Todo para empezar con buen pie.

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 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.

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.

Alimentan dos cosas distintas. El sensor de energía (kWh, acumulativo) alimenta el historial, las curvas y los totales, exactamente los mismos datos que lee el propio panel de Energía. El sensor de potencia (W, en vivo) alimenta solo los indicadores en tiempo real; sin él, un indicador no tiene nada que mostrar y se queda en un guion, aunque las curvas sigan funcionando. La batería tiene su propio campo de potencia opcional, aparte, en el panel de Energía, fácil de pasar por alto porque es opcional y relativamente reciente en Home Assistant. Si su indicador de batería muestra un porcentaje en vez de una potencia en vivo, es justo eso: hay un sensor de carga configurado pero no un sensor de potencia, así que el indicador recurre al porcentaje. En un contador multi-tarifa (punta/valle), el sensor de potencia es un único campo para toda la conexión, completamente aparte de la lista de contadores por tarifa: no hay nada que duplicar, un solo sensor cubre todas las tarifas.

Es un problema de signo, y se ajusta por completo en el propio panel de Energía de Home Assistant, no en Helios. Abra Ajustes, Paneles, Energía, y en el campo del sensor de potencia de esa fuente, cambie entre Estándar e Invertido hasta obtener el sentido correcto; o, si su sensor solo mide una dirección (solo importación, por ejemplo), cambie a Dos sensores y déle los dos. La opción battery-sign del editor de Helios solo afecta a lo que se muestra: cambia qué símbolo (+ o −) se dibuja junto a la cifra, nunca el cálculo subyacente, así que no puede corregir un sensor realmente invertido.

Las dos son correctas, solo responden a preguntas distintas. Un pequeño panel resumen describe todo el periodo seleccionado (su cifra es una media sobre ese periodo), mientras que la línea de tiempo y los indicadores en vivo muestran el valor en un instante exacto, ya sea ahora o donde esté señalando en la línea de tiempo. Así que "cómo se comportó la batería durante todo el periodo" y "dónde está la batería ahora mismo" son cifras genuinamente distintas, y no tienen por qué coincidir salvo por casualidad.

Es normal, estas tarjetas no funcionan igual. Helios lee exclusivamente el panel de Energía de Home Assistant y muestra sus valores tal cual, sin recalcularlos; su configuración de Energía es la que manda, no Helios. Tarjetas como Power Flow Card Plus funcionan de otra forma: se configuran de manera independiente al panel de Energía, a partir de sensores de potencia, y pueden convertir potencia y energía entre sí según lo que usted les proporcione; esa conversión sigue siendo una estimación, sensible a la frecuencia de actualización de los sensores, no una lectura directa. Una pequeña diferencia entre ambas tarjetas normalmente no es un error: es la diferencia entre una lectura directa del panel y una reconstrucción en tiempo real.

Es el nombre del periodo seleccionado: hoy más los dos días siguientes (esa pestaña se llamaba "Previsión" hasta la 2026.9.4). No dice nada del tipo de cifra que se muestra debajo: las dos filas bajo ese título siempre muestran la producción realmente medida, en cualquier periodo, para mantener la coherencia en toda la tarjeta, nunca un total previsto. La curva y su información al pasar el cursor son el único sitio donde aparece la propia previsión.

La línea continua ámbar es su irradiancia solar medida, en W/m² con una escala fija. La línea discontinua es su previsión de producción, pero dibujada solo como una forma, normalizada a su propio máximo: su altura indica la forma del día, no un valor absoluto; pase el cursor por encima para leer la cifra real.

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.

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.

Sí, ya es posible: defina otra ubicación para esa tarjeta en concreto en la sección "Ubicación del hogar" del editor visual (o home-latitude/home-longitude en YAML, indicados como pareja). Útil para vigilar una instalación en una segunda vivienda.

Cada tarjeta recuerda su propio ángulo de cámara (bearing/inclinación) en el navegador, indexado por sus coordenadas redondeadas a unos 111 metros cuando no se define un identificador explícito. Dos tarjetas lo bastante cercanas caen en la misma clave y acaban compartiendo el ángulo. Dele a una de ellas un cache-id distinto en su configuración para separarlas. Ese ángulo vive en el almacenamiento local de su navegador, así que también es propio de cada dispositivo: la misma tarjeta no recordará su ángulo entre su móvil y su ordenador salvo que lo configure por separado en cada uno. El bloqueo de vista, en cambio, es un ajuste de configuración compartido por todos los dispositivos, no un estado por navegador.

Es intencionado, y ni siquiera es un caso especial en el código: la curva sigue simplemente el acimut real del sol para su latitud, que resulta correr en sentido contrario por debajo del ecuador (el mediodía solar acaba al norte de la casa, porque ahí es realmente donde está el sol). Al principio parece al revés si está acostumbrado a un reloj pensado para el hemisferio norte, pero es la geometría la que es correcta, en cualquier punto de la Tierra.

Para el ángulo: arrastre la vista previa en el editor visual hasta el ángulo que quiera, y active "Bloquear rotación" en la sección "Interfaz y mapa". El ángulo queda entonces guardado en la configuración de la tarjeta, así que es el mismo en todos sus dispositivos. Para volver al directo tras mover la línea de tiempo: basta con acercarse a la línea de "ahora", un ligero magnetismo le devuelve automáticamente (con una pequeña indicación "Live" que lo confirma), o use el botón "Live" dedicado que aparece en la línea de tiempo en cuanto se aleja del instante presente, para volver de un solo toque.

Aparecen cuando Helios Forecast proporciona la predicción: una placa por cada línea de paneles configurada allí, en su propia posición (o sobre su tejado, en el lado al que mira, si la línea no tiene coordenadas), orientada según su acimut y elevada según su inclinación. Cada una se ilumina cuando el sol la encara, y su línea de puntos apunta al sol mientras está alto. Sin la integración nada cambia: el rayo único del sol hacia su producción se mantiene.

El pronóstico viene de la integración independiente Helios Forecast, que lo calcula por completo en su propia instancia. También guarda un archivo horario del pasado (recalculado con el tiempo histórico real y ajustado a su producción efectiva), lo que alimenta una curva genuina de "qué se predijo" que se puede comparar directamente con lo que realmente ocurrió, no solo una previsión orientada al futuro. Pásese por la página de Helios Forecast para entender cómo funciona en detalle.

En Helios Forecast, la integración independiente, no en la propia tarjeta Helios. Los dos proyectos comparten nombre de familia pero son independientes: cada uno se puede instalar sin el otro.

No, y nunca lo hará: Helios es una tarjeta Lovelace, código que solo se ejecuta en una pestaña del navegador que esté realmente abierta. A las 3 de la madrugada, cuando nadie está mirando un panel, nada de la tarjeta se está ejecutando, así que no tiene forma de actuar según un horario ni de crear entidades de Home Assistant; eso es tarea de una integración del lado del servidor. Helios Forecast, en cambio, se ejecuta de forma continua en el servidor dentro de Home Assistant y puede exponer la predicción que necesite una automatización. La separación es deliberada: la tarjeta muestra, Forecast predice, y usted mantiene el control de lo que realmente actúa.

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.

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.