Hi, thanks a lot for your work!
I´m struggling with my PTM 215Z. The Button is integrated, but there are noch actions (see below). The Bluepint isn´t working, too. Is that normal, that there are no information regading the actions?
Remove the spaces from the device name, then the blueprint should work.
Hi!
I have the same problem. Have you found a solution for this and would like to share it with me? That would help me a lot. Thank you in advance.
Might be because you have not enabled elabsed time.
Cut/paste from OP
Make sure you enable Elapsed in the z2m advanced settings. This is used to prevent a release after a short press to restart the automation prematurely.
Hey @khvej8 as I wrote to you in a direct message, Elapsed is enabled in z2m. I am very satisfied with the blueprint because the automations run as desired and without errors. This warning message only exists after a complete system restart. I think it’s because if Home Assistant is completely restarted and reloads the automations while z2m or MQTT are not yet ready, the error message occurs.
I’ve created a separate topic about this here. I wish @vandalon would take a look at this and maybe could help:
I found a solution. Maybe it will help someone:
I can’t get this to work. Is there a way to test whether HOA correctly receives the signal from the FoH switches?
I have two switches paired (I think they are paired? How should this look):
With two automations for desperate attempts at getting this to work:
alias: Wohnzimmerschalter_Bogen
description: ""
use_blueprint:
path: vandalon/z2m EnOcean PTM 215Z (Friends of Hue) switch.yaml
input:
button_1_pressed:
- service: light.turn_on
target:
entity_id: light.wohnzimmerdecke
data: {}
button_2_pressed:
- service: light.turn_off
target:
entity_id: light.wohnzimmerdecke
data: {}
controller: FoHWohnzimmer
alias: FoH Test
description: ""
use_blueprint:
path: vandalon/z2m EnOcean PTM 215Z (Friends of Hue) switch.yaml
input:
button_1_pressed:
- service: light.toggle
target:
entity_id: light.wohnzimmerdecke
data: {}
controller: FoHTester
Nothing happens in any button press though. Any help is greatly appreciated!
You need to set the 2 fields called controller and basetropic in the blueprint. Otherwise it does not know what to listen for.
I’m not sure I understand. I set a controller field in both my automations (as you can see in the code blocks that I posted).
What is the basetropic field? I can see no reference to such a field in this thread or any home assistant documentation.
You say that I need to set these fields in the blueprint. Does that mean I have to edit the blueprint file or the automations?
You controller input is not the first, in my automation it is the first one. Strange, are there more different versions.
input:
controller: yourswitchname
if your topic is “zigbee2mqtt”, then OK, otherwise this also needs to be defined
Testing out the blueprint and I have major issues. I put switch on a light on release 1 und switch off that light on release 3. It generally works but I sometimes have to press 3 times until something happens. It is really unreliable. I thought it was the switch itself that it does not transmit. However I tested by creating two normal automations one switch on and the other one switch off. With those it works every time without issue.
So it must be a problem in the blueprint. Any idea what is causing it?
Thanks
1 Like
I had the same experience. Was in doubt to ditch al those FoH switches.
I stopped using the blueprint and created an automation based on this: Home Assistant | Zigbee2MQTT
So only on/off support for now. I manage my lights with the Adaptive Lighting integration.
The biggest win is that my switches now respond instant with no missed actions.
Tried creating a new blueprint based on this but it seems impossible to get the correct device_id using the default inputs.
Have a look at my post to get the most of the Zigbee2MQTT way
Did you have a look at your logbook after pressing a button ? Sometimes, you think your press button 1 and you press 1 and 3 together… It is a known issue.
I do use this blueprint since a year without any issue at all.
An other point to check is how you paired your switch to your network. Did use the “permit join all” or “permit join specific device”. Have a look there Green Power Devices.
Based on the nice work of @vandalon, I have been able to create a functional blueprint for the PTM216Z.
blueprint:
name: Controller - EnOcean PTM 216Z switch
description:
"
Controller automation for executing press/hold/release after hold actions triggered by EnOcean PTM 216Z switch.
\n\n
Make sure that **Elapsed** is enabled in the z2m advanced settings.
\n\n
Make sure to manually create a separate **Text Helper** per controller and define its entity in the automation. It's used to store the last controller event to filter possible
empty events and handle 'button hold' actions.
\n\n
This blueprint is mainly based on the hard work of @vandalon and his great blueprint for the PTM 215Z (Friend of Hue).
"
domain: automation
input:
controller:
name: (Zigbee2MQTT) Controller Name
description: The name of the controller as defined in z2m (e.g. Livingroom Switch)
default: ""
base_topic:
name: (Zigbee2MQTT) Base mqtt topic
description: The base topic as configured in z2m
default: zigbee2mqtt
helper_last_controller_event:
name: (Required) Helper - Last Controller Event
description:
Input Text used to store the last event fired by the controller.
You will need to manually create a text input Helper entity for this.
default: ""
selector:
entity:
domain: input_text
multiple: false
hold_delay:
name: Hold delay
description: If the button has been held more than the configured Hold delay, the corresponding held action is triggered.
default: 500
selector:
number:
min: 100.0
max: 1000.0
unit_of_measurement: milliseconds
mode: box
step: 10.0
button_1_pressed:
name: Button 1 Pressed
description: Action to run, when button 1 is pressed.
default: []
selector:
action: {}
button_1_held:
name: Button 1 Held
description: Action to run, when the button 1 is held.
default: []
selector:
action: {}
button_1_released:
name: Button 1 released
description: Action to run, when the button 1 is released after long press.
default: []
selector:
action: {}
button_2_pressed:
name: Button 2 Pressed
description: Action to run, when the button 2 pressed.
default: []
selector:
action: {}
button_2_held:
name: Button 2 Held
description: Action to run, when the button 2 is held.
default: []
selector:
action: {}
button_2_released:
name: Button 2 released
description: Action to run, when the button 2 is released after long press.
default: []
selector:
action: {}
button_3_pressed:
name: Button 3 Pressed
description: Action to run, when the button 3 is pressed.
default: []
selector:
action: {}
button_3_held:
name: Button 3 Held
description: Action to run, when the button 3 is held.
default: []
selector:
action: {}
button_3_released:
name: Button 3 released
description: Action to run, when the button 3 is released after long press.
default: []
selector:
action: {}
button_4_pressed:
name: Button 4 Pressed
description: Action to run, when the button 4 is pressed.
default: []
selector:
action: {}
button_4_held:
name: Button 4 Held
description: Action to run, when the button 4 is held.
default: []
selector:
action: {}
button_4_released:
name: Button 4 released
description: Action to run, when the button 4 is released after long press.
default: []
selector:
action: {}
button_1_and_3_pressed:
name: Button 1 and 3 Pressed
description: Action to run, when buttons 1 and 3 are pressed.
default: []
selector:
action: {}
button_1_and_3_held:
name: Button 1 and 3 Held
description: Action to run, when buttons 1 and 3 are held.
default: []
selector:
action: {}
button_1_and_3_released:
name: Button 1 and 3 released
description: Action to run, when buttons 1 and 3 are released after long press.
default: []
selector:
action: {}
button_2_and_4_pressed:
name: Button 2 and 4 Pressed
description: Action to run, when buttons 2 and 4 are pressed.
default: []
selector:
action: {}
button_2_and_4_held:
name: Button 2 and 4 Held
description: Action to run, when buttons 2 and 4 are is held.
default: []
selector:
action: {}
button_2_and_4_released:
name: Button 2 and 4 released
description: Action to run, when buttons 2 and 4 are is released after long press.
default: []
selector:
action: {}
# source_url:
mode: restart
max_exceeded: silent
variables:
hold_delay: !input hold_delay
trigger_variables:
base_topic: !input base_topic
controller: !input controller
trigger:
- platform: mqtt
topic: '{{ base_topic ~ "/" ~ controller }}'
condition:
# This line is to avoid a warning at startup only
- '{{ as_timestamp(now()) - as_timestamp(states.binary_sensor.zigbee2mqtt_bridge_connection_state.last_changed)
| int > 40 }}'
- '{{ ("release" in trigger.payload_json.action and trigger.payload_json.elapsed is defined)
or "press_" in trigger.payload_json.action }}'
action:
- variables:
controller: !input controller
helper_last_controller_event: !input helper_last_controller_event
command: '{{ trigger.payload_json.action }}'
prev_command: '{{ states(helper_last_controller_event) }}'
- service: input_text.set_value
data:
entity_id: !input helper_last_controller_event
value: "{{ command }}"
- choose:
- conditions: '{{ "release" in trigger.payload_json.action and trigger.payload_json.elapsed | int < hold_delay }}'
sequence:
- choose:
- conditions:
- '{{ command == "release" and prev_command == "press_1" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_1_pressed
- conditions:
- '{{ command == "release" and prev_command == "press_2" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_2_pressed
- conditions:
- '{{ command == "release" and prev_command == "press_3" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_3_pressed
- conditions:
- '{{ command == "release" and prev_command == "press_4" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_4_pressed
- conditions:
- '{{ command == "release" and prev_command == "press_1_and_3" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_1_and_3_pressed
- conditions:
- '{{ command == "release" and prev_command == "press_2_and_4" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_2_and_4_pressed
- conditions: '{{ "press_" | string in trigger.payload_json.action }}'
sequence:
- delay:
milliseconds: !input hold_delay
- choose:
- conditions: '{{ trigger.payload_json.action == "press_1" }}'
sequence: !input button_1_held
- conditions: '{{ trigger.payload_json.action == "press_2" }}'
sequence: !input button_2_held
- conditions: '{{ trigger.payload_json.action == "press_3" }}'
sequence: !input button_3_held
- conditions: '{{ trigger.payload_json.action == "press_4" }}'
sequence: !input button_4_held
- conditions: '{{ trigger.payload_json.action == "press_1_and_3" }}'
sequence: !input button_1_and_3_held
- conditions: '{{ trigger.payload_json.action == "press_2_and_4" }}'
sequence: !input button_2_and_4_held
- conditions:
- '{{ "release" in trigger.payload_json.action and trigger.payload_json.elapsed | int > hold_delay }}'
sequence:
- choose:
- conditions:
- '{{ command == "release" and prev_command == "press_1" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_1_released
- conditions:
- '{{ command == "release" and prev_command == "press_2" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_2_released
- conditions:
- '{{ command == "release" and prev_command == "press_3" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_3_released
- conditions:
- '{{ command == "release" and prev_command == "press_4" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_4_released
- conditions:
- '{{ command == "release" and prev_command == "press_1_and_3" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_1_and_3_released
- conditions:
- '{{ command == "release" and prev_command == "press_2_and_4" }}'
- '{{ trigger.payload_json.action == "release" }}'
sequence: !input button_2_and_4_released
Well,
is a bit generous. It “compiles” but it doesn’t run as expected.
First of all you check for command = "release", which it will never be. It wil be like release_1. So each release action will never trigger.
Furthermore you added the command variable (
), used it to compare but additionally compare to the payload as well. Once compare would be enough 
I have not yet deployed one of those switches long term, that’s why im not sure if your text helper apprach is actually useful tbh.
But anyways, here is your blueprint, but fixed
blueprint:
name: Controller - EnOcean PTM 216Z switch
description:
"
Controller automation for executing press/hold/release after hold actions triggered by EnOcean PTM 216Z switch.
\n\n
Make sure that **Elapsed** is enabled in the z2m advanced settings.
\n\n
Make sure to manually create a separate **Text Helper** per controller and define its entity in the automation. It's used to store the last controller event to filter possible
empty events and handle 'button hold' actions.
\n\n
This blueprint is mainly based on the hard work of @vandalon and his great blueprint for the PTM 215Z (Friend of Hue).
"
domain: automation
input:
controller:
name: (Zigbee2MQTT) Controller Name
description: The name of the controller as defined in z2m (e.g. Livingroom Switch)
default: ""
base_topic:
name: (Zigbee2MQTT) Base mqtt topic
description: The base topic as configured in z2m
default: zigbee2mqtt
helper_last_controller_event:
name: (Required) Helper - Last Controller Event
description:
Input Text used to store the last event fired by the controller.
You will need to manually create a text input Helper entity for this.
default: ""
selector:
entity:
domain: input_text
multiple: false
hold_delay:
name: Hold delay
description: If the button has been held more than the configured Hold delay, the corresponding held action is triggered.
default: 500
selector:
number:
min: 100.0
max: 1000.0
unit_of_measurement: milliseconds
mode: box
step: 10.0
button_1_pressed:
name: Button 1 Pressed
description: Action to run, when button 1 is pressed.
default: []
selector:
action: {}
button_1_held:
name: Button 1 Held
description: Action to run, when the button 1 is held.
default: []
selector:
action: {}
button_1_released:
name: Button 1 released
description: Action to run, when the button 1 is released after long press.
default: []
selector:
action: {}
button_2_pressed:
name: Button 2 Pressed
description: Action to run, when the button 2 pressed.
default: []
selector:
action: {}
button_2_held:
name: Button 2 Held
description: Action to run, when the button 2 is held.
default: []
selector:
action: {}
button_2_released:
name: Button 2 released
description: Action to run, when the button 2 is released after long press.
default: []
selector:
action: {}
button_3_pressed:
name: Button 3 Pressed
description: Action to run, when the button 3 is pressed.
default: []
selector:
action: {}
button_3_held:
name: Button 3 Held
description: Action to run, when the button 3 is held.
default: []
selector:
action: {}
button_3_released:
name: Button 3 released
description: Action to run, when the button 3 is released after long press.
default: []
selector:
action: {}
button_4_pressed:
name: Button 4 Pressed
description: Action to run, when the button 4 is pressed.
default: []
selector:
action: {}
button_4_held:
name: Button 4 Held
description: Action to run, when the button 4 is held.
default: []
selector:
action: {}
button_4_released:
name: Button 4 released
description: Action to run, when the button 4 is released after long press.
default: []
selector:
action: {}
button_1_and_3_pressed:
name: Button 1 and 3 Pressed
description: Action to run, when buttons 1 and 3 are pressed.
default: []
selector:
action: {}
button_1_and_3_held:
name: Button 1 and 3 Held
description: Action to run, when buttons 1 and 3 are held.
default: []
selector:
action: {}
button_1_and_3_released:
name: Button 1 and 3 released
description: Action to run, when buttons 1 and 3 are released after long press.
default: []
selector:
action: {}
button_2_and_4_pressed:
name: Button 2 and 4 Pressed
description: Action to run, when buttons 2 and 4 are pressed.
default: []
selector:
action: {}
button_2_and_4_held:
name: Button 2 and 4 Held
description: Action to run, when buttons 2 and 4 are is held.
default: []
selector:
action: {}
button_2_and_4_released:
name: Button 2 and 4 released
description: Action to run, when buttons 2 and 4 are is released after long press.
default: []
selector:
action: {}
# source_url:
mode: restart
max_exceeded: silent
variables:
hold_delay: !input hold_delay
trigger_variables:
base_topic: !input base_topic
controller: !input controller
trigger:
- platform: mqtt
topic: '{{ base_topic ~ "/" ~ controller }}'
condition:
# This line is to avoid a warning at startup only
- '{{ as_timestamp(now()) - as_timestamp(states.binary_sensor.zigbee2mqtt_bridge_connection_state.last_changed)
| int > 40 }}'
- '{{ ("release" in trigger.payload_json.action and trigger.payload_json.elapsed is defined)
or "press_" in trigger.payload_json.action }}'
action:
- variables:
controller: !input controller
helper_last_controller_event: !input helper_last_controller_event
command: '{{ trigger.payload_json.action }}'
prev_command: '{{ states(helper_last_controller_event) }}'
- service: input_text.set_value
data:
entity_id: !input helper_last_controller_event
value: "{{ command }}"
- choose:
- conditions: '{{ "release" in command and trigger.payload_json.elapsed | int < hold_delay }}'
sequence:
- choose:
- conditions:
- '{{ command == "release_1" and prev_command == "press_1" }}'
sequence: !input button_1_pressed
- conditions:
- '{{ command == "release_2" and prev_command == "press_2" }}'
sequence: !input button_2_pressed
- conditions:
- '{{ command == "release_3" and prev_command == "press_3" }}'
sequence: !input button_3_pressed
- conditions:
- '{{ command == "release_4" and prev_command == "press_4" }}'
sequence: !input button_4_pressed
- conditions:
- '{{ command == "release_1_and_3" and prev_command == "press_1_and_3" }}'
sequence: !input button_1_and_3_pressed
- conditions:
- '{{ command == "release_2_and_4" and prev_command == "press_2_and_4" }}'
sequence: !input button_2_and_4_pressed
- conditions: '{{ "press_" | string in command }}'
sequence:
- delay:
milliseconds: !input hold_delay
- choose:
- conditions: '{{ command == "press_1" }}'
sequence: !input button_1_held
- conditions: '{{ command == "press_2" }}'
sequence: !input button_2_held
- conditions: '{{ command == "press_3" }}'
sequence: !input button_3_held
- conditions: '{{ command == "press_4" }}'
sequence: !input button_4_held
- conditions: '{{ command == "press_1_and_3" }}'
sequence: !input button_1_and_3_held
- conditions: '{{ command == "press_2_and_4" }}'
sequence: !input button_2_and_4_held
- conditions:
- '{{ "release" in command and trigger.payload_json.elapsed | int > hold_delay }}'
sequence:
- choose:
- conditions:
- '{{ command == "release_1" and prev_command == "press_1" }}'
sequence: !input button_1_released
- conditions:
- '{{ command == "release_2" and prev_command == "press_2" }}'
sequence: !input button_2_released
- conditions:
- '{{ command == "release_3" and prev_command == "press_3" }}'
sequence: !input button_3_released
- conditions:
- '{{ command == "release_4" and prev_command == "press_4" }}'
sequence: !input button_4_released
- conditions:
- '{{ command == "release_1_and_3" and prev_command == "press_1_and_3" }}'
sequence: !input button_1_and_3_released
- conditions:
- '{{ command == "release_2_and_4" and prev_command == "press_2_and_4" }}'
sequence: !input button_2_and_4_released
Well,
It was not the best place to post I do agree.
Some people asked for a working blueprint for the PTM216Z which does not behave the same as the PTM215Z.
PTM216Z is not sending a release_1 or something else but only a release command. See Zigbee2mqtt device page. This explains why there is a need to compare the previous command. Any update of my code is really appreciated anyway.
To avoid the “helper” I created this version.
blueprint:
name: Zigbee2mqtt - EnOcean Simpel PTM 215Z (Friends of Hue) blueprint
description: Using HA triggers
domain: automation
input:
switch:
name: HA device name, action entity
description: If more switches share same functionality, you can choose 2 or more
selector:
entity:
integration: mqtt
domain: sensor
multiple: true
hold_delay:
name: Hold delay (seconds)
description: If the button has been held more than the configured Hold delay,
the corresponding long release action will be triggered
default: 1
selector:
number:
min: 1
max: 4
unit_of_measurement: seconds
step: 1
button_1_press:
name: Button 1 Pressed (upper left)
description: Action to run, when button 1 is pressed.
default: []
selector:
action: {}
button_1_short_release:
name: Button 1 short released (upper left)
description: Action to run, when the button 1 is released after short pres.
default: []
selector:
action: {}
button_1_long_release:
name: Button 1 long released (upper left)
description: Action to run, when the button 1 is released after long press.
default: []
selector:
action: {}
button_2_press:
name: Button 2 Pressed (lower left)
description: Action to run, when button 2 is pressed.
default: []
selector:
action: {}
button_2_short_release:
name: Button 2 short released (lower left)
description: Action to run, when the button 2 is released after short press.
default: []
selector:
action: {}
button_2_long_release:
name: Button 2 long released (lower left)
description: Action to run, when the button 2 is released after long press.
default: []
selector:
action: {}
button_3_press:
name: Button 3 Pressed (upper right)
description: Action to run, when button 3 is pressed.
default: []
selector:
action: {}
button_3_short_release:
name: Button 3 short released (upper right)
description: Action to run, when the button 3 is released after short press.
default: []
selector:
action: {}
button_3_long_release:
name: Button 3 long released (upper right)
description: Action to run, when the button 3 is released after long press.
default: []
selector:
action: {}
button_4_press:
name: Button 4 Pressed (lower right)
description: Action to run, when button 4 is pressed.
default: []
selector:
action: {}
button_4_short_release:
name: Button 4 short released (lower right)
description: Action to run, when the button 4 is released after short press.
default: []
selector:
action: {}
button_4_long_release:
name: Button 4 long released (lower right)
description: Action to run, when the button 4 is released after long press.
default: []
selector:
action: {}
mode: restart
max_exceeded: silent
trigger:
- platform: state
entity_id: !input 'switch'
to:
- release_1
- release_2
- release_3
- release_4
- press_1
- press_2
- press_3
- press_4
action:
- variables:
keypress: '{{ trigger.to_state.state }}'
holddelay: !input 'hold_delay'
timediff: >-
{{ (trigger.to_state.last_changed -
trigger.from_state.last_changed).total_seconds() }}
- choose:
- conditions: '{{ keypress == ''press_1'' }}'
sequence: !input button_1_press
- conditions: '{{ keypress == ''press_2'' }}'
sequence: !input button_2_press
- conditions: '{{ keypress == ''press_3'' }}'
sequence: !input button_3_press
- conditions: '{{ keypress == ''press_4'' }}'
sequence: !input button_4_press
- conditions: '{{ keypress == ''release_1'' }}'
sequence:
- choose:
- conditions: '{{ timediff > (holddelay) }}'
sequence: !input button_1_long_release
default:
- sequence: !input button_1_short_release
- conditions: '{{ keypress == ''release_2'' }}'
sequence:
- choose:
- conditions: '{{ timediff > (holddelay) }}'
sequence: !input button_2_long_release
default:
- sequence: !input button_2_short_release
- conditions: '{{ keypress == ''release_3'' }}'
sequence:
- choose:
- conditions: '{{ timediff > (holddelay) }}'
sequence: !input button_3_long_release
default:
- sequence: !input button_3_short_release
- conditions: '{{ keypress == ''release_4'' }}'
sequence:
- choose:
- conditions: '{{ timediff > (holddelay) }}'
sequence: !input button_4_long_release
default:
- sequence: !input button_4_short_release
1 Like
Thanks for the Blueprint!
Could you please add the “pressed 1 and 3” and “pressed 2 and 4” functions aswell? 
Did not know that was a possibility. Will have a look