homematicip_cloud: Add support for Heating PWM Cycle Time (IOptionalFeatureHeatingPwmCycleTime) — read & write (e.g. HmIP-BWTH / FAL)

[callimeroetsombrero]

Integration name

HomeaticIP Cloud

Link to integration documentation on our website

http://home-assistant.io/integrations/homematicip_cloud/

Describe the enhancement

Add support for the optional device capability Heating PWM Cycle Time (IOptionalFeatureHeatingPwmCycleTime) for Homematic IP devices (e.g., HmIP-BWTH).
Requested scope:

Read + write support (write is required for acceptance).

Scope: global per device (not per channel).

Units: seconds (validate/clamp to device limits if exposed by API).

Proposed UX/API:

New service: homematicip_cloud.set_heating_pwm_cycle_time
Data: { device_id: <device_id>, seconds: }

Expose current value as a device attribute (and/or on the related climate entity) and include it in Diagnostics.

Logging improvement (interim):
Downgrade or de-duplicate the current warning (“Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported”) to avoid log spam until support lands.

Use cases

Fine-tune actuator modulation for hydronic/floor heating and wall thermostats with switching outputs to reduce overshoot/undershoot and improve comfort/efficiency.

Keep configuration centralized in Home Assistant instead of vendor apps.

Anything else?

Startup excerpt (feature warning appears immediately after setup + WS connect)

2025-10-09 15:01:23.674 INFO    [homeassistant.setup] Setting up homematicip_cloud
2025-10-09 15:01:24.043 WARNING [homematicip.device] Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported
2025-10-09 15:01:24.051 INFO    [homematicip.connection.websocket_handler] Start websocket client. Connect task started.

Evidence:

Repeated warning during operation (log spam)

2025-10-09 15:42:30.107 WARNING [homematicip.device] Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported
2025-10-09 17:29:30.047 WARNING [homematicip.device] Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported
2025-10-09 19:15:52.996 WARNING [homematicip.device] Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported
2025-10-09 19:42:35.408 WARNING [homematicip.device] Optional Device Feature 'IOptionalFeatureHeatingPwmCycleTime' is not yet supported

Evidence:

Device reports the capability and a current value

"supportedOptionalFeatures": { "IOptionalFeatureHeatingPwmCycleTime": true, ... }
"heatingPwmCycleTime": 15

Evidence:

Reporter’s device identity (thermostat)

"modelType": "HmIP-BWTH",
"firmwareVersion": "3.0.4",
"connectionType": "HMIP_RF",
"climateControlType": "PWM_CONTROL"

Evidence:

Environment includes floor-heating actuator (for context)

"modelType": "HmIP-FAL230-C10",
"firmwareVersion": "2.4.6"

Evidence:

Environment (reporter)

Version: core-2025.10.1, Supervisor 2025.10.0, HA OS 16.2, Docker 28.3.3, Python 3.13.7, Arch amd64/x86_64, TZ Europe/Berlin

Installation type: Home Assistant OS

Integration: homematicip_cloud (Homematic IP Access Point / cloud)

HACS: 2.0.5 (no customizations affecting this integration)

System healthy; WS connects normally.

Willing to help test: Yes — can run test builds and provide debug logs.

[github-actions[bot]]

🏷️ I've automatically added the integration: homematicip_cloud label to help categorize this feature request.