Learn PLCs free
Intermediate20 min readBuilding Automation

Siemens Structured Text for HVAC Control

Learn Structured Text programming for HVAC Control using Siemens TIA Portal. Includes code examples, best practices, and step-by-step implementation guide for Building Automation applications.

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

Optimizing Structured Text for HVAC Control applications in Siemens's TIA Portal requires measuring the baseline and understanding the demands of Building Automation. This guide focuses on techniques you can evaluate with task timing, scan-time traces, memory use, and controlled fault tests.

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

Performance considerations for HVAC Control systems extend beyond basic functionality. Critical factors include 5 sensor types, 5 actuators, communications load, and the need to handle energy optimization. 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 HVAC 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.

Siemens TIA Portal for HVAC Control

TIA Portal is a programming environment associated with Siemens controller families such as S7-1200, S7-1500, S7-300. 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 TIA Portal 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 HVAC Control exercise, map the required inputs and outputs before writing logic. The example considers 5 sensor types, including Temperature sensors (RTD, Thermocouple), Humidity sensors, Pressure sensors, and 5 actuator types.

Control Equipment for HVAC Control:

  • Air handling units (AHUs) with supply and return fans

  • Variable air volume (VAV) boxes with reheat

  • Chillers and cooling towers for central cooling

  • Boilers and heat exchangers for heating


Controller-family references used in this guide include:

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

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

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

  • S7-400: 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 Siemens 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 HVAC 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 HVAC 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 HVAC Control:

  • Powerful for complex logic: Critical for HVAC Control when handling intermediate control logic

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

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

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

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


Why Structured Text Fits HVAC Control:

HVAC Control systems in Building Automation typically involve:

  • Sensors: Temperature sensors (RTD, thermistors, thermocouples) for zone and supply/return monitoring, Humidity sensors (capacitive or resistive) for moisture control, CO2 sensors for demand-controlled ventilation

  • Actuators: Variable frequency drives (VFDs) for fan and pump speed control, Modulating control valves (2-way and 3-way) for heating/cooling coils, Damper actuators (0-10V or 4-20mA) for air flow control

  • Complexity: Intermediate with challenges including Tuning PID loops for slow thermal processes without causing oscillation


Control Strategies for HVAC Control:

  • zoneTemperature: Cascaded PID control where zone temperature error calculates supply air temperature setpoint, which then modulates cooling/heating valves or VAV damper position

  • supplyAirTemperature: PID control of cooling coil valve, heating coil valve, or economizer dampers to maintain supply air temperature setpoint

  • staticPressure: PID control of supply fan VFD speed to maintain duct static pressure setpoint for proper VAV box operation


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 HVAC 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 HVAC Control using Siemens TIA Portal.

Implementing HVAC Control with Structured Text

HVAC (Heating, Ventilation, and Air Conditioning) control systems use PLCs to regulate temperature, humidity, and air quality in buildings and industrial facilities. These systems balance comfort, energy efficiency, and equipment longevity through sophisticated control algorithms.

This walkthrough demonstrates practical implementation using Siemens TIA Portal and Structured Text programming.

System Requirements:

A typical HVAC Control implementation includes:

Input Devices (Sensors):
1. Temperature sensors (RTD, thermistors, thermocouples) for zone and supply/return monitoring: Critical for monitoring system state
2. Humidity sensors (capacitive or resistive) for moisture control: Critical for monitoring system state
3. CO2 sensors for demand-controlled ventilation: Critical for monitoring system state
4. Pressure sensors for duct static pressure and building pressurization: Critical for monitoring system state
5. Occupancy sensors (PIR, ultrasonic) for demand-based operation: Critical for monitoring system state

Output Devices (Actuators):
1. Variable frequency drives (VFDs) for fan and pump speed control: Primary control output
2. Modulating control valves (2-way and 3-way) for heating/cooling coils: Supporting control function
3. Damper actuators (0-10V or 4-20mA) for air flow control: Supporting control function
4. Compressor contactors and staging relays: Supporting control function
5. Humidifier and dehumidifier control outputs: Supporting control function

