Você pode exportar e importar as configurações do JK BMS com as funções de exportação e importação do app JK BMS no celular. A exportação grava um pequeno arquivo .jkcfg com toda a sua configuração. A importação o envia de volta ao BMS. Guarde esse arquivo como backup e edite-o apenas com uma ferramenta que corrija os checksums, como o editor JK Preset Studio. Se você só quer alterar configurações, pode dispensar o arquivo e gravá-las por Bluetooth direto do navegador.

O que é o arquivo .jkcfg

O arquivo tem exatamente 600 bytes. Ele contém dois frames de 300 bytes, os mesmos frames que o BMS envia via Bluetooth.

Frame 0 guarda as configurações: tensões, correntes, balanceamento, atrasos, temperaturas.
Frame 1 guarda as informações do dispositivo: modelo, versão de hardware e software, número de série, nome do dispositivo e os campos de senha.

O último byte de cada frame é um checksum (soma de verificação). É a soma dos 299 bytes anteriores, cortada para um byte. Se o checksum não bate com os dados, o arquivo está danificado.

A estrutura vem do projeto de código aberto syssi/esphome-jk-bms, que documenta o protocolo JK02_32S. O arquivo de exemplo no repositório do JK Preset Studio foi exportado de uma JK-PB2A16S20P com firmware 19.26.

Exportar e importar configurações do JK BMS: faça backup antes

Os nomes dos menus do app podem mudar entre versões, então use estes passos como orientação.

Conecte-se ao BMS no app JK BMS.
Abra a tela de configurações e procure as opções Export e Import.
Escolha Export e salve o arquivo.
Copie-o para um lugar seguro, como um armazenamento em nuvem ou o seu computador.

O local onde o arquivo é salvo depende do seu celular e da versão do app. Fique atento a uma janela de salvar ou compartilhar que permita escolher o local. Se não encontrar o arquivo, procure no celular por .jkcfg.

Faça backup antes de cada atualização de firmware e antes de cada mudança grande nas configurações.

Por que você não deve editá-lo à mão

Um editor hexadecimal permite alterar qualquer byte, mas um arquivo com checksum errado está danificado e pode ser rejeitado. Você também teria que saber o offset, o tamanho e a escala de cada campo. As tensões são guardadas como inteiros, por exemplo 3450 para 3.45 V. Um único byte errado pode transformar um limite em algo sem sentido.

O arquivo é binário. Um editor de texto vai mostrar lixo e vai danificá-lo se você salvar.

Edite com segurança no navegador

Abra o editor e solte o seu arquivo .jkcfg nele. Nada é enviado. Todo o trabalho acontece no seu navegador.
Altere os valores de que precisa. Cada parâmetro tem um texto de ajuda e uma faixa recomendada.
Leia os avisos. O editor confere os valores com as regras que o firmware da JK aplica na importação, como OVPR abaixo da tensão SOC-100%, que fica abaixo do RCV.
Se quiser, comece de um preset pronto para a sua química e nível de desgaste e depois ajuste.
Baixe o resultado.

O editor aplica apenas os campos que você alterou sobre uma cópia dos seus bytes originais. Bytes desconhecidos e reservados são preservados. Depois ele recalcula os dois checksums. Veja a referência de parâmetros para todos os campos.

Ou dispense o arquivo: grave por Bluetooth

No Chrome ou no Edge, num computador ou num celular Android, o editor consegue se conectar direto ao BMS. Feche o app JK, clique em Conectar BMS e escolha o seu BMS. O editor lê os mesmos dois frames que formam um arquivo .jkcfg, então tudo o que foi dito acima funciona igual.

Quando você clica em Gravar no BMS, o editor grava uma configuração por vez, numa ordem que o firmware aceita, e relê o BMS depois de cada etapa. Não há arquivos de etapas para importar nem adivinhação sobre qual valor falhou. As configurações que o seu modelo não tem são detectadas logo depois de conectar e puladas. O guia de Bluetooth mostra o passo a passo.

O arquivo continua sendo a ferramenta certa para backups, para Firefox, Safari e iPhone e para preparar configurações antes de montar o pack.

Importe o arquivo de volta

Copie o arquivo editado para o seu celular.
Conecte-se ao BMS no app.
Na tela de configurações, escolha Import e selecione o arquivo.
Confira os valores no app quando terminar.

O app grava as configurações uma por uma, e o firmware confere cada uma com o que o BMS tem naquele momento. Um arquivo com valores finais válidos ainda pode falhar no meio do caminho. Por isso o editor pode lhe entregar vários arquivos de etapas numerados. Importe-os em ordem, ou grave por Bluetooth, onde o editor cuida da ordem para você. Se aparecer "This parameter does not apply to the connected device. (Sending failure)", leia o guia sobre Sending failure.

Casos de uso

Clonar para um segundo pack. Exporte do primeiro BMS e importe no segundo, ou abra o arquivo e grave-o no segundo BMS por Bluetooth. Confira antes o número de células e o modelo.
Backup de uma configuração que funciona. Guarde um arquivo de uma instalação funcionando antes de atualizar o firmware.
Compartilhar configurações. Envie o arquivo para outro montador. Apague as senhas antes (veja as perguntas frequentes).
Começar de bons valores. Veja o guia de configuração para LiFePO4 para as faixas típicas.

Erros comuns

Importar um arquivo num pack com número de células diferente.
Importar o arquivo final de uma vez quando o editor gerou várias etapas.
Editar bytes à mão e quebrar um checksum.
Esquecer que o arquivo contém as suas senhas.

Perguntas frequentes

Posso editar o arquivo num editor de texto?

Não. É um arquivo binário de 600 bytes, e um editor de texto vai corrompê-lo. Use um editor hexadecimal só se também souber corrigir os dois checksums, ou use o editor no navegador, que faz isso por você. Veja também parâmetros do JK BMS explicados para saber o que cada campo faz.

O arquivo contém a minha senha?

Sim, pode conter. O frame de informações do dispositivo tem campos para a senha do dispositivo e a senha de configuração, cada uma com até 16 caracteres. Trate o arquivo como privado e limpe esses campos antes de compartilhá-lo. Mais detalhes no guia de senhas.

Um arquivo de outro modelo vai importar?

Não de forma confiável. O firmware rejeita valores que não se aplicam ao dispositivo conectado, então diferenças no número de células, na especificação de corrente ou na versão do firmware podem causar falhas. Alguns modelos também não têm funções inteiras: uma JK-B2A8S20P com firmware 19.25 não tem configurações de tensão de flutuação, aquecimento nem CAN. Por Bluetooth, o editor encontra essas lacunas logo depois de conectar e as pula. O formato do arquivo foi verificado numa JK-PB2A16S20P com firmware 19.26.

Conecte seu BMS ou abra o seu .jkcfg no editor para conferir os valores antes de gravar qualquer coisa.

Exportar e importar configurações do JK BMS: o arquivo .jkcfg