Skip to content

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BMS Data Platform

Read-only monitoring for JK/Jikong BMS. An Android phone works as the Bluetooth gateway and local logger; the Windows dashboard provides a large-screen view, history and diagnostics over the local Wi-Fi network.

Latest release: 0.7.38 · Download APK and Windows package · English user manual (PDF) · Русское руководство (PDF)

Desktop overview

What it is for

The phone stays near the battery, maintains the BLE connection, and records telemetry locally. A computer, tablet or TV on the same Wi-Fi network can open the dashboard in a browser or use the Windows monitor. No cloud account is required.

Included

  • BMS Gateway 0.4.11 (Android 8.0+) — BMS scanning and manual selection, live telemetry, automatic reconnect, up to 32 cells, local history, CSV export, local Wi-Fi API and separately armed active-test records.
  • BMS Data Platform 0.7.38 (Windows x64) — overview, energy flow, configurable history charts, incremental phone-to-PC history synchronisation, separate local battery profiles and long-term cell diagnostics.
  • Complete English, Ukrainian and Russian interfaces.

Screenshots

Android gateway Windows overview
Android gateway Windows overview
Phone Wi-Fi gateway History and diagnostics
Phone Wi-Fi gateway History charts

Desktop connection

Compatibility and safety

The gateway supports JK/Jikong telemetry variants based on JK02 and JK04 protocols, including many 8S–32S models. Firmware and Bluetooth naming vary, so reports from untested BMS models are welcome.

Normal monitoring is read-only and never changes BMS protection parameters. A separately armed experimental diagnostic can briefly switch Charge MOS off and restore it to estimate cell resistance from two current edges; it requires physical permission on the phone, positive stable charge current and user confirmation. Bluetooth discovery may require Android system Location to be enabled, although the app does not read or store location. Close the official JK app before connecting because a BMS normally accepts one active Bluetooth client at a time.

Quick start

  1. Install the Android APK on a phone placed near the battery.
  2. Enable Bluetooth and, if Android requests it, system Location. Scan and select the required BMS.
  3. Connect the phone and computer to the same Wi-Fi network.
  4. Enable the phone Wi-Fi gateway and copy its local address.
  5. Enter that address on the Windows monitor connection page.

Downloads

New in 0.7.38 / Gateway 0.4.11: separate battery history profiles, two temperature sensors, battery-specific exports, clearer cell-chart colours and strict desktop/gateway compatibility checks. See the bilingual release notes. The read-only external monitoring API remains available.


Русская версия

BMS Data Platform — система мониторинга JK/Jikong BMS только для чтения. Телефон находится рядом с аккумулятором, поддерживает Bluetooth-связь и записывает историю. Компьютер, планшет или телевизор в той же Wi-Fi-сети отображает данные через браузер или Windows-монитор.

Последняя версия: 0.7.38 · Скачать APK и Windows-архив · Полное руководство на русском (PDF) · English manual (PDF)

Возможности

Новое в 0.7.38 / Gateway 0.4.11: отдельная история для каждого аккумулятора, два датчика температуры, выбор аккумулятора при экспорте, пояснение цветов графика ячеек и проверка совместимости частей программы. Подробное описание изменений. API внешнего мониторинга только для чтения сохранён.

  • BMS Gateway 0.4.11 для Android 8.0+ — поиск и ручной выбор BMS, текущие параметры, автопереподключение, до 32 ячеек, локальная история, экспорт CSV, локальный Wi-Fi API и отдельно разрешаемые активные тесты.
  • BMS Data Platform 0.7.38 для Windows x64 — обзор батареи, поток энергии, графики истории, дозагрузка данных с телефона, отдельные профили аккумуляторов и долговременная диагностика ячеек.
  • Полностью переведённые интерфейсы: русский, английский и украинский.

Подключение

  1. Установите APK на телефон и разместите его рядом с аккумулятором.
  2. Включите Bluetooth и, если требует Android, системную геолокацию. Выполните сканирование и выберите нужную BMS.
  3. Подключите телефон и компьютер к одной Wi-Fi-сети.
  4. Включите Wi-Fi-шлюз на телефоне и скопируйте показанный локальный адрес.
  5. Введите адрес на странице подключения Windows-монитора.

Важно

Обычный мониторинг работает только в режиме чтения и не изменяет защитные параметры BMS. Отдельно разрешаемая экспериментальная диагностика может кратковременно отключить и восстановить Charge MOS для оценки сопротивления по двум фронтам тока. Для неё нужны физическое разрешение на телефоне, положительный стабильный ток заряда и подтверждение пользователя. Геолокация нужна некоторым версиям Android для обнаружения BLE, но приложение не читает и не сохраняет координаты. Перед подключением закройте официальное приложение JK: одна BMS обычно принимает только одного Bluetooth-клиента.

Скачать

Проект находится в публичном тестировании. Если ваша BMS не подключается, сообщите модель, прошивку, имя Bluetooth-устройства и версию Android.

About

Android phone gateway and Windows dashboard for long-term JK/Jikong BMS monitoring

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages