Vous pouvez exporter et importer les réglages du JK BMS grâce aux fonctions d'export et d'import de l'application mobile JK BMS. L'export écrit un petit fichier .jkcfg qui contient toute votre configuration. L'import le renvoie au BMS. Conservez ce fichier comme sauvegarde, et ne le modifiez qu'avec un outil qui recalcule les sommes de contrôle, comme l'éditeur JK Preset Studio. Si vous voulez seulement modifier des réglages, vous pouvez vous passer du fichier et les écrire en Bluetooth depuis le navigateur.

Qu'est-ce que le fichier .jkcfg

Le fichier fait exactement 600 octets. Il contient deux trames de 300 octets, les mêmes que celles que le BMS envoie en Bluetooth.

La trame 0 contient les réglages : tensions, courants, équilibrage, délais, températures.
La trame 1 contient les informations sur l'appareil : modèle, versions matérielle et logicielle, numéro de série, nom de l'appareil et champs des codes d'accès.

Le dernier octet de chaque trame est une somme de contrôle. C'est la somme des 299 octets précédents, tronquée à un octet. Si la somme de contrôle ne correspond pas aux données, le fichier est endommagé.

La structure provient du projet open source syssi/esphome-jk-bms, qui documente le protocole JK02_32S. Le fichier d'exemple du dépôt JK Preset Studio a été exporté depuis un JK-PB2A16S20P en firmware 19.26.

Exporter et importer les réglages JK BMS : sauvegardez d'abord

Les noms de menus de l'application varient selon les versions, prenez donc ces étapes comme un guide.

Connectez-vous au BMS dans l'application JK BMS.
Ouvrez l'écran des réglages et cherchez les entrées Export et Import.
Choisissez Export et enregistrez le fichier.
Copiez-le en lieu sûr, par exemple dans un stockage cloud ou sur votre ordinateur.

L'emplacement du fichier dépend de votre téléphone et de la version de l'application. Guettez une boîte de dialogue d'enregistrement ou de partage qui vous laisse choisir l'emplacement. Si vous ne trouvez pas le fichier, cherchez .jkcfg sur le téléphone.

Faites une sauvegarde avant chaque mise à jour du firmware et avant chaque modification importante des réglages.

Pourquoi ne pas le modifier à la main

Un éditeur hexadécimal permet de changer n'importe quel octet, mais un fichier dont la somme de contrôle est fausse est endommagé et peut être refusé. Il faudrait aussi connaître le décalage, la taille et l'échelle de chaque champ. Les tensions sont stockées sous forme d'entiers, par exemple 3450 pour 3.45 V. Un seul octet erroné peut transformer une limite en valeur absurde.

Le fichier est binaire. Un éditeur de texte affichera des caractères illisibles et l'endommagera si vous enregistrez.

Le modifier sans risque dans le navigateur

Ouvrez l'éditeur et déposez-y votre fichier .jkcfg. Rien n'est envoyé sur un serveur. Tout se passe dans votre navigateur.
Modifiez les valeurs nécessaires. Chaque paramètre dispose d'un texte d'aide et d'une plage recommandée.
Lisez les avertissements. L'éditeur contrôle les valeurs selon les règles que le firmware JK applique à l'import, par exemple OVPR inférieure à la tension SOC-100%, elle-même inférieure à RCV.
Vous pouvez partir d'un préréglage prêt à l'emploi adapté à votre chimie et au niveau d'usure souhaité, puis l'ajuster.
Téléchargez le résultat.

L'éditeur applique uniquement les champs que vous avez modifiés sur une copie de vos octets d'origine. Les octets inconnus et réservés sont conservés. Il recalcule ensuite les deux sommes de contrôle. Consultez la référence des paramètres pour chaque champ.

Ou sans fichier : écrire en Bluetooth

Dans Chrome ou Edge sur un ordinateur ou un téléphone Android, l'éditeur peut se connecter directement au BMS. Fermez l'application JK, appuyez sur Connecter le BMS et choisissez votre BMS. L'éditeur lit les deux mêmes trames qui composent un fichier .jkcfg : tout ce qui précède fonctionne donc de la même façon.

