​​​​​

Aktuelle Version

Stand 28. Dezember 2021 ist jetzt im master Branch auf Github die Version v1.9 als stabile Version von SmartHomeNG verfügbar.

Nur die Version aus dem master Branch sollte für den produktiven Einsatz benutzt werden!




Was ist neu in SmartNomeNG v1.9?

Die Neuerungen erstrecken sich über Erweiterungen und Bugfixes für den Core von SmartHomeNG sowie Änderungen und Bugfixes für diverse Plugins. Es sind auch neue Plugins hinzugekommen. Eine Übersicht über alle Änderungen ist in den Release Notes zu finden. Die aktuellen Release Notes sind unter www.smarthomeng.de zu finden.




Was ist beim Update auf v1.9 zu beachten?
  1. Die minimale Python Version mit der SmartHomeNG startet ist Python 3.6
  2. Es gibt ein neues websocket Modul, welches das visu_websocket Plugin ersetzt. Dieses muss in der ../etc/module.yaml konfiguriert werden. Genaueres ist in der Dokumentation zu finden: http://www.smarthomeng.de/user/konfi...websocket.html
    Im Gegensatz zum bisherigen Plugin, welches nicht mehr benötigt wird, unterstützt das websocket Modul die parallele Nutzung über ws:// und wss://
  3. Einige Plugins, die schon länger als veraltet (deprecated) gekennzeichnet waren, sind aus SmartHomeNG entfernt worden. Falls noch Bedarf nach diesen veralteten Plugins besteht, können diese aus dem Plugin Archive herunter geladen werden.
  4. Falls SmartHomeNG sonst als Linux systemd Service gestartet wird:
    1. Bitte dringend zunächst den Service abschalten
    2. erfolgreiche Installation abwarten, es sollten keine Fehler mehr im Log zu finden sein
    3. Service anpassen siehe
    http://www.smarthomeng.de/user/insta...ng_daemon.html
    4. Service wieder in Betrieb nehmen
  5. Falls die smartVISU zusammen mit dem neuen websocket Modul verwendet wird, muss das smartvisu Plugin konfiguriert sein.
  6. Das neue smartvisu Plugin (mit v1.8 erschienen) sollte verwendet werden, da es eine bessere Integration in die smartVISU ermöglicht als das alte visu_smartvisu Plugin, welches als veraltet (deprecated) gekennzeichnet wurde.




Dokumentation

Unter https://www.smarthomeNG.de findet sich unser Blog und der Startpunkt für die Dokumentation. Mit dem aktuellen Release ist die Entwickler Dokumentation in die Anwender Dokumentation umgezogen. Es gibt keine separate Entwickler-Dokumentation mehr.
Der Develop Branch

Es findet eine aktive Weiterentwicklung statt, daher bitte mit einem Produktionssystem nicht auf den Entwicklungszweig gehen!
Man sollte nur auf den develop Branch gehen, wenn man genau weiß, was man da macht.
Es kann immer mal passieren, dass der develop branch aufgrund der laufenden Entwicklung in einem nicht lauffähigen Zustand ist.


Auch ein Mischen vom master Branch und develop Plugins kann, aber muß nicht klappen, da einige Plugins aus dem develop Branch Funktionalitäten des Core benötigen könnten, die im master branch noch nicht vorhanden sind. In diesem Fall wird das Plugin nicht laden und einen Log Eintrag schreiben.



Unterstützung

Natürlich gibt es hier im Forum Unterstützung. Zusätzlich haben wir auf https://gitter.im/smarthomeNG/smarthome einen Chat für SmartHomeNG eingerichtet. Dort schauen viele User und Entwickler in regelmäßgen Abständen rein.



WICHTIG: Unterstützung bei Fragen und Problemen

Bevor ihr postet oder um Hilfe fragt, bitte
  • im Administrations-Interface einen Überblick verschaffen ob z.B. config files richtig im SmartHomeNG ankommen
  • Im Logfile nach Fehlern oder Warnungen suchen und wenn möglich deren Ursachen beseitigen.
  • SmartHomeNG im Debugmodus starten oder besser: Für nur den betroffenen Teil den Log-Level auf INFO oder DEBUG hochsetzen.

Wenn Ihr Hilfe braucht und nicht weiterkommt werden Euch andere hier im Forum gerne weiterhelfen.



Wenn ihr dann postet, geizt bitte nicht mit Informationen über eure Installation. Wir können alle nicht Hellsehen. Für uns hilfreich oder sogar notwendig sind unter anderem:
  • Beschreibung was ihr erreichen wollt
  • Erläuterung was ihr bisher gemacht habt
  • Genaue Bescheibung des wahrgenommenen Problems
  • ("Läuft nicht" ist da nicht ausreichend...)
  • Erläuterung welches Verhalten ihr erwartet
  • SmartHomeNG Version
  • Python Version
  • Betriebssystem mit Version
  • eingesetzte Hardware
  • Art der Installation
  • (z.B. Nach Komplettanleitung oder Raspberry Pi Image oder Update von Vorversion oder ...)
  • Konfigurierte Plugins (gerne die etc/plugin.yaml mit posten)
  • gegebenfalls die entsprechenden Item Konfigurationen (aus items/*.yaml)


Viel Spaß und viel Erfolg mit Eurem SmartHomeNG!!!