Aktuelle Version
Stand 02.01.2018 ist jetzt im master Branch die Version v1.4.2 als stabile Version von SmartHomeNG verfügbar.
Nur die Master Version sollte für den produktiven Einsatz benutzt werden!
Es ist nicht nur für Anfänger die richtige Wahl.
Szenarien in denen die Notwendigkeit den develop Branch zu nutzen sollte seit Version 1.3 deutlich reduziert werden.
Es ist geplant den 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.
Nach Nutzerbefragung wird es im Abstand von etwa 6 Monaten jeweils ein neues Release geben.
Die nächste Release wird es also frühestens im Juni/Juli 2018 geben.
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.
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.
Dokumentation
Unter https://www.smarthomeNG.de findet sich der Startpunkt für die Dokumentation:
- Die für das Release aktualisierte Anwender-Dokumentation ist unter https://www.smarthomeNG.de/user/ zu finden.
- Die für das Release aktualisierte Entwickler-Dokumentation ist unter https://www.smarthomeNG.de/developer/ zu finden.
- Ausserdem gibt es ein Wiki unter https://github.com/smarthomeNG/smarthome/wiki in dem Informationen zu finden sind und das primär als Sammelquelle für Featurewünsche gedacht ist.
Was ist neu in SmartNomeNG v1.4.2
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
- Spezifische Fehlermeldung hinzugefügt, falls SmartHomeNG keine Konfiguration in ../etc schreiben darf.
- Items:
- Attribut update_by hinzugefügt
- Initialisierung von prev_update und prev_change für Items mit gecachetem Value korrigiert
- Scenes:
- Bugfix: Fehler beim Start von SmartHomeNG abgefangen, wenn noch keine gelernten Werte gespeichert worden waren.
- conf_to_yaml_converter:
- Bugfix: Der Konverter unterstützt jetzt Blöcke von Kommentaren die länger als 11 kByte sind. Jetzt sind Kommentarblöcke bis zu 32 kByte erlaubt.
Neuerungen bei Plugins (neue Plugins / Plugin Erweiterungen)
- Backend:
- Anzeige für Attribut **update_by** hinzugefügt
- CLI:
- In der Liste der Logiken wird nun wieder der Zeitpunkt des nächsten Laufs angezeigt
- ComfoAir:
- Prüfung der `comfoair_trigger` Einstellung korrigiert
- Enigma2:
- Methode set_power_state hinzugefügt
- LIRC:
- Parameter `instance` ist nun optional und kann dann angegeben werden, wenn Mulit-Instance verwendet wird
- RCSwitch-PI:
- Fehlender Import im Code, Troubleshooting-Section in der README erweitert
- UZSU
- Mehr Debug Ausgaben für das Attribut 'active' hinzugefügt
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 Backend 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
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)