RBgrid dans HACS comme dépôt personnalisé

Vous avez une installation de Home Assistant, vous avez entendu dire que RBgrid peut tourner à l'intérieur en tant qu'appareil ESPHome, et vous avez fait ce qui semble évident : ouvrir HACS et chercher RBgrid.

Aucun résultat. C'est normal, et cela ne dit rien sur l'existence de l'intégration.

RBgrid ne figure pas dans la liste par défaut de HACS. Tant que vous ne l'ajoutez pas vous-même, la recherche ne trouve rien : le résultat que vous venez d'obtenir n'est donc pas une preuve d'absence, c'est l'étape attendue d'un chemin dont personne ne vous a parlé. Cet article décrit ce chemin, en nommant les endroits où il déraille plutôt qu'en les cachant.

Un problème est déjà survenu ? Les pannes sont rassemblées dans un tableau unique à la fin : symptôme, cause, et quoi faire.

Ce dont vous avez besoin avant de commencer

Carte	un ESP32 avec 16 MB de mémoire flash et PSRAM — un WROVER, ou un ESP32-S3 sur le module N16R8. C'est la même carte que pour le firmware autonome.
Modules	vos modules rbAmp et pinces, comme d'habitude.
Home Assistant	2026.1 ou plus récent, avec HACS.
ESPHome	seulement si vous intégrez le composant à votre propre configuration YAML : 2026.5.3 ou plus récent avec le framework ESP-IDF. Pour flasher l'image prête à l'emploi, rien de tout cela n'est nécessaire.

⚠️ La version de Home Assistant est déterminante, ce n'est pas une recommandation. Le panneau RBgrid s'appuie sur les réponses d'action, que les versions plus anciennes ne proposent pas. Sur une version plus ancienne de Home Assistant, le panneau ne fonctionne tout simplement pas — et ce que vous verrez ressemble à une intégration cassée plutôt qu'à une installation ancienne. Si le panneau est vide, vérifiez d'abord ce point.

1. Flasher le hub

Téléchargez l'image d'usine de votre carte depuis les versions publiées de rb-amp/rbgrid-esphome — il y en a deux, une pour l'ESP32-WROVER et une pour l'ESP32-S3. Ouvrez ensuite web.esphome.io dans Chrome ou Edge, cliquez sur Connect, choisissez le port série de votre carte, cliquez sur Install, puis sélectionnez le fichier téléchargé.

Home Assistant ne vous demande pas de clé de chiffrement de l'API ici : l'image prête à l'emploi est construite sans clé, donc l'appareil s'ajoute avec une seule confirmation. Une clé n'est demandée que si vous avez construit votre propre configuration avec une clé.

Configurez le Wi-Fi juste après le flashage, par le même câble USB, lorsque l'installateur le propose. Dans ce cas, le hub n'a jamais besoin de son point d'accès de configuration. Si vous passez par le point d'accès à la place, changez son mot de passe une fois le hub ajouté.

esptool fonctionne aussi : l'image d'usine s'écrit à l'adresse 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, alors que les outils USB d'ESPHome supposent 0x10000. Si vous flashez par USB avec les outils d'ESPHome — esphome run vers un port série, ou Manual download → Factory format — votre build tombe à la mauvaise adresse et la carte ne démarre rien de nouveau : une carte vierge ne démarre pas, et une carte avec une ancienne image 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 décalages et s'écrit à 0x0), ou esptool avec les décalages du fichier flasher_args.json de votre build. Une fois le hub sur le réseau, installez vos propres builds par voie hertzienne — esphome run lorsque le hub est joignable, ou Install → Wirelessly. En mise à jour sans fil, seule l'application est envoyée, et l'appareil la place selon sa propre table de partitions : le décalage est donc juste par construction.

C'est l'étape qui échoue en silence. Vous êtes déjà dans l'outil ESPHome, il vous propose un téléchargement au format d'usine, le fichier semble correct, le flashage réussit — et ensuite la carte ne fait rien. Il n'y a aucune erreur à chercher, c'est pourquoi on la prend souvent pour du matériel défaillant.

Ou intégrez-le à votre propre configuration

Si vous gérez déjà vos appareils ESPHome sous forme de YAML, ajoutez le composant comme source externe au lieu de flasher une image d'usine :

yaml

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]

2. Ajouter RBgrid dans HACS comme custom repository

C'est l'étape que remplaçait le résultat de recherche en haut de cet article, et elle comporte trois actions, pas une seule :

dans HACS, ajoutez https://github.com/rb-amp/rbgrid-ha comme custom repository, catégorie Integration ;
installez RBgrid depuis ce dépôt ;
redémarrez Home Assistant.

Le redémarrage n'est ni facultatif ni une superstition : une intégration nouvellement installée est chargée au démarrage.

3. Configurer d'abord ESPHome, puis RBgrid

