Grundlagen Homegear / Starter-Guide

Deutsche Foren Allgemein
#21

Homegear auf docker - erste Schritte

Weitere Infos finden sich auch noch im Anschluss des zitierten Beitrags. Vielen Dank an @jipp !

#23

Homematic AES

WICHTIG!
Die meisten Homematic-Geräte nutzen einen AES-Handshake um sicher zu stellen, dass nur eine authentifizierte Basis Befehle erteilen darf. Nutzt ihr den Standard-AES-Schlüssel oder den der in der Config-Datei steht, können Unbefugte im schlimmsten Fall eure Geräte schalten.

Das hat zur Folge, dass Geräte, die nicht korrekt von eurer Basis (Homegear/CCU) abgelernt wurden, nicht an einer neuen Basis angelernt werden können. Auch ein Werksreset nutzt dann nichts - das Gerät muss dann zu eQ-3 geschickt werden und kostenpflichtig neu bespielt werden.

Wichtig ist also die Vergabe einer eigenen centralAddress und eines eigenen rfKey. Diese sind in der homematicbidcos.conf einzustellen. Dort ist auch erklärt wie man den rfKey ändern kann, sofern man den “alten” rfKey noch hat.
Der rfKey darf nur aus A-Z und 0-9 bestehen.

Siehe auch: https://doc.homegear.eu/data/homegear-homematicbidcos/configuration.html#homematicbidcos-conf

#24

Betrieb

Nach der Installation läuft Homegear als Dienst im Hintergrund. Mittels sudo service homegear restart kann der Dienst bei Bedarf - zum Beispiel nach Änderungen an den Konfigurationsdateien - neu gestartet werden.

Geräte an-/ablernen

Über die Konsole (sudo homegear -r) können Geräte an Homegear an- und abgelernt werden. Gleiches geht auch mit dem unter Windows lauffähigen Homematic-Konfigurator. Zukünftig wird Homegear ein eigenes Webinterface zu diesem Zweck mitbringen.
Siehe: https://doc.homegear.eu/data/homegear-homematicbidcos/adding_devices.html

Das im Link gezeigte Verfahren ist analog zu allen Protokollen anzuwenden, sofern Geräte angelernt werden müssen.
Leuchten der Philips Hue Bridge sollten über fs 5 und anschließendes search gefunden werden und können mit darauf folgendem ls angezeigt werden. Initial muss einmal der Knopf auf der Bridge gedrückt werden, damit Homegear mit dieser Authentifizierungsinformationen austauschen kann. Auch über die Hue-App angelegte Gruppen werden als einzelne Geräte repräsentiert.
Beispiel:

(Family)> ls
         ID │ Name                      │  Address │ Serial Number │ Type │ Type String               │ Firmware │ Config Pending │ Unreach
────────────┼───────────────────────────┼──────────┼───────────────┼──────┼───────────────────────────┼──────────┼────────────────┼────────
            │                           │          │               │      │                           │          │                │        
         18 │ Regal                     │ 00000001 │   HUE00000001 │ 0304 │            Philips LWB004 │     1336 │             No │      No
         19 │ Stehlampe                 │ 00000002 │   HUE00000002 │ 0304 │            Philips LWB004 │     1336 │             No │      No
         29 │ Wohnzimmer                │ 00000001 │  *HUE00000001 │ 1000 │          Philips Hue Team │        ? │             No │      No
────────────┴───────────────────────────┴──────────┴───────────────┴──────┴───────────────────────────┴──────────┴────────────────┴────────

Mit Sonos habe ich leider keine Erfahrung…

#25

Datenpunkte Geräte

Am einfachsten kann man sich die nach dem Anlernen zur Verfügung stehenden Datenpunkte der Geräte mittels Homegear-Konsole anzeigen lassen. Die geschieht nach der Auswahl des Gerätes (peer select) in der passenden Familie (fs) mit config print.

Es wird zwischen Werten (value) und Konfigurationsparametern (param) unterschieden. Werte können mit getValue gelesen und mit setValue geschrieben werden. Konfigurationsparameter mit getParamset und putParamset.
Mehr dazu unter https://ref.homegear.eu/php.html#affixSection1

Homegear enthält device description files in denen alle Datenpunkte der Geräte hinterlegt sind. Manchmal hilft also auch ein Blick in diese.
Zu finden auf Github im entsprechenden Modul unter misc/Device Description Files und dann nach dem Kürzel des Gerätes suchen.
Mittlerweile gibt es auch keine komplette Liste der Geräte unter https://ref.homegear.eu/devices/

Für Homematic-Geräte gibts es sogar von eq3 selbst eine recht ausführliche Dokumentation. (Danke @Sydney).

Automatisierung
Natürlich macht es Sinn, die per homegear verbundenen Geräte zu automatisieren. Viele Geräte bringen bereits eine gewissen Grundlogik mit.

#26

weiterführende Links

Homegear Reference (en) PHP/RPC Methoden
Homegear Documentation (en) Dokumentation Core/Familien
Homegear Base Library (en) Doxygen Kommentare aus dem Quellcode
Homegear auf GitHub

Homegear Visualisierung Beispielvisualisierung einer Wohnung

1 Like
#27

Thermostate (Homematic, Max)

Homematic- oder Max-Thermostate besitzen eine interne Automatik mit der sie genau genommen auch ohne homegear funktionieren. Dies wird über Wochenprogramme auf den Thermostaten gespeichert. Dieses Wochenprogramm kann über die PHP-Script-Engine mittels putParamset gefüttert werden: Homegear auf Raspberry im Docker-Container --> PHP Scripte werden nicht ausgeführt

@Zennix hat ein kleines Windows-Tool geschrieben, das den benötigten PHP-Code erzeugt: Homegear Script Editor :thumbsup:

#28

Likes bitte im obersten Beitrag an unseren geschätzten Moderator @pmayer, welcher diesen Thread federführend ins Leben gerufen hat :blush:. Vielen Dank auch an dieser Stelle von mir!

Fragen und Anregungen zu diesem Thema sind dort willkommen: Grundlagen Homegear / Starter-Guide - Diskussionsthread

hier gehts ganz nach oben zum Inhaltsverzeichnis

1 Like