Налаштування JK BMS можна експортувати й імпортувати функціями мобільного застосунку JK BMS. Експорт створює невеликий файл .jkcfg з усією вашою конфігурацією. Імпорт надсилає його назад у BMS. Зберігайте цей файл як резервну копію й редагуйте його лише інструментом, що виправляє контрольні суми, наприклад редактором JK Preset Studio. Якщо потрібно лише змінити налаштування, файл можна взагалі оминути й записати їх через Bluetooth прямо з браузера.

Що таке файл .jkcfg

Файл має рівно 600 байтів. Він містить два кадри по 300 байтів, ті самі, що BMS надсилає через Bluetooth.

Кадр 0 містить налаштування: напруги, струми, балансування, затримки, температури.
Кадр 1 містить дані пристрою: модель, версії апаратного забезпечення й прошивки, серійний номер, назву пристрою та поля паролів.

Останній байт кожного кадру - контрольна сума. Це сума попередніх 299 байтів, обрізана до одного байта. Якщо контрольна сума не збігається з даними, файл пошкоджено.

Розмітка походить з open-source проєкту syssi/esphome-jk-bms, який документує протокол JK02_32S. Приклад файлу в репозиторії JK Preset Studio експортовано з JK-PB2A16S20P на прошивці 19.26.

Експорт та імпорт налаштувань JK BMS: спершу зробіть копію

Назви пунктів меню в застосунку можуть відрізнятися між версіями, тож вважайте ці кроки орієнтиром.

Підключіться до BMS у застосунку JK BMS.
Відкрийте екран налаштувань і знайдіть пункти Export та Import.
Оберіть Export і збережіть файл.
Скопіюйте його в надійне місце, наприклад у хмару чи на комп'ютер.

Де саме зберігається файл, залежить від телефона й версії застосунку. Стежте за вікном збереження чи поширення, де можна обрати місце. Якщо файл не знаходиться, пошукайте на телефоні .jkcfg.

Робіть копію перед кожним оновленням прошивки й перед кожною великою зміною налаштувань.

Чому не варто редагувати вручну

Hex-редактор дозволяє змінити будь-який байт, але файл із хибною контрольною сумою пошкоджений і може бути відхилений. Вам також довелося б знати зміщення, розмір і масштаб кожного поля. Напруги зберігаються цілими числами, наприклад 3450 для 3.45 В. Один хибний байт може перетворити межу на нісенітницю.

Файл бінарний. Текстовий редактор покаже абракадабру й пошкодить файл, якщо зберегти.

Безпечне редагування в браузері

Відкрийте редактор і перетягніть на нього файл .jkcfg. Нічого не завантажується на сервер. Уся робота відбувається у вашому браузері.
Змініть потрібні значення. Кожен параметр має довідку й рекомендований діапазон.
Прочитайте попередження. Редактор перевіряє значення за правилами, які прошивка JK застосовує під час імпорту, наприклад OVPR нижче за напругу SOC-100%, яка нижче за RCV.
За бажання почніть з готового пресета для вашої хімії та рівня зносу, а потім підправте.
Завантажте результат.

Редактор змінює лише поля, які ви правили, на копії ваших початкових байтів. Невідомі й зарезервовані байти зберігаються. Потім він перераховує обидві контрольні суми. Усі поля дивіться в довіднику параметрів.

Або без файлу: запис через Bluetooth

У Chrome чи Edge на комп'ютері або Android-телефоні редактор може підключитися до BMS напряму. Закрийте застосунок JK, натисніть «Підключити BMS» і виберіть свою BMS. Редактор читає ті самі два кадри, з яких складається файл .jkcfg, тож усе описане вище працює так само.

Коли ви натискаєте «Записати в BMS», редактор записує по одному параметру в порядку, який приймає прошивка, і перечитує BMS після кожного кроку. Жодних файлів кроків для імпорту й жодного вгадування, яке значення не пройшло. Параметри, яких немає у вашій моделі, виявляються одразу після підключення й пропускаються. Покроково це описано в статті про Bluetooth.

Файл і далі потрібен для резервних копій, для Firefox, Safari й iPhone, а також щоб підготувати налаштування ще до складання батареї.

Імпорт файлу назад

Скопіюйте відредагований файл на телефон.
Підключіться до BMS у застосунку.
На екрані налаштувань оберіть Import і виберіть файл.
Після завершення перевірте значення в застосунку.

Застосунок записує налаштування по одному, а прошивка перевіряє кожне за тим, що BMS має на цей момент. Файл із правильними кінцевими значеннями все одно може впасти посередині. Тому редактор може запропонувати кілька нумерованих файлів кроків. Імпортуйте їх по черзі або запишіть через Bluetooth, де порядок редактор бере на себе. Якщо бачите "This parameter does not apply to the connected device. (Sending failure)", прочитайте статтю про помилку відправки налаштувань.

Сценарії використання

Клонування на другу батарею. Експортуйте з першої BMS й імпортуйте у другу або відкрийте файл і запишіть його в другу BMS через Bluetooth. Спершу перевірте кількість комірок і модель.
Перевірена резервна копія. Зберігайте файл з робочого налаштування перед оновленням прошивки.
Обмін налаштуваннями. Надішліть файл іншому майстру. Спершу приберіть паролі (див. запитання нижче).
Старт із добрих значень. Типові діапазони дивіться в статті про налаштування для LiFePO4.

Типові помилки

Імпорт файлу на батарею з іншою кількістю комірок.
Імпорт фінального файлу одразу, коли редактор запропонував кілька кроків.
Редагування байтів вручну із зіпсованою контрольною сумою.
Забуті паролі, які містить файл.

Часті запитання

Чи можна редагувати файл у текстовому редакторі?

Ні. Це бінарний файл на 600 байтів, тож текстовий редактор його зіпсує. Використовуйте hex-редактор, лише якщо вмієте виправити обидві контрольні суми, або браузерний редактор, який робить це за вас. Що робить кожне поле, дивіться в статті параметри налаштування JK BMS.

Чи містить файл мій пароль?

Так, може. Кадр даних пристрою має поля для пароля пристрою й пароля налаштувань, кожне до 16 символів. Вважайте файл приватним і очищайте ці поля перед поширенням. Докладніше в статті про пароль.

Чи імпортується файл з іншої моделі?

Не гарантовано. Прошивка відхиляє значення, що не стосуються підключеного пристрою, тож різниця в кількості комірок, номінальному струмі чи версії прошивки може спричинити помилки. Деяким моделям також бракує цілих функцій: JK-B2A8S20P на прошивці 19.25 не має напруги float, підігріву й налаштувань CAN. Через Bluetooth редактор знаходить ці прогалини одразу після підключення й пропускає їх. Формат файлу перевірено на JK-PB2A16S20P із прошивкою 19.26.

Підключіть свою BMS або відкрийте .jkcfg у редакторі, щоб перевірити значення, перш ніж щось буде записано.

Як зберегти налаштування JK BMS: експорт, імпорт і файл .jkcfg