Breaking changes
In a last minute change to HA 2023.12, the backward compatible fallback
for a previously unnoticed change to fan API was broken. HA may fix
this in a point release, but in case not, it is being fixed here. #1380
Details: some time previously (at least 2 years ago), the turn_on
service for fans was changed from a simple on/off to also allow
passing percentage (speed) and preset_mode parameters as part of the
turn_on command. This integration did not implement that, and instead
relied on the backward compatibility provided for that change. As
part of improved error handling, a wrapper function was added just
before the HA 2023.12 release to check the preset_mode parameter
before calling the real turn_on service. This new function is missing
the backward compatibility that used to exist, so requires fan
integrations to implement the new API.
This release adds the preset_mode and percentage parameters to the
turn_on method to avoid the errors in HA 2023.12 and get fans working,
however the parameters are ignored, so passing these parameters to the
turn_on service will not work in this release, it is still necessary
to use separate set_percentage and set_preset_mode service calls.
The next release will finish off the implementation.