Anleitung Skill HConnect

HConnect

Anleitung zur Nutzung des Alexa Skills HConnect.

Skillbeschreibung

Der Skill HConnect ist ein sogenannter "Smarthome Skill". Smarthome Skills haben den Vorteil, dass man diese ohne einen Rufnamen benutzen kann. Man kann also direkt dem Skill einen Befehl nennen, ohne den Namen des Skills zu nennen. Ein Beispiel hierfür ist z.B. "Alexa! Schalte die Deckenlampe im Wohnzimmer an". Amazon stellt dazu für die Smarthome Skills einen festen Befehlssatz zur Verfügung den der Skill dann nutzen kann. In Abhängigkeit der zu steuernden Geräte können dann die passenden Befehle genutzt werden.

Standard-Befehlssatz

Befehlssatz-Beschreibung:

Aktion Unterstützte Geräte Alexa-Befehl Konfigurationsmöglichkeiten
Temperatur einstellen Heizkörperthermostate, Wandthermostate, Systemvariablen Alexa! stelle [Gerät] auf [Wert] °C/Grad Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Sonstiges -> Raumthermostate
Verhalten: Konfiguration -> Sonstiges -> Heizungssteuerung
Verhalten: Konfiguration -> Transformierungen
Temperatur einstellen Heizkörperthermostate, Wandthermostate, Systemvariablen Alexa! erhöhe die Temperatur [Gerät] um [Wert] °C/Grad Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Sonstiges -> Raumthermostate
Verhalten: Konfiguration -> Sonstiges -> Heizungssteuerung
Verhalten: Konfiguration -> Transformierungen
Temperatur einstellen Heizkörperthermostate, Wandthermostate, Systemvariablen Alexa! senke die Temperatur [Gerät] um [Wert] °C/Grad Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Sonstiges -> Raumthermostate
Verhalten: Konfiguration -> Sonstiges -> Heizungssteuerung
Verhalten: Konfiguration -> Transformierungen
Heizung Komforttemperatur Heizkörperthermostate, Wandthermostate, Systemvariablen Alexa! schalte [Gerät] ein/an Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Sonstiges -> Raumthermostate
Verhalten: Konfiguration -> Sonstiges -> Heizungssteuerung
Verhalten: Konfiguration -> Transformierungen
Heizung Ausschalten Heizkörperthermostate, Wandthermostate, Systemvariablen Alexa! schalte [Gerät] aus/ab Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Sonstiges -> Raumthermostate
Verhalten: Konfiguration -> Sonstiges -> Heizungssteuerung
Verhalten: Konfiguration -> Transformierungen
Licht dimmen (niedriger um 25%) Dimmaktoren, Systemvariablen Alexa! dimme/senke [Gerät] Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Licht dimmen (niedriger um x %) Dimmaktoren, Systemvariablen Alexa! dimme/senke [Gerät] um [Wert] % Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Licht dimmen (höher um 25%) Dimmaktoren, Systemvariablen Alexa! erhelle/erhöhe [Gerät] Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Licht dimmen (höher um x %) Dimmaktoren, Systemvariablen Alexa! erhelle/erhöhe [Gerät] um [Wert] % Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Licht dimmen (auf x %) Dimmaktoren, Systemvariablen Alexa! stelle/setze/schalte [Gerät] auf [Wert] % Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Rolladen und Markisen steuern Rolladen- und Markisenaktoren, Systemvariablen siehe Licht dimmen Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Verhalten: Konfiguration -> Transformierungen
Geräte und Gruppen schalten Alle Aktoren, Systemvariablen Alexa! schalte [Gerät] ein/an|aus/ab Gültige Geräte: Konfiguration -> Funk-Fernbedienungen
Gültige Geräte: Konfiguration -> Sonstiges -> Wandschalter & Taster erkennen
Gerätenamen: Konfiguration -> Kanäle -> Kanäle (Steuerung)
Gerätenamen: Konfiguration -> Systemvariablen -> Steuervariablen
Gerätenamen: Konfiguration -> Ersetzungen
Gruppen: Konfiguration -> Gruppen
Verhalten: Konfiguration -> Transformierungen

Übertragung der Geräte aus der Homematic in den Cloudservice HConnect

