IO-Link master with EtherNet/IP interface AL1325
3
9.1.16 Update firmware.................................................... 28
9.1.17 Firmware: Resetting the device......................................... 29
9.1.18 Firmware: Restarting the device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
9.1.19 Setting the parameters of IO-Link devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
9.2 ifm IoT Core REST API................................................... 31
9.2.1 ifm IoT Core: General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
9.2.1.1 Accessing the ifm IoT Core....................................... 31
9.2.2 Getting started ..................................................... 33
9.2.3 General functions................................................... 34
9.2.3.1 Example: Reading properties of an element . . . . . . . . . . . . . . . . . . . . . . . . . . 34
9.2.3.2 Example: Outputting the subtree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.2.3.3 Example: Changing a parameter value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.2.3.4 Example: Read multiple elements sequentially . . . . . . . . . . . . . . . . . . . . . . . . 39
9.2.3.5 Example: Browsing device description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
9.2.3.6 DNS support.................................................. 40
9.2.4 IoT: Configuring access rights.......................................... 41
9.2.5 IoT: Configuring IP settings............................................ 41
9.2.6 IoT: Configuring security mode......................................... 42
9.2.6.1 Example: Activating security mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
9.2.6.2 Example: Request with authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
9.2.6.3 Example: Resetting the password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9.2.7 IoT: Configuring the interface to the monitoring software . . . . . . . . . . . . . . . . . . . . . 44
9.2.8 Fieldbus: Configuring the EtherNet/IP interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
9.2.9 Fieldbus: Setting the EtherNet/IP configuration mode . . . . . . . . . . . . . . . . . . . . . . . . 45
9.2.10 Fieldbus: Setting fail-safe values of the outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.2.11 Ports: Setting the operating mode Pin 4 (US) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.2.12 Ports: Configuring device validation and data storage. . . . . . . . . . . . . . . . . . . . . . . . 47
9.2.12.1 Example: Cloning the data memory of an IO-Link port . . . . . . . . . . . . . . . . . . 48
9.2.13 Ports: Setting data transmission to the monitoring software . . . . . . . . . . . . . . . . . . . 50
9.2.14 Ports: Reading / writing process data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
9.2.14.1 Example: Reading an IO-Link process value (operating mode "IO-Link") . . . . 50
9.2.14.2 Example: Reading an IO-Link process value (operating mode "IO-Link") . . . . 51
9.2.14.3 Example: Reading the digital input value (operating mode "DI") . . . . . . . . . . . 51
9.2.14.4 Example: Writing the digital output value (operating mode "DO") . . . . . . . . . . 52
9.2.15 Ports: Reading port events............................................ 52
9.2.16 Timer: Configuring the timers .......................................... 53
9.2.16.1 Set the counting interval......................................... 53
9.2.17 IO-Link devices: Accessing parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
9.2.17.1 Example: Reading a parameter value of an IO-Link device. . . . . . . . . . . . . . . 54
9.2.17.2 Example: Writing a parameter value of an IO-Link device . . . . . . . . . . . . . . . . 55
9.2.18 IO-Link devices: Reading and writing device information . . . . . . . . . . . . . . . . . . . . . 55
9.2.19 IO-Link devices: Reading IO-Link events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
9.2.20 Gateway: Set the application tag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
9.2.21 Gateway: Update firmware............................................ 57
9.2.22 Gateway: Reading status and diagnostic information . . . . . . . . . . . . . . . . . . . . . . . . 57
9.2.23 Gateway: Reading device information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
9.2.24 Gateway: Resetting, rebooting and localising the device. . . . . . . . . . . . . . . . . . . . . . 58
9.2.25 Notifications ....................................................... 58
9.2.25.1 Event-controlled notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
9.2.25.2 Time-controlled notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
9.2.25.3 Use MQTT ................................................... 59
9.2.25.4 Example: Subscribing to notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
9.2.25.5 Example: Changing a notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
9.2.25.6 Example: Subscribing to a notification in CSV format . . . . . . . . . . . . . . . . . . . 65
9.2.25.7 Example: Unsubscribing from a notification. . . . . . . . . . . . . . . . . . . . . . . . . . . 66
9.2.25.8 Example: checking a notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
9.3 IoT Core Visualizer...................................................... 68
9.3.1 Starting the ifm IoT Core Visualizer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
9.3.2 Managing notifications ............................................... 69
9.3.2.1 Creating a new notification....................................... 69
9.3.2.2 Deleting a notification........................................... 69
9.3.3 Searching for elements in the device description . . . . . . . . . . . . . . . . . . . . . . . . . . . 71