Anleitung — MeshCore Relay Controller

1 Übersicht & Funktionsweise Was macht der Relay Controller?

Kurz gesagt

So funktioniert das Mesh

2 Voraussetzungen & Hardware Was du brauchst

⚠ Hochspannung

3 Verkabelung der Relais-Module Pin-Zuordnung & Schaltplan

Beispiel: Heltec V3 (Standard-Pinout)

GPIO-Zuordnung pro Board (Standard-Pinout)

Board	Max. Relais	R1	R2	R3	R4
Heltec V2	4	`GPIO 12`	`GPIO 13`	`GPIO 14`	`GPIO 22`
Heltec V3	4	`GPIO 2`	`GPIO 3`	`GPIO 4`	`GPIO 5`
Heltec V4	4	`GPIO 2`	`GPIO 3`	`GPIO 4`	`GPIO 5`
LILYGO T3S3	4	`GPIO 1`	`GPIO 2`	`GPIO 3`	`GPIO 43`
LILYGO T-Beam	4	`GPIO 2`	`GPIO 13`	`GPIO 14`	`GPIO 15`
T-Beam Supreme	4	`GPIO 2`	`GPIO 3`	`GPIO 6`	`GPIO 15`
Station G2	4	`GPIO 1`	`GPIO 2`	`GPIO 3`	`GPIO 4`
RAK4631	4	`WB_IO1`	`WB_IO2`	`WB_IO3`	`WB_IO4`
Xiao S3 WIO	4	`GPIO 1`	`GPIO 2`	`GPIO 3`	`GPIO 4`
XIAO nRF52840	3	`D6`	`D7`	`D0`	—

⚠ Antenne

Active HIGH vs. Active LOW

Modus	Verhalten	Typische Module
`Active HIGH` (Standard)
`Active LOW`

serial console

relay_active high     # Active HIGH (Standard)
relay_active low      # Active LOW
relay_save            # Konfiguration persistieren

Verbraucher anschließen

Anschluss	Bedeutung	Verwendung
`COM`
`NO`
`NC`

4 Firmware flashen — 6 Schritte Der Wizard

💡 Tipp: Debug-Firmware

⚠ Safe-Mode bei Default-Passwort

💡 Alternative: Manuelles Build

5 Sicherheit: Passwort & Whitelist 3 Ebenen Schutz

Ebene	Schutz	Pflicht?
1. Whitelist
2. Passwort
3. Rate-Limit
+

Passwort setzen

serial console — passwort

relay_password MeinGeheimesPasswort2024!
relay_save

🔒 Passwort-Stärke

Whitelist: Nur bestimmte Companion-Nodes zulassen

Format

serial console — whitelist

# Companion-Node hinzufügen (Hash aus MeshCore-App)
relay_add a1b2c3d4e5f6a7b8

# Whitelist anzeigen
relay_list

# Node entfernen (gleicher Hash wie beim Add)
relay_remove a1b2c3d4e5f6a7b8

# Whitelist-Enforcement manuell an/aus
relay_wl_on
relay_wl_off

# Konfiguration speichern
relay_save

6 Relais steuern — praktisch Schritt für Schritt zum ersten Schaltvorgang

💡 Status abfragen

Beispiel: Pumpe 10 Sekunden laufen lassen

pumpen-zyklus

MeinPasswort:R1_PULSE10      # Relais 1 für 10s ein, dann aus
MeinPasswort:R2_PULSE30      # Relais 2 für 30s ein, dann aus
MeinPasswort:R1_PULSE2       # Relais 1 für 2s ein (Power-Cycle)

Beispiel: Alle Relais auf Not-Aus

notfall-aus

MeinPasswort:ALL_OFF

Alternative: Web Control Panel

7 Befehlsreferenz Alle Mesh-Befehle

Befehl	Beschreibung	Beispiel
`Rn_ON`		`PW:R1_ON`
`Rn_OFF`		`PW:R2_OFF`
`TOGGLEn`		`PW:TOGGLE3`
`ALL_ON`		`PW:ALL_ON`
`ALL_OFF`		`PW:ALL_OFF`
`STATUS`		`PW:STATUS`
`Rn_PULSEs`		`PW:R1_PULSE10`

Antwort

⚠ Rate-Limit & Lockout

8 CLI-Befehle (Serial Console) Konfiguration über USB

Befehl	Beschreibung
`relay_password <pw>`
`relay_add <hex>`
`relay_remove <hex>`
`relay_wl_on` / `relay_wl_off`
`relay_list` / `relay_wl`
`relay_status`
`relay_test <1-4>`
`relay_pins`
`relay_active high\|low`
`relay_save`
`lora_info`

💡 Persistenz

Beispiel-Session: Komplett neu konfigurieren