From 5b1b60dc59436132e3f6de1c4a5668cedfc3b24d Mon Sep 17 00:00:00 2001
From: Nick Ward <nickward@Nicks-MacBook-Air.local>
Date: Thu, 4 Jun 2026 00:43:39 -0600
Subject: [PATCH] Document successful JBD BMS bring-up

---
 docs/hardware-status.md | 62 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/docs/hardware-status.md b/docs/hardware-status.md
index b9056da..a4beada 100644
--- a/docs/hardware-status.md
+++ b/docs/hardware-status.md
@@ -405,3 +405,65 @@ Remaining:
 
 - DS18B20 validation after resistor installation
 
+
+## JBD/Xiaoxiang BMS Bring-Up Results
+
+### Date
+
+2026-06-04
+
+### Hardware
+
+- DGJBD / Xiaoxiang-compatible BMS
+- Bluetooth name: Greta
+- ESP32 BLE address: a5:c2:37:2c:05:dc
+- Battery capacity: 150Ah
+- Chemistry: 4S LiFePO4
+
+### BLE Discovery
+
+Status: PASS
+
+Verified BLE service and characteristics:
+
+- Service: 0xff00
+- Notify characteristic: 0xff01
+- Write characteristic: 0xff02
+- Write mode: write without response
+
+### BMS Read Test
+
+Status: PASS
+
+Verified JBD basic status command:
+
+    DD A5 03 00 FF FD 77
+
+Confirmed live values:
+
+- SOC: 70%
+- Pack voltage: 13.34V
+- Current: 0.00A
+- Remaining capacity: 104.88Ah
+- Nominal capacity: 150.00Ah
+- Cycle count: 3
+- Cell count: 4
+- Temperature: approximately 67.6°F
+
+### ESP32 Firmware Integration
+
+Status: PASS
+
+Verified:
+
+- Main firmware connects to BMS
+- BMS data is read repeatedly
+- BMS data is parsed correctly
+- Serial monitor reports live SOC, voltage, current, and remaining Ah
+
+### Notes
+
+- First BMS read after boot may time out.
+- Subsequent reads succeed consistently.
+- Current implementation reads basic pack telemetry only.
+- Cell voltage and cell delta support will require an additional JBD command.