Einrichten der Bluetooth-Thermostate von eQ-3

Die Firma eQ-3 stellt verschiedene elektronische Heizkörperthermostate her. Das Eqiva BLUETOOTH® Smart Heizkörperthermostat kann auch von FHEM gesteuert werden. Voraussetzung ist natürlich ein Bluetooth-Empfänger (RasPi 3+4 oder Bluetooth-Dongle).

Hinweis: Es gibt auch Versionen ohne Bluetooth. Bei der Bestellung bitte aufpassen.

Bluetooth einrichten

Standardmäßig sollte Bluetooth auf dem Raspberry Pi schon eingerichtet sein. Nutzt man einen B+ mit Dongle, z.B. als Verlängerung, so müssen unter Umständen folgende Pakete installiert werden:

sudo apt-get install bluetooth, bluez

Danach ein sudo reboot. Ein sudo service bluetooth status sollte zeigen, dass der Daemon läuft. Damit der user fhem bzw. pi auf bluetooth zugreifen kann, muss in bluetooth.conf noch folgendes eingetragen werden:

sudo nano /etc/dbus-1/system.d/bluetooth.conf

<policy user="fhem">
    <allow own="org.bluez"/>
    <allow send_destination="org.bluez"/>
    <allow send_interface="org.bluez.GattCharacteristic1"/>
    <allow send_interface="org.bluez.GattDescriptor1"/>
    <allow send_interface="org.freedesktop.DBus.ObjectManager"/>
    <allow send_interface="org.freedesktop.DBus.Properties"/>
</policy>

sudo systemctl restart dbus

Für den User pi muss natürlich fhem durch pi ersetzt werden.

Thermostat in FHEM definieren

Bevor das Thermostat in FHEM eingebunden werden kann, muss die MAC-Adresse ermittelt werden:

sudo bluetoothctl
scan on

Die Geräte tragen den Namen CC-RT-BLE.

Einrichten mit Perl-Modul 10_EQ3BT

Die eQ-3 Heizkörperthermostate können einfach über define <name> EQ3BT <mac address> eingebunden werden.

Mittlerweile wird nur noch das fhempy-Modul empfohlen

Einrichten mit fhempy

fhempy ermöglicht das Schreiben von FHEM-Modulen in der Programmiersprache Python. Erforderlich ist Python 3.8 oder höher (NICHT 2!), weshalb Debian Bullseye empfehlenswert ist. Es ist auch möglich, fhempy auf Peers zu installieren, um dadurch die Bluetooth-Reichweite zu erhöhen. Dadurch ist eine komplette Abdeckung des Hauses möglich. Auf den Peers muss FHEM nicht installiert werden. Neben dem Raspberry Pi Zero eignet sich auch z.B. der Radxa Rock Pi Zero, getestet mit Armbian. Die Peers können aus FHEM heraus verwaltet werden.

Installation auf FHEM-Server

Um die Heizkörperthermostate unter fhempy einzurichten, sind zunächst einige Vorarbeiten erforderlich. Das Einrichten geht dann genau so simpel. Nach dem obligatorischen sudo apt-get update && sudo apt-get upgrade werden die benötigten Python-Pakete mit

[Debian 11 (Bullseye)]

sudo apt install python3 python3-pip python3-dev libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libglib2.0-dev libdbus-1-dev bluez libbluetooth-dev git libprotocol-websocket-perl

[alle anderen]

sudo apt install python3 python3-pip python3-dev libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libglib2.0-dev libdbus-1-dev bluez libbluetooth-dev git

und als nächstes

sudo cpan Protocol::WebSocket

Das dauert eine Weile. Ich empfehle eine Tasse koffeinhaltiges Heißgetränk. Ist die Installation abgeschlossen, geht es an die Konfiguration von FHEM. Zunächst laden wir per Update die benötigten Dateien herunter:

update add https://raw.githubusercontent.com/dominikkarall/fhempy/master/controls_pythonbinding.txt
update

Ist das Update abgeschlossen, können wir fhempy einrichten:

define fhempy_local BindingsIo fhempy

Es wird automatisch fhempyserver und fhempy_local eingerichtet. Auch hier gilt: nicht nervös werden, wenn fhempy_local nicht sofort connected anzeigt.

