Solución de problemas por síntoma¶
Empieza por lo que puedes ver en Home Assistant. Integration Status y sus atributos de bloqueadores suelen explicar por qué Omnibattery espera, limita potencia o excluye una batería.
Compatibilidad con la aplicación Marstek
No necesitas cambiar nada en la aplicación Marstek para que Omnibattery funcione, incluido el ajuste de su medidor de energía. Cuando Omnibattery esté funcionando, no cambies el modo de funcionamiento ni ningún ajuste desde la aplicación Marstek: hacerlo rompe la compatibilidad hasta que desactives y vuelvas a activar la integración.
La batería no hace nada¶
La batería puede estar en reposo intencionadamente cuando la red ya está cerca del objetivo. Si cambia la carga de casa y la batería sigue sin cargar ni descargar, usa esta tabla.
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| El control automático está pausado | Manual Mode y Manual Battery Control por batería | Desactiva el control manual cuando quieras control automático |
| La batería no es apta | Allow Charge, Allow Discharge y battery_charge_blockers / battery_discharge_blockers en Integration Status |
Activa el sentido requerido o elimina el bloqueador indicado |
| La batería no está disponible o está excluida | Entidades de batería, Non-Responsive Batteries y Repairs de Home Assistant | Sigue Las entidades no están disponibles |
| Hay una salida de respaldo activa | Backup Function, potencia de respaldo y backup_cooldown_batteries |
Deja que termine la actividad de respaldo antes de esperar control de red |
| El medidor de red no es válido | Estado y hora de actualización del sensor de red principal | Sigue El medidor de red no está disponible o está bloqueado |
Resultado esperado: Integration Status cambia de un estado bloqueado/manual a carga, descarga o reposo cuando cambia el flujo de red. Consulta varias baterías para el control por batería.
La batería no carga¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| Se alcanzó el SOC máximo o la histéresis de carga | battery_charge_blockers, SOC de corte/objetivo de carga y Charge Hysteresis |
Reduce el objetivo solo si es intencionado; de lo contrario espera a que baje el SOC |
| La carga está desactivada para esta batería | Allow Charge | Actívalo |
| Charge Delay espera al sol | Charge Delay y Charge Delay Status | Revisa el retraso de carga solar |
| Una franja horaria bloquea la carga | Discharge Window, interruptores de franja horaria y charge_blockers |
Revisa las franjas horarias |
| La carga predictiva no encontró déficit | Predictive Charging Active, su motivo, previsión y estimación de consumo | Es lo esperado; revisa la carga predictiva |
| La temperatura o la protección de batería limitan la carga | Integration Status, estado de temperatura, alarma de batería y entidades de fallo | Revisa el límite de carga por temperatura y el manual de la batería |
Resultado esperado: el bloqueador desaparece y la potencia de carga sube cuando el excedente solar, una solicitud manual o un periodo predictivo apto requieren carga.
La batería no descarga¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| Se alcanzó el SOC mínimo | battery_discharge_blockers y el SOC mínimo de batería |
Espera a cargar o ajusta el límite deliberadamente |
| La descarga está desactivada | Allow Discharge | Actívalo |
| La franja horaria actual bloquea la descarga | Discharge Window e interruptores de franja horaria | Revisa las franjas horarias |
| El control de precio o reserva retiene energía | Integration Status, Price-Based Discharge, Discharge Reserve y estados relacionados | Revisa Precio dinámico |
| La protección de capacidad o lógica de carga excluida posee la respuesta | Capacity Protection, dispositivos excluidos activos y bloqueadores | Revisa protección de capacidad y exclusión de carga |
| La batería no está disponible o está excluida | Non-Responsive Batteries y Repairs de Home Assistant | Sigue Las entidades no están disponibles |
Resultado esperado: la descarga se reanuda cuando existe demanda doméstica y ninguna regla de seguridad, horario, precio o participación la bloquea.
Importa o exporta más de lo esperado¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| El signo del medidor de red está invertido | Compara el sensor de red configurado con el contador de la compañía mientras importas | Corrige Invert grid meter en la configuración del sensor principal |
| El objetivo de red no es cero intencionadamente | PD Target Grid Power | Establece el objetivo que corresponda con tu importación o exportación prevista |
| Las actualizaciones del medidor llegan tarde | last_updated del sensor de red y PD Control Quality |
Usa un medidor local más rápido o ajusta el controlador tras corregir la latencia |
| Se excluye una carga grande | Estado del dispositivo excluido y sus controles de exclusión | Revisa la exclusión de carga |
| La protección de fase limita una o varias baterías | Three-Phase Protection Status y asignación de fase | Revisa la protección trifásica |
| La potencia CA y de celdas describen puntos distintos | AC Power, Battery Cell Power y entradas solares | Usa Home Consumption y la entidad de potencia correcta para la tarea |
Resultado esperado: el flujo de red se estabiliza alrededor del objetivo configurado después de que reaccionen el medidor y la batería. Los errores pequeños y breves pueden ser normales.
Las entidades no están disponibles¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| El host, puerto, ID esclavo o modelo de batería es incorrecto | Entrada de integración y configuración específica de batería | Corrige la conexión en la guía de batería pertinente |
| El control RS-485 de Marstek está desactivado | RS485 Control Mode | Actívalo antes de enviar órdenes de control |
| La pasarela o puente está desconectado | Estado del dispositivo de pasarela, ESPHome, MQTT o API | Restaura la conexión local y recarga la integración si es necesario |
| El controlador rechazó lecturas o escrituras repetidas | Repairs de Home Assistant, registros y Non-Responsive Batteries | Sigue las instrucciones de Repair; adjunta diagnósticos si se repite |
| Una entidad antigua pertenece a un controlador previo | Dispositivo e integración del registro de entidades | Elimina la entidad obsoleta no disponible si el controlador actual ha creado su sustituta |
Resultado esperado: el coordinador se actualiza y las entidades admitidas vuelven a estados numéricos o con nombre. Para detalles del protocolo Marstek, consulta el resumen Modbus.
El medidor de red no está disponible o está bloqueado¶
Un medidor silencioso detiene el control automático tras 5 minutos
Cuando el sensor de red pasa a unavailable o unknown, o deja de actualizarse, el bucle de control deja de seguir la carga de la casa, y una batería puede continuar a su última potencia solicitada, por ejemplo 2000W de descarga. Tras 5 minutos sin una lectura válida, Omnibattery crea una reparación de Home Assistant y pone a 0W cada batería bajo control automático. El modo manual y las franjas manuales se mantienen como están, y la carga predictiva desde la red se pausa. El control automático se reanuda solo en cuanto el sensor vuelve a publicar una lectura válida.
Lo mismo ocurre cuando el sensor no publica nada tras reiniciar Home Assistant. Después de un fallo o un corte de luz, una batería puede seguir ejecutando su última orden de antes del reinicio; los 5 minutos cuentan entonces desde que Home Assistant termina de iniciarse.
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| Falló la conexión Wi-Fi o del broker | Integración del medidor, broker MQTT y disponibilidad del sensor | Restaura la conectividad antes de depender del control automático |
| El valor del sensor dejó de cambiar | last_updated mientras cambia la potencia doméstica |
Reinicia o repara la integración fuente |
| Se seleccionó la entidad incorrecta | Sensor de red principal configurado | Selecciona la entidad de potencia neta de red descrita en la configuración del sensor principal |
| Shelly publica demasiado despacio | Cadencia de actualización del sensor MQTT | Usa el script MQTT de Shelly Pro 3EM correspondiente |
Durante hasta 65 segundos después de la última lectura, el valor bloqueado sigue considerándose autoritativo. Después, el controlador puede realizar un recálculo de seguridad con el término derivativo suprimido, pero sigue usando el valor obsoleto; es más seguro restaurar la fuente rápidamente que depender de esto.
Alterna continuamente entre carga y descarga¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| El control es demasiado agresivo | PD Control Quality, perfil de ajuste, banda muerta y ajuste derivativo | Selecciona un perfil más suave o aumenta la banda muerta en seguir el consumo de casa |
| El sensor de red tiene ruido o retraso | Gráfica del sensor e intervalos de actualización | Corrige la fuente del medidor antes de seguir ajustando |
| Una carga pulsante cruza repetidamente el objetivo | Historial de carga y estado de dispositivo excluido | Configúrala mediante exclusión de carga |
| La potencia mínima del relé provoca arranques repetidos | Controles de potencia mínima de carga/descarga y temporización del relé | Revisa los ajustes del actuador en seguir el consumo de casa |
Resultado esperado: PD Control Quality pasa a estable tras observar el controlador suficiente funcionamiento normal.
No cargó durante la noche¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| No se previó déficit de energía | Motivo de Predictive Charging Active y energía objetivo | No hace falta actuar si la energía almacenada y la previsión solar cubren la demanda |
| Faltan datos de precio o previsión | price_data_status, previsión solar y disponibilidad de entidad fuente |
Restaura la fuente descrita por tu modo predictivo |
| No hay periodo apto antes de la demanda | chronological_plan_reason, plazos, franjas seleccionadas e interruptores de franja |
Ajusta el horario o el techo de precio |
| La potencia de carga o capacidad libre es insuficiente | deadline_shortfall_kwh, SOC de batería, límite de carga y SOC objetivo |
Aumenta un límite intencionado o acepta el déficit informado |
| Otra función poseía la carga | charge_blockers, modo manual, retraso de carga o estado de franja horaria |
Elimina la regla en conflicto |
Resultado esperado: el sensor de diagnóstico muestra un plan de carga de red viable o informa claramente de por qué la carga es innecesaria o físicamente imposible. Consulta Precio dinámico o modo Franja horaria.
La fuente de consumo muestra legacy_daily o el perfil solar recurre a un método alternativo
Una fuente de previsión de consumo legacy_daily es esperable mientras el perfil de 28 días sigue aprendiendo, o cuando el intervalo solicitado no cumple su contrato de cobertura. Comprueba Expected Home Consumption Profile y los diagnósticos de integración. Cambiar una fuente o ajuste de carga excluida conserva todos los días aprendidos; un cambio de zona horaria los redistribuye según el desplazamiento entre las dos zonas, y el relleno de Recorder reconstruye en segundo plano lo que siga faltando. No se interpola un hueco de más de cinco minutos.
También es esperable que una previsión solar permanezca inmadura o recurra a un método alternativo durante los primeros días. El aprendizaje necesita potencia FV directa del sensor externo configurado o canales MPPT legibles, al menos siete días de calidad cerrados, cobertura reciente y evidencia suficiente en el intervalo futuro solicitado; se excluyen muestras no válidas, negativas y con huecos largos, y las señales de limitación de producción pueden excluir intervalos. Un cambio de fuente o capacidad inicia una generación nueva. Comprueba la sección solar_profile de los diagnósticos y solar_timeline_fallback_reason; el perfil no puede reparar una previsión meteorológica incorrecta ni modelar una limitación de producción que no puede observar.
La carga completa semanal o el balance de celdas no terminó¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| Día incorrecto o función desactivada | Weekly Full Charge y Weekly Full Charge Day | Activa y programa la carga completa semanal |
| La carga está retrasada o bloqueada | Estado de carga semanal, charge_blockers y control manual |
Elimina el bloqueador o desactiva el retraso configurado para esa ejecución |
| El sistema de gestión de batería paró en la parte superior | SOC, tensión de celda, potencia de carga y entidades de alarma y fallo | Deja que la integración aplique su reducción gradual admitida; inspecciona los fallos persistentes |
| Falta la telemetría de celda requerida | Tensión máxima/mínima de celda y entidades de balance | Comprueba la compatibilidad en monitor de balance de celdas |
| Un blueprint posee la batería | Manual Battery Control y traza de automatización | Revisa el blueprint de balance activo |
Una batería de un sistema multibatería no participa¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| Su SOC o prioridad hace preferible otra batería | Active Batteries, Primary Battery y Charge Priority | Puede ser esperado; revisa varias baterías |
| El sentido está desactivado | Allow Charge / Allow Discharge por batería | Activa el sentido requerido |
| La batería tiene control manual | Manual Battery Control | Libera el control manual tras devolver la batería a reposo |
| Se alcanzó el límite de potencia o SOC | Bloqueadores y entidades de límite por batería | Ajusta únicamente el límite que pretendes cambiar |
| Falló la entrega o la comunicación | Non-Responsive Batteries y Repairs | Sigue la Repair e inspecciona los diagnósticos |
Aparece una alarma o un fallo de batería¶
| Causa probable | Qué comprobar | Acción |
|---|---|---|
| La batería informa de una advertencia o protección | System Alarm Status, Alarm Status y Fault Status por batería | Sigue las indicaciones del fabricante de la batería para la condición indicada |
| La condición ya se ha resuelto | Estado actual y notificación persistente | Confirma que se despeja la notificación; recarga solo si el estado sigue obsoleto |
| El modelo no expone registros de alarma | Disponibilidad de entidad de ese controlador | Usa la aplicación o interfaz local del fabricante |
Los registros de alarma y fallo (sondeados cada 5 segundos) solo están disponibles en hardware v2; v3, vA y vD no los exponen mediante Modbus. Cuando se establece un bit nuevo, Omnibattery crea una notificación persistente titulada con 🚨 para un fallo o ⚠️ para una alarma, con el nombre exacto de la condición (por ejemplo, BAT Overvoltage o Fan Abnormal Warning); se descarta automáticamente cuando se borran todos los bits.
Antes de pedir ayuda¶
- Abre Ajustes → Dispositivos y servicios → Omnibattery.
- Abre la entrada de configuración afectada y selecciona Download diagnostics.
- Revisa el JSON y elimina cualquier cosa que no quieras compartir.
- Activa el registro de depuración desde la página de integración, reproduce el problema y después desactiva el registro para descargar el archivo de registro.
- Incluye en tu informe el síntoma observado, la hora aproximada, estados de entidades relevantes, diagnósticos y registro.
Los diagnósticos ocultan campos de conexión e identificadores conocidos, pero aun así debes revisar el archivo antes de compartirlo.