Retour à l'aperçu Guide

Mopeka dans Home Assistant : la bouteille de gaz du camping-car à l’œil, où que vous soyez

Temps de lecture : 6 min
CampMatic

Cet article existe aussi en : Deutsch · English · Español · Italiano · Polski · Čeština · Svenska · Nederlands

Mopeka dans Home Assistant : la bouteille de gaz du camping-car à l’œil, où que vous soyez

Un capteur Mopeka sous la bouteille de gaz mesure de façon fiable. Mais si vous voulez le niveau dans Home Assistant, deux obstacles se présentent : le Bluetooth ne porte pas plus loin que la liaison radio. Et le capteur n’envoie pas de pourcentage, seulement des données brutes.

Les deux se résolvent. Voici le chemin en bref. Tous les détails et fichiers se trouvent dans notre guide Home Assistant (en anglais).

L’essentiel en bref

  • Le boîtier CampMatic dans le véhicule lit le Mopeka en Bluetooth et envoie les valeurs en Wi-Fi ou en 4G via MQTT à votre Home Assistant, où qu’il tourne.
  • Dans Home Assistant, il vous faut l’extension Mosquitto broker et un court fichier de bridge vers notre serveur.
  • Le Mopeka envoie des valeurs brutes. Hauteur de remplissage et niveau sont calculés par deux capteurs template avec les mêmes formules que l’appli CampMatic. Le fichier prêt à l’emploi est téléchargeable.
  • Sans abonnement : l’appli et le serveur sont gratuits.

Pourquoi passer par le boîtier CampMatic ?

Home Assistant ne lit les capteurs Bluetooth qu’à portée de son propre matériel Bluetooth. Si votre camping-car est en hivernage, sur une aire ou en route avec vous, rien de la bouteille de gaz n’arrive chez vous.

Le boîtier CampMatic reste donc dans le véhicule. Il lit le Mopeka là où il se trouve et transmet les valeurs à votre Home Assistant via MQTT. Vous voyez aussi le niveau dans l’appli CampMatic et dans le bot Telegram. Et dans l’appli, vous pouvez configurer une alerte de niveau de gaz par e-mail ou Telegram.

Ce qu’il vous faut

  • Un capteur Mopeka, par exemple le Pro Check sous une bouteille en acier ou en alu. Les capteurs ne sont pas fournis avec CampMatic.
  • Un boîtier CampMatic : CampMatic Guard pour tout camping-car, ou CampMatic pour Truma CP Plus ou CampMatic pour Truma iNet X si vous voulez aussi piloter le chauffage par appli. Les trois lisent le Mopeka.
  • Un Home Assistant en service, avec un accès administrateur.
  • Environ une demi-heure pour l’ensemble du guide.

Les étapes en bref

  1. Appairer le capteur dans l’appli CampMatic. Sous Settings → Devices → Add device, choisissez le capteur de gaz Mopeka. S’il n’apparaît pas, appuyez brièvement sur le bouton SYNC du Mopeka. Le type de bouteille se règle directement dans CampMatic. L’appairage se fait dans l’appli, pas dans Home Assistant (aide : appareils externes).
  2. Récupérer les identifiants. Sur la page Status de votre appareil dans l’appli CampMatic, la carte MQTT Bridge (Home Assistant) indique broker, port, nom d’utilisateur et mot de passe, le bloc Device Status indique le Device ID (chapitre 2).
  3. Installer Mosquitto. Installez Mosquitto broker (Home Assistant appelle désormais les add-ons « apps »), créez d’abord le dossier /share/mosquitto, puis seulement activez l’option customize (chapitre 3).
  4. Créer le bridge. Le fichier /share/mosquitto/campmatic.conf relie votre broker au nôtre, chiffré sur le port 8883. Redémarrez ensuite Mosquitto. Le journal doit afficher Connecting bridge (chapitre 4).
  5. Relever le numéro d’emplacement. Dans l’intégration MQTT, écoutez campmatic/<GERAETE_ID>/+/config. La ligne mopeka/config indique le numéro d’emplacement (slot) et le type de bouteille (tank_type) de votre capteur (chapitre 8).
  6. Créer les capteurs. Ajoutez les valeurs brutes et les deux capteurs de calcul au fichier package, vérifiez la configuration, redémarrez Home Assistant (chapitre 9).

Quelles valeurs arrivent