Control Equipment:

  • Air handling units (AHUs) with supply and return fans

  • Variable air volume (VAV) boxes with reheat

  • Chillers and cooling towers for central cooling

  • Boilers and heat exchangers for heating


Control Strategies for HVAC Control:

  • zoneTemperature: Cascaded PID control where zone temperature error calculates supply air temperature setpoint, which then modulates cooling/heating valves or VAV damper position

  • supplyAirTemperature: PID control of cooling coil valve, heating coil valve, or economizer dampers to maintain supply air temperature setpoint

  • staticPressure: PID control of supply fan VFD speed to maintain duct static pressure setpoint for proper VAV box operation


Implementation Steps:

Step 1: Document all zones with temperature requirements and occupancy schedules

In TIA Portal, document all zones with temperature requirements and occupancy schedules.

Step 2: Create I/O list with all sensors, actuators, and their signal types

In TIA Portal, create i/o list with all sensors, actuators, and their signal types.

Step 3: Define setpoints, operating limits, and alarm thresholds

In TIA Portal, define setpoints, operating limits, and alarm thresholds.

Step 4: Implement zone temperature control loops with anti-windup

In TIA Portal, implement zone temperature control loops with anti-windup.

Step 5: Program equipment sequencing with proper lead-lag rotation

In TIA Portal, program equipment sequencing with proper lead-lag rotation.

Step 6: Add economizer logic with lockouts for high humidity conditions

In TIA Portal, add economizer logic with lockouts for high humidity conditions.


Siemens Function Design:

Functions (FCs) and Function Blocks (FBs) form the modular building blocks of structured Siemens programs. FCs are stateless code blocks without persistent memory, suitable for calculations, data conversions, or operations that don't require retaining values between calls. FC parameters include IN for input values, OUT for returned results, IN_OUT for passed pointers to existing variables, and TEMP for temporary calculations discarded after execution. Return values are defined using the RETURN data type declaration. FBs contain STAT (static) variables that persist between scan cycles, stored in instance DBs, making them ideal for controlling equipment with ongoing state like motors, valves, or process loops. Multi-instance FBs reduce memory overhead by embedding multiple FB instances within a parent FB's instance DB. The block interface clearly separates Input, Output, InOut, Stat (persistent), Temp (temporary), and Constant sections. FB parameters should include Enable inputs, feedback status outputs, error outputs with diagnostic codes, and configuration parameters for setpoints and timings. Versioned FBs in Type Libraries support interface extensions while maintaining backward compatibility using optional parameters with default values. Generic FB designs incorporate enumerated data types (ENUM) for state machines: WAITING, RUNNING, STOPPING, FAULTED. Call structures pass instance DB references explicitly: Motor_FB(DB1) or multi-instances as Motor_FB.Instance[1]. SCL (Structured Control Language) provides text-based programming within FCs/FBs for complex algorithms, offering better readability than ladder for mathematical operations and CASE statements. Block properties define code attributes: Know-how protection encrypts proprietary logic, version information tracks revisions, and block icons customize graphic representation in calling networks.

Common Challenges and Solutions:

1. Tuning PID loops for slow thermal processes without causing oscillation

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


2. Preventing simultaneous heating and cooling which wastes energy

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


3. Managing zone interactions in open-plan spaces

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


4. Balancing fresh air requirements with energy efficiency

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


Safety Considerations:

  • Freeze protection for coils with low-limit thermostats and valve positioning

  • High-limit safety shutoffs for heating equipment

  • Smoke detector integration for fan shutdown and damper closure

  • Fire/smoke damper monitoring and control

  • Emergency ventilation modes for hazardous conditions


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

Siemens Diagnostic Tools:

