Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[crycode]

Hallo liebe ioBroker-Gemeinde,

ich habe einen neuen Adapter zur Integration von RadioHead (Funk-) Netzwerken in ioBroker erstellt.

Die Kommunikation erfolgt über eine serielle Schnittstelle. Zur Anbindung von Funk-Hardware kann ein kleiner Mikroprozessor (z.B. ein Arduino Nano) als Gateway verwendet werden.

Hintergrund

RadioHead ist eine Open Source paketbasierte Funkmodul-Bibliothek für Mikroprozessoren. Es bietet adressierte, zuverlässige, wiederholt übertragene und bestätigte Nachrichten in variabler Länge.
Ich nutze es unter anderem für eine bidirektionale Funkverbindung zwischen einem selbst entwickelten automatischen Bewässerungssystem für das heimische Gewächshaus und der Zentrale meiner Heimautomatisierung.

Für die Anbindung der Funkhardware an einen Rechner wird ein Serial-Radio-Gateway benötigt. Dies ist im einfachsten Fall ein Arduino Nano mit den entsprechenden Funkmodulen und einem kleinen Sketch, der die Pakete zwischen und Funk und der seriellen Schnittstelle hin und her reicht. (Beispielsketch)

Features

• Empfang von Nachrichten/Befehlen von anderen Knoten im RadioHead-Netzwerk.
• Senden von Nachrichten/Befehlen an andere Knoten im RadioHead-Netzwerk.
• Einzeln konfigurierbare Objekte für eingehende und ausgehende Daten.
• Möglichkeit RadioHead-Nachrichten über Skripte zu senden.
• Möglichkeit empfangene RadioHead-Nachrichten über Skripte auszuwerten.

Wird über die serielle Schnittstelle eine Nachricht empfangen, die zum Muster eines Objektes der eingehenden Daten passt, so werden die Daten daraus extrahiert und von dem Adapter in den State des Objektes geschrieben.

Zum Senden von Daten werden die Daten einfach in den State des konfigurierten Objektes der ausgehenden Daten geschrieben und der Adapter sendet dann die Daten nach dem eingestellten Muster.

Installation

Der Adapter ist aktuell über das latest-Repository verfügbar.

Alternativ kann er über die URL https://github.com/crycode-de/ioBroker.radiohead.git installiert werden.

Beschreibung

Eine vollständige und umfangreiche Beschreibung inklusive Erklärungen zu den einzelnen Konfigurationsmöglichkeiten ist hier zu finden.

Aufgrund der unterschiedlichsten Daten, die mit einer RadioHead-Nachricht empfangen oder gesendet werden können, ist die Konfiguration so flexibel wie möglich aufgebaut und wirkt auf den ersten Blick vielleicht auch etwas komplex.

Je nach Konfiguration werden die einzelnen Objekte unter radiohead.<instanz>.data.<in|out>.<name> automatisch erstellt. Bei Objekten für eingehende Daten wird der State entsprechend aktualisiert, sobald eine passende RadioHead-Nachricht empfangen wurde. Bei Objekten für ausgehende Daten kann der neue State in das Objekt geschrieben werden und der Adapter sendet daraufhin die entsprechende RadioHead-Nachricht.

Über radiohead.<instanz>.info.* werden zu dem ein paar allgemeine Informationen zur Verfügung gestellt.

Screenshots

---

Verbesserungsvorschläge und ggf. Bug-Meldungen sind gerne willkommen. :-)

Viel Spaß beim Testen!