Torna alla panoramica Guida

Integrare un RuuviTag in Home Assistant: il clima del camper da qualsiasi luogo

Tempo di lettura: 6 min
CampMatic

Questo articolo è disponibile anche in: Deutsch · English · Français · Español · Polski · Čeština · Svenska · Nederlands

Integrare un RuuviTag in Home Assistant: il clima del camper da qualsiasi luogo

Un RuuviTag nel tuo camper o autocaravan misura temperatura, umidità e pressione dell’aria. Finché sei lì accanto è facile. Ma se Home Assistant gira a casa e il camper è in rimessaggio invernale o in un’area di sosta, non arriva nulla: il Bluetooth copre solo pochi metri.

Questo articolo mostra come i valori arrivano comunque nel tuo Home Assistant e quali entità ottieni. I passaggi dettagliati sono nella nostra guida per Home Assistant, scritta in inglese.

In breve

  • Il percorso: un box CampMatic nel veicolo legge il RuuviTag via Bluetooth e invia i valori via WiFi o 4G tramite MQTT al tuo Home Assistant, ovunque si trovi.
  • Cosa arriva: temperatura, umidità, pressione dell’aria e tensione della batteria del sensore.
  • Impegno: configurare un bridge MQTT e creare una volta i sensori Ruuvi in YAML. Forniamo noi i modelli, tu sostituisci solo i segnaposto.
  • Costi: nessun abbonamento. App e server sono gratuiti.

Perché non direttamente via Bluetooth?

Home Assistant legge i sensori Bluetooth solo entro la portata radio del proprio hardware Bluetooth. Funziona finché camper e Home Assistant sono vicini. Se il veicolo è altrove, in rimessaggio, in un’area di sosta o in viaggio, serve qualcosa a bordo che legga il sensore e inoltri i valori.

È il compito del box CampMatic. Legge il RuuviTag nel veicolo e consegna i valori tramite MQTT al tuo Home Assistant. Li vedi anche nell’app CampMatic e su Telegram, pure quando Home Assistant è spento. Non ti serve un Ruuvi Gateway (Integrazioni: RuuviTag).

Cosa ti serve

  • Un box CampMatic nel veicolo. Ogni box legge il RuuviTag: CampMatic Guard (solo sensori, per qualsiasi camper, alimentazione via USB), CampMatic per Truma CP Plus e CampMatic per Truma iNet X. Ogni box gestisce fino a otto sensori Bluetooth (FAQ), anche più RuuviTag.
  • Un RuuviTag. Non è incluso.
  • Home Assistant con accesso da amministratore e il componente aggiuntivo Mosquitto broker.
  • Internet a bordo: WiFi per la variante WiFi, una tua SIM per la variante 4G (non inclusa, SIM IoT da circa 2 € al mese).

I passaggi

  1. Abbinare il RuuviTag. Configura il sensore una volta con l’app Ruuvi del produttore. Poi, nell’app CampMatic, vai su Settings → Devices → Add device e scegli il sensore ambientale Ruuvi. I sensori nel raggio d’azione compaiono di solito in pochi secondi. L’abbinamento si fa nell’app CampMatic, non in Home Assistant (Aiuto: Dispositivi esterni).
  2. Recuperare le credenziali. La pagina Status dell’app CampMatic contiene la scheda «MQTT Bridge (Home Assistant)» con broker, porta, utente, password e prefisso dei topic; il blocco «Device Status» mostra il Device ID (capitolo 2).
  3. Installare Mosquitto. Installa il componente, crea la cartella /share/mosquitto e solo dopo attiva l’opzione customize. Al contrario, il componente non si avvia più (capitolo 3).
  4. Creare il bridge. Il file /share/mosquitto/campmatic.conf collega il tuo broker al nostro. Sostituisci i segnaposto, riavvia il componente: nel log deve comparire «Connecting bridge». Se da Home Assistant non vuoi comandare nulla, nella riga del topic metti in al posto di both (capitolo 4).
  5. Leggere il numero di slot. Nell’integrazione MQTT ascolta il topic campmatic/<GERAETE_ID>/+/config. Nella riga ruuvi/config, il numero dopo slot è quello del tuo sensore. I numeri sono assegnati attraverso tutti i tipi di sensore e non si possono indovinare (capitolo 8).
  6. Creare i sensori. I sensori Ruuvi già pronti vanno nel file /config/packages/campmatic.yaml, sotto mqtt: sensor:. Sostituisci <GERAETE_ID> e <SLOT_RUUVI>, controlla la configurazione e riavvia Home Assistant (capitolo 10). La cartella packages si attiva una sola volta, come descritto nel capitolo 6.

