If you can't read please download the document
Upload
buiminh
View
226
Download
5
Embed Size (px)
Citation preview
>
Programming Manual
CODESYS for
AS-i Fieldbus Gateways
AC1401/02
AC1411/12
AC1421/22
Firmware release: 3.0.24 and higher
CODESYS release: 3.5.3.6
English
7391
013
_00
_U
K 2
01
5-0
4-2
3
2
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Contents
>
Cotents
1 Preliminary note 4
1.1 Legal and copyright information ........................................................................................... 5 1.2 The purpose of the document .............................................................................................. 5 1.3 Symbols and formats used .................................................................................................. 6 1.4 Notes on how to get started ................................................................................................. 7 1.5 History of the instructions ..................................................................................................... 7
2 Safety instructions 8
2.1 Required background knowledge ........................................................................................ 9 2.2 Please note! ......................................................................................................................... 9 2.3 Start-up behaviour of the controller....................................................................................10 2.4 Tampering with the unit ......................................................................................................10
3 System requirements 11
3.1 Hardware ............................................................................................................................12 3.2 Software .............................................................................................................................12 3.3 Licensing ............................................................................................................................12
4 Installation 13
4.1 Programming software CoDeSys .......................................................................................14 4.1.1 Installation of the CODESYS Development System ................................................................... 14
4.2 ifm AS-i Package................................................................................................................15 4.2.1 Components of the ifm AS-i package ......................................................................................... 16
5 Target Settings 18
5.1 Create CODESYS project ..................................................................................................19 5.1.1 Create new project with AC14nn ................................................................................................ 20 5.1.2 Add AC14nn to a project ............................................................................................................ 22 5.1.3 Overview: Project structure with AC14nn ................................................................................... 23
5.2 Configure Ethernet interface ..............................................................................................25 5.2.1 Available fieldbus stacks ............................................................................................................ 25 5.2.2 Add fieldbus stack ...................................................................................................................... 26
6 PLC configuration 27
6.1 Configure AC14nn controller ..............................................................................................28 6.1.1 Communication settings ............................................................................................................. 28 6.1.2 Applications ................................................................................................................................ 30
7 PLC programming 31
7.1 Supported programming languages ..................................................................................32 7.2 Create PLC application ......................................................................................................33
7.2.1 Use remanent variables.............................................................................................................. 33 7.2.2 Use complex variables ............................................................................................................... 33 7.2.3 Task configuration ...................................................................................................................... 34
3
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Contents
7.3 Access input and output data .............................................................................................35 7.3.1 Options to access input and output data .................................................................................... 36 7.3.2 Validity of the interface data ....................................................................................................... 36 7.3.3 Process data of the AS-i slaves .................................................................................................. 37 7.3.4 Fieldbus data .............................................................................................................................. 39
7.4 Use functions of the ifm AS-i package ...............................................................................41 7.4.1 Control interface of the ifm function blocks ................................................................................. 41 7.4.2 Configure system ....................................................................................................................... 44 7.4.3 Configure AS-i master ................................................................................................................ 44 7.4.4 Configure AS-i slaves ................................................................................................................. 44 7.4.5 Manage AS-i network ................................................................................................................. 45 7.4.6 Send commands to the system and the AS-i master .................................................................. 47
7.5 Use web visualisations .......................................................................................................48 7.5.1 Notes on web visualisations ....................................................................................................... 49 7.5.2 Add web visualisation to a project .............................................................................................. 49 7.5.3 Create web visualisation............................................................................................................. 50 7.5.4 Configure web visualisation ........................................................................................................ 51
7.6 Testing the PLC application ...............................................................................................53
8 Operation 54
8.1 Activate CODESYS PLC ....................................................................................................55 8.2 Load application on AC14nn ..............................................................................................56 8.3 Operating states of the CODESYS PLC ............................................................................57
8.3.1 Display current operating state ................................................................................................... 57 8.3.2 Switch operating states .............................................................................................................. 58
8.4 Reset ..................................................................................................................................60 8.4.1 Supported reset variants ............................................................................................................ 61 8.4.2 Reset PLC application ................................................................................................................ 61
8.5 Display web visualisation ...................................................................................................62 8.6 Delete application from AC14nn ........................................................................................63
9 Annex 64
9.1 ifm AS-i function libraries ...................................................................................................65 9.1.1 ACnnnn_Utils.library ................................................................................................................... 66 9.1.2 ACnnnn_SYS_CMD.library ...................................................................................................... 128
9.2 Acyclic data records .........................................................................................................137 9.2.1 Overview: Acyclic data sets ...................................................................................................... 137 9.2.2 Description of the data records (DSx)....................................................................................... 138
9.3 Command channels .........................................................................................................168 9.3.1 Principle of the command channels .......................................................................................... 169 9.3.2 System commands ................................................................................................................... 170 9.3.3 AS-i master commands ............................................................................................................ 187
10 Index 253
11 ifm weltweit ifm worldwide ifm lchelle internationale 257
4
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Preliminary note Legal and copyright information
1 Preliminary note
Legal and copyright information ............................................................................................................... 5 The purpose of the document .................................................................................................................. 5 Symbols and formats used ....................................................................................................................... 6 Notes on how to get started...................................................................................................................... 7 History of the instructions ......................................................................................................................... 7
14801
5
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Preliminary note Legal and copyright information
>
1.1 Legal and copyright information 6088
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 IO-Link ( www.io-link.com) is the property of the PROFIBUS Nutzerorganisation e.V., Germany Microsoft is the property of the Microsoft Corporation, USA ( www.microsoft.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
>
1.2 The purpose of the document 18872
This document applies to the following products from ifm electronic:
AS-i Profinet Gateway (art. no. AC1401/AC1402), firmware version 3.0.24 or higher
AS-i Profibus Gateway (art. no. AC1411/AC1412), firmware version 3.0.24 or higher
AS-i EtherNet/IP Gateway (art. no. AC1421/AC1422), firmware version 3.0.24 or higher
This document describes the integration, configuration and programming of the PLC runtime system "CODESYS Runtime" of the above-mentioned device with the aid of the PLC programming software "CODESYS Development System" and the following software component provided by ifm electronic:
Package file "CoDeSys for ifm ASinterface products" (ifm_AC14nn_AC4nnS_1_1_0_3.package)
This document is to complement the following documentations:
Document Manufacturer
User documentation CODESYS V3, installation and first steps 3S-Smart Software Solutions GmbH
Online help for CODESYS V3 programming system 3S-Smart Software Solutions GmbH
Device manual AS-i Fieldbus gateway AC14nn, firmware V3.0.24 or higher ifm electronic gmbh
http://www.as-interface.net/http://www.can-cia.org/http://www.codesys.com/http://www.odva.org/http://www.io-link.com/http://www.microsoft.com/http://www.profibus.com/
6
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Preliminary note Symbols and formats used
>
1.3 Symbols and formats used 15989
WARNING
Death or serious irreversible injuries may result.
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
... Request for action
> ... Reaction, result
... "see"
abc Cross-reference
123 0x123 0b010
Decimal number Hexadecimal number Binary number
[...] Designation of pushbuttons, buttons or indications
7
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Preliminary note Notes on how to get started
>
1.4 Notes on how to get started 16940
For information about the hardware and software requirements see section System requirements ( page 11).
Familiarise yourself with the programming software CODESYS version 3.5.3.6!
The installation of the programming software CODESYS Development System 3.5.3.6 and of the ifm AS-i package are described in section Installation ( page 13).
Information on the integration of the project into a CODESYS project is given in section Target Settings ( page 18).
Information about the programming of the device-internal CODESYS PLC and about the use of the functions of the ifm AS-i package is given in section PLC programming ( page 31).
Information about the permanent operation of the unit and the control of the PLC applications are contained in section Operation ( page 54).
The detailed reference of the ifm AS-i function blocks (FB) is given in section ifm AS-i function libraries ( page 65) in the Appendix. >
1.5 History of the instructions 17986
Issue Topic Date
1.0 New creation of the document 19 Aug 2014
1.0.1 Correction of the available fieldbus stack for the configuration interface ( Available fieldbus stacks ( page 25))
29 Aug 2014
1.0.2 Correction of required CODESYS edition ( Software ( 12)) 18 Feb 2015
1.0.3 Correction of description of the system command 267 in command overview ( Overview: system commands ( 170))
23 Apr 2015
8
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Safety instructions History of the instructions
2 Safety instructions
Required background knowledge ............................................................................................................. 9 Please note! .............................................................................................................................................. 9 Start-up behaviour of the controller ........................................................................................................10 Tampering with the unit ..........................................................................................................................10
213
9
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Safety instructions Required background knowledge
>
2.1 Required background knowledge 13323
This document is intended for people with knowledge of control technology and PLC programming with IEC 61131-3.
To program the PLC, the 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. >
2.2 Please note! 6091
11212
No characteristics are warranted with the information, notes and examples provided in this manual. With the drawings, representations and examples given no responsibility for the system is assumed and no application-specific particularities are taken into account.
The manufacturer of the machine/equipment is responsible for ensuring the safety of the machine/equipment.
Follow the national and international regulations of the country in which the machine/installation is to be placed on the market!
WARNING
Non-observance of these instructions can lead to property damage or bodily injury! ifm electronic gmbh does not assume any liability in this regard.
The acting person must have read and understood the safety instructions and the corresponding chapters in this manual before working on and with this device.
The acting person must be authorised to work on the machine/equipment.
The acting person must have the qualifications and training required to perform this work.
Adhere to the technical data of the devices! You can find the current data sheet on ifm's homepage at: www.ifm.com > Select your country > [Data sheet search] > (article number.) > [Technical data in PDF format]
Note the installation and wiring information as well as the functions and features of the devices! supplied installation instructions or on ifm's homepage: www.ifm.com > Select your country > [Data sheet search] > (article number.) > [Operating instructions]
Please note the corrections and notes in the release notes for the existing documentation, available on the ifm website: www.ifm.com > Select your country > [Data sheet search] > (article number.) > [Operating instructions]
>
http://www.ifm.com/http://www.ifm.com/http://www.ifm.com/
10
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Safety instructions Start-up behaviour of the controller
2.3 Start-up behaviour of the controller 6827
15233
WARNING
Danger due to unintentional and dangerous start of machine or plant sections!
When creating the program, the programmer must ensure that no unintentional and dangerous start of machines or plant sections after a fault (e.g. e-stop) and the following fault elimination can occur! Realise restart inhibit!
In case of an error, set the outputs concerned to FALSE in the program!
A restart can, for example, be caused by: voltage restoration after power failure reset after watchdog response because of too long a cycle time error elimination after an E-stop
To ensure a safe behaviour of the controller:
monitor the voltage supply in the application program.
In case of an error switch off all relevant outputs in the application program.
Additionally monitor relay contacts which can cause hazardous movements in the application program (feedback).
If necessary, ensure that welded relay contacts in the application project cannot trigger or continue hazardous movements.
Additionally monitor relay contacts which can cause hazardous movements in the application program (feedback).
If necessary, ensure that welded relay contacts in the application project cannot trigger or continue hazardous movements.
>
2.4 Tampering with the unit 11242
WARNING
Tampering with the units can affect the safety of operators and machinery!
Tampering with the units is not allowed. In case of non-compliance our liability and warranty expire.
Do not open the devices!
Do not insert any objects into the devices!
Prevent metal foreign bodies from penetrating!
11
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
System requirements Tampering with the unit
3 System requirements
Hardware ................................................................................................................................................12 Software..................................................................................................................................................12 Licensing.................................................................................................................................................12
16903
12
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
System requirements Hardware
>
3.1 Hardware 16904
Device of the AC14nn product family, firmware V3.0.24 or higher
PC/laptop ( system requirements CODESYS development system V3.x)
Ethernet connection between CODESYS-PC/laptop and configuration interface (X3) of the AC14nn ( device manual, section Configuration interface: Connection concepts)
>
3.2 Software 16905
To program the device-internal PLC of the ifm AS-i fieldbus gateways (AC14nn), the following software components are required:
Programming software CODESYS Development System, version 3.5.3.6 www.3s-software.com
Package file "CoDeSys for ifm ASinterface products" (ifm_AC14nn_AC4nnS_1_1_0_3.package) www.ifm.com/ifmde/web/asi-download.htm
>
3.3 Licensing 16906
All models of the device family AC14nn, to be programmed using the CODESYS Development System V3.x, must be licensed. A valid license label can be purchased via ifm's website.
Article description Article no.
1x CODESYS V3 license AC14nn E71400
Use of the device-internal CODESYS PLC of AC14nn without valid license constitutes a violation of applicable law!
http://www.3s-software.com/http://www.ifm.com/ifmde/web/asi-download.htm
13
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Installation Licensing
4 Installation
Programming software CoDeSys ...........................................................................................................14 ifm AS-i Package ....................................................................................................................................15
17146
14
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Installation Programming software CoDeSys
>
4.1 Programming software CoDeSys 7282
The CODESYS Development System (short: CODESYS) serves as platform for the creation of PLC applications according to the standard IEC 61131-3.
>
4.1.1 Installation of the CODESYS Development System 18596
To install the software "CODESYS Development System":
CODESYS installation instructions
15
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Installation ifm AS-i Package
>
4.2 ifm AS-i Package
Components of the ifm AS-i package .....................................................................................................16 Install ifm AS-i package ..........................................................................................................................16 Update ifm AS-i package ........................................................................................................................17 Uninstall the ifm AS-i package ...............................................................................................................17
17679
Familiarise yourself with the following CODESYS functions:
Use of the Package Manager Online help > Menu Commands sorted by Categories > Installation > Package Manager
16
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Installation ifm AS-i Package
>
4.2.1 Components of the ifm AS-i package 17550
ifm provides the package "CODESYS for ASinterface Products" (short: ifm AS-i package) for the CODESYS programming software. It contains the following components:
Component Description Reference
AC14nn.devdesc.xml Device description file of the AC14nn basic module
ACnnnn_EthernetAdapter.devdesc.xml Device description file of the Ethernet interface
ACnnnn_EtherCAT.devdesc.xml Device description file for an EtherCat fieldbus interface for the extension of the Ethernet interface.
ACnnnn_Utils.library Function library with AC14nn specific CODESYS function blocks and data structures
ACnnnn_SYS_CMD.library Function library with function block for access to the command interface of AC14nn from a CODESYS application
>
Install ifm AS-i package
7283
To install the package "CODESYS for ifm AS-interface products":
1 Download the current version of the ifm AS-i package
Access the AS-i download area on ifm's website. ( www.ifm.com > Service > Download > Industrial communication)
Download file ifm_AC14nn_AC4nnS_1_1_0_3.package and save it on the CODESYS PC/notebook.
2 Install the ifm AS-i package in CODESYS
Start CODESYS with administrator rights.
Access the package manager with [Tools] > [Package Manager].
> Window [Package Manager] is displayed.
Start the installation dialogue with [Install new packages].
Select the downloaded ifm AS-i package and carry out a complete installation.
> Window [Package Manager] shows the installed ifm AS-i package:
End the package manager with [Exit].
http://www.ifm.com/
17
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Installation ifm AS-i Package
>
Update ifm AS-i package
12267
To update an installed package "CoDeSys for ifm AS-Interface products":
1 Uninstall the old version of the ifm AS-i package
Uninstall the ifm AS-i package ( page 17)
2 Install a new version of the ifm AS-i package
Install ifm AS-i package ( page 16)
3 Update device libraries
Device window: Mark [Device (AC14nn)] in the project tree.
Activate [Project] > [Update Device].
> Window [Update Device] appears.
Start the update process with [Update Device].
> New device libraries are loaded.
> Project tree view is updated.
Close the Package Manager with [Exit].
Save the project. >
Uninstall the ifm AS-i package
12270
To uninstall the package "CODESYS for ifm AS-interface products":
Access the package manager with [Tools] > [Package Manager].
> Window [Package Manager] shows the installed packages.
Activate [Display version] checkbox.
> The window shows the version numbers of the installed packages.
Tick the package version to be uninstalled and uninstall with [Uninstall ...].
> The marked package version is uninstalled.
Close the Package Manager with [Exit].
18
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings ifm AS-i Package
5 Target Settings
Create CODESYS project ......................................................................................................................19 Configure Ethernet interface...................................................................................................................25
17034
19
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
>
5.1 Create CODESYS project
Create new project with AC14nn ............................................................................................................20 Add AC14nn to a project ........................................................................................................................22 Overview: Project structure with AC14nn ...............................................................................................23
17129
Familiarise yourself with the following CODESYS functions!
CODESYS project Online help > Concepts and Base Components > Project
Device, device tree Online help > Concepts and Base Components > Device, Device tree
Application Online help > Concepts and Base Components > Application
Library manager Online help > Concepts and Base Components > Library manager
20
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
>
5.1.1 Create new project with AC14nn 17130
To create a CODESYS project with an AC14nn:
1 Adjust project attributes
Use [File] > [New Project...] to start the setup dialogue.
> Window for project attributes configuration.
Set the following values: 1. [Templates]: [Standard project] to be highlighted. 2. [Name]: Enter project name (e.g. MyProject). 3. [Location]: Choose storage location for the project file.
Use [OK] to confirm the entered values.
21
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
2 Select device and programming language
> Dialogue window for device selection appears.
Set the following values: 1. [Device]: Select AC14nn (ifm electronic). 2. [PLC_PRG in]: Select PLC programming language ( Supported programming languages ( page 32)).
Use [OK] to confirm the entered values.
> CODESYS creates a project with the AC14nn.
> Window [Devices] shows project tree ( Overview: Project structure with AC14nn ( page 23)).
22
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
>
5.1.2 Add AC14nn to a project 17131
To add a AC14nn to an existing CODESYS project:
1 Open project
Open a stored project.
2 Add AC14nn to the project
In the project tree: Highlight Wurzelknoten (= project name).
Use [Project] > [Add Device...] to start the configuration dialogue.
Dialogue window for device selection appears.
Set the following values: 1. [Name]: Enter device designation. 2. [Action]: Activate [Append Device] checkbox. 3. [Vendor]: Select ifm electronic. 4. In the list: Highlight AC14nn.
Use [Add Device] to confirm the entered values.
Use [Close] to close the dialogue window.
> Project tree shows structure of the project with added device.
23
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
>
5.1.3 Overview: Project structure with AC14nn 17132
A CODESYS project contains all components for the programming and administration of PLC applications. All components of a project are shown in the window [Devices] in a hierarchic tree view. CODESYS projects with an AC14nn have the following structure:
[MyProject] is the name of the CODESYS project
[Device (AC14nn)] represents the AC14nn in the CODESYS project.
[PLC Logic] contains the PLC applications to be executed.
[Application] is a container for all components the belong to a PLC application: Library manager serves for the administration of the function libraries. PLC_PRG (PRG) contains the program code in the selected programming language. Task Configuration offers setting options for the processing of the individual tasks.
Interface [ASi_Master_1] contains the process images of the slaves at AS-i master 1: ASi_1_binaryIO offers access to the digital input and output data. ASi_1_analogIO offers access to the analogue input and output data incl. status flags
Interface [ASi_Master_2] contains the process images of the slaves at AS-i master 2 ( )
Interface [Fieldbus_Interface] contains the input and output data of the Fieldbus interface. FieldBusData_ shows all the data that is transmitted from and to the device via the fieldbus. ASi_1/2_binaryOut contains data that the fieldbus controller sends to the digital AS-i slaves. ASi_1/2_analogOut contains data that the fieldbus controller sends to the analogue AS-i slaves.
24
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Create CODESYS project
Interface [Ethernet] represents the Ethernet adapter of the device.
25
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Configure Ethernet interface
>
5.2 Configure Ethernet interface
Available fieldbus stacks ........................................................................................................................25 Add fieldbus stack ..................................................................................................................................26
17701
Familiarise yourself with the following CODESYS functions!
Menu command "Attach device" Online help > Menu Commands sorted by Categories > Devices > Attach Device...
Configure EtherCAT (master) Online help > Device Editors > EtherCAT Configuration Editor
Configure modbus TCP (master/slave) Online help > Device Editors > Modbus Configuration Editor
>
5.2.1 Available fieldbus stacks 18518
The Ethernet internet (X3) of the device can be declared and operated as an additional fieldbus interface. For this, a fieldbus stack must be assigned to the interface in CODESYS. Presently, the device supports the following fieldbus stacks:
Designation Fieldbus Manufacturer
EtherCAT Master EtherCAT 3S - Smart Software Solutions GmbH
Modbus TCP Master Modbus TCP 3S - Smart Software Solutions GmbH
Modbus TCP Slave Modbus TCP 3S - Smart Software Solutions GmbH
26
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Target Settings Configure Ethernet interface
>
5.2.2 Add fieldbus stack 17702
To declare the Ethernet interface as a fieldbus interface:
1 Create/load CODESYS project
Create or load CODESYS project with AC14nn.
2 Add fieldbus stack
Windows [Devices]: Highlight [Ethernet] in the project tree and use [Project] > [Add Device...] to show the configuration dialogue.
> Window shows configuration options for Ethernet interface.
Set the following values: 1. Field [Name]: Enter name of the fieldbus stack. 2. Group [Action]: Select [Append Device] radio button. 3. List [Vendor]: Select []. 4. Highlight requested fieldbus stack.
Use [Add Device] to confirm the entries.
> Device tree shows the selected fieldbus stack as sub-element of the interface (Example: Modbus TCP slave):
Configure fieldbus devices ( CODESYS online help).
27
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC configuration Configure Ethernet interface
6 PLC configuration
Configure AC14nn controller ..................................................................................................................28 18498
Familiarise yourself with the following CODESYS functions!
Generic device editor Online help > Device Editors > Generic Device Editor
28
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC configuration Configure AC14nn controller
>
6.1 Configure AC14nn controller 18519
To access the configuration options of the device-internal PLC:
In the project tree: Double-click on [Device (AC14nn)].
> Editor window shows tab [Device] with the configuration options for the device-internal PLC:
>
6.1.1 Communication settings 18494
The [Device] > [Communication Settings] tab offers options for the adjustment of the connection between the CODESYS programming software and the AC14nn. >
Configure connection with AC14nn
18500
To configure the connection between CODESYS programming software and the AC14nn:
1 Preparations
Connect CODESYS PC/laptop and configuration interface (X3) of the device.
Optional: Adjust IP settings of the Ethernet interfaces.
2 Select gateway
In the editor window: Select [Device] > [Communication Settings] tab.
> Window shows the active communication settings.
If no gateway is available: Create and configure new gateway.
29
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC configuration Configure AC14nn controller
3 Search AC14nn in the network
Highlight [Gateway-1].
Browse the network for accessible devices with the button [Scan network].
> CODESYS browses the Ethernet network of the selected gateway.
> If successful: Window displays AC14nn with active IP address.
> If not successful: Check Ethernet connection and IP settings and repeat process.
4 Set active communication path
Highlight AC14nn and activate the button [Set active path].
> AC14nn contains the attribute (active) and will be highlighted (font weight bold)
> Communication channel between CODESYS PC laptop and AC14nn is set and active.
30
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC configuration Configure AC14nn controller
>
6.1.2 Applications 18495
The [Device] > [Applications] tab offers display and administration options for applications that are stored on the AC14nn. >
Display stored applications
18496
To display applications stored on the AC14nn:
set communication channel to the AC14nn. ( Configure connection with AC14nn ( page 28))
In the editor window: Select [Device] > [Applications] tab.
Read the applications stored on the device with [Refresh List].
> Editor window shows the list of applications stored on the AC14nn. >
Delete applications on the device
18497
To delete one or several applications on the AC14nn:
Display applications on the device ( Display stored applications ( page 30)).
Delete all applications on the device with [Remove All]. OR Highlight applications in question and delete them with [Remove] on the device.
> A success message appears.
> The list in the editor window shows the message "No application available on the controller".
31
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Configure AC14nn controller
7 PLC programming
Supported programming languages .......................................................................................................32 Create PLC application ...........................................................................................................................33 Access input and output data .................................................................................................................35 Use functions of the ifm AS-i package ...................................................................................................41 Use web visualisations ...........................................................................................................................48 Testing the PLC application....................................................................................................................53
7074
Familiarise yourself with the programming according to the standard IEC 61131-3!
Create example program Online help > Quickstart > Create and run a project
Familiarise yourself with the following CODESYS functions!
Program editor Online help > Editors > Editors for the IEC Programming Languages and CFC
Programming reference Online help > Programming Reference
Menu commands for programing Online help > Menu Commands sorted by Categories > FBD/LD/IL
Function libraries Online help > Libraries
32
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Supported programming languages
>
7.1 Supported programming languages 18034
The following table shows which programming languages according to IEC 61131 are supported by the ifm function libraries:
Library
Fu
nc
tio
n B
loc
k D
iag
ram
(F
BD
)
Seq
uen
tial F
un
cti
on
Ch
art
(S
FC
)
In
str
ucti
on
Lis
t (I
L)
Co
nti
nu
ou
s F
un
cti
on
Ch
art
(C
FC
)
La
dd
er
Dia
gra
m (
LD
)
Str
uctu
red
Text
(ST
) ACnnnn_Utils.library X X X X X X
ACnnnn_SYS_CMD.library X X X X X X
33
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Create PLC application
>
7.2 Create PLC application 17691
To create a PLC application:
Windows [Devices]: Double-click on [PLC_PRG] in the project tree
> Editor window shows programming surface:
>
7.2.1 Use remanent variables 18522
The CODESYS PLC of the AC14nn supports the use of remanent variables. Variables declared with VAR RETAIN are stored in a memory area that is also maintained when the device is switched off.
The declaration of a variable as RETAIN also influences its behaviour when the PLC application is reset ( Supported reset variants ( page 61)). >
7.2.2 Use complex variables 18528
There are different complex variables (STRUCT) at the programmer's disposal. They bundle logically associated data sets. Thereby, they facilitate the organisation of the data storage in the application and at the same time reduce the error rate when variables are declared.
The following complex variables are available:
Designation Description Reference
ASI_NET The complex variable contains the complete process image (inputs and outputs) of an AS-i network.
ASI_NET (STRUCT) ( page 124)
ASI_DATA The complex variable contains the following components:
Slave lists (LPS, LDS, LAS, LPF, LCE, LCEMS, LCEAS, LDAE)
Parameter images (PI, PP)
Configuration data of the AS-i slaves (CDI, PCD)
ASI_NET (STRUCT) ( page 124)
Get_ASi_Data ( page 110)
>
34
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Create PLC application
7.2.3 Task configuration 18412
NOTICE
Risk of reduced device performance!
The basic settings of the task properties can cause high system utilisation in case of extensive applications or projects with several tasks. This can lead to a poor device performance with unwanted system behaviour.
Set the type of the corresponding task to "Freewheeling" in the task configuration!
To change the type of task:
Windows [Devices]: In the project tree, double-click on [Task Configuration] > [Name_of_the_Task]
> Editor window shows the configuration of the selected task.
Select [Type] the value [Freewheeling] in the list
> Selected value is applied.
35
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
7.3 Access input and output data
Options to access input and output data ................................................................................................36 Validity of the interface data ...................................................................................................................36 Process data of the AS-i slaves .............................................................................................................37 Fieldbus data ..........................................................................................................................................39
17447
Familiarise yourself with the following CODESYS functions!
Addresses according to IEC standard 61131-3: Online help > Programming Reference > Operanden > Addresses > Address
Access to IEC address via AT declaration: Online help > Programming Reference > Declaration > AT Declaration
Definition of an ALIAS for an IEC address: Online help > Programming Reference > Data Types > User defined Data Types > References
coupling of a program variable to an address (mapping): Online help > Device Editors > Generic Device Editor > I/O Mapping
36
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
7.3.1 Options to access input and output data 17621
In a CODESYS project, each input and output has a physical address according to the IEC standard (e.g. %IW5). CODESYS offers the following options to access this address from a PLC application and thereby to access the input and outputs data of the device:
Access to IEC address via AT declaration
Definition of an ALIAS for an IEC address
Link a program variable to an IEC address (mapping) >
7.3.2 Validity of the interface data 18413
In order to facilitate the access to inputs and outputs of peripheral devices, AC14nn projects offer clearly defined interfaces ( Overview: Project structure with AC14nn ( page 23)).
Depending on the active controller instance of the outputs of the AS-i slaves (manually, gateway, PLC), the CODESYS data mapper only updates certain interfaces.
The following table shows which interfaces in the project tree the programmer can access and read in the individual operating modes (e.g. for variable linking):
Controller instance Active I/O interfaces
Manual Fieldbus_Interface AS-i 1 Out (%I)
AS-i 2 Out (%I)
ASi_Master_1 AS-i 1 IN (%I)
ASi_Master_2* AS-i 2 IN (%I)
Gateway Fieldbus_Interface AS-i 1 Out (%I)
AS-i 2 Out (%I)
ASi_Master_1 AS-i 1 IN (%I)
ASi_Master_2* AS-i 2 IN (%I)
PLC Fieldbus_Interface AS-i 1 Out (%I)
AS-i 2 Out (%I)
ASi_Master_1 AS-i 1 IN (%I)
AS-i 1 Out (%Q)
ASi_Master_2* AS-i 2 IN (%I)
AS-i 2 Out (%Q)
* ... only available in devices with two 2 AS-i masters!
When linking variables with inputs and outputs, only use the active interfaces in the project tree!
37
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
7.3.3 Process data of the AS-i slaves 17584
The project tree offers direct access to the cyclically updated process images of the inputs and outputs of the AS-i slaves.
Digital input and output data of the slave at AS-i master 1
Analogue input and output data of the slaves at AS-i master 1
Consider validity of the interface data ( Validity of the interface data ( page 36))!
The function library ACnnnn_Utils.library contains the complex variable ASi_NET. The variable represents all inputs and outputs of a completely developed AS-i network. The programmer can use this data structure to store the process images of the inputs and outputs of an AS-i network. ( ASI_NET (STRUCT) ( page 124))
>
Digital input and output data
17625
To access the digital process data of the slaves at AS-i master 1:
In the project tree: Double-click on [ASi_1_binaryIO]
> Editor window shows a structured list of the digital inputs and outputs of the AS-i slaves.
In column [Variable]: Mouse click on to make individual variables visible.
To access the digital process data of the slaves at AS-i master 2 in a system with 2 AS-i masters:
Double-click on [ASi_2_binaryIO]
38
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
Analogue input and output data
17626
To access the analogue process data of the slaves at AS-i master 1:
In the device tree: Double-click on [ASi_1_analogIO]
> Editor window shows a structured list of the analogue inputs and outputs of the AS-i slaves.
In column [Variable]: Mouse click on to make individual variables visible.
To access the analogue process data of the slaves atAS-i Master2 in a system with 2 AS-i masters:
Double-click on [ASi_2_analogIO]
39
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
7.3.4 Fieldbus data 17585
The device tree offers direct access to the data that is transmitted between fieldbus and device.
Data that the fieldbus transmits/receives via the fieldbus.
Output data of the AS-i slaves that is transmitted by the higher-level fieldbus PLC.
Consider validity of the interface data ( Validity of the interface data ( page 36))!
>
Input and output data of the fieldbus interface
17619
The input and output data of the fieldbus interface os transmitted in cycles of 120 words each. The programmer can access this data via IEC addresses.
To access the input and output data of the fieldbus interface:
Device window: In the project tree, double-click on [FieldBusData_]
> Editor window shows a structured list of the inputs and outputs:
In column [Variable]: Mouse click on to make individual variables visible. >
Output data of the AS-i slaves
17620
If the device is operated as a fieldbus gateway (output control = gateway), the fieldbus controller sends the output data of the AS-i slaves in cycles via the fieldbus. The data is structure like an AS-i network. The programmer can access this data via IEC addresses.
40
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Access input and output data
>
Digital output data
17630
To access the digital output data of the slaves at AS-i master 1:
Device window: In the project tree, double-click on [ASi_1_binaryOut]
> Editor window shows a structured list of the digital output data:
In column [Variable]: Mouse click on to make individual variables visible.
To access the digital output data of the slaves at AS-i master 2 in a system with 2 AS-i masters:
Double-click on [ASi_2_binaryOut]
>
Analogue output data
17631
To access the analogue output data of the slaves at AS-i master 1:
Device window: In the project tree, double-click on [ASi_1_analogOut]
> Editor window shows the structured list of the analogue output data:
In column [Variable]: Mouse click on to make individual variables visible.
To access the analogue output data of the slaves at AS-i master 2 in a system with 2 AS-i masters:
Double-click on [ASi_2_analogOut]
41
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
7.4 Use functions of the ifm AS-i package 18489
The CODESYS package "CoDeSys for ifm ASinterface products" offers different functions for the programming of the device-internal CODESYS controller. In the following paragraphs, these functions will be briefly described. To make orientation easier, the functions are grouped according to corresponding subjects and provided with a cross-reference to a detailed explanation in the document's appendix. >
7.4.1 Control interface of the ifm function blocks 17660
All function blocks (FB) of the libraries ACnnnn_Utils.library and ACnnnn_SYS_CMD.library have inputs and outputs for control signals. The inputs activate the execution of the function block. The outputs provide information about the internal condition of the function block. Thanks to the signals, the programmer can create a control structure for a targeted processing of the FB and react to possible errors.
Number and designation of the FB control signals provide information about the type of FB execution: >
FB with one-time execution
17140
These function blocks perform their function exactly once after activation. To execute the function once again, the FB needs to be reactivated. FBs of this kind feature a control interface with the following inputs and outputs:
Designation Type Data type Description Possible values
xExecute Input BOOL Control FB execution FALSE = Stop FB execution
TRUE = Start FB execution
xReady Output BOOL Indication of whether execution of the FB has been completed
FALSE = FB execution not yet completed
TRUE = FB execution completed
xBusy Output BOOL Indication of whether FB is active FALSE = Function block is inactive
TRUE = FB is active
xError Output BOOL Indication of whether faults have occurred during execution of the FB
FALSE = FB executed correctly
TRUE = Error occurred during execution of the FB
wDiagnostic Output WORD Error code FB specific
42
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
The following figure shows the relation between the connections of the control signals:
xExecute = TRUE: xBusy = TRUE:
Rising edge (FALSE TRUE) starts execution of the FB. FB execution has been started, but has not yet been completed.
xReady = TRUE: xBusy = FALSE: xError = FALSE:
FB execution completed; there are valid values on the data outputs. FB is no longer active. FB execution without faults.
xExecute = FALSE: All signal outputs are set to FALSE and all internal states are reset.
xReady = TRUE: xBusy = FALSE: xError = TRUE:
FB execution is terminated. FB is no longer active. Errors occurred during FB execution; wDiagnostic provides error code.
xExecute = FALSE: FB execution interrupted prior to completion; All signal outputs are set to FALSE and all
internal states are reset.
43
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
FB with cyclic execution
17141
Function blocks which, when activated, cyclically perform their function until they are deactivated have the following control inputs and outputs:
Designation Type Data type Description Possible values
xEnable Input BOOL Control FB execution FALSE = Stop FB execution
TRUE = Start FB execution
xActive Output BOOL Indication of whether execution of the FB has been completed
FALSE = FB execution not yet completed
TRUE = FB execution completed
xError Output BOOL Indication of whether faults have occurred during execution of the FB
FALSE = FB executed correctly
TRUE = Error occurred during execution of the FB
wCycleCount Output WORD Counters for the FB cycles Integer value (hexadecimal representation)
wDiagnostic Output WORD Error code FB specific
44
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
7.4.2 Configure system 17450
To configure the system of the device, use the following function blocks:
Function block Description Reference
QuickSetupASi_Master Execute quick setup routine on an AS-i master QuickSetupASi_Master ( page 115)
Set_TimeDate Set system time (date, time) of the system Set_TimeDate ( page 117)
Get_FieldbusInfo Read fieldbus type, the status of the field bus connection and the parameters of the fieldbus interface
Get_FieldbusInfo ( page 113)
>
7.4.3 Configure AS-i master 17448
To configure the AS-i master(s) of the device, use the following function blocks:
Function block Description Reference
Set_Mode Set operating mode of the AS-i master (projecting mode or protected operation)
Set_Mode ( page 100)
Set_ASi_Config Set diagnostic functions of the AS-i master (double address recognition, earth fault detection)
Set_ASi_Config ( page 96)
Set_AdressMode Set automatic addressing of the AS-i master Set_AddressMode ( page 94)
>
7.4.4 Configure AS-i slaves 17449
To configure the AS-i slaves, that are connected to the device, use the following function blocks:
Function block Description Reference
Set_SlaveAddress Change address of an AS-i slave Set_SlaveAddress ( page 104)
Set_SlaveParameter Change I/O configuration and ID codes (IO, ID, ID1, ID2) of an AS-i slave
Set_SlaveParameter ( page 108)
Set_SlaveExtendedID1 Extended ID1 of an AS-i slave Set_SlaveExtendedID1 ( page 106)
45
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
7.4.5 Manage AS-i network 17126
To manage the AS-i networks controlled by AC14nn, use the following function blocks: >
Change network settings
17568
Function block Description Reference
Set_ProjectAll Execute projection adaptation on one AS-i master Set_ProjectAll ( page 103)
Set_LPS Change list of the projected slaves (LDS) Set_LPS ( page 98)
Set_PCD Change permanent projecting data (IO, ID, ID1, ID2) of all slaves on the AS-i master
Set_PCD ( page 101)
>
Read network settings
18532
To read the network settings cyclically and offer them in the application:
Function block Description Reference
Get_ASi_Data Read the following datasets for network management in batches and cycles:
List of activated slaves (LAS)
List of detected slaves (LDS)
List of projected slaves (LPS)
List of peripheral faults (LPF)
List of configuration errors (LCE)
List of configuration errors, missing slaves (LCEMS)
List of configuration errors - additional slaves (LCEAS)
List of double address errors (LDAE)
Configuration data image (CDI)
Permanent configuration data (PCD)
Input parameters (PI)
Output parameters (PP)
Get_ASi_Data ( page 110)
Alternatively, this data can be read separately with the following FB:
46
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
Read parameter images
17569
Function block Description Reference
Get_InputParameter Read parameters of the inputs of the slaves at the AS-i master (PI)
Get_InputParameter ( page 90)
Get_OutputParameter Read parameters of the outputs of the slaves on the AS-i master (PP)
Get_OutputParameter ( page 92)
>
Read slave lists
18530
Function block Description Reference
Get_LPS Read list of projected slaves (LPS) Get_LPS ( page 74)
Get_LDS Read list of detected slaves (LDS) Get_LDS ( page 72)
Get_LAS Read list of activated slaves (LAS) Get_LAS ( page 70)
Get_LPF Read list of peripheral faults (LPF) Get_LPF ( page 84)
Get_LCE Read list of configuration errors (LCE) Get_LCE ( page 76)
Get_LCEMS List of configuration errors - read missing slaves (LCEMS)
Get_LCEMS ( page 80)
Get_LCEAS Read of the configuration errors - read additional slave (LCEAS)
Get_LCEAS ( page 78)
Get_LDAE Read list of double address errors (LDAE) Get_LDAE ( page 82)
>
Read configuration data of the slaves
18533
Function block Description Reference
Get_CDI Read configuration data image (IO, ID, ID1, ID2) of all slaves on the AS-i master
Get_CDI ( page 86)
Get_PCD Read permanent configuration data of all slaves (IO, ID, ID1, ID2) on the AS-i master
Get_PCD ( page 88)
>
Read status of the voltage supply
18529
Function block Description Reference
Get_ASi_PHY_Dat Determine voltage supply status of the AS-i network Get_ASi_PHY_Dat ( page 68)
47
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use functions of the ifm AS-i package
>
7.4.6 Send commands to the system and the AS-i master 17659
Similar to the acyclic transmission command channels and data sets of the device, the programmer can send commands to the system or an AS-i master with the FB ACnnnn_SysCmd ( ACnnnn_SysCmd ( page 129)).
System command overview: Table: System commands ( page 130)
Overview AS-i master commands: Table: AS-i master commands ( page 131)
By default, the FB ACnnnn_SysCmd is hidden. To add the FB to a program module:
Highlight the requested network and add an empty function block with [FBD/LD/IL] > [Insert Empty Block].
> Network shows empty FB.
Double-click on the name field of the FB
Enter designation ACnnnn_SysCmd and confirm with [ENTER].
> FB has inputs and outputs of the ACnnnn_SysCmd.
Adjust inputs and outputs of the FB in accordance with the requested command.
48
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use web visualisations
>
7.5 Use web visualisations
Notes on web visualisations ...................................................................................................................49 Add web visualisation to a project ..........................................................................................................49 Create web visualisation .........................................................................................................................50 Configure web visualisation ....................................................................................................................51
17059
Familiarise yourself with the following CODESYS functions!
Visualisation in CODESYS Online help > Visualization
Web visualisation Online help > Visualization > Visualization Manager with Clients > The Clients and their Editors
Task configuration Online help > Editors > Task Configuration Editor - Task Editor > Configuration dialogue
49
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use web visualisations
>
7.5.1 Notes on web visualisations 17661
The AC14nn supports web visualisations (WebVisu). A web visualisation offers the possibility to have a graphic display of process and control data using a web browser. >
7.5.2 Add web visualisation to a project 17060
To add a web visualisation to a CODESYS project:
Open CODESYS project. OR: Create new CODESYS project. ( Create new project with AC14nn ( page 20))
Windows [Devcies]: In the project tree, right-click on [Application]
> Context menu with options appears.
Select [Add Object ] > [Visualization] and use [Add] to create the visualisation.
> The project tree contains the following additional elements:
VISU_TASK: Configuration options for the parameters of the visualisation task (request interval, watchdog, etc.) Set parameters for visualisation task ( page 51)
VisualizationManager: Administration of several visualisations (determine start visualisation, change name of the .htm file, adjust interval for updates) Change properties of the web visualisation ( page 52)
MyWebVisu: Area for the creation of the web visualisation Create web visualisation ( page 50)
50
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use web visualisations
>
7.5.3 Create web visualisation 17061
To create a web visualisation for a PLC application:
Windows [Devices]: In the project tree, double-click on [Visualization]
> The visualisation editor with a tool box appears:
Create the visualisation using the tools.
Save the project.
51
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use web visualisations
>
7.5.4 Configure web visualisation 17064
Each web visualisation is executed separately from the program code in a separate task. Take the following steps to configure the web visualisation: >
Set parameters for visualisation task
17066
Execute the visualisation task (VISU_TASK) with a priority that is as low as possible to avoid interruption of other tasks that are important for the core functions of the application.
Execute the VISU_TASK in appropriate cyclic intervals to save the resources of the device-internal CODESYS PLC of the fieldbus network.
To set the attributes of the visualisation task:
In the project tree: Double-click on [VISU_TASK]
> In the editor window: [VISU_TASK] > [Configuration] tab shows parameters of the WebVisu task:
Set the parameters as requested.
Save project in order to apply changed values.
52
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Use web visualisations
>
Change properties of the web visualisation
17065
To change the attributes of the web visualisation:
Device window: In the project tree, double-click on [WebVisualization]
> Editor window shows attributes of the web visualisation:
Set the following values: 1. Field [Start Visualization]: Select the created web visualisation. 2. Field [Name of .htm file]: Enter name of htm. file ( note). 3. Group [Best Fit]: Enter fixed width and height as shown.
Enter the name by which the web visualisation is to be accessible in the web browser in the field [Name of .htm file] ( Display web visualisation ( page 62)).
Save project in order to apply changed values.
53
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
PLC programming Testing the PLC application
>
7.6 Testing the PLC application 18594
To ensure permanent operation without errors in industrial environments, the created PLC applications must be tested in detail and possible faults must be remedied.
Familiarise yourself with the following CODESYS functions!
Test and fault elimination Online help > Concepts and Base Components > Debugging
54
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Testing the PLC application
8 Operation
Activate CODESYS PLC ........................................................................................................................55 Load application on AC14nn ..................................................................................................................56 Operating states of the CODESYS PLC ................................................................................................57 Reset ......................................................................................................................................................60 Display web visualisation ........................................................................................................................62 Delete application from AC14nn .............................................................................................................63
18492
Familiarise yourself with the following CODESYS functions!
Communication between CODESYS and device Online help > Menu Commands sorted by Categories > Device communication
Translate project/application and transfer to the device Online help > Menu Commands sorted by Categories > Online
55
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Activate CODESYS PLC
>
8.1 Activate CODESYS PLC 17692
To enable the processing of the created PLC application, the device-internal CODESYS PLC must be activated in the setup menu of AC14nn.
If the PLC application is to have a write access to the outputs of the AS-i slaves, the CODESYS PLC must be activated additionally as controller instance of the AS-i slave outputs.
The following table shows the possible combinations of the parameters [Output access] and [Use PLC] as well as the rights of the CODESYS PLC resulting thereof.
List [Output access]
Checkbox [Use PLC]
CODESYS PLC
Programmable Access to AS-i inputs
Access to AS-i outputs
Gateway
no yes no
yes yes no
Manual
no yes no
yes yes no
PLC * yes yes yes
Legend:
* ... Value fixed (greyed out)
To set the operating mode of the AC14nn:
1 Call up menu page
Navigation path: >
Select [System settings] tab.
2 Set the controller instance of the outputs
Select the requested controller instance of the AS-i outputs in the list [Output access].
Use [Accept selection] to activate the selection.
3 Activate CODESYS PLC
Activate [Use PLC] checkbox.
> CODESYS PLC is active.
4 Optional: Adjust device cycle
Select the requested device cycle time in the list [Device cycle].
Use [Accept selection] to activate the selected value.
56
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Load application on AC14nn
>
8.2 Load application on AC14nn 18593
To transfer the created PLC application as boot project to the device:
Requirements:
Connection between PC/laptop and AC14nn established ( device manual, appendix: Configuration interface: Connection concepts).
Communication path is set ( Configure connection with AC14nn ( page 28)).
Project tested.
1 Translate application
In the project tree: highlight application as active application.
Use [Build] > [Rebuild] to translate the active application.
> CODESYS generates program code.
2 Load application on AC14nn
Use [Online] > [Login] to connect with the AC14nn.
> Active application is loaded to AC14nn (download).
> Application on AC14nn is in STOP state.
3 Create boot application
Use [Online] > [Create boot application] to make the application bootable.
> Application storage is non-volatile.
4 Start application
Use [Debug] > [Start] to start the application.
> Application goes to the RUN state.
57
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Operating states of the CODESYS PLC
>
8.3 Operating states of the CODESYS PLC 17544
All applications saved on the device are executed in separate tasks independently of each other. If the device-internal CODESYS PLC is activated, each of these tasks can have the following operating states:
Operating status Description/characteristics
STOP The PLC application saved on the device is not processed.
RUN The PLC application saved on the device is cyclically processed.
If the device-internal PLC is activated and at least 1 application is saved on the device, the PLC automatically goes into the RUN state.
>
8.3.1 Display current operating state 10272
Execute one of the following actions to display the current operating state of the PLC:
CODESYS:
> Application node in the project tree shows the status:
Connection with CODESYS PLC established.
PLC application is in the STOP state.
Connection with CODESYS PLC established.
PLC application is in the RUN state.
GUI / web interface of the device:
Navigation path: > >
Select the [Applications] register tab.
> The page displays the operating states of the PLC applications saved on the device.
58
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Operating states of the CODESYS PLC
>
8.3.2 Switch operating states 10264
Select one of the following actions to switch between the operating states: >
Start PLC application
18027
To start a PLC application stored on the device:
CODESYS:
In the project tree: highlight application as active application.
Use [Online] > [Login] to establish the connection with the CODESYS PLC.
Use [Debug] > [Start] to start the processing of the active application.
> Application goes into RUN state.
Optional: repeat process for further applications.
GUI / web interface:
Navigation path: > >
Select [Applications] tab.
Use [] / [] to select the requested application.
> Page shows the operating status of the selected application.
Use [Start] function key to start the processing of the selected application.
> Application goes into RUN state.
Optional: repeat process for further applications.
59
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Operating states of the CODESYS PLC
>
Stop PLC application
18029
To stop a PLC application stored on the device:
CODESYS:
In the project tree: highlight application as active application.
Use [Online] > [Login] to establish the connection with the CODESYS PLC.
Use [Debug] > [Stop] to stop the processing of the active application.
> Application goes into STOP state.
Optional: repeat process for further applications.
GUI / web interface:
Navigation path: > >
Select [Applications] tab.
Use [] / [] to select the requested application.
> Page shows the operating status of the selected application.
Use [Stop] function key to stop the processing of the selected application.
> Application goes into STOP state.
Optional: repeat process for further applications.
60
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Reset
>
8.4 Reset
Supports reset variants ...........................................................................................................................61 Reset PLC application ............................................................................................................................61
18025
61
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Reset
>
8.4.1 Supported reset variants 18613
The following table shows the reset variants supported by the device-internal CODESYS PLC and the resulting system behaviour:
Type of reset System behaviour Triggering actions
Reset (cold) Application changes to the STOP state
All variables (VAR, VAR RETAIN) of the application are initialised.
Download the application to the device
CODESYS command: Cold reset
Reset (warm) Application goes to STOP state
Standard variables (VAR) of the application are initialised
Remanent variables (VAR RETAIN) of the application keep their current values.
CODESYS command: Warm reset
GUI commands: Reset all applications
Device reboot
Reset (default) Application goes to STOP state
The application on the PLC is deleted
All variables (VAR, VAR RETAIN) of the application are initialised.
CODESYS PLC is reset to the original state
CODESYS command: Reset default
Firmware update
A variable that has been declared without an initialisation value is initialised with the standard initialisation value (e.g. INT = 0).
>
8.4.2 Reset PLC application 18028
To reset a PLC application stored on the device:
1 Connect with the device
In the project tree: highlight application as active application.
Use [Online] > [Login] to establish the connection with the CODESYS PLC.
> CODESYS is in the online mode.
2 Reset application with requested reset function
Select one of the following reset variants ( Supported reset variants ( page 61)):
Reset (warm): [Online] > [Reset warm]
Reset (cold): [Online] > [Reset cold]
Reset (default): [Online] > [Reset origin]
> Application is reset with the selected reset method.
62
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Display web visualisation
>
8.5 Display web visualisation 17063
To display the created web visualisation:
Requirements:
PC/laptop is connected to the configuration interface (X3) of the device ( device manual, paragraph Configuration interface: Connection concepts)
PLC application with web visualisation is stored and started on AC14nn ( Load application on AC14nn ( page 56)).
On PC/laptop: Start web browser.
Enter the following in the address line and confirm with [ENTER]: :/.htm
is the defined name of the web visualisation ( Change properties of the web visualisation ( page 52)).
> Web browser shows the web visualisation of the device.
63
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Operation Delete application from AC14nn
>
8.6 Delete application from AC14nn 18030
To delete an application stored on the device:
1 Connect with the device
In the project tree: highlight application as active application.
Connect with the device with [Online] > [Login].
> CODESYS is in the online mode.
2 Delete application
In the editor window: Select [Device] > [Applications] tab.
Refresh view with [Refresh List].
> List shows the names of the applications that are stored on the device.
Delete all applications in the device with [Remove All]. OR: Highlight requested application and delete with [Remove] from the device.
> Selected applications will be deleted.
64
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Annex Delete application from AC14nn
9 Annex
ifm AS-i function libraries ........................................................................................................................65 Acyclic data records .............................................................................................................................137 Command channels ..............................................................................................................................168
7156
65
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Annex ifm AS-i function libraries
>
9.1 ifm AS-i function libraries
ACnnnn_Utils.library ...............................................................................................................................66 ACnnnn_SYS_CMD.library ..................................................................................................................128
17128
66
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Annex ifm AS-i function libraries
>
9.1.1 ACnnnn_Utils.library
Overview: AS-i functions (FB_ASi) .........................................................................................................67 Overview: System functions (FB_System) ...........................................................................................112 Enumeration types and complex variables ...........................................................................................119
17722
67
ifm Programming Manual CODESYS for AS-i Fieldbus Gateways AC14nn Firmware 3.0.24 or higher 2015-04-23
Annex ifm AS-i function libraries
>
Overview: AS-i functions (FB_ASi)
Get_ASi_PHY_Dat .................................................................................................................................68 Get_LAS .................................................................................................................................................70 Get_LDS .................................................................................................................................................72 Get_LPS .................................................................................................................................................74 Get_LCE .................................................................................................................................................76 Get_LCEAS ............................................................................................................................................78 Get_LCEMS ...........................................................................................................................................80 Get_LDAE...............................................................................................................................................82 Get_LPF .................................................................................................................................................84 Get_CDI ..................................................................................................................................................86 Get_PCD ................................................................................................................................................88 Get_InputParameter ...............................................................................................................................90 Get_OutputParameter ............................................................................................................................92 Set_AddressMode ..................................................................................................................................94 Set_ASi_Config ......................................................................................................................................96 Set_LPS..................................................................................................................................................98 Set_Mode .............................................................................................................................................100 Set_PCD ...............................................................................................................................................101 Set_ProjectAll ...........................................................................