Alterar configurações do JK BMS por Bluetooth no navegador

Você pode alterar as configurações do JK BMS por Bluetooth direto do navegador, sem o app JK e sem exportar arquivo nenhum. Abra o editor JK Preset Studio no Chrome ou no Edge, clique em Conectar BMS e escolha o seu BMS. O editor lê todas as configurações, deixa você alterá-las com presets e verificações e grava o resultado de volta uma configuração por vez, relendo o BMS depois de cada etapa.

O que você precisa

  • Um navegador com Web Bluetooth. Chrome ou Edge no Windows, macOS, ChromeOS ou Android. Firefox, Safari e todos os navegadores no iPhone e iPad não têm esse recurso. Neles, use o caminho pelo arquivo .jkcfg.
  • O app JK fechado. O BMS aceita uma conexão Bluetooth por vez. Se o app ou outro monitor (um ESP32 com esphome, por exemplo) estiver conectado, o BMS não aparece na lista ou derruba a conexão.
  • Um JK BMS com o protocolo JK02. Testamos uma JK-PB2A16S20P (firmware 19.26) e uma JK-B2A8S20P (firmware 19.25). Outras placas JK com firmware 19 usam o mesmo protocolo.
  • Alcance. Fique a poucos metros do BMS. Um gabinete metálico de baterias reduz muito o alcance.

Conectar e ler as configurações

  1. Abra a página inicial e clique em Conectar BMS.
  2. O navegador mostra uma lista de dispositivos próximos. As placas JK costumam anunciar o número de série ou um nome que começa com JK. Escolha a sua.
  3. O editor lê dois frames do BMS: um com todas as configurações e outro com as informações do dispositivo. O BMS apita uma vez quando envia as configurações.
  4. O editor abre com os seus valores, o modelo e as versões de hardware e firmware.

Esses dois frames são exatamente o que o app JK salva num arquivo .jkcfg. Você pode baixá-los como arquivo a qualquer momento, o que dá um bom backup antes de mudar qualquer coisa.

Quais configurações o seu modelo tem

Nem todo JK BMS tem todas as funções. O frame de configurações sempre traz todos os campos, até os de recursos que a placa não tem: uma placa B2A 8S sem aquecimento ainda informa uma temperatura de início do aquecimento. Por isso, logo depois de conectar, o editor pergunta direto ao BMS. Ele grava de volta o valor atual de cada configuração opcional, o que não muda nada, e o BMS responde para cada uma: aceita, ou "este modelo não tem essa configuração".

As configurações que faltam no BMS ficam marcadas como Não existe neste BMS. Elas continuam visíveis, mas não podem ser editadas, os presets não mexem nelas e elas não são validadas. Na nossa JK-B2A8S20P isso incluiu a tensão de flutuação (RFV), o modo de flutuação na carga, o aquecimento, a pré-carga, o módulo PCL, a chave de porta e os protocolos CAN e UART2. O resultado fica guardado no seu navegador para aquele BMS, então a próxima conexão é instantânea.

Editar e aplicar um preset

Cada parâmetro tem uma explicação curta, uma faixa recomendada para a química das suas células e um link para as fontes. Você pode:

  • alterar valores isolados, por exemplo o OVP ou a tensão de início do balanceamento;
  • aplicar um preset pronto para LiFePO4, NMC ou LTO e depois ajustá-lo;
  • consultar a referência de parâmetros para saber o que cada campo faz.

O editor confere os valores dependentes enquanto você digita, por exemplo se o OVPR fica abaixo da tensão SOC-100% e se ela fica abaixo do RCV. Erros bloqueiam a gravação; avisos só informam.

Gravar e conferir

Clique em Gravar no BMS. A janela mostra o plano antes de qualquer envio: quantas etapas, quais configurações em cada etapa e quais configurações editadas serão puladas. Baixe antes o backup oferecido ali.

O firmware confere cada valor gravado com o que o BMS guarda naquele momento, então os mesmos valores finais podem falhar numa ordem e passar em outra. O editor divide suas alterações em etapas que são seguras em qualquer ordem. Depois de cada etapa, ele relê o BMS e compara todos os valores.

O BMS responde a cada gravação com um código de resultado. Se ele recusar um valor porque conflita com outra configuração, a gravação para na hora e o editor mostra qual configuração falhou e o que o BMS guarda agora. Se uma configuração não existir no seu modelo, ela é pulada e listada. Nada falha em silêncio.

Um detalhe que encontramos no hardware real: uma gravação enviada logo depois de uma leitura pode ser descartada sem resposta nenhuma. O editor espera um pouco depois de cada leitura e reenvia a gravação uma vez se não vier resposta.

Quando o arquivo ainda é melhor

  • O seu navegador ou celular não tem Web Bluetooth.
  • Você quer um backup de longo prazo ou manter várias configurações lado a lado.
  • Você prepara as configurações antes de montar o pack, ou as envia para outra pessoa.

O guia de exportação e importação cobre esse caminho. Se uma importação falhar com "Sending failure", veja o guia sobre Sending failure.

Erros comuns

  • Deixar o app JK aberto, e o BMS nunca aparece na lista.
  • Gravar sem backup. Baixe as configurações atuais antes.
  • Esperar que toda configuração mude em todo modelo. Confira as marcas Não existe neste BMS.
  • Gravar valores de outra química. Comece pelo guia de configuração para LiFePO4 ou pelo preset certo.

Perguntas frequentes

Preciso da senha do BMS para gravar por Bluetooth?

Nos nossos testes, o BMS aceitou gravações sem senha; quem confere a senha é o próprio app JK. Um relato com um firmware V15 mais antigo diz que as gravações pararam de funcionar depois que a senha de configuração foi trocada, então o resultado pode variar.

É seguro?

O editor grava só o que você alterou, numa ordem segura, e confere cada valor depois. Valores errados ainda podem danificar as células, então compare-os com o datasheet das suas células e guarde o backup.

Algum dado sai do meu computador?

Não. O navegador conversa direto com o BMS. As configurações nunca são enviadas.

Por que o BMS apita?

O BMS apita quando alguém pede as configurações dele. O editor pede uma vez ao conectar e uma vez depois de cada etapa de gravação.

Conecte seu BMS e veja as configurações atuais em um minuto.

Guias relacionados

Todos os guias