Sensore Movimento Sonoff (SNZB-03): Entità bloccata stabilmente su Detected ed Occupancy clear timeout

1. A cosa serve

La guida risolve il problema del sensore di movimento PIR Sonoff SNZB-03 la cui entità di presenza rimane bloccata nello stato Detected (Rilevato) senza mai tornare a Clear (Nessun movimento).

2. Specifiche e compatibilità

Protocollo: Zigbee 3.0. Batteria: 1x CR2450 al litio. Sensore: PIR Infrarossi. Piattaforme: ZHA, Zigbee2MQTT.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Spillo di reset. 2. Batteria CR2450 nuova (> 3.0V). 3. Coordinatore Zigbee attivo.

Fase 1: Preparazione

Verifica che la finestra plastica del sensore PIR sia pulita e che il sensore non sia puntato verso sorgenti di calore mutevoli come termosifoni o stufe.

[SCHEMA GRAFICO: Flusso Reset Occupancy SNZB-03: Rilevamento Movimento (ON) ---> Timer Interno (60s) ---> Invio Pacchetto Clear (OFF) ---> Z2M / ZHA]

Imposta il parametro occupancy_timeout: 60 nella scheda settings di Zigbee2MQTT per forzare il ripristino software dello stato OFF se il sensore perde il pacchetto di chiusura!

Fai attenzione durante l'apertura del guscio posteriore a non piegare le lamelle metalliche di contatto della batteria CR2450.

Fase 2: Configurazione

• Apri l'interfaccia di Zigbee2MQTT > seleziona il sensore SNZB-03 > scheda Settings (Specific). 2. Imposta occupancy_timeout su 60. 3. Premi il pulsante di reset sul sensore per 1 secondo per svegliarlo ed applicare la modifica.

Parametro Z2M: occupancy_timeout: 60.

Fase 3: Automazione / Uso pratico

Configurazione manuale del timeout di presenza in configuration.yaml di Z2M:

devices:
  '0x00124b0023a1b2c3':
    friendly_name: sensore_movimento_corridoio
    occupancy_timeout: 60

Automazione YAML per il ripristino di sicurezza dell'entità bloccata:

alias: "Fix - Reset Forzato Movimento Sonoff"
trigger:
  - platform: state
    entity_id: binary_sensor.sonoff_snzb03_occupancy
    to: "on"
    for:
      minutes: 5
action:
  - service: python_script.set_state
    data:
      entity_id: binary_sensor.sonoff_snzb03_occupancy
      state: "off"

Verifica e test operativo

Copri la lente del sensore con una scatola e attendi 60 secondi: l'entità binary_sensor su Home Assistant deve commutare su OFF.

Il LED rosso all'interno della lente PIR smette di lampeggiare ed il registro aggiorna lo stato a Clear.

Cosa fare se qualcosa non funziona

• Blocco persistente su ON: La batteria CR2450 è quasi scarica (< 2.7V), sostituirla. 2. Sensore non rileva movimento: Verificare il tempo di cieco (blind time) di 60 secondi. 3. Disconnessione radio: Eseguire il re-pairing vicino al coordinatore.

9. Sicurezza e privacy

Elaborazione locale immediata senza latenze dei segnali di sicurezza.

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.