mqtt_cul_server's Introduction

MQTT CUL server

This software package provides a bridge to connect a CUL wireless transceiver with an MQTT broker, so that multiple clients (smart home, other apps) can use it over the network to control various smart home devices.

Currently it is used and tested with Somfy RTS rollershutters and shades as well as Brennenstuhl RCS switchable power sockets (Intertechno-compatible) for control and LaCrosse IT+ temperature / humidity sensors (Technoline TX29 DTH-IT) for receiving.

Further information about the CUL: Product page, firmware details.

This software is provided not only as source code, but also as Docker image for ARMv7 processors (Raspberry Pi). An example docker-compose.yml is included.

Device discovery

Home Assistant defines an interface for device auto-discovery, which is supported by this software.

Configuration

CUL

The software supports both the 433 MHz and 868 MHz hardware.

For the CUL, you just need to configure the serial device of the dongle in mqtt_cul_server.ini.

Intertechno

For Intertechno-based switches, you need to configure the system ID, often also called house ID, in mqtt_cul_server.ini and enable it.

Somfy

Somfy RTS configuration is a bit more involved. The documentation is here.

LaCrosse IT+

No configuration required.

mqtt_cul_server's People

Contributors

Stargazers

Watchers

mqtt_cul_server's Issues

Cul MAX! EQ-3

Hello,

will this work mit MAX! EQ-3 also?
https://fhem.de/commandref.html#CUL_MAX

Regards
Marco

Convert to Addon

At the moment this is a standalone Linux/Python software that cannot be installed via supervisor / GUI. It can connect to Home Assistant via MQTT, but apart from that it needs to run completely separately.

As you cannot run “plain” (i.e. non-containerized) software in Home Assistant OS, there’s currently no way to run it on the same device as Home Assistant, if you use the recommended "Home Assistant OS" setup. You can run it on a Raspberry PI with e.g. Raspbian or and other Linux device, but there’s no automated installation yet.

Convert this repository it to a proper add-on to run it from within the supervisor.

FHT / FHT80b support

Any chance to see support for FHT80b devices?

KeyError: 'statedir'

Running this docker image errors out:

Traceback (most recent call last):
  File "/mqtt_cul_server/mqtt_cul_server.py", line 17, in <module>
    mcs = MQTT_CUL_Server(config=config)
  File "/mqtt_cul_server/mqtt_cul_server/__init__.py", line 19, in __init__
    statedir = config["DEFAULT"]["statedir"] or "state"
  File "/usr/local/lib/python3.10/configparser.py", line 1258, in __getitem__
    raise KeyError(key)
KeyError: 'statedir'

Modifying line 4 in mqtt_cul_server.ini to
statedir = /state_dir
solves this.

Recommend Projects

bbock / mqtt_cul_server Goto Github PK