How j-a-a-m/ukraine_alarm_map works
JAAM is an archived Ukrainian air-alert map ecosystem: embedded devices present status and sensor information, while backend services collect and prepare alert and environmental data for clients. The README also identifies a data portal and browser-based firmware flasher. The sampled source shows firmware initialization and Redis-backed backend components, but not enough wiring to establish every service-to-service or device-to-server connection; those links are omitted rather than inferred.
Main entry points: JaamFirmware.cpp Firmware runtime · web_server.py Web server · flasher.js Browser flasher · update_server.py Release service
Components 21
JAAM device firmware
- Firmware runtime
firmware/src/JaamFirmware.cpp - Display
firmware/src/JaamDisplay.cpp - Settings
firmware/src/JaamSettings.cpp - Home Assistant
firmware/src/JaamHomeAssistant.cpp - Climate sensor
firmware/src/JaamClimateSensor.cpp - Light sensor
firmware/src/JaamLightSensor.cpp - Device buttons
firmware/src/JaamButton.cpp
Data collection
- Alert collector
deploy/alerts/alerts.py - Etryvoga collector
deploy/etryvoga/etryvoga.py - Etryvoga WS collector
deploy/etryvoga_ws/etryvoga_ws.py
Backend data services
- Data updater
deploy/updater/updater.py - Redis data store
- WebSocket server
deploy/websocket_server/websocket_server.py
User interfaces
- Web server
deploy/web_server/web_server.py - Device map
deploy/device_map/device_map.py
Firmware updates
- Browser flasher
flasher/flasher.js - Release service
deploy/update_server/update_server.py - Device updater
updater/src/updater.cpp
Other components
- Device user
- Portal user
- Flasher user
Connections 18
- Device user → Firmware runtime: uses device
README.md - Firmware runtime → Display: initializes
firmware/src/JaamFirmware.cpp - Firmware runtime → Settings: initializes
firmware/src/JaamFirmware.cpp - Firmware runtime → Climate sensor: initializes
firmware/src/JaamFirmware.cpp - Firmware runtime → Light sensor: initializes
firmware/src/JaamFirmware.cpp - Firmware runtime → Device buttons: initializes
firmware/src/JaamFirmware.cpp - Firmware runtime → Home Assistant: runs loop
firmware/src/JaamFirmware.cpp - Alert collector → Redis data store: reads and writes
deploy/alerts/alerts.py - Etryvoga collector → Redis data store: stores data
deploy/etryvoga/etryvoga.py - Etryvoga WS collector → Redis data store: stores data
deploy/etryvoga_ws/etryvoga_ws.py - Data updater → Redis data store: publishes data
deploy/updater/updater.py - WebSocket server → Redis data store: reads client data
deploy/websocket_server/websocket_server.py - Web server → Redis data store: reads data
deploy/web_server/web_server.py - Device map → Redis data store: reads locations
deploy/device_map/device_map.py - Portal user → Web server: views portal
README.md - Flasher user → Browser flasher: flashes firmware
README.md - Browser flasher → Release service: requests releases
- Release service → Device updater: provides updates