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
- 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).
- 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).
- Installare Mosquitto. Installa il componente, crea la cartella
/share/mosquittoe solo dopo attiva l’opzionecustomize. Al contrario, il componente non si avvia più (capitolo 3). - Creare il bridge. Il file
/share/mosquitto/campmatic.confcollega 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 mettiinal posto diboth(capitolo 4). - Leggere il numero di slot. Nell’integrazione MQTT ascolta il topic
campmatic/<GERAETE_ID>/+/config. Nella rigaruuvi/config, il numero doposlotè quello del tuo sensore. I numeri sono assegnati attraverso tutti i tipi di sensore e non si possono indovinare (capitolo 8). - Creare i sensori. I sensori Ruuvi già pronti vanno nel file
/config/packages/campmatic.yaml, sottomqtt: 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:
| Valore | Il topic termina con | Sensore nel modello |
|---|---|---|
| Temperatura (°C) | temp_c | Indoor Temperature |
| Umidità (%) | humidity | Indoor Humidity |
| Pressione (hPa) | pressure_hpa | Indoor Pressure |
| Batteria del sensore (V) | battery_v | Indoor Sensor Battery (diagnostica) |
| Intensità del segnale | rssi | Indoor 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.