Siemens S7 Route

Siemens S7 Overview

The SIEMENS_S7 route enables direct communication with Siemens S7 PLCs using the native S7 protocol (ISO-on-TCP). It supports all major S7 PLC families and provides access to data blocks, memory areas, inputs, outputs, timers, and counters.

The S7 route uses native protocol communication, which is typically faster and more efficient than OPC UA for Siemens PLCs.

Basic Syntax

DEFINE ROUTE SiemensPLC WITH TYPE SIEMENS_S7
    ADD S7_CONFIG
        WITH IP "192.168.1.100"
        WITH CPU_TYPE "S71500"
        WITH RACK '0'
        WITH SLOT '1'
    ADD MAPPING ProcessData
        WITH EVERY 500 MILLISECONDS
        ADD TAG Temperature
            WITH ADDRESS "DB1.DBD100"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/temperature"

Supported CPU Types

CPU Type	Parameter Value	Typical Slot	Description
S7-200	`S7200`	0	Compact micro PLCs
S7-300	`S7300`	2	Modular PLCs
S7-400	`S7400`	2/3	High-performance PLCs
S7-1200	`S71200`	1	Compact controllers
S7-1500	`S71500`	1	Advanced controllers

For S7-1200/1500 PLCs, you may need to enable “Permit access with PUT/GET” in the PLC’s protection settings (Hardware Configuration → Protection & Security).

Connection Configuration

S7_CONFIG Parameters

string

required

S7 PLC IP address.

CPU_TYPE

string

required

CPU type: S7200, S7300, S7400, S71200, or S71500.

RACK

integer

PLC rack number. Default: 0.

SLOT

integer

PLC slot number. Default: 1 for S7-1200/1500, 2 for S7-300/400.

CONNECTION_TYPE

string

Connection type: PG (Programming device), OP (Operator Panel), or S7BASIC. Default: PG.

RETRY_ATTEMPTS

integer

Number of retry attempts on failure. Default: 3.

RETRY_TIME_SECONDS

integer

Seconds to wait between retries. Default: 5.

REFRESH_TIME_MS

integer

Refresh time in milliseconds. Default: 1000.

READ_TIMEOUT

integer

Read timeout in milliseconds. Default: 5000.

WRITE_TIMEOUT

integer

Write timeout in milliseconds. Default: 5000.

Connection Examples

S7-1500
S7-1200
S7-300
S7-400

ADD S7_CONFIG
    WITH IP "192.168.1.100"
    WITH CPU_TYPE "S71500"
    WITH RACK '0'
    WITH SLOT '1'
    WITH CONNECTION_TYPE "PG"

ADD S7_CONFIG
    WITH IP "192.168.1.50"
    WITH CPU_TYPE "S71200"
    WITH RACK '0'
    WITH SLOT '1'

ADD S7_CONFIG
    WITH IP "192.168.1.30"
    WITH CPU_TYPE "S7300"
    WITH RACK '0'
    WITH SLOT '2'

ADD S7_CONFIG
    WITH IP "192.168.1.20"
    WITH CPU_TYPE "S7400"
    WITH RACK '0'
    WITH SLOT '3'

S7 Addressing

Address Format

S7 addresses follow the pattern: <Area><Number>.<Offset> or <DB>.<Type><Offset>

