Learn PLCs free
Intermediate15 min readWater & Wastewater

Horner Automation Function Blocks for Pump Control

Learn Function Blocks programming for Pump Control using Horner Automation Cscape. Includes code examples, best practices, and step-by-step implementation guide for Water & Wastewater applications.

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

Troubleshooting Function Blocks programs for Pump Control in Horner Automation's Cscape benefits from a systematic diagnostic process and a clear understanding of likely failure modes. This guide provides a repeatable path from observed symptom to evidence, hypothesis, controlled test, and documented correction.

Start by recording the controller model, firmware, Cscape version, task state, active faults, I/O status, and the exact conditions that reproduce the problem. Preserve the original project and collect diagnostic evidence before changing logic.

Common challenges in Pump Control systems include pressure regulation, pump sequencing, and energy optimization. When implemented with Function Blocks, additional considerations include can become cluttered with complex logic, requiring specific diagnostic approaches. Horner Automation's diagnostic tools in Cscape provide powerful capabilities, but knowing exactly which tools to use for specific symptoms dramatically improves troubleshooting efficiency.

This guide walks through systematic troubleshooting procedures, from initial symptom analysis through root-cause verification and corrective-action testing. It explains how to use relevant Cscape diagnostic features and interpret system behavior in a Pump Control context without assuming that one symptom always has the same cause.

Horner Automation Cscape for Pump Control

Cscape is a programming environment associated with Horner Automation controller families such as XL4, XL7, XL10. This guide uses Function Blocks 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 Function Blocks constructs

  • The project version matches the installed Cscape 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:

  • XL4: Confirm CPU, I/O, memory, communications, and Function Blocks support in the current selection guide

  • XL7: Confirm CPU, I/O, memory, communications, and Function Blocks support in the current selection guide

  • XL10: Confirm CPU, I/O, memory, communications, and Function Blocks support in the current selection guide

  • XL15: Confirm CPU, I/O, memory, communications, and Function Blocks 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 Horner Automation 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 Function Blocks for Pump Control

Function Block Diagram (FBD) is a graphical programming language where functions and function blocks are represented as boxes connected by signal lines. Data flows from left to right through the network.

Execution Model:

Blocks execute based on data dependencies - a block executes only when all its inputs are available. Networks execute top to bottom when dependencies allow.

Core Advantages for Pump Control:

  • Visual representation of signal flow: Critical for Pump Control when handling intermediate control logic

  • Good for modular programming: Critical for Pump Control when handling intermediate control logic

  • Reusable components: Critical for Pump Control when handling intermediate control logic

  • Excellent for process control: Critical for Pump Control when handling intermediate control logic

  • Good for continuous operations: Critical for Pump Control when handling intermediate control logic


Why Function Blocks 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 Function Blocks:

StandardBlocks:
- logic: AND, OR, XOR, NOT - Boolean logic operations
- comparison: EQ, NE, LT, GT, LE, GE - Compare values
- math: ADD, SUB, MUL, DIV, MOD - Arithmetic operations

TimersCounters:
- ton: Timer On-Delay - Output turns ON after preset time
- tof: Timer Off-Delay - Output turns OFF after preset time
- tp: Pulse Timer - Output pulses for preset time

Connections:
- wires: Connect output pins to input pins to pass data
- branches: One output can connect to multiple inputs
- feedback: Outputs can feed back to inputs for state machines

Best Practices for Function Blocks:

  • Arrange blocks for clear left-to-right data flow

  • Use consistent spacing and alignment for readability

  • Label all inputs and outputs with meaningful names

  • Create custom FBs for frequently repeated logic patterns

  • Minimize wire crossings by careful block placement


Common Mistakes to Avoid:

  • Creating feedback loops without proper initialization

  • Connecting incompatible data types

  • Not considering execution order dependencies

  • Overcrowding networks making them hard to read


Typical Applications:

1. HVAC control: Directly applicable to Pump Control
2. Temperature control: Related control patterns
3. Flow control: Related control patterns
4. Batch processing: Related control patterns

Understanding these fundamentals prepares you to implement effective Function Blocks solutions for Pump Control using Horner Automation Cscape.

Implementing Pump Control with Function Blocks

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 Horner Automation Cscape and Function Blocks 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 Cscape, characterize pump curve and system curve.

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

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

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

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

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

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

