SmartHomeNG

Dokumentation

SmartHomeNG ist ein System das als Metagateway zwischen verschiedenen „Dingen“ fungiert und dient der Verbindung unterschiedlicher Geräte-Schnittstellen. Die Standard-Schnittstelle eines Gerätes wird durch das Metagateway so um viele zusätzliche Schnittstellen erweitert. So ist es möglich dass die Klingel mit der Musikanlage und TV spricht, und dessen Wiedergabe unterbricht oder bei Abwesenheit eine Nachricht per Email verschickt.

Das System kann flexibel durch Plugins erweitert werden, wobei die Plugins in folgende Kategorien klassifiziert sind:

  • Gateway: Anbindung von Devices eines Bus-Systems wie KNX, HomeMatic, EnOcean, 1-wire, DMX, Philips Hue, …

  • Interface: Anbindung einzelner Devices wie AVM Fritzboxen, Heizungssteuerungen, div. AV Devices, …

  • Web-/Cloud-Dienst: Anbindung an diverse Web- bzw. Cloud-Dienste, wie Mail, Prowl, Wetter-Dienste, Alexa, …

  • Protokoll: Unterstützung diverser Protokolle wie TCP/IP, MQTT, XMPP

  • System: Systemnahe Erweiterungen wie Datenbank Anbindung, Visu Anbindung, universelle Zeitschaltuhr, Stateengine (endlicher Automat), …

Die Dokumentation richten sich sowohl an reine Anwender, als auch an Entwickler, die Plugins oder komplexe Logiken erstellen wollen. Informationen zur Entwicklung sind in den Abschnitten Entwicklung und Referenz zu finden.

Diese Dokumentation reflektiert das aktuelle Release:

  • Version des Core: v1.11.0.2 develop (Stand 1. April 2026, commit bfa417d)

  • Version der Plugins: v1.11.0.1 develop

Hilfe zu SmartHomeNG gibt es im Supportforum im KNX-User-Forum oder im Chat auf gitter.im .

Hinweis

Mit Release der Version 1.12 wurden die folgenden Konventionen in der Dokumentation eingeführt:

  • Datei- und Ordnernamen werden relativ zum SmartHomeNG-Stammverzeichnis (standardmäßig /usr/local/smarthome/) angegeben

  • Dateien und Ordner, die Nutzerkonfigurationen enthalten, werden unterhalb von etc referenziert. Dies entspricht dem zukünftigen Standard, der mit der Kommandozeilenoption -e / –config-etc oder mit der Option config_etc: true in der etc/smarthome.yaml aktiviert werden kann.

Bemerkung

Anmerkungen und Änderungswünsche zu dieser Dokumentation bitte auf dieser Feedback Seite hinterlassen.