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

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