lemonergy· battery engineering courses

Lemonergy · Studio block

Fault qualification timer

Qualifies persistent symptoms, leaks intermittent evidence and clears after a healthy interval.

Implementation ID
battery-fault-qualifier
Reviewed
2026-10-27

Behavior

Accumulates symptom time at accepted sample events, removes configured evidence during healthy samples, qualifies a persistent fault and clears it after a healthy interval. An explicit reset clears its memory. Initialization consumes no elapsed time.

Interface

Fault qualification timer interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Fault qualification timerStudio blocksymptomresetfaultaccumulatorhealthy
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
symptominputtrue / falseFault symptom; scalar.
resetinputtrue / falseReset; scalar.
faultoutputtrue / falseQualified fault; scalar.
accumulatoroutputsSymptom time (s); scalar.
healthyoutputsHealthy time (s); scalar.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
Sample interval (s)
sampleTimeS		s0.1Positive sample interval. Initialization has zero elapsed time; subsequent accepted samples update memory.
Fault qualification time (s)
qualifyS		s0.3Fault qualification time (s). This is an editable model input; the default belongs to the synthetic worked example.
Evidence removed per healthy sample (s)
decrementS		s0.1Evidence removed per healthy sample (s). This is an editable model input; the default belongs to the synthetic worked example.
Healthy clearing time (s)
clearS		s0.2Healthy clearing time (s). This is an editable model input; the default belongs to the synthetic worked example.

Equations and rules

  • fault qualifies when accumulated symptom time reaches qualifyS
  • healthy clearing requires clearS elapsed without the symptom

Worked example

Fault qualification timer worked example

Use the defaults below with Fault symptom = 1 true / false, Reset = 0 true / false. At 0.4 s, Qualified fault is 1 true / false. Additional checks are listed below.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
Qualified fault
fault		0.4truetrue / false0

Explore the recorded outputs

Fault qualification timer recorded example

Fault qualification timer / Symptom time (s)
Fault qualification timer / Symptom time (s) against timeRecorded synthetic simulation values. Time in seconds; output in —.-0.02400.0630.250.150.50.2370.750.3241—Time (s)
Fault qualification timer / Symptom time (s): 0 — at 0 s

11 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

Fault qualification timer worked example

Qualifies persistent symptoms, leaks intermittent evidence and clears after a healthy interval.

  1. Fault qualification timer: Accumulates symptom time at accepted sample events, removes configured evidence during healthy samples, qualifies a persistent fault and clears it after a healthy interval. An explicit reset clears its memory. Initialization consumes no elapsed time.
    • Use the parameter values in the block reference.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • Qualification depends on sample interval and thresholds; it cannot detect a symptom that was never sampled.
  • 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.

  1. 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)