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

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