Sonoff Zigbee Dongle-E (ZBDongle-E): Cannot open /dev/ttyUSB0 ed errore porta seriale persa al riavvio

1. A cosa serve

La guida risolve l'errore Errno 2: No such file or directory relativo alla scomparsa del device seriale /dev/ttyUSB0 del Sonoff ZBDongle-E (chip EZSP Silicon Labs EFR32MG21) dopo il riavvio di Home Assistant OS.

2. Specifiche e compatibilità

Hardware: Sonoff ZBDongle-E (Silicon Labs EFR32MG21 + CH9102F). Adapter: ezsp / ember. Piattaforme: Zigbee2MQTT / ZHA.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Sonoff ZBDongle-E collegato a prolunga USB. 2. Accesso al Terminale SSH di Home Assistant.

Fase 1: Preparazione

Esegui il comando ls /dev/serial/by-id/ dal terminale SSH per identificare l'ID univoco persistente del chip CH9102F collegato al sistema.

[SCHEMA GRAFICO: Mappatura Seriale Persistente: /dev/ttyUSB0 (Dinamico a Rischio) ===> /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2... (Stabile)]

Sui firmware Z2M recenti, imposta il tipo di adapter su ember anziché ezsp per beneficiare del nuovo driver di comunicazione ad alta stabilità per EFR32MG21!

Non scollegare la chiavetta USB mentre il sistema operativo sta eseguendo la scrittura dei file di log della rete Zigbee.

Fase 2: Configurazione

• Apri la configurazione di Zigbee2MQTT (o ZHA). 2. Sostituisci il valore port: /dev/ttyUSB0 con l'ID completo letto dal terminale. 3. Imposta adapter: ember. 4. Salva e riavvia l'Add-on.

Configurazione seriale ZBDongle-E: port: /dev/serial/by-id/..., adapter: ember, baudrate: 115200.

Fase 3: Automazione / Uso pratico

Configurazione seriale per Sonoff ZBDongle-E in configuration.yaml di Z2M:

serial:
  port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_20221118114548-if00-port0
  adapter: ember
  baudrate: 115200
advanced:
  log_level: info

Automazione YAML di notifica per disconnessione porta seriale:

alias: "System - Disconnessione Seriale Dongle-E"
trigger:
  - platform: state
    entity_id: sensor.zigbee2mqtt_bridge_state
    to: "offline"
action:
  - service: notify.persistent_notification
    data:
      title: "🚨 Porta Seriale ZBDongle-E Persa"
      message: "Verificare la prolunga USB o la mappatura /dev/serial/by-id/."

Verifica e test operativo

Riavvia completamente Home Assistant OS da Impostazioni > Sistema > Riavvia Sistema: al riavvio Zigbee2MQTT deve avviarsi automaticamente in meno di 20 secondi.

L'Add-on mostra il log verde Adapter ember initialized successfully.

Cosa fare se qualcosa non funziona

• Cannot open port: Inserire la chiavetta su una porta USB 2.0 diversa. 2. Baudrate Error: Impostare baudrate su 115200. 3. Errore EZSP: Aggiornare il firmware del Dongle-E all'ultima versione EmberZNet.

9. Sicurezza e privacy

Mappatura seriale gestita direttamente dal kernel Linux di Home Assistant OS.

10. Requisiti e Risorse Ufficiali

Questa guida risolve una problematica tecnica di configurazione o sistema domotico. Di seguito i riferimenti alle documentazioni ufficiali:

* 🌐 Documentazione Ufficiale Home Assistant: [home-assistant.io/help](https://www.home-assistant.io/help/)

* 📦 Repository GitHub Troubleshooting: [github.com/home-assistant/core/issues](https://github.com/home-assistant/core/issues)

* 🛠️ Prerequisiti di sistema: Server Home Assistant OS aggiornato, connessione di rete LAN locale ed accesso Amministratore.