Um Geräte mit dem Skill HConnect steuern zu können müssen die zu steuernden Geräte der Alexa-App bekannt gemacht werden. Dazu muss zunächst der Cloud-Service die Geräte aus der Homematic Zentrale auslesen und dann an die Alexa-App weiter geben. Bevor dies passiert durchlaufen die Geräte natürlich die Konfiguration, welche auf der Webseite eingestellt wurde. Dadurch wird den Geräten ggfs. ein anderer Name gegeben, Befehlsgruppen gebildet, oder auch einfach Kanäle ausgeblendet. Das "auslesen" der Geräte in der Homematic-Zentrale geschieht jeweils zu den folgenden Zeitpunkten:

  • Initial nach der Installation des CCU VPN AddOns bei der Verbindung mit dem VPN Server
  • Immer dann, wenn sich die Homematic-Zentrale per CCU VPN AddOn mit dem Cloud-Service (erneut) verbindet
  • Wenn das lokale Gateway genutzt wird immer dann, wenn das Gateway gestartet wird (Ausnahme: Cache ist aktiviert)
  • Regelmäßig 8 mal über den Tag verteilt, also alle 3 Stunden
  • Benutzergesteuert über den Alexa-Befehl "Alexa! Schalte Geräteerkennung ein! (Name in der Konfiguration anpassbar)"
  • Benutzergesteuert über den Button "Homematic Konfiguration einlesen" unter Konfiguration -> Verwaltung

Nach einer Konfigurationsänderung innerhalb der Homematic-Zentrale muss die geänderte Konfiguration der Zentrale immer übertragen werden, da sich diese Änderungen ansonsten nicht in der Alexa-Steuerung auswirken. Man hat also die Möglichkeit entweder maximal 3 Stunden zu warten um die automatische Aktualisierung zu nutzen, oder man nutzt eine der oben genannten manuellen Möglichkeiten zur Aktualisierung.

Übertragung der Geräte zur Alexa-App

Ist die Konfiguration aus der Homematic Zentrale einmal im Cloud-Service übernommen worden kann die umfangreiche Konfiguration vorgenommen werden. Diese Konfiguration hat Auswirkungen auf die in der Alexa-App sichtbaren Geräte. Ggfs. sind Geräte ausgeblendet oder die Namen der Geräte in der Konfiguration angepasst worden. Die Konfiguration kann zunächst in der Weboberfläche im Bereich Konfiguration vorgenommen werden. Ist man mit allen Änderungen fertig, so kann die nun geänderte Konfiguration aktiviert werden. Dazu ist der Button "Geänderte Konfiguration übernehmen" im Bereich Konfiguration -> Verwaltung vorgesehen. Nach einem Klick ist die neue Konfiguration aktiviert und kann genutzt werden.
Nun muss nur noch die Alexa-App über die sich ggfs. geänderten Geräte informiert werden. Auch dies geschieht über den Tag verteilt durch Amazon in regelmäßigen Abständen. Möchte man dies nicht erst abwarten, so hat man hier 2 Möglichkeiten:

  • Benutzergesteuert über den Alexa-Befehl "Alexa! Erkenne meine Geräte"
  • Benutzergesteuert über die Alexa-App ==> Geräte suchen

Häufige Fragen

In der Alexa-App sind keine Geräte sichtbar oder Alexa meldet, dass Sie keine Geräte gefunden hat

Zunächst einmal können die folgenden Punkte geprüft werden:

  • In der Weboberfläche HConect-Web (Status auf der linken Seite): Ist das Gateway Online?
  • Gateway Offline bei lokaler Gateway Installation (z.B. auf Raspberry Pi) ==> Das Gateway ist zu starten. Die Protokolldatei HConnectAll.log gibt Auskunft darüber ob es sich mit dem Cloud-Service verbunden hat
  • Gateway Offline bei Nutzung des HConnect CCU VPN AddOns ==> Es liegt ein Serverproblem vor. Hier ist der Support zu kontaktieren
  • Konnte die Homematic-Konfiguration einglesen werden?
  • CCU-Status bei Nutzung des HConnect CCU VPN AddOns ist nicht "bereit" ==> Die Homematic Zentrale ist entweder nicht mit dem Cloud-Service verbunden oder der Cloud-Service konnte nicht auf die XML-API der Homematic-Zentrale zugreifen. Hier kann der VPN-Status in der Homematic Systemsteuerung überprüft werden (Systemsteuerung -> Button HConnectVPN). Ist die XML-API auf der Homematic installiert?
  • Ist der Skill HConnect in der Alexa-App überhaupt aktiviert und mit dem Benutzerkonto des Cloud-Services HConnect-Web verknüpft? Falls nicht, muss der Skill aktiviert und mit dem Benutzerkonto verknüpft werden
  • Wenn diese Punkt überprüft sind, Alexa aber immer noch keine Geräte erkennt, so hilft es dann meistens den Skill HConnect in der Alexa-App zu deaktivieren und dann erneut zu aktivieren und mit dem Benutzerkonto zu verknüpfen