Address	Description	Example
`DBn.DBXx.y`	Data Block bit	`DB1.DBX0.0` - DB1, byte 0, bit 0
`DBn.DBBx`	Data Block byte	`DB1.DBB0` - DB1, byte 0
`DBn.DBWx`	Data Block word (16-bit)	`DB1.DBW100` - DB1, word at byte 100
`DBn.DBDx`	Data Block double word (32-bit)	`DB1.DBD100` - DB1, dword at byte 100
`Mx.y`	Memory bit	`M0.0` - Marker byte 0, bit 0
`MBx`	Memory byte	`MB0` - Marker byte 0
`MWx`	Memory word	`MW100` - Marker word at byte 100
`MDx`	Memory double word	`MD100` - Marker dword at byte 100
`Ix.y`	Input bit	`I0.0` - Input byte 0, bit 0
`IBx`	Input byte	`IB0` - Input byte 0
`IWx`	Input word	`IW0` - Input word at byte 0
`Qx.y`	Output bit	`Q0.0` - Output byte 0, bit 0
`QBx`	Output byte	`QB0` - Output byte 0
`QWx`	Output word	`QW0` - Output word at byte 0
`Tx`	Timer	`T0` - Timer 0
`Cx`	Counter	`C0` - Counter 0

Address Types

ADDRESS_TYPE

string

Memory area type: DATABLOCK, MEMORY, INPUT, OUTPUT, TIMER, COUNTER.

For most configurations, the ADDRESS_TYPE is inferred from the address format. Use explicit ADDRESS_TYPE when needed for clarity.

Data Types

Data Type	S7 Type	Size	Description
`BOOL`	BOOL	1 bit	Boolean value
`BYTE`	BYTE	8 bits	Unsigned 8-bit
`WORD`	WORD	16 bits	Unsigned 16-bit
`DWORD`	DWORD	32 bits	Unsigned 32-bit
`INT` / `INT16`	INT	16 bits	Signed 16-bit integer
`UINT16`	UINT	16 bits	Unsigned 16-bit integer
`DINT` / `INT32`	DINT	32 bits	Signed 32-bit integer
`UINT32`	UDINT	32 bits	Unsigned 32-bit integer
`REAL` / `FLOAT`	REAL	32 bits	32-bit floating point
`STRING`	STRING	Variable	S7 string type

TAG Configuration

Complete TAG Example

ADD TAG ProcessTemperature
    WITH ADDRESS "DB1.DBD100"
    WITH ADDRESS_TYPE "DATABLOCK"
    WITH DATA_TYPE "REAL"
    WITH SOURCE_TOPIC "plc/process/temperature"
    WITH SCALING "1"
    WITH OFFSET "0"
    WITH UNIT "°C"
    WITH DECIMAL_PLACES "2"
    WITH MIN_VALUE "-50"
    WITH MAX_VALUE "200"
    WITH DEADBAND "0.5"
    WITH PUBLISH_MODE "JSON"
    WITH WRITABLE "true"
    WITH DESTINATION_TOPIC "plc/process/temperature/set"
    WITH BYTE_ORDER "BIGENDIAN"
    WITH DESCRIPTION "Main process temperature"

TAG Parameters

Address Configuration

ADDRESS

string

required

S7 address in standard notation (e.g., DB1.DBW100, M0.0, I0.0, Q0.0).

ADDRESS_TYPE

string

Address type: DATABLOCK, MEMORY, INPUT, OUTPUT, TIMER, COUNTER.

DATA_TYPE

string

required

S7 data type: BOOL, BYTE, WORD, DWORD, INT, DINT, REAL, STRING.

Value Transformation

SCALING

double

Multiplier applied to raw value. Default: 1.0.

OFFSET

double

Value added after scaling. Default: 0.0.

DECIMAL_PLACES

integer

Number of decimal places in output. Default: 2.

Filtering

MIN_VALUE

double

Minimum allowed value.

MAX_VALUE

double

Maximum allowed value.

DEADBAND

double

Minimum change to trigger publish. Default: 0.0.

Publishing

SOURCE_TOPIC

string

MQTT topic for read values.

PUBLISH_MODE

string

Output format: VALUE_ONLY or JSON. Default: VALUE_ONLY.

UNIT

string

Engineering unit (e.g., °C, bar, RPM).

Write Configuration

WRITABLE

boolean

Allow writing to this address. Default: false.

DESTINATION_TOPIC

string

MQTT topic for write commands.

Event-Based Operations

For on-demand operations:

