Version 0.12.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.12.0 - 2020-01-05

Changed

• Hood: The percentage values used for the Rotation Speed characteristic that correspond to low/medium/high speed from Siri are forced to 25%/50%/100%. This results in a non-linear scale, but should behave more consistently when Siri is used to change the speed. The preferred percentage values are provided to HomeKit in a Valid Values descriptor. (#2)
• Home Connect API requests are now only issued if they are expected to succeed in the appliance's current state and with the currently authorised scopes. This reduces the number of requests that result in errors, making it less likely that the API rate limits will be exceeded and the client blocked.

Fixed

• Hood: The Target Fan State characteristic is no longer updated when a program stops (BSH.Common.Root.ActiveProgram reported as null in an event). This prevents the manual/auto setting being incorrectly changed. (#2)

Version 0.11.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.11.0 - 2020-01-05

Added

• CleaningRobot/CookProcessor: Additional appliance types are now explicitly supported. Previously they just implemented a read-only Switch for their power status.
• Hood: Added support for the intensive setting (Cooking.Common.Option.Hood.IntensiveLevel) on appliances that support it. This is treated as an additional one or two fan speeds above the standard venting levels. (#2)

Changed

• Hood: The step size for the Rotation Speed characteristic is now selected an an integer value that allows 25%/50%/100% to be selected (since Siri uses these percentages for low/medium/high). Previously the step size was calculated as 100% full-scale divided by the number of supported fan speeds, but that caused problems due to rounding errors with fractional values. (#2)
• Hood: Requesting 0% fan speed now stops the current program instead of changing the current program's options. (#2)
• The ability to switch an appliance off or place it in standby is now determined automatically (by querying the allowed values for BSH.Common.Setting.PowerState) instead of being hardcoded based on the appliance type.

Fixed

• Hood: Cope with FanOff (or IntensiveStageOff) not being included in the allowedvalues for the Cooking.Common.Program.Hood.Venting program options (contrary to the Home Connect documentation). (#2)

Version 0.10.1

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.10.1 - 2020-01-04

Fixed

• Program Mode (added in [v0.10.0]) is now listed as an optional characteristic for the Home Appliance service. This prevents HAP Warning messages appearing in the log file during start-up. (#2)

Version 0.10.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.10.0 - 2020-01-04

Added

• CoffeeMaker/Dishwasher/Dryer/Washer/WasherDryer: Experimental support for pausing and resuming the active program using the Active characteristic. This feature is not supported by the appliance simulators and the Home Connect API documentation is incomplete, so additional information is written to the log file to help understand how appliances implement this feature. (#8)
• Oven: Added a Stateless Programmable Switch event to indicate when a program has been aborted.
• A new Program Mode characteristic indicates when the appliance is being controlled locally and when remote control/start are active.

Changed

• Hood: Extra debug information captured to the log file when the appliance sends an event for an invalid fan speed. Also made this non-fatal to prevent Homebridge from crashing. (#2)
• The power Switch is now marked as being the appliance's primary service. (#7)
• CoffeeMaker/Dishwasher/Dryer/Oven/Washer/WasherDryer: The program Switch services are now linked to the Home Appliance service and to each other. (#7)
• Hood: The functional Lightbulb and ambient Lightbulb services are now linked to each other. (#7)
• The active program is no longer queried when the appliance is not running a program. This reduces the number of requests that result in errors, making it less likely that the API rate limits will be exceeded and the client blocked.
• Improved logging of errors to further assist with debugging.

Removed

• Stateless Programmable Switch services no longer generate Double Press events. These were previously intended to indicate when an event had been confirmed by the user (BSH.Common.EnumType.EventPresentState.Confirmed) but neither the physical appliances nor the simulators generate this value. Only Single Press events are now triggered.

Fixed

• CoffeeMaker/Dishwasher/Dryer/Oven/Washer/WasherDryer: Program options are handled better when writing them to the log file in response to Identify. In particular, any default values provided by the appliance are used (instead of using the minimum allowed or the first enum value), and the allowed values for Boolean types are also output. (#1 / #3)
• Fridge/FridgeFreezer/Refrigerator: The FridgeFreezer simulator uses the incorrect value for its door alarm events (BSH.Common.EnumType.DoorState.Open instead of BSH.Common.EnumType.EventPresentState.Present). These are now treated as synonymous.
• The Status Active characteristic is now only set to false under abnormal conditions (Pause, ActionRequired, Error, and Aborting). The previous behaviour of only setting it to true while running a program (Run) resulted in a misleading warning symbol and message within the Elgato Eve app when the appliance was working properly. Setting of the Status characteristic has also been tweaked. (#6)

Version 0.9.1

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.9.1 - 2020-01-01

Changed

• Moved most documentation from the README.md file to the project's Wiki.

Version 0.9.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.9.0 - 2019-12-31

Changed

• Hood: Setting a new fan speed is now implemented by changing the current program's options instead of starting a new program. This makes it less likely that the API rate limits will be exceeded and the client blocked. (#2)
• Hood: Appended "fan" to the name of the Fan service. This only affects newly created accessories.

Fixed

• Hood: Changes to multiple Fan or Lightbulb characteristics (separately for functional and ambient lights) are merged and then the Home Connect requests issued in sequence. This avoids trying to set intermediate states, as well as overlapping requests to control the same feature, resulting in more reliable behaviour. (#2)
• CoffeeMaker/Dishwasher/Dryer/Washer/WasherDryer: Program Switch services are now left writeable rather than attempting to make them read-only when remote start is not enabled. HomeKit is not designed to dynamically change the properties of characteristics in this way, so the previous behaviour did not propagate reliably. (#1 / #3)
• Oven: Added the error code BSH.Common.Error.InvalidUIDValue to the list of responses that are treated as cacheable. This undocumented error code is returned by the Thermador PRD486WDHU/01 Oven. (#2)

Version 0.8.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.8.0 - 2019-12-30

Added

• CoffeeMaker/Dishwasher/Dryer/Oven/Washer/WasherDryer: Added experimental support for starting and stopping programs (or monitoring their use on Oven appliances). By default a Switch is added for each program that the appliance supports. This can be customised via the config.json file to tailor the list of programs and their options. A template configuration is written to the Homebridge log file when the appliance's Identify routine is triggered. (#1 / #3)
• CoffeeMaker: Added Stateless Programmable Switch events for bean container empty, water tank empty, and drip tray full.
• Freezer/FridgeFreezer/Refrigerator: Added Stateless Programmable Switch events for door open and temperature alarms.
• The authorised Home Connect scopes are now remembered. This may be used in the future to enable additional functionality for Oven appliances if the Oven-Control scope is granted.

Version 0.7.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.7.0 - 2019-12-29

Changed

• Hood: The supported fan speeds are read from the appliance rather than being hardcoded. (#2)
• Hood: Only attempt to stop a program when one is running. This reduces the number of requests that result in errors, making it less likely that the API rate limits will be exceeded and the client blocked.

Version 0.6.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.6.0 - 2019-12-29

Added

• Hood: Added support for controlling an ambient light, including selecting its colour (custom colours only). The appliance is now queried when the plugin is first started to determine whether it incorporates functional and/or ambient lights and their capabilities. The result is cached persistently. (#2)

Changed

• CoffeeMaker/Dishwasher/Dryer/Oven/Washer/WasherDryer: Improved how available programs are displayed in the log output in response to an Identify routine. A warning is now output if some programs are not currently available, and hence not listed in the log output. Spaces have been added to the characters allowed in the simplified program names.
• Code significantly restructured to be more maintainable.

Version 0.5.0

homebridge-homeconnect

Home Connect home appliances plugin for Homebridge.

Changes in this version:

v0.5.0 - 2019-12-28

Added

• Hood: Added Fan and Lightbulb services for controlling the extractor fan and functional light in Hood appliances. This is a very quick prototype to obtain feedback on how Hood appliances behave. It uses a hardcoded configuration, assuming that the fan supports 5 venting levels and that there is a functional light with brightness control. (#2)