O Detail Log do JK-BMS é uma longa lista de eventos, cada um com um instantâneo da bateria naquele momento. Ele mostra quando o BMS cortou a carga ou a descarga, qual célula causou isso e quais eram a tensão, a corrente e a temperatura. Exporte-o do app JK como arquivo de texto e leia à mão, ou abra na página de análise de logs, que associa os desarmes às liberações e aponta a causa provável.

O que é o Detail Log

O app o exporta como um arquivo com nome parecido com detaillogs-20261001171819.txt, com a data e a hora da exportação no nome. Apesar da extensão, é um CSV. A primeira linha traz os nomes das colunas e cada uma das demais é um evento.

Uma linha de evento tem a hora, a mensagem (por exemplo "Cell 01 over charge protection"), o estado do MOS de carga, do MOS de descarga, do balanceador e do aquecedor, os números da célula mais alta e da mais baixa, suas tensões, a tensão do pack, a corrente, a capacidade restante e a total, as temperaturas e a corrente do aquecedor.

Firmwares antigos guardam uma lista curta de cerca de 50 eventos que vai sendo sobrescrita. O Detail Log é um registro separado e mais longo, escrito pelo próprio BMS, por isso cobre dias ou semanas sem nada conectado.

Exportando pelo app

Conecte-se ao BMS no app JK por Bluetooth.
Abra a tela do dispositivo e procure a seção de registros. Os nomes do menu mudam um pouco entre versões do app.
Escolha o Detail Log e exporte. O app salva um arquivo .txt.
Envie o arquivo para o computador ou abra no celular.

Lendo as colunas

Alguns detalhes são fáceis de confundir.

Os números de célula no texto da mensagem começam em 1, então "Cell 01" é a primeira célula. As colunas de célula máxima e mínima começam em 0, então some 1 para comparar. Os dois também nem sempre coincidem: o instantâneo pode ficar atrás do evento, então a célula citada na mensagem nem sempre é a que a coluna mostra naquele momento. No exemplo, as linhas que dizem "Cell 01" mostram 0 na coluna de célula máxima em apenas 366 de 1083 linhas, e outras linhas mostram células até a 7.
As linhas de boot trazem zeros nas colunas de tensão e corrente.
As linhas de calibração de hora aparecem quando o app conecta e ajusta o relógio. Marcam as suas próprias sessões, não uma falha.
Linhas com data anterior a 2021, geralmente 2020-01-01, indicam que o relógio ainda não tinha sido ajustado. São eventos reais com hora desconhecida, então a análise os deixa de fora dos cálculos de tempo e duração.
Tensões com apenas uma casa decimal, presentes em algumas exportações antigas, são grosseiras demais para avaliar a dispersão entre células.
A página de análise aceita arquivos de até 10 MB e descarta linhas duplicadas que caem a menos de 2 segundos uma da outra.

Famílias de mensagens

As mensagens se dividem em alguns grupos.

Desarmes e liberações de proteção: sobretensão, subtensão, sobrecorrente de carga e de descarga, curto-circuito, sobretemperatura ou subtemperatura de carga e de descarga, e sobretemperatura do MOS. Cada desarme normalmente tem uma linha de liberação correspondente.
Ações do usuário e do app: o botão de energia, uma chave de emergência, o app desligando o BMS.
Chaves remotas: o app, RS485 ou CAN ligando ou desligando a carga ou a descarga.
Eventos de energia: Boot, desligamento e repouso.
Falhas: estados anormais como número de células errado, erro do coprocessador ou falha de MOS. Não são proteções comuns e merecem atenção.

Os desarmes por sobretensão e subtensão citam a célula. Esse é o dado mais útil.

Episódios de proteção

Um desarme e a sua liberação formam um episódio. O tempo entre os dois é quanto a proteção durou. O tempo da liberação até o próximo desarme do mesmo tipo é o tempo de rearme.

Os episódios explicam por que um único problema pode gerar mil linhas. Se um carregador continua empurrando uma célula acima do limite, o BMS desarma, libera depois de uma pausa e desarma de novo. Cada volta soma duas linhas.

Uma linha Boot fecha qualquer episódio aberto, porque o BMS perdeu o seu estado. Um desarme sem liberação até o fim do arquivo permanece aberto.

Diagnósticos comuns

Carregador acima do limite da célula (tensão do carregador muito alta). O log de exemplo tem 1090 desarmes por sobretensão, 1083 deles na célula 01, com a dispersão entre a célula mais alta e a mais baixa quase sempre abaixo de 10 mV. Isso significa que as células estão equilibradas e que o carregador mantém o pack alto demais; por que a proteção contra sobrecarga de célula fica desarmando traz os números e a solução.

Célula fraca no topo. Se pelo menos 80% dos desarmes citam uma célula e a dispersão é de 50 mV ou mais, essa célula é o problema. Veja primeiro a dispersão, porque só a célula citada pode enganar. Revise as configurações de balanceamento e verifique a célula e a sua fiação. Para ver o padrão nos dados, leia como encontrar uma célula fraca no log.

Subtensão. A mesma divisão vale embaixo. Uma célula bem abaixo das outras aponta para uma célula fraca. Uma dispersão pequena aponta para um pack vazio, muitas vezes por um corte do inversor configurado baixo demais. Compare Cell UVP e Tensão SOC-0% com o ponto em que o inversor para.

Ciclagem. Dez ou mais desarmes por sobretensão com mediana de rearme abaixo de 60 s são sinalizados como ciclagem. Cell OVP recovery e Cell RCV são os campos a observar.

Temperatura e curto-circuito. Os desarmes por temperatura mostram o valor máximo atingido. Uma temperatura do MOS de 70 °C ou mais sem desarme é marcada como aviso. Qualquer desarme por curto-circuito é crítico. Verifique a carga, a fiação e o ajuste de atraso descrito em configurações de sobrecorrente e curto-circuito.

Reinícios inesperados. Uma linha Boot que não vem depois de uma linha de desligamento em até 60 s conta como inesperada. O exemplo tem 7 boots, 2 deles inesperados, porque os outros cinco vêm depois de uma linha "Button to turn it off". Verifique a alimentação e a fiação do BMS e veja como ler reinícios e eventos de energia.

Mudanças de capacidade. Se a capacidade total muda no log, por exemplo de 200 Ah para 334 Ah, alguém editou o ajuste de capacidade. Veja a calibração do SOC para entender como o BMS acompanha a capacidade restante.

Analise o seu log no navegador

Abra a página de análise de logs e solte o arquivo. Ele é lido no seu navegador e nunca é enviado. Você obtém os episódios, a contagem de desarmes por célula e os diagnósticos acima.

Também é possível anexar uma exportação .jkcfg do mesmo BMS. A página então desenha os seus limites como linhas nos gráficos e confronta o log com eles: a tensão de desarme contra Cell OVP, o número de células, a capacidade, o setpoint do carregador contra células × Cell RCV, a corrente de pico perto dos limites de sobrecorrente e a temperatura do MOS perto do seu limite. Corrija o que ela encontrar no editor, de preferência gravando as alterações por Bluetooth, e veja JK BMS Sending failure se o BMS rejeitar um arquivo importado.

Como exportar e ler o Detail Log do JK-BMS