Saltar a contenido

Varias baterías

Omnibattery coordina todas las baterías configuradas como un sistema, respetando a la vez los límites y controles de cada batería. Elige qué baterías deben participar y reparte la potencia solicitada entre las que son elegibles.

¿Lo necesito?

Úsalo si tienes más de una batería compatible y quieres un objetivo de red único, límites de potencia coordinados y un control claro sobre qué batería puede cargar o descargar.

No lo necesitas si tu instalación tiene una batería. Las entidades agregadas del sistema siguen reflejando esa batería.

Antes de empezar

  • Añade todas las baterías a la misma entrada de configuración de Omnibattery. Una entrada admite hasta 10 baterías.
  • Confirma que cada batería se actualiza de forma fiable e informa de estado de carga (SOC) y potencia.
  • Decide si alguna batería necesita control manual o debe excluirse de una dirección.

Cómo activarlo

  1. Abre Ajustes → Dispositivos y servicios → Omnibattery → Configurar.
  2. Añade o revisa cada batería en la sección de configuración de baterías.
  3. Termina el formulario y deja que la integración se recargue.
  4. Abre el panel de Omnibattery y revisa Allow Charge, Allow Discharge, Manual Battery Control, Primary Battery y Charge Priority.

Este comportamiento es automático cuando la entrada de configuración contiene varias baterías; no hay un interruptor independiente para varias baterías.

Estado de varias baterías en Home Assistant

Qué verás

Active Batteries identifica las baterías que están cargando, descargando, en reposo o bajo control manual. Non-Responsive Batteries identifica exclusiones temporales. Integration Status expone bloqueadores globales y por batería.

Cada batería tiene Allow Charge, Allow Discharge y Manual Battery Control. Las instalaciones con varias baterías también muestran Primary Battery y Charge Priority. Los opcionales System Max Charge Power y System Max Discharge Power limitan la solicitud combinada cuando se configuran límites de potencia del sistema.

La selección automática normalmente prefiere mayor SOC para descargar y menor SOC para cargar. Una batería puede permanecer en reposo mientras trabaja otra; es esperado cuando una unidad puede atender la solicitud con más eficiencia.

Si no funciona

Síntoma Causa probable Qué comprobar
Una batería nunca participa Dirección desactivada, control manual, prioridad de SOC o un límite Active Batteries, interruptores Allow, modo manual y bloqueadores por batería
Una batería desaparece temporalmente Fallo de comunicación o de potencia entregada Non-Responsive Batteries y Reparaciones de Home Assistant
La potencia combinada es menor de la esperada Tope de sistema o límite por batería Entidades de límite de potencia de sistema y batería
Las baterías intercambian roles repetidamente Ruido del medidor o histéresis de selección cerca de un límite PD Control Quality, valores de SOC y perfil del controlador
El control manual de una batería lucha contra el automático No se activó el control manual Activa Manual Battery Control antes de escribir consignas sin procesar

Consulta solución de problemas para comprobaciones por síntoma.

Detalles avanzados

Principio de eficiencia

Basándose en curvas de eficiencia Venus medidas, las baterías se activan solo cuando la potencia total supera el punto de cruce de eficiencia: la potencia a la que repartir la carga entre dos baterías es más eficiente que usar solo una. Usar menos baterías a mayor potencia es más eficiente que repartir la misma carga entre todas.

Los puntos de cruce (derivados de mediciones externas de η) son:

Dirección Cruce % del máximo físico de 2500 W
Descarga 1500 W 60 %
Carga 1750 W 70 %

El umbral de activación se calcula dinámicamente como crossover_W ÷ configured_max_W, limitado a [50 %, 95 %]. Esto significa que quien configura un límite de potencia menor por batería activa baterías adicionales más tarde (más cerca de su máximo configurado), lo que refleja correctamente que el rango de operación se mantiene dentro del pico de eficiencia de una sola batería.

Las siguientes mediciones muestran consumo/salida de potencia CC, potencia CA en el contador (pinza interna) y en el enchufe de pared (pinza externa), y la eficiencia resultante en cada nivel de potencia:

Carga

