Unitronics Structured Text for Pump Control: Complete Programming Guide

Optimizing Structured Text for Pump Control applications in Unitronics's VisiLogic / UniLogic requires measuring the baseline and understanding the demands of Water & Wastewater. This guide focuses on techniques you can evaluate with task timing, scan-time traces, memory use, and controlled fault tests.

For intermediate applications like Pump Control, check which diagnostics and profiling tools are available in your installed VisiLogic / UniLogic version. Controller model, firmware, task configuration, communications, and I/O update behavior can all affect the result.

Performance considerations for Pump Control systems extend beyond basic functionality. Critical factors include 5 sensor types, 5 actuators, communications load, and the need to handle pressure regulation. Evaluate whether powerful for complex logic helps the design, then measure the actual task and I/O timing on the selected configuration.

This guide covers memory management, execution order, Structured Text-specific tuning, and a repeatable measurement plan for Pump Control applications. Treat every optimization as a hypothesis: record the baseline, change one variable, retest the same workload, and keep the change only when the measured result and code maintainability both improve.

Unitronics VisiLogic / UniLogic for Pump Control

VisiLogic / UniLogic is a programming environment associated with Unitronics controller families such as Jazz 2, Samba 7", Vision V350. This guide uses Structured Text terminology from the supplied guide dataset, but controller capabilities and language support can change by model, firmware, software edition, and license.

Verify Before You Start:

The selected controller supports the required Structured Text constructs

The project version matches the installed VisiLogic / UniLogic release

Required communications, motion, safety, and simulation options are licensed

Firmware and device-description files are compatible with the project

The vendor manuals used for the design match the exact hardware revision

Application Planning:

For a Pump Control exercise, map the required inputs and outputs before writing logic. The example considers 5 sensor types, including Pressure transmitters, Flow meters, Level sensors, and 5 actuator types.

Control Equipment for Pump Control:

Centrifugal pumps for high flow applications

Positive displacement pumps for metering

Submersible pumps for wet well applications

Booster pump systems for pressure maintenance

Controller-family references used in this guide include:

Jazz 2: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

Samba 7": Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

Vision V350: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

Vision V570: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

Hardware Selection Checklist:

Count local and remote I/O, including planned expansion

Measure the required task and communications update rates

Identify memory, data-retention, diagnostics, and cybersecurity requirements

Treat safety functions as a separate, standards-led design activity

Confirm lifecycle status, regional availability, licensing, and support

Source and Validation Note:

This page does not represent a vendor certification or a hardware acceptance test. Use current Unitronics manuals, release notes, and safety documentation as the authority for product-specific behavior. Validate adapted logic in a simulator or isolated test setup before connecting it to equipment.

Investment Considerations:

For Pump Control projects, compare hardware, software licensing, training, engineering, test equipment, commissioning, spares, and ongoing support. Obtain current pricing and lifecycle information directly from the vendor or an authorized regional supplier.

Understanding Structured Text for Pump Control

Structured Text (ST) is a high-level, text-based programming language defined in IEC 61131-3. It resembles Pascal and provides powerful constructs for complex algorithms, calculations, and data manipulation.

Execution Model:

Code executes sequentially from top to bottom within each program unit. Variables maintain state between scan cycles unless explicitly reset.

Core Advantages for Pump Control:

Powerful for complex logic: Critical for Pump Control when handling intermediate control logic

Excellent code reusability: Critical for Pump Control when handling intermediate control logic

Compact code representation: Critical for Pump Control when handling intermediate control logic

Good for algorithms and calculations: Critical for Pump Control when handling intermediate control logic

Familiar to software developers: Critical for Pump Control when handling intermediate control logic

Why Structured Text Fits Pump Control:

Pump Control systems in Water & Wastewater typically involve:

Sensors: Pressure transmitters for discharge and suction pressure, Flow meters (magnetic, ultrasonic, or vortex), Level transmitters for tank or wet well level

Actuators: Variable frequency drives (VFDs) for speed control, Motor starters (DOL or soft start), Control valves for flow regulation

Complexity: Intermediate with challenges including Preventing cavitation at low suction pressure

Control Strategies for Pump Control:

constant: Maintain fixed speed or output

pressure: PID control to maintain discharge pressure setpoint

flow: PID control to maintain flow rate setpoint

Programming Fundamentals in Structured Text:

Variables:
- declaration: VAR / VAR_INPUT / VAR_OUTPUT / VAR_IN_OUT / VAR_GLOBAL sections
- initialization: Variables can be initialized at declaration: Counter : INT := 0;
- constants: VAR CONSTANT section for read-only values

