Die Version v1.4.1 ist gerade released worden.
Aktuelle Version
(Stand 23.12.2017) ist jetzt im master Branch die Version v1.4.1 als stabile Version von SmartHomeNG verfügbar.
Diese Version sollte für den produktiven Einsatz benutzt werden! Es ist nicht nur für Anfänger die richtige Wahl.
Ab Version 1.3 sollten die Szenarien in denen die Notwendigkeit den develop Branch zu nutzen deutlich reduziert werden.
Wir Ändern die Release Strategie und werden einen neuen Stand der Plugins zeitlich losgelöst vom eigentlichen SmartHomeNG Release im master Branch mehrfach im Jahr verfügbar machen. Wichtige Ãnderungen an Plugins oder neue Plugins werden bei Bedarf auch außerhalb der "Plugin Releases" im master Branch verfügbar gemacht.
Normalerweise wollen wir uns für Releases des Core von SmartHomeNG auf einen Zyklus von ca. 6 Monaten einpendeln. Die Änderungen am Core sind jedoch aktuell so vielfältig und gravierend, dass wir uns jetzt für ein SmartHomeNG Release entschieden haben, statt nur die Plugins zu aktualisieren. Diverse Plugins würden in der aktuellen Version ohne den neuen Core nicht laufen.
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.
Auch ein Mischen vom master Branch und develop Plugins kann, aber muß nicht klappen.
Beispiel: Master Branch V1.1 vom 13.04.2016 zusammen mit AVM Plugin vom Juni 2016 kann nicht funktionieren.
smarthomeNG ist als Organisation bei Github angelegt, so dass mehrere Admins Schreibrechte auf das Repository haben.
Links
- Es gibt eine neue Homepage unter https://www.smarthomeNG.de. (Aktuell leitet diese Seite noch auf die Anwender-Dokumentation weiter)
- Es gibt weiterhin die Homepage bei Github unter https://github.com/smarthomeNG/smarthome/.
Dokumentation
- Die für das Release aktualisierte Anwender-Dokumentation ist unter https://www.smarthomeNG.de/user/ zu finden.
- Die für das Release aktualisierteEntwickler-Dokumentation istunter https://www.smarthomeNG.de/developer/ zu finden.
Die Anwender Dokumentation ist in Deutsch gehalten und erklärt die Installation und Konfiguration. Außerdem enthält sie eine Liste der verfügbaren Plugins.
Die Entwickler Dokumentation ist in Englisch gehalten und stellt Entwicklern von Plugins und Interessierten, die bei der Weiterentwicklung des Core helfen wollen, benötigte Informationen zur Verfügung.
Wiki
Das Wiki ist ebenfalls auf Github unter https://github.com/smarthomeNG/smarthome/wiki zu finden. Dort findet sich unter anderem:
- weitergehende Informationen
- Raum um Feedback und Wünsche zur Anwender- und Entwickler-Dokumentation zu hinterlassen.
Was ist neu in SmartNomeNG v1.4.1
Die Neuerungen erstrecken sich über den Core von SmartHomeNG und die Plugins. Im folgenden sind wichtige Änderungen aufgeführt. Die vollständigen Release Notes können in die Anwender Dokumentation oder die Entwickler Dokumentation nachgelesen werden.
Neuerungen im Core von SmartHomeNG
- Zusammensetzung des Versions-Strings aus GIT Informationen korrigiert
- Items:
- Bugfix: Exception abgefangen, falls on_update oder on_change zu einem nicht existierenden Item zuweisen wollen
- Bugfix: Expansion von relativen Item-Pfaden, wenn das Item Attribut kein String sondern eine Liste von Strings ist
- Casting für lists und dicts so erweitert, dass Werte vom Type str entsprechend gecastet werden (über json.loads)
- Beim Laden von Item Definitionen wird bei Anwender-Definierten Items der Quell-Dateiname im Item gespeichert (zur Anzeige im Backend und für zukünftige Features)
- Scheduler:
- Zeiten mit sunrise/sunset in crontab werden jetzt timezone aware wiedergegeben statt mit utc
Neuerungen bei Plugins (neue Plugins / Plugin Erweiterungen)
- AVDevice:
- Anpassungen
- Backend:
- Grundsätzliche Editierbarkeit von Items der Typen list und dict
- Für Anwender-definierte Items: Anzeige des Dateinamens in dem das Item definiert wurde
- Anzeige der SmartHomeNG Version erweitert
- Aus der Logging-Liste werden Logger herausgefiltert, die nur einen NullHandler haben.
- CLI:
- Durch das erweiterte Casting für lists und dicts ist es möglich mit dem CLI Plugin Listen und Dictionaries Werte zuzuweisen
- mail:
- Gmail Support hinzugefügt
- UZSU:
- Zeiten mit sunrise/sunset werden jetzt timezone aware wiedergegeben statt mit utc
Unterstützung
Natürlich gibt es hier im Forum Unterstützung. Zusäzlich 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.
Fehlerbehebung
Bevor ihr postet oder um Hilfe fragt, bitte
- im Backendeinen Ü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
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)