Anybus® CompactCom™ 40 - EtherNet/IP IIoT Secure

Dataset Encoding

The Anybus CompactCom encodes the different datasets using JSON, see examples below.

Note

Vendor specific datasets are sent transparently, and not encoded.

Data Type Translation

Anybus data types are translated to JSON data types according to the table below.

Anybus Data Type

JSON Data Type

BOOL

Boolean

SINT8/16/32/64

Number

UINT8/16/32/64

Number

FLOAT

Number

CHAR

String

OCTET

String A hexadecimal string representation of the octet value. E.g: 0xFF is translated to “FF”.

ENUM

Object , see below

BOOL1

Boolean

BITSx / BITx

JSON Array of Number where each bit is encoded to a Number of either 0 or 1. The array starts with the most significant bit.

PADx

Data type is ignored and will not be published.

The ENUM data type is encoded as a JSON object:

{
   "EnumValue" : <ADI value encoded as a Number>,
   "EnumStr" : <Enum string of the ADI value encoded as a String>
}

ADI variables of data type PADx will be ignored and not published.

ADI variables with more than one subelement, are encoded if the data type of the ADI is CHAR or OCTET. These are encoded and published as a single string. ADI variables with subelements of other types will be ignored and not published.

An ADI with an array of the data type CHAR will be published as a single string, while other arrays will be published as arrays.

Anybus Data Type

JSON Encoding with Example Values

UINT16

10

Array of UINT16

[0, 1, 2, 3, 4]

BOOL

True

OCTET string

"EDDAEBFE"

Array of OCTET

[“ED”, “DA”, “EB”, “FE”]

ENUM

{
"EnumValue" : 2,
"EnumStr" : "Two",
}

BIT2

[1,0]

Array of BIT2

[[1,0], [1,1], [0,0]]

JSON Encoding of Single ADI Datasets

Single ADI Datasets are encoded as follows:

{
  "<ADI name>" : {
                      "Value" : <ADI value>
                   },
  "Timestamp" : <Timestamp of the dataset>
}

Example of JSON encoding of a single ADI:

{
  "Single ADI" : {
                      "Value" : true
                   },
  "Timestamp" : 1526643062
}

Example of JSON encoding of a variable ADI:

{
  "Variable ADI" : {
                      "Value" : "String value"
                   },
  "Timestamp" : 1526643062
}

Example of JSON encoding of an array ADI with 3 elements:

{
  "Array ADI" : {
                   "Value" : [ 1, 2, 3 ]
                },
  "Timestamp" : 1526643062
}
JSON Encoding of Assembly Mapping Datasets

Assembly Mapping Datasets are encode as follows:

{
  "<Assembly mapping instance name>" : {
                          "<ADI #1 name>" : { "Value" : <ADI value> },
                          ...
                          <ADI #N name>" : { "Value" : <ADI value> },
                       },
  "Timestamp" : <Timestamp of the dataset>
}

Example of JSON encoding of an Assembly Mapping instance:

{
  "Example Assembly" : {
                          "Variable ADI": { "Value" : "String value" },
                          "Array ADI" : { "Value" : [ 1, 2, 3 ] },
                       },
  "Timestamp" : 1526643062
}
In this section: