SwitchBot Hub 2: Errore Matter commissioning failed at step 19 PASE handshake timeout

1. A cosa serve

La guida risolve il fallimento dell'associazione Matter over Wi-Fi dello SwitchBot Hub 2 con Home Assistant, interrompendo il blocco al passaggio 19 (PASE Handshake Timeout).

2. Specifiche e compatibilità

Protocollo: Matter over Wi-Fi (IP/UDP). Connettività: Wi-Fi 2.4 GHz. Integrazione: Matter Server Add-on su Home Assistant.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. SwitchBot Hub 2 con firmware v1.0-0.9 o superiore. 2. App Home Assistant Companion. 3. IPv6 abilitato sul router.

Fase 1: Preparazione

Assicurati che lo smartphone con cui inquadri il codice QR Matter sia connesso alla stessa frequenza Wi-Fi 2.4 GHz su cui è registrato lo SwitchBot Hub 2.

[SCHEMA GRAFICO: Associazione Matter over Wi-Fi: SwitchBot Hub 2 (QR Code Matter) <--- PASE Handshake (Port 5540 UDP) ---> Matter Server Home Assistant]

Abilita sempre il supporto IPv6 Multicast (mDNS) nelle impostazioni della rete LAN del tuo router, altrimenti l'handshake PASE del protocollo Matter andrà in timeout!

Non resettare lo SwitchBot Hub 2 staccando l'alimentazione durante l'aggiornamento del firmware per evitare di corrompere l'immagine Matter.

Fase 2: Configurazione

• Apri l'app SwitchBot > Hub 2 > Impostazioni Matter e genera un nuovo codice d'accoppiamento (Pairing Code). 2. In Home Assistant, vai su Impostazioni > Dispositivi e Servizi > Aggiungi Dispositivo > Matter. 3. Inserisci il codice numerico di 11 cifre o inquadra il QR Code. 4. Attendi il completamento del passaggio 19 PASE.

Porta di rete UDP Matter: 5540. Requisito di rete: IPv6 mDNS abilitato.

Fase 3: Automazione / Uso pratico

Automazione YAML per il monitoraggio dello stato di salute dell'Hub Matter:

alias: "System - Controllo Hub 2 Matter Offline"
trigger:
  - platform: state
    entity_id: event.switchbot_hub2_matter_status
    to: "unavailable"
    for:
      minutes: 10
action:
  - service: homeassistant.reload_config_entry
    target:
      entity_id: event.switchbot_hub2_matter_status

Script YAML per reinizializzare il server Matter:

alias: "System - Riavvio Matter Server Addon"
sequence:
  - service: hassio.addon_restart
    data:
      addon: "core_matter_server"

Verifica e test operativo

Controlla la scheda Dispositivi su Home Assistant: lo SwitchBot Hub 2 ed i suoi sensori integrati di temperatura ed umidità devono apparire correttamente registrati.

Lo schermo LED dell'Hub 2 mostra l'icona Matter illuminata di bianco fisso.

Cosa fare se qualcosa non funziona

• Timeout persistente allo step 19: Riavviare l'Add-on Matter Server ed azzerare i codici dall'app SwitchBot. 2. Dispositivo non trovato: Disattivare la rete Wi-Fi 5 GHz durante la procedura. 3. Errore IPv6: Abilitare l'IPv6 nelle impostazioni di rete di Home Assistant OS.

9. Sicurezza e privacy

Comunicazione locale nativa Matter su rete LAN con crittografia end-to-end senza passare dal cloud SwitchBot.

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.