Pro
20 min

Tank Level Alarms with Hysteresis

analogscalinglevelalarmhysteresis
Tank Level Alarms with Hysteresis scenario preview

Ready to build this?

Sign up free — no credit card required. This scenario requires the Pro plan.

Sign up to play this scenario →

Already have an account? Log in

Briefing

A level transmitter returns raw ADC counts (0–10 000) proportional to tank fill. The formula: **Level % = LT_RAW / 10 000 × 100** gives 0 = empty, 5 000 = 50%, 10 000 = full. Simple threshold detection chatters: if the level sits at exactly 90% the alarm fires and clears every scan. **Hysteresis** solves this by using two setpoints — the alarm **sets** above 90% but only **clears** below 80%. The physics engine computes and publishes four BOOL signals: - **HIGH_SET** (level > 90%) — use this to S= HIGH_ALARM - **HIGH_CLEAR** (level < 80%) — use this to R= HIGH_ALARM - **LOW_SET** (level < 10%) — use this to S= LOW_ALARM - **LOW_CLEAR** (level > 20%) — use this to R= LOW_ALARM Your task is to implement the four-rung latch logic.

Objectives

  • HIGH_ALARM latches when level rises above 90% (HIGH_SET), clears below 80% (HIGH_CLEAR)
  • LOW_ALARM latches when level falls below 10% (LOW_SET), clears above 20% (LOW_CLEAR)

Hints

  • Use SET/RESET latch pairs: | HIGH_SET | S= HIGH_ALARM ; and | HIGH_CLEAR | R= HIGH_ALARM ;
  • The SET rung must come BEFORE the RESET rung for correct scan-order behaviour
  • For LOW_ALARM: | LOW_SET | S= LOW_ALARM ; and | LOW_CLEAR | R= LOW_ALARM ;

I/O Table

Inputs

LT_RAW

Level transmitter raw counts (0–10000)

INT · %IW0

HIGH_SET

Physics: level > 90% — set high alarm

BOOL · %I0.0

HIGH_CLEAR

Physics: level < 80% — clear high alarm

BOOL · %I0.1

LOW_SET

Physics: level < 10% — set low alarm

BOOL · %I0.2

LOW_CLEAR

Physics: level > 20% — clear low alarm

BOOL · %I0.3

Outputs

HIGH_ALARM

High-level alarm (latching with hysteresis)

BOOL · %Q0.0

LOW_ALARM

Low-level alarm (latching with hysteresis)

BOOL · %Q0.1

Your program will be tested against:

All test cases run automatically when you submit. Assertions are hidden until you pass.

  1. #1Level rises above 90% → HIGH_ALARM latches

    LT_RAW = 9100 (91%) → HIGH_SET true → HIGH_ALARM latches on

  2. #2Level drops to 85% (inside hysteresis band) → HIGH_ALARM stays on

    After HIGH_ALARM latches, level drops to 85% (between 80 and 90) — alarm must remain on

  3. #3Level drops below 80% → HIGH_ALARM clears

    After HIGH_ALARM latches, level drops to 75% (below HIGH_CLEAR) — alarm clears

  4. #4Level drops below 10% → LOW_ALARM latches

    LT_RAW = 800 (8%) → LOW_SET true → LOW_ALARM latches on

  5. #5Level recovers above 20% → LOW_ALARM clears

    LOW_ALARM latched; level rises to 25% (above LOW_CLEAR) — alarm clears

Ready to build this?

Sign up free — no credit card required. This scenario requires the Pro plan.

Sign up to play this scenario →

Already have an account? Log in

Runnable simulator field guide

Tank-level alarm PLC scenario: implementation, evidence and troubleshooting

Direct answer

Tank-level alarm PLC scenario becomes useful when it connects transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary with physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response, then proves known low, mid and high input points scale correctly and each alarm enters and clears at its declared boundary without chatter under normal, boundary, fault and recovery conditions. The objective is a repeatable engineering or learning result, not merely activity inside a page or tool.

This guide is written for instrumentation and PLC learners converting a level signal into engineering units and dependable high, high-high, low and low-low alarms. The intended result is specific: the learner can scale a declared range, distinguish normal movement from bad quality, apply stable alarm thresholds and prove acknowledgement and return-to-normal behavior.

a water-based process instrumentation skid with tank, valve, transmitter and controller evidence used for safe calibration and sequence practice while studying analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery
The training scene connects analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery to a declared initial state, inspectable boundaries, safe limits and repeatable acceptance evidence.

