Programming Manual IO-Link Master With AS-Interface Interface . - Ifm

Programming Manual IO-Link Master with AS-Interface Interface StandardLine AC6000 AC6001 AC6002 AC6003 ifm AC600x Lib: 1.0.0.11 CODESYS Development System: 3.5 SP9 Patch 7 Hotfix 3 or higher 80293948 / 00 04 / 2020 English

IO-Link Master with AS-Interface Interface StandardLine Contents 1 Preliminary note 1.1 1.2 1.3 1.4 Legal and copyright information .4 Symbols used.5 Warnings used .5 Modification history .5 2 Safety instructions 2.1 System requirements 3.1 3.2 Installation 4.1 Getting started 5.1 5.2 5.3 Programming 6.1.1 6.1.2 6.2.1 6.4.1 7 2 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9 7.1.10 7.1.11 11 Notes on programming .11 Optional: Changing the AS-i address . 11 Optional: Adjusting the gateway profile . 11 Configuring IO-Link ports .12 Note: Device validation and data storage . 12 Reading / writing parameters of the IO-Link devices .13 Reading / writing process data.13 Note: Using cyclic process data . 13 Reading identification and diagnostic information .15 Reading IO-Link events .15 Resetting the IO-Link master .15 Firmware update .15 Appendix 7.1 9 Preparations .9 Creating a project .9 Integrating the library for the AC600n in the project .10 6 6.5 6.6 6.7 6.8 8 Installing the CODESYS library for AC600n .8 5 6.3 6.4 7 Hardware .7 Software .7 4 6.2 6 Required background knowledge .6 3 6.1 4 16 CODESYS library ifm AC600x Lib .17 qFactoryReset (FB) . 18 qReadDevName (FB) . 21 qReadDiagnosisData (FB). 24 qReadInputPD (FB) . 26 qReadIOLParameter (FB) . 28 qReadIOLPortsCfg (FB) . 30 qReadIOLPortsCfgErr (FB) . 32 qReadOutputPD (FB) . 34 qWriteIOLParameter (FB). 36 qWriteIOLPortsCfg (FB) . 38 qWriteOutputPD (FB) . 40

IO-Link Master with AS-Interface Interface StandardLine 7.1.12 7.1.13 7.1.14 7.1.15 7.1.16 8 qWritePortFailsafePattern (FB) . 42 FWUpdate (FB) . 44 InterpretBasicSlaveData (FB) . 47 Complex variables (STRUCT) . 49 Enumeration types (ENUM). 53 Index 58 3

IO-Link Master with AS-Interface Interface StandardLine 1 Preliminary note Content Legal and copyright information .4 Symbols used .5 Warnings used .5 Modification history .5 33203 1.1 Legal and copyright information 33117 All rights reserved by ifm electronic gmbh. No part of this manual may be reproduced and used without the consent of ifm electronic gmbh. All product names, pictures, companies or other brands used on our pages are the property of the respective rights owners: AS-i is the property of the AS-International Association, ( www.as-interface.net) CAN is the property of the CiA (CAN in Automation e.V.), Germany ( www.can-cia.org) CODESYS is the property of the 3S – Smart Software Solutions GmbH, Germany ( www.codesys.com) DeviceNet is the property of the ODVA (Open DeviceNet Vendor Association), USA ( www.odva.org) EtherNet/IP is the property of the ODVA EtherCAT is a registered trade mark and patented technology, licensed by Beckhoff Automation GmbH, Germany IO-Link is the property of the PROFIBUS Nutzerorganisation e.V., Germany ( www.io-link.com) ISOBUS is the property of the AEF – Agricultural Industry Electronics Foundation e.V., Deutschland ( www.aef-online.org) Microsoft is the property of the Microsoft Corporation, USA ( www.microsoft.com) Modbus is the property of the Schneider Electric SE, France ( www.schneider-electric.com) PROFIBUS is the property of the PROFIBUS Nutzerorganisation e.V., Germany ( www.profibus.com) PROFINET is the property of the PROFIBUS Nutzerorganisation e.V., Germany Windows is the property of the Microsoft Corporation, USA 4

IO-Link Master with AS-Interface Interface StandardLine 1.2 Symbols used 58277 Important note Non-compliance can result in malfunction or interference Information Supplementary note . Request for action Reaction, result . . "see" abc Cross-reference 123 0x123 0b010 Decimal number Hexadecimal number Binary number [.] Designation of pushbuttons, buttons or indications 1.3 Warnings used 58278 WARNING Warning of serious personal injury. Death or serious irreversible injuries may result. CAUTION Warning of personaly injury. Slight reversible injuries may result. NOTICE! Warning of damage to property 1.4 Modification history 34492 Version Topic Date 00 New creation of document 04/2020 5

IO-Link Master with AS-Interface Interface StandardLine 2 Safety instructions Content Required background knowledge .6 28333 2.1 Required background knowledge 42525 This document is intended for people with knowledge of control technology and PLC programming to IEC 61131-3. To program the PLC, these people should also be familiar with the CODESYS software. This document is intended for specialists. Specialists are people who, based on their relevant training and experience, are capable of identifying risks and avoiding potential hazards that may be caused during operation or maintenance of the product. The document contains information about the correct handling of the product. Read this document before use to familiarise yourself with operating conditions, installation and operation. Keep this document during the entire duration of use of the device. Follow the safety instructions. 6

