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).
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.
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