DETAILS.md

DisasterMesh – Details

Ausführliche Fassung der früheren README (Stand Oktober 2026). Die kurze Übersicht steht in der README; Versionsangaben gelten dort.

Aktueller Stand: offenes WLAN DisAHRsterRadio-XXXXXX → http://192.168.4.1, Schwarzes Brett mit dem öffentlichen Gast-Passwort hello (sendet die Weboberfläche automatisch) – einfach verbinden, nichts eingeben. Betreiberfunktionen nur mit Admin-Passwort über USB/Adminbereich. Zugang auf einen Blick · Zugang, Update und Abnahme

Lokale Kommunikation im Ahrtal – auch ohne Internet, Strom- oder Mobilfunknetz. DisAHRsterRadio verbindet LoRa-Funkknoten auf Basis von MeshCore mit einer deutschen Weboberfläche im Handy-Browser: Chat, Schwarzes Brett, Schnellmeldungen, Offlinekarten und Standort teilen. Der Name trägt die Ahr in sich und erinnert an die Flut im Juli 2021.

⚠️ Kein geprüftes Notfunksystem und kein Ersatz für den Notruf 112. Software und Firmware-Builds sind automatisch geprüft. Hardware: LILYGO T3 V1.6.1 lief beim Nutzer mit der Schwester-Firmware DisAHRsterRadio vollständig (OLED, WLAN, Weboberfläche, Chat, LoRa-Empfang); DisasterMesh 0.9.2 selbst ist auf keinem Board abgenommen (auf Hardware getestet ist 0.9.1 nur in der Schwester-Firmware DisAHRsterRadio-MeshCore auf T-Deck Plus und Heltec V2). Heltec V2 zeigte mit älteren Ständen ein Strom-/Brownout-Problem (WLAN-AP erschien nicht); der gestaffelte WLAN-Start ist als Gegenmaßnahme enthalten. Funkreichweite, GPS-Modul, Stromaufnahme und iPhone sind nicht abgenommen.

English summary

