# TDF Viewers

> View and log live sensor data.

Three separate tools are available to view and record local
[Tagged Data Format](https://docs.dev.infuse-iot.com/latest/embedded/app_features/tdf.html#tdf-api) (TDF) packets:

- TDF Localhost
- TDF List
- TDF CSV

<note>

TDF tools all require a running instance of a [Gateways](gateways) bridge to supply data.

</note>

## TDF localhost

The localhost tool records the latest values of TDF packets from each devices and displays them in a table form through
a local web browser. The table view is built on top of [Tabulator](https://tabulator.info/),
providing rich filtering capabilities.

```bash
infuse localhost
```

After running the web server, the interractive web page can be opened in a web browser like below:
![Example infuse localhost webpage display](/images/tdf-viewers/localhost.png)

By default all observed devices are displayed which at times can be overwhelming.
Filtering options can be shown using the button in the top left corner.
Visible devices can be filtered based on if they've send a specific TDFs, their network IDs or application IDs.

The table can also be frozen using the "Pause Updating" checkbox to prevent the table shifting and moving around.
This is useful because frequent refreshes will typically reset text selection which disrupts copying selections.

## TDF List

The TDF list tool simply prints received TDFs to the terminal with formatting.

```bash
infuse tdf_list
```

It will print out TDFs one-by-one as they're received.

```bash
Infuse ID: 00000000000003ea
Interface: BT_ADV
  Address: fd:7f:a6:fa:76:c3 (random)
     RSSI: -56 dBm
-----------------------  -------------------------  -----------------  --------------  -----
2025-03-09 23:55:57.680  ANNOUNCE                   application        0xebe10001
                                                    version.major      1
                                                    version.minor      1
                                                    version.revision   11
                                                    version.build_num  0xe91313a1
                                                    kv_crc             0xaf3cc14a
                                                    blocks             20248669
                                                    uptime             1604665
                                                    reboots            3
                                                    flags              0x01
2025-03-09 23:55:57.680  ACC_4G                     sample.x           -16
                                                    sample.y           242
                                                    sample.z           8283
2025-03-09 23:55:57.680  LTE_CONN_STATUS            cell.mcc           505
                                                    cell.mnc           1
                                                    cell.eci           147045644
                                                    cell.tac           28714
                                                    earfcn             9410
                                                    status             5
                                                    tech               7
                                                    rsrp               -127            dBm
                                                    rsrq               -5              dB
2025-03-09 23:55:57.680  BLUETOOTH_DATA_THROUGHPUT  address.type       0
                                                    address.val        0x60fcf10031da
                                                    throughput         323             B/sec
...
```

There are also a number of available options:

```bash
> infuse tdf_list -h

usage: infuse tdf_list [-h] [--array-all] [--id ID] [--min-rssi MIN_RSSI] [--server-port SERVER_SOCK]

Display received TDFs in a list

options:
  -h, --help            show this help message and exit
  --array-all           Display all array values, not just the last
  --id ID               Limit displayed TDFs by device ID
  --min-rssi MIN_RSSI   Minimum RSSI to display TDF
  --server-port SERVER_SOCK
                        Alternate port to use for Gateway connections (default 8751)
```

## TDF CSV

The TDF CSV tool records all received TDF packets to CSV files.

```text
infuse tdf_csv
```

Each unique Infuse ID and TDF pair results in a dedicated file,
e.g a `BATTERY_STATE` TDF received from `0x123456789ABCDEF` is saved to `123456789ABCDEF_BATTERY_STATE.csv`.
If a file already exists, new data is appended to it.

Example CSV content for `BATTERY_STATE` TDFs

```csv
time,voltage_mv,current_ua,soc
2025-03-10T00:00:35.671640,3737,0,66
2025-03-10T00:00:37.428005,3737,0,66
2025-03-10T00:00:38.531742,3737,0,66
2025-03-10T00:00:40.439066,3737,0,66
```