Les messages du log JK BMS sont de courtes chaînes fixes comme Boot, Time calibration ou Cell 01 over charge protection. Ce guide explique ce que chacune signifie et lesquelles indiquent un vrai problème. Les noms viennent de la table de messages utilisée par le firmware, telle que la liste le projet open source esphome-jk-bms. Le BMS écrit ces messages en anglais, ils restent donc en anglais ici, avec une courte explication en français.

Si vous voulez seulement une réponse pour votre propre fichier, déposez-le dans la page d'analyse des logs. Elle regroupe les messages pour vous. Les sections ci-dessous expliquent ce qu'elle regroupe.

D'où viennent les messages du log JK BMS

Les messages sont la colonne de texte du Detail Log. Le BMS écrit une ligne par événement, et chaque ligne porte un instantané de la batterie : états des MOS, cellule la plus haute et la plus basse, tensions, intensité, capacité et températures. L'export du fichier et la lecture des autres colonnes sont décrits dans exporter et lire le Detail Log du JK-BMS.

Le texte n'est pas normalisé. Le même type d'événement est orthographié différemment selon les endroits, et la page d'analyse reconnaît les messages par motif et non par chaîne exacte. Quand cela compte, c'est signalé plus bas.

Messages d'alimentation et d'horloge

Boot : le BMS a démarré. Les colonnes de tension et d'intensité sont à zéro, et elles semblent écrites avant toute mesure. Voir lire les redémarrages et les événements d'alimentation.
Shutdown : le BMS s'est éteint lui-même.
Enter sleep : le BMS est entré en veille. Les options de veille sont dans les réglages, parmi les champs de veille intelligente.
Reset Watch-Dog : le chien de garde interne a redémarré le BMS. Contrairement aux trois précédents, c'est un défaut. Un cas isolé mérite une note, des cas répétés méritent une enquête.
Time calibration : écrit quand une app se connecte et règle l'horloge. Il marque vos propres sessions et n'est pas un défaut. La page d'analyse masque ces lignes par défaut.

Les lignes datées d'avant 2021, le plus souvent 2020-01-01, ont été écrites avant le réglage de l'horloge. Ce sont de vrais événements à l'heure inconnue.

Messages de commutation

Ils indiquent qui a activé ou coupé la charge ou la décharge, et expliquent donc pourquoi l'état d'un MOS a changé sans protection.

APP open charge, APP close charge, APP open discharge, APP close discharge : vous ou quelqu'un d'autre avez utilisé l'app JK.
Remote open charge, Remote close charge, Remote open discharge, Remote close discharge : la même chose par une commande à distance.
RS485 charge on, RS485 charge off, RS485 discharge on, RS485 discharge off, et les équivalents CAN : un onduleur ou un contrôleur sur le bus a commuté le MOS. RS485 power off est un message à part.
Button to turn it off et APP to turn it off : le BMS a été éteint par le bouton d'alimentation ou depuis l'app. Un Boot qui suit peu après est attendu, pas un redémarrage surprise.
Manually enable the emergency mode, Manually turn off the emergency mode, Turn off the emergency mode automatically : changements du mode d'urgence. Button Emergency On, Button Emergency Off, Remote Emergency On et Remote Emergency Off sont la même idée avec la source nommée.
Button Forced Heating : le chauffage a été forcé avec le bouton.

Coupures et réarmements de protection

Une coupure signifie que le BMS a coupé la charge ou la décharge. La plupart des coupures ont une ligne de réarmement quand la valeur revient. Le libellé du réarmement varie : "is released", "released" ou "Release", et "over-temperature" ou "over temperature". C'est pourquoi Charge over temperature protection is released et Discharge over-temperature protection is released semblent incohérents.

Tension : Cell overcharge protection et Battery overcharge protection, Cell undervoltage protection et Battery undervoltage protection. Certains fichiers nomment la cellule, comme Cell 01 over charge protection ou Cell 03 over discharge protection. L'analyse lit les numéros de cellule de 01 à 32. Voir pourquoi la protection de surcharge des cellules se déclenche sans cesse pour le cas le plus courant.
Courant : Charge overcurrent protection, Discharge overcurrent protection, et les étages Discharge OCP II et Discharge OCP III. Les limites et les délais sont dans surintensité et court-circuit.
Court-circuit : Charge short circuit protection, Discharge short circuit protection, Discharge level 2 short circuit protection. La page d'analyse les juge critiques. SCP Release Failed signifie que le BMS n'a pas pu réarmer la protection contre les courts-circuits, ce qui est aussi traité comme critique.
Température : Charge over temperature protection, Charge low temperature protection, Discharge over temperature protection, Discharge under temperature protection et MOS over temperature protection, chacune avec un réarmement.

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

Messages de défaut

Les défauts ne sont pas de simples protections. Ils décrivent quelque chose d'anormal dans le BMS ou son câblage, et la page d'analyse les juge critiques.

Abnormal current sensor et Abnormal coprocessor communication : défauts internes. Leurs lignes de réarmement sont Abnormal release of current sensor et Abnormal cancellation of coprocessor communication.
Charge MOS abnormal et Discharge MOS abnormal : le BMS a détecté un problème sur un MOS.
Discharge On Failed : le BMS a tenté d'activer la décharge et cela n'a pas fonctionné. Le message seul ne donne pas la cause. Regardez les lignes autour, car une protection encore active serait une explication.
Cells Count Incorrect : le nombre de cellules vu par le BMS ne correspond pas à son réglage. Comparez-le avec le nombre de cellules dans l'éditeur.

Messages de configuration

Factory setting LION, Factory setting LFP, Factory setting LTO : les réglages ont été remis à un jeu d'usine pour cette chimie. Toutes vos valeurs ont changé d'un coup, vérifiez-les.
Unknown Log Code [0] : pas un vrai événement. Il semble s'agir de l'enregistrement périodique que le BMS écrit quand le stockage de données à intervalle est actif, et la page d'analyse le masque par défaut. Si votre fichier en contient des milliers, vérifiez la période de stockage des données.
Unknown Log Code [5], [10] et d'autres numéros : des codes que la table ne nomme pas. La page d'analyse les liste comme inconnus et ne peut pas dire non plus ce qu'ils signifient.

Lire plus vite

Lire un long fichier à la main est lent. La page d'analyse des logs range les messages en familles (alimentation, commutateurs, chaque type de protection, défauts, configuration), associe les coupures à leurs réarmements et compte les coupures par cellule. Elle masque les lignes de synchro d'horloge et périodiques jusqu'à ce que vous les demandiez. Tout se passe dans votre navigateur et le fichier n'est pas envoyé.

Commencez par les défauts et les lignes critiques, puis regardez les coupures qui se répètent.

Messages du log JK BMS expliqués : Boot, Time calibration, protections