System map / 02

Six concepts that control the result

Treat these as connected checkpoints. Each checkpoint has an expected state, an observable state and a boundary to the next part of the system. That structure prevents a software indication from being mistaken for physical proof.

NODE 01observable

Define the operating contract

transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary. For analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery, record the initial condition, actor, requested change, observable result and stopping condition before selecting a tool or implementation.

NODE 02observable

Map the evidence path

physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response. Separate request, internal state, output or service, physical or user-visible result and independent feedback so each boundary can be inspected.

NODE 03observable

Prove normal operation

known low, mid and high input points scale correctly and each alarm enters and clears at its declared boundary without chatter. Run more than one cycle from a known state and retain the values, timings or artifacts that demonstrate repeatability.

NODE 04observable

Exercise a boundary case

open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data. Choose minimum, maximum, simultaneous, delayed or restart conditions that reveal assumptions hidden by the happy path.

NODE 05observable

Diagnose a controlled fault

a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch. Preserve the first symptom, divide the system at a measurable boundary and change one condition only after predicting the result.

NODE 06observable

Transfer and hand over

the design validated against current instrument data, tank limits, alarm philosophy and independent protective layers. Restore normal state, remove temporary changes, repeat affected checks and document which claims remain limited to the learning environment.

Procedure / 03

A six-step practice and commissioning workflow

Run the steps in order the first time. Later, the same structure becomes a diagnostic loop: define the expected condition, observe the boundary, interpret the difference and choose one proving action.

  1. 01

    Write the acceptance case

    Convert transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary into initial conditions, one stimulus and observable pass criteria.

    Evidence: Another person can repeat the case without guessing the intended result.

    Avoid: Using page completion or an animation as the acceptance criterion.

  2. 02

    Build the map

    Document physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response and name who owns each state or decision.

    Evidence: Every request and result has a source, destination and useful inspection point.

    Avoid: Using the same value as command, status and independent feedback.

  3. 03

    Run the baseline

    Apply known low, mid and high input points scale correctly and each alarm enters and clears at its declared boundary without chatter from a clean start and record the expected evidence.

    Evidence: Repeated runs produce the same bounded result.

    Avoid: Changing several parameters before a baseline exists.

  4. 04

    Challenge assumptions

    Test open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data without changing the acceptance contract.

    Evidence: Limits, timing and restart behavior reach defined states.

    Avoid: Testing only one ideal sequence.

  5. 05

    Isolate one failure

    Introduce or analyse a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch and locate the first disagreement.

    Evidence: The proving action distinguishes the leading hypotheses.

    Avoid: Resetting, forcing or replacing before evidence is retained.

  6. 06

    Close the evidence loop

    Complete the design validated against current instrument data, tank limits, alarm philosophy and independent protective layers and repeat the affected regression cases.

    Evidence: A run is complete only when the requested behavior, stop behavior, fault response and recovery are observable from a fresh initial condition.

    Avoid: Treating an acknowledged message or one successful rerun as handover.

Diagnostic matrix / 04

Symptoms, proving points and next actions

The table is a reasoning aid, not a parts-replacement chart. Preserve the initial symptom, inspect the named boundary and use the interpretation to choose the next controlled test. Site safety procedures and equipment manuals remain authoritative.

Diagnostic symptoms, inspection points, interpretations and next actions for Tank-level alarm PLC scenario: implementation, evidence and troubleshooting
Observed symptomInspectInterpretationNext proving action
The expected result is unclearRequirement, initial state, actor, stimulus, units and pass conditionThe operator, programmer and reviewer may be solving different versions of the task.Rewrite one observable acceptance case before continuing.
Internal state changes but the outcome does notRequest, final owner, output or service boundary and independent feedbackA software or interface indication proves intent at one layer, not the complete outcome.Trace the first boundary after the changing state.
Normal case passes but an edge case failsLimits, timing, simultaneous events, reset and restart assumptionsThe implementation contains a hidden assumption exposed by the changed condition.Add the failed boundary as a permanent regression case.
The failure disappears after resetOriginal symptom, histories, diagnostics, timestamps and active causeReset changed evidence or state without proving the initiating cause.Reproduce under a controlled condition and preserve pre/post-event data.
Simulator and target disagreeModel boundary, software version, task timing, I/O behavior, data types and configurationA learning model and the intended target do not share one of the recorded assumptions.Reduce the case and verify against current target documentation.
The result cannot be explainedPrediction, observation, proving action, alternative hypotheses and limitationsActivity occurred but the evidence is not yet transferable or reviewable.Have the learner defend the signal path and repeat a changed case.