Operators:
- arithmetic: + - * / MOD (modulo)
- comparison: = <> < > <= >=
- logical: AND OR XOR NOT

ControlStructures:
- if: IF condition THEN statements; ELSIF condition THEN statements; ELSE statements; END_IF;
- case: CASE selector OF value1: statements; value2: statements; ELSE statements; END_CASE;
- for: FOR index := start TO end BY step DO statements; END_FOR;

Best Practices for Structured Text:

Use meaningful variable names with consistent naming conventions

Initialize all variables at declaration to prevent undefined behavior

Use enumerated types for state machines instead of magic numbers

Break complex expressions into intermediate variables for readability

Use functions for reusable calculations and function blocks for stateful operations

Common Mistakes to Avoid:

Using = instead of := for assignment (= is comparison)

Forgetting semicolons at end of statements

Integer division truncation - use REAL for decimal results

Infinite loops from incorrect WHILE/REPEAT conditions

Typical Applications:

1. PID control: Directly applicable to Pump Control
2. Recipe management: Related control patterns
3. Statistical calculations: Related control patterns
4. Data logging: Related control patterns

Understanding these fundamentals prepares you to implement effective Structured Text solutions for Pump Control using Unitronics VisiLogic / UniLogic.

Implementing Pump Control with Structured Text

Pump control systems use PLCs to regulate liquid flow in industrial processes, water treatment, and building services. These systems manage pump operation, protect equipment, optimize energy use, and maintain process parameters.

This walkthrough demonstrates practical implementation using Unitronics VisiLogic / UniLogic and Structured Text programming.

System Requirements:

A typical Pump Control implementation includes:

Input Devices (Sensors):
1. Pressure transmitters for discharge and suction pressure: Critical for monitoring system state
2. Flow meters (magnetic, ultrasonic, or vortex): Critical for monitoring system state
3. Level transmitters for tank or wet well level: Critical for monitoring system state
4. Temperature sensors for bearing and motor monitoring: Critical for monitoring system state
5. Vibration sensors for predictive maintenance: Critical for monitoring system state

Output Devices (Actuators):
1. Variable frequency drives (VFDs) for speed control: Primary control output
2. Motor starters (DOL or soft start): Supporting control function
3. Control valves for flow regulation: Supporting control function
4. Isolation valves (actuated for remote operation): Supporting control function
5. Check valves to prevent backflow: Supporting control function

Control Equipment:

Centrifugal pumps for high flow applications

Positive displacement pumps for metering

Submersible pumps for wet well applications

Booster pump systems for pressure maintenance

Control Strategies for Pump Control:

constant: Maintain fixed speed or output

pressure: PID control to maintain discharge pressure setpoint

flow: PID control to maintain flow rate setpoint

level: Control tank/wet well level within band

Implementation Steps:

Step 1: Characterize pump curve and system curve

In VisiLogic / UniLogic, characterize pump curve and system curve.

Step 2: Size VFD for application (constant torque vs. variable torque)

In VisiLogic / UniLogic, size vfd for application (constant torque vs. variable torque).

Step 3: Implement primary control loop (pressure, flow, or level)

In VisiLogic / UniLogic, implement primary control loop (pressure, flow, or level).

Step 4: Add pump protection logic (minimum flow, temperature, seal)

In VisiLogic / UniLogic, add pump protection logic (minimum flow, temperature, seal).

Step 5: Program lead/lag sequencing with alternation

In VisiLogic / UniLogic, program lead/lag sequencing with alternation.

Step 6: Implement soft start/stop ramps for smooth operation

In VisiLogic / UniLogic, implement soft start/stop ramps for smooth operation.

Unitronics Function Design:

Function block design in Unitronics uses user-defined FBs in UniLogic (more limited in VisiLogic). Extensive vendor-provided helper FBs cover common tasks (PID, motion, communication, HMI utilities). OEM machine builders typically maintain private FB libraries for their common machine patterns, though code reuse is less mature than in mainstream PLC ecosystems.

Common Challenges and Solutions:

1. Preventing cavitation at low suction pressure

Solution: Structured Text addresses this through Powerful for complex logic.

2. Managing minimum flow requirements

Solution: Structured Text addresses this through Excellent code reusability.

3. Coordinating VFD speed with system pressure

Solution: Structured Text addresses this through Compact code representation.

4. Handling pump cycling with varying demand

Solution: Structured Text addresses this through Good for algorithms and calculations.

Safety Considerations:

