Terug naar het overzicht Handleiding

RuuviTag in Home Assistant: het binnenklimaat van je camper overal in beeld

Leestijd: 6 min
CampMatic

Dit artikel is ook beschikbaar in: Deutsch · English · Français · Español · Italiano · Polski · Čeština · Svenska

RuuviTag in Home Assistant: het binnenklimaat van je camper overal in beeld

Een RuuviTag in de camper meet temperatuur, luchtvochtigheid en luchtdruk. Zolang je ernaast staat, is dat eenvoudig. Maar draait Home Assistant thuis en staat de camper in de winterstalling of op een camperplaats, dan komt er niets binnen: Bluetooth reikt maar een paar meter.

Hier lees je hoe de waarden toch in je Home Assistant terechtkomen en welke entiteiten je uiteindelijk hebt. De afzonderlijke stappen staan in onze handleiding voor Home Assistant (in het Engels).

Het belangrijkste in het kort

  • De route: Een CampMatic-box in het voertuig leest de RuuviTag via Bluetooth uit en stuurt de waarden via wifi of 4G over MQTT naar je Home Assistant, waar dat ook draait.
  • Wat er binnenkomt: temperatuur, luchtvochtigheid, luchtdruk en de batterijspanning van de tag.
  • Wat je moet doen: een MQTT-bridge instellen en de Ruuvi-sensoren één keer in YAML aanmaken. De sjablonen leveren we mee, je vervangt alleen de placeholders.
  • Kosten: geen abonnement. De app en de server zijn gratis.

Waarom niet rechtstreeks via Bluetooth?

Home Assistant leest Bluetooth-sensoren alleen uit binnen het bereik van zijn eigen Bluetooth-hardware. Dat werkt zolang de camper en Home Assistant naast elkaar staan. Staat de camper ergens anders, bijvoorbeeld in de winterstalling, op een camperplaats of onderweg, dan is er iets in het voertuig nodig dat de sensor uitleest en de waarden doorgeeft.

Dat doet de CampMatic-box. Hij leest de RuuviTag in het voertuig uit en levert de waarden via MQTT aan je Home Assistant. Daarnaast zie je ze in de CampMatic-app en via Telegram, ook als Home Assistant even niet draait. Een Ruuvi Gateway heb je daarvoor niet nodig (Integraties: RuuviTag).

Wat je nodig hebt

  • Een CampMatic-box in het voertuig. Elke box leest de RuuviTag uit: CampMatic Guard (alleen sensoren, voor elke camper of caravan, voeding via USB), CampMatic voor Truma CP Plus en CampMatic voor Truma iNet X. Per box koppel je tot acht Bluetooth-sensoren (FAQ), ook meerdere RuuviTags.
  • Een RuuviTag. Die wordt niet meegeleverd.
  • Home Assistant met beheerderstoegang en de add-on Mosquitto broker.
  • Internet in het voertuig: wifi voor de WiFi-variant, een eigen simkaart voor de 4G-variant (niet inbegrepen, IoT-simkaart vanaf ca. € 2 per maand).

Zo krijg je de RuuviTag in Home Assistant

  1. RuuviTag koppelen. Stel de tag eenmalig in met de Ruuvi-app van de fabrikant. Kies daarna in de CampMatic-app onder Settings → Devices → Add device de Ruuvi-omgevingssensor. Tags binnen bereik verschijnen meestal na een paar seconden. Het koppelen gebeurt in de CampMatic-app, niet in Home Assistant (Help: Externe apparaten).
  2. Inloggegevens ophalen. Op de statuspagina van de CampMatic-app staat de kaart “MQTT Bridge (Home Assistant)” met broker, poort, gebruikersnaam, wachtwoord en topicprefix, en in het blok “Device Status” het Device ID (hoofdstuk 2).
  3. Mosquitto instellen. Installeer de add-on, maak de map /share/mosquitto aan en zet pas daarna de optie customize aan. Andersom start de add-on niet meer (hoofdstuk 3).
  4. Bridge aanmaken. Het bestand /share/mosquitto/campmatic.conf verbindt jouw broker met de onze. Vervang de placeholders en start de add-on opnieuw; in het logboek moet “Connecting bridge” staan. Wil je vanuit Home Assistant niets schakelen, dan zet je in de topicregel in in plaats van both (hoofdstuk 4).
  5. Plaatsnummer uitlezen. Luister in de MQTT-integratie naar campmatic/<GERAETE_ID>/+/config. In de regel ruuvi/config staat achter slot het nummer van je tag. De nummers lopen door over alle sensortypen heen en zijn niet te raden (hoofdstuk 8).
  6. Sensoren aanmaken. De kant-en-klare Ruuvi-sensoren komen in het pakketbestand /config/packages/campmatic.yaml onder mqtt: sensor:. Vervang daarin <GERAETE_ID> en <SLOT_RUUVI>, controleer de configuratie en start Home Assistant opnieuw op (hoofdstuk 10). De map packages zet je eenmalig aan, zoals beschreven in hoofdstuk 6.

