HomeMatic-RF Network Bridge

ESP32-S3-basierter Netzwerk-Adapter für HomeMatic-RF. Verbindet ein HM-Funkmodul (HM-MOD-RPI-PCB / RPI-RF-MOD) oder einen unmodifizierten HmIP-RFUSB-Stick via USB-Host mit dem Netz — HB-RF-ETH-UDP für RaspberryMatic, HMUARTLGW-Emulation für FHEM/Homegear, Raw-TCP-Stream, Web-Dashboard, Improv-WLAN- Provisioning.

Funktioniert nur in Chrome, Edge oder Opera auf Desktop — Safari und Firefox unterstützen die Web Serial API nicht.

Unterstützte Hardware

RFNetHM (ESP32-S3)

YD-ESP32-S3-COREBOARD V1.4 (Prototyping)
ESP32-S3 16 MB Flash USB-OTG Dual-OTA

HM-Funkmodul

HM-MOD-RPI-PCB oder RPI-RF-MOD am UART1-Pinheader
UART1 115200 8N1 HMUARTLGW

HmIP-RFUSB-Stick

Unmodifiziert via USB-Host (CP2102N + EFM32)
USB-Host CDC-ACM DualCoPro

Installation

ESP32-S3-Board per USB anstecken (CH343P-Programmierport, typisch /dev/ttyACM0 bzw. COMx).
Im Browser auf „CONNECT“ klicken und den seriellen Port auswählen.
Im Dialog „INSTALL RFNetHM…“ wählen. Das Factory-Image (Bootloader + Partitionen + Applikation) wird in unter 30 s geflasht.
Nach dem Flash bietet das Tool WLAN-Provisioning via Improv-Serial direkt im Browser an (SSID + Passwort eingeben). Alternativ: Board neu starten, der interne Access-Point „RFNetHM XXXX“ öffnet ein Captive Portal zur WLAN-Konfiguration.
Anschließend ist die Web-UI unter http://rfnethm.local bzw. der per DHCP zugewiesenen IP erreichbar. HM-Funkmodul am UART1 oder HmIP-RFUSB-Stick am USB-Host-Port anschließen — die Bridge übernimmt automatisch.

Erst-Flash via Browser: Bei „NEW INSTALL“ wird der Flash vollständig gelöscht und das Factory-Image neu geschrieben. Etwaige WLAN-Credentials und Maintenance-Token im NVS gehen dabei verloren — nach einmaliger Re-Provisionierung sind alle weiteren Updates über das Web-Dashboard (OTA-Update) ohne erneute Konfiguration möglich. Der OTA-Endpoint prüft das Image auf gültiges esp_app_desc.project_name == "rfnethm", ein fremdes Image (z.B. ip4knx) wird abgelehnt.

Was ist drin

HB-RF-ETH-UDP auf Port 3008 — A.R.s Kernel-Modul hb_rf_eth.ko für RaspberryMatic- Container spricht den Stick direkt an
HMUARTLGW-Emulation auf TCP 2330 — FHEM-Define HMUARTLGW uart://<host>:2330, Homegear/rfd analog (DualCoPro→Legacy-Translation für HmIP-RFUSB-Stick, Bypass-Mode für HM-MOD-RPI-PCB am UART)
Raw-HMUARTLGW-TCP-Stream auf Port 2329 — für bmcond und eigene Tools (kein Protokoll-Interpret, reine 0xfd-Frames)
Web-Dashboard mit Live-Statistik (Bridge- Durchsatz, Sink-Verteilung, Stack-HWM, Coredump-Status), Dark/Light-Theme
TX-Master-Soft-Lock — verhindert dass parallel aktive Sinks (RaspberryMatic + FHEM gleichzeitig) sich gegenseitig stören
OTA-Update mit Versions-Check — Image wird auf gültigen ESP-Magic und passenden project_name geprüft, kein Brick durch falsches Image
Improv-Serial für komfortable WLAN-Erstkonfig direkt im Browser
Optionaler Maintenance-Token für OTA + Reset- Endpoints (POST /api/auth/token, offen-by-default)
mDNS-Discovery — _raw-uart._udp:3008, _hmuartlgw._tcp:2330, _http._tcp:80; bmcond's discover-Code findet den Stick automatisch