UMAS (Schneider Electric PLCs)

This protocol is used by Schneider Electric PLCs such as the M340, M580 and the Quantum PLCs with the Unity firmware.

This driver supports reading, writing and browsing of PLC tags.

The Data Dictionary needs to be enabled on the PLC.

The driver is available in Java and in Plc4Py. The tag address syntax differs slightly between the two; where that is the case it is called out below.

Connection String Options

Array selection uses the shared notation - a single index, an inclusive range, and optionally the array’s declared lower bound, placed before the type. See Addressing arrays.

Name

Type

Default Value

Required

Description

Name

UMAS (Schneider Electric)

Code

umas

Maven Dependency

 
<dependency>
  <groupId>org.apache.plc4x</groupId>
  <artifactId>plc4j-driver-umas</artifactId>
  <version>1.0.0</version>
</dependency>

Default Transport

tcp

Supported Transports

  • tcp

Config options:

unit-identifier

INT

0

Modbus unit identifier (slave address). UMAS typically uses 0.

request-timeout-ms

INT

4000

Timeout in milliseconds for UMAS requests.

max-frame-size

INT

65535

Maximum UMAS frame size. The PLC reports its actual limit during InitComms.

browser-generate-array-nodes

BOOLEAN

true

Tells the browser to generate artificial child nodes representing individual array elements.

Transport config options:

tcp

tcp.connect-timeout-ms

INT

5000

tcp.read-timeout-ms

INT

0

tcp.write-timeout-ms

INT

0

tcp.no-delay

BOOLEAN

true

tcp.keep-alive

BOOLEAN

false

tcp.send-buffer-size

INT

81920

tcp.receive-buffer-size

INT

81920

tcp.local-address

STRING

tcp.local-port

INT

0

Supported Operations

Name Value Description

Supported Operations

read

write

browse

ping

Individual Resource Address Format

Connection String

UMAS has the following connection string format:-

umas:{transport}://{ip-address}:{port}?{options}

An example connection string would look like:-

umas:tcp://127.0.0.1:502

Note the transport, port and option fields are optional.

General Format

UMAS addresses are the symbolic names declared in the PLC program, following the usual IEC 61131-3 conventions:

{tag-name}
{tag-name}[{index}]
{tag-name}.{child-name}
{tag-name}.{child-name}[{index}].{child-name}

Depending on the type of tag the child-name parameters are optional. e.g. A tag with a BOOL data type could be TESTING_BOOL_1, whereas if it is a UDT the tag name is followed by the child TESTING_UDT_1.START, which in itself could be a BOOL. An index in square brackets selects a single element and may appear at any position of the path.

Table 1. Examples
Address Meaning

g_r32

a simple global variable

g_plant.meta.r32

a nested struct member

g_arrInt[3]

the fourth element of an array

g_plant.items[2].value

mixed struct and array access
The Java driver takes the data type from the PLC’s data dictionary, so an address carries no :{data-type} suffix - appending one makes the address invalid.

Memory Areas

Apart from tags defined in the PLC, Plc4Py is also able to access the %S and %SW system memory areas.

The specific address details of the data in these areas are outlined in the devices manual.

An example of the address format of these areas is %SW1 or %S20.

These system memory addresses are supported by Plc4Py only. The Java driver’s address parser accepts symbolic names only and rejects addresses starting with %.

Data Types

The following data types are supported

  • BOOL (boolean)

  • SINT (int 8)

  • USINT (uint 8)

  • BYTE (uint 8)

  • INT (int 16)

  • UINT (uint 16)

  • WORD (uint 16)

  • DINT (int 32)

  • UDINT (uint 32)

  • DWORD (uint 32)

  • REAL (float)

  • STRING (char)

  • TIME

  • DATE

  • TOD (Time of Day)

  • DATE_AND_TIME