De handleiding rekent voor het hele traject op ongeveer een halfuur. Alle bestanden staan daar ook als pakket om te downloaden.

Deze waarden komen binnen

Elke waarde heeft een eigen MQTT-topic volgens het patroon campmatic/<GERAETE_ID>/ruuvi/tag_<SLOT_RUUVI>/…. De namen rechts komen uit ons Engelstalige sjabloon:

WaardeTopic eindigt opSensor in het sjabloon
Temperatuur (°C)temp_cIndoor Temperature
Luchtvochtigheid (%)humidityIndoor Humidity
Luchtdruk (hPa)pressure_hpaIndoor Pressure
Batterij van de tag (V)battery_vIndoor Sensor Battery (diagnose)
SignaalsterkterssiIndoor Signal (in het downloadpakket)

De Ruuvi stuurt daarnaast de versnelling in drie assen (accel_x, accel_y, accel_z), een bewegingsteller (moves) en een volgnummer (seq). Heb je die nodig, dan maak je ze volgens hetzelfde patroon aan. Meerdere RuuviTags, bijvoorbeeld in het woongedeelte en in de koelkast, maak je één keer per plaatsnummer aan, met eigen namen.

Drie dingen om te weten:

  • De waarden komen met tussenpozen. De Bluetooth-sensoren melden zich meestal maar om de 6 minuten, en de waarden worden niet bewaard. Na een herstart ontbreken ze daarom een paar minuten. Luister bij het controleren minstens 10 minuten naar campmatic/<GERAETE_ID>/ruuvi/#.
  • Geen oude waarde: Komt er 45 minuten lang niets binnen, dan tonen de sjablonen de sensor als “niet beschikbaar” (unavailable) in plaats van de laatste waarde vast te houden.
  • Luchtdruk ter plaatse. De Ruuvi meet de druk op de plek waar hij ligt. In de bergen is de waarde daarom duidelijk lager dan in het weerbericht.

Ideeën voor automatiseringen

  • Vorstwaarschuwing: Ligt Indoor Temperature een tijdje onder een paar graden, dan stuurt Home Assistant je een bericht. Met de box voor Truma CP Plus kan dezelfde automatisering ook de verwarming inschakelen (hoofdstuk 7). Controleer dan de bedrijfsstatus van de verwarming, niet alleen de schakelaar. Met de box voor Truma iNet X bedien je de verwarming in de CampMatic-app.
  • Koelkast in de gaten houden: Een tweede tag in de koelkast laat weten wanneer de temperatuur daar stijgt.
  • Vocht over meerdere dagen: Het verloop van de luchtvochtigheid laat zien of het in het woongedeelte blijvend te vochtig is.

Voor een eenvoudige waarschuwing heb je Home Assistant niet nodig: de CampMatic-app laat van zich horen via de app, Telegram of e-mail zodra een grenswaarde is bereikt. Home Assistant is de moeite waard voor eigen regels en om je camper te koppelen aan je huis.

Dashboard en problemen oplossen

Het kant-en-klare dashboard uit hoofdstuk 14 heeft een groep “Indoor Climate” met temperatuur, luchtvochtigheid, luchtdruk en verloopgrafiek. Je hebt er geen extra kaarten voor nodig. Kaarten voor sensoren die je niet hebt, verwijder je gewoon.

Blijft een waarde leeg, dan ligt dat meestal aan een van deze oorzaken (hoofdstuk 15):

  • Leeg antwoord op +/config: Er is geen sensor gekoppeld. Dat doe je in de CampMatic-app.
  • Eén sensor zonder waarde: meestal een verkeerd plaatsnummer. Dat kan na opnieuw koppelen veranderen.
  • Meerdere sensoren blijvend “niet beschikbaar”: Controleer of mqtt: meer dan eens in je pakketbestand voorkomt. Dan geldt alleen het laatste blok.
  • Nieuwe sensoren zonder waarde: Start Home Assistant echt opnieuw op. De configuratie herladen is niet genoeg.

Veelgestelde vragen

Ik heb geen Truma-verwarming. Werkt het dan toch?
Ja. Daarvoor is CampMatic Guard bedoeld: de box bewaakt gas, huishoudaccu en binnenklimaat, maar bedient geen verwarming. Een Truma-aansluiting heeft hij niet nodig.

En de huishoudaccu?
Een BM2-accumonitor komt op dezelfde manier in Home Assistant: BM2-accumonitor in Home Assistant.

→ CampMatic Guard · WiFi — € 89

→ CampMatic Guard · 4G — € 129

Lees verder: