I sensori dell'acquario che hai già in Home Assistant, in TankTutor
Scegli i sensori e l'integrazione invia le loro letture alla pagina della vasca: temperatura, pH, conducibilità, salinità, ammoniaca, aria ed eventi come una perdita d'acqua. L'assistente conosce i valori più recenti.
Home Assistant è un marchio di Nabu Casa, Inc., usato qui solo per descrivere la compatibilità. TankTutor non è affiliato a Nabu Casa né al progetto Home Assistant, che non lo approvano né lo sponsorizzano.
Esempio: i sensori da inviare
leak)binary_sensor.perdita_vascaI nomi delle entità sono solo un esempio. Viene inviato solo ciò che scegli.
Cosa arriva in TankTutor
Per ogni vasca scegli al massimo un sensore per tipo di misura. L'integrazione funziona in un solo verso: invia le letture, non crea entità in Home Assistant e non legge dati da TankTutor.
- Temperatura dell'acquaIn °C o °F; TankTutor la salva in °C.
- pHSenza unità.
- ConducibilitàIn µS/cm; i valori in mS/cm o S/cm vengono convertiti.
- SalinitàIn ppt o come densità (SG): l'unità la scegli tu. Solo per le vasche marine e salmastre.
- AmmoniacaIn mg/L o ppm. Indichi tu se il sensore misura l'ammoniaca libera (NH₃) o totale.
- AriaTemperatura e umidità dell'aria, nel riquadro «Ambiente» della vasca.
- EventiDa un sensore acceso/spento: perdita d'acqua, livello basso, livello alto o un nome tuo (al massimo 10 per vasca). Per la perdita l'email urgente è già attiva; per gli altri eventi la attivi tu nella sezione «Eventi dei sensori» della vasca.
I parametri dell'acqua entrano nello storico e nei grafici della vasca.
Cosa serve
- Un account TankTutor con almeno una vasca.
- Home Assistant con HACS installato.
- Una chiave device per ogni vasca da collegare: al massimo 4 chiavi attive per account, sommando tutte le vasche.
Come si installa
- Installa l'integrazione da HACSIn HACS aggiungi un repository personalizzato (custom repository) con l'indirizzo
https://github.com/tanktutor-org/tanktutor-homeassistante il tipo «Integration», poi installa TankTutor. - Crea una chiave deviceIn TankTutor, nella pagina della vasca, apri la sezione «Chiavi device» e genera una nuova chiave. Copiala subito: viene mostrata una sola volta.
- Aggiungi TankTutor in Home AssistantAggiungi l'integrazione TankTutor e incolla la chiave; l'indirizzo dell'API è già compilato. La chiave viene controllata subito: se è sbagliata o revocata viene rifiutata, altrimenti la voce prende il nome della vasca.
- Scegli i sensoriNelle opzioni dell'integrazione indica quale sensore usare per ogni tipo di misura e aggiungi gli eventi. Da quel momento le letture partono da sole.
Per un'altra vasca ripeti i passaggi 2, 3 e 4: ogni vasca ha la sua chiave.
Cosa viene inviato
- Solo i sensori che hai scelto, e di ciascuno solo tipo, valore, unità e ora della lettura.
- Nessun identificativo, nome, area o altro dato delle entità di Home Assistant.
- Un valore non utilizzabile (sconosciuto, non disponibile, non numerico o con un'unità non ammessa) non viene mai inviato.
- La chiave resta nella configurazione dell'integrazione e non viene mai scritta nei log.
Limiti da sapere
- TankTutor accetta al massimo un invio ogni 5 minuti per account, per tutte le vasche insieme. Per i valori numerici parte l'ultima lettura di ogni sensore, non ogni variazione.
- Un evento che si attiva parte appena il limite lo permette: può arrivare con qualche minuto di ritardo.
- Se TankTutor non è raggiungibile, le letture restano in coda, anche dopo un riavvio di Home Assistant, e partono appena possibile. Quelle più vecchie di 7 giorni vengono scartate.
- La salinità è accettata solo per le vasche marine e salmastre: su una vasca d'acqua dolce viene ignorata.
- Se la chiave viene revocata, Home Assistant ti chiede una nuova chiave e la controlla prima di salvarla.
Per chi sviluppa
L'integrazione è open source, con licenza MIT. Puoi anche fare a meno dell'integrazione e inviare le letture con una richiesta HTTP e una chiave device: l'API è descritta nella documentazione.