Configure the Siemens LOGO! Connector
Configure Siemens LOGO! instances and items, select the correct TSAP and memory area, read and write values, and troubleshoot communication.
Use the Siemens LOGO! Connector to read and write values in a Siemens LOGO! 0BA7 or 0BA8 controller over Ethernet.
This guide explains how to prepare the controller connection, configure an instance, create items for LOGO! memory areas, and troubleshoot communication.
The Connector communicates with the controller using ISO-on-TCP on TCP port 102. Make sure that this traffic is permitted between SIA Connect and the controller.
Prerequisites
Before you begin, make sure that:
- The Siemens LOGO! Connector is installed.
- SIA Connect can reach the LOGO! controller by IP address or hostname.
- The LOGO! project contains an Ethernet connection that permits communication with the external partner.
- You know the local and remote TSAP values configured for the connection.
- You know whether the controller is a 0BA7 or 0BA8 model.
- You know the memory addresses and data types that you want to read or write.
Understand the TSAP settings
The TSAP values identify the two endpoints of the configured connection. Enter the values from the Ethernet connection in the LOGO! project.
| Connector setting | Value to enter |
|---|---|
| Local TSAP | The partner TSAP assigned to SIA Connect in the LOGO! project. |
| Remote TSAP | The local TSAP assigned to the LOGO! controller. |
For example, if the controller uses local TSAP 20.00 and its configured partner uses TSAP 30.00, enter 30.00 as Local TSAP and 20.00 as Remote TSAP.
Use the numeric TSAP format shown in the LOGO! project, such as 20.00 or 30.00.
Create a Siemens LOGO! instance
- In the Edge Portal, go to Instances.
- Select Create instance.
- Select the Siemens LOGO! Connector.
- Enter a name for the instance.
- Enter the IP address or hostname of the LOGO! controller in Address.
- Enter the TSAP assigned to SIA Connect in Local TSAP.
- Enter the controller TSAP in Remote TSAP.
- Select the controller generation in Device type.
- Select Create.
Instance parameters
| Parameter | Description |
|---|---|
| Address | IP address or resolvable hostname of the LOGO! controller. |
| Local TSAP | Partner TSAP configured for SIA Connect. |
| Remote TSAP | Local TSAP configured for the LOGO! controller. |
| Device type | Select 0BA7 or 0BA8. The default is 0BA8. |
When the instance is created, the Connector also creates read-only identity items for Vendor, Model, Serial, Firmware, and Product code. Values are shown when the controller provides the corresponding information.
Create an item
The Siemens LOGO! Connector does not discover process items. Create each item manually.
- Open the Siemens LOGO! instance.
- Open the Items tab.
- Select Create item.
- Enter a unique item name.
- Select the required Memory area.
- Enter the Offset.
- Select the Type when using V memory.
- Configure the remaining item settings as required.
- Select Create.
Item parameters
| Parameter | Description |
|---|---|
| Memory area | LOGO! memory area that contains the value. |
| Offset | Address within the selected memory area. The expected format depends on the memory area and data type. |
| Type | Data type used for V memory. Digital and analog I/O areas use a fixed type. |
Memory areas
| Memory area | Purpose | Valid offset | Data type | Device support |
|---|---|---|---|---|
| V | Variable memory | Byte address, with an optional bit number for BOOL values | Selected in Type | 0BA7 and 0BA8 |
| I | Digital inputs |
1 to 24
|
BOOL | 0BA7 and 0BA8 |
| AI | Analog inputs |
1 to 8
|
REAL | 0BA7 and 0BA8 |
| Q | Digital outputs |
1 to 24
|
BOOL | 0BA7 and 0BA8 |
| AQ | Analog outputs |
1 to 8
|
REAL | 0BA7 and 0BA8 |
| NI | Network digital inputs |
1 to 128
|
BOOL | 0BA8 |
| NAI | Network analog inputs |
1 to 32
|
REAL | 0BA8 |
| NQ | Network digital outputs |
1 to 128
|
BOOL | 0BA8 |
| NAQ | Network analog outputs |
1 to 16
|
REAL | 0BA8 |
Use offsets starting at 1 for I, AI, Q, AQ, NI, NAI, NQ, and NAQ. These offsets identify the numbered LOGO! input or output. V-memory offsets are direct byte addresses and can start at 0.
The current Connector maps network memory areas only for 0BA8 controllers.
Address V memory
For V memory, enter the byte address shown in the LOGO! project. Do not convert the address to a one-based item number.
| LOGO! address | Memory area | Offset | Type |
|---|---|---|---|
V100 |
V | 100 |
BYTE, WORD, INT, DWORD, DINT, REAL, or STRING as applicable |
V100.3 |
V | 100.3 |
BOOL |
Supported data types
| Type | Value | Size |
|---|---|---|
| BOOL |
true or false
|
1 bit |
| BYTE | Unsigned integer from 0 to 255 | 1 byte |
| WORD | Unsigned integer from 0 to 65,535 | 2 bytes |
| INT | Signed integer from -32,768 to 32,767 | 2 bytes |
| DWORD | Unsigned integer from 0 to 4,294,967,295 | 4 bytes |
| DINT | Signed integer from -2,147,483,648 to 2,147,483,647 | 4 bytes |
| REAL | 32-bit floating-point value | 4 bytes |
| STRING | Siemens S7 string with a 2-byte header | Configured by the offset range |
| TIME | Displayed as a selectable type, but not currently converted for reading or writing | Not supported |
Do not use TIME items with the current Connector. Although the type is displayed in the item form, the Connector does not currently implement its value conversion.
Configure strings and arrays
Strings
A Siemens STRING uses two header bytes before its character data. Specify the complete byte range in the Offset field.
-
20-12starts at byte 20 and reads 12 bytes in total. This allows 10 character bytes after the two header bytes. -
20-31reads bytes 20 through 31 inclusive. This is also a total of 12 bytes.
Numeric arrays
Add an ending byte offset after a hyphen to read an array. For example, a REAL array that starts at V100 and ends at V111 uses offset 100-111 and contains three 4-byte values.
String arrays
Use parentheses to define the size of each string element. For example, 0(27)-54 reads three strings that each occupy 27 bytes, starting at byte offsets 0, 27, and 54.
Array values are returned and written as compact JSON arrays, such as [10,20,30].
Verify the connection
- Open the instance and confirm that it is running without a connection error.
- Open the Items tab.
- Confirm that the required items receive current values.
- If writing is required, write a safe test value to an item that is intended to be writable.
- Confirm the result in the LOGO! project or connected equipment.
Only write to addresses that are safe to change. A write to an output or control variable can affect connected equipment.
Troubleshoot the Siemens LOGO! Connector
The instance reports Unreachable peer or Connection timed out
- Confirm that the controller is powered and connected to the network.
- Confirm that the instance uses the correct IP address or hostname.
- Use the Ping tool to test network communication from SIA Connect.
- Confirm that TCP port
102is permitted by switches, routers, and firewalls.
The instance reports an ISO connection error
- Confirm that the Ethernet connection is configured in the LOGO! project.
- Confirm that Local TSAP contains the TSAP assigned to SIA Connect.
- Confirm that Remote TSAP contains the controller's local TSAP.
- Confirm that the configured partner connection is permitted by the controller.
The instance connects but item values are incorrect
- Confirm that Device type matches the controller generation.
- Confirm that the correct memory area is selected.
- For V memory, use the direct byte address. For example, V100 uses offset
100. - For digital or analog I/O, use the one-based input or output number.
- Confirm that the selected V-memory data type matches the value in the LOGO! project.
The item reports Invalid offset in address
Check the offset syntax. Remove unsupported characters and confirm that ranges, bit numbers, and string lengths are complete.
The item reports Address out of range or Item not available
- Confirm that the address exists on the selected controller model.
- Confirm that the offset is within the supported range for the selected memory area.
- Use network memory areas only with a 0BA8 controller.
- Confirm that the complete multi-byte value fits in the available memory range.
A string reports Could not determine length of string
Enter a valid STRING range that includes the two header bytes and the character data, such as 20-12.
An array write reports Invalid format
Write the value as a valid JSON array with the correct number of elements, such as [10,20,30]. Make sure every value is valid for the configured data type.
A TIME item does not return a usable value
The current Connector exposes TIME in the item form but does not implement its read or write conversion. Use another supported representation in the LOGO! project when possible.
Identity items are empty
The controller may not have returned the corresponding CPU information. Confirm that the instance is connected. Empty identity values do not by themselves indicate that process-item communication has failed.