% del máximo Consigna (W) CC interna (W) CA interna (W) CA externa (W) η interna η externa
3 % 63 41 58 68 70.7 % 60.3 %
5 % 125 105 123 136 85.4 % 77.2 %
10 % 250 232 247 262 93.9 % 88.5 %
15 % 375 357 372 387 96.0 % 92.2 %
20 % 500 481 497 513 96.8 % 93.8 %
25 % 625 604 621 639 97.3 % 94.5 %
30 % 750 727 743 766 97.8 % 94.9 %
35 % 875 850 871 892 97.6 % 95.3 %
40 % 1000 973 995 1019 97.8 % 95.5 %
45 % 1125 1095 1120 1146 97.8 % 95.5 %
50 % 1250 1245 1271 1274 98.0 % 97.7 %
55 % 1375 1339 1369 1401 97.8 % 95.6 %
60 % 1500 1460 1494 1530 97.7 % 95.4 %
65 % 1625 1581 1618 1658 97.7 % 95.4 %
70 % 1750 1702 1743 1786 97.6 % 95.3 %
75 % 1875 1823 1868 1916 97.6 % 95.1 %
80 % 2000 1942 1992 2044 97.5 % 95.0 %
85 % 2125 2062 2117 2175 97.4 % 94.8 %
90 % 2250 2183 2242 2304 97.4 % 94.7 %
95 % 2375 2304 2366 2436 97.4 % 94.6 %
100 % 2500 2424 2491 2567 97.3 % 94.4 %

Descarga

% del máximo Consigna (W) CC interna (W) CA interna (W) CA externa (W) η interna η externa
3 % 63 80 63 60 78.8 % 75.0 %
5 % 125 160 124 118 77.5 % 73.8 %
10 % 250 284 249 243 87.7 % 85.6 %
15 % 375 416 373 368 89.7 % 88.5 %
20 % 500 550 498 494 90.5 % 89.8 %
25 % 625 685 623 619 90.9 % 90.4 %
30 % 750 820 747 745 91.1 % 90.9 %
35 % 875 956 872 870 91.2 % 91.0 %
40 % 1000 1092 997 996 91.3 % 91.2 %
45 % 1125 1230 1121 1121 91.1 % 91.1 %
50 % 1250 1369 1246 1246 91.0 % 91.0 %
55 % 1375 1507 1370 1372 90.9 % 91.0 %
60 % 1500 1647 1495 1497 90.8 % 90.9 %
65 % 1625 1789 1620 1623 90.6 % 90.7 %
70 % 1750 1931 1745 1748 90.4 % 90.5 %
75 % 1875 2073 1869 1874 90.2 % 90.4 %
80 % 2000 2218 1994 1999 89.9 % 90.1 %
85 % 2125 2362 2118 2124 89.7 % 89.9 %
90 % 2250 2508 2243 2250 89.4 % 89.7 %
95 % 2375 2654 2368 2375 89.2 % 89.5 %
100 % 2500 2801 2492 2501 89.0 % 89.3 %

Prioridades de selección

Descarga

Mayor SOC primero: la batería más cargada descarga primero para equilibrar el estado de carga en el sistema.

Carga

Menor SOC primero: la batería menos cargada recibe energía primero.

Histéresis

Para evitar la activación y desactivación de «ping-pong», se aplican tres niveles de histéresis:

Histéresis Valor Descripción
SOC 5 % Una batería activa permanece activa hasta que otra la supera en 5% de SOC
Energía de vida útil 2.5 kWh Desempata el SOC usando energía acumulada de vida útil con ventaja para la batería activa
Potencia 10 pp Umbral de activación derivado del cruce de eficiencia; desactivación = activación − 10 puntos porcentuales

Reparto de potencia

Tras seleccionar las baterías activas, la potencia total calculada por el controlador PD se reparte entre ellas proporcionalmente, respetando los límites individuales de potencia y SOC. La misma lógica de selección y reparto se aplica siempre que la integración solicita potencia a la flota, no solo durante el control normal de seguimiento de red; incluye carga solar y carga predictiva/desdela red.

También se pueden configurar topes globales opcionales en Advanced PD controller después de activar Enable system power limits:

Ajuste Efecto
System Max Charge Power Limita la potencia de carga combinada de todas las baterías activas
System Max Discharge Power Limita la potencia de descarga combinada de todas las baterías activas

Establece cualquiera en 0 W para desactivar el tope de esa dirección. Estos límites se aplican después de determinar la elegibilidad por batería y antes de repartir la potencia, de modo que una batería puede seguir usando todo su límite individual cuando es la única activa. Si hay varias activas, el total combinado se limita al tope de sistema configurado. Las entidades de control deslizante correspondientes solo se crean cuando está activada la función.

Controles de carga/descarga por batería

Cada batería expone dos interruptores de software:

Interruptor Efecto
Allow Charge Al desactivarlo, esta batería queda excluida de la carga automática. Puede seguir descargando si Allow Discharge está activado.
Allow Discharge Al desactivarlo, esta batería queda excluida de la descarga automática. Puede seguir cargando si Allow Charge está activado.

Estos interruptores no escriben directamente registros de control Modbus. Solo afectan al controlador PD automático de la integración. Si una batería está activa en la dirección desactivada, la integración envía esa batería a 0 W y el siguiente ciclo reasigna la potencia entre las baterías elegibles restantes.

