Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Tank Liquidindustrial-automation
Fill Drain Logic — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 37 views
# Tank Fill & Drain Logic — Usage Guide
## Overview
Multi-mode tank control (OFF / MANUAL / AUTO-FILL / AUTO-DRAIN / BATCH SEQUENCE) with dual-valve discrepancy monitoring, ISA-88 sequence state machine, fill/drain timeout, and ISA-18.2 alarm hierarchy. Suitable for: process feed tanks, CIP tanks, chemical preparation vessels, buffer storage, water treatment contact tanks.
## Operating Modes
| Mode | Value | Behaviour |
|------|-------|-----------|
| OFF | 0 | All valves closed. No automatic actions. |
| MANUAL | 1 | Operator controls each valve directly. Safety overrides still active. |
| AUTO FILL | 2 | Fills tank between FILL_SP_LOW and FILL_SP_HIGH automatically. |
| AUTO DRAIN | 3 | Drains tank between DRAIN_SP_LOW and DRAIN_SP_HIGH automatically. |
| SEQUENCE | 4 | ISA-88 Fill → Hold → Drain batch cycle. |
## Batch Sequence States
```
0: IDLE ──► [SEQ_START] ──► 1: FILLING
│ level >= FILL_SP_HIGH
▼
2: HOLD (HOLD_TIME_TICKS)
│ timer elapsed
▼
3: DRAINING
│ level <= DRAIN_SP_LOW
▼
4: COMPLETE ──► [CONTINUOUS?] ──► 0: IDLE (restart)
└► 0: IDLE (wait)
Timeout ──► 5: FAULT ──► [SEQ_RESET] ──► 0: IDLE
```
## Safety Override Logic (always active)
1. **LT001_PV ≥ SP_HH** → XV_FILL_CMD forced FALSE (overflow prevention)
2. **LT001_PV ≤ SP_LL** → XV_DRAIN_CMD forced FALSE (cavitation prevention)
3. **LT001_VALID = FALSE** → Both valves closed (fail-safe on transmitter loss)
4. **Both valves commanded** → Drain yields to fill (interlock conflict resolution)
## Valve Wiring
Valves are configured as normally-closed (de-energise-to-close) for fail-safe. Adjust LS logic if normally-open actuators are used.
## Commissioning
1. In MANUAL mode — manually open fill valve, confirm XV_FILL_OPEN_LS activates
2. Manually open drain valve — confirm XV_DRAIN_OPEN_LS activates
3. Test discrepancy alarm: remove LS input while valve commanded open, confirm alarm after travel time
4. Test HIGH-HIGH override: force level to SP_HH — confirm fill valve closes
5. Test LOW-LOW override: force level to SP_LL — confirm drain valve closes
6. Test full batch sequence: observe all 4 phases complete and audit log entries
7. Test fill timeout: set FILL_TIMEOUT_TICKS small and confirm fault state reached
---
## Control Logic — Vendor-Agnostic Pseudocode
# Tank Fill & Drain Logic — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-88 | ISA-18.2
## Scan Rate: 100ms | Pattern: Dual-valve fill/drain with auto/manual/sequence modes
```
ROUTINE: TankFillDrainLogic
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL MEASUREMENT (4-20mA with failsafe)
// ═══════════════════════════════════════════════════════════════
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
ELSE
LT001_PV := LT001_LAST_GOOD
SET_ALARM(ALM_LT001_FAIL, HIGH)
// Failsafe: close both valves on transmitter failure
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — VALVE POSITION VERIFICATION
// Limit switches confirm valve physical position.
// Discrepancy between command and LS → alarm after timeout.
// ═══════════════════════════════════════════════════════════════
// Fill valve discrepancy check
IF XV_FILL_CMD <> XV_FILL_OPEN_LS THEN
XV_FILL_DISC_TMR := XV_FILL_DISC_TMR + 1
IF XV_FILL_DISC_TMR >= VALVE_TRAVEL_TIME_TICKS THEN
SET_ALARM(ALM_XV_FILL_DISC, MEDIUM)
END_IF
ELSE
XV_FILL_DISC_TMR := 0
CLEAR_ALARM(ALM_XV_FILL_DISC)
END_IF
// Drain valve discrepancy check
IF XV_DRAIN_CMD <> XV_DRAIN_OPEN_LS THEN
XV_DRAIN_DISC_TMR := XV_DRAIN_DISC_TMR + 1
IF XV_DRAIN_DISC_TMR >= VALVE_TRAVEL_TIME_TICKS THEN
SET_ALARM(ALM_XV_DRAIN_DISC, MEDIUM)
END_IF
ELSE
XV_DRAIN_DISC_TMR := 0
CLEAR_ALARM(ALM_XV_DRAIN_DISC)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — OPERATING MODE STATE MACHINE
// Mode 0: OFF — all valves closed, no actions
// Mode 1: MANUAL — operator controls each valve independently
// Mode 2: AUTO FILL — fills to FILL_SP_HIGH, stops at SP_HIGH
// Mode 3: AUTO DRAIN — drains to SP_LOW, stops at SP_LOW
// Mode 4: SEQUENCE — fill then hold then drain (batch cycle)
// ═══════════════════════════════════════════════════════════════
CASE MODE_SELECTOR OF
0: // OFF
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
SEQ_STATE := 0
1: // MANUAL
XV_FILL_CMD := MAN_FILL_CMD AND LT001_VALID AND NOT (LT001_PV >= SP_HH)
XV_DRAIN_CMD := MAN_DRAIN_CMD AND LT001_VALID AND NOT (LT001_PV <= SP_LL)
2: // AUTO FILL — hysteresis band
XV_DRAIN_CMD := FALSE
IF LT001_PV <= FILL_SP_LOW AND LT001_VALID THEN
XV_FILL_CMD := TRUE
END_IF
IF LT001_PV >= FILL_SP_HIGH THEN
XV_FILL_CMD := FALSE
END_IF
3: // AUTO DRAIN — hysteresis band
XV_FILL_CMD := FALSE
IF LT001_PV >= DRAIN_SP_HIGH AND LT001_VALID THEN
XV_DRAIN_CMD := TRUE
END_IF
IF LT001_PV <= DRAIN_SP_LOW THEN
XV_DRAIN_CMD := FALSE
END_IF
4: // SEQUENCE — ISA-88 batch cycle
CASE SEQ_STATE OF
0: // IDLE — wait for sequence start command
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
IF SEQ_START AND LT001_VALID THEN
SEQ_STATE := 1
SEQ_BATCH_COUNT := SEQ_BATCH_COUNT + 1
AUDIT_LOG(EVENT="BATCH_CYCLE_START",
BATCH=SEQ_BATCH_COUNT)
END_IF
1: // FILLING — open fill valve; wait for SP_HIGH
XV_FILL_CMD := TRUE
XV_DRAIN_CMD := FALSE
FILL_TIMEOUT_TMR := FILL_TIMEOUT_TMR + 1
IF LT001_PV >= FILL_SP_HIGH THEN
XV_FILL_CMD := FALSE
SEQ_STATE := 2
FILL_TIMEOUT_TMR := 0
AUDIT_LOG(EVENT="FILL_COMPLETE", LEVEL=LT001_PV)
END_IF
IF FILL_TIMEOUT_TMR >= FILL_TIMEOUT_TICKS THEN
SET_ALARM(ALM_FILL_TIMEOUT, HIGH)
SEQ_STATE := 5 // Fault state
END_IF
2: // HOLD — soak / reaction / process time
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
HOLD_TMR := HOLD_TMR + 1
IF HOLD_TMR >= HOLD_TIME_TICKS THEN
HOLD_TMR := 0
SEQ_STATE := 3
AUDIT_LOG(EVENT="HOLD_COMPLETE")
END_IF
3: // DRAINING — open drain valve; wait for SP_LOW
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := TRUE
DRAIN_TIMEOUT_TMR := DRAIN_TIMEOUT_TMR + 1
IF LT001_PV <= DRAIN_SP_LOW THEN
XV_DRAIN_CMD := FALSE
SEQ_STATE := 4
DRAIN_TIMEOUT_TMR := 0
AUDIT_LOG(EVENT="DRAIN_COMPLETE", LEVEL=LT001_PV)
END_IF
IF DRAIN_TIMEOUT_TMR >= DRAIN_TIMEOUT_TICKS THEN
SET_ALARM(ALM_DRAIN_TIMEOUT, HIGH)
SEQ_STATE := 5
END_IF
4: // COMPLETE — cycle done; auto-restart if continuous mode
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
AUDIT_LOG(EVENT="BATCH_CYCLE_COMPLETE",
BATCH=SEQ_BATCH_COUNT)
IF CONTINUOUS_MODE THEN
SEQ_STATE := 0 // Return to idle (auto-restart)
SEQ_START := TRUE
ELSE
SEQ_STATE := 0
END_IF
5: // FAULT
XV_FILL_CMD := FALSE
XV_DRAIN_CMD := FALSE
SET_ALARM(ALM_SEQ_FAULT, HIGH)
IF SEQ_RESET THEN
SEQ_STATE := 0
CLEAR_ALARM(ALM_SEQ_FAULT)
CLEAR_ALARM(ALM_FILL_TIMEOUT)
CLEAR_ALARM(ALM_DRAIN_TIMEOUT)
END_IF
END_CASE
END_CASE
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — SAFETY OVERRIDES (always active, regardless of mode)
// Safety overrides take priority over all mode-based logic.
// ═══════════════════════════════════════════════════════════════
// High-High: close fill valve
IF LT001_PV >= SP_HH THEN
XV_FILL_CMD := FALSE
SET_ALARM(ALM_LEVEL_HH, CRITICAL)
END_IF
// Low-Low: close drain valve (prevent air ingestion/pump damage)
IF LT001_PV <= SP_LL THEN
XV_DRAIN_CMD := FALSE
SET_ALARM(ALM_LEVEL_LL, CRITICAL)
END_IF
// Interlock: never open both valves simultaneously
IF XV_FILL_CMD AND XV_DRAIN_CMD THEN
XV_DRAIN_CMD := FALSE // Drain yields to fill in conflict
SET_ALARM(ALM_DUAL_VALVE_CONFLICT, MEDIUM)
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 5 — ALARM PROCESSING (ISA-18.2)
// ═══════════════════════════════════════════════════════════════
IF LT001_PV >= SP_H THEN SET_ALARM(ALM_LEVEL_H, HIGH) END_IF
IF LT001_PV <= SP_L THEN SET_ALARM(ALM_LEVEL_L, HIGH) END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 6 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_LEVEL_PV := LT001_PV
HMI_MODE := MODE_SELECTOR
HMI_SEQ_STATE := SEQ_STATE
HMI_FILL_VALVE := XV_FILL_OPEN_LS
HMI_DRAIN_VALVE := XV_DRAIN_OPEN_LS
HMI_FILL_CMD := XV_FILL_CMD
HMI_DRAIN_CMD := XV_DRAIN_CMD
HMI_BATCH_COUNT := SEQ_BATCH_COUNT
HMI_HOLD_ELAPSED := HOLD_TMR
HMI_HOLD_TOTAL := HOLD_TIME_TICKS
HMI_XMTR_FAULT := NOT LT001_VALID
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 Counts,INT,input,,0,27648,,AI:0:0.0
LT001_MA,Level Transmitter mA Value,REAL,calculated,mA,3.8,20.5,,
LT001_PV,Tank Level Process Value,REAL,calculated,%,0,100,,
LT001_VALID,Level Transmitter Healthy,BOOL,calculated,,,,TRUE,
LT001_LAST_GOOD,Last Good Level Reading,REAL,internal,%,0,100,50,
XV_FILL_CMD,Fill Valve Command (Open=TRUE),BOOL,output,,,,FALSE,DO:1:0.0
XV_DRAIN_CMD,Drain Valve Command (Open=TRUE),BOOL,output,,,,FALSE,DO:1:0.1
XV_FILL_OPEN_LS,Fill Valve Open Limit Switch,BOOL,input,,,,FALSE,DI:0:0.0
XV_FILL_CLOSED_LS,Fill Valve Closed Limit Switch,BOOL,input,,,,TRUE,DI:0:0.1
XV_DRAIN_OPEN_LS,Drain Valve Open Limit Switch,BOOL,input,,,,FALSE,DI:0:0.2
XV_DRAIN_CLOSED_LS,Drain Valve Closed Limit Switch,BOOL,input,,,,TRUE,DI:0:0.3
XV_FILL_DISC_TMR,Fill Valve Discrepancy Timer (100ms ticks),INT,internal,,0,500,0,
XV_DRAIN_DISC_TMR,Drain Valve Discrepancy Timer (100ms ticks),INT,internal,,0,500,0,
VALVE_TRAVEL_TIME_TICKS,Valve Travel Time Allowance (100ms ticks),INT,internal,,10,300,60,
MODE_SELECTOR,Operating Mode (0=OFF 1=MAN 2=AUTO-FILL 3=AUTO-DRAIN 4=SEQ),INT,input,,0,4,0,
MAN_FILL_CMD,Manual Fill Valve Open Command,BOOL,input,,,,FALSE,
MAN_DRAIN_CMD,Manual Drain Valve Open Command,BOOL,input,,,,FALSE,
FILL_SP_LOW,Fill Start Setpoint (Fill below this),REAL,internal,%,0,100,20,
FILL_SP_HIGH,Fill Stop Setpoint (Fill stops here),REAL,internal,%,0,100,80,
DRAIN_SP_HIGH,Drain Start Setpoint (Drain above this),REAL,internal,%,0,100,85,
DRAIN_SP_LOW,Drain Stop Setpoint (Drain stops here),REAL,internal,%,0,100,15,
SP_LL,Low-Low Safety Setpoint,REAL,internal,%,0,100,5,
SP_L,Low Alarm Setpoint,REAL,internal,%,0,100,10,
SP_H,High Alarm Setpoint,REAL,internal,%,0,100,85,
SP_HH,High-High Safety Setpoint,REAL,internal,%,0,100,95,
SEQ_STATE,Sequence State Machine State,INT,internal,,0,5,0,
SEQ_START,Sequence Start Command,BOOL,input,,,,FALSE,
SEQ_RESET,Sequence Fault Reset Command,BOOL,input,,,,FALSE,
SEQ_BATCH_COUNT,Completed Batch Cycle Count,DINT,internal,,0,999999,0,
CONTINUOUS_MODE,Auto-Restart Batch on Completion,BOOL,internal,,,,FALSE,
HOLD_TMR,Hold Phase Timer (100ms ticks),INT,internal,,0,360000,0,
HOLD_TIME_TICKS,Hold Phase Duration Setting (100ms ticks),INT,internal,,0,360000,3000,
FILL_TIMEOUT_TMR,Fill Phase Timeout Timer,INT,internal,,0,36000,0,
FILL_TIMEOUT_TICKS,Fill Phase Maximum Time (100ms ticks),INT,internal,,100,36000,1800,
DRAIN_TIMEOUT_TMR,Drain Phase Timeout Timer,INT,internal,,0,36000,0,
DRAIN_TIMEOUT_TICKS,Drain Phase Maximum Time (100ms ticks),INT,internal,,100,36000,1800,
ALM_LT001_FAIL,Level Transmitter Failure Alarm,BOOL,calculated,,,,FALSE,
ALM_LEVEL_LL,Tank Level Low-Low Critical,BOOL,calculated,,,,FALSE,
ALM_LEVEL_L,Tank Level Low Alarm,BOOL,calculated,,,,FALSE,
ALM_LEVEL_H,Tank Level High Alarm,BOOL,calculated,,,,FALSE,
ALM_LEVEL_HH,Tank Level High-High Critical,BOOL,calculated,,,,FALSE,
ALM_XV_FILL_DISC,Fill Valve Position Discrepancy,BOOL,calculated,,,,FALSE,
ALM_XV_DRAIN_DISC,Drain Valve Position Discrepancy,BOOL,calculated,,,,FALSE,
ALM_DUAL_VALVE_CONFLICT,Both Valves Commanded Open Simultaneously,BOOL,calculated,,,,FALSE,
ALM_FILL_TIMEOUT,Fill Phase Timeout — Tank Not Reaching Setpoint,BOOL,calculated,,,,FALSE,
ALM_DRAIN_TIMEOUT,Drain Phase Timeout — Tank Not Reaching Setpoint,BOOL,calculated,,,,FALSE,
ALM_SEQ_FAULT,Sequence Fault — Manual Reset Required,BOOL,calculated,,,,FALSE,
HMI_LEVEL_PV,HMI: Tank Level,REAL,output,%,0,100,,
HMI_MODE,HMI: Operating Mode,INT,output,,0,4,0,
HMI_SEQ_STATE,HMI: Sequence State,INT,output,,0,5,0,
HMI_FILL_VALVE,HMI: Fill Valve State (Open LS),BOOL,output,,,,FALSE,
HMI_DRAIN_VALVE,HMI: Drain Valve State (Open LS),BOOL,output,,,,FALSE,
HMI_FILL_CMD,HMI: Fill Valve Command,BOOL,output,,,,FALSE,
HMI_DRAIN_CMD,HMI: Drain Valve Command,BOOL,output,,,,FALSE,
HMI_BATCH_COUNT,HMI: Completed Batch Count,DINT,output,,0,999999,0,
HMI_HOLD_ELAPSED,HMI: Hold Phase Elapsed Ticks,INT,output,,0,360000,0,
HMI_HOLD_TOTAL,HMI: Hold Phase Total Setting,INT,output,,0,360000,3000,
HMI_XMTR_FAULT,HMI: Transmitter Fault Flag,BOOL,output,,,,FALSE,
```
---
## Alarm Matrix
```csv
Alarm Tag,Condition,Setpoint,Priority,Type,Response,Delay,Auto Acknowledge
ALM_LEVEL_HH,LT001_PV >= SP_HH,95%,critical,safety,Fill valve closed automatically. Risk of overflow. Check fill valve and inlet piping.,0s,No
ALM_LEVEL_LL,LT001_PV <= SP_LL,5%,critical,safety,Drain valve closed automatically. Risk of pump cavitation / empty tank. Check drain valve and outlet.,0s,No
ALM_LT001_FAIL,LT001_VALID=FALSE,4mA wire-break,high,equipment,Transmitter signal lost. Both valves closed for safety. Check transmitter wiring and loop supply. Do not operate AUTO.,5s,No
ALM_FILL_TIMEOUT,Fill phase did not reach setpoint within timeout,80% in 30min,high,process,Possible supply failure or valve not opening. Check supply pressure and fill valve.,0s,No
ALM_DRAIN_TIMEOUT,Drain phase did not reach setpoint within timeout,20% in 30min,high,process,Possible blockage or valve not opening. Check drain valve and outlet piping.,0s,No
ALM_LEVEL_H,LT001_PV >= SP_H,85%,high,process,Level approaching high-high. Verify fill valve closed. Reduce inlet if manual.,20s,No
ALM_LEVEL_L,LT001_PV <= SP_L,10%,high,process,Level approaching low-low. Verify drain valve closed. Check supply source.,20s,No
ALM_XV_FILL_DISC,Fill valve command vs limit switch mismatch >travel time,6s,medium,equipment,Fill valve not responding to command. Check actuator, air supply, and positioner.,6s,No
ALM_XV_DRAIN_DISC,Drain valve command vs limit switch mismatch >travel time,6s,medium,equipment,Drain valve not responding to command. Check actuator, air supply, and positioner.,6s,No
ALM_DUAL_VALVE_CONFLICT,Both valves commanded open simultaneously,N/A,medium,diagnostic,Logic conflict detected — drain de-energised. Review control logic and manual override state.,0s,Yes
ALM_SEQ_FAULT,Sequence entered fault state,N/A,medium,process,Batch sequence faulted. Investigate root cause. Press SEQ_RESET when safe to continue.,0s,No
```