[Blueprint] EnOcean PTM 215Z (Friends of Hue) Switch for Zigbee2MQTT

Blueprints Exchange
, , , ,
1

This blueprint allows you to easily configure the EnOcean PTM 215Z (the battery-less “Friends of Hue” kinetic switch) using Zigbee2MQTT. It utilizes MQTT Device Triggers for a seamless and fast integration.

Note: Available in both English and German (see GitHub link below).

:inbox_tray: Import Blueprint (English)

:hammer_and_wrench: Prerequisites (Important!)

To ensure Home Assistant recognizes the buttons correctly, please follow these steps before creating the automation:

  1. Press each button (1-4) on your PTM 215Z at least once manually.
  2. This allows Zigbee2MQTT (Z2M) to register the buttons as MQTT Device Triggers.
  3. Ensure that MQTT Discovery is enabled in your Z2M configuration.

:clipboard: Supported Features

  • Full support for all 4 buttons.
  • Uses native MQTT Device Triggers for minimal latency.
  • Clean configuration UI.

:open_book: How to use

  1. Import the blueprint using the button above.
  2. Go to Settings -> Automations & Scenes -> Create Automation.
  3. Select the imported Blueprint and choose your device.

:link: Resources & German Version

  • GitHub Repository: AlexF090/HA-Blueprints
    (You can find the German version and full documentation in the repository above.)
2

HA-Blueprints (English)

Goal

Home Assistant Blueprints that you can import into your instance and reuse.

Included Blueprints

  • EnOcean PTM 215Z - Z2M 2.x (MQTT Device Trigger) v2 (EN)
    • File: blueprints/automation/enocean_ptm215z_z2m.yaml

Import Blueprint to My Home Assistant

Import in Home Assistant

  1. Open Home Assistant.
  2. Go to Settings → Automations & Scenes → Blueprints.
  3. Click Add Blueprint.
  4. Choose Import blueprint / Paste YAML (depending on the UI).
  5. Paste the content from blueprints/automation/enocean_ptm215z_z2m.yaml and click the button Import Blueprint to My Home Assistant to add the blueprint.
  6. Create the automation from the blueprint (Create Automation) and fill in the required inputs.

Prerequisites (important before creating/enabling)

Before you create or enable the automation:

  • Press each PTM215Z button (1-4) once manually.
  • This allows Z2M to register the buttons as MQTT Device Triggers in Home Assistant.
  • Make sure MQTT Discovery is enabled in your Z2M configuration (default).

Community import via URL (optional)

If you publicly host this repo (for example on GitHub), you can also import via Add Blueprint using a raw URL:

https://raw.githubusercontent.com/<user>/<repo>/main/blueprints/automation/enocean_ptm215z_z2m.yaml

After that, click the button Import Blueprint to My Home Assistant to add the blueprint.

3

HA-Blueprints (Deutsch)

Ziel

Home Assistant Blueprints, die du in deine Instanz importieren und wiederverwenden kannst.

Enthaltene Blueprints

  • EnOcean PTM 215Z - Z2M 2.x (MQTT Device Trigger) v2 (DE)
    • Datei: blueprints/automation/enocean_ptm215z_z2m_de.yaml

Blueprint import (DE)

In Home Assistant importieren

  1. Öffne Home Assistant.
  2. Gehe zu Einstellungen → Automationen & Szenen → Blueprints.
  3. Klicke Add Blueprint.
  4. Wähle Import blueprint / Paste YAML (je nach UI).
  5. Füge den Inhalt von blueprints/automation/enocean_ptm215z_z2m_de.yaml ein und klicke danach den Button Import Blueprint to My Home Assistant, um den Blueprint hinzuzufügen.
  6. Erstelle danach die Automation über den Blueprint (Create Automation) und fülle die erforderlichen Inputs aus.

Voraussetzungen (wichtig vor Erstellung/Activation)

Bevor du den Blueprint als Automation erstellst oder aktivierst:

  • Drücke jede PTM215Z-Taste (1-4) einmal manuell.
  • Damit registriert Z2M die Tasten als MQTT Device Triggers in Home Assistant.
  • Stelle sicher, dass MQTT Discovery in deiner Z2M-Konfiguration aktiv ist (Standard).

Community-Import über URL (optional)

Wenn du dieses Repo öffentlich hostest (z.B. GitHub), kannst du per Add Blueprint auch über eine Raw-URL importieren:

https://raw.githubusercontent.com/<user>/<repo>/main/blueprints/automation/enocean_ptm215z_z2m_de.yaml

Danach klicke auf den Button Import Blueprint to My Home Assistant, um den Blueprint hinzuzufügen.

1 Like