IO-Link Master with AS-Interface Interface StandardLine 3 System requirements Content Hardware .7 Software.7 38972 3.1 Hardware 59364 AS-i master: SmartSPS AC14 DataLine (AC1403/04, AC1423/24, AC1433/34) or AS-i gateway AC14 (AC1401/02, AC1411/12, AC1421/22) IO-Link master: AC600n (AC6000/01, AC6002/03) PC/laptop for CODESYS development system 3.2 Software 59365 CODESYS development system, version 3.5 SP9 patch 7 or higher CODESYS package for AC14: "CODESYS for SmartPLC AC14 DataLine", version 1.6.4.4 or higher "CODESYS for SmartPLC AC14 StandardLine", version 1.6.4.4 or higher CODESYS library for AC600n "ifm AC600x Lib", version 1.0.0.1 or higher The features and functions described in this manual can only be obtained by using the software components in the versions stated here. ifm offers the software component for download on its website ( www.ifm.com) 7

IO-Link Master with AS-Interface Interface StandardLine 4 Installation Content Installing the CODESYS library for AC600n.8 42637 4.1 Installing the CODESYS library for AC600n 59366 ifm offers the function library "ifm AC600n Lib" for the programming system CODESYS. The library offers the following functionality: Function blocks to configure and administer the IO-Link master and the IO-Link ports of the AC600n Function blocks to configure the connected IO-Link devices Function blocks to read and write process values of the IO-Link ports Data structures (enumeration types (ENUM) Structure variables (STRUCT) To install the CODESYS library for the AC600: Requirements: CODESYS development system has been installed correctly on the PC / laptop. CODESYS package for AC14 has been correctly installed. CODESYS library for the AC600n has been downloaded. Start CODESYS with administrator rights. Select [Tools] [Library repository .]. Dialogue window [Library repository] appears. Click on [Install.]. Select "ifm AC600n Lib" and click on [Open] to start the installation. The library will be installed. 8

IO-Link Master with AS-Interface Interface StandardLine 5 Getting started Content Preparations .9 Creating a project .9 Integrating the library for the AC600n in the project .10 59367 5.1 Preparations 59368 Please note the following documents: Device manual and programming manual SmartPLC AC14 / AS-i gateway AC14 Operating instructions AC600n Ensure that the following conditions are met: AS-i network with AC14 (AS-i master) and AC600n (AS-i slave) has been configured. AS-i address and gateway profile of the AC600n have been set according to the requirements. AC14 works in the "protected mode". CODESYS PC and AC14 are connected via Ethernet cable. The programming interface between the CODESYS PC and the AC14 has been configured correctly. The CODESYS PLC of the AC14 is enabled. The CODESYS PLC has write access to the AS-i outputs. 5.2 Creating a project 59369 Requirements: CODESYS Development System has been started. Open project with SmartPLC AC14 / AS-i gatewayAC14. OR Select [File] [New Project.]. Select suitable template and click [OK]. CODESYS generates a project with SmartPLC AC14 / AS-i gateway AC14. Device tree shows standard project with SmartPLC AC14 / AS-i gateway AC14. Significance of the project objects: Programming manual AC14 With the project template, the function libraries "ACnnnn Utils" and "ACnnnn SYS CMD" for the AC14 will be linked automatically into the project. 9

IO-Link Master with AS-Interface Interface StandardLine 5.3 Integrating the library for the AC600n in the project 59370 To use the functions and elements of the function library for the AC600n, the user must link the installed library into the CODESYS project. In the device tree of the project: Open [Library Manager]. The library manager shows the libraries that are linked into the project. Click on [Add library]. A dialogue window appears. Select the library "ifm AC600x Lib" and click on [OK] to confirm the selection. CODESYS integrates the library "ifm AC600x Lib" into the project. The user can use the elements of the library in the CODESYS project. 10

IO-Link Master with AS-Interface Interface StandardLine 6 Programming Content Notes on programming .11 Configuring IO-Link ports.12 Reading / writing parameters of the IO-Link devices .13 Reading / writing process data .13 Reading identification and diagnostic information .15 Reading IO-Link events .15 Resetting the IO-Link master .15 Firmware update .15 59371 6.1 Notes on programming 59372 The FBs of the library "ifm AC600x Lib" use the FB "ACnnnn SysCmd". This is why all function blocks are executed as acyclic commands. Make sure that the ifm package has been installed for the AC14 device that is used. 6.1.1 Optional: Changing the AS-i address 59373 The user can set the AS-i address of the AC600n with functions of the AS-i master. In addition, the user can change the address of the basic AS-i slave within a CODESYS application using the following function blocks: FB "Set SlaveAddress" FB "ACnnnn SysCmd" (change AS-i slave address with command 0x1006) After the address has been changed, the AS-i master shows a configuration error. Reconfigure the AS-i network. 6.1.2 Optional: Adjusting the gateway profile 59374 The gateway profile determines which process data of the IO-Link ports is transmitted cyclically between the IO-Link master and the AS-i network. The user can adjust the adequate gateway profile using the ID1 code of the basic AS-i slave. The process data is transmitted in the analogue channels of the additional AS-i slaves (mapping: Operating instructions of the AC600n). The user can set the ID1 code of the basic AS-i slave using functions of the AS-i master. In addition, the user can change the ID1 code of the basic AS-i slave within a CODESYS application using the following function blocks: FB "Set SlaveExtendedID1" FB "ACnnnn SysCmd" (with command "0x1009 – change extended ID1 of the AS-i slave") After the ID1 code has been changed, the AS-i master shows a configuration error. Reconfigure the AS-i network. 11