Le faire tourner dans Home Assistant
Si Home Assistant est déjà l'endroit où vous regardez, RBgrid peut y vivre au lieu de se trouver à côté : le même cœur de mesure, flashé comme appareil ESPHome, avec chaque circuit dans votre tableau de bord Énergie et aucune seconde application à entretenir.
De quoi vous avez besoin
Un ESP32 avec 16 Mo de flash et PSRAM — un WROVER, ou un S3 sur le module N16R8 — la même carte que pour le firmware autonome, plus vos modules rbAmp. Côté logiciel : Home Assistant 2026.1 ou ultérieur avec HACS et, si vous l'intégrez à votre propre configuration, ESPHome 2026.5.3 ou ultérieur sur le framework ESP-IDF.
Flasher le hub
Téléchargez l'image d'usine de votre carte depuis la page des versions du paquet, puis ouvrez web.esphome.io dans Chrome ou Edge, choisissez Connect, sélectionnez le port série de votre carte, choisissez Install et sélectionnez le fichier téléchargé. Il existe deux images : une pour l'ESP32-WROVER, une pour l'ESP32-S3.
Réglez le Wi-Fi juste après le flashage, par le même câble USB, lorsque l'installateur le propose — ainsi le hub n'a jamais besoin de son point d'accès de configuration. Si vous utilisez ce point d'accès, changez son mot de passe une fois le hub adopté.
Ou intégrez-le dans votre propre configuration
Si vous gardez déjà vos appareils ESPHome en YAML, ajoutez le composant comme source externe au lieu de flasher une image d'usine :
external_components:
- source:
type: git
url: https://github.com/rb-amp/rbgrid-esphome
ref: v1.2.0 # the tag of the release you are installing — see the repository's Releases
path: esphome/components
components: [rbgrid]esptool fonctionne aussi : l'image d'usine s'écrit à l'offset 0x0.
⚠️ Ceci concerne votre propre build YAML, pas l'image prête à l'emploi. Le composant apporte une table de partitions avec l'application à 0x20000. Le chemin USB d'ESPHome — Manual download → Factory format, et esphome run vers un port série — suppose le standard 0x10000, de sorte qu'une carte flashée ainsi ne démarre rien de neuf : une carte vierge ne démarre pas, et une carte avec une image plus ancienne continue silencieusement à faire tourner l'ancienne.
Pour une première installation par USB, utilisez l'image d'usine prête à l'emploi de la page des versions — elle est fusionnée avec les vrais offsets et s'écrit à 0x0 — ou esptool avec les offsets du fichier flasher_args.json de votre build. Une fois le hub sur le réseau, installez vos propres builds à distance : esphome run avec le hub joignable, ou Install → Wirelessly. À distance, seule l'application est envoyée et l'appareil la place grâce à sa propre table de partitions, de sorte que l'offset est juste par construction.
L'ajouter à Home Assistant
L'ordre compte ici. Ajoutez d'abord le hub dans l'intégration ESPHome — Home Assistant l'aura découvert de lui-même — puis seulement ensuite ajoutez l'intégration RBgrid.
L'intégration RBgrid ne figure pas dans la liste par défaut de HACS : la recherche dans HACS ne trouve donc rien tant que vous ne l'avez pas ajoutée vous-même. Dans HACS, ajoutez https://github.com/rb-amp/rbgrid-ha comme dépôt personnalisé, catégorie Intégration. Elle apparaît dans Home Assistant sous le nom RBgrid.
- Un hub expose douze emplacements de mesure — les mêmes douze pour lesquels il conserve l'historique. Le nom de chaque emplacement est présent dès le départ ; le reste des entités d'un emplacement n'apparaît que lorsque vous y associez un point, de sorte que ce que vous voyez après l'adoption, ce sont douze noms plutôt que l'équivalent de douze appareils de capteurs vides.
- Si vous libérez un emplacement et l'attribuez à un autre point, les totaux cumulés de cet emplacement reprennent là où ils en étaient, de sorte que les statistiques de Home Assistant peuvent présenter un palier au moment du changement. La série par point que l'intégration importe en est la vue propre.
- Une seule devise partout : quelle que soit la devise de votre tarif, chaque entité monétaire y est exprimée.
- Les entités d'énergie vont directement dans le tableau de bord Énergie — ce sont du type cumulatif attendu, donc rien à templater et aucun
utility_meterà construire.
Et l'argent est le calcul propre du hub, non celui de Home Assistant : il récupère le prix day-ahead de votre zone, applique votre contrat et valorise chaque période de 15 minutes à son prix propre — comme sur un hub autonome. Ce que cela signifie pour vos coûts
Licence
Le composant ESPHome et l'intégration Home Assistant sont sous MIT. Le firmware autonome du hub est publié sous PolyForm Noncommercial, et cette licence ne s'applique pas ici : ces deux paquets sont sous MIT à part entière.