18. SwitchBot Contact Sensor: Sensore Porta/Finestra con Raggio Luce e Sensore di Movimento Integrato

1. A cosa serve e Specifiche Tecniche

Il Contact Sensor rileva se una porta o finestra viene aperta o chiusa, ma riconosce anche se stai entrando o uscendo dalla stanza grazie al sensore di movimento integrato sulla scocca.

📊 Scheda Tecnica e Compatibilità

• 🏷️ Prodotto / Modello: SwitchBot Contact Sensor
• ⚙️ Specifiche Hardware: Magnete di contatto + Sensore infrarossi movimento + Sensore luce, Connessione BLE 5.0, Autonomia 2 anni
• 🌐 Protocolli Supportati: Bluetooth BLE 5.0+, Wi-Fi 2.4GHz / 5GHz, Matter over Bridge / Direct, Infrarossi (IR)
• 🏠 Integrazione Home Assistant: Supportata via BLE Proxy locale, Matter integration o SwitchBot Cloud API

2. Materiali e Prerequisiti Necessari

• Hardware: Modulo SwitchBot Contact Sensor in confezione originale.
• Batterie / Alimentazione: Verificare lo stato di carica delle batterie in dotazione o la presenza di un alimentatore USB stabilizzato.
• Connettività: Hub Home Assistant (Raspberry Pi 4 / Mini PC) con Bluetooth integrato o Dongle USB / ESP32 BLE Proxy attivo.
• Smartphone: App SwitchBot ufficiale (iOS / Android) aggiornata all'ultima versione firmware.

Fase 1: procedura originale

3. Fase 1: Preparazione ed Installazione Fisica

Prima di procedere alla configurazione software, effettua l'installazione fisica del dispositivo posizionandolo nel punto strategico della stanza o dell'impianto elettrico.

[SCHEMA GRAFICO INSTALLAZIONE FISICA]
+-----------------------------------------------------------+
|                                                           |
|    [ PARETE / SERRAMENTO / SCATOLA 503 / CILINDRO ]       |
|                            |                              |
|                            v                              |
|           +---------------------------------+             |
|           |   SWITCHBOT_CONTACT_SENSOR     |             |
|           +---------------------------------+             |
|                            |                              |
|             ( Segnale BLE 5.0 / Wi-Fi )                   |
|                            v                              |
|          [ HOME ASSISTANT / HUB 2 / BLE PROXY ]           |
|                                                           |
+-----------------------------------------------------------+

💡 TRUCCO DA PRO DAL BANCO DI PROVA:

Incolla il sensore sulla porta d'ingresso per attivare la scena 'Uscita da Casa' quando la porta si chiude e subito dopo vieni rilevato all'esterno.

Mantieni la distanza tra la parte magnetica ed il sensore principale inferiore a 15mm quando la porta è completamente chiusa.

Fase 2: procedura originale

4. Fase 2: Configurazione ed Integrazione in Home Assistant

Per integrare il dispositivo in Home Assistant mantenendo la massima velocità di risposta locale ed eliminando la latenza del cloud:

1. Abbinamento App: Apri l'app SwitchBot, aggiungi il dispositivo e calibra la corsa o le impostazioni di base.
2. Aggiornamento Firmware: Assicurati che il firmware del dispositivo sia aggiornato all'ultima versione stabile.
3. Rilevamento in HA: Apri Home Assistant -> Impostazioni -> Dispositivi e Servizi. Il dispositivo apparirà automaticamente tra le integrazioni scoperte via Bluetooth.
4. Inserimento Chiave: Se richiesto, inserisci la chiave Encryption Key nell'integrazione SwitchBot Bluetooth.

Stati entità: door_open, door_closed, entering_room, leaving_room.

Fase 3: procedura originale

5. Fase 3: Automazione Pratica e Codice YAML

Di seguito il codice YAML di esempio pronto da copiare ed incollare nel tuo file automations.yaml su Home Assistant per sfruttare al massimo il dispositivo:

