Questa integrazione per Home Assistant consente l'utilizzo di dispositivi Xsense all'interno di un sistema di casa intelligente. È stata creata sulla base del codice originale di Theo Snel ed è stata pubblicata con la sua autorizzazione e in collaborazione con lui.
Fino a quando non sarà disponibile un'integrazione ufficiale per Home Assistant da parte di Theo, verrà utilizzata questa integrazione HACS, che verrà regolarmente aggiornata per aggiungere nuove funzionalità e risolvere eventuali problemi. Questa integrazione consente agli utenti di integrare facilmente i loro dispositivi Xsense in Home Assistant e di utilizzarli per varie automazioni e monitoraggi.
- Integrazione di diversi dispositivi Xsense in Home Assistant.
- Supporto per automazioni basate sui dati dei sensori Xsense.
- Supporto per i seguenti tipi di dispositivi: stazioni base, rilevatori di fumo, rilevatori di monossido di carbonio, rilevatori di calore, rilevatori di perdite d'acqua e igrometri.
- Configurazione semplice tramite HACS (Home Assistant Community Store).
- Un server Home Assistant funzionante (si consiglia l'ultima versione).
- Un account Xsense con dispositivi supportati.
- HACS deve essere installato in Home Assistant per consentire l'installazione dell'integrazione.
Per una guida dettagliata all'installazione e alla configurazione dell'integrazione, puoi guardare il seguente video:
Prima di installare l'integrazione, sono necessarie alcune preparazioni:
-
Crea un secondo account nell'app X-Sense (da utilizzare con Home Assistant): Poiché non è possibile accedere contemporaneamente all'app e a Home Assistant con lo stesso account, consigliamo di utilizzare un account separato per Home Assistant. In questo modo si evita di essere disconnessi continuamente dall'app o da Home Assistant. L'account aggiuntivo consente un'integrazione fluida e un utilizzo continuo senza interruzioni.
-
Condividi i dispositivi supportati dall'account principale con l'account Home Assistant: Utilizza l'app X-Sense per condividere solo i dispositivi supportati con l'account appena creato. In questo modo sarà possibile utilizzare facilmente l'integrazione in Home Assistant continuando a gestire i dispositivi tramite l'account principale.
-
Apri HACS in Home Assistant: HACS è un'importante estensione per Home Assistant che consente di installare facilmente integrazioni personalizzate.
-
Vai ai repository personalizzati: Vai alle impostazioni nella dashboard di HACS e aggiungi il repository come fonte personalizzata.
-
Aggiungi il repository: Inserisci l'URL del repository:
https://github.com/Jarnsen/ha-xsense-component_test
-
Scarica e installa l'integrazione: Cerca l'integrazione in HACS, scaricala e installala. Dopo l'installazione, la configurazione può essere effettuata tramite l'interfaccia di Home Assistant.
Dopo l'installazione è necessaria una configurazione di base per impostare correttamente l'integrazione:
-
Nome utente e password: Utilizza le credenziali dell'account X-Sense appena creato per stabilire la connessione.
-
Panoramica dei dispositivi: Dopo la configurazione riuscita, i dispositivi condivisi saranno disponibili in Home Assistant e potranno essere utilizzati per le automazioni.
Dopo una corretta installazione e configurazione, l'integrazione sarà visibile in Home Assistant. I dispositivi saranno visibili sulla dashboard e potranno essere utilizzati per automazioni, notifiche e altre applicazioni.
Questa integrazione supporta diversi dispositivi Xsense. Ecco un elenco dei dispositivi attualmente confermati e testati:
- Stazione base (SBS50): Hub centrale per i dispositivi Xsense.
- Rilevatore di calore (XH02-M): Rilevamento di temperature insolitamente elevate.
- Rilevatore di monossido di carbonio (XC01-M; XC04-WX): Rileva concentrazioni pericolose di monossido di carbonio.
- Rilevatore di fumo (XS01-M, WX; XS03-WX; XS0B-MR): Rilevamento precoce del fumo.
- Rilevatore combinato di monossido di carbonio e fumo (SC07-WX; XP0A-MR (parzialmente supportato)): Dispositivi combinati per rilevare sia il monossido di carbonio che il fumo.
- Rilevatore di perdite d'acqua (SWS51): Rileva la presenza di acqua in luoghi indesiderati.
- Igrometro-termometro (STH51): Monitoraggio della temperatura e dell'umidità.
Questi dispositivi possono essere utilizzati per creare automazioni e avvisi una volta integrati in Home Assistant.
Con questa integrazione, è possibile creare diverse automazioni. Ecco alcuni esempi:
Quando la temperatura di un termometro Xsense è troppo alta, viene inviata una notifica:
automation:
- alias: "Avviso di temperatura Xsense"
trigger:
platform: numeric_state
entity_id: sensor.xsense_temperature
above: 30
action:
service: notify.notify
data:
message: "La temperatura supera i 30 gradi!"Quando il rilevatore di perdite d'acqua rileva una presenza d'acqua, viene attivato un avviso:
automation:
- alias: "Allarme del rilevatore di perdite d'acqua"
trigger:
platform: state
entity_id: binary_sensor.xsense_waterleak
to: "on"
action:
service: notify.notify
data:
message: "Rilevata perdita d'acqua!"Siamo sempre alla ricerca di supporto per sviluppare e migliorare ulteriormente questa integrazione. Ecco alcuni modi in cui puoi aiutare:
-
Test dei dispositivi: Se possiedi un dispositivo Xsense che funziona con l'integrazione, faccelo sapere in modo da poterlo aggiungere all'elenco dei dispositivi supportati.
-
Feedback sui dispositivi non supportati: Se un dispositivo non funziona, forniscici un feedback in modo che possiamo fornire supporto o includere il dispositivo nelle versioni future dell'integrazione.
-
Condivisione dei dispositivi per i test: Il modo migliore per testare nuovi dispositivi è condividerli tramite l'app X-Sense. In questo modo possiamo garantire che il maggior numero possibile di dispositivi sia supportato.
-
Supporto della comunità: Partecipa alle discussioni nella nostra comunità. Che si tratti di suggerimenti per miglioramenti o di aiutare altri utenti con la loro installazione, ogni aiuto è ben accetto!
Per discussioni e supporto, puoi unirti al nostro server Discord o visitare il forum Home Assistant: