Quick Start

Quick Start

Three steps: install the Flipper app, install the Android app, connect and capture.

1. Install the Flipper app

Copy artifacts/rf_logger.fap to your Flipper SD card at:

/ext/apps/Sub-GHz/rf_logger.fap

On the Flipper: Apps → Sub-GHz → RF Logger. It opens directly on the manual frequency editor (default 433.92 MHz).

• ↑ / ↓ change the active digit · ← / → move the cursor · OK starts scanning · Back exits.
• Range is clamped to 300–928 MHz (CC1101 limit).
• While running: OK toggles SD logging, Back returns to the editor.
• The bottom status line shows the Bluetooth link: BT:off / BT:adv / BT:ok.

2. Install the Android app

Enable Install unknown apps, or sideload with ADB:

adb install artifacts/RF_Triangulator.apk

Grant Location when prompted (required for GPS capture).

3. Connect and capture

Open RF Triangulator → tap ☰ and pick a transport:

USB (wired) — plug the Flipper into the phone with USB-C → Transport USB → Connect Flipper → accept the USB permission. Auto-reconnects if USB drops.

Bluetooth (wireless) — see Bluetooth Setup for the full flow.

Then, on either transport:

1. The top bar mirrors the Flipper: frequency, RSSI, signal bar.
2. Walk to a position and tap Capture here — it logs GPS + live RSSI.
3. Repeat from 3+ positions that surround the suspected transmitter.
4. The drawer shows the triangulation estimate + RMS error once you have 3 captures.
5. Set the environment / path-loss n in the drawer to match your surroundings — it's the single biggest accuracy lever (see Understanding Accuracy).

Auto-capture

Tap Auto-capture to log at a fixed interval (1 / 2 / 5 / 10 s) while you walk. Tap Stop Auto to end.

Import & export

• Load .sub / .log (☰) imports files captured on the Flipper SD card (.sub, .log, .csv, .txt with RSSI: / Latitude: / Longitude: fields).
• Export CSV — one row per capture: id, lat, lon, rssi_dbm, freq_hz, source.
• Export JSON — full capture list + the triangulation estimate.

Captures and settings persist across app restarts, so a field session isn't lost.