Sensor principal¶
El primer paso configura las fuentes de datos globales de la integración.
Sensor de consumo de red¶
Sensor de Home Assistant que mide el intercambio de potencia con la red (en W o kW).
Sensores compatibles
Cualquier sensor que exponga la potencia de red funciona: Shelly EM, Shelly EM3, Neurio, integraciones de contador inteligente (e.g. sensor.grid_power).
Frecuencia de actualización
El sensor debe actualizarse lo más rápido posible. El controlador es dirigido por eventos —recalcula cada vez que este sensor publica un valor nuevo—, así que la frecuencia de actualización del sensor es la frecuencia de control: un sensor más rápido implica una respuesta más rápida y precisa. (Un watchdog de 2 segundos sigue ejecutando el ciclo si el sensor se queda en silencio.)
El consumo del hogar puede variar varios kilovatios en fracciones de segundo (arranque de electrodomésticos, horno, lavadora…). Los sensores lentos son compatibles, pero su retraso puede hacer que el controlador reaccione a una situación que ya ha cambiado, reduciendo la calidad de la regulación.
Recomendado: actualización cada 1–2 segundos. Los dispositivos Shelly no ofrecen esta cadencia MQTT de forma nativa. Es necesario ejecutar un script dentro del dispositivo; consulta la referencia de scripts MQTT para Shelly Pro 3EM para ver ejemplos.
Omnibattery sigue siempre el último valor publicado hasta que supera los 65 segundos de antigüedad, independientemente del polling rate del sensor. Los sensores que actualizan repetidamente cada 10 segundos o más generan un único aviso de Repairs de Home Assistant por ejecución de la integración; no se emiten avisos recurrentes en el log. Si el sensor es rápido después del siguiente reinicio, el Repair persistente se elimina tras tres actualizaciones.
Detección automática de kW¶
Si el atributo unit_of_measurement del sensor es kW, la integración multiplica el valor por 1000 automáticamente.
Signo invertido¶
Activa "Signo del medidor invertido" si tu sensor usa la convención opuesta:
| Convención | Importación | Exportación |
|---|---|---|
| Estándar (por defecto) | Valor positivo | Valor negativo |
| Invertida | Valor negativo | Valor positivo |
Déjalo desactivado si no estás seguro.
Potencia máxima contratada¶
La potencia contratada de tu conexión de red, en W (por defecto 7000).
La integración limita la carga de las baterías para que la importación de red proyectada nunca supere este límite, evitando que salte el diferencial. Aplica en todos los modos — control normal de setpoint, un objetivo/offset positivo, balance neto horario y carga predictiva desde red — no solo al cargar desde la red de forma programada. Solo limita la carga; nunca fuerza una descarga.
Sensor de previsión solar (opcional)¶
Sensor que proporciona la producción solar estimada para hoy, en kWh o Wh.
Configurarlo aquí lo pone a disposición de:
- Carga predictiva (modos Franja Horaria y Precio Dinámico)
- Retraso de carga solar
También puedes dejarlo en blanco y configurarlo más tarde en esas secciones específicas.
Sensor de producción solar (optional)¶
Sensor de potencia de producción fotovoltaica (W o kW) en tiempo real de un inversor externo que no está conectado mediante las entradas MPPT de la batería. Se utiliza para mostrar el nodo Solar en el diagrama de flujo energético del panel. Déjalo vacío si tus paneles solares alimentan directamente el MPPT de la batería.
Consumo del hogar (derivado automáticamente)¶
No hay campo de sensor de consumo del hogar en la configuración — la integración deriva el consumo total del hogar de sensores que ya tiene:
Consumo del hogar = Potencia de red + Potencia AC de baterías + Producción solar
Es el valor que muestra el diagrama de flujo de energía y el sensor sensor.marstek_venus_system_home_consumption, y alimenta el historial de 7 días que usan la carga predictiva y el retraso de carga. La acumulación corre solo durante la franja solar+batería (fuera de la franja de carga; todo el día si no hay franja); el contador se reinicia a medianoche y sobrevive reinicios de HA.