How v0l/battery-control works
battery_control unifies battery, BMS, monitor, and power-station devices behind an async Battery trait and normalized status, capability, and command types. The primary workflow discovers or identifies a device, uses a backend adapter to obtain status or execute supported controls, then presents results through the CLI or bench UI. The README documents the breadth of backends and UI capabilities; several backend implementations are unsampled, so their internal protocol flows are not expanded here.
Main entry points: battery.rs Battery Trait · types.rs Status and Commands · main.rs Battery CLI · worker.rs Device Worker
Components 21
User Interfaces
- Battery CLI
src/bin/battery/main.rs - CLI Output
src/bin/battery/output.rs
Unified Battery API
- Device Discovery
src/discovery.rs - Battery Trait
src/battery.rs - Capabilities
src/capabilities.rs - Status and Commands
src/types.rs - Pairing State
src/auth.rs
Backend Adapters
- Anker Adapter
src/backends/anker.rs - JK Adapter
src/backends/jk.rs - JBD Adapter
src/backends/jbd.rs - Pylontech CAN
src/backends/pylontech.rs - Victron Adapter
src/backends/victron.rs - Other Adapters
src/backends
Device Protocols
- JK Pack Model
crates/jk_bms/src/pack.rs - JK BMS Logic
crates/jk_bms/src/bms.rs - EcoFlow Packets
crates/ecoflow/src/packet.rs - EcoFlow Curve Crypto
crates/ecoflow/src/secp160r1.rs
Bench UI
- Bench Window
crates/ui/src/main.rs - Device Worker
crates/ui/src/worker.rs - Demo Battery
crates/ui/src/demo.rs
Other components
- User
Connections 24
- User → Battery CLI: runs commands
README.md - Battery CLI → Device Discovery: discovers devices
src/bin/battery/main.rs - Battery CLI → Battery Trait: reads or controls
src/bin/battery/main.rs - Battery CLI → CLI Output: formats results
src/bin/battery/main.rs - Battery Trait → Status and Commands: uses normalized types
src/lib.rs - Battery Trait → Capabilities: gates controls
src/lib.rs - Anker Adapter → Battery Trait: implements
src/backends/anker.rs - Anker Adapter → Status and Commands: maps telemetry
src/backends/anker.rs - Anker Adapter → Pairing State: handles pairing
src/backends/anker.rs - JK Adapter → Battery Trait: implements
src/backends/jk.rs - JK Adapter → Status and Commands: maps device state
src/backends/jk.rs - JBD Adapter → Battery Trait: implements
src/backends/jbd.rs - JBD Adapter → Status and Commands: maps device state
src/backends/jbd.rs - Pylontech CAN → Battery Trait: implements
README.md - Pylontech CAN → Status and Commands: normalizes readings
README.md - Victron Adapter → Battery Trait: implements
README.md - Other Adapters → Battery Trait: adapt device families
README.md - JK Pack Model → JK BMS Logic: models pack for
crates/jk_bms/src/module.rs - EcoFlow Packets → EcoFlow Curve Crypto: supports session protocol
- User → Bench Window: uses bench window
README.md - Bench Window → Device Worker: dispatches commands
crates/ui/src/main.rs - Device Worker → Device Discovery: scans devices
crates/ui/src/worker.rs - Device Worker → Battery Trait: reads and controls
crates/ui/src/worker.rs - Device Worker → Demo Battery: uses demo mode
crates/ui/src/worker.rs