From 6266a95500f90d42bb66f344d826af8eaa5b2ec0 Mon Sep 17 00:00:00 2001 From: Kasper Date: Thu, 20 Aug 2026 21:13:46 +0200 Subject: [PATCH] Update EnOcean PTM 21xZ/ZE - MQTT Trigger --- EnOcean PTM 21xZ%2FZE - MQTT Trigger.-.md | 50 ++++++++++++++++++----- 1 file changed, 40 insertions(+), 10 deletions(-) diff --git a/EnOcean PTM 21xZ%2FZE - MQTT Trigger.-.md b/EnOcean PTM 21xZ%2FZE - MQTT Trigger.-.md index 0400959..30ef81a 100644 --- a/EnOcean PTM 21xZ%2FZE - MQTT Trigger.-.md +++ b/EnOcean PTM 21xZ%2FZE - MQTT Trigger.-.md @@ -428,19 +428,49 @@ The blueprint specifies a minimum Home Assistant version of: ## Installation -1. Download the Blueprint YAML file. -2. Open Home Assistant. -3. Go to: +The easiest way to install this Blueprint is to use the Import Blueprint button below. -```text -Settings → Automations & Scenes → Blueprints -``` -4. Import the Blueprint. +### Automatic Installation + +1. Click **Import Blueprint** below. +2. Home Assistant will open the Blueprint import page. +3. Select **Import Blueprint**. +4. Once imported, the Blueprint will be available under: +`Settings → Automations & Scenes → Blueprints` 5. Create a new automation from the Blueprint. -6. Enter the controller name exactly as it appears in Zigbee2MQTT. -7. Verify the MQTT base topic. +6. Enter the Controller Name exactly as it appears in Zigbee2MQTT. +7. Verify the MQTT Base Topic. The default is: +`zigbee2mqtt` 8. Configure the desired button actions. -9. If using a PTM216Z, create and select the required Text Helper. +9. Configure the Hold Delay if required. +10. If you are using a PTM216Z, enable the PTM216Z option and select the required Text Helper. +11. Save the automation. + +[![Import Blueprint](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https://gitea.kskovmose.dk/Kasper/HAOS/raw/branch/main/Blueprints/PTM_21xZ_ZE.yamll) + +### Manual Installation + +If the automatic import does not work, the Blueprint can also be installed manually. + +1. Open the Blueprint YAML file in the [repository](https://gitea.kskovmose.dk/Kasper/HAOS/src/branch/main/Blueprints/PTM_21xZ_ZE.yaml). +2. Copy the complete YAML content. +3. In Home Assistant, go to: +`Settings → Automations & Scenes → Blueprints` +4. Select Import Blueprint. +5. Paste the URL of the raw YAML file. +6. Confirm the import. +7. Create a new automation from the Blueprint. +8. Configure the controller, MQTT settings and button actions. + +### Controller Name + +The Controller Name must match the name of the controller as configured in Zigbee2MQTT. + +For example: + + `Livingroom_Switch` + +If multiple controllers are supported by the configuration, each controller name can be entered separately. ## Troubleshooting ### Button does not trigger anything