Learn PLCs free
Intermediate20 min readInfrastructure

Eaton Structured Text for Traffic Light Control

Learn Structured Text programming for Traffic Light Control using Eaton XSoft-CoDeSys-3 / easySoft. Includes code examples, best practices, and step-by-step implementation guide for Infrastructure applications.

💻
Platform
XSoft-CoDeSys-3 / easySoft
📊
Complexity
Beginner
⏱️
Project Duration
1-2 weeks

Learning to implement Structured Text for Traffic Light Control using Eaton's XSoft-CoDeSys-3 / easySoft is a useful skill for PLC programmers working in Infrastructure. This guide walks through the fundamentals with clear explanations and an illustrative example that you can adapt to a simulator or test bench.

The example uses Eaton terminology and references controller families such as easyE4 and XC-100. Confirm the exact instructions, data types, firmware requirements, and licensing in the current vendor documentation before choosing hardware or deploying a project.

The Structured Text approach is particularly well-suited for Traffic Light Control because complex calculations, data manipulation, advanced control algorithms, and when code reusability is important. This combination allows you to leverage powerful for complex logic while managing the typical challenges of Traffic Light Control, including timing optimization and emergency vehicle priority.

Throughout this guide, you'll find step-by-step implementation guidance, an illustrative code example, and a verification checklist specific to Infrastructure. Whether you're programming your first Traffic Light Control exercise or transitioning from another PLC platform, use the material as a starting point and validate it in your exact XSoft-CoDeSys-3 / easySoft version and controller environment.

Eaton XSoft-CoDeSys-3 / easySoft for Traffic Light Control

XSoft-CoDeSys-3 / easySoft is a programming environment associated with Eaton controller families such as easyE4, XC-100, XC-152. 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 XSoft-CoDeSys-3 / easySoft 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 Traffic Light Control exercise, map the required inputs and outputs before writing logic. The example considers 5 sensor types, including Vehicle detection loops, Pedestrian buttons, Camera sensors, and 4 actuator types.

Control Equipment for Traffic Light Control:

  • NEMA TS2 or ATC traffic controller cabinets

  • Conflict monitors for signal verification

  • Malfunction management units (MMU)

  • Uninterruptible power supplies (UPS)


Controller-family references used in this guide include:

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

  • XC-100: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

  • XC-152: Confirm CPU, I/O, memory, communications, and Structured Text support in the current selection guide

  • XC-202: 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 Eaton 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 Traffic Light 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 Traffic Light 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 Traffic Light Control:

  • Powerful for complex logic: Critical for Traffic Light Control when handling beginner control logic

  • Excellent code reusability: Critical for Traffic Light Control when handling beginner control logic

  • Compact code representation: Critical for Traffic Light Control when handling beginner control logic

  • Good for algorithms and calculations: Critical for Traffic Light Control when handling beginner control logic

  • Familiar to software developers: Critical for Traffic Light Control when handling beginner control logic


Why Structured Text Fits Traffic Light Control:

