RBgrid en HACS como repositorio personalizado: la guía

Tiene Home Assistant, ha oído que RBgrid puede ejecutarse dentro como un dispositivo ESPHome, y ha hecho lo evidente: abrir HACS y buscarlo.

No apareció nada. Es lo correcto, y no dice nada sobre si la integración existe.

RBgrid no está en la lista predeterminada de HACS. Hasta que lo añada usted mismo, la búsqueda no encuentra nada, así que el resultado que acaba de obtener no es una prueba de que no exista: es el primer paso esperado de un camino que nadie le explicó. Este artículo es ese camino, con los puntos donde se tuerce señalados en lugar de ocultos.

¿Algo ya salió mal? Los fallos están recogidos en una tabla al final: síntoma, causa y qué hacer.

Lo que necesita antes de empezar

Placa	un ESP32 con 16 MB de flash y PSRAM — un WROVER, o un ESP32-S3 con el módulo N16R8. La misma placa que el firmware independiente.
Módulos	sus módulos y pinzas rbAmp, como de costumbre.
Home Assistant	2026.1 o posterior, con HACS.
ESPHome	solo si incorpora el componente a su propia configuración YAML: 2026.5.3 o posterior sobre el framework ESP-IDF. Para grabar la imagen lista para usar no necesita nada de esto.

⚠️ La versión de Home Assistant es un requisito, no una recomendación. El panel de RBgrid depende de las respuestas de acción, que las versiones anteriores no tienen. En una versión anterior de Home Assistant el panel simplemente no funciona, y lo que verá parece una integración rota en lugar de una instalación antigua. Si el panel está en blanco, revise esto primero.

1. Grabe el firmware en el hub

Descargue la imagen de fábrica para su placa desde las versiones de rb-amp/rbgrid-esphome: hay dos, una para el ESP32-WROVER y otra para el ESP32-S3. Después abra web.esphome.io en Chrome o Edge, elija Connect, seleccione el puerto serie de su placa, pulse Install y elija el archivo que descargó.

Home Assistant no le pide aquí una clave de cifrado de la API: la imagen lista para usar se compila sin ella, así que el dispositivo se añade con una sola confirmación. Solo se pide una clave si compiló su propia configuración con ella.

Configure el Wi-Fi justo después de grabar, con el mismo cable USB, cuando el instalador lo ofrezca. Si lo hace, el hub nunca necesita su punto de acceso de configuración. Si en cambio pasa por el punto de acceso, cambie su contraseña una vez que el hub esté incorporado.

esptool también funciona: la imagen de fábrica se escribe en el desplazamiento 0x0.

⚠️ Esto se refiere a su propia compilación en YAML, no a la imagen lista para usar. El componente incluye una tabla de particiones con la aplicación en 0x20000, mientras que las herramientas USB propias de ESPHome asumen el estándar 0x10000. Si graba por USB con las herramientas de ESPHome — esphome run a un puerto serie, o Manual download → Factory format — su compilación acaba en la dirección incorrecta y la placa no arranca nada nuevo: una placa en blanco no se levanta, y una placa con una imagen anterior sigue ejecutando en silencio la versión antigua.

Para una primera instalación por USB, use la imagen de fábrica lista para usar de la página de versiones (está combinada con los desplazamientos reales y se escribe en 0x0), o esptool con los desplazamientos del flasher_args.json de su propia compilación. Cuando el hub esté en la red, cargue sus compilaciones de forma inalámbrica — esphome run con el hub accesible, o Install → Wirelessly. Por aire solo se envía la aplicación, y el dispositivo la coloca según su propia tabla de particiones, así que el desplazamiento es correcto por construcción.

Este es el paso que falla en silencio. Ya está dentro de la herramienta de ESPHome, le ofrece una descarga en formato de fábrica, el archivo parece correcto, la grabación termina bien, y después la placa no hace nada. No hay ningún error que buscar, por eso casi siempre se interpreta como hardware muerto.

O compílelo en su propia configuración

Si ya guarda sus dispositivos ESPHome como YAML, añada el componente como fuente externa en lugar de grabar una imagen de fábrica:

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. Añada RBgrid en HACS como custom repository

Este es el paso que el resultado de búsqueda del principio de este artículo estaba sustituyendo, y son tres acciones, no una:

en HACS, añada https://github.com/rb-amp/rbgrid-ha como custom repository, categoría Integration;
instale RBgrid desde él;
reinicie Home Assistant.

El reinicio no es opcional ni una superstición: una integración recién instalada se carga al arrancar.

3. Configure primero ESPHome, y después RBgrid

Tras el reinicio, Settings → Devices & services debería mostrar dos tarjetas: ESPHome (el dispositivo en sí) y RBgrid (esta integración).

Configure primero la de ESPHome. La tarjeta de RBgrid espera a que esté, porque RBgrid se comunica con un dispositivo que Home Assistant ya conoce; si lo configura en el otro orden, no tiene a qué engancharse.

