Learn PLCs free
Intermediate20 min readWater & Wastewater

Red Lion Controls Structured Text for Pump Control

Learn Structured Text programming for Pump Control using Red Lion Controls Crimson 3.2. Includes code examples, best practices, and step-by-step implementation guide for Water & Wastewater applications.

💻
Platform
Crimson 3.2
📊
Complexity
Intermediate
⏱️
Project Duration
2-4 weeks

Implementing Structured Text for Pump Control using Red Lion Controls Crimson 3.2 requires translating a control narrative into code, tests, and commissioning checks. This hands-on guide focuses on practical implementation steps, an illustrative code example, and decisions that should be recorded during design review.

The guide uses Crimson 3.2 terminology and Structured Text because complex calculations, data manipulation, advanced control algorithms, and when code reusability is important. Confirm language support for the selected controller and software release, then map the example's 5 sensor inputs and 5 actuator outputs to the project's reviewed I/O list.

Real Pump Control projects in Water & Wastewater face practical challenges including pressure regulation, pump sequencing, and integration with existing systems. Success requires balancing powerful for complex logic against steeper learning curve, while meeting 2-4 weeks project timelines typical for Pump Control implementations.

This guide provides step-by-step implementation guidance, an illustrative example, practical design patterns, and troubleshooting scenarios. Compile and test the adapted logic in an isolated environment, verify fail-safe behavior with the responsible controls and safety reviewers, and complete site acceptance checks before production use.

Red Lion Controls Crimson 3.2 for Pump Control

Crimson 3.2 is a programming environment associated with Red Lion Controls controller families such as FlexEdge DA10D, FlexEdge DA30D, FlexEdge DA50D. 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 Crimson 3.2 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:

  • FlexEdge DA10D: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

  • FlexEdge DA30D: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

  • FlexEdge DA50D: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

  • Graphite HMI: 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 Red Lion Controls 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 Red Lion Controls Crimson 3.2.

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 Red Lion Controls Crimson 3.2 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 Crimson 3.2, characterize pump curve and system curve.

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

In Crimson 3.2, size vfd for application (constant torque vs. variable torque).

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

In Crimson 3.2, implement primary control loop (pressure, flow, or level).

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

In Crimson 3.2, add pump protection logic (minimum flow, temperature, seal).

Step 5: Program lead/lag sequencing with alternation

In Crimson 3.2, program lead/lag sequencing with alternation.

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

In Crimson 3.2, implement soft start/stop ramps for smooth operation.


Red Lion Controls Function Design:

Crimson projects use reusable 'programs' (Crimson's unit of logic code) with parameters. Library management is more basic than in mainstream IEC ecosystems; OEMs typically maintain private project templates and copy-adapt rather than importing shared libraries. FlexEdge DA's IEC PLC portion follows standard IEC 61131-3 function-block reuse patterns.

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

Red Lion Controls Diagnostic Tools:

Crimson 3.2 integrated debugger with tag monitoring and simulation mode,Built-in data-logging diagnostics with local and network-export options,Integrated communication analyzer for every supported driver (300+ protocols),FlexEdge webserver for remote HMI mirroring and device-level diagnostics,Visual logic debugger for Crimson logic (event-driven rather than scan-based),Real-time tag watch with filtering and grouping,Database import/export for tag-database migration and diffing,N-Tron managed switch diagnostics integrated with FlexEdge ecosystem,Red Lion US-based technical support,Crimson help system with protocol-specific driver documentation inline

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

Red Lion Controls Structured Text Example for Pump Control

Illustrative Structured Text example for Pump Control using Red Lion Controls terminology. Adapt the syntax to your Crimson 3.2 release, compile it, and verify it in an isolated test environment before use on equipment.

(* Red Lion Controls Crimson 3.2 - Pump Control Control *)
(* Structured Text Implementation for Water & Wastewater *)
(* Red Lion projects use Crimson's tag database with typed tags and descr *)

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 in Crimson are typically  *)
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 Crimson's built-in Logger — configured periodic or event-triggered records written to local SD card, networked SFTP, or cloud endpoints in CSV or JSON format. Integration with database historians is supported through standard protocols. For FlexEdge, integration with N-Tron switches and the wider Red Lion data ecosystem supports site-wide aggregation. *)
        eState := IDLE;

    FAULT:
        rCentrifugalpumps := 0.0;
        (* Alarm handling uses Crimson's built-in Alarm Manager — configured alarm conditions with severity, message text, logging, and HMI display behaviour. The alarm engine handles detection, acknowledgement, and history without custom code. Integration with email, SMS, or external alarm aggregators is configured via Crimson's notification features. *)
        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 in Crimson are typically implemented using tag-based state variables with event-driven logic checking the state on each event. The event-driven model maps naturally to state-transition logic. FlexEdge DA's IEC PLC portion uses standard CASE-based state machines in ST when PLC-side sequencing is required.) 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 Red Lion Controls naming conventions: Red Lion projects use Crimson's tag database with typed tags and descriptive nam
  • Red Lion Controls function design: Crimson projects use reusable 'programs' (Crimson's unit of logic code) with par
  • Data organization: Crimson tag databases hold typed tags with scope (Global, Alarm, Report, etc.) a
  • 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 Crimson 3.2: Use Crimson 3.2's simulation mode to test HMI and logic before deployi
  • 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
  • Red Lion Controls common error: Crimson version-to-firmware compatibility issues after hardware firmware upgrade
  • 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

🏆Red Lion Crimson Certified Engineer
🏆Red Lion Specialist Training
🏆Advanced Red Lion Controls Programming Certification

Applying Structured Text to Pump Control using Red Lion Controls Crimson 3.2 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 Crimson 3.2 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 Red Lion Controls platform-specific features for Pump Control optimization.