{"id":50597552,"url":"https://github.com/dionipe/jk-bms-esp32-cyd","last_synced_at":"2026-06-05T15:30:58.060Z","repository":{"id":359938933,"uuid":"1246301710","full_name":"dionipe/jk-bms-esp32-cyd","owner":"dionipe","description":"ESP32-2432S028R — JK BMS Bluetooth ","archived":false,"fork":false,"pushed_at":"2026-05-24T07:04:19.000Z","size":391,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T09:10:53.734Z","etag":null,"topics":["bms","jikong-bms"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dionipe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-22T04:12:59.000Z","updated_at":"2026-05-24T07:04:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dionipe/jk-bms-esp32-cyd","commit_stats":null,"previous_names":["dionipe/jk-bms-esp32-cyd"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dionipe/jk-bms-esp32-cyd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dionipe%2Fjk-bms-esp32-cyd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dionipe%2Fjk-bms-esp32-cyd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dionipe%2Fjk-bms-esp32-cyd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dionipe%2Fjk-bms-esp32-cyd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dionipe","download_url":"https://codeload.github.com/dionipe/jk-bms-esp32-cyd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dionipe%2Fjk-bms-esp32-cyd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33949038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bms","jikong-bms"],"created_at":"2026-06-05T15:30:57.145Z","updated_at":"2026-06-05T15:30:58.004Z","avatar_url":"https://github.com/dionipe.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESP32-2432S028R — JK BMS \u0026 ANT BMS Bluetooth Monitor\n\nMonitor baterai **JK BMS** dan **ANT BMS** via Bluetooth Low Energy (BLE), ditampilkan pada layar sentuh TFT 2.8\" bawaan board **ESP32-2432S028R** (Cheap Yellow Display / CYD).\n\n## Fitur Utama\n\n- **Splash screen** animasi boot dengan countdown 3 detik sebelum BLE scan dimulai\n- **Scan BLE otomatis** selama 8 detik, lalu langsung masuk daftar perangkat — mendeteksi **JK BMS** dan **ANT BMS** secara bersamaan\n- **Auto-rescan** setiap 12 detik dari layar pilih perangkat\n- **3 halaman display** yang dapat berpindah dengan tap layar:\n  - **Halaman 1 – Utama**: voltase total, arus, SOC, suhu MOS/baterai, kapasitas, siklus, status charging/discharging/balancing\n  - **Halaman 2 – Voltase Sel**: grid 3 kolom dengan voltase tiap sel, warna-kode diferensial\n  - **Halaman 3 – Resistansi Sel**: grid 3 kolom dengan resistansi internal tiap sel (mΩ), hanya tersedia untuk protokol lama JK (55AAEB90)\n- **Dukungan dua protokol JK BMS**:\n  - Protokol baru TLV `4E57` (JK02 standar BLE)\n  - Protokol lama fixed-frame `55AAEB90` (JK01 / variant firmware)\n- **Dukungan legacy RS485 bridge (`EB90`)** untuk balancer JK yang merespons ACK pendek `FC xx 06`\n- **Dukungan ANT BMS** via protokol `7E A1` (CRC-16/Modbus) — voltase sel, arus, SOC, suhu, kapasitas, status charging/discharging/balancing\n- **Auto-deteksi offset** data resistansi antar varian firmware\n- **LED RGB** indikator status koneksi\n- **Watchdog \u0026 reconnect** otomatis jika koneksi BLE putus\n\n## Hardware\n\n| Komponen | Spesifikasi |\n|---|---|\n| Board | ESP32-2432S028R (CYD) |\n| MCU | ESP32 dual-core 240 MHz |\n| Display | ILI9341 2.8\" TFT 240×320, SPI (HSPI) |\n| Touchscreen | XPT2046, SPI (VSPI) |\n| LED | RGB LED (active low) |\n| Wireless | BLE via NimBLE |\n\n### Pinout\n\n| Komponen | Pin |\n|---|---|\n| TFT MOSI | GPIO 13 |\n| TFT MISO | GPIO 12 |\n| TFT CLK  | GPIO 14 |\n| TFT CS   | GPIO 15 |\n| TFT DC   | GPIO 2  |\n| TFT BL (Backlight) | GPIO 21 |\n| LED Merah | GPIO 4 |\n| LED Hijau | GPIO 16 |\n| LED Biru  | GPIO 17 |\n| Touch CS  | GPIO 33 |\n| Touch IRQ | GPIO 36 |\n\n## Protokol BMS yang Didukung\n\n### JK BMS — Protokol Baru `4E57` (JK02)\n- BLE Service UUID: `0000ffe0-0000-1000-8000-00805f9b34fb`\n- Notify: `FFE1` · Write: `FFE2`\n- Frame header: `4E 57` (TLV tag-length-value)\n- Data: voltase sel, arus, SOC, suhu, kapasitas, alarm, status MOSFET\n\n### JK BMS — Protokol Lama `55AAEB90` (JK01 / Variant)\n- Frame header: `55 AA EB 90`\n- Frame type `0x02`: data sel (voltase + resistansi internal per sel)\n- Resistansi sel: offset auto-detected, unit mΩ (nilai raw = mΩ langsung)\n- Data tambahan: suhu, arus, SOC, kapasitas, alarm\n\n### JK Legacy RS485 Bridge — `55AA ..` request / `EB90 ..` response\n- Request host: `55 AA \u003caddr\u003e FF 00 00 \u003cchecksum\u003e`\n- Response slave: `EB 90 \u003caddr\u003e FF ...` dengan panjang tetap 74 byte\n- ACK pendek legacy `FC xx 06` dideteksi sebagai sinyal valid; firmware akan memicu poll lanjutan otomatis\n- ACK `FC xx 06` diproses di level notify (termasuk karakteristik bridge seperti `FF12`) dan tetap terdeteksi saat fragment/campur paket\n- Probe alamat legacy mencakup `0x81`, `0x00`, `0x01`, `0x02`, `0x10` untuk kompatibilitas varian modul BLE-RS485\n- Parser `EB90` mengekstrak voltase total, jumlah sel, voltase per-sel, flag balancing, dan alarm\n\nCatatan checksum request RS485:\n- checksum dihitung sebagai penjumlahan byte `55 AA \u003caddr\u003e FF 00 00` (mod 256)\n- contoh untuk alamat `0x81`: request valid adalah `55 AA 81 FF 00 00 7F`\n\n### ANT BMS — Protokol `7E A1`\n- BLE Service UUID: `0000ffe0-0000-1000-8000-00805f9b34fb`\n- Notify \u0026 Write: `FFE1` (satu karakteristik untuk dua arah)\n- Frame header: `7E A1` · Response type: `0x11`\n- CRC: CRC-16/Modbus atas byte payload\n- Request: 10-byte command `7E A1 01 00 00 BE 18 55 AA 55`\n- Data: voltase tiap sel (LE uint16, mV), suhu sensor, suhu MOS, voltase total, arus, SOC, status charging/discharging/balancing, kapasitas\n- Deteksi perangkat: nama BLE mengandung `\"ANT\"` atau `\"ant\"`\n\n## Persyaratan\n\n- [PlatformIO IDE](https://platformio.org/) (extension VS Code)\n- Board ESP32-2432S028R terhubung via USB\n- JK BMS **atau** ANT BMS dengan BLE aktif\n\n## Build \u0026 Upload\n\n```bash\n# Build\npio run\n\n# Build dan upload ke board\npio run --target upload\n\n# Buka serial monitor (115200 baud)\npio device monitor --baud 115200\n```\n\nAtau gunakan tombol **Upload** (→) di toolbar PlatformIO VS Code.\n\n## Struktur Proyek\n\n```\nESP32-2432S028R/\n├── src/\n│   └── main.cpp          # Firmware utama\n├── platformio.ini        # Konfigurasi build PlatformIO\n├── README.md\n└── CHANGELOG.md\n```\n\n## Serial Monitor\n\nBuka serial monitor 115200 baud untuk melihat log diagnostik, termasuk:\n- Proses BLE scan dan koneksi\n- Parsed data dari BMS setiap frame\n- Auto-deteksi offset resistansi (`[OldProto] finalOffset=...`)\n- Outlier correction C01 jika aktif (`[OldProto] C01 outlier ...`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdionipe%2Fjk-bms-esp32-cyd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdionipe%2Fjk-bms-esp32-cyd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdionipe%2Fjk-bms-esp32-cyd/lists"}