Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Tank Liquidindustrial-automation
Auto Water Refill — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 97 views
# Auto Water Refill — Usage Guide
## Overview
Simple on/off solenoid valve refill control. Starts filling when level drops to `SP_START`, stops when it reaches `SP_STOP`. Includes timeout guard, supply fault detection, and HH safety override.
Suitable for: cooling towers, buffer tanks, plating baths, wash water tanks, irrigation reservoirs.
## Setpoint Hierarchy
```
SP_HH ─────────────────────────────────── 95% (Critical — fill forced off)
SP_H ────────────────────────────────── 85% (High alarm)
SP_STOP ───────────────────────────────── 75% (Auto refill stops here)
↑ Hysteresis band
SP_START ──────────────────────────────── 25% (Auto refill starts here)
SP_L ────────────────────────────────── 15% (Low alarm)
SP_LL ─────────────────────────────────── 5% (Critical)
```
The hysteresis band (`SP_STOP` − `SP_START`) prevents rapid cycling. Minimum recommended band: 10%.
## Timeout Sizing
`FILL_TIMEOUT_TICKS = TANK_VOLUME_L / FILL_RATE_LPM × 60 × 10 × 1.5`
Example: 1000 L tank, 10 L/min fill rate → 1000/10 × 600 × 1.5 = 90,000 ticks (150 min safety margin).
## Commissioning
1. Verify level transmitter: check 4mA = empty, 20mA = full
2. In MANUAL mode: open fill solenoid, confirm level rises
3. Test SP_HH override: force level to 95% — confirm solenoid closes
4. In AUTO mode: let level drop to SP_START, confirm auto-refill starts and stops at SP_STOP
5. Test timeout: set `FILL_TIMEOUT_TICKS` low, run fill, confirm fault and alarm
---
## Control Logic — Vendor-Agnostic Pseudocode
# Auto Water Refill — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-18.2
## Scan Rate: 100ms | Pattern: Simple reservoir low-level auto-refill with high cutoff
```
ROUTINE: AutoWaterRefill
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL MEASUREMENT & VALIDATION
// ═══════════════════════════════════════════════════════════════
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_XMTR_FAIL, HIGH)
// Fail safe: close fill solenoid on xmtr failure
FILL_SOL_CMD := FALSE
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — REFILL CONTROL LOGIC
// Hysteresis: start at SP_START, stop at SP_STOP.
// Manual override: operator can force fill on/off.
// Permissive: supply pressure OK and no fault.
// ═══════════════════════════════════════════════════════════════
SUPPLY_OK := SUPPLY_PRESS_OK AND NOT SUPPLY_FAULT
FILL_ALLOWED := LT001_VALID AND SUPPLY_OK AND NOT REFILL_FAULT
CASE MODE_SELECTOR OF
0: // OFF
FILL_SOL_CMD := FALSE
1: // MANUAL
FILL_SOL_CMD := MAN_FILL_CMD AND FILL_ALLOWED
2: // AUTO
IF LT001_PV <= SP_START AND NOT FILL_ACTIVE AND FILL_ALLOWED THEN
FILL_ACTIVE := TRUE
FILL_START_TIME := SYS_TICK
AUDIT_LOG(EVENT="REFILL_STARTED", LEVEL=LT001_PV)
END_IF
IF LT001_PV >= SP_STOP THEN
FILL_ACTIVE := FALSE
AUDIT_LOG(EVENT="REFILL_COMPLETE", LEVEL=LT001_PV)
END_IF
FILL_SOL_CMD := FILL_ACTIVE AND FILL_ALLOWED
END_CASE
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — REFILL TIMEOUT
// Prevents solenoid staying open if tank never fills.
// ═══════════════════════════════════════════════════════════════
IF FILL_ACTIVE THEN
FILL_TMR := FILL_TMR + 1
IF FILL_TMR >= FILL_TIMEOUT_TICKS THEN
FILL_ACTIVE := FALSE
FILL_SOL_CMD := FALSE
REFILL_FAULT := TRUE
SET_ALARM(ALM_FILL_TIMEOUT, HIGH)
AUDIT_LOG(EVENT="REFILL_TIMEOUT_FAULT")
END_IF
ELSE
FILL_TMR := 0
END_IF
// Reset fault
IF RESET_CMD AND NOT FILL_ACTIVE THEN
REFILL_FAULT := FALSE
RESET_CMD := FALSE
END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — ALARMS (ISA-18.2)
// ═══════════════════════════════════════════════════════════════
IF LT001_PV >= SP_HH THEN SET_ALARM(ALM_LEVEL_HH, CRITICAL) FILL_SOL_CMD := FALSE END_IF
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
IF LT001_PV <= SP_LL THEN SET_ALARM(ALM_LEVEL_LL, CRITICAL) END_IF
// ═══════════════════════════════════════════════════════════════
// SECTION 5 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_LEVEL := LT001_PV
HMI_FILL := FILL_SOL_CMD
HMI_MODE := MODE_SELECTOR
HMI_FILL_ACTIVE := FILL_ACTIVE
HMI_FAULT := REFILL_FAULT
HMI_XMTR_FAIL := 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,INT,input,,0,27648,,AI:0:0.0
LT001_MA,Level 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,
FILL_SOL_CMD,Fill Solenoid Valve Command,BOOL,output,,,,FALSE,DO:1:0.0
SUPPLY_PRESS_OK,Water Supply Pressure OK,BOOL,input,,,,TRUE,DI:0:0.0
SUPPLY_FAULT,Water Supply Fault,BOOL,input,,,,FALSE,DI:0:0.1
MODE_SELECTOR,Operating Mode (0=OFF 1=MAN 2=AUTO),INT,input,,0,2,2,
MAN_FILL_CMD,Manual Fill Command,BOOL,input,,,,FALSE,
RESET_CMD,Fault Reset Command,BOOL,input,,,,FALSE,
FILL_ACTIVE,Refill Cycle Active,BOOL,internal,,,,FALSE,
FILL_ALLOWED,Refill Conditions Met,BOOL,calculated,,,,FALSE,
SUPPLY_OK,Supply Healthy and Available,BOOL,calculated,,,,FALSE,
REFILL_FAULT,Refill Fault — Reset Required,BOOL,internal,,,,FALSE,
SP_START,Refill Start Setpoint (low level trigger),REAL,internal,%,0,100,25,
SP_STOP,Refill Stop Setpoint (high cutoff),REAL,internal,%,0,100,75,
SP_LL,Level Low-Low Critical Setpoint,REAL,internal,%,0,100,5,
SP_L,Level Low Alarm Setpoint,REAL,internal,%,0,100,15,
SP_H,Level High Alarm Setpoint,REAL,internal,%,0,100,85,
SP_HH,Level High-High Critical Setpoint,REAL,internal,%,0,100,95,
FILL_TMR,Fill Timeout Timer (100ms ticks),INT,internal,,0,999999,0,
FILL_TIMEOUT_TICKS,Maximum Fill Duration (100ms ticks),INT,internal,,100,999999,18000,
FILL_START_TIME,Refill Start Timestamp,DINT,internal,,0,999999,,
SYS_TICK,System Tick Counter,DINT,input,,0,999999,,
ALM_XMTR_FAIL,Level Transmitter Failure,BOOL,calculated,,,,FALSE,
ALM_LEVEL_HH,Level High-High,BOOL,calculated,,,,FALSE,
ALM_LEVEL_H,Level High,BOOL,calculated,,,,FALSE,
ALM_LEVEL_L,Level Low,BOOL,calculated,,,,FALSE,
ALM_LEVEL_LL,Level Low-Low,BOOL,calculated,,,,FALSE,
ALM_FILL_TIMEOUT,Refill Timeout — Tank Not Filling,BOOL,calculated,,,,FALSE,
HMI_LEVEL,HMI: Level,REAL,output,%,0,100,,
HMI_FILL,HMI: Fill Solenoid,BOOL,output,,,,FALSE,
HMI_MODE,HMI: Mode,INT,output,,0,2,2,
HMI_FILL_ACTIVE,HMI: Refill Active,BOOL,output,,,,FALSE,
HMI_FAULT,HMI: Fault Active,BOOL,output,,,,FALSE,
HMI_XMTR_FAIL,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,95%,critical,safety,Fill solenoid forced closed. Overflow risk. Check demand side for blockage or valve stuck open.,0s,No
ALM_LEVEL_LL,LT001_PV <= SP_LL,5%,critical,process,Critically low level. Check water supply pressure and solenoid operation.,0s,No
ALM_XMTR_FAIL,LT001_VALID = FALSE,wire-break,high,equipment,Level transmitter failed. Fill solenoid closed for safety. Check wiring and loop power.,5s,No
ALM_FILL_TIMEOUT,Refill active for longer than FILL_TIMEOUT_TICKS,30 min,high,process,Tank not filling. Check water supply pressure and solenoid valve. Sequence faulted — manual reset required.,0s,No
ALM_LEVEL_H,LT001_PV >= SP_H,85%,high,process,Level above normal high. Verify refill solenoid closed. Check for inadvertent supply.,10s,No
ALM_LEVEL_L,LT001_PV <= SP_L,15%,high,process,Level below normal low. Refill should be active. Check supply and solenoid.,10s,No
```