Basic
20 min

Chemical Dosing Control

dosingwaterproportionalalarmREAL
Chemical Dosing Control scenario preview

Ready to build this?

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

Sign up to play this scenario →

Already have an account? Log in

Briefing

A chemical dosing system injects reagent into a water main proportionally. When flow is active and the operator enables dosing, the dose pump runs at a speed inversely proportional to the chemical tank level (smaller tank = more concentrated injection needed = faster pump speed). The dosing skid's VFD takes its speed reference directly from a proportional controller block in your program: declare DOSE_PID : PID and run it P-only so its CV equals (100 − TANK_LEVEL). A LOW_TANK_ALARM input cuts off dosing immediately and activates the LOW_TANK_LAMP warning.

Objectives

  • DOSE_PUMP_RUN energises only when FLOW_RUNNING AND DOSE_START AND NOT LOW_TANK_ALARM
  • Dose speed (DOSE_PID.CV, 0–100%) is proportional to (100 – TANK_LEVEL): emptier tank runs faster
  • LOW_TANK_ALARM stops the dose pump and lights LOW_TANK_LAMP
  • LOW_TANK_LAMP stays ON while LOW_TANK_ALARM is asserted
  • When dosing is disabled or flow stops, DOSE_PUMP_RUN drops and the dose speed parks at 0

Hints

  • DOSE_PUMP_RUN := FLOW_RUNNING AND DOSE_START AND NOT LOW_TANK_ALARM
  • Declare the controller instance exactly as DOSE_PID : PID; — the skid VFD (and the grader) read DOSE_PID.CV
  • P-only proportional maths: DOSE_PID(SP := 100.0, PV := TANK_LEVEL, Kp := 1.0, Ki := 0.0, Kd := 0.0, MIN := 0.0, MAX := 100.0, DT_MS := 50, ENABLE := DOSE_PUMP_RUN); gives CV = 100 − TANK_LEVEL
  • ENABLE := DOSE_PUMP_RUN parks the CV at MIN (0) whenever the pump permissive drops
  • LOW_TANK_LAMP := LOW_TANK_ALARM

I/O Table

Inputs

FLOW_RUNNING

Flow switch — water main active

BOOL · %I0.0

DOSE_START

Operator dose enable switch

BOOL · %I0.1

TANK_LEVEL

Chemical tank level 0–100%

REAL · %IW0

LOW_TANK_ALARM

Low tank float switch (<10%)

BOOL · %I0.2

Outputs

DOSE_PUMP_RUN

Dose pump run contactor

BOOL · %Q0.0

LOW_TANK_LAMP

Low tank alarm lamp

BOOL · %Q0.1

Your program will be tested against:

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

  1. #1Dose pump starts when flow active and dose enabled

    FLOW_RUNNING + DOSE_START + tank at 50% -> pump runs at ~50% speed

  2. #2Dose pump stops when flow is lost

    FLOW_RUNNING goes false -> pump stops

  3. #3LOW_TANK_ALARM stops dosing and lights lamp

    LOW_TANK_ALARM while running -> pump stops, LOW_TANK_LAMP on

  4. #4Speed is inversely proportional to tank level

    Lower tank level -> higher pump speed

Ready to build this?

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

Sign up to play this scenario →

Already have an account? Log in

Runnable simulator field guide

Chemical-dosing PLC scenario: implementation, evidence and troubleshooting

Direct answer

Chemical-dosing PLC scenario becomes useful when it connects training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy with batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state, then proves one declared dose starts only with valid permissives and stops once at the target with coherent equipment feedback 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 process-control learners programming a dosing pump, valves, tank conditions and measured addition under a declared safe training recipe. The intended result is specific: the learner can separate recipe demand from equipment permission, command and measured result, stop on missing evidence and recover without silently repeating a dose.

a guarded water-based process training skid used to test dosing, heating, flushing, valve, pump and instrument sequence evidence while studying bounded dosing sequence, permissives, measurement and recovery
The field scene connects bounded dosing sequence, permissives, measurement and recovery to declared initial conditions, observable 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

training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy. For bounded dosing sequence, permissives, measurement 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

batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state. 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

one declared dose starts only with valid permissives and stops once at the target with coherent equipment feedback. 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

empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return. Choose minimum, maximum, simultaneous, delayed or restart conditions that reveal assumptions hidden by the happy path.

NODE 05observable

Diagnose a controlled fault

a recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart 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 production design reviewed against current process, chemical, equipment, environmental and safety requirements and validated on target. 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 training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy 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 batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state 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 one declared dose starts only with valid permissives and stops once at the target with coherent equipment feedback 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 empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return 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 recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart 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 production design reviewed against current process, chemical, equipment, environmental and safety requirements and validated on target 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 Chemical-dosing 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 water-based educational model does not select chemicals, materials, exposure controls, dose limits, environmental requirements or a production safety function.

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. training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy. For bounded dosing sequence, permissives, measurement 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 training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy 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: What should a PLC chemical-dosing sequence prove? A defensible short answer is: It should prove the correct source, destination and route, confirm equipment response, measure the addition, stop at the bounded target and retain fault and completion evidence.

Case 02

predict → observe → prove

Prove map the evidence path

Engineering context. batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state. 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 batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state 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: How should a dosing sequence recover after interruption? A defensible short answer is: Preserve how much was delivered, establish the physical state and require a deliberate rule for resume, abort or manual disposition instead of starting the dose again.

Case 03

predict → observe → prove

Prove prove normal operation

Engineering context. one declared dose starts only with valid permissives and stops once at the target with coherent equipment feedback. 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 one declared dose starts only with valid permissives and stops once at the target with coherent equipment feedback 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 bounded dosing sequence, permissives, measurement and recovery? A defensible short answer is: Start with the operating contract and evidence path: training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy, followed by batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state. Add advanced features only after the baseline is predictable.

Case 04

predict → observe → prove

Prove exercise a boundary case

Engineering context. empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return. 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 empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return 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 bounded dosing sequence, permissives, measurement 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 recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart 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 recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart 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 production design reviewed against current process, chemical, equipment, environmental and safety requirements and validated on target. 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 production design reviewed against current process, chemical, equipment, environmental and safety requirements and validated on target 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 recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart mismatch or empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return can expose assumptions that never appear during ideal startup and steady operation.

Answer surface / 07

Questions people ask about Chemical-dosing 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.

What should a PLC chemical-dosing sequence prove?

It should prove the correct source, destination and route, confirm equipment response, measure the addition, stop at the bounded target and retain fault and completion evidence.

How should a dosing sequence recover after interruption?

Preserve how much was delivered, establish the physical state and require a deliberate rule for resume, abort or manual disposition instead of starting the dose again.

What should I learn first about bounded dosing sequence, permissives, measurement and recovery?

Start with the operating contract and evidence path: training recipe, source and destination identity, level permissives, route, pump or valve capacity, requested quantity, flow or weight evidence, timeout, hold, abort and restart policy, followed by batch request through route confirmation, dosing output, measured transfer, totalized amount, stop command, residual motion, completion record and next state. Add advanced features only after the baseline is predictable.

How do I practise bounded dosing sequence, permissives, measurement 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 recipe, permissive, route, command, pump, valve, instrument, totalizer, timeout, completion or restart mismatch or empty source, full destination, no flow, leaking valve, pump trip, noisy measurement, overshoot, pause, abort, controller restart and power return 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.

Real plc chemical dosing control footage

See this exact skill in the working simulator.

Watch the real browser product respond to the task on this page, then try the same practical workflow yourself. No slides, concept mockups, install, or credit card.

Try this in the browser
PLC Chemical Dosing — Proportional Control and Alarms