Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Pump Systemsindustrial-automation
Priority Liquid Level — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 39 views
# Priority-Based Liquid Level Control — Usage Guide
## Overview
3-stage cascaded priority pump control with redundant transmitter selection, runtime-equalised pump assignment, hysteresis-confirmed staging, and ISA-18.2 alarm hierarchy. Designed for high-demand applications: municipal water supply, fire water storage, cooling tower sumps, irrigation reserves.
## Stage Setpoint Design
```
SP_HH (95%) ── Emergency: ALL pumps stop
SP_H (85%) ── High alarm
[IDLE BAND]
SP_STAGE1_OFF (70%) ─┐
│ Stage 1 OFF band
SP_STAGE1_ON (40%) ─┘─ Stage 1 starts
SP_STAGE2_OFF (60%) ─┐
│ Stage 2 OFF band
SP_STAGE2_ON (25%) ─┘─ Stage 2 starts (Stage 1 must be running)
SP_L (15%) ── Low alarm
SP_STAGE3_OFF (50%) ─┐
│ Stage 3 OFF band
SP_STAGE3_ON (10%) ─┘─ EMERGENCY: Stage 3 starts immediately
SP_LL (5%) ── Critical low alarm
```
## Pump Assignment
Pumps are assigned to stages (1=lowest hours, 3=highest hours) automatically. Assignment only changes when all pumps are stopped, preventing disruption during operation.
## Staging Delays
| Parameter | Default | Purpose |
|-----------|---------|---------|
| `STAGE_ON_CONFIRM_TICKS` | 30 (3s) | Prevents staging on brief transient |
| `MIN_ON_TIME_TICKS` | 600 (60s) | Minimum run before de-staging |
Stage 3 (emergency) bypasses the start confirmation delay — immediate action required.
## Using with latching-interlock-pump
Connect each pump's `PERM_OK` output from the latching-interlock-pump template as input to this template's `PERM_OK_1/2/3`. This creates a clean separation between individual pump health and system-level staging logic.
---
## Control Logic — Vendor-Agnostic Pseudocode
# Priority-Based Liquid Level Control — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-18.2
## Scan Rate: 100ms | Pattern: 3-stage priority cascade with duty alternation
```
ROUTINE: PriorityLiquidLevelControl
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL MEASUREMENT & VALIDATION
// ═══════════════════════════════════════════════════════════════
// Scale 4-20mA inputs
FOR i := 0 TO 1 DO
LT_MA[i] := SCALE(LT_RAW[i], 0, 27648, 4.0, 20.0)
LT_VALID[i] := (LT_MA[i] >= 3.8) AND (LT_MA[i] <= 20.5)
IF LT_VALID[i] THEN
LT_PV[i] := SCALE(LT_MA[i], 4.0, 20.0, 0.0, 100.0)
LT_LAST_GOOD[i] := LT_PV[i]
ELSE
LT_PV[i] := LT_LAST_GOOD[i]
SET_ALARM(ALM_LT_FAIL[i], HIGH)
END_IF
END_FOR
// Select active transmitter (primary preferred; failover to secondary)
IF LT_VALID[0] THEN
LEVEL_PV := LT_PV[0]
ELSIF LT_VALID[1] THEN
LEVEL_PV := LT_PV[1]
SET_ALARM(ALM_LT_FAILOVER, MEDIUM)
ELSE
SET_ALARM(ALM_LT_BOTH_FAIL, CRITICAL)
// Failsafe: continue with last known; alarm prevents auto action
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — PRIORITY STAGE EVALUATION
// Stage 1 pump handles normal demand.
// Stage 2 pump brings additional capacity if level still falling.
// Stage 3 pump is emergency / maximum demand stage.
// Stages ADD progressively; none are removed until level recovers.
// ═══════════════════════════════════════════════════════════════
// Stage thresholds (fill application — pumps start to raise level)
// Stage 3 (emergency) starts first when level critically low
STAGE_3_START := (LEVEL_PV <= SP_STAGE3_ON)
STAGE_3_STOP := (LEVEL_PV >= SP_STAGE3_OFF)
// Stage 2 starts when level moderately low
STAGE_2_START := (LEVEL_PV <= SP_STAGE2_ON)
STAGE_2_STOP := (LEVEL_PV >= SP_STAGE2_OFF)
// Stage 1 — normal control range
STAGE_1_START := (LEVEL_PV <= SP_STAGE1_ON)
STAGE_1_STOP := (LEVEL_PV >= SP_STAGE1_OFF)
// Validate setpoint hierarchy
IF NOT (SP_STAGE3_ON < SP_STAGE2_ON AND
SP_STAGE2_ON < SP_STAGE1_ON AND
SP_STAGE1_OFF < SP_STAGE2_OFF AND
SP_STAGE2_OFF < SP_STAGE3_OFF) THEN
SET_ALARM(ALM_SP_CONFIG_ERROR, MEDIUM)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — PUMP ASSIGNMENT & PRIORITY LOGIC
// Pumps are assigned to stages based on runtime hours (API 610).
// Assignment is re-evaluated when all pumps stopped.
// ═══════════════════════════════════════════════════════════════
// Sort pumps by runtime hours (ascending — least hours = duty)
// Simplified for 3 pumps; production implementations use sort algorithm
IF (P1_HOURS <= P2_HOURS) AND (P1_HOURS <= P3_HOURS) THEN
STAGE1_PUMP := 1; STAGE2_PUMP := 2; STAGE3_PUMP := 3
ELSIF (P2_HOURS <= P1_HOURS) AND (P2_HOURS <= P3_HOURS) THEN
STAGE1_PUMP := 2; STAGE2_PUMP := 1; STAGE3_PUMP := 3
ELSE
STAGE1_PUMP := 3; STAGE2_PUMP := 1; STAGE3_PUMP := 2
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — STAGE LATCH CONTROL WITH HYSTERESIS TIMERS
// Minimum on-time prevents rapid cycling across stage boundaries.
// Confirmation delays prevent nuisance staging on transient levels.
// ═══════════════════════════════════════════════════════════════
// Stage 1 latch
IF STAGE_1_START AND NOT STAGE1_LATCH THEN
STAGE1_ON_TMR := STAGE1_ON_TMR + 1
IF STAGE1_ON_TMR >= STAGE_ON_CONFIRM_TICKS THEN
STAGE1_LATCH := TRUE
STAGE1_ON_TMR := 0
END_IF
ELSE
STAGE1_ON_TMR := 0
END_IF
IF STAGE_1_STOP AND STAGE1_LATCH THEN
STAGE1_OFF_TMR := STAGE1_OFF_TMR + 1
IF STAGE1_OFF_TMR >= MIN_ON_TIME_TICKS THEN
STAGE1_LATCH := FALSE
STAGE1_OFF_TMR := 0
END_IF
ELSE
STAGE1_OFF_TMR := 0
END_IF
// Stage 2 latch (only activates if Stage 1 already running)
IF STAGE_2_START AND STAGE1_LATCH AND NOT STAGE2_LATCH THEN
STAGE2_ON_TMR := STAGE2_ON_TMR + 1
IF STAGE2_ON_TMR >= STAGE_ON_CONFIRM_TICKS THEN
STAGE2_LATCH := TRUE
STAGE2_ON_TMR := 0
END_IF
ELSE
STAGE2_ON_TMR := 0
END_IF
IF STAGE_2_STOP AND STAGE2_LATCH THEN
STAGE2_OFF_TMR := STAGE2_OFF_TMR + 1
IF STAGE2_OFF_TMR >= MIN_ON_TIME_TICKS THEN
STAGE2_LATCH := FALSE
STAGE2_OFF_TMR := 0
END_IF
ELSE
STAGE2_OFF_TMR := 0
END_IF
// Stage 3 latch — emergency; overrides staging confirmation delay
IF STAGE_3_START THEN
STAGE3_LATCH := TRUE // Immediate start; no confirmation delay in emergency
SET_ALARM(ALM_STAGE3_ACTIVE, HIGH)
END_IF
IF STAGE_3_STOP THEN
STAGE3_LATCH := FALSE
CLEAR_ALARM(ALM_STAGE3_ACTIVE)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 5 — OUTPUT COMMANDS
// Map stage latches to assigned pump commands.
// Permissive check per pump before energising.
// ═══════════════════════════════════════════════════════════════
PUMP_CMD[1] := FALSE
PUMP_CMD[2] := FALSE
PUMP_CMD[3] := FALSE
IF STAGE1_LATCH AND PERM_OK[STAGE1_PUMP] THEN
PUMP_CMD[STAGE1_PUMP] := TRUE
END_IF
IF STAGE2_LATCH AND PERM_OK[STAGE2_PUMP] THEN
PUMP_CMD[STAGE2_PUMP] := TRUE
END_IF
IF STAGE3_LATCH AND PERM_OK[STAGE3_PUMP] THEN
PUMP_CMD[STAGE3_PUMP] := TRUE
END_IF
// Count active pumps
PUMPS_RUNNING := 0
FOR i := 1 TO 3 DO
IF PUMP_RUN_FB[i] THEN
PUMPS_RUNNING := PUMPS_RUNNING + 1
END_IF
END_FOR
// ═══════════════════════════════════════════════════════════════
// SECTION 6 — ISA-18.2 ALARMS
// ═══════════════════════════════════════════════════════════════
IF LEVEL_PV >= SP_HH THEN
SET_ALARM(ALM_LEVEL_HH, CRITICAL)
STAGE1_LATCH := FALSE; STAGE2_LATCH := FALSE; STAGE3_LATCH := FALSE
PUMP_CMD[1] := FALSE; PUMP_CMD[2] := FALSE; PUMP_CMD[3] := FALSE
END_IF
IF LEVEL_PV >= SP_H THEN SET_ALARM(ALM_LEVEL_H, HIGH) END_IF
IF LEVEL_PV <= SP_L THEN SET_ALARM(ALM_LEVEL_L, HIGH) END_IF
IF LEVEL_PV <= SP_LL THEN SET_ALARM(ALM_LEVEL_LL, CRITICAL) END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 7 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_LEVEL_PV := LEVEL_PV
HMI_PUMPS_RUNNING := PUMPS_RUNNING
HMI_STAGE1_ACTIVE := STAGE1_LATCH
HMI_STAGE2_ACTIVE := STAGE2_LATCH
HMI_STAGE3_ACTIVE := STAGE3_LATCH
HMI_STAGE1_PUMP := STAGE1_PUMP
HMI_STAGE2_PUMP := STAGE2_PUMP
HMI_STAGE3_PUMP := STAGE3_PUMP
HMI_P1_HOURS := P1_HOURS
HMI_P2_HOURS := P2_HOURS
HMI_P3_HOURS := P3_HOURS
END_ROUTINE
```
---
## Tag List
```csv
Tag Name,Description,Data Type,Direction,Engineering Unit,Range Min,Range Max,Default Value,Address
LT_RAW_0,Level Transmitter 1 Raw Counts,INT,input,,0,27648,,AI:0:0.0
LT_RAW_1,Level Transmitter 2 Raw Counts (Redundant),INT,input,,0,27648,,AI:0:0.1
LT_MA_0,Transmitter 1 mA Value,REAL,calculated,mA,3.8,20.5,,
LT_MA_1,Transmitter 2 mA Value,REAL,calculated,mA,3.8,20.5,,
LT_PV_0,Transmitter 1 Level Process Value,REAL,calculated,%,0,100,,
LT_PV_1,Transmitter 2 Level Process Value,REAL,calculated,%,0,100,,
LT_VALID_0,Transmitter 1 Signal Healthy,BOOL,calculated,,,,TRUE,
LT_VALID_1,Transmitter 2 Signal Healthy,BOOL,calculated,,,,TRUE,
LT_LAST_GOOD_0,Transmitter 1 Last Good Reading,REAL,internal,%,0,100,50,
LT_LAST_GOOD_1,Transmitter 2 Last Good Reading,REAL,internal,%,0,100,50,
LEVEL_PV,Active Level Process Value,REAL,calculated,%,0,100,,
SP_STAGE1_ON,Stage 1 Start Setpoint,REAL,internal,%,0,100,40,
SP_STAGE1_OFF,Stage 1 Stop Setpoint,REAL,internal,%,0,100,70,
SP_STAGE2_ON,Stage 2 Start Setpoint,REAL,internal,%,0,100,25,
SP_STAGE2_OFF,Stage 2 Stop Setpoint,REAL,internal,%,0,100,60,
SP_STAGE3_ON,Stage 3 Emergency Start Setpoint,REAL,internal,%,0,100,10,
SP_STAGE3_OFF,Stage 3 Emergency Stop Setpoint,REAL,internal,%,0,100,50,
SP_LL,Low-Low Alarm Setpoint,REAL,internal,%,0,100,5,
SP_L,Low Alarm Setpoint,REAL,internal,%,0,100,15,
SP_H,High Alarm Setpoint,REAL,internal,%,0,100,85,
SP_HH,High-High Trip Setpoint,REAL,internal,%,0,100,95,
STAGE1_LATCH,Stage 1 Control Latch,BOOL,internal,,,,FALSE,
STAGE2_LATCH,Stage 2 Control Latch,BOOL,internal,,,,FALSE,
STAGE3_LATCH,Stage 3 Emergency Latch,BOOL,internal,,,,FALSE,
STAGE1_PUMP,Pump Assigned to Stage 1 (1/2/3),INT,internal,,1,3,1,
STAGE2_PUMP,Pump Assigned to Stage 2 (1/2/3),INT,internal,,1,3,2,
STAGE3_PUMP,Pump Assigned to Stage 3 (1/2/3),INT,internal,,1,3,3,
STAGE1_ON_TMR,Stage 1 Start Confirmation Timer,INT,internal,,0,500,0,
STAGE2_ON_TMR,Stage 2 Start Confirmation Timer,INT,internal,,0,500,0,
STAGE1_OFF_TMR,Stage 1 Minimum On-Time Timer,INT,internal,,0,1000,0,
STAGE2_OFF_TMR,Stage 2 Minimum On-Time Timer,INT,internal,,0,1000,0,
STAGE_ON_CONFIRM_TICKS,Stage Start Confirmation Delay (100ms ticks),INT,internal,,0,300,30,
MIN_ON_TIME_TICKS,Minimum Pump On-Time (100ms ticks),INT,internal,,0,3000,600,
PUMP_CMD_1,Pump 1 Command Output,BOOL,output,,,,FALSE,DO:1:0.0
PUMP_CMD_2,Pump 2 Command Output,BOOL,output,,,,FALSE,DO:1:0.1
PUMP_CMD_3,Pump 3 Command Output,BOOL,output,,,,FALSE,DO:1:0.2
PUMP_RUN_FB_1,Pump 1 Running Feedback,BOOL,input,,,,FALSE,DI:0:0.0
PUMP_RUN_FB_2,Pump 2 Running Feedback,BOOL,input,,,,FALSE,DI:0:0.1
PUMP_RUN_FB_3,Pump 3 Running Feedback,BOOL,input,,,,FALSE,DI:0:0.2
PERM_OK_1,Pump 1 Permissives Satisfied,BOOL,input,,,,FALSE,
PERM_OK_2,Pump 2 Permissives Satisfied,BOOL,input,,,,FALSE,
PERM_OK_3,Pump 3 Permissives Satisfied,BOOL,input,,,,FALSE,
P1_HOURS,Pump 1 Runtime Hours,REAL,internal,h,0,99999,0,
P2_HOURS,Pump 2 Runtime Hours,REAL,internal,h,0,99999,0,
P3_HOURS,Pump 3 Runtime Hours,REAL,internal,h,0,99999,0,
PUMPS_RUNNING,Number of Pumps Currently Running,INT,calculated,,0,3,0,
ALM_LT_FAIL_0,Level Transmitter 1 Failure,BOOL,calculated,,,,FALSE,
ALM_LT_FAIL_1,Level Transmitter 2 Failure,BOOL,calculated,,,,FALSE,
ALM_LT_FAILOVER,System Using Backup Transmitter,BOOL,calculated,,,,FALSE,
ALM_LT_BOTH_FAIL,Both Level Transmitters Failed,BOOL,calculated,,,,FALSE,
ALM_LEVEL_LL,Level Low-Low Critical Alarm,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 Trip Alarm,BOOL,calculated,,,,FALSE,
ALM_STAGE3_ACTIVE,Emergency Stage 3 Active Alarm,BOOL,calculated,,,,FALSE,
ALM_SP_CONFIG_ERROR,Setpoint Configuration Hierarchy Error,BOOL,calculated,,,,FALSE,
HMI_LEVEL_PV,HMI: Active Level Display,REAL,output,%,0,100,,
HMI_PUMPS_RUNNING,HMI: Pumps Currently Running Count,INT,output,,0,3,0,
HMI_STAGE1_ACTIVE,HMI: Stage 1 Active Flag,BOOL,output,,,,FALSE,
HMI_STAGE2_ACTIVE,HMI: Stage 2 Active Flag,BOOL,output,,,,FALSE,
HMI_STAGE3_ACTIVE,HMI: Stage 3 Active Flag,BOOL,output,,,,FALSE,
HMI_STAGE1_PUMP,HMI: Stage 1 Assigned Pump Number,INT,output,,1,3,1,
HMI_STAGE2_PUMP,HMI: Stage 2 Assigned Pump Number,INT,output,,1,3,2,
HMI_STAGE3_PUMP,HMI: Stage 3 Assigned Pump Number,INT,output,,1,3,3,
HMI_P1_HOURS,HMI: Pump 1 Runtime Hours,REAL,output,h,0,99999,0,
HMI_P2_HOURS,HMI: Pump 2 Runtime Hours,REAL,output,h,0,99999,0,
HMI_P3_HOURS,HMI: Pump 3 Runtime Hours,REAL,output,h,0,99999,0,
```
---
## Alarm Matrix
```csv
Alarm Tag,Condition,Setpoint,Priority,Type,Response,Delay,Auto Acknowledge
ALM_LT_BOTH_FAIL,LT_VALID_0=FALSE AND LT_VALID_1=FALSE,N/A,critical,safety,Both level transmitters failed. System holding last value. Do not operate in AUTO. Manual inspection required.,0s,No
ALM_LEVEL_HH,LEVEL_PV >= SP_HH,95%,critical,safety,All pumps stopped automatically. Overflow risk. Check inlet isolation and downstream.,0s,No
ALM_LEVEL_LL,LEVEL_PV <= SP_LL,5%,critical,safety,Emergency Stage 3 active. All three pumps running. Check supply source.,0s,No
ALM_STAGE3_ACTIVE,STAGE3_LATCH = TRUE,10%,high,process,Maximum demand — all three pumps running. Investigate rapid level drop cause.,0s,No
ALM_LT_FAILOVER,LT_VALID_0=FALSE AND LT_VALID_1=TRUE,N/A,high,equipment,Primary transmitter failed; using backup. Restore primary before next shutdown.,5s,No
ALM_LEVEL_L,LEVEL_PV <= SP_L,15%,high,process,Stage 2 approaching. Verify all stage 1 pumps healthy. Check supply source.,20s,No
ALM_LEVEL_H,LEVEL_PV >= SP_H,85%,high,process,Level approaching high-high. Check demand — ensure stage pumps will stop.,20s,No
ALM_LT_FAIL_0,LT_VALID_0 = FALSE,N/A,medium,equipment,Primary transmitter 1 signal lost. Check wiring and loop supply.,5s,No
ALM_LT_FAIL_1,LT_VALID_1 = FALSE,N/A,medium,equipment,Backup transmitter 2 signal lost. Check wiring and loop supply.,5s,No
ALM_SP_CONFIG_ERROR,Setpoint hierarchy invalid,N/A,medium,diagnostic,Stage setpoints not in correct order. Correct configuration before AUTO operation.,0s,No
```