Dry run protection using flow or level monitoring

Overtemperature protection for motor and bearings

Overload protection through current monitoring

Vibration trips for mechanical failure detection

Emergency stop with proper system depressurization

Performance Metrics:

Task and I/O timing: Record minimum, average, and maximum values under a defined test load

Accuracy: Define an acceptable tolerance and compare it with calibrated reference measurements

Throughput: Count completed cycles over a fixed interval and record rejected or incomplete cycles

Fault response: Measure detection, safe-state, alarm, and recovery behavior for each test case

Resource use: Record memory, communications load, and diagnostic-buffer behavior

Unitronics Diagnostic Tools:

UniLogic (current) and VisiLogic (legacy) integrated debuggers with breakpoints,Built-in simulator covering PLC logic, HMI screens, alarms, recipes, and data tables,Web visualisation for UniStream — remote HMI viewing without additional software,SD card logging with PC-side export tools for offline trend analysis,Modbus RTU/TCP transaction logging built into the IDE,Controller status monitor — CPU load, scan time, memory usage,HMI event logger capturing operator actions for audit purposes,CAN bus diagnostic tools for CANopen-equipped models,Remote support tool — Unitronics' own screen-sharing for technical support,User community forum with active troubleshooting discussions

Use the monitoring and diagnostic functions available in your VisiLogic / UniLogic version, and record the software, firmware, hardware, workload, and test procedure with every result.

Unitronics Structured Text Example for Pump Control

Illustrative Structured Text example for Pump Control using Unitronics terminology. Adapt the syntax to your VisiLogic / UniLogic release, compile it, and verify it in an isolated test environment before use on equipment.

(* Unitronics VisiLogic / UniLogic - Pump Control Control *)
(* Structured Text Implementation for Water & Wastewater *)
(* Unitronics projects use IDE-managed tag names rather than raw memory a *)

PROGRAM PRG_PUMP_CONTROL_Control

VAR
    (* State Machine Variables *)
    eState : E_PUMP_CONTROL_States := IDLE;
    bEnable : BOOL := FALSE;
    bFaultActive : BOOL := FALSE;

    (* Timers *)
    tonDebounce : TON;
    tonProcessTimeout : TON;
    tonFeedbackCheck : TON;

    (* Counters *)
    ctuCycleCounter : CTU;

    (* Process Variables *)
    rPressuretransmitters : REAL := 0.0;
    rCentrifugalpumps : REAL := 0.0;
    rSetpoint : REAL := 100.0; (* Illustrative value; replace with a reviewed requirement *)
END_VAR

VAR CONSTANT
    (* Water & Wastewater Process Parameters *)
    C_DEBOUNCE_TIME : TIME := T#500MS;
    C_PROCESS_TIMEOUT : TIME := T#30S; (* Illustrative value; verify for the process *)
    C_BATCH_SIZE : INT := 50; (* Illustrative value; replace with a reviewed requirement *)
END_VAR

(* Input Conditioning *)
tonDebounce(IN := bStartButton, PT := C_DEBOUNCE_TIME);
bEnable := tonDebounce.Q AND NOT bEmergencyStop AND bSafetyOK;

