Aktuelle Version
Stand 31. März 2023 ist im master Branch auf Github die Version v1.9.5 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.5?
Es handelt sich um ein Bugfix-Release, welches außer Bugfixes einige neue Features in den Plugins, sowie ein neues Plugins enthält.
Eine Übersicht über alle Änderungen ist in den Release Notes zu finden. Die aktuellen Release Notes sind in der Anwender Dokumentation unter docs.smarthomeng.de zu finden.
Bitte auch die Release Notes des Wartungs-Releases v1.9.4 beachten!
Was ist beim Update auf v1.9 bzw. v1.9.5 zu beachten?
- Die minimale Python Version mit der SmartHomeNG v1.9.x startet ist Python 3.7
- 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: https://docs.smarthomeng.de/konfigur...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:// - Einige Plugins, die schon länger als veraltet (deprecated) gekennzeichnet waren, sind mit v1.9 aus SmartHomeNG entfernt worden. Falls noch Bedarf nach diesen veralteten Plugins besteht, können diese aus dem Plugin Archive herunter geladen werden.
- 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 https://docs.smarthomeng.de/installa...ng_daemon.html
4. Service wieder in Betrieb nehmen - ACHTUNG: Das pluggit Plugin hat ein massives Update erfahren und die Version 2.x ist in der Konfiguration nicht kompatibel zum pluggit Plugin 1.x!
Bitte in der Dokumentation des Plugins die Unterschiede nachlesen, bzw. nachlesen wie man erstmal mit der Version 1.2.3 des Plugins weiter arbeiten kann. - Falls die smartVISU zusammen mit dem neuen websocket Modul verwendet wird, muss das smartvisu Plugin konfiguriert sein.
- 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. Die Dokumentation ist unter https://docs.smarthomeng.de zu finden. Mit dem aktuellen Release ist die Entwickler Dokumentation in die Anwender Dokumentation umgezogen. Es gibt keine separate Entwickler-Dokumentation mehr.
- Die für das Release aktualisierte Entwickler-Dokumentation ist unter https://docs.smarthomeng.de/entwickl...twicklung.html zu finden.
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!!!