Ejecútalo dentro de Home Assistant

Si Home Assistant ya es el lugar donde miras, RBgrid puede vivir ahí en lugar de al lado: el mismo núcleo de medida, grabado como dispositivo ESPHome, con cada circuito en tu panel de energía y sin una segunda app que mantener.

Lo que necesitas

Un ESP32 con 16 MB de flash y PSRAM —un WROVER, o un S3 en el módulo N16R8— la misma placa que el firmware independiente, más tus módulos rbAmp. En el lado del software: Home Assistant 2026.1 o posterior con HACS y, si lo compilas en tu propia configuración, ESPHome 2026.5.3 o posterior sobre el framework ESP-IDF.

Graba el hub

Descarga la imagen de fábrica para tu placa desde la página de versiones del paquete, luego abre web.esphome.io en Chrome o Edge, elige Conectar, selecciona el puerto serie de tu placa, elige Instalar y selecciona el archivo que descargaste. Hay dos imágenes: una para el ESP32-WROVER y otra para el ESP32-S3.

Configura el Wi-Fi justo después de grabar, por el mismo cable USB, cuando el instalador lo ofrezca: así el hub nunca necesita su punto de acceso de configuración. Si sí usas el punto de acceso, cambia su contraseña una vez que el hub esté adoptado.

O compílalo en tu propia configuración

Si ya guardas tus dispositivos ESPHome como YAML, añade 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   # la etiqueta de la versión que estás instalando — véase Releases del repositorio
        path: esphome/components
      components: [rbgrid]

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

⚠️ Esto trata de tu propia compilación YAML, no de la imagen lista para usar. El componente trae una tabla de particiones con la aplicación en 0x20000. La vía USB de ESPHome —Manual download → Factory format, y esphome run a un puerto serie— asume el estándar 0x10000, así que una placa grabada de esa forma no arranca nada nuevo: una placa en blanco no se levanta, y una placa con una imagen anterior sigue ejecutando la antigua en silencio.

Para una primera instalación por USB, usa la imagen de fábrica lista 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 tu propia compilación. Una vez que el hub está en la red, instala tus propias compilaciones por aire: esphome run con el hub accesible, o Install → Wirelessly. Por aire solo se envía la aplicación y el dispositivo la coloca usando su propia tabla de particiones, así que el desplazamiento es correcto por construcción.

Añádelo a Home Assistant

Aquí el orden importa. Añade primero el hub en la integración ESPHome —Home Assistant lo habrá encontrado por sí mismo— y solo después añade la integración RBgrid.

La integración RBgrid no está en la lista predeterminada de HACS, así que buscarla en HACS no encuentra nada hasta que la añadas tú. En HACS, añade https://github.com/rb-amp/rbgrid-ha como repositorio personalizado, categoría Integration. Aparece en Home Assistant como RBgrid.

  • Un hub expone doce ranuras de medida —las mismas doce para las que guarda historial. El nombre de cada ranura está desde el principio; el resto de las entidades de una ranura aparecen cuando asignas un punto a ella, así que lo que ves tras la adopción son doce nombres en lugar de doce dispositivos llenos de sensores vacíos.
  • Si liberas una ranura y se la das a un punto distinto, los totales de vida de esa ranura continúan desde donde estaban, así que las estadísticas de Home Assistant pueden mostrar un salto en el cambio. La serie por punto que importa la integración es la vista limpia de ello.
  • Una sola moneda en todo: sea cual sea la moneda de tu tarifa, todas las entidades de dinero están en ella.
  • Las entidades de energía van directamente al panel de energía: son del tipo acumulativo que espera, así que no hay nada que plantillar ni que construir un utility_meter.

Y el dinero es del propio hub, no una operación aritmética de Home Assistant: descarga el precio day-ahead de tu zona, aplica tu contrato y valora cada periodo de 15 minutos a su propio precio, igual que en un hub independiente. Qué significa eso para tus costes

Licencia

El componente ESPHome y la integración para Home Assistant son MIT. El firmware del hub independiente se publica bajo PolyForm Noncommercial y esa licencia no se aplica aquí: estos dos paquetes son MIT por derecho propio.