Selve NG

Überblick

Zusammenfassung der README und des Codes von Kannix2005/homeassistant-selve, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

• Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.

• Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.

• Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

• Abdeckungen
• Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Texte aus dem Code von Kannix2005/homeassistant-selve. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Aktionen

• Ping GWPingt das Gateway - Mit Hilfe der Methode „selve.GW.service.ping“ wird das SELVE USB-RF Gateway auf einfache Weise angesprochen. Dieser Befehl ist ohne Parameter entsprechend kurz, so dass mit Hilfe der Methode ein schnelles, automatisiertes Auffinden des Gateways möglich ist. Als Initialisierungsbefehl kann hier z.B. die Anwendung im Falle mehrerer, vorhandener COM Ports das Gateway schnellstmöglich lokalisieren, ohne dass der Anwender einen COM Port vordefinieren muss.
• GW StateHolt den Status des Gateways - Mit Hilfe der Methode „selve.GW.service.getState“ wird der aktuelle Status des Gateways gelesen. Befindet sich der USB Stick z.B. im Bootloader sind nur eingeschränkt Methoden erreichbar – siehe entsprechendes Kapitel unten. Damit die Anwendung einwandfrei funktioniert sollte eine Anwendung stets warten, bis der Status „Ready“ erreicht ist. Während der „StartUp“ Phase sorgt das Gateway für ein automatisierter Abgleich der internen Informationen eingelernter Aktore, so dass am Ende alle verfügbaren Daten aktualisiert sind. Folgende Statusinformationen werden der Anwendung mitgeteilt: Bootloader Der USB Stick befindet sich im Bootloader. Dieser Bereich ist nach dem Neustart für zwei Sekunden aktiv. Wird kein Firmwareupdate durch die Anwendung durchgeführt und wechselt der Zustand nicht, so signalisiert dies eine mögliche fehlerhafte Firmware. In diesem Fall muss ein neues Firmwareupdate gestartet werden. Update Der USB Stick befindet sich im Bootloader und es wird aktiv ein Firmwareupdate durchgeführt. Ein Update muss durch die Anwendung komplett durchgeführt werden, bevor die eigentliche Firmware wieder lauffähig ist. Ein abgebrochenes, bzw. unterbrochenes Firmwareupdate kann jedoch aus dem Bootloader jederzeit neu gestartet werden. StartUp Die eigentliche Firmware ist gestartet und die StartUp Phase läuft. In dieser Zeit holt sich das Gateway alle aktuellen Zustände der eingelernten Aktore. Je nach Anlagengröße kann die StartUp Phase unterschiedliche Zeiten in Anspruch nehmen. Ready Ist die StartUp Phase beendet, so ist das Gateway betriebsbereit und kann verwendet werden. Alle erhaltenen Akturzustände sind auf Stand und können direkt ausgelesen und verwendet werden. Der Ereignismanager ist nun aktiviert und informiert so die Anwendung automatisch über sich ändernde Zustände.
• GW-Firmware-VersionHolt die FW Version des Gateway - Mit Hilfe der Methode „selve.GW.service.getVersion“ können die aktuellen Versionsinformationen der aktuell installierten Firmware des Gateways gelesen werden. Die Firmwareversion des USB Sticks setzt sich aus 4 Ziffern zusammen, die wie folgt zu interpretieren sind: Part1.Part2.Part3.Revision (z.B. 16.02.03.01) Weiterhin wird die im Stick verwendete Version der SELVE XML Spezifikation angezeigt: Part1.Part2 (z.B. 2.0) HINWEIS Die einzelnen Integerwerte liegen im Gateway als HEX Werte vor, die für eine einheitliche, korrekte Darstellung konvertiert werden sollten.
• GW SerialHolt die Seriennummer des Gateway.
• GW SpecHolt die Specnummer des Gateway.
• Reset GWResettet das Gateway. - Mit Hilfe der Methode „selve.GW.service.reset“ kann ein Softwarereset durchgeführt werden. Beim Empfang der Methode wird die entsprechende Antwort der Anwendung gesendet und daraufhin neu gebootet. Diese Methode wird z.B. dazu genutzt um ein Firmwareupdate durchführen zu können. Nach einem Reset sollte die Anwendung stets mit den entsprechend Methoden „selve.GW.service.ping“ und/oder „selve.GW.service.getState“ die gewünschte Bereitschaft abwarten.
• Werksreset GWACHTUNG! - Setzt das Gateway auf den Werkszustand zurück. Mit Hilfe der Methode „selve.GW.service.factoryReset“ kann das SELVE USB-RF Gateway auf den Werkzustand zurückgesetzt werden. Wird dieser Befehl ausgeführt, so werden alle benutzerspezifischen Einstellungen, eingelernten Sender, Aktore, etc. gelöscht.
• LED GWSchalte Status LED an oder aus
• LED GW abrufenHole Status der Status LED
• Update AllAktualisiert alle bekannten Geräte
• Set ForwardÄndere Commeo Forwarding - Mit Hilfe der Methode „selve.GW.param.setForward“ kann das commeo Forwarding im Gateway aktiviert, bzw. deaktiviert werden. Bei aktiviertem Forwarding bedeutet dies, dass das Gateway als zusätzliches Routing Element in einem commeo System agiert. Je nach Anlagensituation kann diese Funktion im Gateway ausgeschaltet werden, da z.B. der Installationsort des Gateways dagegen spricht. Im Werkszustand ist diese Funktion stets eingeschaltet.
• Get ForwardHole Commeo Forwarding
• Set EventsÄndere Eventmanager Config - Mit Hilfe der Methode „selve.GW.param.setEvent“ kann der Ereignismanager des Gateways individuell eingestellt werden. Aktivierte Ereignisse sorgen dafür, das Änderungen das Gateway automatisch der Anwendung mitteilt, so dass die Anwendung kein Polling von Statusinformationen durchführen muss. EventDevice Ist die Einstellung aktiviert, so sendet das Gateway automatisch alle Zustandsänderungen der eingelernten Aktore. EventSensor Ist die Einstellung aktiviert, so teilt das Gateway der Anwendung veränderte Sensordaten automatisch mit. EventSender Ist die Einstellung aktiviert, so meldet das Gateway automatisch eingehende Betätigungen eingelernter Sender der Anwendung. Logging Ist die Einstellung aktiviert, so sendet das Gateway mögliche Logs der externen Anwendung. Das Gateway selbst besitzt keinen Speicher für Logs, so dass dies die Anwendung an dieser Stelle übernehmen muss. EventDuty Ist die Einstellung aktiviert, so sendet das Gateway automatisch Veränderungen der Funkressourcennutzung.
• Get EventsHole Eventmanager Config
• Get DutyFunkressourcennutzung auslesen - Mit Hilfe der Methode „selve.GW.param.getDuty“ kann die aktuelle Funkressourcennutzung des Gateways gelesen werden. Aufgrund des genutzten ISM-Bands 868 MHz sorgt das Gateway selbständig dafür die geforderten Richtlinien einzuhalten. Die hier gelesene Auslastung wird in Prozent mitgeteilt. Dieser Wert gibt an, wie groß die aktuelle Auslastung bezogen auf des erlaubten Grenzwerts ist. Eine 100 %ige Auslastung bedeutet, dass der Grenzwert, der nach der Richtlinie erlaubten Funkauslastung, erreicht wurde.
• Get RFFunkinformationen auslesen
• Gerätesuche startenStarte Aktorscan
• Gerätesuche stoppenStoppe Aktorscan
• Gerätesuche StatusErgebnis des Aktorscans
• Save deviceSpeichere Aktor im Gateway

Aus der README