title: OpenDTU-OnBattery: Battery
agents: special/opendtu
catalog: hw/environment/opendtu
license: GPL-2.0-only
distribution: check_mk
description:
 OpenDTU-OnBattery only. Reports the connected battery / BMS from
 {/api/batterylivedata/status}: state of charge, voltage, current, derived power
 (with charge / discharge direction), temperature, and the charge / discharge current
 limits. Any warning or alarm "issues" the BMS provider raises are shown, and every
 additional numeric reading the provider includes is listed as detail.

 The service goes {CRIT} when the battery data is stale (older than three times the
 device's own max-age), when the BMS raises an alarm, or when the state of charge
 falls below the critical level. It goes {WARN} on a BMS warning, on low state of
 charge, and on battery temperature outside the configured window. Thresholds are set
 via the "OpenDTU Battery" check parameters.

item:
 (no item -- one service per host)

discovery:
 One service is created when the device has a battery configured and the special agent
 returned battery data.
