As mensagens do log do JK BMS são textos curtos e fixos, como Boot, Time calibration ou Cell 01 over charge protection. Este guia explica o que cada uma significa e quais apontam para um problema real. Os nomes vêm da tabela de mensagens que o firmware usa, conforme listada no projeto de código aberto esphome-jk-bms.

Se você só quer uma resposta para o seu arquivo, solte-o na página de análise de logs. Ela agrupa as mensagens para você. As seções abaixo explicam o que ela está agrupando.

De onde vêm as mensagens do log do JK BMS

As mensagens são a coluna de texto do Detail Log. O BMS escreve uma linha por evento, e cada linha traz um instantâneo do pack: estados dos MOS, célula mais alta e mais baixa, tensões, corrente, capacidade e temperaturas. Como exportar o arquivo e ler as outras colunas está em como exportar e ler o Detail Log do JK-BMS.

O texto não é padronizado. O mesmo tipo de evento é escrito de forma diferente em lugares diferentes, e a página de análise reconhece as mensagens por padrão e não pela string exata. Quando isso importa, é indicado abaixo.

Mensagens de energia e de relógio

Boot: o BMS iniciou. As colunas de tensão e corrente ficam em zero e parecem ser gravadas antes de qualquer medição. Veja como ler reinícios e eventos de energia.
Shutdown: o BMS se desligou sozinho.
Enter sleep: o BMS entrou em modo de suspensão. As opções de suspensão estão nas configurações, nos campos de suspensão inteligente.
Reset Watch-Dog: o watchdog interno reiniciou o BMS. Ao contrário das três anteriores, isto é uma falha. Uma de vez em quando merece nota, repetidas merecem investigação.
Time calibration: registrada quando um app conecta e ajusta o relógio. Marca as suas próprias sessões e não é uma falha. A página de análise oculta essas linhas por padrão.

Linhas com data anterior a 2021, geralmente 2020-01-01, foram gravadas antes de o relógio ser ajustado. São eventos reais com hora desconhecida.

Mensagens de chaves

Elas registram quem ligou ou desligou a carga ou a descarga, e por isso explicam por que o estado do MOS mudou sem nenhuma proteção.

APP open charge, APP close charge, APP open discharge, APP close discharge: você ou outra pessoa usou o app JK.
Remote open charge, Remote close charge, Remote open discharge, Remote close discharge: o mesmo por comando remoto.
RS485 charge on, RS485 charge off, RS485 discharge on, RS485 discharge off e os equivalentes CAN: um inversor ou controlador no barramento acionou o MOS. RS485 power off é uma mensagem própria.
Button to turn it off e APP to turn it off: o BMS foi desligado pelo botão de energia ou pelo app. Um Boot logo depois é esperado, não um reinício surpresa.
Manually enable the emergency mode, Manually turn off the emergency mode, Turn off the emergency mode automatically: mudanças do modo de emergência. Button Emergency On, Button Emergency Off, Remote Emergency On e Remote Emergency Off são a mesma ideia com a origem indicada.
Button Forced Heating: o aquecimento foi forçado pelo botão.

Desarmes e liberações de proteção

Um desarme significa que o BMS cortou a carga ou a descarga. A maioria dos desarmes tem uma linha de liberação correspondente quando o valor se recupera. O texto da liberação varia: "is released", "released" ou "Release", e "over-temperature" ou "over temperature". Por isso Charge over temperature protection is released e Discharge over-temperature protection is released parecem inconsistentes.

Tensão: Cell overcharge protection e Battery overcharge protection, Cell undervoltage protection e Battery undervoltage protection. Alguns arquivos citam a célula, como em Cell 01 over charge protection ou Cell 03 over discharge protection. A análise lê números de célula de 01 a 32. Veja por que a proteção contra sobrecarga de célula fica desarmando para o caso mais comum.
Corrente: Charge overcurrent protection, Discharge overcurrent protection e os estágios Discharge OCP II e Discharge OCP III. Limites e atrasos estão em configurações de sobrecorrente e curto-circuito.
Curto-circuito: Charge short circuit protection, Discharge short circuit protection, Discharge level 2 short circuit protection. A página de análise as classifica como críticas. SCP Release Failed significa que o BMS não conseguiu liberar a proteção contra curto-circuito, o que também é tratado como crítico.
Temperatura: Charge over temperature protection, Charge low temperature protection, Discharge over temperature protection, Discharge under temperature protection e MOS over temperature protection, cada uma com uma liberação.

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

Mensagens de falha

Falhas não são proteções comuns. Descrevem algo errado com o BMS ou a sua fiação, e a página de análise as classifica como críticas.

Abnormal current sensor e Abnormal coprocessor communication: falhas internas. As linhas de liberação são Abnormal release of current sensor e Abnormal cancellation of coprocessor communication.
Charge MOS abnormal e Discharge MOS abnormal: o BMS detectou um problema num MOS.
Discharge On Failed: o BMS tentou ligar a descarga e não funcionou. A mensagem sozinha não dá a causa. Olhe as linhas ao redor, já que uma proteção ainda ativa seria uma explicação.
Cells Count Incorrect: o número de células que o BMS vê não corresponde ao ajuste. Compare com o número de células no editor.

Mensagens de configuração

Factory setting LION, Factory setting LFP, Factory setting LTO: as configurações foram restauradas para um conjunto de fábrica dessa química. Todos os seus valores mudaram de uma vez, então confira-os.
Unknown Log Code [0]: não é um evento real. Parece ser o registro periódico que o BMS escreve quando o armazenamento de dados por tempo está ligado, e a página de análise o oculta por padrão. Se o seu arquivo tem milhares delas, verifique o período de armazenamento de dados.
Unknown Log Code [5], [10] e outros números: códigos que a tabela não nomeia. A página de análise os lista como desconhecidos e também não sabe dizer o que significam.

Lendo mais rápido

Ler um arquivo longo à mão é lento. A página de análise de logs separa as mensagens em famílias (energia, chaves, cada tipo de proteção, falhas, configuração), associa desarmes a liberações e conta os desarmes por célula. Ela oculta as linhas de sincronização do relógio e as periódicas até você pedir. Tudo roda no seu navegador e o arquivo não é enviado.

Comece pelas falhas e pelas linhas críticas, depois olhe os desarmes que se repetem.

Mensagens do log do JK BMS: Boot, Time calibration, proteções