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

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