💡 Die meisten Relais-Module verwenden Active HIGH. Optokoppler-Module oft Active LOW.
Wähle ein Radio Preset das zu deinem MeshCore-Netzwerk passt. Alle Nodes müssen die gleichen LoRa-Parameter verwenden!
3Sicherheit & Authentifizierung
Nur autorisierte Nodes mit korrektem Passwort können schalten.
🔑 Passwörter
⚠ Schwaches/bekanntes Passwort. Bitte ein anderes waehlen.
Admin-Passwort: Login in der Companion App MIT Schreibrechten UND Auth-Token für Mesh-Befehle (PASSWORT:BEFEHL). Pflicht. Guest-Passwort: Optionaler Login in der Companion App OHNE Schreibrechte — nur Status-Anzeige. Leer = kein Gast-Zugang.
Rate-Limiting
📋 Node-Whitelist
Nur Nodes in der Whitelist dürfen Login-Versuche beantworten. Der Node-Hash ist der Public-Key-Prefix deines Companion-Node — in der MeshCore App unter Settings → Node Info → Public Key (erste 8–16 Hex-Zeichen reichen als Prefix, Mehr = eindeutiger). Akzeptiert: 8–64 Hex-Zeichen (gerade Anzahl), kein 0x-Prefix.
Deaktiviert — jeder eingeloggte Admin kann Relay-Befehle senden. Nur das Admin-Passwort schützt.
4Konfiguration prüfen
Zusammenfassung und generierte Dateien für Custom-Builds.
Zusammenfassung
relay_config.h
platformio.ini
Die Firmware wird mit deinem Passwort individuell kompiliert (~2-3 Min). Das Passwort ist fest im Binary eingebaut — nach dem Flash bereits aktiv, kein Serial-Setup noetig. Alternative: Dateien herunterladen und lokal mit PlatformIO kompilieren.
5Firmware Flashen
Board per USB verbinden und Firmware im Browser flashen.
Nicht verbunden
Bereit. Zuerst "Firmware bauen", dann Board verbinden und flashen.
⚠️ RAK4631 / nRF52
nRF52-Boards können nicht über Web Serial geflasht werden.
Alternativen: 1. nRF Connect App — DFU über Bluetooth 2. adafruit-nrfutil — DFU über USB
DFU-Modus: Double-Tap Reset
6Verifizieren & Konfigurieren
Serial Console öffnen, Boot prüfen, Passwort und Whitelist setzen.
GPIO Pinout — Relay-Anschlüsse
🖥 Serial Console
Nicht verbunden
Nächste Schritte
Passwort setzen: relay_password DEIN_PASSWORT
Nodes hinzufügen: relay_add AABBCCDDEEFF
Speichern: relay_save
Testen: PASSWORT:STATUS von einem Mesh-Node senden
WICHTIG: LoRa-Antenne MUSS angeschlossen sein! Betrieb ohne Antenne beschädigt den Transceiver dauerhaft.
Befehlsreferenz
Klicke auf einen Befehl zum Kopieren
Serial-Befehle (über USB/Serial Console)
relay_status
Zeigt den aktuellen Zustand aller Relais (ON/OFF)
relay_pins
Zeigt die GPIO-Pin-Zuordnung und Active-High/Low Modus
relay_test [1-4]
Schaltet ein Relais kurz ein/aus zum Testen (1 Sek. Puls)
relay_on [1-4]
Schaltet ein bestimmtes Relais dauerhaft ein
relay_off [1-4]
Schaltet ein bestimmtes Relais aus
relay_toggle [1-4]
Wechselt den Zustand eines Relais (ON→OFF / OFF→ON)
relay_all_on
Schaltet alle Relais gleichzeitig ein
relay_all_off
Schaltet alle Relais gleichzeitig aus
relay_password DEIN_PASSWORT
Setzt das Authentifizierungs-Passwort für Mesh-Befehle
relay_active high|low
Ändert den Schaltmodus: HIGH = Relais aktiv bei HIGH, LOW = invertiert
relay_wl
Zeigt Whitelist-Status und alle eingetragenen Nodes
relay_wl_on / relay_wl_off
Aktiviert oder deaktiviert die Node-Whitelist zur Laufzeit
relay_wl_add NODE_HASH
Fügt einen Node zur Whitelist hinzu (6-Byte Hex aus Companion App)
relay_wl_rm NODE_HASH
Entfernt einen Node aus der Whitelist
password DEIN_PASSWORT
Setzt das MeshCore Admin-Login-Passwort (für Companion App Login)
advert
Sendet ein Flood-Advertisement ins Mesh (macht den Repeater sichtbar)
Mesh-Nachrichten (von anderen Nodes per LoRa senden)
Format: PASSWORT:BEFEHL — als Textnachricht an den Relay-Node senden
PASSWORT:STATUS
Fragt den aktuellen Zustand aller Relais ab — Antwort: R1:ON R2:OFF ...
PASSWORT:R1_ON
Schaltet Relais 1 ein (R1–R4 möglich)
PASSWORT:R1_OFF
Schaltet Relais 1 aus (R1–R4 möglich)
PASSWORT:R2_ON
Schaltet Relais 2 ein
PASSWORT:R2_OFF
Schaltet Relais 2 aus
PASSWORT:R3_ON
Schaltet Relais 3 ein
PASSWORT:R3_OFF
Schaltet Relais 3 aus
PASSWORT:R4_ON
Schaltet Relais 4 ein
PASSWORT:R4_OFF
Schaltet Relais 4 aus
PASSWORT:TOGGLE1
Schaltet Relais 1 um (ON→OFF oder OFF→ON). TOGGLE1–TOGGLE4 möglich
PASSWORT:TOGGLE2
Schaltet Relais 2 um
PASSWORT:TOGGLE3
Schaltet Relais 3 um
PASSWORT:TOGGLE4
Schaltet Relais 4 um
PASSWORT:ALL_ON
Schaltet alle Relais gleichzeitig ein
PASSWORT:ALL_OFF
Schaltet alle Relais gleichzeitig aus (Notfall-Aus)
Sicherheitshinweise
• Whitelist: Ist mindestens ein Node eingetragen, werden Befehle von unbekannten Nodes abgelehnt
• Rate-Limiting: Max. 10 Befehle/Minute pro Node — danach temporäre Sperre
• Lockout: Nach 5 falschen Passwörtern wird der Node für 300 Sekunden gesperrt
• Antwort: Jeder Befehl erhält eine Antwort mit dem aktuellen Status aller Relais
