yenoiwesa / homebridge-connexoon

A homebridge plugin to integrate Somfy blinds with the Connexoon RTS hub
Apache License 2.0
27 stars 2 forks source link

'Down' and 'Up', 'In' and 'Out' #26

Closed drekka closed 3 years ago

drekka commented 3 years ago

Hi, is it possible (new feature perhaps) to be able to map the commands to something that makes more sense to an "average Joe"? For example we have two blinds, a window blind which is either up or down and an awning which is in or out. So ideally, I'd like to see the words "In", "out", and "up" and "Down" in the HomeKit UI instead of "Open" and :"Closed".

yenoiwesa commented 3 years ago

Hi there @drekka 👋

Unfortunately no, it is not possible to change the Home app's wording as it is defined by Apple. The Homekit API only allows to define a Door, a Window, or a Window Covering service to have access to the current position and target position characteristics.

See the mapping of the Homebridge services and their characteristics here: https://github.com/homebridge/HAP-NodeJS/blob/d70a1ba9fd8dbb6dba4ae4f8abae2766781cb643/src/lib/gen/HomeKit.ts#L5164

So an awning has to be defined as a Window Covering service. The open/close corresponds to the current/target position characteristic control, that Apple defines as such:

https://developer.apple.com/documentation/homekit/hmcharacteristictypecurrentposition :

The corresponding value is an integer percentage. A value of 0 indicates a door or window is fully closed, or that awnings or shades permit the least possible light. A value of 100 indicates the opposite.

These characteristics and their values are all the plugin can define, the way they are controlled and displayed in the Home app are entirely up to Apple.

Sorry!

Cheers, Matt

jdebardi commented 3 years ago

@drekka I solve this by creating a scene with the wording I want. It's not ideal as you end up with potentially a lot of scenes controlling just 1 device (2 scenes each for in and out) but it makes for much more natural use with Siri.