Product evidence / 05

What the browser practice can actually demonstrate

The browser runtime joins editable control state to visible I/O and machine or process behavior, allowing the same initial conditions and stimuli to be replayed.

Where simulation stops

The exercise does not specify a real tank geometry, sensor technology, overfill safety function, relief design or site alarm philosophy.

Commissioning notebook / 06

Six cases that turn the concepts into evidence

Use these as written briefs rather than click-through instructions. For every case, state the expected condition before acting, retain the first useful observation and explain why the final result proves the requirement. A different program or component choice can still be correct when it produces the same bounded behavior and evidence.

Case 01

predict → observe → prove

Prove define the operating contract

Engineering context. transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary. For analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery, record the initial condition, actor, requested change, observable result and stopping condition before selecting a tool or implementation. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Write the acceptance case” stage of the workflow: convert transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary into initial conditions, one stimulus and observable pass criteria. The acceptance record should show this result: another person can repeat the case without guessing the intended result. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “The expected result is unclear” as one bounded deviation. Inspect requirement, initial state, actor, stimulus, units and pass condition The working interpretation is that the operator, programmer and reviewer may be solving different versions of the task. The next proving action is to rewrite one observable acceptance case before continuing. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is using page completion or an animation as the acceptance criterion. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: How do you stop a tank-level alarm from chattering? A defensible short answer is: Use justified hysteresis or delay after verifying signal quality and process behavior; never use delay to hide a failing transmitter or unsafe response time.

Case 02

predict → observe → prove

Prove map the evidence path

Engineering context. physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response. Separate request, internal state, output or service, physical or user-visible result and independent feedback so each boundary can be inspected. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Build the map” stage of the workflow: document physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response and name who owns each state or decision. The acceptance record should show this result: every request and result has a source, destination and useful inspection point. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “Internal state changes but the outcome does not” as one bounded deviation. Inspect request, final owner, output or service boundary and independent feedback The working interpretation is that a software or interface indication proves intent at one layer, not the complete outcome. The next proving action is to trace the first boundary after the changing state. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is using the same value as command, status and independent feedback. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: Should a high-high alarm latch? A defensible short answer is: That depends on the approved alarm and protection philosophy; if it latches, define acknowledgement, reset permissives and the independent trip relationship explicitly.

Case 03

predict → observe → prove

Prove prove normal operation

Engineering context. known low, mid and high input points scale correctly and each alarm enters and clears at its declared boundary without chatter. Run more than one cycle from a known state and retain the values, timings or artifacts that demonstrate repeatability. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Run the baseline” stage of the workflow: apply known low, mid and high input points scale correctly and each alarm enters and clears at its declared boundary without chatter from a clean start and record the expected evidence. The acceptance record should show this result: repeated runs produce the same bounded result. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “Normal case passes but an edge case fails” as one bounded deviation. Inspect limits, timing, simultaneous events, reset and restart assumptions The working interpretation is that the implementation contains a hidden assumption exposed by the changed condition. The next proving action is to add the failed boundary as a permanent regression case. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is changing several parameters before a baseline exists. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: What should I learn first about analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery? A defensible short answer is: Start with the operating contract and evidence path: transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary, followed by physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response. Add advanced features only after the baseline is predictable.

Case 04

predict → observe → prove

Prove exercise a boundary case

Engineering context. open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data. Choose minimum, maximum, simultaneous, delayed or restart conditions that reveal assumptions hidden by the happy path. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Challenge assumptions” stage of the workflow: test open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data without changing the acceptance contract. The acceptance record should show this result: limits, timing and restart behavior reach defined states. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “The failure disappears after reset” as one bounded deviation. Inspect original symptom, histories, diagnostics, timestamps and active cause The working interpretation is that reset changed evidence or state without proving the initiating cause. The next proving action is to reproduce under a controlled condition and preserve pre/post-event data. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is testing only one ideal sequence. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: How do I practise analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery effectively? A defensible short answer is: Use short cases with known initial conditions, a written prediction, one action and an observable result. Then alter a boundary or fault and explain why the evidence changed.

Case 05

predict → observe → prove

Prove diagnose a controlled fault