Después pulse Configure en la tarjeta de RBgrid. Por el camino, ESPHome le ofrece su propio diálogo Name and assign, con el hub y sus ranuras — pulse Skip; los nombres vienen de los propios puntos.

El último paso tiene dos casillas de verificación que conviene leer en lugar de pasar de largo:

Configure the Energy dashboard with this hub — activada por defecto cuando su panel de energía está vacío. Esto es lo que pone las entidades del hub en el panel de energía.
Set the hub's tariff plan to Home Assistant's currency — déjela activada. El hub y Home Assistant deben contar en una misma moneda, porque nada convierte entre ambos: el panel de energía simplemente etiqueta los números del hub con su propia moneda. Si alguna vez difieren, la pestaña Tariff del panel lo indica y ofrece una corrección de un solo clic.

Cuando termine, el panel RBgrid Hub aparece en su barra lateral (también en /rbgrid), la importación de estadísticas empieza en menos de un minuto, y el panel de energía muestra el hub a partir de la siguiente hora en punto, porque esas estadísticas se escriben un par de minutos después de cada hora.

⚠️ ¿No aparece ninguna tarjeta de RBgrid? mDNS no llega a Home Assistant en todas las redes — una red puente de Docker es el caso habitual. Use Add integration → RBgrid en su lugar: lista los hubs que la integración de ESPHome ya tiene. Lo mismo vale después de eliminar un hub: Home Assistant no lo volverá a descubrir por sí solo, así que reinícielo o use Add integration.

4. Lo que ve tras la incorporación, y por qué parece escaso

Un punto es una medición con nombre — un circuito que define en el panel de RBgrid, asociado a una pinza en un canal de módulo. Una ranura es el lugar que ese punto ocupa en Home Assistant. Un hub expone doce ranuras de medición — las mismas doce de las que el hub guarda historial. El nombre de cada ranura está desde el principio; el resto de las entidades de una ranura aparecen cuando se asocia un punto a ella, algo que hace en la pestaña Points del panel.

Así que lo que ve tras la incorporación son doce nombres, no doce dispositivos llenos de sensores vacíos. Es el tercer aspecto que la gente lee como un fallo: una integración que apenas añadió nada. Añadió la estructura; las entidades llegan a medida que da trabajo a las ranuras.

Dos consecuencias que conviene conocer antes de reorganizar nada:

Si libera una ranura y se la asigna a otro punto, los totales acumulados de esa ranura continúan desde donde estaban, así que las estadísticas de Home Assistant pueden mostrar un escalón en el cambio. La serie por punto que importa la integración es la vista limpia.
Una sola moneda en todo. Sea cual sea su tarifa, todas las entidades de dinero están en esa moneda.

Las entidades de energía van directamente al panel de energía: son del tipo acumulativo que este espera, así que no hace falta ningún sensor de plantilla ni utility_meter en medio.

Los cuatro fallos, en un solo lugar

Lo que ve	Qué es	Qué hacer
La búsqueda en HACS no devuelve nada	esperado — RBgrid no está en la lista predeterminada	añádalo como custom repository, instálelo y reinicie (paso 2)
No aparece ninguna tarjeta RBgrid	mDNS no llega a Home Assistant — a menudo por una red puente de Docker	Add integration → RBgrid, que lista los hubs que ESPHome ya tiene (paso 3)
La placa no hace nada tras una grabación correcta	su propia compilación se grabó por USB, donde ESPHome asume `0x10000` y esta tabla de particiones coloca la aplicación en `0x20000`	grabe la imagen de fábrica lista para usar, o `esptool` con los desplazamientos del `flasher_args.json`; cargue las compilaciones posteriores de forma inalámbrica (paso 1)
El panel está en blanco, o la integración parece rota	Home Assistant anterior a 2026.1: el panel necesita respuestas de acción	actualice Home Assistant
Tras la incorporación, casi no hay entidades	doce nombres de ranura sin puntos asociados todavía	asocie puntos en la pestaña Points del panel; las entidades siguen (paso 4)

Lo que esto no hace

No hace que el hub necesite Home Assistant. Es una de dos formas de ejecutar el mismo núcleo de medición; la otra es la aplicación propia del hub. Cambiar entre ellas más adelante implica volver a grabar y empezar el historial desde cero, así que conviene elegir con deliberación.
No enciende ni apaga nada. El hub mide y pone precio; las automatizaciones deciden.
No da a Home Assistant una resolución de 15 minutos. Los períodos son los del hub; lo que llega a las estadísticas de Home Assistant es por hora.

Dónde leer más

Ejecutarlo dentro de Home Assistant — la referencia de esta ruta, incluido lo que hace el panel.
Dos formas de ejecutar RBgrid, y cómo elegir — si todavía no está seguro de que esta es su ruta.
Inicio rápido — primer encendido, el punto de acceso y su contraseña.
Precios de mercado — los precios del día siguiente también funcionan en esta ruta.