Remerciements : Ce tutoriel s’appuie sur les documentations README et les données du projet publiées librement sur GitHub par l’auteur du projet BatMON (batmon-ha). Nous remercions expressément le développeur d’origine pour la mise à disposition de ces contenus techniques et de ces données.

Source du projet (GitHub) : https://github.com/fl4p/batmon-ha

Dans cet article, nous expliquons pas à pas comment BatMON s’installe, se configure et s’exécute dans Home Assistant afin de lire les données de batterie directement depuis le système de gestion de batterie (BMS) via Bluetooth Low Energy (BLE) et de les afficher de manière fiable dans Home Assistant.

Les procédures décrites conviennent particulièrement aux batteries LiFePO₄ avec BMS Bluetooth, comme p.  ex. les batteries Bluetooth Lithink, et sont conçues pour une utilisation en camping-cars, systèmes hors réseau et systèmes de stockage d’énergie fixes.

Remarque importante : BatMON utilise Bluetooth Low Energy pour la transmission des données. Selon les conditions environnementales (distance, blindage métallique, interférences radio ou matériel Bluetooth de l’hôte), de brèves interruptions de connexion peuvent se produire. En règle générale, cela n’indique pas un défaut de la batterie ou du BMS.

1) Qu’est-ce que BatMON et quelle fonction remplit-il dans Home Assistant ?

BatMON est un add-on spécialement développé pour Home Assistant destiné à la surveillance des systèmes de batteries. Grâce à Bluetooth Low Energy (BLE), une connexion directe est établie avec le système de gestion de batterie (BMS), permettant de lire en continu les données d’exploitation.

Les données lues sont transmises à Home Assistant via MQTT et y sont mises à disposition sous forme d’entités de capteurs. Sur cette base, il est possible de créer des visualisations, des journaux et des automatisations.

Pour les batteries Lithink LiFePO₄ avec BMS Bluetooth, BatMON permet une architecture système particulièrement légère, car aucun gateway supplémentaire ni interface série n’est nécessaire.

  • Connexion BLE directe au BMS de la batterie
  • Collecte de la tension, du courant et de l’état de charge (SoC) de la batterie
  • Lecture des tensions des cellules et des températures (selon le BMS)
  • Prise en charge de plusieurs batteries en parallèle
  • Découverte automatique MQTT pour Home Assistant
  • Intégration dans les tableaux de bord et les vues d’énergie

Dans la pratique, BatMON a particulièrement fait ses preuves dans des systèmes fonctionnant en continu, par exemple dans des camping-cars ou des systèmes énergétiques автономes. Avec les batteries Bluetooth Lithink, les données fournies par le BMS sont reprises directement et représentées comme des entités Home Assistant distinctes.

2) Prérequis

  1. Home Assistant installé avec prise en charge du Supervisor.
  2. Prise en charge Bluetooth sur le système hôte (interne ou via adaptateur USB).
  3. Broker MQTT installé, p.  ex. Mosquitto.
  4. Batterie compatible Bluetooth, allumée et à portée, p.  ex. une batterie Lithink Bluetooth LiFePO₄.

Sur les batteries Bluetooth Lithink, la fonction Bluetooth est activée en usine. Aucune activation supplémentaire ni modification du micrologiciel n’est nécessaire. Pendant la configuration, la batterie ne doit pas rester connectée en permanence à une application smartphone en parallèle.

3) Étape 1 : ajouter le dépôt BatMON

  1. Ouvrir Home Assistant.
  2. Accéder à Supervisor → Add-on Store.
  3. Ajouter un nouveau dépôt via le menu ⋮ → Repositories.
  4. Saisir l’URL suivante :
https://github.com/fl4p/home-assistant-addons

4) Étape 2 : installer l’add-on BatMON

  1. Dans l’Add-on Store, sélectionner BatMON.
  2. Cliquer sur Install.
  3. Attendre la fin complète de l’installation.

5) Étape 3 : installer et configurer le broker MQTT

  1. Installer l’add-on Mosquitto MQTT.
  2. Démarrer le service MQTT.
  3. Activer l’intégration MQTT dans Home Assistant.
  4. Configurer correctement le nom d’utilisateur et le mot de passe.

6) Étape 4 : configurer BatMON (connexion de la batterie Bluetooth)

devices:
  - address: CC:44:8C:F7:AD:BB
    type: jk
    alias: lithink_battery
    pin: "12345"
    adapter: "hci0"
    debug: true
    current_calibration: 1.0

Dans les systèmes à plusieurs batteries, plusieurs appareils peuvent être définis avec un alias propre à chacun. Chaque batterie Bluetooth Lithink est ensuite gérée comme une entité distincte dans Home Assistant.

7) Étape 5 : démarrer BatMON

  1. Démarrer l’add-on.
  2. Vérifier les journaux.
  3. S’assurer qu’une connexion stable à la batterie est établie et que les données MQTT sont bien envoyées.

8) Étape 6 : afficher les données de batterie dans Home Assistant

Après un démarrage réussi, les données des capteurs sont automatiquement intégrées dans Home Assistant via MQTT Discovery. Les valeurs affichées correspondent aux données fournies par le BMS de la batterie et concordent avec les informations de l’application de la batterie.

9) Dépannage

La batterie n’apparaît pas ou ne se connecte pas

  • Vérifier l’adresse MAC.
  • Configurer correctement le type de BMS.
  • Réduire la distance entre la batterie et l’hôte.
  • Consulter les journaux de BatMON.
  • Vérifier le broker MQTT.

La connexion existe, mais aucune entité n’est visible dans Home Assistant

  • Intégration MQTT activée ?
  • Identifiants MQTT corrects ?
  • Messages MQTT Publish présents dans le journal ?
  • Recharger l’intégration MQTT ou redémarrer Home Assistant.

Connexion Bluetooth instable

  • Éviter les connexions parallèles avec des applications smartphone.
  • Réduire les interférences radio.
  • Utiliser des adaptateurs Bluetooth USB externes.
  • Dans les systèmes fixes (p.  ex. camping-car ou hors réseau), il est recommandé d’utiliser une seule connexion Bluetooth permanente via Home Assistant, en particulier avec les batteries Bluetooth Lithink.

10) Remerciements et source du projet

Ce tutoriel s’appuie entièrement sur les documentations README et les données de projet librement accessibles du projet BatMON. Nous remercions le développeur d’origine pour la mise à disposition de ces informations techniques.

Source du projet : https://github.com/fl4p/batmon-ha

0 commentaire

Laissez un commentaire

Ce site est protégé par hCaptcha, et la Politique de confidentialité et les Conditions de service de hCaptcha s’appliquent.

Dernières Actualités

Cette section ne contient actuellement aucun contenu. Ajoutez-en en utilisant la barre latérale.