10 IIoT functionality
10.3 REST API
10.3.4 Reading and writing ISDU parameters
The
Indexed Service Data Unit
(ISDU) provides a highly flexible message
format, which can contain single or multiple commands.
LioN-X IOL-Masters with IIoT support reading and writing ISDU parameters
from connected IOL-Devices. It is possible to do this as a bulk transfer by
reading and writing of multiple ISDU parameters via a single request.
10.3.4.1 Reading ISDU
Method:
POST
URL:
<ip>/r/isdu.json
Parameters:
port (0-7)
Example:
192.168.1.20/r/isdu.json?port=5
Post-Body:
JSON array of read ISDU object
Property
Data type
Example values
Remarks
ix
integer
0-INT16
Index to be read
subix
integer
0-INT8
Subindex to be read
Table 30: Read ISDU object
Property
Data type
Example values
Remarks
status
integer
0, -1
0 = no error, -1= an
error occured
message
string
Error Message if
error occured
data
data, if no error
occured. otherweise
null
Table 31: Read ISDU response object
Manual EtherCAT®
Version 1.1 04/2021
121