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 · 94 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 ```

More like this

Rate, comment, and get full access

Members can download files, rate contributions, and discuss fixes with the engineers who posted them — free.

Join the library