Intégration enocean

Hello @Quentino ,

Welcome to the forum!

If you want help, you may want to edit your post and translate everything into English. (You could use DeepL, Google Translate or ChatGPT if you don’t speak English).

There is also a French forum: Home Assistant Communauté Francophone - Communauté francophone sur Home Assistant avec des tutoriels, des articles, de l’aide, du partage.

1 Like

​Technical Incident Report - EnOcean Integration Issue

Hardware Environment:

  • Controller: EnOcean USB 300 Gateway (GmbH)
  • Device: Nodon Roller Shutter Module (SIN-2-RS-01)
  • Platform: Home Assistant OS running on Mini PC
  • Device ID: usb-EnOcean_GmbH_USB_300_DE_E08CY0EN-if00-port0

​1. Actions Taken

  • YAML Configuration: Configured binary_sensor (for reception) and switch (for emission) using the native enocean integration.
  • Addressing: Tested both the persistent Serial ID and the direct device path /dev/ttyUSB0.
  • Hardware Resets: Performed a full factory reset on the Nodon module (20s press) and power-cycled the USB 300 dongle.
  • Pairing Procedure: Attempted pairing multiple times by setting the Nodon module to learning mode (red flashing LED) and triggering “ON/OFF” commands from the Home Assistant UI.

​2. Persistent Symptom

​The USB 300 serial port “freezes” or “locks up” immediately upon sending an emission command via Home Assistant.

  • Behavior: The dongle flashes red exactly once, then becomes completely unresponsive. It stops flashing red during further emission attempts and stops flashing green during reception (even when using a known-working physical remote).
  • Consequence: Pairing is impossible because the hardware communication link breaks after the first transmitted frame. A full service restart and a physical USB unplug/replug are required to restore communication.

​3. Technical Hypothesis

​The issue appears to be related to Serial Buffer Management within the native Home Assistant EnOcean integration. When a frame is transmitted without an immediate acknowledgement (typical during a pairing phase), the integration fails to release the port, leading to a hardware-level hang of the USB 300 controller. This could also be exacerbated by electromagnetic interference (EMI) from the Mini PC’s USB 3.0 ports affecting the dongle during high-power transmission bursts.

Excellent.

Hint: you can edit any of your postings, in this case your initial one rather than putting it into a reply. :innocent:

1 Like

The integration cannot pair the device. Even though they were no issue, this won’t work as the “ON/OFF” command is not a pairing command. You have to use external tool to do the pairing.

Hy, I’m working on it: pledou/home-assistant-core: :house_with_garden: Open source home automation that puts local control and privacy first. For now I forked it but, once it works, I will publish a component in HACS replacing official enocean.

1 Like