Unitronics Structured Text for Pump Control: Complete Programming Guide

Optimizing Structured Text performance for Pump Control applications in Unitronics's VisiLogic / UniLogic requires understanding both the platform's capabilities and the specific demands of Water & Wastewater. This guide focuses on proven optimization techniques that deliver measurable improvements in cycle time, reliability, and system responsiveness.

Unitronics's VisiLogic / UniLogic offers powerful tools for Structured Text programming, particularly when targeting intermediate applications like Pump Control. With 1% market share and extensive deployment in US small, Unitronics has refined its platform based on real-world performance requirements from thousands of installations.

Performance considerations for Pump Control systems extend beyond basic functionality. Critical factors include 5 sensor types requiring fast scan times, 5 actuators demanding precise timing, and the need to handle pressure regulation. The Structured Text approach addresses these requirements through powerful for complex logic, enabling scan times that meet even demanding Water & Wastewater applications.

This guide dives deep into optimization strategies including memory management, execution order optimization, Structured Text-specific performance tuning, and Unitronics-specific features that accelerate Pump Control applications. You'll learn techniques used by experienced Unitronics programmers to achieve maximum performance while maintaining code clarity and maintainability.

Unitronics VisiLogic / UniLogic for Pump Control

Unitronics takes a distinctive approach to PLC programming: every controller ships with an integrated colour touchscreen HMI, and the development tool handles PLC logic and HMI design in a single workspace. VisiLogic is the legacy tool for the Vision, Samba, and Jazz product families; UniLogic is the current-generation environment for the UniStream line. Both are free to download and include a complete built-in simulator covering PLC logic, HMI screens, alarms, recipes, and data tables — the sim...

Platform Strengths for Pump Control:

Combined PLC + HMI in one unit reduces panel cost

Free VisiLogic and UniLogic IDEs

Built-in simulator with both PLC and HMI simulation

Strong US small-integrator community

Unique ${brand.software} Features:

Combined PLC + HMI in one unit across Jazz, Samba, Vision, and UniStream

Free VisiLogic (legacy) and UniLogic (current) IDEs

Built-in simulator covering PLC logic, HMI, alarms, data tables, and recipes

Integrated data sampling and trend logging without separate SCADA

Key Capabilities:

The VisiLogic / UniLogic environment excels at Pump Control applications through its combined plc + hmi in one unit reduces panel cost. This is particularly valuable when working with the 5 sensor types typically found in Pump Control systems, including Pressure transmitters, Flow meters, Level sensors.

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

Unitronics's controller families for Pump Control include:

Jazz 2: Suitable for intermediate Pump Control applications

Samba 7": Suitable for intermediate Pump Control applications

Vision V350: Suitable for intermediate Pump Control applications

Vision V570: Suitable for intermediate Pump Control applications

Hardware Selection Guidance:

CPU selection across Unitronics ranges from the Jazz 2 micro series (tiny applications, basic motor control, simple process monitoring with 10-20 I/O) through Samba 7" (small machine control with touchscreen HMI), Vision V350/V570 (medium machinery with larger HMI), and UniStream 7" / 15.6" (flagship combined PLC+HMI for mid-to-high complexity applications with advanced features like UniCloud, cel...

Industry Recognition:

Moderate - US small-integrator market, OEM machines, building automation. Unitronics' combined PLC+HMI controllers are uncommon in high-volume automotive manufacturing but appear in automotive tier-2 and tier-3 supplier shops, single-machine workcells, and after-market test fixtures. The cost advantage and single-unit PLC+HMI approach makes Unitronics attractive for small...

Investment Considerations:

With $$ pricing, Unitronics positions itself in the mid-range segment. For Pump Control projects requiring intermediate skill levels and 2-4 weeks development time, the total investment includes hardware, software licensing, training, and ongoing support.

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:

Scan Time: Optimize for 5 inputs and 5 outputs

Memory Usage: Efficient data structures for Jazz 2 capabilities

Response Time: Meeting Water & Wastewater requirements for Pump Control

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

Unitronics's VisiLogic / UniLogic provides tools for performance monitoring and optimization, essential for achieving the 2-4 weeks development timeline while maintaining code quality.

Unitronics Structured Text Example for Pump Control

Complete working example demonstrating Structured Text implementation for Pump Control using Unitronics VisiLogic / UniLogic. Follows Unitronics naming conventions. Tested on Jazz 2 hardware.

(* 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;
END_VAR

VAR CONSTANT
    (* Water & Wastewater Process Parameters *)
    C_DEBOUNCE_TIME : TIME := T#500MS;
    C_PROCESS_TIMEOUT : TIME := T#30S;
    C_BATCH_SIZE : INT := 50;
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 define Water & Wastewater-specific parameters: cycle time 30s, batch size
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 identifies stuck conditions - critical for reliability
6.Safety override section executes regardless of state - Unitronics best practice for intermediate systems

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 VisiLogic / UniLogic simulation tools 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

Mastering Structured Text for Pump Control applications using Unitronics VisiLogic / UniLogic requires understanding both the platform's capabilities and the specific demands of Water & Wastewater. This guide has provided comprehensive coverage of implementation strategies, working code examples, best practices, and common pitfalls to help you succeed with intermediate Pump Control projects.

Unitronics's 1% market share and moderate - us small-integrator market, oem machines, building automation demonstrate the platform's capability for demanding applications. The platform excels in Water & Wastewater applications where Pump Control reliability is critical.

By following the practices outlined in this guide—from proper program structure and Structured Text best practices to Unitronics-specific optimizations—you can deliver reliable Pump Control systems that meet Water & Wastewater requirements.

Next Steps for Professional Development:

1. Certification: Pursue Unitronics Certified Integrator to validate your Unitronics expertise
2. Advanced Training: Consider UniLogic Developer Training for specialized Water & Wastewater applications
3. Hands-on Practice: Build Pump Control projects using Jazz 2 hardware
4. Stay Current: Follow VisiLogic / UniLogic updates and new Structured Text features

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

The 2-4 weeks typical timeline for Pump Control projects will decrease as you gain experience with these patterns and techniques. 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.