Engineering context. a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch. Preserve the first symptom, divide the system at a measurable boundary and change one condition only after predicting the result. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Isolate one failure” stage of the workflow: introduce or analyse a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch and locate the first disagreement. The acceptance record should show this result: the proving action distinguishes the leading hypotheses. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “Simulator and target disagree” as one bounded deviation. Inspect model boundary, software version, task timing, I/O behavior, data types and configuration The working interpretation is that a learning model and the intended target do not share one of the recorded assumptions. The next proving action is to reduce the case and verify against current target documentation. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is resetting, forcing or replacing before evidence is retained. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: What counts as proof of competence? A defensible short answer is: A repeatable artifact or system result plus an explanation of the signal path is stronger than time spent, screenshots or a copied answer. Physical competence requires separate supervised evidence.

Case 06

predict → observe → prove

Prove transfer and hand over

Engineering context. the design validated against current instrument data, tank limits, alarm philosophy and independent protective layers. Restore normal state, remove temporary changes, repeat affected checks and document which claims remain limited to the learning environment. Begin with a written normal condition and identify which request, state, physical result or communication value will provide independent confirmation. Do not begin by changing the configuration; the initial state is part of the evidence and should remain reproducible.

Controlled setup. Use the “Close the evidence loop” stage of the workflow: complete the design validated against current instrument data, tank limits, alarm philosophy and independent protective layers and repeat the affected regression cases. The acceptance record should show this result: a run is complete only when the requested behavior, stop behavior, fault response and recovery are observable from a fresh initial condition. Record initial conditions, the exact stimulus and the observation point so another learner can repeat the case without relying on your memory.

Fault challenge. Introduce or analyse “The result cannot be explained” as one bounded deviation. Inspect prediction, observation, proving action, alternative hypotheses and limitations The working interpretation is that activity occurred but the evidence is not yet transferable or reviewable. The next proving action is to have the learner defend the signal path and repeat a changed case. Change only one condition before observing the result, and preserve timestamps or measurements where timing matters.

Review and recovery. The most common trap here is treating an acknowledged message or one successful rerun as handover. After restoring the cause, repeat the normal case and at least one stop, timeout, disconnect or restart boundary relevant to this topic. Remove temporary forces and bypasses, return the model to a known state and retain the evidence that both operation and recovery are deliberate.

Explain it aloud: Why test faults and restart behavior? A defensible short answer is: Because a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch or open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data can expose assumptions that never appear during ideal startup and steady operation.

Answer surface / 07

Questions people ask about Tank-level alarm PLC scenario

These concise answers define the operating, training and product boundaries most often missed in broad summaries. The full workflow and diagnostic table above provide the evidence behind them.

How do you stop a tank-level alarm from chattering?

Use justified hysteresis or delay after verifying signal quality and process behavior; never use delay to hide a failing transmitter or unsafe response time.

Should a high-high alarm latch?

That depends on the approved alarm and protection philosophy; if it latches, define acknowledgement, reset permissives and the independent trip relationship explicitly.

What should I learn first about analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery?

Start with the operating contract and evidence path: transmitter range, raw input limits, engineering units, valid quality, alarm thresholds, hysteresis, on-delay, latching, acknowledgement and trip boundary, followed by physical or simulated level through loop signal, input conversion, scaled value, quality, alarm evaluation, operator indication and protective response. Add advanced features only after the baseline is predictable.

How do I practise analog tank-level scaling, alarm thresholds, hysteresis, delay and recovery effectively?

Use short cases with known initial conditions, a written prediction, one action and an observable result. Then alter a boundary or fault and explain why the evidence changed.

What counts as proof of competence?

A repeatable artifact or system result plus an explanation of the signal path is stronger than time spent, screenshots or a copied answer. Physical competence requires separate supervised evidence.

Why test faults and restart behavior?

Because a transmitter, loop, input, range, scale, quality, threshold, timer, alarm-state or display mismatch or open loop, underrange, overrange, noisy level, threshold equality, rapid fill, delayed scan, acknowledgement while active, restart and stale data can expose assumptions that never appear during ideal startup and steady operation.

Can browser practice replace official software or hardware?

No. It can build concepts and diagnostic reasoning. Exact firmware, I/O electrical behavior, networking, safety and commissioning require current official tools, documentation and target equipment.

How should progress be documented?

Keep the requirement, initial state, program or configuration, observed values, fault hypothesis, proving action, recovery result and a concise limitations statement.