Skip to content

Conversation

Sopsy
Copy link

@Sopsy Sopsy commented Sep 14, 2025

Proposed change

  1. Fixes the missing cooling mode this thermostat has, but is not easily available to be toggled due to ZHA misintepreting "HEATING_ONLY" as something that cannot be toggled to "COOLING_ONLY". Bosch probably means that it does not automatically change to cooling when it's heating only.
    It uses the undocumented 0x06 "centralite specific" value, which works perfectly for this thermostat as well.

  2. Adds Imperial/Metric config option for the temperature reading on the thermostat itself.

  3. Moves Operating mode from Diagnostic to Config, so it is easier to change from the UI. In reality Manual is usually the only mode people would like to use with HA, but this change makes it easier to change to that (default on the thermostat is Schedule).

  4. Adds back "Heating demand" that was removed with the fix of ZHA Bosch thermostat shows state as heating while cooling home-assistant/core#151763. It is useful information, and I would not want to remove it completely, rather rename it so ZHA does not get confused.

  5. Adds an entity for outdoor temperature sensor, useful for automations. This is shown in the top right corner of the screen along with a tree icon indicating "outdoors". The default is indeed -327.68C, but as long as the value is never changed, nothing is displayed on the screen. Valid range is -99.9 - 99.9 C. -100C and below is displayed as Lo, and 100C and higher is not displayed at all, so it can be used as a way to remove the number from the screen.
    To get rid of the temperature in the corner, the thermostat can be rebooted or the value set to anything over 10 000. After a reboot it's gone, but comes back after the first write to the value.

  6. Adds the NC/NO setting for valves.

  7. Adds the Min/Max cool setpoint limit config.

  8. Adds the external sensor (usually a floor sensor) connection setting.

  9. Adds the Valve status LED setting.

  10. Adds the heater type (underfloor, boiler, radiator, central heating) setting.
    According to Bosch documentation and recent research, the meaning is following:
    Underfloor heating: 230V relay output.
    Boiler: Potential free relay output. (Removed from the Bosch Smart Home app, replaced with Central heating)
    Radiator: Radio only.
    Central heating: Relay disconnected (not used), everything is controlled by the controller and not the thermostat. Thermostat only reports the heating demand to the controller.

Especially 6, 8 and 10 are crucial for some setups, previously completely preventing using this thermostat without the Bosch Smart Home Controller because they are not changeable from the thermostat itself when it is connected to a Zigbee network.

Additional information

3 visual issues persist that this does not fix. I did not spend too much time trying to figure out how to override the attributes (seemingly not very easy) as they do work, but are just confusing in the UI.

  1. The "Switch" entity in controls is read-only by the thermostat so it should be moved to Sensors and renamed to something like "Relay output" On/Off or "Valve" Open/Closed.
  2. Keypad lockout should be a boolean 0x00/0x01 Off/On, and not an enum. The thermostat does not support the other states.
  3. Min heat setpoint has a weird step of 0.349999999... instead of 0.5

If someone knows how to fix these with just the quirk, I'd be happy to implement.

Device diagnostics

Checklist

  • The changes are tested and work correctly
  • pre-commit checks pass / the code has been formatted using Black
  • Tests have been added to verify that the new code works
  • Device diagnostics data has been attached

Copy link

codecov bot commented Sep 14, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.15%. Comparing base (500e74e) to head (61062a8).

Additional details and impacted files
@@            Coverage Diff             @@
##              dev    #4344      +/-   ##
==========================================
+ Coverage   92.12%   92.15%   +0.02%     
==========================================
  Files         358      358              
  Lines       11917    11954      +37     
==========================================
+ Hits        10979    11016      +37     
  Misses        938      938              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@Sopsy
Copy link
Author

Sopsy commented Sep 20, 2025

Added some more missing features.

@Sopsy
Copy link
Author

Sopsy commented Oct 6, 2025

Fixed conflicts and added the missing features researched with the help of @DerDreschner over at the Z2M side (thanks!).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
needs review This PR should be reviewed soon, as it generally looks good.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants