Todo para empezar con buen pie.
Helios lo lee todo de su panel de Energía de Home Assistant.
Basta con configurar el panel de Energía, y la tarjeta funciona, sin más.
Instalación
Configure primero su panel de Energía.
- 1
Abra los ajustes del panel de Energía
En Home Assistant, entre en Ajustes, Paneles, Energía. Es el único sitio del que Helios saca sus datos: todo lo que ajuste aquí llega directamente a la tarjeta.
- 2
Añada sus fuentes
Añada su red eléctrica (la importación y, si vende excedente, también la exportación), su producción solar y su batería. Cada una apunta al sensor de energía en kWh que su integración ya ofrece.
- 3
Añada los sensores de potencia opcionales
Para tener valores al segundo, dele también a cada fuente su sensor de potencia (W) opcional, no solo el de kWh. Sin él, los indicadores no tienen valor en tiempo real; el historial sigue disponible gracias a los sensores de kWh.
- 4
Ponga una tarjeta Helios en un panel
Ya está. Añada la tarjeta (type: custom:helios-card) y lo recoge todo automáticamente. Sin cablear entidades tarjeta por tarjeta.
La guía completa: la documentación de Energía de Home Assistant.
Preguntas frecuentes
Las preguntas que más se repiten.
La tarjeta está vacía o no muestra ningún dato.
Helios lo lee todo de su panel de Energía de Home Assistant. Compruebe que está bien configurado (Ajustes, Paneles, Energía), con al menos una fuente solar, de red o de batería. Si el panel de Energía está vacío, la tarjeta no tiene nada que mostrar.
Los valores en vivo salen con guiones o se quedan planos.
Los sensores de energía (kWh) alimentan el historial y las gráficas, pero los valores instantáneos necesitan un sensor de potencia (W) en cada fuente. Añada el sensor de potencia opcional a esa fuente en su panel de Energía de Home Assistant. Sin él, los indicadores no tienen valor en tiempo real (se quedan en un guion); el historial y las curvas, en cambio, siguen funcionando gracias a los sensores de kWh.
Mi casa se dibuja mal, o solo se ve la mitad.
La escena 2.5D se apoya en el contorno de su edificio en OpenStreetMap. Compruebe que existe en openstreetmap.org con un contorno correcto; si no aparece, añádalo allí y dele tiempo a que se propague. En dispositivos muy antiguos, los límites de renderizado del navegador también pueden recortar la escena.
No aparece nada, o la escena está en el sitio equivocado.
Helios se centra en la ubicación del hogar definida en Home Assistant (Ajustes, Sistema, General). Puede definir otra ubicación en cada tarjeta, desde el editor visual, si quiere que una tarjeta apunte a otro lugar.
¿De dónde sale el tiempo? ¿Se envían mis datos a algún sitio?
La irradiancia y la nubosidad vienen de Open-Meteo, sin clave de API, y el mapa y los edificios de OpenStreetMap, servidos como teselas vectoriales por OpenFreeMap. Todo lo demás son sus propios datos de Home Assistant. No hay servidor de Helios, ni cuenta, ni telemetría: sus cifras de energía nunca salen de su instancia, y esos servicios solo reciben una ubicación aproximada, jamás sus coordenadas exactas.
¿Puedo conectar Helios a mis entidades a mano, en vez de al panel de Energía?
No, es una decisión deliberada, y un compromiso que asumo por completo. Helios lee el 100% de su panel de Energía de Home Assistant, y siempre será así. Es lo que mantiene la tarjeta de verdad sencilla de instalar, incluso cuando empieza, y lo que le permite adaptarse a cualquier instalación sin sepultarle en opciones. Y esa fuente de datos única garantiza cifras coherentes, lo mismo en el panel de Energía que en Helios. Tengo previsto añadir y cambiar muchas cosas todavía, pero conectar las entidades tarjeta por tarjeta nunca será una de ellas.
Mi batería o mi red muestran el sentido contrario.
Algunos sensores dan el signo al revés. Para la batería, dele la vuelta en el editor visual de Helios con la opción de signo de la batería (por defecto, invertido u oculto). Para la red, el sentido viene de su panel de Energía de Home Assistant: ponga ahí el sensor de potencia de esa fuente en Estándar o Invertido.
¿Cómo funciona el pronóstico solar?
El pronóstico viene de la integración independiente Helios Forecast, que lo calcula por entero en su propia instancia y lo inyecta en el panel de Energía. Pásese por la página de Helios Forecast para entender cómo funciona.
He encontrado un fallo, o tengo una idea.
Abra una incidencia en el repositorio de GitHub. Los formularios le guían hacia los pocos detalles (su configuración de la tarjeta, una captura, la consola del navegador) que permiten arreglarlo rápido.
¿Sigue atascado? Abra una incidencia en el repositorio de Helios o, para los pronósticos, en Helios Forecast.