El estado se almacena por batería como allow_charge y allow_discharge. Los valores ausentes tienen como predeterminado activado, por lo que las instalaciones existentes mantienen su comportamiento tras actualizar.

Control manual por batería

Cada batería también expone switch.*_battery_manual_mode. Al activarlo, Omnibattery primero envía y verifica una orden de 0 W, borra el modo forzado y las consignas de potencia de software de la integración, y retira esa batería del grupo automático. El estado del interruptor se conserva por batería, de modo que la exclusión sobrevive a un reinicio. La batería sigue siendo consultada y permanece incluida en la telemetría física de batería/red, pero no recibe consignas automáticas de potencia; la gestión de seguridad del driver y del BMS sigue activa.

Al desactivar el interruptor, la batería conserva el control manual mientras se verifica la orden final de reposo. Solo entonces vuelve al grupo automático y se programa un ciclo de control inmediato. Si falla el traspaso a reposo, el interruptor sigue activado y la batería permanece manual.

En drivers con registros (Marstek, ESPHome), las entidades sin procesar Force Mode, Set Charge Power y Set Discharge Power escriben directamente los registros del dispositivo, y el bucle de control reafirma esos registros en cada ciclo. Por tanto, escribir en ellas mientras la batería está bajo control automático se rechaza con un error que apunta a Manual Mode, en lugar de aceptarse y revertirse un segundo después. Activar el interruptor global Manual Mode o el Battery Manual Mode de esa batería libera la protección. Los registros de configuración de batería, como los cortes de SOC y los topes de potencia, no se ven afectados.

Este control es independiente del interruptor global Manual Mode. Por ejemplo, con dos baterías, A puede dejarse en modo manual con una potencia elegida por el usuario mientras B continúa automática. Si B ya está cargando, el controlador PD incluye la carga de red CA medida de A para que B reduzca su propia carga y el contador se mantenga en cero. Cuando las baterías automáticas ya no cargan, la carga de red intencionada de A se excluye de la realimentación para que B no descargue para compensarla. La potencia solar acoplada en CC no se incluye cuando el driver expone una lectura de potencia CA independiente.

Registro unificado de bloqueadores

Los permisos de carga y descarga se resuelven mediante un registro de bloqueadores en tiempo de ejecución. Los bloqueadores pueden ser globales o aplicarse a una batería. El controlador consulta este registro antes de retornos tempranos por banda muerta y sensor obsoleto, de modo que una orden activa se detiene en cuanto aparece un bloqueador.

Los bloqueadores globales incluyen retraso de carga solar, reglas de carga/descarga de franjas horarias, control de descarga basado en precios y pausas de cargador VE sin telemetría. Los bloqueadores por batería incluyen los interruptores Allow Charge y Allow Discharge, SOC máximo, SOC mínimo e histéresis de carga. Otras comprobaciones de disponibilidad como la exclusión por respaldo/fuera de red y por falta de respuesta siguen separadas del registro.

Los atributos de nivel superior charge_blocked y discharge_blocked informan del estado efectivo del sistema: pasan a true cuando hay un bloqueador global activo o cuando todas las baterías conocidas están bloqueadas en esa dirección. Los detalles por batería siguen visibles en battery_charge_blockers y battery_discharge_blockers.

El registro se expone en el sensor de diagnóstico Integration Status mediante estos atributos:

  • charge_blocked
  • discharge_blocked
  • charge_blockers
  • discharge_blockers
  • battery_charge_blockers
  • battery_discharge_blockers

Exclusión de batería sin respuesta

Cuando una batería no entrega de forma constante la potencia ordenada —por ejemplo, por un fallo de comunicación Modbus o una respuesta de autoprotección del firmware— la integración la detecta y la retira temporalmente del grupo activo.

Una batería se marca como sin respuesta cuando su salida medida es inferior al 5% de la consigna durante 3 ciclos de control consecutivos. Una vez marcada, entra en una ventana de exclusión de 5 minutos en la que no recibe órdenes nuevas y las baterías restantes absorben su parte de carga. Cuando expira la ventana, el contador de fallos se reinicia y la batería vuelve a ser elegible.

Las negativas a descargar con SOC bajo están exentas. En o por debajo de 20% SOC (o justo por encima del SOC mínimo configurado), el BMS puede cortar la descarga por sí mismo —por ejemplo, una celda débil que cae bajo carga— aunque el SOC informado siga por encima del mínimo. La batería confirma la orden pero entrega 0 W; se trata como un corte esperado del BMS y no como un fallo, así que sigue en el grupo. Esto refleja el manejo de corte del BMS a SOC alto en el lado de carga.

Este mecanismo evita que una sola batería defectuosa degrade silenciosamente el rendimiento del sistema sin alarmas ni intervención manual.