Step 5: Program lead/lag sequencing with alternation

In Cscape, program lead/lag sequencing with alternation.

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

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


Horner Automation Function Design:

Cscape includes a library of vendor-supplied FBs covering timers, counters, PID, communication, and HMI utilities. User-defined subroutines and FBs are supported for code reuse within a project. Private cross-project libraries are maintained by OEM machine builders but the ecosystem is smaller than for Codesys-based brands. Reuse is typically pattern-based (copy-paste-adapt) rather than via shared-library imports.

Common Challenges and Solutions:

1. Preventing cavitation at low suction pressure

  • Solution: Function Blocks addresses this through Visual representation of signal flow.


2. Managing minimum flow requirements

  • Solution: Function Blocks addresses this through Good for modular programming.


3. Coordinating VFD speed with system pressure

  • Solution: Function Blocks addresses this through Reusable components.


4. Handling pump cycling with varying demand

  • Solution: Function Blocks addresses this through Excellent for process control.


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

Horner Automation Diagnostic Tools:

Cscape integrated debugger with ladder and ST monitoring,Built-in PLC and HMI simulator for offline logic testing,OCS webserver (on capable models) for remote diagnostic access,Integrated communication diagnostics for Cscape-supported protocols,SD card logging with PC-side CSV export,Cellular signal-strength monitoring on OCS Cellular variants,Real-time variable watch tables within Cscape,Modbus RTU/TCP protocol analyzer,Horner technical support direct-contact model (US-based engineers),Backup/restore utility in Cscape for project and configuration

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

Horner Automation Function Blocks Example for Pump Control

Illustrative Function Blocks example for Pump Control using Horner Automation terminology. Adapt the syntax to your Cscape release, compile it, and verify it in an isolated test environment before use on equipment.

(* Horner Automation Cscape - Pump Control Control *)
(* Reusable Function Blocks Implementation *)
(* Cscape includes a library of vendor-supplied FBs covering ti *)

FUNCTION_BLOCK FB_PUMP_CONTROL_Controller

VAR_INPUT
    bEnable : BOOL;                  (* Enable control *)
    bReset : BOOL;                   (* Fault reset *)
    rProcessValue : REAL;            (* Pressure transmitters for discharge and suction pressure *)
    rSetpoint : REAL := 100.0;  (* Illustrative value; replace with a reviewed requirement *)
    bEmergencyStop : BOOL;           (* Safety input *)
END_VAR

VAR_OUTPUT
    rControlOutput : REAL;           (* Variable frequency drives (VFDs) for speed control *)
    bRunning : BOOL;                 (* Process active *)
    bComplete : BOOL;                (* Cycle complete *)
    bFault : BOOL;                   (* Fault status *)
    nFaultCode : INT;                (* Diagnostic code *)
END_VAR

