Cómo exportar y leer el Detail Log del JK-BMS

El Detail Log del JK-BMS es una lista larga de eventos, cada uno con una instantánea de la batería en ese momento. Te dice cuándo el BMS cortó la carga o la descarga, qué celda lo provocó y cuáles eran la tensión, la corriente y la temperatura. Expórtalo desde la JK app como archivo de texto y léelo a mano o ábrelo en la página de análisis de logs, que empareja los disparos con sus liberaciones y señala la causa probable.

Qué es el Detail Log

La app lo exporta como un archivo con nombre parecido a detaillogs-20261001171819.txt, con la fecha y la hora de exportación en el nombre. Aunque la extensión sea .txt, es un CSV. La primera fila contiene los nombres de las columnas y cada una de las demás es un evento.

Una fila de evento incluye la hora, el mensaje (por ejemplo "Cell 01 over charge protection"), el estado del MOS de carga, el MOS de descarga, el balanceador y el calefactor, los números de la celda más alta y la más baja, sus tensiones, la tensión del pack, la corriente, la capacidad restante y la total, las temperaturas y la corriente del calefactor.

El firmware antiguo guarda una lista corta de unos 50 eventos que se sobrescribe. El Detail Log es un registro aparte, más largo, escrito por el propio BMS, así que cubre días o semanas sin que haya nada conectado.

Exportarlo desde la app

1. Conéctate al BMS en la JK app por Bluetooth.
2. Abre la pantalla del dispositivo y busca la sección de registros. Los nombres del menú cambian un poco entre versiones de la app.
3. Elige el Detail Log y expórtalo. La app guarda un archivo de texto.
4. Envía el archivo al ordenador o ábrelo en el móvil.

Leer las columnas

Algunos detalles se confunden con facilidad.

• Los números de celda en el texto del mensaje empiezan en 1, así que "Cell 01" es la primera celda. Las columnas de celda máxima y mínima empiezan en 0, por lo que hay que sumar 1 para compararlas. Tampoco coinciden siempre: la instantánea puede ir por detrás del evento, así que la celda nombrada en el mensaje no siempre es la que muestra la columna en ese momento. En el ejemplo, las filas que dicen "Cell 01" muestran 0 en la columna de celda máxima solo en 366 de 1083 filas, y otras filas muestran celdas hasta la 7.
• Las filas de arranque llevan ceros en las columnas de tensión y corriente.
• Las filas de calibración de hora aparecen cuando la app se conecta y ajusta el reloj. Marcan tus propias sesiones, no un fallo.
• Las filas con fecha anterior a 2021, normalmente 2020-01-01, indican que el reloj aún no estaba ajustado. Son eventos reales con hora desconocida, así que el análisis los deja fuera de los cálculos de tiempos y duraciones.
• Las tensiones con un solo decimal, presentes en algunas exportaciones antiguas, son demasiado toscas para juzgar la dispersión entre celdas.
• La página de análisis acepta archivos de hasta 10 MB y descarta las filas duplicadas que caen a menos de 2 segundos una de otra.

Familias de mensajes

• Disparos y liberaciones de protección: sobretensión, subtensión, sobrecorriente de carga y de descarga, cortocircuito, sobretemperatura o subtemperatura de carga y de descarga, y sobretemperatura del MOS. Cada disparo suele tener su fila de liberación.
• Acciones del usuario y de la app: el botón de encendido, un interruptor de emergencia, la app apagando el BMS.
• Interruptores remotos: la app, RS485 o CAN activando o desactivando la carga o la descarga.
• Eventos de alimentación: Boot, apagado y reposo.
• Fallos: estados anormales como un número de celdas incorrecto, un error del coprocesador o un fallo de MOS. No son protecciones normales y merecen atención.

Los disparos por sobretensión y subtensión nombran la celda. Es el dato más útil.

Episodios de protección

Un disparo y su liberación forman un episodio. El tiempo entre ambos es lo que duró la protección. El tiempo desde la liberación hasta el siguiente disparo del mismo tipo es el tiempo de rearme.

Un solo problema puede generar mil filas. Si un cargador sigue empujando una celda por encima del límite, el BMS dispara, libera tras una pausa y vuelve a disparar. Cada vuelta añade dos filas.

Una fila Boot cierra cualquier episodio abierto, porque el BMS perdió su estado. Un disparo sin liberación antes del final del archivo queda abierto.

Diagnósticos habituales

Cargador por encima del límite de celda (tensión del cargador demasiado alta). El log de ejemplo tiene 1090 disparos por sobretensión, 1083 de ellos en la celda 01, con una diferencia entre la celda más alta y la más baja casi siempre por debajo de 10 mV. Eso significa que las celdas están equilibradas y que el cargador mantiene el pack demasiado alto; por qué la protección de sobrecarga de celda salta sin parar tiene las cifras y la solución.

Celda débil arriba. Si al menos el 80% de los disparos nombra una celda y la dispersión es de 50 mV o más, esa celda es el problema. Mira primero la dispersión, porque la celda nombrada por sí sola puede engañar. Revisa los ajustes de balanceo y comprueba la celda y su cableado. Para ver el patrón en los datos, consulta cómo encontrar una celda débil en el log.

Subtensión. Se aplica el mismo criterio por abajo. Una celda muy por debajo del resto apunta a una celda débil. Una dispersión pequeña apunta a un pack vacío, a menudo por un corte del inversor puesto demasiado bajo. Compara Cell UVP y SOC-0% voltage con el punto donde se detiene el inversor.

Ciclado. Diez o más disparos por sobretensión con una mediana de rearme inferior a 60 s se marcan como ciclado. Cell OVP recovery y Cell RCV son los campos que hay que mirar.

Temperatura y cortocircuito. Los disparos por temperatura muestran el valor máximo alcanzado. Una temperatura del MOS de 70 °C o más sin disparo se marca como advertencia. Cualquier disparo por cortocircuito es crítico. Revisa la carga, el cableado y el ajuste de retardo descrito en ajustes de sobrecorriente y cortocircuito.

Reinicios inesperados. Una fila Boot que no sigue a una fila de apagado en menos de 60 s cuenta como inesperada. El ejemplo tiene 7 arranques, 2 de ellos inesperados, porque los otros cinco siguen a una fila "Button to turn it off". Revisa la alimentación y el cableado del BMS, y consulta cómo leer reinicios y eventos de alimentación.

Cambios de capacidad. Si la capacidad total cambia en el log, por ejemplo de 200 Ah a 334 Ah, alguien editó el ajuste de capacidad. Consulta la calibración del SOC para saber cómo sigue el BMS la capacidad restante.

Analiza tu log en el navegador

Abre la página de análisis de logs y suelta el archivo. Se lee en tu navegador y nunca se sube. Obtienes los episodios, los disparos por celda y los diagnósticos anteriores.

También puedes adjuntar una exportación .jkcfg del mismo BMS. La página dibuja entonces tus umbrales como líneas en los gráficos y contrasta el log con ellos: la tensión de disparo frente a Cell OVP, el número de celdas, la capacidad, la consigna del cargador frente a celdas × Cell RCV, la corriente máxima cerca de los límites de sobrecorriente y la temperatura del MOS cerca de su límite. Corrige lo que encuentre en el editor, mejor escribiendo los cambios por Bluetooth, y consulta JK BMS Sending failure si el BMS rechaza un archivo importado.