# richonguzman/lora_aprs_tracker architecture

> Architecture diagram of the GitHub repository richonguzman/lora_aprs_tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/richonguzman/lora_aprs_tracker
- Repository: https://github.com/richonguzman/lora_aprs_tracker

## Overview

CA2RXU LoRa APRS Tracker is ESP32 firmware for GPS-based APRS tracking and station operation. The principal workflow is GPS position acquisition, beacon scheduling and packet generation, LoRa transmission, and display of tracker and heard-station information. Users also configure the device and use its menu for messaging, weather requests, and station tools; Bluetooth TNC, Winlink, telemetry, notifications, and web configuration are additional capabilities. Relationships among unsampled modules are shown only where the README documents them; internal call wiring is therefore limited.

Main entry points: [`src/lora_utils.cpp`](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/lora_utils.cpp) (LoRa Radio), [`src/menu_utils.cpp`](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/menu_utils.cpp) (Tracker Menu), [`src/telemetry_utils.cpp`](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/telemetry_utils.cpp) (Telemetry), [`variants/ttgo_t_deck_GPS/board_pinout.h`](https://github.com/richonguzman/lora_aprs_tracker/blob/main/variants/ttgo_t_deck_GPS/board_pinout.h) (Board Pinout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tracking["Tracking and APRS"]
  node_gps["GPS Position<br/>[gps_utils.cpp]"]
  node_beacon["Smart Beaconing"]
  node_packets["APRS Packets<br/>[utils.cpp]"]
  node_radio["LoRa Radio<br/>[lora_utils.cpp]"]
  node_stations["Heard Stations<br/>[station_utils.cpp]"]
end

subgraph group_interaction["User Interaction"]
  node_menu["Tracker Menu<br/>[menu_utils.cpp]"]
  node_messages["Messages<br/>[msg_utils.cpp]"]
  node_display["Display<br/>[display.cpp]"]
  node_symbols["APRS Symbols"]
  node_keyboard["Keyboard Input<br/>[keyboard_utils.cpp]"]
end

subgraph group_connectivity["Connectivity"]
  node_web["Web Interface<br/>[web_utils.cpp]"]
  node_wifi["Wi-Fi Access Point<br/>[wifi_utils.cpp]"]
  node_bluetooth["Bluetooth TNC"]
  node_kiss["KISS TNC<br/>[kiss_utils.cpp]"]
  node_winlink["Winlink Mail<br/>[winlink_utils.cpp]"]
end

subgraph group_device["Device Services"]
  node_weather["Weather Telemetry<br/>[wx_utils.cpp]"]
  node_telemetry["Telemetry"]
  node_notifications["Notifications"]
  node_battery["Battery Monitor<br/>[battery_utils.cpp]"]
end

subgraph group_configuration["Configuration"]
  node_configuration["Configuration<br/>[configuration.cpp]"]
  node_board["Board Pinout<br/>[board_pinout.h]"]
end

node_user(("Tracker User"))
node_aprs_network(("LoRa APRS Network"))
node_igateway(("Nearby LoRa iGate"))

node_user -->|"operates"| node_menu
node_gps -->|"provides position"| node_beacon
node_beacon -->|"encodes beacons"| node_packets
node_packets -->|"transmits packets"| node_radio
node_radio -->|"sends over LoRa"| node_aprs_network
node_aprs_network -.->|"reaches nearby"| node_igateway
node_radio -->|"hears trackers"| node_stations
node_stations -->|"shows recent stations"| node_display
node_menu -->|"manages messages"| node_messages
node_menu -->|"requests weather"| node_weather
node_display -->|"draws symbols"| node_symbols
node_user -->|"enters input"| node_keyboard
node_user -->|"configures device"| node_web
node_web -.->|"uses access point"| node_wifi
node_user -->|"connects TNC app"| node_bluetooth
node_bluetooth -->|"selects KISS mode"| node_kiss
node_menu -->|"accesses mail"| node_winlink
node_weather -->|"sends weather data"| node_telemetry
node_telemetry -->|"transmits telemetry"| node_radio
node_radio -->|"signals transmission"| node_notifications
node_battery -->|"reports voltage"| node_telemetry
node_user -->|"sets options"| node_configuration
node_board -.->|"defines GPS pins"| node_gps
node_board -.->|"defines radio pins"| node_radio

click node_gps "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/gps_utils.cpp"
click node_beacon "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/smartbeacon_utils.cpp"
click node_packets "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/utils.cpp"
click node_radio "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/lora_utils.cpp"
click node_stations "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/station_utils.cpp"
click node_menu "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/menu_utils.cpp"
click node_messages "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/msg_utils.cpp"
click node_display "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/display.cpp"
click node_symbols "https://github.com/richonguzman/lora_aprs_tracker/blob/main/include/custom_characters.h"
click node_keyboard "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/keyboard_utils.cpp"
click node_web "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/web_utils.cpp"
click node_wifi "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/wifi_utils.cpp"
click node_bluetooth "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/bluetooth_utils.cpp"
click node_kiss "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/kiss_utils.cpp"
click node_winlink "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/winlink_utils.cpp"
click node_weather "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/wx_utils.cpp"
click node_telemetry "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/telemetry_utils.cpp"
click node_notifications "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/notification_utils.cpp"
click node_battery "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/battery_utils.cpp"
click node_configuration "https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/configuration.cpp"
click node_board "https://github.com/richonguzman/lora_aprs_tracker/blob/main/variants/ttgo_t_deck_GPS/board_pinout.h"

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_gps,node_beacon,node_packets,node_radio,node_stations,node_user toneBlue
class node_menu,node_messages,node_display,node_symbols,node_keyboard toneAmber
class node_web,node_wifi,node_bluetooth,node_kiss,node_winlink toneMint
class node_weather,node_telemetry,node_notifications,node_battery toneRose
class node_configuration,node_board,node_aprs_network,node_igateway toneIndigo
```

## Components

### Tracking and APRS

- [GPS Position](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/gps_utils.cpp): `src/gps_utils.cpp`
- [Smart Beaconing](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/smartbeacon_utils.cpp): `src/smartbeacon_utils.cpp`
- [APRS Packets](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/utils.cpp): `src/utils.cpp`
- [LoRa Radio](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/lora_utils.cpp): `src/lora_utils.cpp`
- [Heard Stations](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/station_utils.cpp): `src/station_utils.cpp`

### User Interaction

- [Tracker Menu](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/menu_utils.cpp): `src/menu_utils.cpp`
- [Messages](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/msg_utils.cpp): `src/msg_utils.cpp`
- [Display](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/display.cpp): `src/display.cpp`
- [APRS Symbols](https://github.com/richonguzman/lora_aprs_tracker/blob/main/include/custom_characters.h): `include/custom_characters.h`
- [Keyboard Input](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/keyboard_utils.cpp): `src/keyboard_utils.cpp`

### Connectivity

- [Web Interface](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/web_utils.cpp): `src/web_utils.cpp`
- [Wi-Fi Access Point](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/wifi_utils.cpp): `src/wifi_utils.cpp`
- [Bluetooth TNC](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/bluetooth_utils.cpp): `src/bluetooth_utils.cpp`
- [KISS TNC](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/kiss_utils.cpp): `src/kiss_utils.cpp`
- [Winlink Mail](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/winlink_utils.cpp): `src/winlink_utils.cpp`

### Device Services

- [Weather Telemetry](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/wx_utils.cpp): `src/wx_utils.cpp`
- [Telemetry](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/telemetry_utils.cpp): `src/telemetry_utils.cpp`
- [Notifications](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/notification_utils.cpp): `src/notification_utils.cpp`
- [Battery Monitor](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/battery_utils.cpp): `src/battery_utils.cpp`

### Configuration

- [Configuration](https://github.com/richonguzman/lora_aprs_tracker/blob/main/src/configuration.cpp): `src/configuration.cpp`
- [Board Pinout](https://github.com/richonguzman/lora_aprs_tracker/blob/main/variants/ttgo_t_deck_GPS/board_pinout.h): `variants/ttgo_t_deck_GPS/board_pinout.h`

### Other components

- **Tracker User**
- **LoRa APRS Network**
- **Nearby LoRa iGate**

## Connections

- Tracker User → Tracker Menu: operates (evidence: `README.md`)
- GPS Position → Smart Beaconing: provides position (evidence: `README.md`)
- Smart Beaconing → APRS Packets: encodes beacons (evidence: `README.md`)
- APRS Packets → LoRa Radio: transmits packets (evidence: `README.md`)
- LoRa Radio → LoRa APRS Network: sends over LoRa (evidence: `README.md`)
- LoRa APRS Network → Nearby LoRa iGate: reaches nearby (evidence: `README.md`)
- LoRa Radio → Heard Stations: hears trackers (evidence: `README.md`)
- Heard Stations → Display: shows recent stations (evidence: `README.md`)
- Tracker Menu → Messages: manages messages (evidence: `README.md`)
- Tracker Menu → Weather Telemetry: requests weather (evidence: `README.md`)
- Display → APRS Symbols: draws symbols (evidence: `src/display.cpp`)
- Tracker User → Keyboard Input: enters input (evidence: `README.md`)
- Tracker User → Web Interface: configures device (evidence: `README.md`)
- Web Interface → Wi-Fi Access Point: uses access point
- Tracker User → Bluetooth TNC: connects TNC app (evidence: `README.md`)
- Bluetooth TNC → KISS TNC: selects KISS mode (evidence: `README.md`)
- Tracker Menu → Winlink Mail: accesses mail (evidence: `README.md`)
- Weather Telemetry → Telemetry: sends weather data (evidence: `README.md`)
- Telemetry → LoRa Radio: transmits telemetry (evidence: `README.md`)
- LoRa Radio → Notifications: signals transmission (evidence: `README.md`)
- Battery Monitor → Telemetry: reports voltage (evidence: `README.md`)
- Tracker User → Configuration: sets options (evidence: `README.md`)
- Board Pinout → GPS Position: defines GPS pins
- Board Pinout → LoRa Radio: defines radio pins
