====== Amazon Echo / HA-Bridge  ======

==== Installation auf Raspberry Pi ====

  * Hier ist eine Anleitung zur Installation der HA-Bridge und der Einbindung von Loxone: [[http://www.kohlenklau.de/amazon-echo-steuert-loxone-smarthome/]]
  * Eine zweite sehr gute Anleitung: [[http://www.meintechblog.de/2017/05/alexa-licht-an-pimp-my-smart-home-loxone-fhem-in-unter-einer-stunde/]]

==== Installation auf Loxberry ohne Plugin Verwendung ====

Ab Loxberry V1.x.x muss der Loxberry Dienst //Simple Service Discovery Protocol (SSDP) //unter// LoxBerry-Dienste > Optionen// deaktiviert werden. Erst dann kann startet die HA-Bridge fehlerfrei starten.

Die aktuelle HA-Bridge hat die Download-URL [[https://github.com/bwssytems/ha-bridge/releases/download/v5.1.0/ha-bridge-5.1.0.jar]]

<code bash>
loxberry@raspberrypi:~ $ sudo mkdir /home/pi/habridge
</code>

<code bash>
loxberry@raspberrypi:~ $ cd /home/pi/habridge
</code>

<code bash>
loxberry@raspberrypi:~/habridge $ wget https://github.com/bwssytems/ha-bridge/releases/download/v5.1.0/ha-bridge-5.1.0.jar
</code>

Das Erstellen des Start-Scripts braucht man auch nicht, sondern besser als Service konfigurieren: [[https://github.com/bwssytems/ha-bridge#system-control-setup-on-a-pi-preferred]]

<code bash>
loxberry@raspberrypi:~ $ cd /etc/systemd/system
</code>

<code bash>
loxberry@raspberrypi:~ $ sudo nano habridge.service
</code>

Standardmäßig startet das Service auf Port 80 (geht nicht, dort ist der Loxberry Apache), deswegen im habridge.service File zusätzlich den Startparameter -Dserver.port=8080 mitgeben. Das gesamte File schaut dann in etwa so aus:

<code ini>
[Unit]
Description=HA Bridge
Wants=network.target
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/pi/habridge
ExecStart=/usr/bin/java -jar -Dserver.port=8080 -Dconfig.file=/home/pi/habridge/habridge.config /home/pi/habridge/ha-bridge-5.1.0.jar

[Install]
WantedBy=multi-user.target
</code>

Danach den Service starten und enablen.

<code bash>
loxberry@raspberrypi:~ $ sudo systemctl daemon-reload
</code>

<code bash>
loxberry@raspberrypi:~ $ sudo systemctl start habridge.service
</code>

<code bash>
loxberry@raspberrypi:~ $ sudo systemctl enable habridge.service
</code>

==== Installation auf Loxberry mit Plugin Verwendung ====

Hier gibt es das HA Bridge Plugin: [[plugins:loxberry_ha_bridge:start|LoxBerry HA Bridge]]

==== Einrichtung / Konfiguration der HA-Bridge ====

=== Automatisch ===

  * Wer schnell und einfach all seine Loxone Komponente in die HA-Bridge eintragen möchte kann dies mit dem folgenden Tools erledigen.\\
https://github.com/escalate/loxone-ha-bridge-importer
  * Eine kurze Anleitung findet ihr hier [[modifikationen_hacks:amazon_echo_habridge:loxone_ha_bridge_importer_anleitung|Loxone HA-Bridge Importer Anleitung]]

=== Manuell ===

  * In HA-Bridge 5.1 schaut das UI etwas anders aus als in 3.5, sonst ist die Kohlenklau-Anleitung aber immer noch korrekt zum Einrichten der HTTP-REST-Aufrufe zum Miniserver.

{{modifikationen_hacks:amazon_echo_habridge:1197146220.png?w=340}}

{{modifikationen_hacks:amazon_echo_habridge:1197146222.png?w=340}}

Ausführliche Anleitung als PDF zur Installation und Konfiguration der HA-Bridge mit Loxone V1.0.3: {{modifikationen_hacks:amazon_echo_habridge:1209205530.pdf|1209205530.pdf}}

===== Hinweis =====

Amazon hat ein Update an seinen Alexa Geräten durchgeführt. Dieses Update führt dazu, dass die Geräte aus der HA-Bridge nicht mehr gefunden werden. Vereinfacht kann man sagen, dass die Geräteseriennummer (HUE-DeviceID) der HA-Bridge das Problem verursachen. Alexa erwartet seit dem Update ein anderes DeviceID Muster.

|Alexa erwartet folgendes Muster|00:17:88:XX:XX:XX:XX:YY-YY|
|HA-Bridge Muster               |ec:89:56:63:7a:99:78-7b   |

Es fällt auf, dass die erwartete Seriennummer länger ist, mit 00 beginnt und die letzten zwei Ziffernblöcke identisch sind.

Die Seriennummer in der HA-Bridge zu ändern geht z.b. über Add/Edit. Das Feld der Seriennummer ist ein Readonly Feld. Der Readonly verweis kann jedoch mit den Browser-Entwicklungstools (Taste F12) gelöscht werden, sodass in das Feld geschrieben werden kann.

{{modifikationen_hacks:amazon_echo_habridge:1282867951.png?h=250}}

Öffnen der Entwicklungstools mit F12

  - Feld auswählen mit dem Tool
  - Auswahl des Feldes
  - readonly="" im Quellcode entfernen
  - Am Anfang 00: hinzufügen und am Ende die letzten beiden Zifferngruppen in eine Identische verändern.

Vielleicht wird der Fehler aber auch in einer der nächsten Versionen der HA-Bridge angepasst.

Quelle: https://github.com/bwssytems/ha-bridge/issues/1293