Terug naar het overzicht Handleiding

Mopeka in Home Assistant: je gasfles in de 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

Mopeka in Home Assistant: je gasfles in de camper overal in beeld

Een Mopeka-sensor onder de gasfles meet betrouwbaar. Maar wie het vulpeil in Home Assistant wil hebben, loopt tegen twee hindernissen aan: Bluetooth reikt niet verder dan het zendbereik. En de sensor stuurt geen percentage, maar ruwe data.

Beide zijn op te lossen. Hier staat de route in het kort; alle details en bestanden staan in onze handleiding voor Home Assistant (in het Engels).

Het belangrijkste in het kort

  • De CampMatic-box in het voertuig leest de Mopeka uit via Bluetooth en stuurt de waarden via wifi of 4G over MQTT naar je Home Assistant, waar dat ook draait.
  • In Home Assistant heb je de add-on Mosquitto broker nodig en een kort bridgebestand naar onze server.
  • De Mopeka levert ruwe waarden. Vulhoogte en vulpeil ontstaan via twee templatesensoren met dezelfde formules die ook de CampMatic-app gebruikt. Het kant-en-klare bestand kun je downloaden.
  • Geen abonnement: de app en de server zijn gratis.

Waarom via de CampMatic-box?

Home Assistant leest Bluetooth-sensoren alleen uit binnen het bereik van zijn eigen Bluetooth-hardware. Staat je camper in de winterstalling of op een camperplaats, of ben je ermee onderweg, dan komt er thuis niets van de gasfles binnen.

De CampMatic-box blijft daarom in het voertuig. Hij leest de Mopeka uit waar die zit en levert de waarden via MQTT aan je Home Assistant. Het vulpeil zie je daarnaast in de CampMatic-app en in de Telegram-bot. Voor het gasvulpeil kun je in de app bovendien een melding via e-mail of Telegram instellen.

Wat je nodig hebt

  • Een Mopeka-sensor, bijvoorbeeld de Pro Check onder een stalen of aluminium fles. Sensoren worden niet met CampMatic meegeleverd.
  • Een CampMatic-box: CampMatic Guard voor elke camper of caravan, of CampMatic voor Truma CP Plus of CampMatic voor Truma iNet X als je daarnaast de verwarming via de app wilt bedienen. Alle drie lezen de Mopeka uit.
  • Een werkende Home Assistant-installatie waarop je beheerderstoegang hebt.
  • Ongeveer een halfuur voor de hele handleiding.

De stappen in het kort

  1. Sensor koppelen in de CampMatic-app. Kies onder Settings → Devices → Add device de Mopeka-gaspeilsensor. Verschijnt hij niet, druk dan kort op de SYNC-knop van de Mopeka. Het flestype stel je direct in CampMatic in. Het koppelen gebeurt in de app, niet in Home Assistant (Help: Externe apparaten).
  2. Inloggegevens ophalen. Op de statuspagina van je apparaat in de CampMatic-app staan in de kaart MQTT Bridge (Home Assistant) broker, poort, gebruikersnaam en wachtwoord, en in het blok Device Status het Device ID (hoofdstuk 2).
  3. Mosquitto instellen. Installeer Mosquitto broker (Home Assistant noemt add-ons inmiddels “Apps”), maak eerst de map /share/mosquitto aan en zet daarna de optie customize aan (hoofdstuk 3).
  4. Bridge aanmaken. Het bestand /share/mosquitto/campmatic.conf verbindt jouw broker versleuteld via poort 8883 met de onze. Start Mosquitto daarna opnieuw. In het logboek moet Connecting bridge staan (hoofdstuk 4).
  5. Plaatsnummer opzoeken. Luister in de MQTT-integratie naar campmatic/<GERAETE_ID>/+/config. De regel mopeka/config toont het plaatsnummer (slot) en het flestype (tank_type) van je sensor (hoofdstuk 8).
  6. Sensoren aanmaken. Zet de ruwe waarden en de twee rekensensoren in het pakketbestand, controleer de configuratie en start Home Assistant opnieuw op (hoofdstuk 9).

Welke waarden er binnenkomen