Traffic Light Control systems in Infrastructure typically involve:

  • Sensors: Inductive loop detectors embedded in pavement for vehicle detection, Video detection cameras with virtual detection zones, Pedestrian push buttons with ADA-compliant features

  • Actuators: LED signal heads for vehicle indications (red, yellow, green, arrows), Pedestrian signal heads (walk, don't walk, countdown), Flashing beacons for warning applications

  • Complexity: Beginner with challenges including Balancing main street progression with side street delay


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 Traffic Light 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 Traffic Light Control using Eaton XSoft-CoDeSys-3 / easySoft.

Implementing Traffic Light Control with Structured Text

Traffic signal control systems manage the safe and efficient flow of vehicles and pedestrians at intersections. PLCs implement signal timing plans, coordinate with adjacent intersections, respond to traffic demands, and interface with central traffic management systems.

This walkthrough demonstrates practical implementation using Eaton XSoft-CoDeSys-3 / easySoft and Structured Text programming.

System Requirements:

A typical Traffic Light Control implementation includes:

Input Devices (Sensors):
1. Inductive loop detectors embedded in pavement for vehicle detection: Critical for monitoring system state
2. Video detection cameras with virtual detection zones: Critical for monitoring system state
3. Pedestrian push buttons with ADA-compliant features: Critical for monitoring system state
4. Preemption receivers for emergency vehicle detection (optical or radio): Critical for monitoring system state
5. Railroad crossing interconnect signals: Critical for monitoring system state

Output Devices (Actuators):
1. LED signal heads for vehicle indications (red, yellow, green, arrows): Primary control output
2. Pedestrian signal heads (walk, don't walk, countdown): Supporting control function
3. Flashing beacons for warning applications: Supporting control function
4. Advance warning flashers: Supporting control function
5. Cabinet cooling fans and environmental controls: Supporting control function

Control Equipment:

  • NEMA TS2 or ATC traffic controller cabinets

  • Conflict monitors for signal verification

  • Malfunction management units (MMU)

  • Uninterruptible power supplies (UPS)


Control Strategies for Traffic Light Control:

1. Primary Control: Automated traffic signal control using PLCs for intersection management, timing optimization, and pedestrian safety.
2. Safety Interlocks: Preventing Timing optimization
3. Error Recovery: Handling Emergency vehicle priority

Implementation Steps:

Step 1: Survey intersection geometry and traffic patterns

In XSoft-CoDeSys-3 / easySoft, survey intersection geometry and traffic patterns.

Step 2: Define phases and rings per NEMA/ATC standards

In XSoft-CoDeSys-3 / easySoft, define phases and rings per nema/atc standards.

Step 3: Calculate minimum and maximum green times for each phase

In XSoft-CoDeSys-3 / easySoft, calculate minimum and maximum green times for each phase.

Step 4: Implement detector logic with extending and presence modes

In XSoft-CoDeSys-3 / easySoft, implement detector logic with extending and presence modes.

Step 5: Program phase sequencing with proper clearance intervals

In XSoft-CoDeSys-3 / easySoft, program phase sequencing with proper clearance intervals.

Step 6: Add pedestrian phases with accessible pedestrian signals

In XSoft-CoDeSys-3 / easySoft, add pedestrian phases with accessible pedestrian signals.


Eaton Function Design:

Eaton projects typically build atop Codesys's standard FB libraries (timers, counters, PID, motion) plus Eaton-specific libraries for SmartWire-DT device control and easyE4 smart-relay integration. OEMs often maintain private function-block libraries for their machine families. Code reuse practices mirror mainstream Codesys conventions; OOP extensions are available but not heavily adopted.

Common Challenges and Solutions:

1. Balancing main street progression with side street delay

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


2. Handling varying traffic demands throughout the day

  • Solution: Structured Text addresses this through Excellent code reusability.


3. Providing adequate pedestrian crossing time

  • Solution: Structured Text addresses this through Compact code representation.


4. Managing detector failures gracefully

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


Safety Considerations:

  • Conflict monitoring to detect improper signal states

  • Yellow and all-red clearance intervals per engineering standards

  • Flashing operation mode for controller failures

  • Pedestrian minimum walk and clearance times per MUTCD

  • Railroad preemption for track clearance


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

Eaton Diagnostic Tools:

XSoft-CoDeSys-3 integrated debugger with breakpoints, watch, and trace,easySoft project simulator for easyE4 logic development without hardware,CoDeSys trace buffer — capture variable histories during live operation,XSoft-CoDeSys-3 network analyzer for EtherCAT and PROFINET fieldbus diagnostics,Online parameter comparison between development PC and running controller,easyE4 webserver interface — remote status view from any browser,SmartWire-DT diagnostics for Eaton's own device-level network,Modbus TCP protocol analyzer built into XSoft-CoDeSys-3,Controller self-diagnostics via LED codes (standard Codesys behaviour),Eaton Automation Portal online documentation and firmware archive

Use the monitoring and diagnostic functions available in your XSoft-CoDeSys-3 / easySoft version, and record the software, firmware, hardware, workload, and test procedure with every result.

Eaton Structured Text Example for Traffic Light Control

Illustrative Structured Text example for Traffic Light Control using Eaton terminology. Adapt the syntax to your XSoft-CoDeSys-3 / easySoft release, compile it, and verify it in an isolated test environment before use on equipment.

(* Eaton XSoft-CoDeSys-3 / easySoft - Traffic Light Control Control *)
(* Structured Text Implementation for Infrastructure *)
(* Eaton Codesys projects follow IEC 61131-3 conventions — camelCase for  *)

PROGRAM PRG_TRAFFIC_LIGHT_CONTROL_Control

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

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

    (* Counters *)
    ctuCycleCounter : CTU;

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

VAR CONSTANT
    (* Infrastructure 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 on Eaton controllers are  *)
CASE eState OF
    IDLE:
        rLEDtrafficsignals := 0.0;
        ctuCycleCounter(RESET := TRUE);
        IF bEnable AND rVehicledetectionloops > 0.0 THEN
            eState := STARTING;
        END_IF;

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

    RUNNING:
        (* Traffic Light Control active - Traffic signal control systems manage the safe and *)
        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:
        rLEDtrafficsignals := 0.0;
        (* Log production data - Data logging patterns range from simple CSV append via Codesys file-IO FBs to networked SQL writes via OPC UA or MQTT. The easyE4 webserver provides basic data-export functionality for small-scale monitoring. For serious logging, XC-303 controllers with SD-card storage and SCADA integration are typical. *)
        eState := IDLE;

    FAULT:
        rLEDtrafficsignals := 0.0;
        (* Alarm handling on XC-series controllers typically uses custom FB-based alarm managers that write timestamped events to a buffer, with optional logging to SD card or networked databases. For easyE4, alarm-like behaviour is implemented by setting output bits tied to HMI indicators or SMS-notification via the optional WiFi/cellular module. Engineers wanting richer alarm handling typically move to XC. *)
        IF bFaultReset AND NOT bEmergencyStop THEN
            bFaultActive := FALSE;
            eState := IDLE;
        END_IF;
END_CASE;

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

END_PROGRAM

Code Explanation:

  • 1.Enumerated state machine (State machines on Eaton controllers are most commonly implemented as CASE-of-INT in ST with named state constants, or via CFC (Continuous Function Chart) for visual representation. For complex sequencing, IEC SFC is supported. easyE4 applications rarely implement full state machines; they use block-level logic for simpler sequencing patterns.) for clear Traffic Light 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 Eaton naming conventions: Eaton Codesys projects follow IEC 61131-3 conventions — camelCase for variables,
  • Eaton function design: Eaton projects typically build atop Codesys's standard FB libraries (timers, cou
  • Data organization: Codesys-based Eaton projects use IEC 61131-3 global variable lists and PROGRAM V
  • 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
  • Traffic Light Control: Use passage time (extension) values based on approach speed
  • Traffic Light Control: Implement detector failure fallback to recall or maximum timing
  • Traffic Light Control: Log all phase changes and detector events for analysis
  • Debug with XSoft-CoDeSys-3 / easySoft: Use XSoft-CoDeSys-3 online monitoring with trace buffers rather than p
  • Safety: Conflict monitoring to detect improper signal states
  • Use a compatible simulator or isolated test rig to test Traffic Light 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
  • Eaton common error: Codesys V3 vs V2 project incompatibility for engineers migrating from legacy Moe
  • Traffic Light Control: Balancing main street progression with side street delay
  • Traffic Light Control: Handling varying traffic demands throughout the day
  • Neglecting to validate Inductive loop detectors embedded in pavement for vehicle detection leads to control errors
  • Insufficient comments make Structured Text programs unmaintainable over time

Related Certifications

🏆Eaton Automation Certified Specialist
🏆Codesys-based programming certifications
🏆Advanced Eaton Programming Certification

Applying Structured Text to Traffic Light Control using Eaton XSoft-CoDeSys-3 / easySoft 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 beginner Traffic Light 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 XSoft-CoDeSys-3 / easySoft 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 passage time (extension) values based on approach speed

For further learning, explore related topics including Recipe management, Highway ramp metering, and Eaton platform-specific features for Traffic Light Control optimization.