In der Alexa-App tauchen Geräte wie "Heizung" oder "aufheizen" auf. Wo kommen diese her?

Dieses Verhalten ist immer dann zu beobachten wenn die Konfiguration der Kanalbenennung nicht zu der tatsächlich vorhandenen Kanalbenennung der Geräte innerhalb der Homematic-Zentrale passt. Es sind z.B. Duplizierungen der Kanalnamen für die Heizungssteuerung konfiguriert (unter Konfiguration -> Duplizierungen) und es wurde ein Pattern der Kanalbenennung angegeben, welches nicht den tatsächlichen Kanalnamen entspricht.
Nachdem ein Benutzer sich auf dieser Plattform registriert werden 2 Standard Konfigurationen angelegt. Dadurch soll z.B. aus dem Kanalnamen "Heizung Wohnzimmer" ein weiterer Kanal mit dem Namen "Wohnzimmer Heizung" erstellt werden. Das Ergebnis sind dann 2 unterschiedlich benannte Geräte in der Alexa-App mit welchem ein und das selbe Gerät gesteuert werden kann. Dies erhöht die Erkennungsgenauigkeit von Alexa, man kann also entweder "Alexa! Schalte die Heizung im Wohnzimmer ein" sagen, oder aber auch "Alexa! Schalte im Wohnzimmer die Heizung" ein.
Wenn aber nun der Schaltkanal in der Homematic "Wohnzimmer Heizung" heisst, das Pattern für die Duplizierung aber auf {name} [room] gesetzt ist (also genau umgekehrt), dann kommt es zu diesem Verhalten. Die Lösung ist einfach: Entweder man ändert innerhalb der Homematic das Namensschema, oder man konfiguiert einfach das Pattern innerhalb des Cloud-Services um. Möchte man dieses Feature überhaupt nicht nutzen, so kann die entsprechende Duplizierung auch gelöscht werden. Danach verwirft man in der Alexa-App einmal alle Geräte und lässt die Geräte erneut erkennen.

Wie können Homematic-Programm von Alexa gestartet werden?

Alle auf der Homematic angelegten Programme erscheinen im Bereich Konfiguration -> Programme. Dieser Konfigurationsbereich ist in 2 Bereiche aufgeteilt. Im oberen Bereich werden Programme aufgelistet welche bereits für die Verwendung in Alexa frei geschaltet wurden. Im unteren Bereich erscheinen alle Programme welche in der Homematic angelegt wurden. Anfänglich ist der obere Bereich also leer, da die Freischaltung der Programm durch den Benutzer erst ausdrücklich konfiguriert werden muss.
Um nun ein vorhandenes Programm für die Verwendung in Alexa frei zu schalten benutzt man den grünen Pfeil ganz rechts, welcher neben jedem Programm der Homematic im unteren Konfigurationsbereich erscheint. Dadurch "rutscht" das ausgewählte Programm in den oberen Bereich und kann dort noch einmal konfiguriert werden. Hier kann man einen "Alexa-Namen" vergeben, also den Namen unter welchem man das Programm mit Alexa ansteuern möchte.
Hat man dies nun konfiguriert, so aktiviert man die neue Konfiguration (Konfiguration -> Verwaltung -> Geänderte Konfiguration übernehmen) und lässt Alexa einmal die neuen Geräte erkennen. Dazu sagt man: "Alexa! Erkenne meine Geräte". In der Alexa App wird danach das entsprechende Programm auftauchen und kann mit
Alexa! Schalte [Alexa-Programmname] ein ausgeführt werden.
Programme können NICHT ausgeschaltet werden. Es ist immer nur der Einschaltbefehl verfügbar. Programme können auch nicht "gestartet" werden, da ein Befehl wie z.B. "Alexa! Starte xxx" für das Starten von Skills vorgesehen ist.
Möchte man aber dennoch eine Lösung mit Ein/Ausschalten, so kann man hier mit der Steuerung von Systemvariablen und der Verknüpfung mit einem Homematic-Programm sehr viel erreichen.