Wanted to summarize this whole process for future readers. In short this works great using HA as-is and there’s no need for any modifications of the OpenZWave or HA software. Also worth noting is that if you have an add-on switch it will also properly work for double-tap if the main switch is configured for double-tap.
- Forward double-tap events to your controller. In the Z-Wave configuration panel of HA:
- Select the node for the light switch you want to enable double-tap on.
- Under Node group associations select
Group 3
. - Under Node to control select your Z-Wave USB stick (or whatever Z-Wave controller you use).
- Hit
Add to Group
- Add an automation that triggers on the double-tap event. The
entity_id
will be something likezwave.kitchen_light
. Thebasic_level
will255
when the top of the switch is double-tapped, and will be0
when the bottom is double-tapped. An example:
- id: notify_on_double_tap_on_of_kitchen_lights
alias: Kitchen lights double-tapped on
trigger:
# Trigger on double-tap of kitchen lights
- platform: event
event_type: zwave.node_event
event_data:
entity_id: zwave.kitchen_light
basic_level: 255
action:
- service: notify.john_doe
data:
message: 'Kitchen light switch double tapped on'
Pitfalls and debugging:
- If you only see
Group 1
in your associate groups then you either aren’t using the new Z-Wave Plus version of the GE light switches, or you have some of the earlier versions of the Z-Wave Plus switches (same model #) which have an earlier firmware. Unfortunately there doesn’t appear to be a way to update this firmware as of now. - If double tap works, but one switch triggers multiple double-tap automations, double check your
entity_id
matches properly (and make sure not to useobject_id
). - If you want to see the event data, including the entity ID, set your logger level to
debug
inconfiguration.yaml
and double-tap the switch. Search the home-assistant.log for"zwave.node_event"
- If you’re not seeing double-tap events in the OpenZWave log (OZW_Log.txt) then make sure your controller is properly associated with Group 3 for the switch you’re trying to double tap (see (1) above).