Z2M - Philips Hue Tap Switch

I took the Blueprint that @harbri created for the Dimmer Switch and created a Hue Tap version out of it.

This blueprint will let you configure each button of a Philips Hue Tap Switch which is paired with Zigbee2MQTT.

Blueprint

Click the badge to import this Blueprint: (needs Home Assistant Core 2021.3 or higher)
Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

Or import this Blueprint by using the forum topic URL:

blueprint:
  name: Z2M - Hue Tap Switch 4 buttons
  description: 'Use the individual buttons of the Hue Tap switch to control an action by a tap.'
  domain: automation
  input:
    dimmer:
      name: Hue Tap switch
      description: Hue Tap Switch to use (Zigbee2mqtt Action Sensor)
      selector:
        entity:
          domain: sensor
    button_1:
      name: Button Single Dot
      description: Action to run on click of single dot button
      default: []
      selector:
        action: null
    button_2:
      name: Button Two Dots
      description: Action to run on click of two dot button
      default: []
      selector:
        action: null
    button_3:
      name: Button Three Dots
      description: Action to run on click of three dot button
      default: []
      selector:
        action: null
    button_4:
      name: Button Four Dots
      description: Action to run on click of four dot button
      default: []
      selector:
        action: null
mode: restart
max_exceeded: silent
trigger:
- platform: state
  entity_id: !input 'dimmer'
  attribute: action
action:
- variables:
    command: '{{ trigger.to_state.state }}'
- choose:
  - conditions:
    - '{{ command == ''press_1'' }}'
    sequence: !input button_1
  - conditions:
    - '{{ command == ''press_2'' }}'
    sequence: !input button_2
  - conditions:
    - '{{ command == ''press_3'' }}'
    sequence: !input button_3
  - conditions:
    - '{{ command == ''press_4'' }}'
    sequence: !input button_4
2 Likes

Hi :slight_smile:

Recently your blueprint doesn’t work anymore, so while searching I found this issue on the Z2M Github.

We need to change this :

  • toggle → press_1
  • recall_scene_0 → press_2
  • recall_scene_1 → press_3
  • recall_scene_2 → press_4
1 Like

Thanks for the heads-up. I just adjusted the code to match the change in z2m.

Let me know if you run into any other issues.

1 Like

I tried using this blueprint and it looks like it should work, but in the debug section I get the following:

Executed: May 21, 2022, 10:18:39 AM

Error: UndefinedError: 'dict object' has no attribute 'to_state'

Found the issue - Had to comment out the “attribute: action”

trigger:
- platform: state
  entity_id: !input 'dimmer'
  # attribute: action
2 Likes

Had to do the same after moving from Conbee stick to Sonoff Zigbee 3.0

Found the issue - Had to comment out the “attribute: action”

trigger:
- platform: state
  entity_id: !input 'dimmer'
  # attribute: action
2 Likes

Thank you for this! This fixed my problem with the blue print - I hope the OP can update it.

If anyone is having issues using this template with scenes or multiple lights since the last update.
Change mode: restart, to mode: queued.
Before I updated that value, I used to receive alot of “Stopped because of unknown reason “null”” errors.

This is what my blueprint looks like now:

blueprint:
  name: Z2M - Hue Tap Switch 4 buttons
  description: Use the individual buttons of the Hue Tap switch to control an action
    by a tap.
  domain: automation
  input:
    dimmer:
      name: Hue Tap switch
      description: Hue Tap Switch to use (Zigbee2mqtt Action Sensor)
      selector:
        entity:
          domain: sensor
          multiple: false
    button_1:
      name: Button Single Dot
      description: Action to run on click of single dot button
      default: []
      selector:
        action: {}
    button_2:
      name: Button Two Dots
      description: Action to run on click of two dot button
      default: []
      selector:
        action: {}
    button_3:
      name: Button Three Dots
      description: Action to run on click of three dot button
      default: []
      selector:
        action: {}
    button_4:
      name: Button Four Dots
      description: Action to run on click of four dot button
      default: []
      selector:
        action: {}
  source_url: https://community.home-assistant.io/t/z2m-philips-hue-tap-switch/329686
mode: queued
max_exceeded: silent
trigger:
- platform: state
  entity_id: !input dimmer
#  attribute: action
action:
- variables:
    command: '{{ trigger.to_state.state }}'
- choose:
  - conditions:
    - '{{ command == ''press_1'' }}'
    sequence: !input button_1
  - conditions:
    - '{{ command == ''press_2'' }}'
    sequence: !input button_2
  - conditions:
    - '{{ command == ''press_3'' }}'
    sequence: !input button_3
  - conditions:
    - '{{ command == ''press_4'' }}'
    sequence: !input button_4

Hello,
I am very new here with zigbee2mqtt. As a stick I use the Sonof. I currently do not understand how I can connect the Hue Tap with zigbee2mqtt. Can you help me there?

How did you pair Phillips hue tap switch at first place? I am trying to pair the switch with my HA Yellow but with no luck. I know its green device, I have Hue lights in the same room, so if translation is needed, it should be performed fine.
What am I missing?
Thank you for help.