(* Main State Machine - Pattern: State machines are commonly implemented  *)
CASE eState OF
    IDLE:
        rCentrifugalpumps := 0.0;
        ctuCycleCounter(RESET := TRUE);
        IF bEnable AND rPressuretransmitters > 0.0 THEN
            eState := STARTING;
        END_IF;

    STARTING:
        (* Ramp up output - Gradual start *)
        rCentrifugalpumps := MIN(rCentrifugalpumps + 5.0, rSetpoint);
        IF rCentrifugalpumps >= rSetpoint THEN
            eState := RUNNING;
        END_IF;

    RUNNING:
        (* Pump Control active - Pump control systems use PLCs to regulate liquid f *)
        tonProcessTimeout(IN := TRUE, PT := C_PROCESS_TIMEOUT);
        ctuCycleCounter(CU := bCyclePulse, PV := C_BATCH_SIZE);

        IF ctuCycleCounter.Q THEN
            eState := COMPLETE;
        ELSIF tonProcessTimeout.Q THEN
            bFaultActive := TRUE;
            eState := FAULT;
        END_IF;

    COMPLETE:
        rCentrifugalpumps := 0.0;
        (* Log production data - Data logging uses UniLogic's Data Samplers — configured triggers (time-based or event-based) write structured records to Data Tables or SD card in CSV format. Exported files can be pushed via FTP or email. For cloud integration, UniCloud provides managed data ingestion. Simpler VisiLogic projects use HMI-triggered SD writes via custom ladder code. *)
        eState := IDLE;

    FAULT:
        rCentrifugalpumps := 0.0;
        (* Alarm handling uses UniLogic's built-in Alarm Manager — configure alarm conditions in tables with severity, message text, and logging behaviour, and the engine handles detection, acknowledgement, history, and HMI display without custom code. VisiLogic uses a simpler alarm approach via HMI event handlers. *)
        IF bFaultReset AND NOT bEmergencyStop THEN
            bFaultActive := FALSE;
            eState := IDLE;
        END_IF;
END_CASE;

(* Safety Override - Always executes *)
IF bEmergencyStop OR NOT bSafetyOK THEN
    rCentrifugalpumps := 0.0;
    eState := FAULT;
    bFaultActive := TRUE;
END_IF;

END_PROGRAM

Code Explanation:

1.Enumerated state machine (State machines are commonly implemented in ladder with step-counter registers or in ST using CASE structures with named state constants. UniLogic's HMI graphical bindings make state-to-screen visualisation straightforward — a single state variable drives both logic and operator screen transitions. SFC is not a primary language on Unitronics; state logic is typically CASE or ladder.) for clear Pump Control sequence control
2.Constants use clearly marked illustrative values that must be replaced with reviewed project requirements
3.Input conditioning with debounce timer prevents false triggers in industrial environment
4.STARTING state implements soft-start ramp - prevents mechanical shock
5.Process timeout detection flags a possible stuck condition for investigation
6.The final override illustrates a software permissive only; it is not a safety-rated function and must not replace a validated safety system

Best Practices

✓Follow Unitronics naming conventions: Unitronics projects use IDE-managed tag names rather than raw memory addressing.
✓Unitronics function design: Function block design in Unitronics uses user-defined FBs in UniLogic (more limi
✓Data organization: Unitronics uses its own tag database concept rather than IEC-standard data block
✓Structured Text: Use meaningful variable names with consistent naming conventions
✓Structured Text: Initialize all variables at declaration to prevent undefined behavior
✓Structured Text: Use enumerated types for state machines instead of magic numbers
✓Pump Control: Use PID with derivative on PV for pressure control
✓Pump Control: Implement soft start ramps even with VFD (200-500ms)
✓Pump Control: Add flow proving before considering pump operational
✓Debug with VisiLogic / UniLogic: Use the built-in simulator to reproduce issues before hardware visit
✓Safety: Dry run protection using flow or level monitoring
✓Use a compatible simulator or isolated test rig to test Pump Control logic before deployment

Common Pitfalls to Avoid

⚠Structured Text: Using = instead of := for assignment (= is comparison)
⚠Structured Text: Forgetting semicolons at end of statements
⚠Structured Text: Integer division truncation - use REAL for decimal results
⚠Unitronics common error: VisiLogic-to-UniLogic migration issues — not all projects convert cleanly
⚠Pump Control: Preventing cavitation at low suction pressure
⚠Pump Control: Managing minimum flow requirements
⚠Neglecting to validate Pressure transmitters for discharge and suction pressure leads to control errors
⚠Insufficient comments make Structured Text programs unmaintainable over time

Related Certifications

🏆Unitronics Certified Integrator

🏆UniLogic Developer Training

🏆Advanced Unitronics Programming Certification

Applying Structured Text to Pump Control using Unitronics VisiLogic / UniLogic requires understanding the platform, the process, and the project's acceptance criteria. This guide has covered implementation structure, an illustrative code example, verification practices, and common pitfalls for a intermediate Pump Control exercise.

Use the practices outlined here to create a design that can be reviewed and tested. Define performance targets in the project requirements and confirm them with repeatable measurements.

Next Steps:

1. Check Sources: Read the current VisiLogic / UniLogic help, controller manual, release notes, and relevant standards
2. Practice Safely: Adapt the example in a simulator or isolated training setup
3. Review: Have the I/O map, state behavior, faults, and recovery steps reviewed
4. Test: Record normal, boundary, fault, restart, and communications test results

Structured Text Foundation:

Structured Text (ST) is a high-level, text-based programming language defined in IEC 61131-3. It resembles Pascal and provides powerful constructs for...

Project duration depends on scope, reviews, hardware availability, software and firmware versions, testing, commissioning, and site constraints. Remember: Use PID with derivative on PV for pressure control

For further learning, explore related topics including Recipe management, Wastewater treatment, and Unitronics platform-specific features for Pump Control optimization.