ADD EVENT ReadOnDemand
    WITH SOURCE_TOPIC "s7/commands/read"
    WITH DESTINATION_TOPIC "s7/responses/read"
    WITH QUERY '{"operation": "READ", "address": "DB1.DBW0", "data_type": "WORD", "count": 10}'

Complete Examples

Basic Data Block Reading
Memory and I/O
Bidirectional Control
Multiple Polling Rates

Read values from a data block:

DEFINE ROUTE ProductionPLC WITH TYPE SIEMENS_S7
    ADD S7_CONFIG
        WITH IP "192.168.1.100"
        WITH CPU_TYPE "S71500"
        WITH RACK '0'
        WITH SLOT '1'
    ADD MAPPING ProductionData
        WITH EVERY 500 MILLISECONDS
        ADD TAG Temperature
            WITH ADDRESS "DB1.DBD0"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/temperature"
            WITH UNIT "°C"
        ADD TAG Pressure
            WITH ADDRESS "DB1.DBD4"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/pressure"
            WITH UNIT "bar"
        ADD TAG Speed
            WITH ADDRESS "DB1.DBW8"
            WITH DATA_TYPE "INT"
            WITH SOURCE_TOPIC "plc/speed"
            WITH UNIT "RPM"
        ADD TAG Running
            WITH ADDRESS "DB1.DBX10.0"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/running"

Read markers, inputs, and outputs:

DEFINE ROUTE IOMonitor WITH TYPE SIEMENS_S7
    ADD S7_CONFIG
        WITH IP "192.168.1.100"
        WITH CPU_TYPE "S71200"
        WITH RACK '0'
        WITH SLOT '1'
    ADD MAPPING DigitalIO
        WITH EVERY 100 MILLISECONDS
        ADD TAG StartButton
            WITH ADDRESS "I0.0"
            WITH ADDRESS_TYPE "INPUT"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/io/start"
        ADD TAG StopButton
            WITH ADDRESS "I0.1"
            WITH ADDRESS_TYPE "INPUT"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/io/stop"
        ADD TAG MotorRunning
            WITH ADDRESS "Q0.0"
            WITH ADDRESS_TYPE "OUTPUT"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/io/motor"
        ADD TAG SystemReady
            WITH ADDRESS "M0.0"
            WITH ADDRESS_TYPE "MEMORY"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/status/ready"

Read process values and write setpoints:

DEFINE ROUTE ControlLoop WITH TYPE SIEMENS_S7
    ADD S7_CONFIG
        WITH IP "192.168.1.100"
        WITH CPU_TYPE "S71500"
        WITH RACK '0'
        WITH SLOT '1'
    ADD MAPPING ControlData
        WITH EVERY 200 MILLISECONDS
        ADD TAG ProcessValue
            WITH ADDRESS "DB10.DBD0"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "control/pv"
            WITH UNIT "°C"
            WITH PUBLISH_MODE "JSON"
        ADD TAG Setpoint
            WITH ADDRESS "DB10.DBD4"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "control/sp"
            WITH UNIT "°C"
            WITH WRITABLE "true"
            WITH DESTINATION_TOPIC "control/sp/set"
            WITH MIN_VALUE "0"
            WITH MAX_VALUE "100"
        ADD TAG Output
            WITH ADDRESS "DB10.DBD8"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "control/output"
            WITH UNIT "%"
        ADD TAG ManualMode
            WITH ADDRESS "DB10.DBX12.0"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "control/manual"
            WITH WRITABLE "true"
            WITH DESTINATION_TOPIC "control/manual/set"

Optimize with different update frequencies:

