Bank SOC
Pace BMS Monitor
Live battery status, configuration, backups and diagnostics for the Home Assistant add-on.
Read-only BMS
No Live Data
User view
Use this page for daily confidence: battery percentage, operating state, power flow, capacity, health, temperature and active warnings.
Historical trends
Use this page to review local SQLite history from the monitor-owned live snapshot. This page is read-only and does not publish MQTT or send BMS commands.
History Trends
Local serial-first history. Charts refresh every 10 seconds while this tab is open.
Visible Samples
No data
Oldest Sample
No data
Newest Sample
No data
View
Bank
Battery Power
Average Pack Voltage
Worst Cell Delta
Setup and installer checks
Use this page for first-run validation, MQTT/Telegram tests and Full Monitoring dry checks. These tools do not send BMS write or control commands.
Setup Tests
These checks validate external services and configuration only. No BMS commands are sent.
Setup Checklist
Basic Required serial setup is ready; finish optional MQTT/Telegram monitoring items.
7 / 10 ready
BMS Serial
Ready
Serial connection is configured.
MQTT
Ready
MQTT host and port are configured.
Home Assistant Discovery
Enabled
Home Assistant can auto-create MQTT entities.
Retained State
Enabled
MQTT retains latest values for HA fallback.
Monitor Seen
Waiting
Start the add-on and confirm monitor state appears.
BMS Reads
Waiting
Waiting for a successful analog read from the BMS.
Battery Layout
Auto
No expected pack/cell count is configured; using detected BMS layout.
Telegram
Needs setup
Set a real Telegram bot token/chat ID or disable notify_enabled.
Warning Noise Control
Ready
Severity-aware warning repeat intervals are configured.
Local History
Ready
Latest sample: 2026-06-29 01:10:15
Admin / installer view
Use this page to edit add-on options, notification thresholds, Telegram settings and report schedules. Configuration changes may require restart, but they do not write settings to the BMS.
Editable Add-on Configuration
Saves Home Assistant add-on options only. This does not write to the BMS. Restart the add-on after saving changes that affect runtime.
Choose which configuration sections to show.
Backups: 2 / 10
Latest: 2026-06-03 15:54:23
Format Help
Multiple threshold format: use comma-separated numbers only.
Example:
50,25,10. Do not add percentage signs.
Time format: use 24-hour
HH:MM format.
Examples: 19:00, 10:15, 00:00.
Admin backup view
Use this page to compare, download and restore add-on configuration backups. Restores change Home Assistant add-on options only and do not write to the BMS.
Configuration Backups
Backups are stored locally in /data/config_backups/. A backup is created before every web config save and before every restore.
Backups Stored
2 / 10
Latest Backup
2026-06-03 15:54:23
Oldest Backup
2026-06-03 15:49:56
Backup Folder
/data/config_backups
The latest 10 backups are kept. Restoring a backup changes Home Assistant add-on options only and does not write to the BMS. Restart is required after restore.
When to use these buttons:
Create Backup Now — use before testing config changes or before updating the add-on.
Download All ZIP — use when you want an offline copy of all saved backups.
Compare — use before restoring to see what is different from the current config.
Restore Preview — use when you are considering restoring a backup and want to review the changes first.
Download — use to save one specific backup file.
Delete — use to remove an old or test backup you no longer need.
Create Backup Now — use before testing config changes or before updating the add-on.
Download All ZIP — use when you want an offline copy of all saved backups.
Compare — use before restoring to see what is different from the current config.
Restore Preview — use when you are considering restoring a backup and want to review the changes first.
Download — use to save one specific backup file.
Delete — use to remove an old or test backup you no longer need.
| Type | Created | Backup File | Size | Actions |
|---|---|---|---|---|
| Automatic Backup Before Save | 2026-06-03 15:54 |
options-backup-20260603-155423-before-save.json
|
3005 bytes | |
| Automatic Backup Before Save | 2026-06-03 15:49 |
options-backup-20260603-154956-before-save.json
|
3005 bytes |
Read-only log view
Use this page to filter captured monitor and web UI logs for support. Viewing logs does not change BMS settings and does not send BMS commands.
Logs
This is a viewer for logs already captured by the add-on. The controls below only filter the display; they do not change what the monitor records.
Log Viewer
Log viewer information
Showing latest is the newest 400 line sample read from
Refresh Logs reads the latest sample again and keeps the page in the Logs tab. Logs now also auto-refresh quietly while this tab is open.
Show chooses the display: Important shows alerts/events, Battery reads adds normal Analog/Warn read summaries, and Everything shows the whole captured sample including web access/debug lines.
Search only filters what is displayed. It does not change what the monitor records. To capture deeper monitor detail, change
The oldest and newest line timestamps show the time span covered by the current sample.
/data/pacebms-monitor.log and /data/pacebms-web.log. The sample is capped so the page stays fast.
Refresh Logs reads the latest sample again and keeps the page in the Logs tab. Logs now also auto-refresh quietly while this tab is open.
Show chooses the display: Important shows alerts/events, Battery reads adds normal Analog/Warn read summaries, and Everything shows the whole captured sample including web access/debug lines.
Search only filters what is displayed. It does not change what the monitor records. To capture deeper monitor detail, change
debug_output in Config and restart the add-on.
The oldest and newest line timestamps show the time span covered by the current sample.
No captured log file entries are available yet. Restart the add-on once after this update so monitor and web logs start writing to the support log files.
Event history
Use this page to review recent tests, disconnects, stale-data events, warnings and recoveries.
Last Events
Latest events are stored locally in /data/events.json. The latest 50 are kept.
2026-06-20 22:55:00
Monitor started
SN: 413021350200084
ok
2026-06-20 22:55:00
Monitor starting
SN: 413021350200084
info
2026-06-20 22:37:59
Monitor stopped
SN: 413021350200084
warn
2026-06-20 22:36:58
BMS disconnected
Send failed
danger
2026-06-20 16:31:03
Monitor started
SN: 413021350200084
ok
2026-06-20 16:31:03
Monitor starting
SN: 413021350200084
info
2026-06-20 16:27:42
Monitor stopped
SN: 413021350200084
warn
2026-06-20 16:18:30
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:18:23
BMS disconnected
Checksum error
danger
2026-06-20 16:17:58
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:17:51
BMS disconnected
Checksum error
danger
2026-06-20 16:17:26
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:17:19
BMS disconnected
Checksum error
danger
2026-06-20 16:15:16
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:15:09
BMS disconnected
Checksum error
danger
2026-06-20 16:10:24
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:10:17
BMS disconnected
Receive failed
danger
2026-06-20 16:09:52
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:09:45
BMS disconnected
Receive failed
danger
2026-06-20 16:09:19
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:09:12
BMS disconnected
Checksum error
danger
2026-06-20 16:08:46
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:08:39
BMS disconnected
Checksum error
danger
2026-06-20 16:03:56
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 16:03:49
BMS disconnected
Checksum error
danger
2026-06-20 15:55:49
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:55:42
BMS disconnected
Checksum error
danger
2026-06-20 15:50:24
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:50:17
BMS disconnected
Checksum error
danger
2026-06-20 15:45:01
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:44:54
BMS disconnected
Checksum error
danger
2026-06-20 15:40:08
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:40:01
BMS disconnected
Checksum error
danger
2026-06-20 15:34:43
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:34:36
BMS disconnected
Receive failed
danger
2026-06-20 15:34:11
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:34:04
BMS disconnected
Receive failed
danger
2026-06-20 15:33:39
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:33:32
BMS disconnected
Receive failed
danger
2026-06-20 15:28:45
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:28:38
BMS disconnected
Checksum error
danger
2026-06-20 15:26:36
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:26:29
BMS disconnected
Receive failed
danger
2026-06-20 15:26:03
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:25:56
BMS disconnected
Checksum error
danger
2026-06-20 15:19:33
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:19:26
BMS disconnected
Checksum error
danger
2026-06-20 15:12:31
BMS reconnected
Offline: 6s; retries: 1
ok
2026-06-20 15:12:24
BMS disconnected
Checksum error
danger
2026-06-20 15:10:22
BMS reconnected
Offline: 6s; retries: 1
ok
Config Help
Hubble AM2 NMC Voltage Reference
| Cell V | OCV Ref | Status | Risk | Notes |
|---|---|---|---|---|
| > 4.20 | Over | Overvoltage | Danger | Above BMS high protection; cell damage risk. |
| 4.18 | 100% | At limit | Caution | Absolute full charge; only at end of charge current taper. |
| 4.15 | 99% | Very high | Caution | Prolonged time here stresses cells. |
| 4.13 | 98% | High | Caution | Top of charge range after full cycle. |
| 4.10 | 97% | Normal | Normal | Top of practical charge range. |
| 4.05 | 95% | Normal | Normal | Healthy full-charge point. |
| 4.00 | 92% | Normal | Normal | |
| 3.95 | 88% | Normal | Normal | |
| 3.90 | 83% | Normal | Normal | |
| 3.85 | 77% | Normal | Normal | |
| 3.80 | 70% | Normal | Normal | |
| 3.75 | 62% | Normal | Normal | |
| 3.70 | 53% | Normal | Normal | Nominal voltage. |
| 3.65 | 45% | Normal | Normal | Flat plateau region. |
| 3.60 | 37% | Normal | Normal | |
| 3.50 | 25% | Normal | Normal | |
| 3.40 | 15% | Caution | Caution | Approaching cutoff territory. |
| 3.30 | 10% | Warning | Warning | BMS low-voltage warning zone. |
| 3.20 | 6% | Critical | Critical | |
| 3.00 | 2-3% | Protection | Protection | BMS discharge FET cutoff. |
| 2.92 | 0% | Danger | Danger | Irreversible damage zone. |
| < 2.50 | Dead | Dead cell | Dead | Below absolute minimum. |
Reference only. Live BMS SOC remains authoritative. Under load, cell voltage can read about 50-100 mV lower than resting open-circuit voltage. This table does not affect BMS warnings, Telegram policy, MQTT entities or the existing Status column.
Diagnostics
Health overview and redacted support information for the add-on. This page reads add-on state only and does not write to the BMS. Live fields refresh every 1 second while open.
Support bundle information
The Support Bundle ZIP includes diagnostics, recent events, backup summary and sanitized config. Sensitive values are redacted and full backup files are not included.
Diagnostics unavailable
Diagnostics could not be generated. Check MQTT settings and add-on logs.