Le Mopeka mesure par ultrasons, du dessous, à travers le fond de la bouteille. Ce qui vous parvient, c’est le temps de parcours de l’impulsion, pas le niveau. Chaque valeur a son propre topic selon le schéma campmatic/<GERAETE_ID>/mopeka/bottle_<SLOT_MOPEKA>/… :

  • raw_tof : temps de parcours en microsecondes
  • raw_t : octet de température de 0 à 127 ; moins 40 donne les degrés Celsius
  • battery_raw : pile du capteur en octet brut
  • quality : qualité de mesure de 0 à 3
  • rssi : force du signal en dBm

Le numéro d’emplacement doit être relevé : CampMatic numérote les emplacements à la suite, tous types de capteurs confondus.

Capteurs template : du temps de parcours au niveau

Le temps de parcours ne devient une hauteur qu’en tenant compte de la température, car le son est plus lent par temps froid. Et la hauteur ne devient un niveau que si l’on connaît la hauteur de la bouteille. Ni l’un ni l’autre ne se trouve dans le capteur. L’avantage : les nouveaux types de bouteille et les recalibrages ne demandent aucune mise à jour du firmware.

Dans Home Assistant, deux capteurs template du chapitre 9 s’en chargent. Ils utilisent les mêmes formules que l’appli CampMatic, pour que les deux affichent la même valeur. Au final, vous avez :

  • sensor.gas_bottle_level_height : hauteur de remplissage en millimètres
  • sensor.gas_bottle_level : niveau en pourcentage

S’y ajoutent la température, la pile du capteur en volts et la qualité de mesure. Dans la formule du niveau, vous saisissez deux valeurs pour votre bouteille : vide, c’est toujours 38 mm ; plein dépend du type, par exemple 333 mm pour une bouteille acier de 6 kg et 358 mm pour 11 kg acier. Le tableau complet se trouve dans le guide.

Trois pièges que le guide explique en détail :

  • La formule de la hauteur a besoin de l’octet de température, pas des degrés. Sinon les valeurs semblent plausibles, mais sont fausses.
  • Un nom d’entité mal orthographié dans une formule donne simplement une valeur vide, sans message d’erreur. Copiez les noms d’entité depuis Developer tools → States plutôt que de les taper.
  • Les nouveaux capteurs MQTT n’apparaissent qu’après un vrai redémarrage de Home Assistant.

La qualité de mesure doit être à 2 ou 3. À 0 ou 1, le capteur n’est pas bien positionné. Les nouvelles valeurs n’arrivent en général que toutes les six minutes et ne sont pas mises en mémoire tampon ; juste après un redémarrage, elles sont donc indisponibles quelques minutes.

Deux bouteilles, tableau de bord, dépannage

Avec deux capteurs Mopeka, vous ajoutez le bloc une deuxième fois, avec le second numéro d’emplacement et d’autres noms. Chaque boîtier accepte jusqu’à huit capteurs Bluetooth, dont jusqu’à quatre moniteurs de batterie. Les capteurs de gaz se combinent, par exemple une bouteille avec Truma Level Control et une avec Mopeka.

Pour l’affichage, le guide fournit un tableau de bord prêt à l’emploi qui n’utilise que les cartes livrées avec Home Assistant. La jauge de gaz passe au vert à partir de 40 % et au jaune à partir de 20 % ; vous pouvez modifier ces seuils (chapitre 14). Si quelque chose ne fonctionne pas, voyez le chapitre 15, dépannage.

Truma Level Control ou Mopeka ?

Avec un Truma Level Control sous la bouteille, le chemin vers Home Assistant est plus court. Il fournit le niveau, la quantité restante et les jours restants déjà calculés, sans capteur template. Comment faire : Truma Level Control dans Home Assistant. Le Mopeka, lui, convient aussi aux réservoirs fixes et aux formats de bouteille américains.

Ce que cela coûte

  • CampMatic Guard WiFi : 89 €. Utilise un réseau Wi-Fi existant, par exemple un point d’accès mobile.
  • CampMatic Guard 4G : 129 €. Pas besoin de Wi-Fi, mais d’une carte SIM à vous (non fournie), par exemple une carte SIM IoT à partir d’environ 2 € par mois.
  • Appli et serveur : gratuits, sans abonnement.

Les modèles Mopeka que CampMatic lit sont listés sur la page Intégrations.

→ CampMatic Guard WiFi — 89 €

→ CampMatic Guard 4G — 129 €

Pour aller plus loin :