Einrichten der Bluetooth-Thermostate von eQ-3

	An dieser Seite wird momentan noch gearbeitet.

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 üblichen 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 Remote-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.

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