joleys / niko-home-control-II

Home Assistant Custom Integration for Niko Home Control II
MIT License
74 stars 21 forks source link

Implement changes related to documentation v1.3 #110

Closed tijsverkoyen closed 8 months ago

tijsverkoyen commented 9 months ago

Niko released v1.3 for the documentation in august 2023.

Based on the changelog from Niko there are multiple changes:

General

  • Added: several parameters in various devices which are visible but not in use by the API
    • Energy Home, see page 70

Not relevant as we don't expose parameters.

  • Changed: several typo’s

Not really relevant for us

Changed: Authentication token to be generated via the Niko Home Control Programming Software

See page 9 in the new documentation.

New properties

Generic Zigbee Smart plug

  • Added in: Device model – Generic Zigbee Smart plug

See page 66

  • Property Status

NHC Zigbee Smart plug

  • Added in: Device model – NHC Smart plug

See page 64

  • Parameter Groupid

Not relevant as we don't expose the parameters

  • Parameter Groupid1-Groupid25

Not relevant as we don't expose the parameters

  • Property Status

NHC All Off Action

  • Added in: Device model - NHC All Off Action

See page 39

  • Property AllStarted

NHC Free Start Stop Action

  • Added in: Device model - NHC Free Start Stop Action

See page 46

  • Property AllStarted

NHC House mode Action

  • Added in: Device model - NHC House mode Action

See page 48

  • Property AllStarted

NHC Mood Action

  • Added in: Device model - NHC Mood

See page 55

  • Property AllStarted

Sonos Speaker

  • Added in: Device model Sonos Speaker

See page 67

  • Parameter API version

Not relevant as we don't expose parameters, and Sonos Speaker is not (yet) supported in this integration.

  • Parameter Software version

Not relevant as we don't expose parameters, and Sonos Speaker is not (yet) supported in this integration.

NHC Access Control Action

  • Added in Device model - NHC Access Control Action

See page 37

  • Property Callpending

This is already present.

  • Property CallAnswered

This is already present.

NHC Motor Action

  • Added in Device model - NHC motor Action

See page 55

  • Property LastDirection

This is already present.

New devices

Generic ZigBee Heating/Cooling Implementation

  • Added: Device model - Generic ZigBee Heating/Cooling Implementation

See page 77.

Remark: From a code viewpoint this matches the thermostat_hvac device. As Type: hvac and Model: thermostat. But it is very similar to the Generic Heating/Cooling Implementation. So the device to instance is altered to have a way to create specific instances based on the Technology also.

NHC Player status action

  • Added: Device model NHC Player Status Action

See page 78 and 79

NHC Thermo Switch

  • Added: Device model – NHC Thermo switch

See page 79, 80 and 81

NHC Virtual Thermostat

  • Added: Device model – NHC Virtual Thermostat

See page 81 and 82

NHC ZigBee Electricity Metering module (with clamp)

  • Added: Device model – NHC NHC ZigBee Electricity Metering module (with clamp)

See page 83 and 84

This will be catched by the Electricity Metering module (with clamp) implementation. As the model (Electricity-clamp) and type (centralmeter) are the same. And the integration works on this. It seems that both have the same parameters and properties. So no code changes needed at this point.

Others

Update documentation

Fix UnitOfXXX constants