Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Tank Liquidindustrial-automation
Level Alarm And Control — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 38 views
# Level Alarm and Control — Usage Guide
## Overview
Four-tier tank alarm scheme with confirmation delays and hysteresis, combined with simple fill and drain pump control. This template is suited to Siemens STEP 7 / TIA style applications where discrete alarms and on/off control are preferred over PID.
## Alarm Hierarchy
| Stage | Setpoint | Purpose |
|------|----------|---------|
| HH | `SP_HH` | Safety / overflow prevention |
| H | `SP_H` | Early warning high level |
| L | `SP_L` | Early warning low level |
| LL | `SP_LL` | Safety / dry-run prevention |
Each alarm uses confirmation delay plus reset hysteresis to prevent nuisance alarms from sloshing or transmitter noise.
## Control Strategy
- Fill pump starts at `FILL_ON_SP`, stops at `FILL_OFF_SP`
- Drain pump starts at `DRAIN_ON_SP`, stops at `DRAIN_OFF_SP`
- Fill and drain are mutually interlocked; only one runs at a time
- On transmitter failure, both pumps stop fail-safe
## Commissioning
1. Verify 4-20mA scaling from empty to full tank
2. Force each alarm threshold and confirm delay/hysteresis behaviour
3. Test fill pump start/stop thresholds with falling/rising level
4. Test drain pump start/stop thresholds with rising/falling level
5. Disconnect transmitter signal and confirm both pumps stop and `ALM_XMTR_FAIL` activates
---
## Control Logic — Vendor-Agnostic Pseudocode
# Level Alarm and Control — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-18.2 | STEP 7 / TIA Portal style
## Scan Rate: 100ms | Pattern: LL/L/H/HH 4-tier alarm staging with on/off pump control
```
ROUTINE: LevelAlarmControl
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL MEASUREMENT (4-20mA with wire-break detection)
// ═══════════════════════════════════════════════════════════════
LT001_MA := SCALE(LT001_RAW, 0, 27648, 4.0, 20.0)
LT001_VALID := (LT001_MA >= 3.8) AND (LT001_MA <= 20.5)
IF LT001_VALID THEN
LT001_PV := SCALE(LT001_MA, 4.0, 20.0, 0.0, 100.0)
LT001_LAST_GOOD := LT001_PV
XMTR_FAULT := FALSE
ELSE
LT001_PV := LT001_LAST_GOOD
XMTR_FAULT := TRUE
SET_ALARM(ALM_XMTR_FAIL, HIGH)
// Fail-safe: stop all pumps on transmitter loss
FILL_PUMP_CMD := FALSE
DRAIN_PUMP_CMD := FALSE
END_IF
// Rate of change calculation (level delta per 100ms scan)
LEVEL_ROC := LT001_PV - LT001_PV_PREV
LT001_PV_PREV := LT001_PV
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — 4-TIER ALARM STAGE PROCESSING
// Each stage uses confirmation timers (dead-time) per ISA-18.2.
// Timers reset when condition clears. Latch cleared only after
// condition drops below setpoint + hysteresis.
// ═══════════════════════════════════════════════════════════════
// --- HIGH-HIGH (Critical / Safety) ---
IF LT001_PV >= SP_HH THEN
ALM_HH_TMR := ALM_HH_TMR + 1
IF ALM_HH_TMR >= ALM_HH_DELAY THEN
ALM_LEVEL_HH := TRUE
SET_ALARM(ALM_LEVEL_HH, CRITICAL)
END_IF
ELSIF LT001_PV < (SP_HH - ALM_HYSTERESIS) THEN
ALM_HH_TMR := 0
ALM_LEVEL_HH := FALSE
END_IF
// --- HIGH (Warning) ---
IF LT001_PV >= SP_H AND NOT ALM_LEVEL_HH THEN
ALM_H_TMR := ALM_H_TMR + 1
IF ALM_H_TMR >= ALM_H_DELAY THEN
ALM_LEVEL_H := TRUE
SET_ALARM(ALM_LEVEL_H, HIGH)
END_IF
ELSIF LT001_PV < (SP_H - ALM_HYSTERESIS) THEN
ALM_H_TMR := 0
ALM_LEVEL_H := FALSE
END_IF
// --- LOW (Warning) ---
IF LT001_PV <= SP_L AND NOT ALM_LEVEL_LL THEN
ALM_L_TMR := ALM_L_TMR + 1
IF ALM_L_TMR >= ALM_L_DELAY THEN
ALM_LEVEL_L := TRUE
SET_ALARM(ALM_LEVEL_L, HIGH)
END_IF
ELSIF LT001_PV > (SP_L + ALM_HYSTERESIS) THEN
ALM_L_TMR := 0
ALM_LEVEL_L := FALSE
END_IF
// --- LOW-LOW (Critical / Safety) ---
IF LT001_PV <= SP_LL THEN
ALM_LL_TMR := ALM_LL_TMR + 1
IF ALM_LL_TMR >= ALM_LL_DELAY THEN
ALM_LEVEL_LL := TRUE
SET_ALARM(ALM_LEVEL_LL, CRITICAL)
END_IF
ELSIF LT001_PV > (SP_LL + ALM_HYSTERESIS) THEN
ALM_LL_TMR := 0
ALM_LEVEL_LL := FALSE
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — PUMP CONTROL
// FILL pump starts at low demand; stops at high setpoint.
// DRAIN pump starts at high demand; stops at low setpoint.
// Both pumps interlock: only one active at a time.
// ═══════════════════════════════════════════════════════════════
CASE MODE_SELECTOR OF
0: // OFF
FILL_PUMP_CMD := FALSE
DRAIN_PUMP_CMD := FALSE
1: // MANUAL
FILL_PUMP_CMD := MAN_FILL_CMD AND NOT XMTR_FAULT AND NOT ALM_LEVEL_HH
DRAIN_PUMP_CMD := MAN_DRAIN_CMD AND NOT XMTR_FAULT AND NOT ALM_LEVEL_LL
// Prevent both running simultaneously
IF FILL_PUMP_CMD AND DRAIN_PUMP_CMD THEN
DRAIN_PUMP_CMD := FALSE
END_IF
2: // AUTO
// Fill pump: ON below FILL_ON_SP, OFF above FILL_OFF_SP
IF LT001_PV <= FILL_ON_SP AND NOT XMTR_FAULT AND
NOT ALM_LEVEL_LL AND LT001_VALID THEN
FILL_PUMP_CMD := TRUE
END_IF
IF LT001_PV >= FILL_OFF_SP OR ALM_LEVEL_HH OR XMTR_FAULT THEN
FILL_PUMP_CMD := FALSE
END_IF
// Drain pump: ON above DRAIN_ON_SP, OFF below DRAIN_OFF_SP
IF LT001_PV >= DRAIN_ON_SP AND NOT XMTR_FAULT AND
NOT ALM_LEVEL_HH AND LT001_VALID THEN
DRAIN_PUMP_CMD := TRUE
END_IF
IF LT001_PV <= DRAIN_OFF_SP OR ALM_LEVEL_LL OR XMTR_FAULT THEN
DRAIN_PUMP_CMD := FALSE
END_IF
// Mutual interlock
IF FILL_PUMP_CMD AND DRAIN_PUMP_CMD THEN
FILL_PUMP_CMD := FALSE // Drain has priority in conflict
END_IF
END_CASE
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — RAPID CHANGE ALARM
// ═══════════════════════════════════════════════════════════════
IF ABS(LEVEL_ROC) > RAPID_CHANGE_THRESHOLD THEN
SET_ALARM(ALM_RAPID_CHANGE, MEDIUM)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 5 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_LEVEL_PV := LT001_PV
HMI_LEVEL_ROC := LEVEL_ROC
HMI_ALM_HH := ALM_LEVEL_HH
HMI_ALM_H := ALM_LEVEL_H
HMI_ALM_L := ALM_LEVEL_L
HMI_ALM_LL := ALM_LEVEL_LL
HMI_FILL_PUMP := FILL_PUMP_CMD
HMI_DRAIN_PUMP := DRAIN_PUMP_CMD
HMI_MODE := MODE_SELECTOR
HMI_XMTR_FAULT := XMTR_FAULT
END_ROUTINE
```
---
## Tag List
```csv
Tag Name,Description,Data Type,Direction,Engineering Unit,Range Min,Range Max,Default Value,Address
LT001_RAW,Level Transmitter Raw ADC,INT,input,,0,27648,,AI:0:0.0
LT001_MA,Level Transmitter mA,REAL,calculated,mA,3.8,20.5,,
LT001_PV,Level Process Value,REAL,calculated,%,0,100,,
LT001_VALID,Transmitter Healthy,BOOL,calculated,,,,TRUE,
LT001_LAST_GOOD,Last Good Level,REAL,internal,%,0,100,50,
LT001_PV_PREV,Previous Level for ROC,REAL,internal,%,0,100,50,
XMTR_FAULT,Transmitter Fault Active,BOOL,internal,,,,FALSE,
LEVEL_ROC,Level Rate of Change per Scan,REAL,calculated,%/scan,-100,100,0,
MODE_SELECTOR,Operating Mode (0=OFF 1=MAN 2=AUTO),INT,input,,0,2,2,
MAN_FILL_CMD,Manual Fill Pump Command,BOOL,input,,,,FALSE,
MAN_DRAIN_CMD,Manual Drain Pump Command,BOOL,input,,,,FALSE,
FILL_PUMP_CMD,Fill Pump Run Command,BOOL,output,,,,FALSE,DO:1:0.0
DRAIN_PUMP_CMD,Drain Pump Run Command,BOOL,output,,,,FALSE,DO:1:0.1
FILL_ON_SP,Fill Pump Start Setpoint,REAL,internal,%,0,100,25,
FILL_OFF_SP,Fill Pump Stop Setpoint,REAL,internal,%,0,100,55,
DRAIN_ON_SP,Drain Pump Start Setpoint,REAL,internal,%,0,100,75,
DRAIN_OFF_SP,Drain Pump Stop Setpoint,REAL,internal,%,0,100,45,
SP_LL,Level Low-Low Setpoint,REAL,internal,%,0,100,10,
SP_L,Level Low Setpoint,REAL,internal,%,0,100,20,
SP_H,Level High Setpoint,REAL,internal,%,0,100,80,
SP_HH,Level High-High Setpoint,REAL,internal,%,0,100,90,
ALM_HYSTERESIS,Alarm Reset Hysteresis,REAL,internal,%,0,10,2,
ALM_HH_TMR,HH Alarm Confirmation Timer,INT,internal,,0,1000,0,
ALM_H_TMR,H Alarm Confirmation Timer,INT,internal,,0,1000,0,
ALM_L_TMR,L Alarm Confirmation Timer,INT,internal,,0,1000,0,
ALM_LL_TMR,LL Alarm Confirmation Timer,INT,internal,,0,1000,0,
ALM_HH_DELAY,HH Alarm Delay (100ms ticks),INT,internal,,0,1000,10,
ALM_H_DELAY,H Alarm Delay (100ms ticks),INT,internal,,0,1000,30,
ALM_L_DELAY,L Alarm Delay (100ms ticks),INT,internal,,0,1000,30,
ALM_LL_DELAY,LL Alarm Delay (100ms ticks),INT,internal,,0,1000,10,
RAPID_CHANGE_THRESHOLD,Rate-of-Change Alarm Threshold,REAL,internal,%/scan,0,20,2,
ALM_LEVEL_HH,Level High-High Alarm Active,BOOL,calculated,,,,FALSE,
ALM_LEVEL_H,Level High Alarm Active,BOOL,calculated,,,,FALSE,
ALM_LEVEL_L,Level Low Alarm Active,BOOL,calculated,,,,FALSE,
ALM_LEVEL_LL,Level Low-Low Alarm Active,BOOL,calculated,,,,FALSE,
ALM_XMTR_FAIL,Transmitter Failure Alarm,BOOL,calculated,,,,FALSE,
ALM_RAPID_CHANGE,Rapid Level Change Alarm,BOOL,calculated,,,,FALSE,
HMI_LEVEL_PV,HMI: Level PV,REAL,output,%,0,100,,
HMI_LEVEL_ROC,HMI: Level Rate of Change,REAL,output,%/scan,-100,100,0,
HMI_ALM_HH,HMI: HH Alarm,BOOL,output,,,,FALSE,
HMI_ALM_H,HMI: H Alarm,BOOL,output,,,,FALSE,
HMI_ALM_L,HMI: L Alarm,BOOL,output,,,,FALSE,
HMI_ALM_LL,HMI: LL Alarm,BOOL,output,,,,FALSE,
HMI_FILL_PUMP,HMI: Fill Pump Status,BOOL,output,,,,FALSE,
HMI_DRAIN_PUMP,HMI: Drain Pump Status,BOOL,output,,,,FALSE,
HMI_MODE,HMI: Operating Mode,INT,output,,0,2,2,
HMI_XMTR_FAULT,HMI: Transmitter Fault,BOOL,output,,,,FALSE,
```
---
## Alarm Matrix
```csv
Alarm Tag,Condition,Setpoint,Priority,Type,Response,Delay,Auto Acknowledge
ALM_LEVEL_HH,LT001_PV >= SP_HH,90%,critical,safety,Immediate high-high alarm. Stop inflow or start emergency drain. Investigate risk of overflow.,1s,No
ALM_LEVEL_LL,LT001_PV <= SP_LL,10%,critical,safety,Immediate low-low alarm. Protect pumps from cavitation and check upstream supply.,1s,No
ALM_XMTR_FAIL,LT001_VALID = FALSE,wire-break,high,equipment,Transmitter failed. Pumps stopped fail-safe. Check wiring and loop power.,5s,No
ALM_LEVEL_H,LT001_PV >= SP_H,80%,high,process,Level high. Drain control should respond. Verify process demand and pump status.,3s,No
ALM_LEVEL_L,LT001_PV <= SP_L,20%,high,process,Level low. Fill control should respond. Verify supply and fill pump status.,3s,No
ALM_RAPID_CHANGE,ABS(LEVEL_ROC) > RAPID_CHANGE_THRESHOLD,>2%/scan,medium,diagnostic,Unexpected level movement. Check valve leakage, sensor noise, or sudden demand change.,0s,Yes
```