Quand vous appuyez sur Écrire dans le BMS, l'éditeur écrit un réglage à la fois, dans un ordre que le firmware accepte, et relit le BMS après chaque étape. Pas de fichiers d'étapes à importer, pas de devinette sur la valeur qui a échoué. Les réglages absents de votre modèle sont détectés juste après la connexion et ignorés. Le guide Bluetooth détaille la marche à suivre.

Le fichier reste le bon outil pour les sauvegardes, pour Firefox, Safari et l'iPhone, et pour préparer les réglages avant l'assemblage du pack.

Réimporter le fichier

Copiez le fichier modifié sur votre téléphone.
Connectez-vous au BMS dans l'application.
Dans l'écran des réglages, choisissez Import et sélectionnez le fichier.
Vérifiez les valeurs dans l'application une fois l'opération terminée.

L'application écrit les réglages un par un, et le firmware vérifie chacun d'eux par rapport à ce que le BMS contient à cet instant. Un fichier dont les valeurs finales sont valides peut donc échouer en cours de route. C'est pourquoi l'éditeur peut vous fournir plusieurs fichiers d'étapes numérotés. Importez-les dans l'ordre, ou écrivez en Bluetooth, où l'éditeur gère l'ordre pour vous. Si vous voyez "This parameter does not apply to the connected device. (Sending failure)" (ce paramètre ne s'applique pas à l'appareil connecté, échec de l'envoi), lisez le guide sur le Sending failure.

Cas d'usage

Cloner vers un second pack. Exportez depuis le premier BMS et importez dans le second, ou ouvrez le fichier et écrivez-le dans le second BMS en Bluetooth. Vérifiez d'abord le nombre de cellules et le modèle.
Sauvegarde fiable. Conservez un fichier d'une installation qui fonctionne avant une mise à jour du firmware.
Partager des réglages. Envoyez le fichier à un autre bricoleur. Effacez d'abord les codes d'accès (voir la FAQ).
Partir de bonnes valeurs. Consultez le guide des réglages LiFePO4 pour les plages habituelles.

Erreurs fréquentes

Importer un fichier sur un pack avec un nombre de cellules différent.
Importer le fichier final d'un seul coup alors que l'éditeur a proposé plusieurs étapes.
Modifier des octets à la main et casser une somme de contrôle.
Oublier que le fichier contient vos codes d'accès.

FAQ

Puis-je modifier le fichier dans un éditeur de texte ?

Non. C'est un fichier binaire de 600 octets, un éditeur de texte le corromprait. N'utilisez un éditeur hexadécimal que si vous savez aussi corriger les deux sommes de contrôle, ou utilisez l'éditeur dans le navigateur, qui s'en charge pour vous. Voir aussi les paramètres du JK BMS expliqués pour le rôle de chaque champ.

Le fichier contient-il mon mot de passe ?

Oui, c'est possible. La trame d'informations sur l'appareil comporte des champs pour le code d'accès de l'appareil et pour le code de configuration, chacun jusqu'à 16 caractères. Traitez le fichier comme privé et videz ces champs avant de le partager. Plus de détails dans le guide sur le mot de passe.

Un fichier provenant d'un autre modèle s'importera-t-il ?

Pas de façon fiable. Le firmware refuse les valeurs qui ne s'appliquent pas à l'appareil connecté, donc des différences de nombre de cellules, de courant nominal ou de version de firmware peuvent provoquer des échecs. Certains modèles n'ont pas non plus certaines fonctions entières : un JK-B2A8S20P en firmware 19.25 n'a ni tension de floating, ni chauffage, ni réglages CAN. En Bluetooth, l'éditeur repère ces manques juste après la connexion et les ignore. Le format de fichier a été vérifié sur un JK-PB2A16S20P en firmware 19.26.

Connectez votre BMS ou ouvrez votre .jkcfg dans l'éditeur pour vérifier les valeurs avant toute écriture.

Exporter et importer les réglages JK BMS : le fichier .jkcfg