Io-link master with as-interface interface (94 pages)
Summary of Contents for IFM AL1352
Page 1
> > Operating Instructions IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 AL1352 HW Revision: AA Firmware: 2.3.x LR DEVICE: 1.5.0.x English...
Page 2
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Contents Preliminary note Legal and copyright information ................... 5 Purpose of the document ..................... 5 Explanation of Symbols ....................... 5 Modification history ......................6 Safety instructions General ..........................
Page 3
Read / write cyclic process data ....................45 9.2.9 Control IO-Link master ....................... 46 9.2.10 Read diagnostic data of the AL1352 ..................48 9.2.11 Read device information of the IO-Link master ................49 9.2.12 Read information about IO-Link devices ..................49 9.2.13...
Page 4
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 13.2 ifm IoT Core ........................67 13.2.1 Overview: IoT profile ........................68 13.2.2 Overview: IoT types ........................73 13.2.3 Overview: IoT services ....................... 74 Index...
Page 6
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 CAUTION! Slight reversible injuries may result. NOTICE! Property damage is to be expected or may result. Important note Non-compliance can result in malfunction or interference Information Supplementary note ►...
Page 7
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Safety instructions Content General ..............................7 Required background knowledge ......................7 Safety symbols on the device ........................7 IT safety ..............................8 Tampering with the unit ..........................8 28333 >...
Page 8
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 IT safety 54678 NOTICE! If the device is operated in an unprotected network environment. > Unauthorised read or write access to data is possible. >...
Page 9
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Intended use Content Permitted use ............................9 Prohibited use ............................9 34079 > Permitted use 34209 The IO-Link master serves as a gateway between intelligent IO-Link devices and the IoT core network. The device is designed for use without a control cabinet in the plant construction.
Page 10
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Function Content Communication, parameter setting, evaluation ..................11 Digital inputs ............................12 IO-Link supply ............................12 33836...
Page 11
34210 The device provides the following configuration options: Parameter setting of the IO-Link master of the AL1352 with LR DEVICE parameter setting software, IoT core projection software or ifm IoT-Core services. Parameter setting of the connected IO-Link devices (sensors, actuators) with LR DEVICE parameter setting software, IoT core projection software or ifm IoT-Core services ...
Page 12
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 4.1.5 Visual indication 34192 The device has the following visual indicators: Status and error indication of the gateway, of the IoT core connection and of the system ...
Page 13
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Mounting Content Mount the device ............................13 34058 > Mount the device 34059 ► Disconnect the system from power before installation. ► For installation choose a flat mounting surface. ►...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Electrical connection Content Notes ..............................14 IoT ports..............................15 IO-Link ports ............................16 Connect the device ..........................18 33805 > Notes 51957 A qualified electrician must connect the unit. ►...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 IoT ports 52272 ► Connect the unit via the M12 socket X21 and/or X22 with the IoT core network (e.g. laptop/PC with LR DEVICE parameter setting software, laptop/PC with LR SMARTOBSERVER monitoring software, PC/laptop with http request compatible software) ...
> IO-Link ports 51958 The IO-Link ports of the AL1352 meet the requirements of the IO-Link specifications 1.0 to 1.1.2. ► Please note the information concerning IO-Link wiring! ► Cover unused sockets with M12 protective caps (art. no.: E73004). ...
Page 17
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 6.3.2 Connect IO-Link devices for Class B operation 51960 Notes on wiring: For Class B operation, the IO-Link device must be supplied with an additional auxiliary voltage UA using a Y connection cable.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Connect the device 33882 ► Disconnect power. ► Connect the IO-Link Master via M12 socket X31 to 24 V DC (20...30 V SELV/PELV; according to EN61010-1, secondary circuit with maximum 30 V DC supplied by mains circuit up to 300 V of overvoltage category II).
Page 19
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Operating and display elements Content Overview ..............................19 LED indicators ............................20 34063 > Overview 52274 Status LEDs RDY and IoT → Status LEDs (→ S. 20) L/A and 10/100 MBits/s status LEDs of the IoT interface (X21/X22) →...
Page 20
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > LED indicators 34047 The device only has the following LED indicators: > 7.2.1 Status LEDs 52237 The RDY LED indicates the status of the gateway. The IoT LED indicates the status of the connection to the LR SMARTOBSERVER.
Page 21
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 7.2.3 IO-Link ports (Class A) 34074 Each IO-Link port Class A has 2 LEDs marked as IOL and DI. The LEDs indicate the status of the IO-Link port.
Page 22
Operating and display elements (→ S. 19)). To enable parameter setting of the AL1352 via the IoT core network, the IoT interface must be configured according to the network environment. ► Connect AL1352 via the ports X21/X22 to the IoT core network.
Page 23
► Connect laptop/PC and AL1352 via the Ethernet interface. ► Start web browser. ► Enter the IP address of the AL1352 into the address field of the browser and confirm with [ENTER]. > Web browser shows the web interface of the device.
Page 24
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Configuration Content LR DEVICE .............................25 ifm IoT Core ............................35 33858...
Firmware: Reset device to factory settings ....................33 Firmware: Reboot the device........................33 Configure IO-Link devices ........................34 33692 On delivery, the AL1352 is configured with the factory settings (→ Factory settings (→ S. 60)). Required software: LR DEVICE (1.5.0.x or higher) (art.-no.: QA0011/QA0012)
IO-Link master and the connected IO-Link devices without being connected to the AL1352 (OFFLINE mode). The configuration created in this way can be stored as a file (*.lrp) and loaded to the AL1352 and activated at a later date.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.1.2 IoT: Configure IP settings 34049 For access to the IO-Link master via the IT infrastructure the user has to set the IP settings of the IoT port.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.1.3 IoT: Configure security mode 54680 The IoT interface of the IO-Link offers a security mode. It enables secure data transmission via transport encryption and restriction of the access to IO-Link masters and IO-Link devices via user authentication.
2147483647 2147483647 ms [Application Tag] Source identifier of the IO-Link master in the Factory setting: AL1352 structure of LR AGENT or LR SMARTOBSERVER (String32) After changing the parameter [Port LR Agent or SMARTOBSERVER] or [Application Tag], it may take 120 seconds before the device establishes a new TCP connection.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 9.1.6 IO-Link ports: Configure operating mode 33694 The IO-Link ports X01...X08 of the device support the following operating modes: Digital input (DI): binary input signal at pin 4 (C/Q) of the IO-Link port ...
Restore] [Vendor ID] ID of the manufacturer that is to be validated 0...65535 Factory setting: 0# ifm electronic: 310 [Device ID] ID of the IO-Link device that is to be validated 0...16777215 Factory setting: 0 ► Save changed values on the device.
* ... parameter can only be changed if the IoT core controller is disconnected ► Save changed values on the device. > 9.1.9 Info: Show device information 34065 To read the general information of the ifm IO-Link master: ► Select [Info] menu. > The menu page shows the current settings. Name Description...
When rebooting the device, all settings are kept. To restart the AL1352: ► Select [Firmware] menu. > The menu page shows the current settings. ► Click on [Reboot] to reboot the device. > LR DEVICE reboots the ifm IO-Link master.
► Under [ONLINE]: Click on the required IO-Link master. > LR DEVICE automatically detects the IO-Link devices connected to the IO-Link master (e.g. ifm sensor KG5065). Configure IO-Link device ► Mouse click on the port to which the IO-Link device is connected.
9.2.1 First steps 52245 To read the device description of the AL1352: ► Send the following POST request to the AL1352: {"code":"request","cid":-1,"adr":"gettree"} > AL1352 returns the device description as structured JSON object. ► Identify all substructures and the data points contained therein in the tree structure of the JSON object.
Read the value of the element ../setdata Write the value of the element > 9.2.3 Configure the IoT interface 52247 The AL1352 is integrated into the IT network via the IoT interface. Substructure: iotsetup Available data points: Name Description Access ../smobip IP address of the LR SMARTOBSERVER ../smobport...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.2.4 IoT interface: Configure security mode 54683 The access to the IoT interface of the IO-Link master can be protected with a security mode: Sub-structure: iotsetup Available data points: Name...
Page 38
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: Activate security mode 54701 Task: Activate the security mode of the IO-Link interface of the IO-Link master. Set the password "password" (Base64 coded: cGFzc3dvcmQ=) Solution: The activation sonsists of 2 steps: Activate security mode Use service setdata with datapoint iotsetup/security/securitymode to activate the security mode.
Page 39
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: Request with authentication 54685 Task: The temperature of the IO-Link master is to be read. The security function is enabled (current password: password). Solution: Read the data point processdatamaster/temperature with the getdata service.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.2.5 Configure IO-Link ports 52248 The user can configure the IO-Link ports X01...X08 separately. Substructure: iolinkmaster/port[n] (n = 1...8). Available data points: Name Description Access ../senddatatosmob...
Page 41
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: Clone the Data Storage of an IO-Link port 52344 Task: Save the Data Storage of IO-Link port X02 of IO-Link master 1 and restore the data at IO-Link master 2.
9.2.6 Configure IO-Link devices 52249 The ifm IoT Core supports the configuration of the connected IO-Link devices. A parameter is accessed via IO-Link index and subindex (→ IO Device Description (IODD) of the device). Substructure: iolinkmaster/port[n]/iolinkdevice (n = 1...8) Applicable services:...
Page 43
Example: Change the parameter value of an IO-Link device 33844 Task: Set the output configuration OUT1 of the ifm temperature sensor TN2531 at IO-Link port X02 to the value "Hnc / hysteresis function, normally closed". Solution: Change the parameter [ou1] of the sensor to the value 4 using the iolwriteacyclicdata service.
> Example: Change name of the IO-Link master a33823 Task: Set the name of the IO-Link master to AL1352 for the representation in the LR SMARTOBSERVER. Solution: Change the parameter [Application Tag] with the setdata service to the value [AL1352].
Example: Read process data of an IO-Link device 33842 Task: Read the current measured value of the ifm temperature sensor TN2531 at IO-Link port X02 Solution: Read the data point for the process input data with the getdata service. ...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.2.9 Control IO-Link master 52251 Different services and management functions can be carried out on the IO-Link master. Substructure: firmware Available data points: Name Description Access...
Page 47
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: Update firmware 52252 Task: Update the firmware of the device; size of the firmware file: 356676 bytes Solution: The firmware is transferred to the device in fragments (chunks). The size of the fragments depends on the size of the flash memory of the IO-Link master.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.2.10 Read diagnostic data of the AL1352 52253 The user can read diagnostic data of the status of the IO-Link masters. Substructure: processdatamaster...
../bootloaderrevision Bootloader version ../extensionrevisions Firmware and bootloader version ../fieldbustype Fieldbus r ... read only Additional information about the AL1352 can be read with the getidentity service (→ Service: getidentity (→ S. 77)). > 9.2.12 Read information about IO-Link devices 52339 The user can obtain information about the IO-Link devices connected to the IO-Link ports.
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 9.2.13 Subscribe to events 52255 If a data point has the subelement datachanged, the user can subscribe to events. Available data points: Name Description Access timer[n]/counter...
Page 51
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: Subscribe to event 33853 Task: The current values of the following parameters should be sent regularly to a network server with IP address 192.168.0.4: product name of the IO-Link device at IO-Link port X02, cyclic input data of the IO-Link device at IO-Link port X02 and the operating temperature of the IO-Link master.
9.2.14 MQTT support 54699 The AL1352 can operate as a client in a MQTT-based communication environment. By using the subscribe service it is possible to send messages to a MQTT broker (PUBLISH). > Example: Publish the temperature to an MQTT broker...
IoT Core: General information 52256 The DataLine device family has an IoT Core. The IoT Core allows the user to address the AL1352 from IT networks via a REST API and to integrate it into Internet-of-Things applications. A device description is stored on the AL1352. This device description is a structured, machine-readable data object in JSON format.
Page 54
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Access the ifm IoT Core 52257 The user can access the ifm IoT Core via HTTP requests. The following request methods are available. > GET request 33804 Using the GET method the user has read access to a data point.
Page 55
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > POST request 54700 Using a POST request the user has read and write access to a data point. The syntax of the request to the IoT Core is: "code":"code_id", "cid":id, "adr":"data_point/service",...
Page 56
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Example: POST request 54035 Request: "code":"request", "cid":4711, "adr":"devicetag/applicationtag/getdata" Response: "cid":4711, "data":{"value":"AL1352"}, "code":200 > IoT Core: Diagnostic codes 54688 Code Text Description Request successfully processed OK but needs reboot Request successfully processed;...
Page 57
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Maintenance, repair and disposal Content Cleaning process ............................57 Update firmware .............................58 Replace IO-Link device ..........................59 51990 The operation of the unit is maintenance-free. ► Dispose of the unit in an environmentally friendly way in accordance with the applicable national regulations when it is no longer used.
Page 58
► Enter the following into the address field of the browser and confirm with [ENTER]: http://<IP address of the device>/web/update > Web browser shows the [Firmware Update] page. Load new firmware to AL1352 ► Click on [Select file]. > Dialogue window appears.
Page 59
► Save changes. Replace IO-Link device ► Disconnect old IO-Link device from IO-Link master. ► Connect new IO-Link device with the same IO-Link port of the AL1352. > IO-Link master copies parameter values from the data memory to the new IO-Link device.
Page 60
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Factory settings 33849 In the factory settings, the device has the following parameter settings: Parameter Factory setting [IP address] (IoT interface) 169.254.X.X [Subnet mask] (IoT interface) 255.255.0.0 [IP gateway address] (IoT interface) 0.0.0.0...
Page 61
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Accessories 33870 List of accessories of AL1352: → www.ifm.com > Product page > Accessories...
Page 62
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Appendix Content Technical data ............................63 ifm IoT Core ............................67 33879...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 13.1.4 Inputs 34069 Inputs Number of digital inputs 16; (IO-Link Port Class A: 8 x 2) Switching level high [V] 11...30 Switching level low [V] 0...5 Digital inputs protected against short circuits >...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 13.1.10 Electrical connection 52261 Voltage supply IN X31 Plug and socket connection Wiring + 24 V DC (US) GND (US) IoT port X21, X22 Plug and socket connection Wiring TX +...
Page 67
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 13.2 ifm IoT Core Content Overview: IoT profile ..........................68 Overview: IoT types ..........................73 Overview: IoT services ...........................74 33803...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Profile: deviceinfo 34207 Element (identifier) Properties mandatory Comments deviceinfo type = structure characterises the element as device information profile = deviceinfo ../devicename type = data optional...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Profile: iolinkdevice_full 52265 Element (identifier) Characteristics Mandatory Comments iolinkdevice type = structure Structure of an IO-Link device profile = iolinkdevice_full ../vendorid type = data mandatory ../deviceid type = data...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Profile: network 52266 Element (identifier) Characteristics Mandatory Comments network type = structure Characterises the element as device information profiles = deviceinfo ...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 Profile: software 34223 Element (identifier) Properties mandatory Comments software type = structure characterises the element as software profile = software ../version type = data mandatory ../type type = data...
Page 73
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > 13.2.2 Overview: IoT types 34055 The ifm IoT Core uses the following element types: Name Description structure Element is a structure element (like a folder in a file system)
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: gettree 34175 Name: gettree Description: The service reads the complete device description of the AL1352 and provides it as JSON object. Request data (field "data"): none Response data (field "data"): Data field...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: getdatamulti 34174 Name: getdatamulti Description: The service sequentially reads the values of several data points and provides them. The value and the diagnostic code are provided for each data point. Request data (field "data"): Data field Required field...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: getidentity 54690 Name: getidentity Description: The service reads the device information of the AL1352 and issues it. Request data ("data" field): none Return data ("data" field): Data field Required...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: getsubscriptioninfo 34172 Name: getsubscriptioninfo Description: The service provides information about an existing subscription (subscribe). Request data (field "data"): Data field Required field Data type Description callback...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: iolreadacyclic 34178 Name: iolreadacyclic Description: The service acyclically reads the parameter value of an IO-Link device. The parameter is accessed via IO-Link index and subindex. Request data (field "data"): Data field Required field...
Description: The service sets the value of the data point. Request data (field "data"): Data field Required field Data type Description newvalue mandatory STRING New value of the element/data point Response data (field "data"): none Example: "code":"request", "cid":4711, "adr":"devicetag/applicationtag/setdata", "data":{"newvalue":"ifm IO-Link master"}...
JSON array hash optional STRING > Service: signal 33819 Name: signal Description: The service starts the flashing of the status LEDs of the AL1352. Request data (field "data"): none Return data (field "data"): none Example: "code":"request", "cid":4711, "adr":"firmware/signal"...
IO-Link Master with IoT Interface DataLine 8 Ports IP 65 / IP 66 / IP 67 > Service: subscribe 34194 Name: subscribe Description: The service subscribes to the values of data points. The data points to be subscribed are transferred as a list. The IO-Link master sends changes to the data drain defined in callback. Request data (field "data"): Data field Required field...
Page 83
Index Inputs ..................... 64 Inputs / outputs ..................63 Intended use .................... 9 Interfaces ....................64 Access the ifm IoT Core ................ 54 Internet of Things (IoT) ................11 Accessories ................... 61 IO-Link ....................11 Appendix ....................62 IO-Link ports ..................16 Application .....................
Page 84
Read / write cyclic process data ............45 Read device and diagnostic information ..........23 Read device information of the IO-Link master ........49 Read diagnostic data of the AL1352 ............. 48 Read information about IO-Link devices ..........49 Remarks....................26 Replace IO-Link device .................