Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Pump Systemsindustrial-automation
Water Level Pump Control — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 93 views
# Water Level-Based Pump Control — Usage Guide
## Overview
Hysteresis-band level control with 4-tier ISA-18.2 alarm hierarchy, 3-point median filtering, wire-break detection, leak-rate monitoring, and manual/auto mode. Suitable for raw water tanks, buffer tanks, sump wells, condensate tanks, and process feed tanks.
## Setpoint Hierarchy
```
HH (92%) ─── High-High: emergency — pump stop + overflow valve
H (85%) ─── High: alert — check inlet
│
│ [OPERATING BAND]
│
L (15%) ─── Low: alert — check fill pump
LL (10%) ─── Low-Low: emergency — pump start forced / drain tripped
```
Ensure setpoints maintain: SP_LL < SP_L < SP_LOW < SP_HIGH < SP_H < SP_HH
## Minimum Hysteresis Band
Set `MIN_HYSTERESIS_BAND` ≥ 5% to prevent rapid cycling.
For noisy/turbulent tanks: increase to 10–15%.
## Transmitter Wiring
4-20mA two-wire connection. PLC sees 0–27648 raw counts (Siemens) or 0–32767 (AB).
Set `LEVEL_RANGE_MIN` and `LEVEL_RANGE_MAX` to match transmitter calibration range.
## PUMP_FUNCTION Setting
| Value | Function | Start trigger | Stop trigger |
|-------|----------|---------------|--------------|
| 0 (FILL) | Fills tank | Level ≤ SP_LOW | Level ≥ SP_HIGH |
| 1 (DRAIN) | Drains tank | Level ≥ SP_HIGH | Level ≤ SP_LOW |
## Commissioning Checklist
- [ ] Confirm transmitter 4-20mA loop — check current at 0% and 100% fill
- [ ] Set SP_LL and SP_HH with operations and process engineer
- [ ] Verify overflow valve wiring and manual operation (if fitted)
- [ ] Test leak detection by slowly draining with pump off — confirm ALM_POSSIBLE_LEAK
- [ ] Force transmitter to 2mA (wire-break) — confirm ALM_LT001_FAIL and hold-last-good
- [ ] Test each alarm level by slowly varying actual level
- [ ] Confirm AUTO mode: pump starts at SP_LOW, stops at SP_HIGH, no cycling
---
## Control Logic — Vendor-Agnostic Pseudocode
# Water Level-Based Pump Control — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-18.2
## Scan Rate: 100ms | Pattern: Hysteresis band control with 3-level alarming
```
ROUTINE: WaterLevelPumpControl
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL SIGNAL CONDITIONING
// 4-20mA transmitter scaled to engineering units (%).
// Wire-break and saturation detection for failsafe operation.
// Median filter (3-sample) eliminates turbulence noise.
// ═══════════════════════════════════════════════════════════════
// Raw input validation (4-20mA = 3.8–20.5mA healthy)
LT001_MA := SCALE(LT001_RAW_COUNTS, 0, 27648, 4.0, 20.0) // Siemens raw → mA
LT001_VALID := (LT001_MA >= 3.8) AND (LT001_MA <= 20.5)
// Scale to engineering units
IF LT001_VALID THEN
LT001_PV_RAW := SCALE(LT001_MA, 4.0, 20.0, LEVEL_RANGE_MIN, LEVEL_RANGE_MAX)
ELSE
LT001_FAULT := TRUE
SET_ALARM(ALM_LT001_FAIL, HIGH)
LT001_PV_RAW := LT001_LAST_GOOD // Hold last good value on fault
END_IF
// 3-point median filter (eliminates turbulence spikes)
LT001_HIST[2] := LT001_HIST[1]
LT001_HIST[1] := LT001_HIST[0]
LT001_HIST[0] := LT001_PV_RAW
IF LT001_VALID THEN
LT001_LAST_GOOD := LT001_PV_RAW
END_IF
// Median of 3 samples
IF (LT001_HIST[0] >= LT001_HIST[1] AND LT001_HIST[0] <= LT001_HIST[2]) OR
(LT001_HIST[0] <= LT001_HIST[1] AND LT001_HIST[0] >= LT001_HIST[2]) THEN
LT001_PV := LT001_HIST[0]
ELSIF (LT001_HIST[1] >= LT001_HIST[0] AND LT001_HIST[1] <= LT001_HIST[2]) OR
(LT001_HIST[1] <= LT001_HIST[0] AND LT001_HIST[1] >= LT001_HIST[2]) THEN
LT001_PV := LT001_HIST[1]
ELSE
LT001_PV := LT001_HIST[2]
END_IF
// Rate of change (for surge/leak detection)
LEVEL_RATE := (LT001_PV - LT001_PV_PREV) / 0.1 // %/s over 100ms scan
LT001_PV_PREV := LT001_PV
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — HYSTERESIS BAND CONTROL
// Pump starts at LOW setpoint, stops at HIGH setpoint.
// Dead-band (hysteresis) prevents rapid cycling.
// For fill pump: start when level falls below SP_LOW, stop at SP_HIGH.
// For drain pump: start when level rises above SP_HIGH, stop at SP_LOW.
// ═══════════════════════════════════════════════════════════════
CASE PUMP_FUNCTION OF
FILL: // Start pump to fill tank (level rising)
IF LT001_PV <= SP_LOW AND PERMISSIVES_OK AND NOT PUMP_LATCH THEN
PUMP_LATCH := TRUE
AUDIT_LOG(EVENT="PUMP_START_FILL",
LEVEL=LT001_PV, SP=SP_LOW)
END_IF
IF LT001_PV >= SP_HIGH THEN
PUMP_LATCH := FALSE
AUDIT_LOG(EVENT="PUMP_STOP_FILL",
LEVEL=LT001_PV, SP=SP_HIGH)
END_IF
DRAIN: // Start pump to drain tank (level falling)
IF LT001_PV >= SP_HIGH AND PERMISSIVES_OK AND NOT PUMP_LATCH THEN
PUMP_LATCH := TRUE
AUDIT_LOG(EVENT="PUMP_START_DRAIN",
LEVEL=LT001_PV, SP=SP_HIGH)
END_IF
IF LT001_PV <= SP_LOW THEN
PUMP_LATCH := FALSE
AUDIT_LOG(EVENT="PUMP_STOP_DRAIN",
LEVEL=LT001_PV, SP=SP_LOW)
END_IF
END_CASE
// Validate hysteresis band (SP_HIGH must be > SP_LOW + MIN_BAND)
IF (SP_HIGH - SP_LOW) < MIN_HYSTERESIS_BAND THEN
SET_ALARM(ALM_SETPOINT_CONFIG, MEDIUM)
PUMP_LATCH := FALSE // Inhibit until corrected
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — PERMISSIVE INTERLOCK GATE
// ═══════════════════════════════════════════════════════════════
PERMISSIVES_OK := (NOT PUMP_FAULT_LATCHED AND
PERM_OL_OK AND
PERM_ESTOP_OK AND
LT001_VALID AND
NOT INHIBIT_CMD)
IF NOT PERMISSIVES_OK THEN
PUMP_LATCH := FALSE
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — MODE SELECTION & MANUAL OVERRIDE
// ═══════════════════════════════════════════════════════════════
CASE MODE_SELECTOR OF
0: // OFF
PUMP_CMD := FALSE
PUMP_LATCH := FALSE
1: // MANUAL — operator direct control
IF MAN_START AND PERMISSIVES_OK THEN
PUMP_LATCH := TRUE
END_IF
IF MAN_STOP THEN
PUMP_LATCH := FALSE
END_IF
PUMP_CMD := PUMP_LATCH
2: // AUTO — level-based hysteresis
PUMP_CMD := PUMP_LATCH
END_CASE
// ═══════════════════════════════════════════════════════════════
// SECTION 5 — ISA-18.2 ALARM HIERARCHY
// LL → L → H → HH cascade with independent setpoints.
// Time-delays reduce nuisance alarms (sloshing, transients).
// ═══════════════════════════════════════════════════════════════
// Low-Low: emergency drain/shutoff
IF LT001_PV <= SP_LL THEN
LL_TMR := LL_TMR + 1
IF LL_TMR >= LL_DELAY_TICKS THEN
SET_ALARM(ALM_LEVEL_LL, CRITICAL)
// Force fill pump on in AUTO; trip drain pump
IF PUMP_FUNCTION = FILL THEN
PUMP_LATCH := TRUE
ELSE
PUMP_LATCH := FALSE
END_IF
END_IF
ELSE
LL_TMR := 0
CLEAR_ALARM(ALM_LEVEL_LL)
END_IF
// Low
IF LT001_PV <= SP_L AND LT001_PV > SP_LL THEN
L_TMR := L_TMR + 1
IF L_TMR >= L_DELAY_TICKS THEN
SET_ALARM(ALM_LEVEL_L, HIGH)
END_IF
ELSE
L_TMR := 0
CLEAR_ALARM(ALM_LEVEL_L)
END_IF
// High
IF LT001_PV >= SP_H AND LT001_PV < SP_HH THEN
H_TMR := H_TMR + 1
IF H_TMR >= H_DELAY_TICKS THEN
SET_ALARM(ALM_LEVEL_H, HIGH)
END_IF
ELSE
H_TMR := 0
CLEAR_ALARM(ALM_LEVEL_H)
END_IF
// High-High: emergency overflow prevention
IF LT001_PV >= SP_HH THEN
HH_TMR := HH_TMR + 1
IF HH_TMR >= HH_DELAY_TICKS THEN
SET_ALARM(ALM_LEVEL_HH, CRITICAL)
// Force fill pump off; energise overflow valve if fitted
PUMP_LATCH := FALSE
PUMP_CMD := FALSE
OVERFLOW_VALVE_CMD := TRUE
END_IF
ELSE
HH_TMR := 0
CLEAR_ALARM(ALM_LEVEL_HH)
OVERFLOW_VALVE_CMD := FALSE
END_IF
// Rapid level drop (potential leak)
IF LEVEL_RATE < -LEAK_RATE_THRESHOLD AND NOT PUMP_RUN_FB THEN
SET_ALARM(ALM_POSSIBLE_LEAK, HIGH)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 6 — RUN TIME / START CYCLE TRACKING
// ═══════════════════════════════════════════════════════════════
IF PUMP_RUN_FB THEN
RUNTIME_TICKS := RUNTIME_TICKS + 1
IF RUNTIME_TICKS >= 36000 THEN // 1h at 100ms scan
RUNTIME_HOURS := RUNTIME_HOURS + 1.0
RUNTIME_TICKS := 0
END_IF
END_IF
IF RISING_EDGE(PUMP_RUN_FB) THEN
START_COUNT := START_COUNT + 1
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 7 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_LEVEL_PV := LT001_PV
HMI_LEVEL_RATE := LEVEL_RATE
HMI_PUMP_RUNNING := PUMP_RUN_FB
HMI_PUMP_CMD := PUMP_CMD
HMI_MODE := MODE_SELECTOR
HMI_SP_LOW := SP_LOW
HMI_SP_HIGH := SP_HIGH
HMI_SP_L := SP_L
HMI_SP_H := SP_H
HMI_SP_LL := SP_LL
HMI_SP_HH := SP_HH
HMI_XMTR_FAULT := NOT LT001_VALID
HMI_RUNTIME_HOURS := RUNTIME_HOURS
HMI_START_COUNT := START_COUNT
HMI_PERMISSIVES_OK := PERMISSIVES_OK
END_ROUTINE
```
---
## Tag List
```csv
Tag Name,Description,Data Type,Direction,Engineering Unit,Range Min,Range Max,Default Value,Address
LT001_RAW_COUNTS,Level Transmitter Raw ADC Counts,INT,input,,0,27648,,AI:0:0.0
LT001_MA,Level Transmitter Milliamp Value,REAL,calculated,mA,0,20,,
LT001_PV_RAW,Level Process Value (Unfiltered),REAL,calculated,%,0,100,,
LT001_PV,Level Process Value (Median Filtered),REAL,calculated,%,0,100,,
LT001_PV_PREV,Level PV Previous Sample,REAL,internal,%,0,100,,
LT001_VALID,Level Transmitter Signal Healthy,BOOL,calculated,,,,TRUE,
LT001_FAULT,Level Transmitter Fault Active,BOOL,calculated,,,,FALSE,
LT001_LAST_GOOD,Last Valid Level Reading,REAL,internal,%,0,100,50,
LT001_HIST_0,Level History Sample 0 (newest),REAL,internal,%,0,100,,
LT001_HIST_1,Level History Sample 1,REAL,internal,%,0,100,,
LT001_HIST_2,Level History Sample 2 (oldest),REAL,internal,%,0,100,,
LEVEL_RANGE_MIN,Level Transmitter Physical Range Min,REAL,internal,%,0,0,0,
LEVEL_RANGE_MAX,Level Transmitter Physical Range Max,REAL,internal,%,0,100,100,
LEVEL_RATE,Level Rate of Change,REAL,calculated,%/s,-10,10,,
PUMP_CMD,Pump Start/Stop Command,BOOL,output,,,,FALSE,DO:1:0.0
PUMP_RUN_FB,Pump Running Feedback (Contactor Aux),BOOL,input,,,,FALSE,DI:0:0.0
PUMP_LATCH,Pump Control Latch (Seal-In),BOOL,internal,,,,FALSE,
PUMP_FAULT_LATCHED,Pump Latched Fault (Manual Reset),BOOL,internal,,,,FALSE,
PUMP_FUNCTION,Pump Function: 0=FILL 1=DRAIN,INT,internal,,0,1,0,
OVERFLOW_VALVE_CMD,Emergency Overflow Valve Command,BOOL,output,,,,FALSE,DO:1:0.1
MODE_SELECTOR,Operating Mode (0=OFF 1=MAN 2=AUTO),INT,input,,0,2,2,
MAN_START,Manual Start Command,BOOL,input,,,,FALSE,DI:0:0.1
MAN_STOP,Manual Stop Command,BOOL,input,,,,FALSE,DI:0:0.2
INHIBIT_CMD,External Inhibit Signal,BOOL,input,,,,FALSE,
PERM_OL_OK,Thermal Overload Relay Healthy (NC),BOOL,input,,,,TRUE,DI:0:0.3
PERM_ESTOP_OK,E-Stop Circuit Healthy (NC),BOOL,input,,,,TRUE,DI:0:0.4
PERMISSIVES_OK,All Permissives Satisfied,BOOL,calculated,,,,FALSE,
SP_LOW,Pump Start Setpoint (Low Level — Fill; or Stop — Drain),REAL,internal,%,0,100,20,
SP_HIGH,Pump Stop Setpoint (High Level — Fill; or Start — Drain),REAL,internal,%,0,100,80,
SP_LL,Low-Low Alarm Setpoint,REAL,internal,%,0,100,10,
SP_L,Low Alarm Setpoint,REAL,internal,%,0,100,15,
SP_H,High Alarm Setpoint,REAL,internal,%,0,100,85,
SP_HH,High-High Alarm & Emergency Setpoint,REAL,internal,%,0,100,92,
MIN_HYSTERESIS_BAND,Minimum Required Hysteresis Band Width,REAL,internal,%,1,50,5,
LEAK_RATE_THRESHOLD,Leak Detection Rate Threshold,REAL,internal,%/s,0,10,0.5,
LL_TMR,Low-Low Alarm Confirmation Timer (100ms ticks),INT,internal,,0,500,0,
L_TMR,Low Alarm Confirmation Timer (100ms ticks),INT,internal,,0,500,0,
H_TMR,High Alarm Confirmation Timer (100ms ticks),INT,internal,,0,500,0,
HH_TMR,High-High Alarm Confirmation Timer (100ms ticks),INT,internal,,0,500,0,
LL_DELAY_TICKS,Low-Low Alarm Delay Setting,INT,internal,,0,100,0,
L_DELAY_TICKS,Low Alarm Delay Setting,INT,internal,,0,300,20,
H_DELAY_TICKS,High Alarm Delay Setting,INT,internal,,0,300,20,
HH_DELAY_TICKS,High-High Alarm Delay Setting,INT,internal,,0,100,0,
RUNTIME_HOURS,Accumulated Runtime Hours,REAL,internal,h,0,99999,0,
RUNTIME_TICKS,Runtime Tick Accumulator (100ms),INT,internal,,0,36000,0,
START_COUNT,Total Start Count,DINT,internal,,0,999999,0,
ALM_LEVEL_LL,Level Low-Low Alarm (Critical),BOOL,calculated,,,,FALSE,
ALM_LEVEL_L,Level Low Alarm,BOOL,calculated,,,,FALSE,
ALM_LEVEL_H,Level High Alarm,BOOL,calculated,,,,FALSE,
ALM_LEVEL_HH,Level High-High Alarm (Critical),BOOL,calculated,,,,FALSE,
ALM_LT001_FAIL,Level Transmitter Failure Alarm,BOOL,calculated,,,,FALSE,
ALM_POSSIBLE_LEAK,Rapid Level Drop — Possible Leak,BOOL,calculated,,,,FALSE,
ALM_SETPOINT_CONFIG,Setpoint Configuration Error,BOOL,calculated,,,,FALSE,
HMI_LEVEL_PV,HMI: Tank Level Display,REAL,output,%,0,100,,
HMI_LEVEL_RATE,HMI: Level Rate of Change,REAL,output,%/s,-10,10,,
HMI_PUMP_RUNNING,HMI: Pump Running Status,BOOL,output,,,,FALSE,
HMI_PUMP_CMD,HMI: Pump Command State,BOOL,output,,,,FALSE,
HMI_MODE,HMI: Active Mode,INT,output,,0,2,2,
HMI_SP_LOW,HMI: Start Setpoint Display,REAL,output,%,0,100,20,
HMI_SP_HIGH,HMI: Stop Setpoint Display,REAL,output,%,0,100,80,
HMI_SP_L,HMI: Low Alarm Setpoint,REAL,output,%,0,100,15,
HMI_SP_H,HMI: High Alarm Setpoint,REAL,output,%,0,100,85,
HMI_SP_LL,HMI: Low-Low Alarm Setpoint,REAL,output,%,0,100,10,
HMI_SP_HH,HMI: High-High Alarm Setpoint,REAL,output,%,0,100,92,
HMI_XMTR_FAULT,HMI: Transmitter Fault Flag,BOOL,output,,,,FALSE,
HMI_RUNTIME_HOURS,HMI: Runtime Hours,REAL,output,h,0,99999,0,
HMI_START_COUNT,HMI: Start Count,DINT,output,,0,999999,0,
HMI_PERMISSIVES_OK,HMI: All Permissives OK,BOOL,output,,,,FALSE,
```
---
## Alarm Matrix
```csv
Alarm Tag,Condition,Setpoint,Priority,Type,Response,Delay,Auto Acknowledge
ALM_LEVEL_HH,LT001_PV >= SP_HH,92%,critical,safety,Pump stopped automatically. Overflow valve opened if fitted. Check inlet valve and downstream capacity immediately.,0s,No
ALM_LEVEL_LL,LT001_PV <= SP_LL,10%,critical,safety,Risk of pump cavitation or tank emptying. Fill pump forced on if in AUTO. Stop drain pump immediately.,0s,No
ALM_LT001_FAIL,LT001_VALID = FALSE,4mA wire-break,high,equipment,Transmitter signal lost. System holds last good value. Check transmitter wiring and loop supply. DO NOT operate in AUTO mode.,5s,No
ALM_POSSIBLE_LEAK,LEVEL_RATE < -0.5%/s AND NOT PUMP_RUN_FB,0.5%/s drop,high,process,Level dropping rapidly without pump running. Inspect tank and piping for leak. Isolate if confirmed.,10s,No
ALM_LEVEL_L,LT001_PV <= SP_L,15%,high,process,Level approaching low-low. Verify fill pump is running. Check supply source.,20s,No
ALM_LEVEL_H,LT001_PV >= SP_H,85%,high,process,Level approaching high-high. Verify fill pump stopped. Check inlet valve.,20s,No
ALM_SETPOINT_CONFIG,SP_HIGH - SP_LOW < MIN_HYSTERESIS_BAND,5% band,medium,diagnostic,Setpoints too close — risk of rapid pump cycling. Increase hysteresis band. Pump inhibited until corrected.,0s,No
```