# tworjaga/flipper-rf-lab architecture

> Architecture diagram of the GitHub repository tworjaga/flipper-rf-lab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tworjaga/flipper-rf-lab
- Repository: https://github.com/tworjaga/flipper-rf-lab

## Overview

Flipper RF Lab is a Flipper Zero RF capture, monitoring, and research application. Its main workflow is menu-selected operation, RF acquisition through the CC1101 and timing hardware, analysis of signals into protocol, fingerprint, and threat results, then session storage/export and display. The README also documents spectrum scanning, research tools, telemetry, compression, and long-term logging. Main-to-module calls are supported by its imports and excerpts; several feature integrations are documented but their detailed runtime wiring was not sampled.

Main entry points: [`core/flipper_rf_lab_main.c`](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/flipper_rf_lab_main.c) (Runtime workers), [`storage/sd_manager.c`](https://github.com/tworjaga/flipper-rf-lab/blob/main/storage/sd_manager.c) (Session and SD storage), [`analysis/fingerprinting.c`](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/fingerprinting.c) (RF fingerprinting), [`analysis/threat_model.c`](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/threat_model.c) (Threat modeling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Runtime workers"]
  node_menu["Main menu<br/>[main_menu.c]"]
end

subgraph group_hardware["RF hardware"]
  node_cc1101["CC1101 driver<br/>[cc1101_driver.c]"]
  node_gpio["GPIO manager<br/>[gpio_manager.c]"]
  node_timer["Precision timing<br/>[timer_precision.c]"]
end

subgraph group_analysis["Signal analysis"]
  node_fingerprints["RF fingerprinting<br/>[fingerprinting.c]"]
  node_protocol["Protocol inference<br/>[protocol_infer.c]"]
  node_threat["Threat modeling<br/>[threat_model.c]"]
  node_clustering["Signal clustering<br/>[clustering.c]"]
end

subgraph group_persistence["Persistence"]
  node_store[("Session and SD storage<br/>[sd_manager.c]")]
  node_compression["Signal compression<br/>[compression.c]"]
end

subgraph group_support["Research and math"]
  node_research["Research mode"]
  node_telemetry["System telemetry<br/>[telemetry.c]"]
  node_fixed["Fixed-point math<br/>[fixed_point.c]"]
  node_statistics["Statistics toolkit<br/>[statistics.c]"]
end

node_operator(("Operator"))
node_sdcard[("Flipper SD storage")]
node_rf(("RF environment"))

node_operator -->|"selects mode"| node_menu
node_main -->|"updates display"| node_menu
node_main -->|"initializes and polls"| node_cc1101
node_main -->|"initializes"| node_gpio
node_main -->|"uses timing"| node_timer
node_rf -.->|"emits signals"| node_cc1101
node_main -->|"initializes engine"| node_fingerprints
node_main -->|"initializes engine"| node_clustering
node_main -->|"initializes engine"| node_threat
node_main -->|"dispatches analysis"| node_protocol
node_fingerprints -->|"reads and exports"| node_store
node_threat -->|"uses storage API"| node_store
node_main -->|"initializes storage"| node_store
node_store -->|"reads and writes"| node_sdcard
node_main -->|"configures compression"| node_compression
node_research -->|"runs in workers"| node_main
node_main -->|"updates periodically"| node_telemetry
node_telemetry -->|"exports telemetry"| node_store
node_fingerprints -->|"uses statistics"| node_statistics
node_protocol -->|"uses statistics"| node_statistics
node_clustering -->|"uses fixed math"| node_fixed
node_threat -->|"uses fixed math"| node_fixed
node_statistics -->|"uses fixed math"| node_fixed
node_store -.->|"writes compressed data"| node_compression
node_menu -.->|"selects operations"| node_main
node_main -.->|"supports research mode"| node_research

click node_main "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/flipper_rf_lab_main.c"
click node_menu "https://github.com/tworjaga/flipper-rf-lab/blob/main/ui/main_menu.c"
click node_cc1101 "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/cc1101_driver.c"
click node_gpio "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/gpio_manager.c"
click node_timer "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/timer_precision.c"
click node_fingerprints "https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/fingerprinting.c"
click node_protocol "https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/protocol_infer.c"
click node_threat "https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/threat_model.c"
click node_clustering "https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/clustering.c"
click node_store "https://github.com/tworjaga/flipper-rf-lab/blob/main/storage/sd_manager.c"
click node_compression "https://github.com/tworjaga/flipper-rf-lab/blob/main/storage/compression.c"
click node_research "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/flipper_rf_lab_main.c"
click node_telemetry "https://github.com/tworjaga/flipper-rf-lab/blob/main/research/telemetry.c"
click node_fixed "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/math/fixed_point.c"
click node_statistics "https://github.com/tworjaga/flipper-rf-lab/blob/main/core/math/statistics.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_menu toneBlue
class node_cc1101,node_gpio,node_timer,node_sdcard toneAmber
class node_fingerprints,node_protocol,node_threat,node_clustering toneMint
class node_store,node_compression toneRose
class node_research,node_telemetry,node_fixed,node_statistics,node_operator,node_rf toneIndigo
```

## Components

### Application

- [Runtime workers](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/flipper_rf_lab_main.c): `core/flipper_rf_lab_main.c`
- [Main menu](https://github.com/tworjaga/flipper-rf-lab/blob/main/ui/main_menu.c): `ui/main_menu.c`

### RF hardware

- [CC1101 driver](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/cc1101_driver.c): `core/hal/cc1101_driver.c`
- [GPIO manager](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/gpio_manager.c): `core/hal/gpio_manager.c`
- [Precision timing](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/hal/timer_precision.c): `core/hal/timer_precision.c`

### Signal analysis

- [RF fingerprinting](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/fingerprinting.c): `analysis/fingerprinting.c`
- [Protocol inference](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/protocol_infer.c): `analysis/protocol_infer.c`
- [Threat modeling](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/threat_model.c): `analysis/threat_model.c`
- [Signal clustering](https://github.com/tworjaga/flipper-rf-lab/blob/main/analysis/clustering.c): `analysis/clustering.c`

### Persistence

- [Session and SD storage](https://github.com/tworjaga/flipper-rf-lab/blob/main/storage/sd_manager.c): `storage/sd_manager.c`
- [Signal compression](https://github.com/tworjaga/flipper-rf-lab/blob/main/storage/compression.c): `storage/compression.c`

### Research and math

- [Research mode](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/flipper_rf_lab_main.c): `core/flipper_rf_lab_main.c`
- [System telemetry](https://github.com/tworjaga/flipper-rf-lab/blob/main/research/telemetry.c): `research/telemetry.c`
- [Fixed-point math](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/math/fixed_point.c): `core/math/fixed_point.c`
- [Statistics toolkit](https://github.com/tworjaga/flipper-rf-lab/blob/main/core/math/statistics.c): `core/math/statistics.c`

### Other components

- **Operator**
- **Flipper SD storage**
- **RF environment**

## Connections

- Operator → Main menu: selects mode (evidence: `README.md`)
- Runtime workers → Main menu: updates display (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → CC1101 driver: initializes and polls (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → GPIO manager: initializes (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → Precision timing: uses timing (evidence: `core/flipper_rf_lab_main.c`)
- RF environment → CC1101 driver: emits signals (evidence: `README.md`)
- Runtime workers → RF fingerprinting: initializes engine (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → Signal clustering: initializes engine (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → Threat modeling: initializes engine (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → Protocol inference: dispatches analysis (evidence: `core/flipper_rf_lab_main.c`)
- RF fingerprinting → Session and SD storage: reads and exports (evidence: `analysis/fingerprinting.c`)
- Threat modeling → Session and SD storage: uses storage API (evidence: `analysis/threat_model.c`)
- Runtime workers → Session and SD storage: initializes storage (evidence: `core/flipper_rf_lab_main.c`)
- Session and SD storage → Flipper SD storage: reads and writes (evidence: `storage/sd_manager.c`)
- Runtime workers → Signal compression: configures compression (evidence: `core/flipper_rf_lab_main.c`)
- Research mode → Runtime workers: runs in workers (evidence: `core/flipper_rf_lab_main.c`)
- Runtime workers → System telemetry: updates periodically (evidence: `core/flipper_rf_lab_main.c`)
- System telemetry → Session and SD storage: exports telemetry (evidence: `research/telemetry.c`)
- RF fingerprinting → Statistics toolkit: uses statistics (evidence: `analysis/fingerprinting.c`)
- Protocol inference → Statistics toolkit: uses statistics (evidence: `analysis/protocol_infer.c`)
- Signal clustering → Fixed-point math: uses fixed math (evidence: `analysis/clustering.c`)
- Threat modeling → Fixed-point math: uses fixed math (evidence: `analysis/threat_model.c`)
- Statistics toolkit → Fixed-point math: uses fixed math
- Session and SD storage → Signal compression: writes compressed data
- Main menu → Runtime workers: selects operations
- Runtime workers → Research mode: supports research mode (evidence: `README.md`)
