Field fix / guidePLC / HMI Code & LogicVendor-agnostic (IEC 61131-3)Tank Liquidindustrial-automation
Tank To Tank Transfer — PLC Control Template
Shared by TSIMEREZIVO Team · 4 Oct 2026 · 41 views
# Tank-to-Tank Transfer — Usage Guide
## Overview
Metered transfer between two tanks with permissive gate, volume accumulation, source/destination level cutoffs, and timeout protection. Suitable for: raw material transfers, product blending feeds, CIP chemical dosing tanks, water treatment inter-stage transfers.
## Transfer Sequence
```
IDLE ──► [all perms OK + START] ──► OPENING ──► TRANSFERRING ──► CLOSING ──► COMPLETE
│ │
[source low / dest full / [ACK_CMD]
volume SP reached / timeout] │
│ IDLE
FAULT ──► [RESET] ──► IDLE
```
## Permissive Bitmask
| Bit | Tag | Meaning |
|-----|-----|---------|
| 0 (1) | `PERM_SOURCE_AVAILABLE` | Source level ≥ `SOURCE_LOW_LIMIT` |
| 1 (2) | `PERM_DEST_SPACE` | Destination level ≤ `DEST_HIGH_LIMIT` |
| 2 (4) | `PERM_PUMP_READY` | Pump healthy, no overload |
| 3 (8) | `PERM_VALVES_OK` | Both isolation valves open (LS) |
| 4 (16) | `PERM_NO_FAULT` | No active fault |
Full word = 31 (all satisfied).
## Volume Tracking
Volume is estimated from pump runtime × `PUMP_FLOW_RATE_LPH`. For accurate metering, install a flow transmitter and integrate `FT001_PV` instead. Set `TRANSFER_VOLUME_SP = 0` to run level-cutoff mode (ignores volume SP).
## Commissioning
1. Confirm both level transmitters reading correctly before first transfer
2. Manually open each isolation valve and verify LS signals
3. Run one transfer in MANUAL pump mode — verify volume accumulation tracking
4. Test `SOURCE_LOW_CUTOFF` — fill source partially and confirm automatic stop
5. Test `DEST_HIGH_CUTOFF` — fill destination nearly full and confirm automatic stop
---
## Control Logic — Vendor-Agnostic Pseudocode
# Tank-to-Tank Transfer — Logic
## Standards: IEC 61131-3 | ISA-5.1 | ISA-18.2
## Scan Rate: 100ms | Pattern: Volume-metered transfer with source/dest guards
```
ROUTINE: TankToTankTransfer
SCAN_RATE: 100ms
// ═══════════════════════════════════════════════════════════════
// SECTION 1 — LEVEL MEASUREMENTS (source and destination)
// ═══════════════════════════════════════════════════════════════
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
SOURCE_LEVEL := LT_PV[0] // Source tank %
DEST_LEVEL := LT_PV[1] // Destination tank %
// ═══════════════════════════════════════════════════════════════
// SECTION 2 — TRANSFER PERMISSIVES
// All conditions must be satisfied before transfer.
// ═══════════════════════════════════════════════════════════════
PERM_SOURCE_AVAILABLE := SOURCE_LEVEL >= SOURCE_LOW_LIMIT
PERM_DEST_SPACE := DEST_LEVEL <= DEST_HIGH_LIMIT
PERM_PUMP_READY := PUMP_HEALTHY AND NOT PUMP_OL
PERM_VALVES_OK := XV_SRC_OPEN_LS AND XV_DST_OPEN_LS
PERM_NO_FAULT := NOT TRANSFER_FAULT
PERMISSIVE_WORD := 0
IF PERM_SOURCE_AVAILABLE THEN PERMISSIVE_WORD := PERMISSIVE_WORD OR 1 END_IF
IF PERM_DEST_SPACE THEN PERMISSIVE_WORD := PERMISSIVE_WORD OR 2 END_IF
IF PERM_PUMP_READY THEN PERMISSIVE_WORD := PERMISSIVE_WORD OR 4 END_IF
IF PERM_VALVES_OK THEN PERMISSIVE_WORD := PERMISSIVE_WORD OR 8 END_IF
IF PERM_NO_FAULT THEN PERMISSIVE_WORD := PERMISSIVE_WORD OR 16 END_IF
ALL_PERMS_OK := (PERMISSIVE_WORD = 31)
// ═══════════════════════════════════════════════════════════════
// SECTION 3 — TRANSFER STATE MACHINE
// State 0: IDLE — all stopped
// State 1: OPENING — open source and dest valves
// State 2: TRANSFERRING — pump running, accumulating volume
// State 3: CLOSING — close valves, pump off
// State 4: COMPLETE — transfer done
// State 5: FAULT — requires reset
// ═══════════════════════════════════════════════════════════════
CASE XFER_STATE OF
0: // IDLE
PUMP_CMD := FALSE
XV_SRC_CMD := FALSE
XV_DST_CMD := FALSE
XFER_VOLUME := 0.0
XFER_RUNTIME := 0
IF START_CMD AND ALL_PERMS_OK THEN
XFER_STATE := 1
XV_SRC_CMD := TRUE
XV_DST_CMD := TRUE
START_CMD := FALSE
AUDIT_LOG(EVENT="TRANSFER_STARTED",
SOURCE_LEVEL=SOURCE_LEVEL, DEST_LEVEL=DEST_LEVEL)
END_IF
1: // OPENING valves — wait for LS confirmation
VALVE_OPEN_TMR := VALVE_OPEN_TMR + 1
IF XV_SRC_OPEN_LS AND XV_DST_OPEN_LS THEN
PUMP_CMD := TRUE
XFER_STATE := 2
VALVE_OPEN_TMR := 0
END_IF
IF VALVE_OPEN_TMR >= VALVE_TRAVEL_TICKS THEN
SET_ALARM(ALM_VALVE_OPEN_TIMEOUT, MEDIUM)
XFER_STATE := 5
END_IF
2: // TRANSFERRING
XFER_RUNTIME := XFER_RUNTIME + 1
// Volume estimation via runtime × rated flow
XFER_VOLUME := XFER_RUNTIME * PUMP_FLOW_RATE_LPH / 36000.0
// Check for transfer completion conditions
IF SOURCE_LEVEL <= SOURCE_LOW_CUTOFF THEN
SET_ALARM(ALM_SOURCE_LOW, HIGH)
XFER_STATE := 3
END_IF
IF DEST_LEVEL >= DEST_HIGH_CUTOFF THEN
SET_ALARM(ALM_DEST_FULL, HIGH)
XFER_STATE := 3
END_IF
IF TRANSFER_VOLUME_SP > 0.0 AND XFER_VOLUME >= TRANSFER_VOLUME_SP THEN
XFER_STATE := 3
END_IF
IF XFER_RUNTIME >= TRANSFER_TIMEOUT_TICKS THEN
SET_ALARM(ALM_XFER_TIMEOUT, HIGH)
XFER_STATE := 5
END_IF
// Abort if permissives lost mid-transfer
IF NOT PERM_PUMP_READY THEN
SET_ALARM(ALM_XFER_ABORT, HIGH)
XFER_STATE := 5
END_IF
3: // CLOSING — stop pump, close valves
PUMP_CMD := FALSE
XV_SRC_CMD := FALSE
XV_DST_CMD := FALSE
XFER_STATE := 4
AUDIT_LOG(EVENT="TRANSFER_COMPLETE",
VOLUME=XFER_VOLUME, RUNTIME=XFER_RUNTIME)
4: // COMPLETE — display results until acknowledged
IF ACK_CMD THEN
XFER_STATE := 0
ACK_CMD := FALSE
END_IF
5: // FAULT
PUMP_CMD := FALSE
XV_SRC_CMD := FALSE
XV_DST_CMD := FALSE
IF RESET_CMD THEN
XFER_STATE := 0
TRANSFER_FAULT := FALSE
RESET_CMD := FALSE
END_IF
END_CASE
// ═══════════════════════════════════════════════════════════════
// SECTION 4 — HMI OUTPUTS
// ═══════════════════════════════════════════════════════════════
HMI_SOURCE_LEVEL := SOURCE_LEVEL
HMI_DEST_LEVEL := DEST_LEVEL
HMI_XFER_STATE := XFER_STATE
HMI_XFER_VOLUME := XFER_VOLUME
HMI_PERMISSIVE := PERMISSIVE_WORD
HMI_PUMP := PUMP_CMD
HMI_SRC_VALVE := XV_SRC_OPEN_LS
HMI_DST_VALVE := XV_DST_OPEN_LS
END_ROUTINE
```
---
## Tag List
```csv
Tag Name,Description,Data Type,Direction,Engineering Unit,Range Min,Range Max,Default Value,Address
LT_RAW_0,Source Tank Level Raw ADC,INT,input,,0,27648,,AI:0:0.0
LT_RAW_1,Destination Tank Level Raw ADC,INT,input,,0,27648,,AI:0:0.1
LT_MA_0,Source Tank mA,REAL,calculated,mA,3.8,20.5,,
LT_MA_1,Destination Tank mA,REAL,calculated,mA,3.8,20.5,,
LT_VALID_0,Source Transmitter Healthy,BOOL,calculated,,,,TRUE,
LT_VALID_1,Destination Transmitter Healthy,BOOL,calculated,,,,TRUE,
LT_PV_0,Source Tank Level,REAL,calculated,%,0,100,,
LT_PV_1,Destination Tank Level,REAL,calculated,%,0,100,,
LT_LAST_GOOD_0,Source Last Good Level,REAL,internal,%,0,100,50,
LT_LAST_GOOD_1,Destination Last Good Level,REAL,internal,%,0,100,10,
SOURCE_LEVEL,Source Tank Level (Active),REAL,calculated,%,0,100,,
DEST_LEVEL,Destination Tank Level (Active),REAL,calculated,%,0,100,,
XV_SRC_CMD,Source Isolation Valve Command,BOOL,output,,,,FALSE,DO:1:0.0
XV_DST_CMD,Destination Isolation Valve Command,BOOL,output,,,,FALSE,DO:1:0.1
XV_SRC_OPEN_LS,Source Valve Open Limit Switch,BOOL,input,,,,FALSE,DI:0:0.0
XV_DST_OPEN_LS,Destination Valve Open Limit Switch,BOOL,input,,,,FALSE,DI:0:0.1
PUMP_CMD,Transfer Pump Run Command,BOOL,output,,,,FALSE,DO:1:0.2
PUMP_HEALTHY,Pump Healthy Status,BOOL,input,,,,TRUE,DI:0:0.2
PUMP_OL,Pump Overload Trip,BOOL,input,,,,FALSE,DI:0:0.3
XFER_STATE,Transfer State Machine State,INT,internal,,0,5,0,
START_CMD,Transfer Start Command,BOOL,input,,,,FALSE,
ACK_CMD,Transfer Complete Acknowledge,BOOL,input,,,,FALSE,
RESET_CMD,Fault Reset Command,BOOL,input,,,,FALSE,
TRANSFER_FAULT,Transfer Fault Active,BOOL,internal,,,,FALSE,
PERMISSIVE_WORD,Permissive Status Bitmask (31=all OK),INT,calculated,,0,31,0,
ALL_PERMS_OK,All Transfer Permissives Satisfied,BOOL,calculated,,,,FALSE,
PERM_SOURCE_AVAILABLE,Source Level Above Minimum,BOOL,calculated,,,,FALSE,
PERM_DEST_SPACE,Destination Level Below Maximum,BOOL,calculated,,,,FALSE,
PERM_PUMP_READY,Pump Healthy and Not Overloaded,BOOL,calculated,,,,FALSE,
PERM_VALVES_OK,Both Isolation Valves Open,BOOL,calculated,,,,FALSE,
PERM_NO_FAULT,No Active Fault,BOOL,calculated,,,,TRUE,
SOURCE_LOW_LIMIT,Source Level Permissive Minimum (to start),REAL,internal,%,0,100,20,
SOURCE_LOW_CUTOFF,Source Level Stop Transfer Setpoint,REAL,internal,%,0,100,5,
DEST_HIGH_LIMIT,Destination Level Permissive Maximum (to start),REAL,internal,%,0,100,85,
DEST_HIGH_CUTOFF,Destination Level Stop Transfer Setpoint,REAL,internal,%,0,100,95,
TRANSFER_VOLUME_SP,Transfer Volume Target (0=run until level cutoffs),REAL,input,L,0,999999,0,
XFER_VOLUME,Estimated Transfer Volume Accumulated,REAL,calculated,L,0,999999,0,
PUMP_FLOW_RATE_LPH,Pump Rated Flow Rate,REAL,internal,L/hr,0,100000,1000,
XFER_RUNTIME,Transfer Runtime (100ms ticks),INT,internal,,0,999999,0,
TRANSFER_TIMEOUT_TICKS,Transfer Timeout Limit (100ms ticks),INT,internal,,100,999999,18000,
VALVE_OPEN_TMR,Valve Opening Timer,INT,internal,,0,600,0,
VALVE_TRAVEL_TICKS,Valve Travel Timeout (100ms ticks),INT,internal,,10,600,60,
ALM_LT_FAIL_0,Source Level Transmitter Failure,BOOL,calculated,,,,FALSE,
ALM_LT_FAIL_1,Destination Level Transmitter Failure,BOOL,calculated,,,,FALSE,
ALM_VALVE_OPEN_TIMEOUT,Isolation Valve Did Not Open in Time,BOOL,calculated,,,,FALSE,
ALM_SOURCE_LOW,Source Tank Low During Transfer,BOOL,calculated,,,,FALSE,
ALM_DEST_FULL,Destination Tank Full During Transfer,BOOL,calculated,,,,FALSE,
ALM_XFER_TIMEOUT,Transfer Did Not Complete in Time,BOOL,calculated,,,,FALSE,
ALM_XFER_ABORT,Transfer Aborted — Pump Fault,BOOL,calculated,,,,FALSE,
HMI_SOURCE_LEVEL,HMI: Source Tank Level,REAL,output,%,0,100,,
HMI_DEST_LEVEL,HMI: Destination Tank Level,REAL,output,%,0,100,,
HMI_XFER_STATE,HMI: Transfer State,INT,output,,0,5,0,
HMI_XFER_VOLUME,HMI: Transfer Volume,REAL,output,L,0,999999,0,
HMI_PERMISSIVE,HMI: Permissive Word,INT,output,,0,31,0,
HMI_PUMP,HMI: Pump Status,BOOL,output,,,,FALSE,
HMI_SRC_VALVE,HMI: Source Valve Status,BOOL,output,,,,FALSE,
HMI_DST_VALVE,HMI: Destination Valve Status,BOOL,output,,,,FALSE,
```
---
## Alarm Matrix
```csv
Alarm Tag,Condition,Setpoint,Priority,Type,Response,Delay,Auto Acknowledge
ALM_LT_FAIL_0,Source transmitter signal out of range,<3.8 or >20.5mA,high,equipment,Transfer halted. Check source level transmitter wiring and loop supply.,5s,No
ALM_LT_FAIL_1,Destination transmitter signal out of range,<3.8 or >20.5mA,high,equipment,Transfer halted. Check destination level transmitter wiring and loop supply.,5s,No
ALM_SOURCE_LOW,Source tank dropped below low cutoff during transfer,5%,high,process,Transfer stopped to prevent pump cavitation. Verify source supply. Reset when level restored.,0s,No
ALM_DEST_FULL,Destination tank reached high cutoff during transfer,95%,high,process,Transfer stopped to prevent overflow. Reduce downstream demand or increase destination capacity.,0s,No
ALM_XFER_TIMEOUT,Transfer did not complete within timeout period,30 min,high,process,Check pump running, valve positions, and source level. Investigate blockage.,0s,No
ALM_XFER_ABORT,Transfer aborted — pump became unhealthy mid-transfer,N/A,high,equipment,Pump tripped during transfer. Check overloads and motor. Reset fault then restart transfer.,0s,No
ALM_VALVE_OPEN_TIMEOUT,Isolation valve did not confirm open position within travel time,6s,medium,equipment,Check valve actuator, air supply, and limit switch. Sequence faulted.,6s,No
```