De Mopeka meet met ultrageluid van onderaf door de bodem van de fles. Bij jou komt de looptijd van de geluidspuls binnen, niet het vulpeil. Elke waarde heeft een eigen topic volgens het patroon campmatic/<GERAETE_ID>/mopeka/bottle_<SLOT_MOPEKA>/…:

  • raw_tof: looptijd in microseconden
  • raw_t: temperatuurbyte van 0 tot 127, min 40 geeft graden Celsius
  • battery_raw: sensorbatterij als ruwe byte
  • quality: meetkwaliteit van 0 tot 3
  • rssi: signaalsterkte in dBm

Het plaatsnummer moet je opzoeken: CampMatic nummert de plaatsen doorlopend over alle gekoppelde sensortypen.

Templatesensoren: van looptijd naar vulpeil

Pas met de temperatuur wordt de looptijd een vulhoogte, want geluid is bij kou langzamer. Pas als de hoogte van de fles bekend is, wordt de vulhoogte een vulpeil. Geen van beide zit in de sensor. Het voordeel: nieuwe flestypen en kalibraties vereisen geen firmware-update.

In Home Assistant nemen twee templatesensoren uit hoofdstuk 9 dat over. Ze rekenen met dezelfde formules als de CampMatic-app, zodat beide dezelfde waarde tonen. Uiteindelijk heb je:

  • sensor.gas_bottle_level_height: vulhoogte in millimeters
  • sensor.gas_bottle_level: vulpeil in procent

Daarbij komen temperatuur, sensorbatterij in volt en meetkwaliteit. In de formule voor het vulpeil vul je twee getallen voor je fles in: leeg is altijd 38 mm, vol hangt af van het type, bijvoorbeeld 333 mm bij de stalen fles van 6 kg en 358 mm bij 11 kg staal. De complete tabel staat in de handleiding.

Drie valkuilen die de handleiding uitgebreid uitlegt:

  • In de formule voor de vulhoogte hoort de temperatuurbyte, niet het aantal graden. Anders zien de waarden er aannemelijk uit, maar kloppen ze niet.
  • Een typefout in een entiteitsnaam in de formule levert alleen een lege waarde op, zonder foutmelding. Kopieer de entiteitsnamen uit Developer tools → States (in de Nederlandse interface het tabblad “Statussen”) in plaats van ze over te typen.
  • Nieuwe MQTT-sensoren verschijnen pas na een echte herstart van Home Assistant.

De meetkwaliteit hoort op 2 of 3 te staan. Bij 0 of 1 zit de sensor niet goed. Nieuwe waarden komen meestal maar om de zes minuten binnen en worden niet bewaard. Direct na een herstart zijn ze daarom een paar minuten niet beschikbaar.

Twee flessen, dashboard, problemen oplossen

Heb je twee Mopeka-sensoren, dan maak je het blok een tweede keer aan, met het tweede plaatsnummer en eigen namen. Per box kun je tot acht Bluetooth-sensoren koppelen, waarvan maximaal vier accumonitors. Gaspeilsensoren kun je combineren, bijvoorbeeld een fles met Truma Level Control en een met Mopeka.

Voor de weergave levert de handleiding een kant-en-klaar dashboard dat alleen kaarten gebruikt die standaard in Home Assistant zitten. De graadmeter voor het gas toont groen vanaf 40 en geel vanaf 20 procent; de drempels kun je aanpassen (hoofdstuk 14). Werkt er iets niet, dan helpt hoofdstuk 15, problemen oplossen.

Truma Level Control of Mopeka?

Met een Truma Level Control onder de fles is de route naar Home Assistant korter. Die levert vulpeil, resterende hoeveelheid en resterende dagen kant-en-klaar berekend; templatesensoren heb je daarvoor niet nodig. Hoe dat werkt, lees je in Truma Level Control in Home Assistant. De Mopeka past daarentegen ook bij vaste tanks en Amerikaanse flesmaten.

Wat het kost

  • CampMatic Guard WiFi: € 89. Gebruikt een bestaand wifinetwerk, bijvoorbeeld een mobiele hotspot.
  • CampMatic Guard 4G: € 129. Heeft geen wifi nodig, wel een eigen simkaart (niet inbegrepen), bijvoorbeeld een IoT-simkaart vanaf ca. € 2 per maand.
  • App en server: gratis, zonder abonnement.

Welke Mopeka-modellen CampMatic uitleest, staat op de pagina Integraties.

→ CampMatic Guard WiFi — € 89

→ CampMatic Guard 4G — € 129

Lees verder: