Kasper/HAOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update EnOcean PTM 21xZ/ZE - MQTT Trigger

Kasper
2026-08-20 21:13:46 +02:00
parent 23c4aca730
commit 6266a95500
1 changed files with 40 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
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