Lemonergy · Studio block

Battery voltage monitor

Reports each channel below/above its bounds and a combined fault.

Implementation ID: battery-voltage-monitor
Reviewed: 2026-10-27

Behavior

Compares each measured channel with strict lower and upper bounds. A value equal to a bound does not trip. The combined output is true when any channel is outside the bounds.

Interface

Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.

Ports and observed outputs
Name	Direction	Unit	Meaning
`values`	input	V	Channel measurements; 3 channels at the default configuration.
`low`	output	true / false	Below lower bound; 3 channels at the default configuration.
`high`	output	true / false	Above upper bound; 3 channels at the default configuration.
`fault`	output	true / false	Any fault; scalar.

Parameters

Defaults are initial model values. Select values for your own model and operating conditions.

Configuration fields
Parameter	Unit	Default	Meaning and limits
Number of measurement channels `cells`	1	3	Number of measurement channels. This is an editable model input; the default belongs to the synthetic worked example.
Lower threshold (V) `lower`	V	3	Lower threshold (V). This is an editable model input; the default belongs to the synthetic worked example.
Upper threshold (V) `upper`	V	4.2	Upper threshold (V). This is an editable model input; the default belongs to the synthetic worked example.

Equations and rules

low[j] = value[j] < lower
high[j] = value[j] > upper
fault = any(low) or any(high)

Worked example

Battery voltage monitor worked example

Use the defaults below with Channel measurements = [3, 4, 4.3] V. At 0 s, Any fault is 1 true / false. Additional checks are listed below.

Open Studio example after release →

Numerical checks for the bundled synthetic example
Output	Time (s)	Expected value	Unit	Absolute tolerance
Any fault `fault`	0	`true`	true / false	1e-08

Explore the recorded outputs

Battery voltage monitor recorded example

Battery voltage monitor / Below lower bound [1]

Battery voltage monitor / Below lower bound [1]: 0 — at 0 s

2 actual recorded samples. Lines are visual guides between samples. Synthetic example, not measured cell data.

Download the recorded samples (JSON) · Open this Studio example after release

Use in a workflow

Battery voltage monitor worked example

Reports each channel below/above its bounds and a combined fault.

Battery voltage monitor: Compares each measured channel with strict lower and upper bounds. A value equal to a bound does not trip. The combined output is true when any channel is outside the bounds.
- Use the parameter values in the block reference.
- Implementation tested locally; public release pending.

Open Studio example after release

Connected concepts

Limits and interpretation

Bounds are user-supplied. This comparator does not disconnect a circuit or diagnose a sensor failure.
The example verifies numerical behavior for synthetic parameters. Cell characterization and validation for an intended use are separate tasks.

Scientific and mathematical references

These sources explain the scientific and mathematical background. The behavior, interface and limits above define the Lemonergy implementation; a citation does not imply every model option in the source is implemented.

Getting Started with the BQ76925
Texas Instruments · 2019
Technical reference · A concrete BMS analog front-end example: cell voltage, current, temperature measurement and MCU integration.

Implementation sources

This reference follows the public interface and locally verified numerical checks for an upcoming release.

Contract: Lemonergy Studio public contract · Verification record: verification-2026-10-27

docs/glossary/native-block-verification.json

This implementation and its workflow uses (JSON) · Knowledge graph (JSON-LD)