Bugfixes

What's Changed

• Added/extended tests
• Bump ramses_rf client: 0.43.0...0.50.0
• evo zones have target_temperature_step now set to 0.5 C (from 0.1) - precision stays at 0.1 C

Tested with Python 3.13 (lint/mypy/pytest all pass).

What's Fixed

• Bugfix: async_forward_entry_setup is deprecated
• Bugfix: avoid lingering timer

Full Changelog: 0.42.0...0.50.0

Bugfixes

This is release 0.42.0, which includes further tests, and bugfixes.

It includes ramses_rf 0.42.0:

• includes a fix for #198 (not a valid value for dictionary value @ data['class'])

Note that only the config-flow version (this version) of RAMSES is now being maintained.

MQTT is a first class citizen

This is release 0.41.23, which includes config_flow, and initial support for MQTT (i.e. the RMASES_ESP dongle)..

It is based upon 0.41.20, and includes very few changed to ramses_cc,

• switch to pyserial-asyncio-fast (HA's own version of pyserial-asyncio)

... but ramses_rf has been bumped to 0.31.23:

• zxdavb/ramses_rf@0.31.22...0.31.23

Latest release with config_flow

This is release 0.41.20, which includes config_flow.

It is recommended over 0.31.20, which is identical, but without config_flow.

Generally, switching from no config_flow should be considered a one-way migration. Going back is not impossible, but requires some work.

The addition of config_flow is thanks to @trvrnrth!

Highlights: Increased reliability, and evohome faults are becoming a first-class citizen. Also, binding of fake HVAC remotes may now work, where they did not before.

Changes include:

• refactoring of Evohome system faults binary sensor
• addition of get_system_faults service call for evohome controllers
• bump ramses_rf client to 0.31.20
• homogenising sensor descriptors between both config_flow/non-config_flow releases
• hardening test suite - increasing coverage

Changes to ramses_rf include:

• will use pyserial-asyncio-fast if available (may fix #184)
• changes to protocol and startup (may fix #181, #182)
• fix bug that prevented HVAC remotes from binding
• improvements to startup of the serial transport - ?more reliable (may fix #184)
• improvements to the MQTT transport
• less logspam, and more informative logging otherwise
• improvements to 1030, 1260, 3220 parsers
• bugfix excessive polling for OpenTherm bridges (esp. 3220 params/schema pkts)
• various other refactoring, fixes, some minor deprecations, and more intense QA/QI

Latest Latest release without config_flow

This is release 0.31.20, which excludes config_flow.

It is identical to 0.41.20, which is the recommended release, but without config_flow.

Generally, switching from no config_flow should be considered a one-way migration. Going back is not impossible, but requires some work.

Highlights: Increased reliability, and evohome faults are becoming a first-class citizen. Also, binding of fake HVAC remotes may now work, where they did not before.

Changes include:

• refactoring of Evohome system faults binary sensor
• addition of get_system_faults service call for evohome controllers
• bump ramses_rf client to 0.31.20
• homogenising sensor descriptors between both config_flow/non-config_flow releases
• hardening test suite - increasing coverage

Changes to ramses_rf include:

• will use pyserial-asyncio-fast if available (may fix #184)
• changes to protocol and startup (may fix #181, #182)
• fix bug that prevented HVAC remotes from binding
• improvements to startup of the serial transport - ?more reliable (may fix #184)
• improvements to the MQTT transport
• less logspam, and more informative logging otherwise
• improvements to 1030, 1260, 3220 parsers
• bugfix excessive polling for OpenTherm bridges (esp. 3220 params/schema pkts)
• various other refactoring, fixes, some minor deprecations, and more intense QA/QI

Latest stable release (no config_flow)

This is release 0.31.19, which has been tested on HA version 2024.4.x. It does not utilize config flow.

It should be a seamless downgrade to 0.31.16 if you have issues with this version.

Overview

This release of ramses_cc does not utilize config flow!

Changes since 0.31.16 are:

• bump ramses_rf client to latest version, 0.31.19 (main change: more reliable QoS & FSM)
• slightly tweak start-up so more serial port problems are survivable without restarting HA (a WIP)
• tweak the integration to latest HA coding rules

Known Issues

#171 - Fault log broken

Bugs Fixed

May address #181, #182 - complete failure to start integration.

Latest Stable release

Overview

This is version 0.31.16. Note that 0.31.17 has been yanked - this is the latest 0.31.x release.

Note that this version does not include config_flow:

• if you are running 0.31.x, this should be a simple/safe upgrade
• if you are running 0.41.x, you may want to wait for 0.41.16 (but you don't have to, YMMV)

If there is an issue, it should be straight-forward to roll back to 0.31.11 from this version. Mostly, it includes only bug fixes since 0.31.11, and:

• it adds service call icons
• bumps client to 0.31.16 - QoS is now enabled by default

Bugs Fixed

Resolved issues since 0.31.11 include (but are not limited to):

• #163 - ramses_cc.set_zone_mode appears broken (2nd attempt)

It uses an updated version of the ramses_rf client library:

• QoS is now enabled by default
• experimental support for evofw3-over-MQTT (see: https://github.com/IndaloTech/ramses_esp)
• improved logging: better messages, less logspam, no silent discarding of packets
• threadsafeing, parser tweaks, hardening

Stable release

This is the latest stable release, It includes only bug fixes since 0.31.7.

Note that this version does not include config_flow:

• if you are running 0.31.7, this should be a simple/safe upgrade
• if you are running 0.41.7, you may want to wait (but you don't have to, YMMV)

If there is an issue, it should be straight-forward to roll back to 0.31.7 from this version.

With the exception of adding tests via test_homeassistant_custom_component, it contains only bug fixes, including:

• fix battery_level is extra_state_attrs (now scalar, not dict)
• lots of tweaks/fixes to the service calls

Resolved issues include (but are not limited to):

• #169 set_zone_mode - eco_boost is being set for 1 hour
• #164 send_packet - creating invalid address
• #163 set_zone_mode - broken?
• #162 Warning: Entity implements HVACMode(s): heat, off, auto and therefore...
• #157 The gateway type is not determinable, will assume evofw3
• #156 fix errors within 3110 parser
• #151 Message events listener doesn't catch as expected
• #145 fix errors within 01FF parser
• #85 send_pkt service fails with 18:000730 as destination

It uses an updated version of the ramses_rf client library:

• experimental support for evofw3-over-MQTT (see: https://github.com/IndaloTech/ramses_esp)
• improved logging: better messages, less logspam, no silent discarding of packets
• threadsafeing, parser tweaks, hardening

Now with added Config Flow

This is version 0.41.7, which has been tested on HA version 2024.1.x. It is based upon 0.31.7, and should be a seamless transition from that version.

It should not be considered stable (although there are no known issues), so please backup your HA installation before installing this version. If you want to rollback to 0.31.7 (or later), you may need to restore from backup.

Overview

This is the first release of ramses_cc that utilizes config flow.

Many thanks to @trvrnrth for adding config flow to this integration!

Device faking of sensors/switches is now first class

This is version 0.31.7, which has been tested on HA version 2024.2.x. It is considered stable.

It is a stable release, but please backup your HA installation before installing this version.

You should be able to upgrade/downgrade between 0.31.x and 0.2x.. Whilst doing so, there should be no need to (temporarily):

• stop enforcing your known list
• disable your state (packet) cache

Note, however some breaking changes, below, and:

• RFC2217 no longer supported (see #143)

Overview

This is the first release of ramses_cc that exposes version 2 of device faking. Please see the new guide (WIP) in the wiki for:

• sensors, and remotes/switches

It is extensively refactored and includes many fixes over the 0.30.x track, and many, many since 0.2x.x.

These uncorrected bugs have been identified:

• some OTB sensors (dhw_setpoint, and ch_max_setpoint) are often unavailable when they shouldn't be
• fetching controller logbook entries (system faults) is currently broken

Changes in 0.31.7

These bugs have been fixed:

• failed service: ramses_cc.put_co2_level call (zxdavb/ramses_rf@7d918acb)

Changes in 0.31.6

These bugs have been fixed:

• Some esoteric OTB sensors are missing (e.g. _percentage, _value) (zxdavb/ramses_rf@aa257ed)

Changes in 0.31.5

The OTC (outside temperature compensation) sensor has had its friendly name changed to 'OTC active'.

These bugs have been fixed:

• Some OTB binary sensors are constantly true (or false), regardless (zxdavb/ramses_rf@ff8a10e)
• Another cause for gappy (temporarily unavailable) OTB sensors found (zxdavb/ramses_rf@570cc74)
• Missing sensor.10_xxxxxx_max_rel_modulation (zxdavb/ramses_rf@24487a5)

Changes in 0.31.4

These bugs have been fixed:

• CO2 sensors were missing from the ramses_cc.put_co2_level service call
• The material design icons used for relay state (open/closed) were swapped (fixed in commit 8673169).
• The user wasn't warned that hold_secs isn't supported for the remote.send_command service call (#146)
• The binary_sensor.18_xxxxxx_gateway_status sensor had the opposite value (e.g. Problem when is OK) (18109e5)
• The ramses_cc.send_packet service call has a shorted max payload length (#145)
• Backoff (of polling interval) has been disabled for now (39f0a2d0)
• Deprecation (of non-responsive devices) has been disabled for now (88bb9d7)
• Several other binary sensor icons have been improved (78f4f55)
• Fix bug with updating entity state via async_write_ha_state_delayed (1cb73b8)
• Most FAN sensors are exposed by default, as before (2772979)
• Refactoring of OTB._handle_msg() and associated code (e.g. e8ca4c24)
• Lots of unavailable OTB sensors (792e90ab)

Changes in 0.31.3

The default entity_id for the DHW has changed from water_heater.stored_hw to water_heater.01_123456_hw. This will be an issue if you e.g. reset your entity registry, but keep your automations (this is for people with multiple controllers, with at least 2 having DHW)..

The schema sensor, sensor:01_123456_status is now called sensor:01_123456_status.

Retrieving zone schedules has been fixed (status of DHW schedules?).

Retrieving fault logs is currently out of action, pending a re-write; this means binary_sensor.01_123456_active_fault is unavailable.

Changes in/before 0.31.2

Service call names have added/changed. See the wiki for the new service calls.

In particular, these service calls have been removed:

ramses_cc.fake_device      # is now ramses_cc.bind_device
ramses_cc.put_zone_temp    # is now ramses_cc.fake_zone_temp
ramses_cc.put_dhw_temp     # is now ramses_cc.fake_dhw_temp

Note: the new ramses_cc.put_dhw_temp is different to the old put_dhw_temp service call.

Restored many missing / unavailable / entities. These entities, if extant, can be removed:

binary_sensor.10_xxxxxx_actuator_state
binary_sensor.13_xxxxxx_actuator_state

Extraneous sensors, created in error, have been deprecated. They contained oem_code in their entity_id. They can be safely removed in Settings > Devices & Services > Entities.

Note that the following is a real sensor, and so should not be removed:

sensor.10_048122_oem_code