CometBlue

eurotronic-cometblue-ha is a library to communicate with your Eurotronic GmbH Comet Blue radiator controllers.

[!NOTE] This library is a fork of zero-udo/eurotronic-cometblue with changes specifically for using it in a Home Assistant custom component. For changes, see zero-udo/eurotronic-cometblue#8.

The device supports up to four programmable schedules for each weekday. Longer periods can be set as holidays. There are 8 holiday slots available. It depends on bleak and bleak-retry-connector and runs therefore on Linux, Windows and macOS in addition to the Home Assistant component.

Compatible devices

Comet Blue radiator controllers are sold under different names:

This library should work with all listed radiator controllers, but is only tested with a Sygonix HT100BT which is the only one I own.

If your device is not listed here but looks similar (or you know it is a rebranded Comet Blue), or if you are able to test this library with another device - let me know your results.

Installation

Just

pip install eurotronic-cometblue-ha

Usage

Import the library and instantiate an object.

Parameters are the device MAC-Address and the (optional) PIN. Depending on your connection quality you can specify a longer or shorter discovery duration.

from eurotronic_cometblue_ha import CometBlue

blue = CometBlue(mac="00:00:00:00:00:00", pin=123456, timeout=2)

or

from eurotronic_cometblue_ha import AsyncCometBlue

blue = AsyncCometBlue(mac="00:00:00:00:00:00", pin=123456, timeout=2)

for an asynchronous client.

The following (synchronous) methods are available, for the asynchronous variants add _async:

:warning: the device applies set values when the connection is closed, not directly after setting them

Examples

Use CometBlueAsync and [method_name]_async for asynchronous handling.

Instantiating and retrieving the current temperature

from eurotronic_cometblue_ha import CometBlue

blue = CometBlue("00:00:00:00:00:00", 123456)
blue.connect()
temp = blue.get_temperature()
print(temp)
blue.disconnect()

or

from eurotronic_cometblue_ha import CometBlue

with CometBlue("00:00:00:00:00:00", 123456) as blue:
    temp = blue.get_temperature()
    print(temp)

results in

{
    'currentTemp': 24.5,
    'manualTemp': 16.0,
    'targetTempLow': 16.0,
    'targetTempHigh': 20.0,
    'tempOffset': 0.0,
    'windowOpen': True,
    'windowOpenMinutes': 10
}

Setting a new schedule

Setting a new schedule for Mondays with two heating periods:

• Period 1 from 06:00 to 08:00

• Period 2 from 16:00 to 22:00

All unmentioned periods (periods 3 and 4) will be disabled (start and end set to 00:00).

Set periods will be consolidated, meaning setting only period 3 via this method will write period 1 and disable the others.

To use this schedule, make sure to disable manual mode.

blue.set_weekday(Weekday.MONDAY,
                 {"start1": "06:00", "end1": "08:00",
                  "start2": "16:00", "end2": "22:00"})
blue.set_manual_mode(False)

Setting a holiday

Setting a holiday (slot 2) from 26th December 2020 18:00 till 5th January 2021 14:00 and keep the temperature at 16.5 °C

blue.set_holiday(2, {"start": datetime(2020, 12, 26, 18),
                     "end": datetime(2021, 1, 5, 14),
                     "temperature": 16.5})

Credits:

• Thorsten Tränker for his reverse engineering work done here
• @zero-udo for the inital library zero-udo/eurotronic-cometblue
• @FloSchmidt for checking the Eurotronic Comet Blue
• @rikroe for the switch to bleak