Program Status: Real-time monitoring showing actual rung logic states with green highlights for TRUE conditions and value displays,Force Tables: Override inputs/outputs permanently (use with extreme caution, indicated by warning icons),Modify Variable: Temporarily change tag values in online mode for testing without redownload,Trace & Watch Tables: Record up to 50 variables synchronously with 1ms resolution, triggered by conditions,Diagnostic Buffer: Chronological log of 200 system events including mode changes, errors, and module diagnostics,ProDiag Viewer: Displays user-configured diagnostic messages with operator guidance and troubleshooting steps,Web Server Diagnostics: Browser-based access to buffer, topology, communication load, and module status,PROFINET Topology: Live view of network with link quality, update times, and neighbor relationships,Memory Usage Statistics: Real-time display of work memory, load memory, and retentive memory consumption,Communication Diagnostics: Connection statistics, telegram counters, and partner unreachable conditions,Test & Commissioning Functions: Actuator testing, sensor simulation, and step-by-step execution modes,Reference Data Cross-Reference: Shows all code locations using specific variables, DBs, or I/O addresses

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

Siemens Structured Text Example for HVAC Control

Illustrative Structured Text example for HVAC Control using Siemens terminology. Adapt the syntax to your TIA Portal release, compile it, and verify it in an isolated test environment before use on equipment.

(* Siemens TIA Portal - HVAC Control Control *)
(* Structured Text Implementation for Building Automation *)
(* Siemens recommends structured naming conventions using the PLC tag tab *)

PROGRAM PRG_HVAC_CONTROL_Control

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

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

    (* Counters *)
    ctuCycleCounter : CTU;

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

VAR CONSTANT
    (* Building Automation 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 machine implementation in Siemens  *)
CASE eState OF
    IDLE:
        rVariablefrequencydrivesVFDs := 0.0;
        ctuCycleCounter(RESET := TRUE);
        IF bEnable AND rTemperaturesensorsRTDThermocouple > 10.0 THEN
            eState := STARTING;
        END_IF;

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

    RUNNING:
        (* HVAC Control active - HVAC (Heating, Ventilation, and Air Conditioning)  *)
        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:
        rVariablefrequencydrivesVFDs := 0.0;
        (* Log production data - High-speed data logging captures process variables into archive DBs with configurable sample rates from 1ms to several minutes using Recipe_DataLog FB. Create circular buffer structure: ARRAY[1..10000] OF STRUCT containing Timestamp (DTL), Values (ARRAY of REAL), and Status (BYTE). Write pointer increments with each sample wrapping to start when buffer full, oldest data automatically overwritten. Triggered logging initiates capture on alarm conditions preserving pre-trigger and post-trigger data for root cause analysis. Multi-variable logging synchronizes up to 200 analog/digital tags per record ensuring time-correlated data. Archiving to SIMATIC Memory Card provides non-volatile storage surviving power loss with background writing preventing scan time impact. CSV export function formats logged data for Excel analysis or import to third-party analytics platforms. Integration with SIMATIC Process Historian automatically transfers logs to central server via OPC UA for long-term trending and plant-wide analysis. Compression algorithms reduce storage requirements for slowly-changing values using deadband filtering. Recipe logging captures batch parameters, operator setpoints, and quality measurements linking production data to specific product lots. Energy logging tracks consumption per machine zone calculating OEE (Overall Equipment Effectiveness) metrics. Communication logging records message traffic, connection events, and telegram errors for network troubleshooting. Diagnostic logging stores CPU mode changes, hardware faults, and program modifications creating audit trail for regulated industries. *)
        eState := IDLE;

    FAULT:
        rVariablefrequencydrivesVFDs := 0.0;
        (* Alarm management leverages ProDiag function blocks creating operator-guidance alarms with three severity levels: warnings (yellow), errors (red), and status messages (blue). Configure ProDiag_Info_UserDB containing message texts in multiple languages stored in system text lists. Alarm blocks include diagnostic text with parameter placeholders: 'Tank {1} temperature {2}°C exceeds limit {3}°C' where parameters substitute actual values at runtime. Implement alarm priority hierarchy ensuring critical alarms display prominently despite hundreds of simultaneous conditions. Use alarm classes grouping related alarms: SAFETY, PROCESS, MAINTENANCE, COMMUNICATION with class-specific acknowledgment requirements and escalation timers. Alarm buffering stores 1000+ alarms in circular buffer DB with timestamps, values, and operator acknowledgments for post-incident analysis. Fleeting alarms (active less than scan cycle) use latch logic preserving occurrence until operator acknowledgment. Alarm rate limiting prevents flood conditions where single fault cascades into hundreds of consequential alarms by introducing short delays before enabling secondary alarms. Integration with WinCC Alarm Control provides filtering, sorting, and archiving with export to SQL databases for trend analysis. SMS/email notification for critical alarms uses Industrial Ethernet messaging blocks sending formatted text to distribution lists. Alarm analytics tracks most frequent alarms identifying chronic equipment issues requiring maintenance attention. Shelving functionality allows temporary suppression of nuisance alarms during commissioning or maintenance without modifying PLC code. *)
        IF bFaultReset AND NOT bEmergencyStop THEN
            bFaultActive := FALSE;
            eState := IDLE;
        END_IF;
