Battery (function 5)

A battery and its monitor. This is where the state of charge on the screens comes from, along with voltage, current, temperature, the charge/discharge limits the battery imposes, and its cycle count. The command connects and disconnects it.

• state enum: ok, warning, alarm.
• request enum: no-charge, mid-load, overload, low-battery, off.

Published

device/5/<i>/life

metadata adds counter; expireAfterSec: 30.

data field	Type	Unit	Description
state	string	—	Battery state (enum)
stateCode	int	—	Raw state
request	string	—	Charge request (enum)
requestCode	int	—	Raw request
voltage	number (1 dec)	V	Battery voltage
current	number (1 dec)	A	Battery current (signed)
soc	int	%	State of charge
temperature	int	°C	Battery temperature
BindToParc	int	—	Parc binding id

{
  "data": {
    "state": "ok",
    "stateCode": 0,
    "request": "mid-load",
    "requestCode": 1,
    "voltage": 12.8,
    "current": -15.4,
    "soc": 87,
    "temperature": 24,
    "BindToParc": 1
  },
  "metadata": {
    "rxdate": "2026-06-17T14:30:45.123Z",
    "rxTimestamp": 1781793045,
    "expireAfterSec": 30,
    "counter": 3
  }
}

device/5/<i>/state

expireAfterSec: 30.

data field	Type	Unit	Description
maxChargeVoltage	number (1 dec)	V	Max charge voltage
maxChargeCurrent	number (1 dec)	A	Max charge current
maxDischargeCurrent	number (1 dec)	A	Max discharge current
minDischargeVoltage	number (1 dec)	V	Min discharge voltage

{
  "data": {
    "maxChargeVoltage": 14.6,
    "maxChargeCurrent": 100.0,
    "maxDischargeCurrent": 200.0,
    "minDischargeVoltage": 10.5
  },
  "metadata": {
    "rxdate": "2026-06-17T14:30:45.123Z",
    "rxTimestamp": 1781793045,
    "expireAfterSec": 30
  }
}

device/5/<i>/cycle

expireAfterSec: 60.

data field	Type	Description
cycle	int	Charge/discharge cycle count
errorCode	int	Alarm code (0 = none)

{
  "data": {
    "cycle": 342,
    "errorCode": 0
  },
  "metadata": {
    "rxdate": "2026-06-17T14:30:45.123Z",
    "rxTimestamp": 1781793045,
    "expireAfterSec": 60
  }
}

mosquitto_sub -h 127.0.0.1 -t 'device/5/+/#' -v

Command — device/5/<i>/command

Regex ^device/5/([[:digit:]]+)/command$. If both true, requestOn is cleared.

Field	Type	Description
requestOn	bool	Turn battery on
requestOff	bool	Turn battery off

mosquitto_pub -h 127.0.0.1 -t 'device/5/0/command' -m '{"requestOn":true}'
mosquitto_pub -h 127.0.0.1 -t 'device/5/0/command' -m '{"requestOff":true}'