Exportar e importar ajustes del JK BMS: guía del archivo .jkcfg

Puedes exportar e importar los ajustes del JK BMS con las funciones de exportación e importación de la app móvil de JK BMS. La exportación guarda un pequeño archivo .jkcfg con toda tu configuración. La importación lo vuelve a enviar al BMS. Guarda ese archivo como copia de seguridad y edítalo solo con una herramienta que corrija las sumas de verificación, como el editor de JK Preset Studio. Si solo quieres cambiar ajustes, puedes prescindir del archivo y escribirlos por Bluetooth desde el navegador.

Qué es el archivo .jkcfg

El archivo mide exactamente 600 bytes. Contiene dos tramas de 300 bytes, las mismas que el BMS envía por Bluetooth.

• La trama 0 guarda los ajustes: tensiones, corrientes, balanceo, retardos y temperaturas.
• La trama 1 guarda la información del dispositivo: modelo, versión de hardware y de software, número de serie, nombre del dispositivo y los campos de contraseña.

El último byte de cada trama es una suma de verificación. Es la suma de los 299 bytes anteriores, recortada a un byte. Si la suma de verificación no coincide con los datos, el archivo está dañado.

La estructura viene del proyecto de código abierto syssi/esphome-jk-bms, que documenta el protocolo JK02_32S. El archivo de ejemplo del repositorio de JK Preset Studio se exportó desde un JK-PB2A16S20P con firmware 19.26.

Exportar e importar ajustes del JK BMS: primero, la copia de seguridad

Los nombres de los menús de la app pueden cambiar entre versiones, así que toma estos pasos como orientación.

1. Conéctate al BMS en la app de JK BMS.
2. Abre la pantalla de ajustes y busca las opciones "Export" e "Import".
3. Elige "Export" y guarda el archivo.
4. Cópialo a un lugar seguro, como la nube o tu ordenador.

Dónde se guarda el archivo depende del teléfono y de la versión de la app. Fíjate en el diálogo de guardar o compartir que te deja elegir la ubicación. Si no encuentras el archivo, busca .jkcfg en el teléfono.

Haz una copia antes de cada actualización de firmware y antes de cada cambio grande de ajustes.

Por qué no debes editarlo a mano

Un editor hexadecimal te deja cambiar cualquier byte, pero un archivo con una suma de verificación incorrecta está dañado y puede ser rechazado. Además tendrías que conocer el desplazamiento, el tamaño y la escala de cada campo. Las tensiones se guardan como enteros, por ejemplo 3450 para 3.45 V. Un solo byte equivocado puede convertir un límite en un disparate.

El archivo es binario. Un editor de texto mostrará basura y lo dañará si guardas.

Edítalo de forma segura en el navegador

1. Abre el editor y arrastra tu archivo .jkcfg sobre él. No se sube nada. Todo ocurre en tu navegador.
2. Cambia los valores que necesites. Cada parámetro tiene un texto de ayuda y un rango recomendado.
3. Lee los avisos. El editor comprueba los valores con las reglas que el firmware de JK aplica al importar, como OVPR por debajo de la tensión de SOC-100%, y esta por debajo de RCV.
4. Si quieres, parte de un preset listo para tu química y nivel de desgaste, y luego ajusta.
5. Descarga el resultado.

El editor aplica solo los campos que cambiaste sobre una copia de tus bytes originales. Los bytes desconocidos y reservados se conservan. Después recalcula las dos sumas de verificación. Consulta la referencia de parámetros para ver cada campo.

O sin archivo: escribe por Bluetooth

En Chrome o Edge, en un ordenador o un teléfono Android, el editor puede conectarse directamente al BMS. Cierra la app JK, pulsa Conectar BMS y elige tu BMS. El editor lee las mismas dos tramas que forman un archivo .jkcfg, así que todo lo anterior funciona igual.

Al pulsar Escribir en el BMS, el editor escribe un ajuste cada vez, en un orden que el firmware acepta, y vuelve a leer el BMS después de cada paso. No hay archivos de pasos que importar ni que adivinar qué valor falló. Los ajustes que tu modelo no tiene se detectan nada más conectar y se omiten. La guía de Bluetooth lo explica paso a paso.

El archivo sigue siendo la herramienta adecuada para copias de seguridad, para Firefox, Safari y iPhone, y para preparar los ajustes antes de montar el pack.

Vuelve a importar el archivo

1. Copia el archivo editado al teléfono.
2. Conéctate al BMS en la app.
3. En la pantalla de ajustes, elige "Import" y selecciona el archivo.
4. Revisa los valores en la app cuando termine.

La app escribe los ajustes uno a uno y el firmware comprueba cada uno con lo que el BMS tiene en ese momento. Un archivo con valores finales válidos puede fallar a mitad de camino. Por eso el editor puede darte varios archivos de pasos numerados. Impórtalos en orden, o escribe por Bluetooth, donde el editor se encarga del orden por ti. Si ves "This parameter does not apply to the connected device. (Sending failure)" (este parámetro no se aplica al dispositivo conectado, fallo de envío), lee la guía del Sending failure.

Casos de uso

• Clonar a un segundo pack. Exporta desde el primer BMS e importa en el segundo, o abre el archivo y escríbelo en el segundo BMS por Bluetooth. Comprueba antes el número de celdas y el modelo.
• Copia de una configuración que funciona. Guarda un archivo de una instalación que va bien antes de actualizar el firmware.
• Compartir ajustes. Envía el archivo a otro aficionado. Borra antes las contraseñas (mira las preguntas frecuentes).
• Partir de buenos valores. Consulta la guía de ajustes para LiFePO4 para ver los rangos típicos.

Errores habituales

• Importar un archivo en un pack con un número de celdas distinto.
• Importar el archivo final de una vez cuando el editor dio varios pasos.
• Editar bytes a mano y romper una suma de verificación.
• Olvidar que el archivo contiene tus contraseñas.

Preguntas frecuentes

¿Puedo editar el archivo con un editor de texto?

No. Es un archivo binario de 600 bytes, así que un editor de texto lo corromperá. Usa un editor hexadecimal solo si también sabes corregir las dos sumas de verificación, o usa el editor del navegador, que lo hace por ti. Consulta también parámetros del JK BMS explicados para saber qué hace cada campo.

¿El archivo contiene mi contraseña?

Sí, puede contenerla. La trama de información del dispositivo tiene campos para la contraseña del dispositivo y la contraseña de configuración, de hasta 16 caracteres cada una. Trata el archivo como privado y vacía esos campos antes de compartirlo. Más detalles en la guía de contraseñas.

¿Se importará un archivo de otro modelo?

No de forma fiable. El firmware rechaza valores que no se aplican al dispositivo conectado, así que las diferencias en número de celdas, corriente nominal o versión de firmware pueden provocar fallos. Además, a algunos modelos les faltan funciones enteras: un JK-B2A8S20P con firmware 19.25 no tiene ajustes de flotación, calefacción ni CAN. Por Bluetooth, el editor detecta esos huecos nada más conectar y los omite. El formato del archivo se verificó en un JK-PB2A16S20P con firmware 19.26.

Conecta tu BMS o abre tu .jkcfg en el editor para revisar los valores antes de escribir nada.