Après le redémarrage, Settings → Devices & services doit afficher deux cartes : ESPHome (l'appareil lui-même) et RBgrid (cette intégration).

Configurez d'abord la carte ESPHome. La carte RBgrid attend celle-ci, car RBgrid communique avec un appareil que Home Assistant connaît déjà ; configuré dans l'autre ordre, il n'a rien à quoi se rattacher.

Ensuite, cliquez sur Configure sur la carte RBgrid. Au cours de la procédure, ESPHome propose sa propre boîte de dialogue Name and assign, qui liste le hub et ses emplacements — cliquez sur Skip ; les noms viennent des points eux-mêmes.

La dernière étape comporte deux cases à cocher qu'il vaut la peine de lire plutôt que de cliquer sans regarder :

Configure the Energy dashboard with this hub — activée par défaut lorsque votre tableau de bord Énergie est vide. C'est ce qui place les entités du hub sur le tableau de bord.
Set the hub's tariff plan to Home Assistant's currency — laissez-la activée. Le hub et Home Assistant doivent compter dans une seule devise, car rien ne convertit entre les deux : le tableau de bord Énergie affiche simplement les nombres du hub avec sa propre devise. Si les deux devises diffèrent un jour, l'onglet Tariff du panneau le signale et propose une correction en un clic.

Une fois la procédure terminée, le panneau RBgrid Hub apparaît dans votre barre latérale (aussi à /rbgrid), l'importation des statistiques démarre dans la minute qui suit, et le tableau de bord Énergie affiche le hub à la prochaine heure pleine, car ces statistiques sont écrites quelques minutes après chaque heure.

⚠️ Aucune carte RBgrid du tout ? mDNS n'atteint pas Home Assistant sur tous les réseaux — un réseau bridge Docker est le cas habituel. Utilisez Add integration → RBgrid à la place : il liste les hubs que l'intégration ESPHome connaît déjà. Il en va de même après la suppression d'un hub : Home Assistant ne le redécouvrira pas tout seul, donc redémarrez-le ou utilisez Add integration.

4. Ce que vous voyez après l'ajout, et pourquoi c'est peu chargé

Un point est une mesure nommée — un circuit que vous définissez dans le panneau RBgrid, relié à une pince sur une voie de module. Un emplacement est la place qu'occupe ce point dans Home Assistant. Un hub expose douze emplacements de mesure — les mêmes douze pour lesquels le hub conserve l'historique. Le nom de chaque emplacement est présent dès le départ ; le reste des entités d'un emplacement apparaît dès qu'un point lui est associé, ce que vous faites dans l'onglet Points du panneau.

Donc, après l'ajout, vous voyez douze noms, et non douze appareils remplis de capteurs vides. C'est le troisième point que l'on prend pour une panne : une intégration qui n'a presque rien ajouté. Elle a ajouté la structure ; les entités arrivent au fur et à mesure que vous donnez du travail aux emplacements.

Deux conséquences à connaître avant de réorganiser quoi que ce soit :

Si vous libérez un emplacement pour le donner à un autre point, les totaux cumulés de cet emplacement reprennent là où ils en étaient — la statistique de Home Assistant peut donc montrer un saut au moment du changement. La série par point que l'intégration importe en est la vue propre.
Une seule devise partout. Quel que soit votre tarif, toutes les entités monétaires sont dans cette devise.

Les entités d'énergie vont directement sur le tableau de bord Énergie : ce sont des compteurs cumulatifs, du type qu'il attend, donc aucun capteur template ni utility_meter n'est nécessaire entre les deux.

Les quatre pannes, en un seul endroit

Ce que vous voyez	Ce que c'est	Que faire
La recherche HACS ne renvoie rien	normal — RBgrid ne figure pas dans la liste par défaut	ajoutez-le comme custom repository, installez-le, redémarrez (étape 2)
Aucune carte RBgrid n'apparaît	mDNS n'atteint pas Home Assistant — souvent un réseau bridge Docker	Add integration → RBgrid, qui liste les hubs qu'ESPHome connaît déjà (étape 3)
La carte ne fait rien après un flashage réussi	votre propre build est passé par USB, où ESPHome suppose `0x10000` alors que cette table de partitions place l'application à `0x20000`	flashez l'image d'usine prête à l'emploi, ou `esptool` avec les décalages du fichier `flasher_args.json` ; installez les builds suivants par voie hertzienne (étape 1)
Le panneau est vide, ou l'intégration semble cassée	Home Assistant plus ancien que 2026.1 : le panneau a besoin des réponses d'action	mettez Home Assistant à jour
Après l'ajout, presque aucune entité	douze noms d'emplacements sans point encore associé	associez des points dans l'onglet Points du panneau ; les entités suivent (étape 4)

Ce que cela ne fait pas

Cela ne rend pas le hub dépendant de Home Assistant. C'est l'une des deux façons de faire tourner le même cœur de mesure ; l'autre est l'application du hub lui-même. Passer de l'une à l'autre plus tard implique de reflasher et de repartir de zéro pour l'historique, il vaut donc la peine de choisir en connaissance de cause.
Cela n'allume ni n'éteint rien. Le hub mesure et tarifie ; ce sont les automatisations qui décident.
Cela ne donne pas à Home Assistant une résolution de 15 minutes. Les périodes sont celles du hub ; ce qui parvient aux statistiques de Home Assistant est horaire.

Pour en savoir plus

Utiliser RBgrid dans Home Assistant — la référence de cette voie, y compris ce que fait le panneau.
Deux façons d'utiliser RBgrid, et comment choisir — si vous ne savez pas encore si cette voie est la vôtre.
Démarrage rapide — première mise sous tension, le point d'accès et son mot de passe.
Prix du marché — les prix du jour suivant fonctionnent aussi sur cette voie.