Le Detail Log du JK-BMS est une longue liste d'événements, chacun accompagné d'un instantané de la batterie à ce moment. Il indique quand le BMS a coupé la charge ou la décharge, quelle cellule en est la cause, et la tension, l'intensité et la température du moment. Exportez-le depuis l'app JK en fichier texte, puis lisez-le à la main ou ouvrez-le dans la page d'analyse des logs, qui associe chaque coupure à son réarmement et désigne la cause probable.

Ce qu'est le Detail Log

L'app l'exporte en fichier nommé par exemple detaillogs-20261001171819.txt, avec la date et l'heure de l'export dans le nom. Malgré l'extension, c'est un CSV : la première ligne contient les noms de colonnes, chaque autre ligne est un événement.

Une ligne d'événement contient l'heure, le message (par exemple "Cell 01 over charge protection"), l'état des MOS, de l'équilibreur et du chauffage, les numéros et tensions des cellules la plus haute et la plus basse, la tension du pack, l'intensité, les capacités restante et pleine, les températures et le courant de chauffage.

Les firmwares anciens gardent une courte liste d'environ 50 événements, réécrite en boucle. Le Detail Log est un enregistrement distinct et plus long, écrit par le BMS lui-même : il couvre des jours ou des semaines sans rien de connecté.

L'exporter depuis l'app

Connectez-vous au BMS dans l'app JK en Bluetooth.
Ouvrez l'écran de l'appareil et cherchez la section des logs (les noms de menu varient selon la version).
Choisissez le Detail Log et exportez-le. L'app enregistre un fichier .txt.
Envoyez le fichier vers votre ordinateur ou ouvrez-le sur le téléphone.

Lire les colonnes

Quelques détails prêtent à l'erreur.

Les numéros de cellule dans le texte du message commencent à 1, donc "Cell 01" est la première cellule. Les colonnes de cellule max et min commencent à 0, il faut donc ajouter 1 pour comparer. Les deux ne concordent pas toujours : l'instantané peut être en retard sur l'événement, si bien que la cellule nommée dans le message n'est pas toujours celle que la colonne affiche à ce moment. Dans l'exemple, les lignes "Cell 01" affichent 0 dans la colonne de cellule max sur seulement 366 des 1083 lignes.
Les lignes Boot contiennent des zéros dans les colonnes de tension et d'intensité. Le BMS n'avait encore rien mesuré quand il les a écrites.
Les lignes d'étalonnage de l'heure apparaissent quand l'app règle l'horloge à la connexion. Ce n'est pas un défaut.
Les lignes datées d'avant 2021, souvent 2020-01-01, signifient que l'horloge n'était pas encore réglée. Ce sont de vrais événements à l'heure inconnue, que l'analyse écarte des calculs de durée.
Les tensions à une seule décimale (anciens exports) sont trop grossières pour juger un écart entre cellules.
La page d'analyse accepte des fichiers jusqu'à 10 Mo et supprime les lignes en double espacées de moins de 2 secondes.

Familles de messages

Les messages se répartissent en groupes.

Coupures de protection et réarmements : surtension, sous-tension, surintensité en charge et en décharge, court-circuit, sur-température et sous-température en charge et en décharge, et sur-température des MOS. Chaque coupure a normalement une ligne de réarmement.
Actions de l'utilisateur et de l'app : bouton d'alimentation, interrupteur d'urgence, extinction par l'app.
Commutateurs distants : l'app, le RS485 ou le CAN activent ou coupent la charge ou la décharge.
Événements d'alimentation : Boot, arrêt et veille.
Défauts : états anormaux (mauvais nombre de cellules, erreur du coprocesseur, panne de MOS).

Les coupures de surtension et de sous-tension nomment la cellule, le détail le plus utile du fichier.

Épisodes de protection

Une coupure et son réarmement forment un épisode. Le temps qui les sépare est la durée de la protection. Le temps entre le réarmement et la coupure suivante du même type est le délai avant nouvelle coupure.

Les épisodes expliquent pourquoi un seul problème peut produire mille lignes. Si un chargeur pousse sans cesse une cellule au-dessus de la limite, le BMS coupe, réarme après une pause, puis coupe de nouveau. Chaque boucle ajoute deux lignes.

Une ligne Boot ferme tout épisode ouvert, car le BMS a perdu son état. Une coupure sans réarmement avant la fin du fichier reste ouverte.

Diagnostics courants

Voici les motifs recherchés par la page d'analyse, avec ses chiffres.

Chargeur au-dessus de la limite des cellules (tension du chargeur trop élevée). Le log d'exemple compte 1090 coupures de surtension, dont 1083 sur la cellule 01, avec un écart entre la cellule la plus haute et la plus basse le plus souvent sous 10 mV. Les cellules sont donc équilibrées et c'est le chargeur qui tient la batterie trop haut ; pourquoi la protection de surcharge des cellules se déclenche sans cesse donne les chiffres et le remède.

Cellule faible en haut. Si au moins 80 % des coupures nomment la même cellule et que l'écart atteint 50 mV ou plus, cette cellule est le problème. Vérifiez d'abord l'écart, car la cellule nommée seule peut tromper. Consultez les réglages d'équilibrage et contrôlez la cellule et son câblage. Pour le motif dans les données, voir repérer une cellule faible dans le log.

Sous-tension. Même distinction en bas : une cellule très en dessous des autres est une cellule faible, un écart serré désigne une batterie vide, souvent à cause d'un seuil de coupure de l'onduleur trop bas. Comparez Cell UVP et SOC-0% voltage avec l'arrêt de l'onduleur.

Cyclage. Dix coupures de surtension ou plus, avec un délai médian avant nouvelle coupure sous 60 s, sont signalées comme du cyclage. Examinez Cell OVP recovery et Cell RCV.

Température et court-circuit. Les coupures de température montrent la valeur de pointe. Une température des MOS de 70 °C ou plus sans coupure est signalée comme un avertissement. Toute coupure pour court-circuit est critique. Vérifiez la charge, le câblage et le délai décrit dans surintensité et court-circuit.

Redémarrages inattendus. Une ligne Boot qui ne suit pas une ligne d'extinction ou d'arrêt dans les 60 s est comptée comme inattendue. L'exemple compte 7 Boot, dont 2 inattendus, car les cinq autres suivent une ligne "Button to turn it off". Vérifiez l'alimentation et le câblage du BMS, et voyez lire les redémarrages et les événements d'alimentation.

Changements de capacité. Si la capacité pleine change dans le log, par exemple de 200 Ah à 334 Ah, quelqu'un a modifié le réglage de capacité. Voir l'étalonnage du SOC pour le suivi de la capacité restante.

Analyser votre log dans le navigateur

Ouvrez la page d'analyse des logs et déposez le fichier .txt. Il est lu dans votre navigateur, jamais envoyé. Vous obtenez les épisodes, les coupures par cellule et les constats ci-dessus.

Vous pouvez joindre un export .jkcfg du même BMS. La page trace vos seuils sur les graphiques et recoupe le log avec eux : tension de coupure face à Cell OVP, nombre de cellules, capacité, consigne du chargeur face à cellules × Cell RCV, courant de pointe proche des limites de surintensité, et température des MOS proche de la limite des MOS. Corrigez ses constats dans l'éditeur, idéalement en écrivant les modifications en Bluetooth, et consultez JK BMS Sending failure si le BMS refuse un fichier importé.

Exporter et lire le Detail Log du JK-BMS