DisAHRsterRadio (repository DisasterMesh) is an offline LoRa mesh messenger for the Ahr valley (Germany), built on MeshCore 1.18. Each ESP32 node opens its own Wi-Fi; phones use a German web UI (MeshAhrtal) for channel chat, direct messages, a bulletin board (room server), quick emergency templates, offline vector maps of the valley and opt-in position sharing (compact !DP1 messages, coarse/medium/fine precision). Supported main boards: LILYGO T3-S3 V1.3 (SX1262 or SX1276), LILYGO T3 V1.6.1 (SX1276) and Heltec WiFi LoRa 32 V2 (SX1276), all 868 MHz; repeater and room-server profiles are included, an external NMEA GPS module is optional. Version and firmware ID come from the single VERSION file. Status: development prototype – CI-tested software and firmware builds; this version has not been accepted on real hardware (only the LILYGO T3 V1.6.1 ran the sister firmware DisAHRsterRadio at the user's site). Not a certified emergency system.

Funktionen

Bereich	Funktionen
Kommunikation	Kanalchat, Direktnachrichten, Kontakte, Verlaufssuche, JSON-Export, begrenzte Zustellaufträge
Schwarzes Brett	Room-Server, Portal tritt automatisch mit öffentlichem Gast-Passwort hello bei (lesen/schreiben), 32 Beiträge, Vorlagen Hilfe / Angebot / Info (!DM1), aktuelle Hilfe oben
Schnellmeldungen	Trinkwasser, Strom/Laden, Medikamente, Verletzt, Evakuierung, „Mir geht es gut“, Hilfe anbieten, Strom vorhanden
Ahrtal-Orte	14 Orte von Schuld bis Kripp für Meldungen und Standort (gerundete Ortsmitten nach OSM)
Standort	Ortsliste, Karte antippen, Handy-Ortung (nur in sicherem Kontext), optionales GPS-Modul; Teilen als !DP1 mit Genauigkeit grob/mittel/fein, höchstens alle 5 Minuten. Details
Offlinekarten	Ahrtal-Übersicht Quelle–Mündung, Heimersheim mit Gebäuden, Altenahr, Dernau/Ahrweiler, Sinzig; Speicherung auf dem Handy, automatische Aktualisierung bei Internet. Karten
Versorgung und eigene Orte	OSM-Versorgungspunkte (Wasser, Apotheke, Feuerwehr, Arzt, Lebensmittel, WC, Unterstand), eigene POIs und Erntefundorte, GeoJSON-Import/-Export
Gerät und Administration	Diagnose, Knotenname, Uhrzeit, Adminzugang (Admin-Passwort nur für Betreiber), Chatkanäle, 868-MHz-Funkprofile, Verlauf löschen, optionales SD-Archiv

Zugang auf einen Blick

Zugang	Aktueller Stand
WLAN DisAHRsterRadio-XXXXXX	offen, ohne Passwort – verbinden, http://192.168.4.1 öffnen, nichts eingeben (höchstens 4 Handys je Board)
Bluetooth (MeshCore-App)	im Release-Build für Heltec V2 (disaster_heltec_v2_sx1276_wifi) nicht enthalten – Bedienung über das WLAN-Portal
Schwarzes Brett (Room-Server)	öffentliches MeshCore-Standard-Gast-Passwort hello: damit lesen und schreiben. Die Weboberfläche sendet hello beim „Beitreten“ automatisch, niemand muss etwas eintippen. In der MeshCore-App hello eingeben; ohne Passwort nur lesen
Admin (nur Betreiber)	Für Betreiberfunktionen (Funkprofil, Name, Kanäle, Verwaltung von Repeater/Room-Server) gibt es ein Admin-Passwort. Es ist für jedes Gerät eigen, steht weder im Code noch in der Doku und wird nur beim ersten Start über USB (115200 Baud) angezeigt. Der Betreiber muss es dort ablesen und sicher aufbewahren oder ein eigenes setzen (im Adminbereich der Weboberfläche ändern (12–64 Zeichen); bei Repeater und Room-Server per USB-Befehl password <neu>).

Außer dem öffentlichen Standard hello stehen keine Passwörter in Code, Doku, Flyern oder der Live-Demo; die Live-Demo öffnet den Adminbereich ohne Anmeldung. Details: Offener Zugang.

Download: Release v0.9.2 mit dem Paket für Heltec WiFi LoRa 32 V2 (factory.bin an 0x0 flashen; überschreibt Einstellungen, Identität und Verlauf). Pakete für weitere Boards sind vorerst nicht im Release; ältere Releases (bis 0.9.0-alpha) enthalten noch die alten Zugangsregeln.

Schnellstart

1. Demo ansehen: Live-Demo im Browser – alles simuliert, Adminbereich ohne Anmeldung. Offline: python tools/build_demo.py erzeugt dieselbe Demo in docs/demo/. Demo-ZIPs und Startpakete in den älteren Releases (0.7.x/0.8.0) sind veraltet und beschreiben noch den früheren Demo-Adminzugang – bitte die Live-Demo oder tools/build_demo.py verwenden. Startpaket
2. Firmware: Release v0.9.2 mit dem Paket für Heltec V2 (…-factory.bin an 0x0, Einzelteile, SHA256SUMS, deutsche ANLEITUNG.md). Weitere Boards und Profile (T3-S3 V1.3, T3 V1.6.1, Repeater, Room-Server, SD, GPS, SX1276) bleiben im Code, sind aber vorerst nicht im Release: Builds der Workflows „Build T3-S3 V1.3“ und „Build DisAHRsterRadio TTGO“ unter Actions (GitHub-Anmeldung nötig) oder selbst bauen (siehe unten). Flashen mit Sicherung · Startpaket und Windows
3. Vorherige Firmware und Einstellungen lokal sichern. Bei bestehender DisAHRsterRadio-Installation gleicher Rolle nur die Anwendung aktualisieren, kein uploadfs.
4. Nur Betreiber: USB-Seriellmonitor (115200 Baud) öffnen und das beim ersten Start angezeigte Admin-Passwort sicher aufbewahren oder ein eigenes setzen. Für WLAN und Brett muss niemand etwas eingeben.
5. Handy mit DisAHRsterRadio-XXXXXX verbinden, http://192.168.4.1 öffnen. Web-App auf dem iPhone
6. Knoten benennen, Uhr übernehmen, Funkprofil und Kanäle auf allen Boards abstimmen.
7. Erst zwei Boards direkt testen, dann Repeater und Room-Server ergänzen. Abnahmeprotokoll

Hardware

Funkprofil (alle Geräte, alle Rollen): MeshCore-Standard-Preset EU/UK (Narrow) – 869,618 MHz, Bandbreite 62,5 kHz, SF8, CR 4/8, MeshCore-Standard-Syncword (privat, 0x12). Gesetzt über die Build-Flags LORA_FREQ=869.618, LORA_BW=62.5, LORA_SF=8, LORA_CR=8 in firmware/MeshCore/platformio.ini (gilt für alle Upstream-Gerätevarianten und die eigenen Profile). Teilband 869,4–869,65 MHz (SRD, ETSI EN 300 220 / BNetzA): max. 500 mW ERP (27 dBm), 10 % Sendezeit; die Firmware bleibt bei der bisherigen boardsicheren Sendeleistung (nicht erhöht). Alle Knoten eines Netzes müssen dasselbe Profil nutzen – Geräte mit älterem Stand (CR 4/5) einmal in der Weboberfläche auf „EU/UK Narrow“ stellen oder per CLI set radio 869.618,62.5,8,8.

Zielaufbau: fünf LILYGO T3-S3 V1.3 (ESP32-S3, SX1262, 868-MHz-Antenne). Board, Pins, Strom · Fünf-Board-Aufbau

Boards	Rolle	Firmwareprofil
A und B	WLAN-Portal mit MeshAhrtal-Oberfläche	disaster_t3s3_sx1262_wifi
optional	WLAN-Portal mit SD-Archiv	disaster_t3s3_sx1262_wifi_sd
optional	WLAN-Portal mit GPS-Modul	disaster_t3s3_sx1262_wifi_gps
C und D	Repeater	disaster_t3s3_sx1262_repeater
E	Room-Server (Schwarzes Brett)	disaster_t3s3_sx1262_room

Weitere Boards und Profile:

Board	Rolle	Firmwareprofil	Stand
LILYGO T3-S3 V1.3 mit SX1276	WLAN / Repeater / Room / SD	disaster_t3s3_sx1276_*	baut, ungeprüft
LILYGO T3 V1.6.1 (TTGO LoRa32 V2.1_1.6, SX1276)	WLAN-Portal	disaster_tlora_v2_1_sx1276_wifi	baut; Hardware mit DisAHRsterRadio geprüft
TTGO LoRa32 V2.1_1.6	WLAN / SD / Repeater / Room	disaster_ttgo_wifi, _wifi_sd, _repeater, _room	baut, ungeprüft
Heltec WiFi LoRa 32 V2 (SX1276)	WLAN-Portal (WLAN 8,5 dBm, 2 s später gestartet)	disaster_heltec_v2_sx1276_wifi	baut; Brownout-Problem bekannt
Heltec WiFi LoRa 32 V2	Diagnose (Boot-Marker seriell)	disaster_heltec_v2_sx1276_wifi_diag	baut

Firmware nie auf eine andere Funkchip-Variante flashen. Meshtastic-Knoten sprechen nicht mit MeshCore. WLAN-Name DisAHRsterRadio-XXXXXX. Das WLAN ist offen – einfach verbinden, nichts eingeben. Der Room-Server (Board E) nutzt das öffentliche Gast-Passwort hello.

Optionales GPS-Modul (NMEA, 9600 Baud, z. B. ATGM336H, NEO-6M, L76K) – nicht an Hardware geprüft:

Modul	T3-S3
VCC	3V3
GND	GND
TX	GPIO 44
RX	GPIO 43

Vorschauen

Echte Browseraufnahmen der Demo; Geräte- und Funkwerte sind simuliert.

Chat	Schwarzes Brett	Meldungsvorlagen
Kartendownload	Versorgung	Eigene POIs
Adminzugang	Diagnose	Funkprofile

Weitere: Desktop · Direktnachrichten · Kanäle · Knoten · Zustellaufträge/SD · Erntefundorte · Heimersheim-Karte

Status und Grenzen

• Prototyp. Nicht zertifiziert, kein Anschluss an Leitstellen, keine Funkpriorität für Hilferufe.
• Hardware ungeprüft: Funk, Reichweite, Repeater, Room-Server über Neustart, Stromausfall, SD-Last, GPS-Modul, Stromaufnahme, echtes iPhone/Android. Siehe Validierung, Entwicklungsplan, iPhone, Strom.
• Handy-Ortung ist über http://192.168.4.1 vom Browser gesperrt; Ortsliste, Karte oder GPS-Modul verwenden.
• Alle WLAN-Nutzer eines Boards teilen eine Knotenidentität. Verlauf im Flash, eigene POIs und Exporte sind unverschlüsselt.
• Positionen im Kanal sind für alle mit dem Kanalschlüssel lesbar (im Public-Kanal für alle).
• Karten müssen vor dem Ausfall auf dem Handy liegen; keine Karteninhalte über Funk.
• Im Ordner dist/ liegen bewusst keine Firmwaredateien (Hinweis).

Entwicklung und Tests

Benötigt: Python 3, Node.js 20, Git, PlatformIO 6.2.

npm ci --omit=optional && npm test          # JS-Tests ohne Browser
python tests/tools.test.py                   # Python-Tests: tests/*.test.py
g++ -std=c++17 -I tests/fakes tests/history.test.cpp -o /tmp/t && /tmp/t   # C++-Tests: tests/*.test.cpp
python tools/embed_web.py                    # Oberfläche in die Firmware einbetten
python -m platformio run -d firmware/MeshCore -e disaster_t3s3_sx1262_wifi

Browserprüfungen und Vorschauen: npm ci && npx playwright install chromium, dann npm run test:browser, python tools/build_demo.py, node tools/capture_previews.cjs.

CI (Actions): „Tests“ (JS, Python, C++, Versionsprüfung tools/version.py --check, feste Bibliotheksversionen tools/pin_libs.py --check), „Build DisAHRsterRadio TTGO“ (TTGO-, T3-V1.6.1- und Heltec-Profile + Browser), „Build T3-S3 V1.3“ (8 Profile + GPS-Profil, Windows-Pakete), „Windows MVP checks“, „Release“ (bei jedem Tag v*: Paket für Heltec V2 bauen, prüfen und veröffentlichen; Versionen mit Zusatz wie -alpha als Vorabversion), „Projektseite (GitHub Pages)“.

Version und Firmwarekennung stehen nur in der Datei VERSION; python tools/version.py überträgt sie in Oberfläche, Demo, README, Flyer und Projektseite.

Weitere Doku: Architektur · Windows-Entwicklung · MeshCore-Anpassungen · Änderungen

Mitmachen

Fehler und Ideen bitte als Issue. Pull Requests gegen main; alle Checks müssen grün sein. Dokumentation und Oberfläche sind auf Deutsch. Hardware-Testberichte (zwei Boards, Repeater, iPhone, GPS-Modul) mit dem Abnahmeprotokoll sind besonders willkommen.

Flyer (A5): Druck-PDF mit QR-Codes · Digital-PDF mit klickbaren Links · Vorschau; erzeugt mit dem gemeinsamen Flyer-Generator python3 tools/flyer/flyer.py (Konfiguration tools/flyer/flyer.json, Version aus VERSION, schreibt auch die Druckquelle docs/flyer/flyer.html); beide PDFs hängen auch am Release. Projektseite: Quelle docs/site/index.html, lokal bauen mit python tools/build_site.py (Seite, Bilder und Live-Demo in _site/); Veröffentlichung über den Workflow „Projektseite (GitHub Pages)“.

Lizenz und Quellen

• Code: MIT. MeshCore und weitere Komponenten unter ihren eigenen Lizenzen, siehe Quellen und Lizenzen.
• Kartendaten: © OpenStreetMap-Mitwirkende, ODbL 1.0.
• Foto und Startbild: © Pietwars, nicht unter MIT (Bildquellen). Schrift im Startbild: Rajdhani (SIL Open Font License).