# marshallmortem-svg/mortemhive-hotspot architecture

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

- Interactive diagram: https://gitdiagram.com/marshallmortem-svg/mortemhive-hotspot
- Repository: https://github.com/marshallmortem-svg/mortemhive-hotspot

## Overview

MortemHive is a flashable Pi-Star hotspot image for Raspberry Pi Zero W and an MMDVM OLED hat. The user flashes the image, configures Wi-Fi and station identity, then uses the hotspot while the OLED presents radio and device status. The graph includes documented safety, gateway, and optional Wi-Fi capabilities; the dashboard excerpt also shows identity, telemetry, and OLED-rendering behavior. Most image configuration and service wiring was not sampled, so those relationships are shown only where the README explicitly documents them.

Main entry points: [`image/scripts/hotspot-oled-dash.py`](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-oled-dash.py) (OLED dashboard), [`image/configs`](https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/image/configs) (Radio configurations), [`image/scripts/hotspot-config-guard.sh`](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-config-guard.sh) (Identity guard), [`image/systemd/watchdog.conf`](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/systemd/watchdog.conf) (Hardware watchdog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_image["Hotspot image"]
  node_image["Pi-Star image"]
  node_wifi_setup["Wi-Fi setup"]
end

subgraph group_radio["Radio services"]
  node_radio_config["Radio configurations"]
  node_modem_services["Modem services"]
  node_config_guard["Identity guard"]
end

subgraph group_dashboard["OLED dashboard"]
  node_dashboard["OLED dashboard"]
end

subgraph group_reliability["Reliability"]
  node_systemd_watchdog["Hardware watchdog<br/>[watchdog.conf]"]
  node_service_guards["Service guard units"]
end

subgraph group_network["Network support"]
  node_wifi_access_point["Setup access point"]
  node_wifi_watchdog["Wi-Fi resilience"]
end

node_operator(("Hotspot operator"))
node_station_config[("Station identity")]
node_radio_logs[("Radio activity logs")]
node_device_state[("Device and Wi-Fi state")]
node_oled["OLED panel"]

node_operator -->|"flashes"| node_image
node_operator -->|"configures"| node_wifi_setup
node_operator -->|"sets identity"| node_station_config
node_image -->|"includes"| node_dashboard
node_image -->|"includes"| node_radio_config
node_radio_config -->|"configures"| node_modem_services
node_config_guard -->|"blocks startup"| node_modem_services
node_station_config -->|"reads identity"| node_dashboard
node_radio_logs -.->|"reads activity"| node_dashboard
node_device_state -->|"reads telemetry"| node_dashboard
node_dashboard -->|"renders screens"| node_oled
node_systemd_watchdog -->|"reboots on hang"| node_image
node_service_guards -->|"guards startup"| node_modem_services
node_operator -->|"joins optionally"| node_wifi_access_point
node_wifi_watchdog -.->|"extends Wi-Fi"| node_image

click node_wifi_setup "https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/configs/wpa_supplicant.conf"
click node_radio_config "https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/image/configs"
click node_config_guard "https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-config-guard.sh"
click node_dashboard "https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-oled-dash.py"
click node_systemd_watchdog "https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/systemd/watchdog.conf"
click node_service_guards "https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/image/systemd"
click node_wifi_watchdog "https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/extras/wifi-resilience"

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_image,node_wifi_setup toneBlue
class node_radio_config,node_modem_services,node_config_guard,node_station_config,node_radio_logs,node_device_state toneAmber
class node_dashboard toneMint
class node_systemd_watchdog,node_service_guards toneRose
class node_wifi_access_point,node_wifi_watchdog,node_operator,node_oled toneIndigo
```

## Components

### Hotspot image

- **Pi-Star image**
- [Wi-Fi setup](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/configs/wpa_supplicant.conf): `image/configs/wpa_supplicant.conf`

### Radio services

- [Radio configurations](https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/image/configs): `image/configs`
- **Modem services**
- [Identity guard](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-config-guard.sh): `image/scripts/hotspot-config-guard.sh`

### OLED dashboard

- [OLED dashboard](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/scripts/hotspot-oled-dash.py): `image/scripts/hotspot-oled-dash.py`

### Reliability

- [Hardware watchdog](https://github.com/marshallmortem-svg/mortemhive-hotspot/blob/main/image/systemd/watchdog.conf): `image/systemd/watchdog.conf`
- [Service guard units](https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/image/systemd): `image/systemd`

### Network support

- **Setup access point**
- [Wi-Fi resilience](https://github.com/marshallmortem-svg/mortemhive-hotspot/tree/main/extras/wifi-resilience): `extras/wifi-resilience`

### Other components

- **Hotspot operator**
- **Station identity**
- **Radio activity logs**
- **Device and Wi-Fi state**
- **OLED panel**

## Connections

- Hotspot operator → Pi-Star image: flashes (evidence: `README.md`)
- Hotspot operator → Wi-Fi setup: configures (evidence: `README.md`)
- Hotspot operator → Station identity: sets identity (evidence: `README.md`)
- Pi-Star image → OLED dashboard: includes (evidence: `README.md`)
- Pi-Star image → Radio configurations: includes (evidence: `README.md`)
- Radio configurations → Modem services: configures (evidence: `README.md`)
- Identity guard → Modem services: blocks startup (evidence: `README.md`)
- Station identity → OLED dashboard: reads identity (evidence: `image/scripts/hotspot-oled-dash.py`)
- Radio activity logs → OLED dashboard: reads activity
- Device and Wi-Fi state → OLED dashboard: reads telemetry (evidence: `image/scripts/hotspot-oled-dash.py`)
- OLED dashboard → OLED panel: renders screens (evidence: `image/scripts/hotspot-oled-dash.py`)
- Hardware watchdog → Pi-Star image: reboots on hang (evidence: `README.md`)
- Service guard units → Modem services: guards startup (evidence: `README.md`)
- Hotspot operator → Setup access point: joins optionally (evidence: `README.md`)
- Wi-Fi resilience → Pi-Star image: extends Wi-Fi (evidence: `README.md`)