END_CASE;

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

END_PROGRAM

Code Explanation:

  • 1.Enumerated state machine (State machine implementation in Siemens uses enumerated data types (ENUM) defining states like IDLE, STARTING, RUNNING, STOPPING, FAULTED combined with CASE statements in SCL for clarity. Create UDT 'StateMachine_Type' containing CurrentState (ENUM), PreviousState (ENUM), StateTimer (TON), and TransitionConditions (STRUCT). Main state logic resides in CASE CurrentState OF structure with each state performing actions and checking transition conditions. State transitions update PreviousState before changing CurrentState, enabling return-to-last-state recovery. Timer-based states use IF StateTimer.Q THEN advance to next state pattern. Fault handling uses nested CASE for fault severity levels with automatic or manual recovery logic. State change logging writes to circular buffer DB for diagnostics. Operator HMI displays state names via enumeration text lists. Initialization in OB100 sets CurrentState := IDLE and resets all transition flags. State machine execution encapsulated in FB allows multiple instances for identical equipment like ARRAY[1..10] OF MachineControl_FB. Parallel state machines coordinate through shared command/status DBs with arbitration logic preventing conflicts. GRAPH language provides graphical state machine programming with automatic interlock generation, suitable for less complex sequences where visualization aids maintenance personnel understanding.) for clear HVAC 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 Siemens naming conventions: Siemens recommends structured naming conventions using the PLC tag table with sy
  • Siemens function design: Functions (FCs) and Function Blocks (FBs) form the modular building blocks of st
  • Data organization: Data Blocks (DBs) are fundamental to Siemens programming, serving as structured
  • 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
  • HVAC Control: Use slow integral action for temperature loops to prevent hunting
  • HVAC Control: Implement anti-windup to prevent integral buildup during saturation
  • HVAC Control: Add rate limiting to outputs to prevent actuator wear
  • Debug with TIA Portal: Use CALL_TRACE to identify the call hierarchy leading to errors in dee
  • Safety: Freeze protection for coils with low-limit thermostats and valve positioning
  • Use a compatible simulator or isolated test rig to test HVAC 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
  • Siemens common error: 16#8022: DB does not exist or is too short - called DB number not loaded or inte
  • HVAC Control: Tuning PID loops for slow thermal processes without causing oscillation
  • HVAC Control: Preventing simultaneous heating and cooling which wastes energy
  • Neglecting to validate Temperature sensors (RTD, thermistors, thermocouples) for zone and supply/return monitoring leads to control errors
  • Insufficient comments make Structured Text programs unmaintainable over time

Related Certifications

🏆Siemens Certified Programmer
🏆TIA Portal Certification
🏆Advanced Siemens Programming Certification

Applying Structured Text to HVAC Control using Siemens TIA Portal 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 HVAC 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 TIA Portal 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 slow integral action for temperature loops to prevent hunting

For further learning, explore related topics including Recipe management, Hospital environmental systems, and Siemens platform-specific features for HVAC Control optimization.