DEFINE ROUTE OptimizedPLC WITH TYPE SIEMENS_S7
    ADD S7_CONFIG
        WITH IP "192.168.1.100"
        WITH CPU_TYPE "S71500"
        WITH RACK '0'
        WITH SLOT '1'
    
    ADD MAPPING FastLoop
        WITH EVERY 100 MILLISECONDS
        ADD TAG CriticalAlarm
            WITH ADDRESS "DB1.DBX0.0"
            WITH DATA_TYPE "BOOL"
            WITH SOURCE_TOPIC "plc/alarms/critical"
        ADD TAG MotorSpeed
            WITH ADDRESS "DB1.DBD10"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/motor/speed"
    
    ADD MAPPING MediumLoop
        WITH EVERY 1 SECOND
        ADD TAG Temperature
            WITH ADDRESS "DB2.DBD0"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/process/temp"
        ADD TAG Pressure
            WITH ADDRESS "DB2.DBD4"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/process/pressure"
    
    ADD MAPPING SlowLoop
        WITH EVERY 10 SECONDS
        ADD TAG ProductionCount
            WITH ADDRESS "DB3.DBD0"
            WITH DATA_TYPE "DINT"
            WITH SOURCE_TOPIC "plc/production/count"
        ADD TAG RuntimeHours
            WITH ADDRESS "DB3.DBD4"
            WITH DATA_TYPE "REAL"
            WITH SOURCE_TOPIC "plc/stats/runtime"

S7-1200/1500 Setup

S7-1200 and S7-1500 PLCs require additional configuration to allow external access.

Enable PUT/GET Access

Open TIA Portal project
Navigate to Device Configuration → Properties
Go to Protection & Security → Connection mechanisms
Enable Permit access with PUT/GET communication from remote partner

Optimized Block Access

For S7-1500, ensure data blocks are set to allow standard access:

Open the Data Block in TIA Portal
In Properties, uncheck Optimized block access
Compile and download to PLC

Troubleshooting

Connection Refused

Verify IP address is correct
Check PLC is in RUN mode
For S7-1200/1500: Enable PUT/GET access
Verify correct RACK and SLOT settings
Check firewall allows TCP port 102

Wrong Slot Error

Use correct slot for your CPU:

S7-1200/1500: Slot 1
S7-300: Slot 2
S7-400: Slot 2 or 3 (check hardware config)

Optimized Block Access Error

For S7-1500: Disable optimized block access in TIA Portal for data blocks you want to access.

Incorrect Values

Verify address matches TIA Portal
Check DATA_TYPE corresponds to PLC variable type
For multi-word types, verify byte offset is correct
Check BYTE_ORDER if values seem swapped

Write Fails

Ensure WRITABLE is set to “true”
Verify PLC is in RUN mode
Check access permissions in PLC
Confirm value is within MIN_VALUE/MAX_VALUE

Next Steps

OPC UA

Cross-platform industrial communication.

ADS (Beckhoff)

Connect to TwinCAT systems.

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

Siemens S7 Overview

Basic Syntax

Supported CPU Types

Connection Configuration

S7_CONFIG Parameters

Connection Examples

S7 Addressing

Address Format

Address Types

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Event-Based Operations

Complete Examples

S7-1200/1500 Setup

Enable PUT/GET Access

Optimized Block Access

Troubleshooting

Next Steps

OPC UA

ADS (Beckhoff)

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

​Siemens S7 Overview

​Basic Syntax

​Supported CPU Types

​Connection Configuration

​S7_CONFIG Parameters

​Connection Examples

​S7 Addressing

​Address Format

​Address Types

​Data Types

​TAG Configuration

​Complete TAG Example

​TAG Parameters

​Event-Based Operations

​Complete Examples

​S7-1200/1500 Setup

​Enable PUT/GET Access

​Optimized Block Access

​Troubleshooting

​Next Steps

OPC UA

ADS (Beckhoff)

Siemens S7 Overview

Basic Syntax

Supported CPU Types

Connection Configuration

S7_CONFIG Parameters

Connection Examples

S7 Addressing

Address Format

Address Types

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Event-Based Operations

Complete Examples

S7-1200/1500 Setup

Enable PUT/GET Access

Optimized Block Access

Troubleshooting

Next Steps