La guida calcola circa mezz’ora per il percorso completo. Lì trovi anche tutti i file in un unico download.

Quali valori arrivano

Ogni valore ha un proprio topic MQTT secondo lo schema campmatic/<GERAETE_ID>/ruuvi/tag_<SLOT_RUUVI>/…. I nomi a destra sono quelli del modello inglese:

ValoreIl topic termina conSensore nel modello
Temperatura (°C)temp_cIndoor Temperature
Umidità (%)humidityIndoor Humidity
Pressione (hPa)pressure_hpaIndoor Pressure
Batteria del sensore (V)battery_vIndoor Sensor Battery (diagnostica)
Intensità del segnalerssiIndoor Signal (nel pacchetto da scaricare)

Il Ruuvi invia anche l’accelerazione su tre assi (accel_x, accel_y, accel_z), un contatore di movimenti (moves) e un numero di sequenza (seq). Se ti servono, creali con lo stesso schema. Con più RuuviTag, per esempio nella zona giorno e nel frigorifero, crei i sensori una volta per ogni numero di slot, ciascuno con il proprio nome.

Tre cose da sapere:

  • I valori arrivano a intervalli. I sensori Bluetooth di solito si fanno sentire solo ogni 6 minuti e i valori non vengono memorizzati. Dopo un riavvio mancano quindi per qualche minuto. Per verificare, ascolta campmatic/<GERAETE_ID>/ruuvi/# per almeno 10 minuti.
  • Niente valori vecchi: se per 45 minuti non arriva nulla, i modelli mostrano il sensore come «non disponibile» invece di tenere l’ultimo valore.
  • Pressione locale. Il Ruuvi misura la pressione nel punto in cui si trova. In montagna il valore è quindi molto più basso di quello delle previsioni meteo.

Idee per le automazioni

  • Allerta gelo: se Indoor Temperature resta per un po’ sotto pochi gradi, Home Assistant ti manda un messaggio. Con il box per Truma CP Plus la stessa automazione può anche accendere il riscaldamento (capitolo 7); in quel caso controlla lo stato di funzionamento del riscaldamento, non solo l’interruttore. Con il box per Truma iNet X il riscaldamento si comanda nell’app CampMatic.
  • Frigorifero sott’occhio: un secondo sensore nel frigorifero segnala quando la temperatura sale.
  • Umidità nei giorni: lo storico mostra se la cellula abitativa resta troppo umida.

Per un semplice avviso Home Assistant non serve: l’app CampMatic ti avvisa tramite app, Telegram o e-mail non appena viene raggiunta una soglia. Home Assistant conviene per regole tue e per collegare il camper al resto della casa.

Dashboard e risoluzione dei problemi

La dashboard pronta del capitolo 14 ha un gruppo «Indoor Climate» con temperatura, umidità, pressione e grafico dello storico, senza schede aggiuntive. Elimina le schede dei sensori che non hai.

Se un valore resta vuoto, la causa è spesso una di queste (capitolo 15):

  • Risposta vuota su +/config: nessun sensore è abbinato. Si fa nell’app CampMatic.
  • Un solo sensore senza valore: quasi sempre un numero di slot sbagliato. Può cambiare dopo un nuovo abbinamento.
  • Più sensori sempre «non disponibili»: controlla se mqtt: compare più di una volta nel file del pacchetto. In quel caso vale solo l’ultimo blocco.
  • Sensori nuovi senza valore: riavvia davvero Home Assistant. Ricaricare la configurazione non basta.

Domande frequenti

Non ho un riscaldamento Truma. Funziona lo stesso?
Sì. Per questo c’è CampMatic Guard: sorveglia gas, batteria di servizio e clima interno, ma non comanda alcun riscaldamento. Non ha bisogno di un collegamento Truma.

E la batteria di servizio?
Un monitor batteria BM2 arriva in Home Assistant per la stessa strada: Integrare il monitor batteria BM2 in Home Assistant.

→ CampMatic Guard · WiFi — 89 €

→ CampMatic Guard · 4G — 129 €