Hiermit sind die Vorbereitungen abgeschlossen. Das Thermostat kann nun mit

define <name> fhempy eq3bt <MAC-Adresse>

eingebunden werden. Die benötigten Module werden automatisch nachgeladen.

Installation des fhempy-Peer

Fhempy läuft nicht nur lokal auf dem FHEM-Server. Zur Reichweitenerhöhung kann auch ein fhempy-Peer auf einem oder mehreren RasPi’s installiert und diese über die Wohnung verteilt werden. Geeignet ist natürlich auch ein RasPi, der zur Visualisierung dient.

WICHTIG!! Die folgenden Befehle dürfen nur auf dem Remote-RasPi und nicht auf der FHEM-Instanz ausgeführt werden.

Zunächst müssen die benötigten Python-Pakete wie oben beschrieben installiert werden. Installiere nun fhempy als User pi

pip3 install --upgrade fhempy

Überprüfe, ob die Hauptinstanz auf dem FHEM-Server läuft und starte dann fhempy als User pi auf dem Peer

fhempy

Nach kurzer Zeit siehst du die ankommende FHEM-Verbindung. Nun noch die systemd-Konfiguration, damit fhempy automatisch gestartet wird

curl -sL https://raw.githubusercontent.com/fhempy/fhempy/master/install_systemd_fhempy.sh | sudo -E bash -

fhempy läuft nun unter dem User pi. Möchtest du das ändern, so schau in die Datei fhempy.service im Verzeichnis /etc/systemd/system/ Hinterher das sudo systemctl daemon-reload nicht vergessen. Der Peer sollte in FHEM automatisch erkannt werden (beruht auf Zeroconf). Sollte das nicht der Fall sein, kann der Peer auch manuell definiert werden

define fhempy_peer_IP BindingsIo IP:15733 fhempy

Pairing

Die Thermostate mit einer Software größer 120 müssen mit dem RasPi gepaired werden. Drücke dazu das Rad am Thermostat bis „Pair“ im Display erscheint. Dann führe folgende Schritte aus:

$ sudo bluetoothctl
[bluetooth]# power on
[bluetooth]# agent on
[bluetooth]# default-agent
[bluetooth]# scan on
[bluetooth]# scan off
[bluetooth]# pair 00:1A:22:06:A7:83
[agent] Enter passkey (number in 0-999999): <enter pin>
[bluetooth]# trust 00:1A:22:06:A7:83
[bluetooth]# disconnect 00:1A:22:06:A7:83
[bluetooth]# exit

Optional steps:
[bluetooth]# devices - to list all bluetooth devices
[bluetooth]# info 00:1A:22:06:A7:83
Device 00:1A:22:06:A7:83 (public)
        Name: CC-RT-BLE
        Alias: CC-RT-BLE
        Paired: yes
        Trusted: yes
        Blocked: no
        Connected: no
        LegacyPairing: no
        UUID: Generic Access Profile    (00001800-0000-1000-8000-00805f9b34fb)
        UUID: Generic Attribute Profile (00001801-0000-1000-8000-00805f9b34fb)
        UUID: Device Information        (0000180a-0000-1000-8000-00805f9b34fb)
        UUID: Vendor specific           (3e135142-654f-9090-134a-a6ff5bb77046)
        UUID: Vendor specific           (9e5d1e47-5c13-43a0-8635-82ad38a1386f)
        ManufacturerData Key: 0x0000
        ManufacturerData Value:
  00 00 00 00 00 00 00 00 00                       .........

Dadurch ist das Thermostat nicht mehr mit der calor BT-App steuerbar (und umgekehrt).

Bekannte Probleme

Fehlermeldung nach fhempy-Installation

Meldet pip3 folgendes

  WARNING: The script normalizer is installed in '/home/myname/.local/bin' which is not on PATH.
  Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

so fehlt der Pfad zu fhempy und fhempy kann nicht aufgerufen werden. Es ist folgender Befehl aufzurufen

export PATH=$PATH:/home/myname/.local/bin

also z.B.

export PATH=$PATH:/home/pi/.local/bin

Links