VAR
    (* Internal Function Blocks *)
    fbSafety : FB_SafetyMonitor;     (* Safety logic *)
    fbRamp : FB_RampGenerator;       (* Soft start/stop *)
    fbPID : FB_PIDController;        (* Process control *)
    fbDiag : FB_Diagnostics;         (* Alarm handling typically uses custom ladder logic that sets a %M bit when an alarm condition is met, records a timestamp in a %R register, and triggers HMI banner display. Cscape's alarm objects on the HMI side handle acknowledgement and history display. For more sophisticated alarm management, engineers typically roll their own framework rather than relying on a vendor alarm engine. *)

    (* Internal State *)
    eInternalState : E_ControlState;
    tonWatchdog : TON;
END_VAR

(* Safety Monitor - Dry run protection using flow or level monitoring *)
fbSafety(
    Enable := bEnable,
    EmergencyStop := bEmergencyStop,
    ProcessValue := rProcessValue,
    HighLimit := rSetpoint * 1.2,
    LowLimit := rSetpoint * 0.1
);

(* Main Control Logic *)
IF fbSafety.SafeToRun THEN
    (* Ramp Generator - Prevents startup surge *)
    fbRamp(
        Enable := bEnable,
        TargetValue := rSetpoint,
        RampRate := 20.0,  (* Illustrative value; tune and verify for the process *)
        CurrentValue => rSetpoint
    );

    (* PID Controller - Process regulation *)
    fbPID(
        Enable := fbRamp.InPosition,
        ProcessValue := rProcessValue,
        Setpoint := fbRamp.CurrentValue,
        Kp := 1.0,
        Ki := 0.1,
        Kd := 0.05,
        OutputMin := 0.0,
        OutputMax := 100.0
    );

    rControlOutput := fbPID.Output;
    bRunning := TRUE;
    bFault := FALSE;
    nFaultCode := 0;

ELSE
    (* Safe State - Overtemperature protection for motor and bearings *)
    rControlOutput := 0.0;
    bRunning := FALSE;
    bFault := NOT bEnable;  (* Only fault if not intentional stop *)
    nFaultCode := fbSafety.FaultCode;
END_IF;

(* Diagnostics - Data logging commonly writes to SD card in CSV format using vendor-provided file-IO FBs. Triggers are typically time-based or event-based. Cellular-connected variants can push logs via FTP or email. For SCADA-replacement scenarios, OCS Modem and Cellular controllers serve as the data-gateway function themselves, integrating remote sites with central systems. *)
fbDiag(
    ProcessRunning := bRunning,
    FaultActive := bFault,
    ProcessValue := rProcessValue,
    ControlOutput := rControlOutput
);

(* Watchdog - Detects frozen control *)
tonWatchdog(IN := bRunning AND NOT fbPID.OutputChanging, PT := T#10S);
IF tonWatchdog.Q THEN
    bFault := TRUE;
    nFaultCode := 99;  (* Watchdog fault *)
END_IF;

(* Reset Logic *)
IF bReset AND NOT bEmergencyStop THEN
    bFault := FALSE;
    nFaultCode := 0;
    fbDiag.ClearAlarms();
END_IF;

END_FUNCTION_BLOCK

Code Explanation:

  • 1.Encapsulated function block follows Cscape includes a library of vendor-supp - reusable across Water & Wastewater projects
  • 2.FB_SafetyMonitor illustrates status checks and high/low limits; it is not a certified safety function
  • 3.FB_RampGenerator prevents startup issues common in Pump Control systems
  • 4.FB_PIDController tuned for Water & Wastewater: Kp=1.0, Ki=0.1
  • 5.Watchdog timer illustrates one way to flag an unchanged output for diagnosis
  • 6.Diagnostic function block enables Data logging commonly writes to SD card in CSV format using vendor-provided file-IO FBs. Triggers are typically time-based or event-based. Cellular-connected variants can push logs via FTP or email. For SCADA-replacement scenarios, OCS Modem and Cellular controllers serve as the data-gateway function themselves, integrating remote sites with central systems. and Alarm handling typically uses custom ladder logic that sets a %M bit when an alarm condition is met, records a timestamp in a %R register, and triggers HMI banner display. Cscape's alarm objects on the HMI side handle acknowledgement and history display. For more sophisticated alarm management, engineers typically roll their own framework rather than relying on a vendor alarm engine.

Best Practices

  • Follow Horner Automation naming conventions: Horner projects use Horner-specific tag addressing in earlier projects (%R, %M,
  • Horner Automation function design: Cscape includes a library of vendor-supplied FBs covering timers, counters, PID,
  • Data organization: Horner controllers use reference-table addressing (%R integers, %M booleans, %AI
  • Function Blocks: Arrange blocks for clear left-to-right data flow
  • Function Blocks: Use consistent spacing and alignment for readability
  • Function Blocks: Label all inputs and outputs with meaningful names
  • 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 Cscape: Use Cscape's built-in simulator before deploying to hardware when poss
  • 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

  • Function Blocks: Creating feedback loops without proper initialization
  • Function Blocks: Connecting incompatible data types
  • Function Blocks: Not considering execution order dependencies
  • Horner Automation common error: Cscape version-to-firmware compatibility issues after hardware upgrades
  • 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 Function Blocks programs unmaintainable over time

Related Certifications

🏆Horner Automation Certified Specialist
🏆Advanced Horner Automation Programming Certification

Applying Function Blocks to Pump Control using Horner Automation Cscape 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 Cscape 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

Function Blocks Foundation:

Function Block Diagram (FBD) is a graphical programming language where functions and function blocks are represented as boxes connected by signal line...

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 Temperature control, Wastewater treatment, and Horner Automation platform-specific features for Pump Control optimization.