Add support for manual mode state reporting

[TD22057]

@NickWaterton

Currently manual up/down is not being reported. Commands are handled correctly, but only the final state is send when it's achieved. Add an optional manual_state output template to Dimmer, KeypadLinc, and Remote with template arguments 'mode_str' = 'up', 'down', 'stop' as well as 'mode' = +1, -1, 0. See PR #103 for details.

[NickWaterton]

You are missing Switch - switches can send manual dim up/down messages as well. Also, I chose the numbers 0,1 and 2 for OpenHAB compatibility (these are the numbers used in the InsteonPLM binding). Using different numbers causes some compatibility problems. OpenHab users would have to transform every response in a custom table, and that might not be possible as without a separate topic we would have to be using a Json transform as well (and you can’t use two transforms). You could write a custom JavaScript transform, but then things are getting out of hand for a 1 digit offset. An alternative would be to add an “OH_Man” option reporting 0,1 and 2 for compatibility. What do you think? Nick Waterton P.Eng Sent from my iPhone

[TD22057]

OK.
Devices: Dimmer, KeypadLinc, Remote, Switch

Template parameters:

• mode: -1 (down), 0 (stop), 1 (up)
• openhab_mode: 0 (down), 1 (stop), 2 (up)

Optional config inputs for devices:

• manual_state_topic
• manual_state_payload

I'll fold in what you did into this system after merging in the fast on/off changes.

[NickWaterton]

Great, Thanks. Nick Waterton P.Eng Sent from my iPhone

[TD22057]

I haven't had time to update docs and tests yet, but you can find the code on the branch manual if you want to test it. As usual, it was more complicated than originally expected. I was able to test it for all the devices. Some behavior differences:

• Dimmer: holding up down changes the dimming level so the device does a refresh when it gets a stop to find the final value.
• Switch: the device changes state when pressed so that message is also emitted (holding up is a manual up + a turn on)
• Keypadlinc group1: acts like a switch or dimmer depending on the model
• Keypadlinc non-group 1: These buttons emit the manual up/down/stop message but do NOT change state when pressed. They alternate up/down when held repeatedly
• Remote: same as keypadlinc non-group 1 buttons

[TD22057]

manual branch has been merged to the dev branch in commit 3dc6079. Final API changed a little bit to make it more consistent with the other template values. See the config.yaml file for examples.

[TD22057]

Note: In 0.6.5, I changed the manual mode topics to force retain=False when sending. This stops the broker from saving a manual mode on/off message which isn't a persistent state like normal state updates.