alias: "Sicurezza - Avviso Finestra Aperta Clima Acceso"
trigger:
  - platform: state
    entity_id: binary_sensor.contact_sensor_finestra
    to: "on"
    for:
      minutes: 1
condition:
  - condition: state
    entity_id: climate.condizionatore
    state: "cool"
action:
  - service: climate.turn_off
    target:
      entity_id: climate.condizionatore

Verifica e test operativo

6. Verifica e Test Operativo

Per verificare che l'integrazione ed il dispositivo rispondano correttamente senza ritardi:

1. Accedi alla Dashboard Lovelace ed aziona l'entità associata a switchbot_contact_sensor.
2. Verifica che il tempo di risposta del dispositivo sia inferiore a 300ms.
3. Pressione fisica / Trigger: Aziona il sensore o pulsante fisicamente e controlla che l'evento venga registrato immediatamente nei log di Home Assistant (Registro Attività).

Cosa fare se qualcosa non funziona

7. Troubleshooting ed Isolamento Locale

Se il dispositivo risulta "Non Disponibile" o risponde con latenza:

• Disconnessioni BLE: Aggiungi un ESP32 BLE Proxy economico nella stessa stanza del dispositivo per estendere la copertura Bluetooth di Home Assistant.
• Batteria scarica: Se la percentuale della batteria scende sotto il 15%, la potenza del modulo radio BLE si riduce significativamente causando perdite di pacchetti.
• Integrazione Cloud: Se utilizzi le API Cloud, verifica che il token API generato nell'app SwitchBot non sia scaduto.

8. Sicurezza, Privacy e Manutenzione

• Operatività Locale: Prediligi l'integrazione Bluetooth BLE locale o Matter over Thread per fare in modo che le automazioni funzionino anche in assenza di connessione Internet.
• Manutenzione: Sostituisci le batterie utilizzandone esclusivamente di tipo alcalino o al litio di alta qualità (Panasonic, Duracell) ed evita batterie ricaricabili NiMH con tensione a 1.2V per prevenire letture errate.

9. Requisiti e Risorse Ufficiali

• Sito Ufficiale: Documentazione e Firmware Ufficiale SwitchBot
• Repository HA: Integrazione SwitchBot Bluetooth Home Assistant

🛒 Acquista su Amazon in Offerta:

Per acquistare SwitchBot Contact Sensor originale al miglior prezzo garantito con spedizione Prime:

👉 Acquista SwitchBot Contact Sensor su Amazon.it (Link Affiliato Ufficiale RisparmioHub)

Controlli editoriali prima di iniziare

Annota modello, revisione hardware e versione firmware visibili nell’app prima di modificare qualsiasi impostazione. Conserva anche il nome delle entità già presenti in Home Assistant: questo riferimento permette di riconoscere subito duplicati o variazioni dopo il nuovo abbinamento.

Se il dispositivo partecipa a un’automazione esistente, disattivala temporaneamente dall’interfaccia grafica e salva una copia della configurazione. Esegui una sola modifica per volta, quindi attendi l’aggiornamento dello stato prima di passare al controllo successivo.

Verifica copertura Bluetooth, Wi-Fi o Thread nel punto di installazione senza spostare contemporaneamente hub e accessorio. Un test vicino al gateway distingue un problema radio da un errore di configurazione e rende più semplice ripristinare la situazione iniziale.

Al termine confronta comando nell’app, stato mostrato in Home Assistant e risposta fisica del dispositivo. Se uno dei tre risultati non coincide, interrompi la prova, consulta i messaggi del registro e ripeti soltanto il passaggio coinvolto.

Prima dell’uso quotidiano controlla infine autorizzazioni dell’account, aggiornamenti disponibili e funzionamento locale in assenza temporanea di Internet. Registra l’esito e la data del test: saranno utili per distinguere un futuro guasto da un cambiamento introdotto da firmware, integrazione o rete domestica.