Un Victron SmartSolar dans le camping-car, un SmartShunt ou un BMV-712 Smart sur la batterie cellule et Home Assistant à la maison : ces valeurs ont leur place ensemble sur un tableau de bord, avec historique et avec la production solaire dans le tableau de bord Énergie. Voici le chemin en bref. Tous les détails et fichiers se trouvent dans notre guide Home Assistant (en anglais).
L’essentiel en bref
- Compatibles : les régulateurs solaires Victron SmartSolar MPPT et les moniteurs de batterie SmartShunt et BMV-712 Smart.
- Le principe : le boîtier CampMatic dans le véhicule lit la fonction Bluetooth « Instant Readout » des appareils Victron et envoie des valeurs prêtes à l’emploi en Wi-Fi ou en 4G via MQTT à votre Home Assistant.
- Une seule fois : la clé issue de l’appli VictronConnect. Elle se saisit dans l’appli CampMatic, pas dans Home Assistant.
- Condition : le firmware 1.37.15 ou plus récent sur le boîtier. Cela vaut pour CampMatic Guard, CampMatic pour Truma CP Plus et CampMatic pour Truma iNet X.
- Lecture seule : CampMatic ne commande rien sur l’appareil Victron.
Pourquoi passer par le boîtier CampMatic ?
VictronConnect n’affiche les valeurs qu’à portée Bluetooth. Il en va de même pour Home Assistant : il ne reçoit les appareils Bluetooth qu’à portée de son propre matériel Bluetooth. Si Home Assistant tourne à la maison et que le camping-car est en hivernage, sur une aire ou en route, rien n’arrive.
Le boîtier CampMatic reste dans le véhicule, à quelques mètres du régulateur. Il lit ce que le régulateur émet de toute façon en Bluetooth et transmet les valeurs en Wi-Fi ou en 4G via MQTT à votre Home Assistant, où qu’il tourne, ainsi qu’à l’appli CampMatic et au bot Telegram. Pas de câble, pas d’appareil GX, pas de cloud VRM.
Ce qu’il vous faut
- Un appareil Victron avec Bluetooth intégré : SmartSolar MPPT, SmartShunt ou BMV-712 Smart.
- Un boîtier CampMatic avec le firmware 1.37.15 ou plus récent. Les boîtiers plus anciens reçoivent la mise à jour sur demande auprès du support et l’installent eux-mêmes via l’appli.
- Un emplacement libre : chaque appareil Victron occupe l’un des huit emplacements Bluetooth maximum par boîtier.
- Home Assistant avec l’extension Mosquitto broker, et vos identifiants MQTT issus de l’appli CampMatic.
Étape 1 : récupérer la clé dans VictronConnect
Les libellés ci-dessous sont ceux de l’interface anglaise de VictronConnect.
- Dans VictronConnect, touchez votre appareil. Le code PIN d’usine est
000000. - En haut à droite, touchez la roue dentée, puis ⋮ → Product info.
- Activez « Instant readout via Bluetooth ». L’interrupteur affiche ensuite « Enabled ».
- À côté de « Instant readout details · Encryption data », touchez SHOW. La clé fait 32 caractères : 0 à 9 et a à f. Copiez-la au lieu de la retaper : un seul caractère faux, et le boîtier ne peut rien lire.
- Fermez VictronConnect.
Une capture d’écran de l’endroit se trouve dans l’aide, rubrique Appareils externes. La clé permet uniquement la lecture, pas la commande.
Étape 2 : appairer dans l’appli CampMatic
Sous Settings → Devices → Add device, choisissez Victron SmartSolar MPPT ou Victron SmartShunt / BMV, touchez votre appareil dans la liste et collez la clé. Si la clé est fausse ou si l’Instant Readout est désactivé, l’appli vous dit quoi faire.
Même si vous ne voulez les valeurs que dans Home Assistant : la clé se saisit dans l’appli CampMatic. Home Assistant reçoit des valeurs prêtes à l’emploi et n’en a pas besoin.
Étape 3 : le chemin vers Home Assistant
- Noter les identifiants : utilisateur, mot de passe, numéro d’appareil et Device ID depuis l’appli (chapitre 2).
- Installer Mosquitto et le bridge : créer d’abord le dossier
/share/mosquitto, puis activercustomize(chapitre 3), puis créer le fichier de bridge et redémarrer l’extension (chapitre 4). Pour vérifier que les valeurs arrivent, écoutezcampmatic/<GERAETE_ID>/#(chapitre 5). Les valeurs Victron ne s’annoncent pas toutes seules : elles arrivent sur leurs propres topics. - Relever le numéro d’emplacement : écouter
campmatic/<GERAETE_ID>/+/config. Victron a son propre topicvictron/config(chapitre 8). - Créer les capteurs : reprendre le bloc Victron de notre package et remplacer
<GERAETE_ID>et<SLOT_SOLAR>, plus<SLOT_SHUNT>pour un SmartShunt ou un BMV. Puis vérifier la configuration et redémarrer complètement Home Assistant (chapitre 13). - Tableau de bord : le tableau de bord prêt à l’emploi contient un groupe Solar avec puissance PV, batterie, production du jour et l’historique des dernières 48 heures (chapitre 14).
Quelles valeurs arrivent
Pour le régulateur solaire, les valeurs arrivent sous campmatic/<GERAETE_ID>/victron/solar_<SLOT_SOLAR>/…, pour le moniteur de batterie sous …/victron/shunt_<SLOT_SHUNT>/…. Les valeurs sans contenu valide ne sont pas envoyées du tout.
| Appareil | Valeurs |
|---|---|
| SmartSolar MPPT | puissance PV, tension batterie, courant de charge, production du jour en kWh, phase de charge, code d’erreur, courant de sortie charge (uniquement sur les régulateurs qui en ont une), force du signal, identifiant du modèle |
| SmartShunt, BMV-712 Smart | état de charge en %, tension, courant (négatif = décharge), Ah consommés, autonomie en minutes, alarmes ; selon l’entrée auxiliaire, batterie de démarrage, tension médiane ou température |
| Réception | dans le topic victron/status, par emplacement : ok, key (la clé ne correspond pas), off (Instant Readout désactivé) ou none (rien reçu pour l’instant) |
Notre package en fait des capteurs (noms anglais, comme dans le guide) tels que Solar Charger PV Power, Solar Charger Yield Today ou SmartShunt State of Charge, plus la phase de charge en clair, le capteur de problème Solar Charger Fault et Solar Charger Reception. Le code d’erreur est le même numéro que VictronConnect affiche sous la forme « Err N ».
La production solaire dans le tableau de bord Énergie
Solar Charger Yield Today est créé comme capteur d’énergie en kWh. Dans les réglages du tableau de bord Énergie, vous l’ajoutez comme production solaire. Une particularité : le régulateur remet la production du jour à zéro au lever du soleil suivant, pas à minuit. Home Assistant reconnaît cette remise à zéro tout seul et additionne correctement les journées.
Les valeurs sont-elles à jour ?
Le boîtier envoie de nouvelles valeurs environ toutes les cinq à six minutes, même si le régulateur émet plus souvent. Ce n’est pas un appareil de mesure à la seconde. Pour la production solaire et l’état de charge, qui évoluent sur des heures, cela suffit. Les valeurs ne sont pas conservées sur le broker : après un redémarrage de Home Assistant, les capteurs restent sur « unavailable » jusqu’à la valeur suivante.
Ce que CampMatic ne fait pas
CampMatic se contente de lire. Commuter la sortie charge, modifier les paramètres de charge ou mettre à jour le firmware du régulateur reste l’affaire de VictronConnect. La tension PV et le courant PV manquent, car Victron ne les inclut pas dans l’Instant Readout.
Une remarque sur la clé : le topic victron/config contient votre clé en plus de l’emplacement et de l’adresse MAC, et le bridge le recopie dans votre propre broker. Si vous partagez un enregistrement, par exemple sur un forum, masquez d’abord la clé.
Ce que ça coûte
CampMatic est sans abonnement. L’appli et le serveur sont gratuits, vous n’achetez le boîtier qu’une fois. Sans chauffage Truma, le CampMatic Guard suffit : Guard WiFi à 89 € ou Guard 4G à 129 €. La version 4G a besoin de votre propre carte SIM, non fournie ; une SIM IoT coûte à partir d’environ 2 € par mois. Pour piloter aussi le chauffage Truma, CampMatic pour Truma est disponible à partir de 149 €. Les appareils Victron ne sont pas fournis.
Questions fréquentes
Tous les capteurs Victron sont sur « unavailable ». Que faire ?
Regardez ce qu’indique Solar Charger Reception. Avec key, la clé ne correspond pas : copiez-la à nouveau dans VictronConnect et saisissez-la de nouveau dans l’appli CampMatic. Avec off, l’Instant Readout est désactivé. Si les deux sont en ordre, vérifiez que VictronConnect n’est plus connecté au régulateur, fermez l’appli et attendez quelques minutes (Troubleshooting, en anglais).
Et la bouteille de gaz ?
La balance Senso4s arrive dans Home Assistant par le même chemin : Senso4s dans Home Assistant.
→ Commander CampMatic Guard WiFi — 89 €
→ Commander CampMatic Guard 4G — 129 €
À lire aussi :