Display Ifm 1082
Display Ifm 1082
Display Ifm 1082
PDM360 NG Touch
CR1082
English
2015-08-27
7390994_01_UK
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Contents
Contents
2 Safety instructions 9
2.1 What previous knowledge is required? ..............................................................................10
2.2 Note! ...................................................................................................................................10
2.3 Start-up behaviour of the controller....................................................................................11
3 System description 12
3.1 Information about the device ..............................................................................................12
3.2 Hardware ............................................................................................................................13
3.2.1 Display elements ........................................................................................................................ 14
3.2.2 Operating elements .................................................................................................................... 15
3.2.3 Limitations for program and data memories ............................................................................... 16
3.2.4 Real-time clock (RTC) ................................................................................................................ 17
3.2.5 Camera visualisation .................................................................................................................. 18
3.3 Interfaces ...........................................................................................................................19
3.3.1 Inputs (technology) ..................................................................................................................... 20
3.3.2 Outputs (technology) .................................................................................................................. 23
3.3.3 CAN ............................................................................................................................................ 24
3.3.4 USB ............................................................................................................................................ 24
3.3.5 Ethernet ...................................................................................................................................... 24
3.3.6 Analogue video input .................................................................................................................. 25
3.4 Software description ..........................................................................................................26
3.4.1 Software components ................................................................................................................. 27
3.4.2 Programming system CODESYS 2.3 ......................................................................................... 28
3.4.3 ifm target package for CODESYS .............................................................................................. 28
3.4.4 Operating states ......................................................................................................................... 28
4 Installation 29
4.1 Install the CODESYS programming system ......................................................................30
4.2 Install the device-specific target package ..........................................................................30
4.3 Update the runtime system of the device ..........................................................................31
4.3.1 Notes .......................................................................................................................................... 32
4.3.2 Enter the recovery mode ............................................................................................................ 34
4.3.3 Update the runtime system......................................................................................................... 34
4.3.4 Configure IP parameter of ethernet interface ............................................................................. 37
4.3.5 Quit the recovery mode .............................................................................................................. 40
5 Device configuration 41
5.1 Enter the setup mode .........................................................................................................42
5.2 Operating instructions ........................................................................................................43
5.2.1 Key functionality ......................................................................................................................... 44
5.2.2 Navigation key ............................................................................................................................ 49
5.2.3 Touchscreen............................................................................................................................... 49
2
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Contents
6 Programming 85
6.1 Set the target system .........................................................................................................86
6.1.1 Create CODESYS project manually ........................................................................................... 87
6.1.2 Configure the controller .............................................................................................................. 88
6.1.3 Configure CAN interfaces ........................................................................................................... 89
6.1.4 Use access protection ................................................................................................................ 91
6.2 First steps ...........................................................................................................................93
6.2.1 Programming notes for CODESYS projects ............................................................................... 94
6.2.2 Create PLC program ................................................................................................................ 114
6.2.3 Add additional libraries ............................................................................................................. 115
6.2.4 Programming interfaces ........................................................................................................... 116
6.2.5 Save project in the device ........................................................................................................ 122
6.3 Configuration of the inputs and outputs ...........................................................................123
6.3.1 Notes ........................................................................................................................................ 124
6.3.2 Configure input ......................................................................................................................... 124
6.3.3 Configure output ....................................................................................................................... 124
6.4 Use visualisations ............................................................................................................125
6.4.1 Notes on visualisations ............................................................................................................. 126
6.4.2 Create visualisation .................................................................................................................. 132
6.4.3 Configuring functions of operating elements ............................................................................ 133
6.4.4 Use of optical and acustical feedback ...................................................................................... 136
6.4.5 Install fonts (true type fonts) ..................................................................................................... 137
6.5 Use of touch screen functions ..........................................................................................139
6.5.1 General notes ........................................................................................................................... 139
6.5.2 Process touch screen inputs .................................................................................................... 139
6.5.3 Use visual feedback ................................................................................................................. 141
6.5.4 Calibration of the touch screen ................................................................................................. 142
6.6 Install and set up mobile camera .....................................................................................143
6.6.1 Setup and operate Ethernet cameras ....................................................................................... 144
6.6.2 Setup and operate analogue cameras ..................................................................................... 148
3
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Contents
9 Annex 345
9.1 Address assignment in Ethernet networks ......................................................................346
9.2 System flags.....................................................................................................................347
9.2.1 System flags: system ............................................................................................................... 348
9.2.2 System flags: Inputs and Outputs ............................................................................................. 348
9.2.3 System flags: Status LED ......................................................................................................... 349
9.2.4 System flags: function keys ...................................................................................................... 350
9.2.5 System flags: navigation keys .................................................................................................. 351
9.2.6 System flags: error flags ........................................................................................................... 352
9.3 Possible operating modes inputs/outputs ........................................................................353
9.4 CANopen tables ...............................................................................................................354
9.4.1 Structure of CANopen messages ............................................................................................. 355
9.4.2 Boot-up message ..................................................................................................................... 360
9.4.3 Network management (NMT) ................................................................................................... 361
9.4.4 CANopen error code ................................................................................................................ 366
11 Index 379
4
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
About this manual Copyright
Copyright ..................................................................................................................................................6
Overview: documentation modules for ecomatmobile devices ................................................................6
CODESYS programming manual .............................................................................................................7
What do the symbols and formats mean? ................................................................................................7
How is this documentation structured? ....................................................................................................8
History of the instructions (CR1082) ......................................................................................................8
202
5
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
About this manual Copyright
>
1.1 Copyright
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
>
6
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
About this manual CODESYS programming manual
>
In the additional "Programming Manual for CODESYS V2.3" you obtain more details about the use of
the programming system.
This manual can be downloaded free of charge from ifm's website:
→ www.ifm.com > Select your country > [Service] > [Download] > [Systems for mobile machines]
You also find manuals and online help for ecomatmobile at:
→ ecomatmobile DVD "Software, tools and documentation"
>
WARNING
Death or serious irreversible injuries may result.
CAUTION
Slight reversible injuries may result.
NOTICE
Property damage is to be expected or may result.
7
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
About this manual How is this documentation structured?
>
This documentation is a combination of different types of manuals. It is for beginners and also a
reference for advanced users. This document is addressed to the programmers of the applications.
How to use this manual:
Refer to the table of contents to select a specific subject.
Using the index you can also quickly find a term you are looking for.
At the beginning of a chapter we will give you a brief overview of its contents.
Abbreviations and technical terms → Annex.
In case of malfunctions or uncertainties please contact the manufacturer at:
→ www.ifm.com > Select your country > [Contact].
We want to become even better! Each separate section has an identification number in the top right
corner. If you want to inform us about any inconsistencies, indicate this number with the title and the
language of this documentation. Thank you very much for your support!
We reserve the right to make alterations which can result in a change of contents of the
documentation. You can find the current version on ifm's website at:
→ www.ifm.com > Select country > [Data sheet search] > (Article no.) > [Operating instructions]
>
8
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Safety instructions History of the instructions (CR1082)
2 Safety instructions
9
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Safety instructions What previous knowledge is required?
>
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.
The document is intended for specialists. These specialists are people who are qualified by their
training and their experience to see risks and to avoid possible hazards that may be caused during
operation or maintenance of a 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 the document during the entire duration of use of the device.
Adhere to the safety instructions.
>
2.2 Note!
7328
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 personal 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]
10
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Safety instructions Start-up behaviour of the controller
NOTE
To ensure the protection rating:
- Cover the unused M12 sockets using the protective caps E73004!
- Permissible tightening torque of the protective caps = 0.6...0.8 Nm.
NOTICE
Danger of burn-in effects!
If the device is operated with the same visualisation for many hours, the image may be burned into the
screen.
► Operate the device with changing visualisations!
>
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!
11
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Information about the device
3 System description
>
These instructions describe the following models of the device familiy 'PDM360' from ifm electronic
gmbh:
PDM360 NG - 7": CR1082
Software release:
Runtime system: V02.03.xx
12
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
3.2 Hardware
13
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
Display
7362
Designation Data
Technology TFT
Screen diagonal 7" (15.7 cm)
Aspect ratio 15:9
Resolution 800 x 480 pixels
Colour depth 6 bits per colour channel = 18 bits = 262 144 representable colours
(Create the image as "True Color" with 24 bits)
>
Status-LED
7372
The intergrated status LED indicates the operating states of the device. By default the following colour
codes and flashing frequencies apply:
Colour and flashing frequency of the status LED can be programmed in the CODESYS
application.
14
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
Key LEDs
19468
All keys are seperately backlit by LEDs. The LEDs can be programmed in the CODESYS application.
Behaviour in Setup mode: → Key functionality (→ page 44)
>
The audio signalling device integrated into the device can be programmed in the CODESYS
application.
Tone duration (off, permanent tone, key click
Tone pitch (500...5000 Hz)
>
Function keys
with pressure point
backlit with programmable LEDs
Navigation key
as a combination of 5 independent keys
backlit with programmable LEDs
Touch screen
Resistive technology,
i.e. display reacts to pressure by fingers (can be also operated when wearing gloves) and
pens
direct selection and activation of GUI elements
15
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
Memory for bitmap files (80 x 100 pixels each, 24-bit colour depth)
45 Mbytes
Memory for font files
System need 75 Mbytes
legend:
1 ... Memory size: → data sheet
2 ... Retain data → Retain variables (→ page 96)
16
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
The device contains a real-time clock. During the system start the device synchronises the
(secondary) system clock with the (primary) real-time clock. The system clock can be used as follows:
• read the current clock time in the application program
• time stamp in (automatically generated) event protocols
• registration of operating times
Features of the real-time clock:
• is battery backed and continues to run in the switched-off device
• can be set to different UTC based time zones
• device monitors the charging status of the backup battery
The functions from the following libraries control the real-time clock or retrieve the values:
SysLibRtc.lib (3S)
This library offers functions to access the real-time clock of the device:
• reading and setting the real-time clock
• reading the current display mode
• checking the status of the battery
The processing is done synchronously.
SysLibTime.lib (3S)
This library is required for representing the task time evaluation in the task editor of CODESYS.
• reading the real-time clock of the device with the function blocks from this library
The processing is done synchronously.
17
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Hardware
>
18
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
3.3 Interfaces
14332
19
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
20
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
Operating modes
19930
>
Binary inputs
7345
In = pin binary-input n
(CR) = device
(1) = input filter
(2a) = input minus switching
(2b) = input plus switching
(3) = voltage
Figure: basic circuit of binary input minus switching / plus switching for negative and positive sensor signals
Basic circuit of binary input plus switching (BL) Basic circuit of binary input minus switching (BH)
for positive sensor signal: for negative sensor signal:
Input = open signal = low (GND) Input = open signal = high (supply)
21
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
Analogue inputs
7346
The analogue inputs can be configured via the application program. The measuring range can be set
as follows:
• current input 0...20 mA
• voltage input 0...10 V
• voltage input 0...32 V
If in the operating mode "0...32 V" the supply voltage is read back, the measurement can also be
performed ratiometrically. This means potentiometers or joysticks can be evaluated without additional
reference voltage. A fluctuation of the supply voltage then has no influence on this measured value.
In case of ratiometric measurement the connected sensors should be supplied with VBBS of the
device. So, faulty measurements caused by offset voltage are avoided.
8971
>
Contacts of Reed relays may be clogged (reversibly) if connected to the device inputs without
series resistor.
22
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
>
Binary output
19931
The device offers 1 output channel (OUT00). It can be operated as a binary, high side output.
23
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
3.3.3 CAN
The device has 4 CAN interfaces. They can be used to realize the following functions:
configurable as CAN Layer 2, CANopen Master/Slave, SAE J1939
Available protocols:
CAN interface CAN 1 CAN 2 CAN 3 CAN 4
>
3.3.4 USB
14326
The device offers 2 USB interfaces. They can be used to realize the following functions:
Connect USB memory to the device (supported file systems: FAT16, FAT32, VFAT, EXT2, EXT3)
Connect external devices to the device (keyboard, mouse)
>
3.3.5 Ethernet
14325
The device offers 1 Ethernet interface. It can be used to realize the following functions:
Download a application program from CODESYS to the device (programing interface)
Connect ethernet camera systems to the device
External access to the device:
– Telnet/FTP (unencrypted)
– SSH/SCP (encrypted)
24
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Interfaces
>
The device offers 2 analogue video inputs. They can be used to realize the following functions:
Connect analogue video camera systems to the device
Input signal: S-Video (FBAS); supported signals: PAL, NTSC
25
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Software description
26
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Software description
>
The device has the following software componentscommunicates with the hardware as below:
Software component Can user change the component? By means of what tool?
1
Operating system (Linux derivate) No ---
Upgrade yes
Runtime system (RTS) 2 Image file
Downgrade no
Application program
Yes CODESYS
with libraries
Legend:
1 ... The operating system will be changed partially while updating the runtime system of the device. Therefore, an
downgrade of the runtime system is not possible.
2 ... The runtime system version number must correspond to the target version number in the CODESYS target system
setting.
>
Runtime system
19093
Basic program in the device, establishes the connection between the hardware of the device and the
application program.
Normally it is necessary to download the runtime system only once. Then, the application program can
be loaded into the controller (also repeatedly) without affecting the runtime system.
ifm electronic maintains the runtime system and releases update packages. The user can download
the current release from the website of ifm electronic gmbh:
→ www.ifm.com > Select your country > [Service] > [Download]
>
Application program
15274
14118
Software specific to the application, implemented by the machine manufacturer, generally containing
logic sequences, limits and expressions that control the appropriate inputs, outputs, calculations and
decisions.
8340
WARNING
The user is responsible for the reliable function of the application programs he designed. If necessary,
he must additionally carry out an approval test by corresponding supervisory and test organisations
according to the national regulations.
The visualisation pages and embedded graphics are part of the CODESYS application program.
27
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
System description Software description
>
The user can create application programs for the CR1082 by using the programming system
CODESYS 2.3. In this manual we refer to the CODESYS version 2.3.9.25.
In the "programming manual CODESYS 2.3" you will find more details about how to use
the programming system "CODESYS for Automation Alliance". This manual can be
downloaded free of charge from ifm's website at:
→ www.ifm.com > Select your country > [Service] > [Download]
→ ecomatmobile DVD "Software, tools and documentation"
ifm electronic provides a device-specific target package for the programming system CODESYS 2.3.
By using the components included in the package the user can easily access the device functions.
The target package contains the following components:
device-specific target file (*.trg)
device configuration (*.cfg)
function libraries for programming according to IEC 61131-3
ifm-specific error messages
ifm-specific task configuration
>
28
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Software description
4 Installation
29
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Install the CODESYS programming system
>
► Download the installation file for CODESYS 2.3 from the ifm website.
→ www.ifm.com > Select your country > [Service] > [Download] > [Systems for mobile machines]
► Install the CODESYS 2.3 programming system on the PC/laptop (→ CODESYS software manual).
>
Detailed information on the device-specific target package: → ifm target package for
CODESYS (→ page 28)
30
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
Notes ......................................................................................................................................................32
Enter the recovery mode ........................................................................................................................34
Update the runtime system.....................................................................................................................34
Configure IP parameter of ethernet interface .........................................................................................37
Quit the recovery mode ..........................................................................................................................40
18159
31
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
4.3.1 Notes
32
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
The user can download the current version of the runtime system from the ifm website.
► Access the download from the ifm website.
(→ www.ifm.com > Select your country > [Service] > [Download] > [Systems for mobile machines])
► Download the ZIP archive with the update file and unzip (e.g. V020301_NoWD_PDM360NG.zip).
> The update file is stored on the PC/laptop (e.g. V020301_NoWD_PDM360NG.ifm).
>
>
During the update process the following software compknents of the device will be updated:
1. System software (Linux)
2. Firmware of the keys
3. Firmware of the I/O co-processor
4. Firmware if the watchdog co-processor
33
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
NOTICE
Risk of data loss!
Interrupting the update process can result in a loss of the user data stored in the device.
► Do not interrupt the update process!
The runtime system of the device can only be updated in the recovery mode.
The current version of the runtime system can be downloaded from the ifm electronic website
(→ Download the update file (→ page 33)).
34
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
The upgrade process may take a few minutes. Do not press any key on the device during the
upgrade process!
35
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
The upgrade process may take a few minutes. Do not press any key on the device during the
upgrade process!
36
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
In order to update the runtime system of the CR1082 via a network infrastructure, the device's
ethernet interface needs to be configured. The device provides the following options for configuration
of the ethernet interface:
Manual The operator sets the interface parameters (IP address, subnet mask,
gateway address) manually.
Automatic The interface parameters are set automatically by the network's DHCP
server (DHCP = Dynamic Host Configuration Protocol).
37
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
If successful:
> [Network Setup] menu page appears.
> Information bar shows active values of the IP parameters [IP-address], [netmask] und
[gateway].
> Device can be accessed via the IP network by using the shown parameters.
If not successful:
> Error message is displayed.
► Press [ESC] to return to the [Network Setup] menu page.
► Remove the error cause and repeat the procedure.
38
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
39
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Installation Update the runtime system of the device
>
If there is a valid project stored on the device, this project will be startet automatically
after completing the reboot process.
If there is no valid project stored on the device, the CR1082 automatically enters the
setup mode after completing the reboot process.
40
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Update the runtime system of the device
5 Device configuration
This chapter describes the configuration of the device in the setup mode.
41
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Enter the setup mode
>
If no valid application is stored in the device, the device passes automatically in the setup
mode after power on.
Submenu Description
42
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
43
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
The assignment of the function keys is context sensitive. The function of a key is described by the text
label of the corresponding button on the screen.
Only active function keys have a labeled button.
Only active function keys are backlit by the key LED.
The following table provides an overview of the available key functions:
44
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
45
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
► Use [SELECT] or [BACKSEL] to select the requested GUI element (i.e. number field, option field).
> The selected GUI element has a black frame.
> The selected GUI element is activated and can be changed.
► Use [ENTER] to activate / deactivate the selected GUI element (i.e. option field)
OR:
Use []/[] to increment/decrement the value of the selected GUI element (i.e. number field).
> The changes are displayed.
► Use [SAVE] to confirm and apply the changes.
► Use [EXIT] to change to the higher-level menu.
46
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
► Use [SELECT] to select a specific window (i.e. [Name], [Places], [Favorites] and [UP])
> The selected window is focused (black frame or dark-grey header).
► Use []/[] to select an specific item within the selected window (i.e. file, directory).
> The selected item has a light-grey background.
► Use [ENTER] to change into the selected directory.
OR
Start action according to key label (i.e. Use [RESTORE] to restore the data saved in the selected
backup file).
> Selected action is proceeded.
> Use [EXIT] to change to the higher-level menu.
47
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
The user interface of the runtime system has an on-screen keyboard. It appears automatically as soon
as the user is expected to enter characters.
The on-screen keyboard shows the German character set (QWERTZ keyboard layout).
To protect sensitive information only the character entered last appears in plain text. All other
characters are replaced by an *.
To enter a text:
► Use [] / [] and [] / [] to select the button of the requested character.
> The selected button is highlighted (black frame).
► Use [ENTER] to activate the selected button.
> The entered character appears in the input box.
► Repeat the process for all requested characters.
► Use [CONFIRM PASSWD] to confirm the entry
OR:
Use [EXIT] to cancel and return to the previous setup screen .
48
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
The keys of the navigation key can be used as an alternative as well as an equivalent to function keys.
The following table shows operating elements with the same function:
[] Move up
>
5.2.3 Touchscreen
18156
49
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
If the password protection is enabled, the operator has only accress to the following menu functions:
[SETUP] > [System Information]
[SETUP] > [ACTIONS] > [Keyboard Test]
[SETUP] > [ACTIONS] > [Calibrate Touchscreen]
50
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Operating instructions
>
Setup: Enter the password for full access to the setup menu
11759
Full access to all setup function is only valid until the user exits the setup menu.
► When the setup menu is called, enter the password again!
51
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
52
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The menu [SETUP] > [SYSTEM SETTINGS] provides access to the following functions:
53
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The device provides the following options for configuration of the Ethernet interface:
Manual The operator sets the interface parameters (IP address, subnet mask,
gateway address) manually.
Automatic The interface parameters are set automatically by the network's DHCP
server (DHCP = Dynamic Host Configuration Protocol).
54
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
2 Set IP parameters
► Use [SELECT] / [BACKSEL] to select the required number field.
► Use [] / [] to increment / decrement the number in the selected number field until the
requested value has been reached.
> Number field shows the required value.
► Optional: Repeat the procedure until the values in all number fields are correctly set.
3 Save changed values
► Press [SAVE] to confirm and save the changed values.
55
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
To use DHCP, the device must be connected to a DHCP server via the Ethernet interface.
To set the IP parameters of the Ethernet interface by means of the Dynamic Host Configuration
Protocol (DHCP).
1 Select menu page
► Navigation path: [SETUP] > [SYSTEM SETTINGS] > [ETHERNET] > [DHCP]
> Menu page displays the following information:
Bezeichung Bedeutung Mögliche Werte
[DHCP Client] Status of DHCP client of the device DHCP client disabled
[IP Address] IP address of the Ethernet interface of the device i.e. 192.68.82.247
If successful:
> [IP Address], [Netmask] and [Gateway] show valid values assigned by the DHCP server.
> Status message appears: DHCP configured successfully
If not successful:
> Status message appears: Failed to get DHCP lease!
► Use [EXIT] to stop the configuration process.
► Check the connection to the DHCP server!
► Repeat the configuration process (s.a.).
56
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
57
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
58
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The setup menu is always displayed with a 100 % brightness. The changed brightness
will only become effective outside the setup menu.
59
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The secure network services Secure Shell (SSH) and Secure Copy (SCP) are always
available. The user can therefore access the device via SSH and SCP if the network
services Telnet and FTP are inactive.
(→ Access the device with SSH (→ page 120), → Copy the files with SCP (→ page 121)).
Telnet disabled
[FTP] Enable / Disable the FTP service of the device FTP enabled
FTP disabled
60
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The menu page [SETUP] > [SYSTEM SETTINGS] > [PASSWORD SETTINGS] provides access to the
following options:
Setup: Change the system password (→ page 61)
Setup: Enable / Disable password protection (→ page 62)
>
Notes on operation of the on-screen keyboard: → Operation: Enter a text using the on-screen
keyboard (→ page 48)
61
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
If the password protection is enabled the operator has restricted access to the functions of the
setup menu (→ Setup: Working with enabled password protection (→ page 50)).
The password protection does not become active before the next call of the setup menu.
► Use [EXIT] repeatedly to change to the startscreen of the setup mode.
► Use [ENTER] to enter the setup menu.
62
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
63
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
The submenu [SETUP] > [ACTIONS] provides access to the following functions:
64
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
65
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
To test the CAN interfaces of the device, process one of the following functiions:
CAN test: Transmit data (→ page 66)
CAN test: Receive data (→ page 67)
>
► Set the test CAN message to be sent in hex format in [Tx Bytes (hex)].
► Set the test CAN message to be sent in hex format in [Tx Bytes (hex)].
4 Transmit test message
► Press [START] to start the transmission.
> Device tries to send the test message on the selected CAN interface.
> The number of the CAN messages sent since the beginning of the transfer appears in [Tx
Frame Counter].
If successful:
> Information bar displays confirmation message.
► Press [STOP] to finish the cyclic transmission of the test message.
If not successful:
> Information bar displays error message.
► Press [STOP] to finish the cyclic transmission of the test message.
► Check the CAN interface connection.
► Repeat the procedure.
66
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
If no baudrate of the CAN interface was set the test will be processed with 125 Kbits/s.
>
► Press [START] to start receiving messages on the selected CAN interface. (→ note)
> [Rx Bytes (hex)] displays the content of the received messages (hexadecimal value).
> [CAN Rx-Id (hex)] displays CAN ID related to the revceived message (hexadecimal value).
> [Rx Frame Counter] displays the number of messages received sicne the start of the
transmission.
If successful:
> [Rx Frame Counter] displays value > 0.
► Press [STOP] to finish receiving CAN messages.
If not successful:
> [Rx Frame Counter] displays value 0.
► Pres [STOP] to finish receiving CAN messages.
► Check the CAN interface connection.
► Repeat the procedure.
If no baudrate of the CAN interface was set the test will be processed with 125 Kbits/s.
67
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
Specifications for the image file, which is used as splash screen → Visualisation limits
(→ page 128)
[Load from USB device] Load the image file from a USB device
[Load from /tmp] Load the image file from the directory /tmp of the device
[Load from ...] Load the image file from a selectable directory
► Use [SELECT] / [BACKSEL] to select the requested menu item and press [ENTER] to confirm.
> Menu page displays the selected image source.
3 Set splash screen
► Select the requested image file.
> Selected image file has focus.
► Use [LOAD] to save the file in the device and to use the image as splash screen.
>
The user can define a user-defined splash screen. The image file has the following restricitions:
Parameter Restriction
68
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
To test the function of the keys, the key LEDs and the navigation switch:
1 Select menu page
► Navigation path: [SETUP] > [ACTIONS] > [KEYBOARD TEST]
> [Keyboard Test] menu page appears.
2 Test function keys
► Press any function key and keep it pressed.
> The key-related area on the screen is displayed brighter.
> The key LED is off.
3 Test navigation switch
► Use [OK] or [] / [] to switch between the two input fields of the group [Navigation Switch
Test].
> Selected field gets a black frame.
► Use [] / [] to increment / decrement the value displayed in the selected field.
69
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
To backup data stored on the device as well as to restore data to the device, the following options are
available:
Name Description
[BACKUP SYSTEM INFORMATION] Save the system information
(→ Backup: Save the system information (→ page 71))
[BACKUP SYSTEM] Save the system software
(→ Backup: Save the system files (→ page 72))
[RESTORE SYSTEM] Restore the system software
(→ Restore: Restore the system files (→ page 74))
70
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
► Use [SELECT] / [BACKSEL] to select the requested menu item and press [ENTER] to confirm.
> Menu page displays the content of the selected memory location.
3 Save the system information
► Select requested directory.
► Press [SAVE] to save the system information.
> Devices saves the file containing the system information in the selected directory.
71
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
WARNING
If the backup and the restore device have different runtime versions, the restoration of a backup file
can lead to an undefinable system behaviour of the PDM360 NG!
The runtime versions on the backup and restore devices must be identical.
► Ensure that the runtime systems on the backup and restore device are of the same version!
(→ Update the runtime system of the device (→ page 31))
► Use [SELECT] / [BACKSEL] to select the required components and press [ENTER] zu enable /
disable.
= Exclude software component from backup file
= Include software component in backup file
► Optional: Repeat procedure for additional software components.
Check [Select All] to include all software components in the backup file.
► Use [SELECT] / [BACKSEL] to select the requested menu item and press [ENTER] to confirm.
72
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
73
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
WARNING
If the backup and the restore device have different runtime versions, the restoration of a backup file
can lead to an undefinable system behaviour of the PDM360 NG!
The runtime versions on the backup and restore devices must be identical.
► Ensure that the runtime systems on the backup and restore device are of the same version!
(→ Update the runtime system of the device (→ page 31))
► Use the option "Auto Restore" for the automatic restoration of system files from a backup
file (→ Automatically restore system files (→ page 84)).
► Use [SELECT] / [BACKSEL] to select the memory location of the backup file and press
[ENTER] to confirm.
> Menu page displays content of selected memory location.
► Select backup file.
► Press [RESTORE] to load the selected backup file.
3 Select software components
> Menu page displays list of software components included in the backup file.
Software components not included in the backup file are geyed out!
► Use [SELECT] / [BACKSEL] to select the software components to be restored and press
[ENTER] to check / uncheck the option field:
= Exclude software component from restoring process
= Include software component in restoring process
► Optional: Repeat procedure for additional software components.
► Press [CONFIRM] to confirm the selection.
> Device restores the selected software components.
> Status bar displays progess of restoring process.
► If required, press [EXIT] to cancel the restoring process.
>
74
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
NOTICE
Risk of data loss on the USB device!
► Unmount USB devices before removing them from the runtime system!
► Do not remove the USB device before unmounting has been confirmed!
75
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
To manage font files (True Type Fonts) on the device, the following options are available:
Name Description
[LOAD FONT] Install font files on the device
(→ Fonts: Load the font (→ page 76))
[REMOVE FONT] Remove font files stored on the device
(→ Fonts: Remove the font (→ page 76))
>
► Use [SELECT] / [BACKSEL] to select the requested menu item and press [ENTER] to confirm.
> Menu page displays selected source.
3 Install font file
► Select the requested font file.
> Selected font file has focus.
► Press [LOAD] to save the selected font file on the device.
> After rebooting the device the installed font file can be used in CODESYS projects.
► Optional: Repeat steps 2 and 3 to install additional font file on the device.
>
76
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: start screen
>
NOTICE
Risk of data loss!
> When this action is confirmed, all user data in the directory /data of the storage medium is
irretrievably deleted!
► Save files that you will need to an external medium prior to formatting!
Use the backlit function key above the navigation keys to cancel calibration process.
77
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration PDF file viewer
>
The setup menu uitlises a PDF file viewer. The operator can use it to display PDF files stored in the
directories /home/pdf and /media.
To display a PDF file:
► Enter the setup mode (→ Enter the setup mode (→ page 42))
► Select [PDF-Viewer] menu item.
► Use [ENTER] to change to the PDF file viewer.
► Choose one of the following options:
78
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration PDF file viewer
>
► Select requested PDF file and press [ENTER] to open the file (→ Operation: Navigate in the file
directory (→ page 47)).
> PDF file is loaded.
> Display shows the content of the PDF file:
79
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration PDF file viewer
>
80
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration PDF file viewer
>
► Use [SELECT] / [BACKSEL] to select one of the following menu items and press [ENTER]:
[OPEN NEW PDF FILE] Open new PDF file
→ PDF file viewer (→ page 78)
[SHOW PDF FILE: Open the selected PDF file
/Verzeichnis/Dateiname] → PDF: Navigating in the PDF file (→ page 79)
[SHOW INDEX OF: Open index of the selected PDF file
/Verzeichnis/Dateiname] → PDF-Viewer: Display the tabel of content of the PDF file (→ page 82)
81
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration PDF file viewer
>
► Display PDF file in full-screen mode (→ PDF-Viewer: Display PDF file in full-screen mode (→ page 80)).
► Change to extended menu (→ PDF-Viewer: Display extended menu (→ page 81)).
► Select [SHOW INDEX OF: /Verzeichnis/Dateiname] menu item and press [ENTER].
> Menu page displays the tabel of contents of PDF file:
82
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Setup: Start the application
>
► Enter the setup mode (→ Enter the setup mode (→ page 42))
► Select [LOAD APPLICATION] button.
► Use [ENTER] to start the application.
83
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Device configuration Automatically restore system files
>
The function "Auto Restore" automatically identifies backup files saved in the root directory of a USB
memory device (*.bup) and restores their contents. Several devices can be easily and time-savingly
provided with the same software configuration (e.g. install a backup on controllers of the same type in
several vehicles).
1 Create a backup file
► Enter the setup modus (→ Enter the setup mode (→ page 42))
► Create backup of device configuration of the master device and store the backup file on an
USB memory device (→ Backup: Save the system files (→ page 72)).
The device only recognises backup files in the root directory of the USB memory device.
► Save the master backup file in the root directory of the USB memory device!
Only one backup file may be in the root directory of the USB memory device. If there
are several backup files in the root directory, the automatic restore process will be
stopped. An error message appears.
► Delete unneeded backup files in the root directory of the USB memory device!
► Connect the USB memory device with the master backup file with the target device
► Enter the setup mode (→ Enter the setup mode (→ page 42))
► Select [SETUP] and press [ENTER] to change in the setup menu.
> The setup automatically recognises the structure and contents of the backup file.
> The menu screen shows the system components contained in the backup file.
► Press [START] to start the restore process.
> The selected system components are transferred to the device.
If successful:
> The menu screen shows the completion message.
3 Reboot the device
► Press [REBOOT] to reboot the device.
> Device reboots.
> If a valid project is loaded, this project is started after rebooting.
If no valid project is loaded, the device enters the setup mode after rebooting.
>
84
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Exit setup, reboot device
6 Programming
This chapter describes the programming of the device with CODESYS 2.3.
85
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
86
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
When installing the ecomatmobile DVD "Software, tools and documentation", projects with
templates have been stored in the program directory of your PC:
...\ifm electronic\CoDeSys V2.3\Projects\Template_DVD_Vx.y
► Open the requested template in CODESYS via:
[Datei] > [Neu aus Vorlage…]
> CODESYS creates a new project which shows the basic program structure. It is strongly
recommended to follow the shown procedure.
1 Start CODESYS
► Double click on the program symbol "CoDeSys V2.3" on the Windows desktop
OR:
Activate [Start] > [All Programs] > [ifm electronic] > [CoDeSys V2.3] > [CoDeSys V2.3].
> The CODESYS programming environment appears.
2 Create a new project with CR1082
► Select [File] > [New].
> The window [Target Settings] appears.
► In the list [Configuration] select CR1082 and press [OK] to apply the selection.
When selecting the target system make sure that the target version matches the
version of the runtime system installed on the device!
> The window with the configuration options of the target system appears.
► Press [OK] to apply the basic settings.
3 Select the programming language
> The window [New POU] appears.
► Select type and programming language of the POU PLC_PRG and press [OK] to confirm.
> From the target file, CODESYS loads the description of the device hardware, the default
configuration of the device and the standard libraries with important basic functions.
> The program editor appears with the opened POU PLC_PRG.
4 Save the project
► Save the project with [File] > [Save as ...].
87
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
In the PLC configuration the programmer can configure the target system.
To access the PLC configuration:
► In the project organizer select the tab [Ressourcen]:
The programmer configures the input of the device directly in the PLC application!
(→ Configuration of the inputs and outputs (→ page 123))
88
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
The CR1082 is designed as a display for representing process data. It is thus conditionally
real-time capable. Computationally intensive processes can cause long cycle times!
► Avoid computationally intensive functions (controller, encoder, control of diesel engines,
operation as CANopen master)!
► Monitor the cycle time during the runtime of the PLC program! Cycle times in the range
from 5 ... 10 ms are no problem.
The device can be configured either as CANopen master or CanSlave. The configuration is carried out
in the PLC configuration (→. Configure the controller (→ page 88)).
>
Information on the configuration options: → System manual, chapter Using CAN – description
89
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
Information on the configuration options: → System manual, chapter Using CAN – description
90
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
91
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Set the target system
>
The access protection for the IEC project is set/changed in CODESYS via the PLC browser.
The password to protect the IEC project does not have to be identical with the password to
protect the Linux runtime system.
Additional information about the command setpwd and to delete the password for the
protection of the IEC project: → CODESYS help function.
92
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
93
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
94
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
NOTE
Function blocks must NOT be called in functions!
Otherwise: During execution the application program will crash.
All function elements must NOT be called recursively, nor indirectly!
An IEC application must contain max. 8,000 function elements!
Background:
All variables of functions...
• are initialised when called and
• become invalid after return to the caller.
Function blocks have 2 calls:
• an initialisation call and
• the actual call to do something.
Consequently that means for the FB call in a function:
• every time there is an additional initialisation call and
• the data of the last call gets lost.
95
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Variables
11739
>
Retain variables
3131
Variables declared as RETAIN generate remanent data. Retain variables keep the values saved in
them when the device is switched on/off or when an online reset is made.
14166
96
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Global network variables are used for data exchange between controllers in the network. The values
of global network variables are available to all CoDeSys projects in the whole network if the variables
are contained in their declaration lists.
A distinction is made between export and import variables:
Export variables originate from the local project.
Their values can be influenced locally.
It is also to be possible to use the variables in one or more other projects, but only with read
access. To do so, these variables must be exported (provided) from the local project.
Import variables do not originate from the local project but from another project.
Their values cannot be influenced locally.
The variables are used with read access in the local project (and possibly also in several other
projects). To do so, these variables must be imported into the corresponding local project.
► To export or import, the global network variables must be combined in lists. You can assign an
EXP file to every global variable list.
In this example each project has 3 lists of global network variables:
- 1 list with export variables (with local data for reading in other controllers) and
- 2 lists with import variables (with data of the other controllers for local reading).
► When you create a global variable list please note:
By selecting [Export before compile] in the window [Properties] CoDeSys updates the
corresponding EXP file (e.g. ExportProj1.exp) when the project is compiled.
By selecting [Import before compile] in the window [Properties], CoDeSys refers to the
corresponding EXP file (e.g. ExportProj1.exp) when the project is compiled, and updates
the list.
UDP (User Datagram Protocol) is a minimal connectionless network protocol belonging to the
transport layer of the internet protocol family. The task of UDP is to pass data which is transmitted via
the internet to the right application.
Example:
Information is to be exchanged between 3 devices (controller/PDM) and 1 PC. This is done by means
of the "global network variables" ( figure below). The example only shows the variables x1, x2 and
x3 in the global network variable lists of the corresponding projects.
97
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
The project "DemoProj1" contains the global network variable list "Global_Variables_Export_Proj1".
► In the properties of this list enter the file ExportProj1.exp.
► Activate [Export before compile].
> When this project is compiled, ExportProj1.exp is updated.
The project "DemoProj2" contains the global network variable list "Global_Variables_Import_Proj1".
► In the properties of this list enter the file ExportProj1.exp.
► Activate [Import before compile].
> When compilation of this project starts, the list "Globale_Variablen_Import_Proj1" is updated by
means of the file ExportProj.exp and then used for the compilation.
NOTE
If a project with variables to be exported is changed, all projects which import these global network
variable lists must then be rebuilt to update the lists:
► Menu [Project] > [Rebuild all]
► Menu [Online] > [Create boot project]
> The boot project is saved in the controller/PDM.
98
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
When a new project is created in CoDeSys the target file corresponding to the controller must be
loaded. It is selected in the dialogue window for every hardware and acts as an interface to the
hardware for the programming system.
► Add the entries shown on the following screenshot to the program POU PLC_PRG:
99
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
► With [File] > [Save as ...] save the project in the requested directory.
Here: filename = "DemoProj1" (for the first device in the network)
>
The same communication parameters must be set for the PC, the device (controller/PDM) and the
project.
► Open the following dialogue with [Online] > [Communication Parameters...].
> The following window appears:
► Click [New…]
> The following window appears:
100
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
► Enter the corresponding IP address of the controller (compare with step 2).
► applies only to the following devices:
- PDM360: CR1050, CR1051
- PDM360compact: CR1052, CR1053, CR1055, CR1056:
Set [Motorola byteorder] = YES.
► Confirm with [OK].
>
101
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Integrate libraries
3633
102
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
To demonstrate the exchange of data via global network variables, write one project each for all three
devices. These projects are suitable for this purpose mainly because of the contained global variable
lists.
The example shows the project for device 1.
► Click on the tab [Resources] in CoDeSys.
► Select (= click) the entry [Global Variables]:
103
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
104
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
NOTE
In the field [Link to file] > [Filename] it is expected to indicate an EXP file. (After [Project] > [Rebuild
all]) this external file contains the list of global network variables of this project to be exported, but is
NOT saved together with the project. ( CoDeSys online help).
We recommend another method which integrates the lists of global network variables in the project:
Write projects for more devices (→ page 106) > create import lists.
Here you see that the COB ID = 51 was assigned to the export variables of DemoProj1 in device 1
and that these variables can be found again with the COB ID = 51 in DemoProj2 and DemoProj3 in
device 2 and device 3. In this example we have used this procedure for the definition of the COB IDs.
NOTE
For the selection of the COB IDs observe the following:
The export list and its corresponding import lists must be assigned to the same COB ID.
In the whole network each COB ID may only be assigned to one export list.
105
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
Also create export lists for the projects DemoProj2 and DemoProj3.
► Now create corresponding projects with export lists for the two other devices: DemoProj2.pro and
DemoProj3.pro. These files are necessary for the following steps.
Filenames and entries following table:
Device Project filename Global variable list to be exported COB ID Global variable
106
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
107
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
► From the menu "[Project] > [Merge…]" repeat the process with DemoProj3.pro and its export list.
> The resources in DemoProj1.pro are now as follows:
108
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Transmit projects
3654
► Check whether all 3 devices together with the PC are available with their corresponding IP
addresses in the LAN.
► Transmit the 3 created projects DemoProj1...3 to the corresponding devices.
► Start these projects there.
>
► Check the behaviour of the data transmission by looking at the corresponding global variable lists.
If, for example, in the project DemoProj1.pro you open the variable list
"Globale_Variablen_Import_Proj2", you should note that the value of x2 is increasing.
► Also check the other projects and make sure that the transmission of the global variables in the
network functions.
109
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
System flags
18107
System flags are factory set global variables. System flags are mapped to IEC addresses (%Ixx,
%Qxx). The programmer can access the following elemnts by using symbol names in the program
code:
Inputs and outputs
Functions of the input elements
Functions of the display elements
States of system components and characteristic values
Further infomration about system flags of the device: → System flags (→ page 347)
>
Libraries
7425
ifm electronic provides the following device-specific function libraries for programming the CR1082
using CODESYS 2.3:
Library Description
Further information about the ifm function libraries: → ifm libraries for the device CR1082
(→ page 156)
To add additional libraries to a CODESYS project: → Add additional libraries (→ page 115)
110
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
For the programmable devices from the controller family ecomatmobile numerous functions are
available which enable use of the devices in a wide range of applications.
As these units use more or fewer system resources depending on their complexity it is not always
possible to use all units at the same time and several times.
NOTICE
Risk that the device acts too slowly!
Cycle time must not become too long!
► When designing the application program the above-mentioned recommendations must be
complied with and tested.
► If necessary, the cycle time must be optimised by restructuring the software and the system
set-up.
>
Watchdog behaviour
11789
In this device a watchdog monitors the runtime of system processes, including the process of the
CODESYS application. Each process has to call the wathcdog monitor within a defined time intervall.
If the maximum watchdog time is exceeded:
> all processes are stopped (reset)
> all outputs are switched off
> the screen goes black
> the status LED flashes red at 5 Hz
A process needs a certain time to proceed reset and initialisation routines (watchdog reset).
The following tabel shows the watchdog times for each process:
111
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Operating sequence
7427
In principle, there are two options to create a project for display devices:
In both cases we urgently recommend to design a precise structure of the visualisation and its
contents before starting.
112
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
The application program is generated by the CODESYS programming system and loaded in the
controller several times during the program development for testing:
In CODESYS: [Online] > [Login] > load the new program.
For each such download via CODESYS the source code is translated again. The result is that each
time a new checksum is formed in the controller memory. This process is also permissible for safety
controllers until the release of the software.
113
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
Only some networks are necessary for an executable program. You do not need any special function
block to be able to use important device functions. All monitor functions you can control via system
variables in the PLC configuration ( System flags (→ page 347)).
114
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
For the CR1082, ifm electronic provides additional CODESYS libraries, that contain device-specific
functions. The libraries will be installed together with the target package of the device (→ ifm libraries
for the device CR1082 (→ page 156)).
The release numbers of the libraries and the target package must be equal.
V version
xx: 00...99 target version number
yy: 00...99 release number
zz: 00...99 patch number
The basic file name (e.g. "CR1082") and the software version number "xx" (e.g. "04") must
always have the same value! Otherwise the device goes to the STOP mode.
The values for "yy" (release number) and "zz" (patch number) do not have to match.
115
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
116
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
The device can be programmed over the Ethernet interface (Position of the connectors: → Installation
instrcution).
Device and CODESYS pc/laptop can be connected directly oder via a ethernet network.
► Only use recommended accessories! (→ Installation instruction)
► For the connection in the network an experienced user or system administrator should set
up the network addresses and do the configuration.
The device and the pc/laptop need to belong to the same ip address space.
► Note the settings of the IP address and the subnet mask! (→ Address assignment in Ethernet
networks (→ page 346))
117
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
118
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
To access the Linux runtime system of the device directly via the Ethernet inerface, use one of the
following options.
119
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
► Download the Telnet client and install it on the PC (e.g. PuTTY → the operating system of the
Telnet client
► Start the Telnet client
> The program window appears
► Use the following parameters to create a new connection profile:
- PC name/IP address: 192.168.82.247
- Port: 23
- Transfer protocol: Telnet
► Establish a connection to the device with the created connection profile
> The program window with a prompt appears.
► Enter the following details and confirm with [ENTER]
- User name/login: root
- Password: pdm360ng
> The prompt of the root directory # appears
► Enter the requested command
► When done, enter exit in the prompt and confirm with [ENTER]
> The program window is closed
>
To establish a secure terminal connection between the PC and the device, proceed as follows:
► Download the SSH client and install it on the PC (e.g. PuTTY (→ www.putty.org))
► Establish an Ethernet connection between the PC and the device.
► If necessary, adapt the IP network settings of the PC and/or the device.
→ Help function of the PC operating system
→ Setup: Configure the IP parameters manually (→ page 55)
► Start the SSH client
► Use the following parameters to create a new connection profile:
- IP address = 192.168.82.247
- Connection type = SSH
- Port number = 22
► Save the connection profile
► Establish a secure connection between the PC and the device with the saved connection profile
> A safety note appears
► Confirm the safety note
> The terminal window appears
► Enter the following details and confirm with [Enter]:
- login as: = root
- root@192.168.82.247' password: pdm360ng
> The success message Welcome using SSH/SCP on IFM PDM360NG ! appears
► Execute the requested commands in the command line
→ Help function of the SSH client
► When done, separate the secure connection with [Shift]+[Strg]+[D]
120
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
>
For some purposes an FTP connection between the PC and the device can be useful:
- Quick data transmission
- Connection also possible via the internet
- If no access to the USB port is possible
In case of doubt or problems please contact your system administrator.
► Establish an Ethernet connection between the PC and the device.
► The PC and the device must have compatible IP addresses and the same subnet mask.
→ Setup: Configure the IP parameters manually (→ page 55).
► Start the file manager on the PC.
► Enter the IP address of the device and, if needed, the requested directory as target address
following "ftp://", e.g.
ftp://192.168.82.247/home (default IP address in the device)
► After a right-click in the right space of the file manager click [Login as...] in the context menu.
> The dialogue [Login as...] opens.
► Enter the following:
- User name = root
- Password = pdm360ng
► Connect with the device with mouse click on [Login]
► Copy the requested files
► Close the file manager to disconnect the FTP connection.
>
To transfer files via a secure SCP connection (Secure CoPy) between the device and the PC, proceed
as follows:
► Download the SCP client and install it on the PC (e.g. WinSCP (→ www.winscp.net))
► Establish an Ethernet connection between the PC and the device.
► If necessary, adapt the IP network settings of the PC and/or the device.
→ Help function of the PC operating system
→ Setup: Configure the IP parameters manually (→ page 55)
► Start the SCP client
► Use the following parameters to create a new connection profile:
- IP address = 192.168.82.247
- Connection type = SCP
- Port number = 22
- User name/Login = root
- Password = pdm360ng
► Save the connection profile
► Establish a secure connection between the PC and the device with the saved connection profile
> The program windows with the file systems of the PC and the device appear
► Copy the requested files
→ Help function of the SCP client
► When done, separate the secure connection
► End the SCP client
>
121
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming First steps
Requirements:
Device and CODESYS pc/laptop are connected via ethernet interfaces.
Programming interface is set.
1 Compile project
► Use [Project] > [Rebuild All] to compile the program code for the device.
> After all libraries and variables have been inserted and parameterised as described, no error
messages should appear.
If a project was changed (or a new one created) it must be cleaned before transferring it to the
device. Without cleaning, the program can become unstable due to memory overflow.
► Use [Project] > [Clean all] to clean the project.
> During cleaning, all program elements are reorganised and combined thus reducing the
volume.
The program code is saved on the device in the directory /home/projects. With another
download project files already on the device are not loaded again.
► To delete the project files in the directory /home/projects, use [Online] > [Reset
(source)].
122
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Configuration of the inputs and outputs
>
Notes ....................................................................................................................................................124
Configure input .....................................................................................................................................124
Configure output ...................................................................................................................................124
7308
1394
For some devices of the ecomatmobile controller family, additional diagnostic functions can be
activated for the inputs and outputs. So, the corresponding input and output signal can be monitored
and the application program can react in case of a fault.
Depending on the input and output, certain marginal conditions must be taken into account when
using the diagnosis:
► It must be checked by means of the data sheet if the device used has the described input and
output groups (→ data sheet).
Constants are predefined (e.g. IN_DIGITAL_H) in the device libraries (ifm_CR1082_Vxxyyzz.LIB
) for the configuration of the inputs and outputs.
For details → Possible operating modes inputs/outputs (→ page 353).
123
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Configuration of the inputs and outputs
>
6.3.1 Notes
19934
>
Presets
13348
All inputs and outputs are factory set to binary, plus switching (BH).
The diagnostics function is disabled.
The overload protection is enabled.
>
The active configuration of the inputs and outputs can be displayed via the system flags IN00 and
OUT00.
Detailed information on the system flags: → System flags: Inputs and Outputs (→ page 348)
>
The inputs are configured usign teh function block INPUT in the application program.
>
The operting mode of the output is fixed (binary, plus switching (BH)).
124
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
125
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
>
Drawing area
YS_OBJECTID>
The images used in the project can be larger than the given drawing area. In this case only a
selectable part of the image will be displayed.
>
If an image is loaded in the device which does not meet the requirements for size or colour, it is
resized before it is displayed and the colours used are "checked".
Each time the image is opened, it must be resampled. This often leads to much longer times to
change from one image to the other. Corrective measures:
► First carry out all transformations of the bitmap or the image in an image processing program on
your computer.
Only for BasicDisplay: The colour palette is adapted when the image is integrated into the project
by CODESYS. On the device itself no adaptations will be made (size, scaling, colour).
► Only save the suitably transformed images in the visualisation of the device.
>
Texts
7428
The smallest font size which is clearly visible on the device is 8 points.
Permissible fonts (true type fonts):
- Arial (standard)
- Courier New
- Times New Roman
- ifm ISO symbols
- Loadable fonts
Install all required fonts on the PC!
Permissible font size:
- Standard = 10 pixels
- Max. = 72 Pixels
- Permissible nuances = 1 pixel
126
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
127
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
Visualisation limits
128
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
Designation Limitation
129
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
Legend:
+ ... can be used without problem
o ... can be used with restrictions
– .... cannot be used
It is allowed to save colour bitmaps with a colour depth of 18 bits (max. 24 bits).
Some visualisations with the CODESYS options are not very satisfactory, e.g. round scales.
Solution:
Integrate the requested elements as (an externally generated) BMP graphic. It is then sufficient to
turn an arrow in the visualisation depending on values which could change its colour if limit values
are exceeded.
>
Movement of elements
7392
Image and text elements can be moved on the display in a defined manner.
131
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
132
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
The signals of the navigation key are evaluated independently of the signals of the
function keys and the touch screen.
The device detects several simultaneously pressed function keys and evaluates them.
When the function key is permanently activated, the device generates a key pulse
sequence (after an adjustable waiting time).
>
The following tasks have to be solved in the visualisations of the application program:
• jump to the visualisation pages,
• change parameter values in the input fields,
• confirm messages.
To do so, the ecomatmobile PDM devices provide a number of operating elements.
For the devices of the PDM families you can assign functions to certain operating elements or signals.
There are several ways to do so which can also be combined in some cases:
System variables in the PLC configuration
→ Use edit controls (→ page 135)
Library ifm_PDM_INPUT_Vxxyyzz.lib (contains FBs to manage input fields)
→ POUs: Manage visualisation (→ page 198)
CODESYS dialogue [Elements configuration]
→ CODESYS user manual
Functions and function elements created by the user
133
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
The operating elements of the device are systematically numbered internally. In order to read or to
change the states of the input elements, the user can easily use symbol names in the programming
code of CODESYS.
The following figure shows the assignment of the individual operating elements with system flags:
>
For each key of the device the system detects the following events. Using the results of this detection,
the system generates signals and maps them to system flags:
134
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
ifm provides the programmer with "edit controls". You can link functions to operating elements using
system variables in the PLC configuration.
For normal mode:
MD_KEYx_y Assignment of key y in the group of keys x (preset)
>
IF Init =TRUE
THEN
(* Default Mapping ( MD ) *)
MD_KEY3_right:= 'TAB'; (* jump to next element foreward *)
MD_KEY3_left:='SHIFT_TAB'; (* jump to next element backwards *)
MD_KEY3_push:='SPACE'; (* select the element *)
(* Edit Mapping/ Edit mode ( ME )*)
ME_KEY3_UP:='UP'; (* Increment value *)
ME_KEY3_DOWN:='DOWN'; (* Decrement value *)
ME_KEY3_LEFT:='LEFT'; (* Move left on the value position *)
ME_KEY3_RIGHT:='RIGHT'; (* Move right on the value position *)
ME_KEY3_PUSH:='SPACE'; (* Take over value *)
ME_KEY1_5:= 'ESCAPE'; (* Exit edit mode *)
END_IF
135
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
All operating elements are backlit withLEDs. The LEDs can be controlledin the application
program.
► Only switch those key LEDs in the program which can be sensibly actuated in the
current screen.
For all keys currently without function:
► Switch off keys LEDs in the program.
Request to press a certain key:
► Programm the key LED so that it flashes.
Night design of the operating elements:
The LEDs for alle operating elements are dimmable.
For operating at night the LEDs have ONE adjustable basic brightness for all operating
elements. So the operating elements are also backlit if the key LEDs were not switched
on.
>
To generate an optical feedback indicating, which key can be used for user input, the programmer can
use the key LEDs. The following options are available:
>
Control buzzer
11543
To generate an acoustical feedback indicating user inputs, the programmer can use the
device-internal buzzer. The following options are available:
136
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
The character sets supplied by the factory (fonts) are not sufficient for all applications. Here we show
you the example "Cyrillic" to learn how to add more character sets.
NOTICE
If after the installation of large fonts (e.g. Chinese fonts) a device with a CODESYS application is
restarted, the watchdog may be activated!
Reason: It takes some seconds until the new font is initialised.
► Start the device once in the setup mode (→ Enter the setup mode (→ page 42)).
137
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use visualisations
>
Symbol files
14522
The unit is factory preset with the ISO symbols. An overview and explanations of the installed symbols
is given in the file ifm_iso-documentation.pdf (→ ecomatmobile DVD "Software, tools and
documentation" or on your hard disk in the CODESYS installation directory
Targets\ifm\Library\Fonts\ifm_ISO.
Example: ifm_iso_f.ttf
138
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use of touch screen functions
>
>
Operation of the touch screen can be programmed in CODESYS with standard input functions or via
PLC code.
The following table compares the two methods.
Flexibility Programmer is bound to defined functions Flexible interaction between user interface and
application program possible
Response time to input Fast reaction of the visualisation because Response time bound to PLC cycle
event-based processing irrespective of the PLC
cycle
Programming Low; simple creation of user interfaces Increased programming complexity
complexity
suitable for All groups of users Experienced programmers
139
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use of touch screen functions
>
CODESYS offers different input functions to define how elements of the graphical user interface (e.g.
buttons) react to actuation of the touch screen.
To access the input functions in CODESYS:
1 Preperations
► Create/open CODESYS project.
► Create new visualisation and create a new object (→ Create visualisation (→ page 132))
2 Configure input function
► Selelct created object.
► Select [Extras] > [Configure].
> The [Regular Element Configuration] window appears.
► Select the [Input] item in the [Category] field.
> [Input] group shows options for input configuration:
Option Description Possible values
[Toggle variable] The state of the Boolean variable is = function disabled
changed when the visualisation object is
touched (= switch mode) = function enabled
[Text input of variable The element activated in the list box = function disabled
'Textdisplay'] appears when the visualisation object is
touched. The value will be written into the = function enabled
varibale defined in the category
[Variables] > [Textdisplay]
List Selection of input element [Text] = input field
[Numpad] = Number pad
[Keypad] = On-screen keyboard (German key
assignment)
140
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use of touch screen functions
>
To get an feedback from the system in case the display is getting touched, the programmer can use
the global data structure PointOfContact. It provides the following functions:
Variable Funktion
PointOfContact.AfterGlow Show/hide pressure point
>
CODESYS offers the following options to create visual feedback for graphical operating elements:
Option Description
Input element "button" The appearance of the button automatically changes when the button is activated or
deactivated. The programmer does not have to make additional settings.
Change between two bitmaps 2 different bitmaps exist for each condition (activated, deactivated) of an input element.
Both graphics are positioned congruently on 2 visualisation levels. When the operating
element is activated, the bitmap graphics is switched to invisible for the inactive
condition.
Touch event on bitmap A touch event triggers a reaction when the input element is activated.
Change of the frame colour The input element has a frame. When deactivated, the frame is colourless or in neutral
colours. The frame colour changes when the frame is activated.
141
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Use of touch screen functions
>
To be able to calibrate the touch screen from a PLC application, carry out the following changes in the
CODESYS project:
1 Create visualisation page
► Open / Create a project.
► Create an empty visualisati→ page with the designation TOUCHCALIBRATION (→ Create
visualisation (→ page 132))
2 Insert control code in PLC application
► Define a condition for access to the visualisati→ page TOUCHCALIBRATION.
► Define the visualisati→ page which will be opened after successful calibration.
► Define the condition for the cancellation of the calibration process (e.g. change to the
visualisati→ page y when the function x is pressed)
Notes on use:
The calibration process is automatically started when the operator opens the
visualisati→ page TOUCHCALIBRATION.
► Follow the instructions on the screen (→ Setup: Calibrate the touchscreen (→ page 77))!
> When the calibration process is cancelled: The values of the last successful calibration apply.
> When the calibration process has been successfully completed: The touch screen is
recalibrated.
The calibration process can only be cancelled as long as the operator has not yet touched the
last cross in the centre of the screen!
The new values apply immediately upon completion of the calibration process! It is not
necessary to reboot the device.
142
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
143
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
1 Create visualisation
► Open CODESYS project.
► In the Object Organizer, select the [Visualizations] tab
► Create a new visualisation object.
> The drawing area appears.
2 Insert placeholder for camera image
► Select [Insert] > [Bitmap].
► Drag out the contour of the planned camera image on the drawing area.
> The [Open] window appears.
► Select the file camera.bmp in the subdirectory ..\targets\ifm\library\bmp_ng.
> The placeholder graphic is inserted into the drawing area.
> Press [OK] to close the window.
3 Set size and position of the camera image
► Select [Extras] > [Elementlist...].
> [Element list] window appears.
► Select the requested image.
► Under [Position] enter the following values:
Parameter Description Possible values
X X coordinate of the upper left corner of the image i.e. 290
Y Y coordinate of the upper left corner of the image i.e. 220
Width Width of the displayed image (in pixels) recommended: 320
max.: 640
Image resolutions that are in the range between recommended and maximum image
resolution or above the maximum image resolution, cause a high CPU load.
► Avoid to set such values!
Only the visible area of the display can be used for the camera image (→ datasheet,
resoltution of the display). Images outside this area (in the non-visible area) are ignored.
Instead the image is represented at the last valid position. If there was no valid position, NO
image is represented.
► Press [OK] to apply the entered values and close the window.
144
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
The variables entered must be declared. Afterwards they can be used for programming
the application.
>
145
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
146
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
Only the visible area of the display can be used for the camera image (→ datasheet,
resoltution of the display). Images outside this area (in the non-visible area) are ignored.
Instead the image is represented at the last valid position. If there was no valid position, NO
image is represented.
147
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
System standard Number of image lines Number of image colums Aspect ratio
PAL 720 576 5:4
NTSC 720 480 3:2
The CR1082 supports the following display modes for analog cameras:
Place the camera image only in the visible area of the display (datasheet, display resolution)!
Images outside the visible area will be ignored.
148
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
The original image can only be scaled in any manner as full-size image, also asymmetrically.
Original image:
149
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
Original image:
150
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
1 Create visualisation
► Open CODESYS project.
► In the Object Organizer, select the [Visualizations] tab
► Create a new visualisation object.
> The drawing area appears.
2 Insert placeholder for camera image
► Select [Insert] > [Bitmap].
► Drag out the contour of the planned camera image on the drawing area.
> The [Open] window appears.
► Select the file camera.bmp in the subdirectory ..\targets\ifm\library\bmp_ng.
> The placeholder graphic is inserted into the drawing area.
> Press [OK] to close the window.
3 Set size and position of the camera image
► Select [Extras] > [Elementlist...].
> [Element list] window appears.
► Select the requested image.
► Under [Position] enter the following values:
Parameter Description Possible values
X X coordinate of the upper left corner of the image e.g. 290
Y Y coordinate of the upper left corner of the image e.g. 220
Width Width of the displayed image (in pixels) recommended (PAL): 360
max.: 720
Height Height of the displayed image (in pixels) recommended (PAL): 288
max: 576
Image resolutions that are in the range between recommended and maximum image
resolution or above the maximum image resolution, cause a high CPU load.
► Avoid to set such values!
Only the visible area of the display can be used for the camera image (→ datasheet,
resoltution of the display). Positions outside this area (in the non-visible area) are ignored.
► Press [OK] to apply the entered values and close the window.
151
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
The variables entered must be declared. Afterwards they can be used for programming
the application.
>
► Use lower-case and upper-case letters when entering the parameter values!
>
>
>
152
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
invalid target area The camera image is not completely Check the settings of the camera
in the visible area of the display → Insert an analogue camera image in a CODESYS
project (→ page 151)
invalid rotation angle The indicated angle of rotation is Check the settings of the camera
invalid → Rotate the camera image (→ page 152)
valid angles: 0°, 90°, 180° and 270°
framebuffer or plane During setup of the analogue Set the boolean variable for switching the analogue
can't be used camera an Ethernet camera is camera on and off to FALSE
exclusively already running in the overlay mode → Switch the camera on/off (→ page 146)
(the analogue camera is not
switched on)
>
153
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Programming Install and set up mobile camera
>
Only the visible area of the display can be used for the camera image (→ datasheet,
resoltution of the display). Positions outside this area (in the non-visible area) are ignored.
154
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements Install and set up mobile camera
All CODESYS function elements (FBs, PRGs, FUNs) are stored in libraries. Below you will find a list of
all the ifm libraries you can use with this device.
This is followed by a description of the function elements, sorted by topic.
155
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
156
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
BUZZER_CLICK (→ page 194) FUN generate acoustic signal using device-internal buzzer
BUZZER_ON (→ page 195) FB generate tone using devcie-internal buzzer
GET_DEVICE_SERIAL FB read serial number of the device
(→ page 176)
GET_ETHERNET (→ page 177) FB read IP parameters of the Ethernet interface
GET_VERSIONS (→ page 179) FB read release numbers of the software components of the device
INPUT (→ page 166) FB set the operating mode of the input channel
KEY_CLICK (→ page 196) FB generate click when key is pressed
LOAD_SPLASH_SCREEN FB define splash screen image
(→ page 171)
SET_BOOTUP_BACKLIGHT FUN set brightness of the display
(→ page 170)
SET_ETHERNET (→ page 168) FB set IP parameters of the Ethernet interface
Legend:
GV ... Global variable
FB ... Function block
FUN ... Function
PRG ... Program
157
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
>
158
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
>
>
>
159
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
160
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
161
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
162
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm libraries for the device CR1082
>
>
163
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
Here you will find the description of the ifm function elements suitable for this device, sorted by topic.
164
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INPUT ...................................................................................................................................................166
SET_ETHERNET .................................................................................................................................168
SET_BOOTUP_BACKLIGHT ...............................................................................................................170
LOAD_SPLASH_SCREEN...................................................................................................................171
TouchScreenDisable ............................................................................................................................172
CamsOffOnPageSwitch........................................................................................................................173
KEY_MAPPING ....................................................................................................................................174
8566
Here you find units for the setup of the device from a CODESYS application.
165
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INPUT
9673
Symbol in CODESYS:
>
Description
14351
INPUT enables determining the state at the input channels (→ data sheet). The FB provides the
current state at the selected channel.
The measurement and the output value result from the operating mode indicated via MODE
• binary input plus switching (BL) for positive sensor signal (with/without diagnosis)
• binary input minus switching (BH) for negative sensor signal
• analogue input 0...20 mA
• analogue input 0...10 V
• analogue input ratiometric 0...32 V
166
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
If the value 1 or 242 is provided at output RESULT, reset the input ENABLE (ENABLE =
FALSE)!
167
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
SET_ETHERNET
11681
Symbol in CODESYS:
>
Description
11682
168
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
If the value 1, 64, 65, 80, 81 or82 is provided at output RESULT, reset input ENABLE (ENABLE
= FALSE)!
169
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
SET_BOOTUP_BACKLIGHT
9681
Symbol in CODESYS:
>
Description
9683
With the function SET_BOOTUP_BACKLIGHT the brightness of the display can be set.
NOTICE
When functions are called too frequently (FUN) the Flash memory may be destroyed.
► Call functions only if absolutely necessary!
>
>
170
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
LOAD_SPLASH_SCREEN
14531
Symbol in CODESYS:
>
Description
14533
LOAD_SPLASH_SCREEN loads an image file from a selectable location and saves it in the flash
memory of the device. The image file will be used as splash screen after the next reboot of the device.
NOTE
Each call of the FB executes a write operation on the flash memory of the device.
► Do not call the function block cyclically in the program code!
Only one instance of the FB may be active at a time.
Observe the characteristics of the splash screen → chapter Visualisation limits (→ page 128)
>
>
Output parameters
19879
If the value 1 or 242 is provided at the RESULT output, reset the ENABLE input (ENABLE =
FALSE)!
>
171
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
TouchScreenDisable
18884
Description
18901
172
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CamsOffOnPageSwitch
18888
Description
18894
173
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
KEY_MAPPING
8959
Description
8960
KEY_MAPPING contains the current key assignment with constant character strings.
174
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
GET_DEVICE_SERIAL ........................................................................................................................176
GET_ETHERNET .................................................................................................................................177
GET_VERSIONS ..................................................................................................................................179
19614
175
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
GET_DEVICE_SERIAL
11695
Symbol in CODESYS:
>
Description
11696
GET_DEVICE_SERIAL reads the serial number from the device. The current value is provided at
output SERIAL as long as the input ENABLE is set to TRUE. RESULT provides the return value of the
FB.
>
>
176
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
GET_ETHERNET
11673
Symbol in CODESYS:
>
Description
11674
GET_ETHERNET reads
the IP address of the sensor
the network mask of the TCP/IP network and
the IP address of the gateway
and transfers them to the FB outputs IP_ADDRESS, NETMASK und GATEWAY.
>
177
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
178
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
GET_VERSIONS
14360
>
Description
14362
179
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
180
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
NORM_DINT ........................................................................................................................................182
NORM_REAL .......................................................................................................................................183
TOGGLE ...............................................................................................................................................184
19615
181
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
NORM_DINT
13238
Symbol in CODESYS:
>
Description
3307
NORM_DINT normalises a value within defined limits to a value with new limits.
The FB normalises a value of type DINT, which is within the limits of XH and XL, to an output value
within the limits of YH and YL. This FB is for example used to generate PWM values from analogue
input values.
NOTE
► The value for X must be in the defined input range between XL and XH!
There is no internal plausibility check of the value X.
Outside this value range the output X_OUT_OF_RANGE is set.
► The result of the calculation (XH-XL)•(YH-YL) must remain in the value range of data type DINT
(-2 147 483 648...2 147 483 647)!
> Due to rounding errors the normalised value can deviate by 1.
> If the limits (XH/XL or YH/YL) are defined in an inverted manner, normalisation is also done in an
inverted manner.
>
>
182
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
NORM_REAL
13243
Symbol in CODESYS:
>
Description
3310
NORM_REAL normalises a value within defined limits to a value with new limits.
The FB normalises a value of type REAL, which is within the limits of XH and XL, to an output value
within the limits of YH and YL. This FB is for example used to generate PWM values from analogue
input values.
NOTE
► The value for X must be in the defined input range between XL and XH!
There is no internal plausibility check of the value X.
Outside this value range the output X_OUT_OF_RANGE is set.
► The result of the calculation (XH-XL)•(YH-YL) must remain in the value range of data type REAL
(-3,402823466•1038...3,402823466•1038)!
> Due to rounding errors the normalised value can deviate by 1.
> If the limits (XH/XL or YH/YL) are defined in an inverted manner, normalisation is also done in an
inverted manner.
>
>
183
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
TOGGLE
13247
Symbol in CODESYS:
>
Description
3304
TOGGLE enables the setting and resetting of a Boolean variable via only one input bit.
The first rising edge on the input IN sets the output OUT to 'TRUE'.
The next rising edge resets the output back to 'FALSE'.
etc.
>
184
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
7.2.4 POUs: Manage, read and write the USB memory device
19599
185
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
USB_STORAGE_MANAGER
9691
>
Description
9708
186
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
187
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
USB_STORAGE_REMOVE
9711
>
Description
9713
188
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
COPY_PDM_TO_USB
10098
Symbol in CODESYS:
>
Description
10100
COPY_PDM_TO_USB copies a file from the memory of the PDM to a connected USB memory device.
>
189
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
COPY_USB_TO_PDM
10107
Symbol in CODESYS:
>
Description
10109
COPY_USB_TO_PDM copies a file from a connected USB memory device to the device.
>
>
190
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
USB_STORAGE_HANDLER
10090
Symbol in CODESYS:
>
Description
10092
191
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
192
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
BUZZER_CLICK ...................................................................................................................................194
BUZZER_ON ........................................................................................................................................195
KEY_CLICK ..........................................................................................................................................196
8650
Here we show you functions to control the LED and the buzzer in this device.
193
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
BUZZER_CLICK
9651
Symbol in CODESYS:
>
Description
9654
With BUZZER_CLICK the integrated buzzer of the device generates a click signal as soon as the
function is called. Adjustable features:
- click repetition time in [ms],
- tone pitch in [Hz].
>
>
194
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
BUZZER_ON
9658
Symbol in CODESYS:
>
Description
9660
With BUZZER_ON the integrated buzzer of the device generates an adjustable tone:
- The tone duration is determined by the duration of the ENABLE signal.
- The tone pitch results from the parameter FREQUENCY.
>
>
If the value 1 or 242 is provided at output RESULT, reset the input ENABLE (ENABLE =
FALSE)!
195
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
KEY_CLICK
9667
Symbol in CODESYS:
>
Description
9669
With KEY_CLICK the integrated buzzer of the device generates an adjustable click tone as soon as
one of the keys is pressed:
- The tone pitch results from the parameter FREQUENCY.
- The click repetition time results from the parameter DURATION.
Do not use the FB KEY_CLICK simultaneously with the autorepeat function (→ System flags
(→ page 347)).
Otherwise, the device will produce disagreeable noises.
>
196
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
If the value 1 or 242 is provided at output RESULT, reset the input ENABLE (ENABLE =
FALSE)!
197
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
SPEED_UP_VISU_TASK.....................................................................................................................199
FOCUSED_ELEMENT .........................................................................................................................200
CURSOR_POSITION ...........................................................................................................................201
FocusFrameImagePath ........................................................................................................................202
PDM_PAGECONTROL ........................................................................................................................203
OverlayVisu ..........................................................................................................................................205
CurrentVisuDisplayed ...........................................................................................................................206
INPUT_DINT ........................................................................................................................................207
INPUT_INT ...........................................................................................................................................210
INPUT_REAL .......................................................................................................................................215
INIT_VAR_RETAIN_DINT ....................................................................................................................218
INIT_VAR_RETAIN_INT ......................................................................................................................220
INIT_VAR_RETAIN_REAL ...................................................................................................................222
8617
198
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
SPEED_UP_VISU_TASK
11711
Symbol in CODESYS:
>
Description
11712
SPEED_UP_VISU_TASK accelerates the visualisation process of the PDM. This leads to a faster
change to the next page.
During the execution of the application program the FB can be activated or deactivated at any time.
The FB assigns additional CPU processing times to the visualisatoin process. Therefore there
are fewer resources available to other processes (e.g. CAN_communication, control process).
Before the FB is used, test thoroughly if the change has any negative effects on the correct
execution of the application program!
>
>
199
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
FOCUSED_ELEMENT
18891
Description
8897
FOCUSED_ELEMENT contains the ID of the visualisation objetc, which currently has the focus.
200
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CURSOR_POSITION
18890
Description
18896
CURSOR_POSITION contains the current position of the cursor when entering alphanumerical
charachters (e.g. numpad, on-screen keyboard).
CURSOR_POSITION DINT
201
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
FocusFrameImagePath
18892
Description
18898
FocusFrameImagePath contains the path of the directory where the image file of the user-specific
focus frame is stored.
The image file of the focus frame must have the following characteristics:
File format: PNG
Transparency: The area within the frame must be saved as transparent.
202
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
PDM_PAGECONTROL
18886
Description
3294
*) Also note the new 5-digit numbering when naming your existing visualisation pages!
>
203
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
204
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
OverlayVisu
18887
Description
18889
OverlayVisu contains the name of the visualisati→ page which is used as overlay visualisation. An
overlay visualisation overlays the active visualisation page.
205
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CurrentVisuDisplayed
18889
Description
18895
206
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INPUT_DINT
3223
Symbol in CODESYS:
>
Description
3333
INPUT_DINT supports up to 6 input fields which can be assigned to 6 different objects in the
visualisation. The input objects are parameterised with the internal variables FIELD1...FIELD6,
COLOR_FIELD1...COLOR_FIELD6 and VALUE_FIELD1...VALUE_FIELD6.
The FB is an alternative to the input function integrated in CoDeSys and more flexible compared to the
CoDeSys input function.
The FB contains no visualisation elements.
207
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
208
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
Internal parameters
3336
COLOR_FIELD1 DINT
Sets the alarm colour of the input object (only PDM color).
... DINT
The variable must be assigned in the visualisation.
COLOR_FIELD6 DINT
VALUE_FIELD_1 DINT Internal input value which is immediately visible during
the input and transferred to VALUE_FIELDx on the
... DINT second rising edge of ENTER.
VALUE_FIELD_6 DINT The variable must be assigned in the visualisation.
209
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INPUT_INT
3220
Symbol in CODESYS:
>
Description
3328
INPUT_INT supports up to 6 input fields which can be assigned to 6 different objects in the
visualisation. The input objects are parameterised with the internal variables FIELD1...FIELD6,
COLOR_FIELD1...COLOR_FIELD6 and VALUE_FIELD1...VALUE_FIELD6.
The FB is an alternative to the input function integrated in CoDeSys and more flexible compared to the
CoDeSys input function.
The FB contains no visualisation elements.
210
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
211
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
Internal parameters
3331
COLOR_FIELD1 INT
Sets the alarm colour of the input object (only PDM color).
... INT
The variable must be assigned in the visualisation.
COLOR_FIELD6 INT
VALUE_FIELD_1 INT Internal input value which is immediately visible during
the input and transferred to VALUE_FIELDx on the
... INT second rising edge of ENTER.
VALUE_FIELD_6 INT The variable must be assigned in the visualisation.
>
212
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
► Integrate the requested function block into the application program and link the inputs and outputs
to the parameters and variables:
► Create the requested visualisation page. In the example the three right elements are intended for
the input of the values:
► When the input elements are configured with the internal parameters FIELD1...FIELD3 a frame is
shown for the selected input object (FIELDn = TRUE, alarm colour frame = black). For the other
objects it is not visible.
213
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
214
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INPUT_REAL
3225
Symbol in CODESYS:
>
Description
3337
INPUT_REAL supports up to 6 input fields which can be assigned to 6 different objects in the
visualisation. The input objects are parameterised with the internal variables FIELD1...FIELD6,
COLOR_FIELD1...COLOR_FIELD6 and VALUE_FIELD1...VALUE_FIELD6.
The FB is an alternative to the input function integrated in CoDeSys and more flexible compared to the
CoDeSys input function.
The FB contains no visualisation elements.
215
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
216
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
Internal parameters
3340
COLOR_FIELD1 REAL
Sets the alarm colour of the input object (only PDM color).
... REAL
The variable must be assigned in the visualisation.
COLOR_FIELD6 REAL
VALUE_FIELD_1 REAL Internal input value which is immediately visible during
the input and transferred to VALUE_FIELDx on the
... REAL second rising edge of ENTER.
VALUE_FIELD_6 REAL The variable must be assigned in the visualisation.
217
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INIT_VAR_RETAIN_DINT
3232
Symbol in CODESYS:
>
Description
3344
INIT_VAR_RETAIN_DINT initialises the array of INPUT_DINT (→ page 207) indicated on the input
INIT_VALUE with remanent input values.
If input values are to be saved permanently, the values must be initialised after switching on the
display, otherwise they are overwritten in the first cycle. The FB initialises the array INIT_VALUE of
INPUT_DINT with remanent input values.
The function element compares the values of VALUE1...VALUE6 with the values of INIT_VALUE:
> If the contents of VALUE1...VALUE6 = 0, VALUE1...VALUE6 are written to the array INIT_VALUE.
> If the contents of VALUE1...VALUE6 0, the elements of the array INIT_VALUE are written to
VALUE1...VALUE6.
218
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
> The following INPUT function block is then initialised with INIT_VALUE in the first cycle.
219
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INIT_VAR_RETAIN_INT
3229
Symbol in CODESYS:
>
Description
3341
INIT_VAR_RETAIN_INT initialises the array of INPUT_INT (→ page 210) indicated on the input
INIT_VALUE with remanent input values.
If input values are to be saved permanently, the values must be initialised after switching on the
display, otherwise they are overwritten in the first cycle. The FB initialises the array INIT_VALUE of
INPUT_INT with the remanent input values.
The function element compares the values of VALUE1...VALUE6 with the values of INIT_VALUE:
> If the contents of VALUE1...VALUE6 = 0, VALUE1...VALUE6 are written to the array INIT_VALUE.
> If the contents of VALUE1...VALUE6 0, the elements of the array INIT_VALUE are written to
VALUE1...VALUE6.
220
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
> The following INPUT function block is then initialised with INIT_VALUE in the first cycle.
221
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
INIT_VAR_RETAIN_REAL
3235
Symbol in CODESYS:
>
Description
3347
INIT_VAR_RETAIN_REAL initialises the array of INPUT_REAL (→ page 215) indicated on the input
INIT_VALUE with remanent input values.
If input values are to be saved permanently, the values must be initialised after switching on the
display, otherwise they are overwritten in the first cycle. The FB initialises the array INIT_VALUE of
INPUT_INT with the remanent input values.
The function element compares the values of VALUE1...VALUE6 with the values of INIT_VALUE:
> If the contents of VALUE1...VALUE6 = 0, VALUE1...VALUE6 are written to the array INIT_VALUE.
> If the contents of VALUE1...VALUE6 0, the elements of the array INIT_VALUE are written to
VALUE1...VALUE6.
222
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
> The following INPUT function block is then initialised with INIT_VALUE in the first cycle.
223
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
PointOfContact .....................................................................................................................................225
19928
224
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
PointOfContact
18885
Description
18900
PointOfContact is a structured variable. It provides information about the point of contact of the
touchscreen and gives access to configuration options for visual feedback. The following table shows
details regarding the different structure variables.
225
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
226
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
VERSION
9688
Symbol in CODESYS:
>
Description
9698
The program VERSION indicates the version and history of the library in the comment of the function
element.
227
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
EXITPLC_START_APPLICATION
11702
Symbol in CODESYS:
>
Description
11705
When the application is called with EXITPLC_START_APPLICATION, the runtime system of the
PDM including the active visualisation is terminated. When the application has been exited,
the runtime system starts again.
>
>
228
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
SYSTEM_ASYNCH
9693
Symbol in CODESYS:
>
Description
9700
SYSTEM_ASYNCH sends any command (max. 255 characters) to the Linux operating system. The
command is processed asynchronously in the background.
The function block must be executed (EXECUTE = TRUE) until the FB output DONE = TRUE.
>
229
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
Here we describe the RAW-CAN function blocks (CAN Layer 2) of ifm electronic to be used in the
application program.
230
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_ENABLE ......................................................................................................................................232
CAN_RECOVER ..................................................................................................................................233
CAN_SETDOWNLOADID ....................................................................................................................234
CAN_STATUS ......................................................................................................................................235
15049
231
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_ENABLE
7492
Symbol in CODESYS:
>
Description
7494
With CAN_ENABLE the CAN hardware is initialised. Without this call no other calls are possible in
RAW-CAN or they return an error.
In order to change the baud rate the following procedure is required:
► Maintain the function block on ENABLE=FALSE for the duration of one cycle.
> All protocols are reset.
> Re-initialisation of the CAN interface and the CAN protocols running on it. Any information
available for cyclical transmission is lost as well and must be newly created.
> At renewed ENABLE=TRUE, the new baud rate is adopted.
>
>
232
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RECOVER
7512
Symbol in CODESYS:
>
Description
7513
233
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_SETDOWNLOADID
7516
= Set download ID
Unit type = function block (FB)
Unit is contained in the library ifm_RawCAN_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7517
The download ID is required for data exchange when connecting the runtime system and the
CODESYS development environment. When the device is started the download ID is set with the
default value from the hardware configuration.
With CAN_SETDOWNLOADID this value can be set in the PLC program (e.g. using certain inputs).
The changed ID is also written into the hardware configuration.
>
>
234
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_STATUS
7499
Symbol in CODESYS:
>
Description
7501
235
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
236
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX ...............................................................................................................................................238
CAN_RX_ENH .....................................................................................................................................239
CAN_RX_ENH_FIFO ...........................................................................................................................241
CAN_RX_RANGE ................................................................................................................................243
CAN_RX_RANGE_FIFO ......................................................................................................................245
15050
237
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX
7586
Symbol in CODESYS:
>
Description
7588
>
238
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX_ENH
7606
= CAN RX enhanced
Unit type = function block (FB)
Unit is contained in the library ifm_RawCAN_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7608
In addition, CAN_RX_ENH provides the following possibilities (as opposed to CAN_RX (→ page 238)):
• select the frame type (11 or 29 bits),
• define a mask for the evaluation of the CAN ID.
239
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
240
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX_ENH_FIFO
7615
Symbol in CODESYS:
>
Description
7616
In addition, CAN_RX_ENH_FIFO provides a FiFo for the received data (as opposed to CAN_RX_ENH
(→ page 239)). Thus several CAN messages can be received in one cycle.
No overwriting takes place when the FiFo is full. Inbound messages will be lost.
In this event:
► Deactivate and reactive the FB via ENABLE.
> The FiFo is deleted and can be newly filled.
>
241
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
242
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX_RANGE
7592
Symbol in CODESYS:
>
Description
7594
243
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
244
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_RX_RANGE_FIFO
7601
Symbol in CODESYS:
>
Description
7603
No overwriting takes place when the FiFo is full. Inbound messages will be lost.
In this event:
► Use ENABLE to deactivate and reactivate the function.
> The FiFo is deleted and can be newly filled.
>
245
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
246
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_TX................................................................................................................................................248
CAN_TX_ENH ......................................................................................................................................249
CAN_TX_ENH_CYCLIC.......................................................................................................................251
15055
247
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_TX
7522
Symbol in CODESYS:
>
Description
7523
>
248
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_TX_ENH
7558
= CAN TX enhanced
Unit type = function block (FB)
Unit is contained in the library ifm_RawCAN_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7559
Additional setting options are offered through CAN_TX_ENH (for: enhanced). Here, all CAN specific
characteristics can be set individually, e.g.:
Is it an 11 or a 29 bit identifier?
The additional inputs can be preset so that CAN_TX (→ page 248) is not required.
> If an instance of this FB is called several times during a cycle, the data is also sent several times.
>
249
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
250
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_TX_ENH_CYCLIC
7568
Symbol in CODESYS:
>
Description
7569
If a period is too short, this could lead to a high bus load which could affect the performance of the
complete system.
>
251
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
252
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_REMOTE_REQUEST .................................................................................................................254
CAN_REMOTE_RESPONSE...............................................................................................................256
15057
253
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_REMOTE_REQUEST
7625
Symbol in CODESYS:
>
Description
7627
>
254
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
255
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CAN_REMOTE_RESPONSE
7631
Symbol in CODESYS:
>
Description
7633
CAN_REMOTE_RESPONSE provides data to the CAN controller in the device which is automatically
sent upon the request of a remote message.
This FB strongly depends on the device type. Only a limited number of remote messages can be set
up:
BasicController: CR040n, CR041n, CR043n
max. 40 remote messages
BasicDisplay: CR045n
PDM360 NG: CR108n, CR120n max. 100 remote messages
>
256
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
257
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
For CANopen, ifm electronic provides a number of function elements which will be explained in the
following.
258
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_ENABLE ............................................................................................................................260
CANOPEN_GETBUFFERFLAGS ........................................................................................................262
CANOPEN_GETSTATE .......................................................................................................................264
CANOPEN_SETSTATE .......................................................................................................................266
15061
259
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_ENABLE
7785
Symbol in CODESYS:
>
Description
7787
To avoid guarding or heartbeat errors the nodes must be "shut down" via an appropriate sequence
first.
If the master is restarted after a stop, all other connected nodes also have to be re-initialised.
Without CANOPEN_ENABLE, the CANopen master is started automatically, as far as this has been
selected in the configuration.
The configured baud rate is only adopted if CAN_ENABLE (→ page 232) has not been activated before.
>
260
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
261
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETBUFFERFLAGS
7890
Symbol in CODESYS:
>
Description
7892
262
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
263
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETSTATE
7865
= Get state
Unit type = function block (FB)
Unit is contained in the library ifm_CANopen_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7867
Via CANOPEN_GETSTATE, parameters of the master, a slave device or a specific node in the
network can be set.
>
>
264
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
265
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SETSTATE
7858
= Set state
Unit type = function block (FB)
Unit is contained in the library ifm_CANopen_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7860
Via CANOPEN_SETSTATE, parameters of the master, a slave device or a node in the network can be
set.
The treatment of the NMT state of master, node or device is carried out in the CAN stack or via the
commands of the FB CANOPEN_NMTSERVICES (→ page 270). At the same time admissibility checks are
carried out. For reasons of consistency no inputs are provided for this purpose.
266
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
>
267
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETNMTSTATESLAVE ...................................................................................................269
CANOPEN_NMTSERVICES ................................................................................................................270
15063
268
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETNMTSTATESLAVE
7851
Symbol in CODESYS:
>
Description
7853
>
269
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_NMTSERVICES
7843
Symbol in CODESYS:
>
Description
7844
270
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
271
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETODCHANGEDFLAG .................................................................................................273
CANOPEN_READOBJECTDICT .........................................................................................................274
CANOPEN_WRITEOBJECTDICT .......................................................................................................275
15065
272
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETODCHANGEDFLAG
7927
Symbol in CODESYS:
>
Description
7928
>
273
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_READOBJECTDICT
7933
Symbol in CODESYS:
>
Description
7935
>
274
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_WRITEOBJECTDICT
7940
Symbol in CODESYS:
>
Description
7942
NOTICE
This could lead to falsification of important system settings, e.g.:
- guarding times
- heartbeat times
► Carefully verify input parameters!
>
275
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
276
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOREAD ........................................................................................................................278
CANOPEN_SDOREADBLOCK ............................................................................................................280
CANOPEN_SDOREADMULTI .............................................................................................................282
CANOPEN_SDOWRITE ......................................................................................................................284
CANOPEN_SDOWRITEBLOCK ..........................................................................................................286
CANOPEN_SDOWRITEMULTI ...........................................................................................................288
2071
Here you will find ifm function elements for CANopen handling of Service Data Objects (SDOs).
277
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOREAD
7791
= SDO read
Unit type = function block (FB)
Unit is contained in the library ifm_CANopen_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7793
CANOPEN_SDOREAD is an easy function block for editing "Expedited SDOs", i.e. SDOs with max.
4 bytes of user data. This type usually represents the bigger part of the SDO communication.
Expedited SDO = Expedited Service Data Object
A considerable amount of memory space can be saved due to the limitation of the data volume to
max. 4 bytes of user data, as this FB only needs to reserve 4 bytes as buffer storage and does not
create a large data array itself.
>
278
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
279
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOREADBLOCK
14942
Symbol in CODESYS:
>
Description
14943
CANOPEN_SDOREADBLOCK reads the indicated entry in the object directory of a node in the
network via SDO block transfer.
> If the node doesn't support block transfer, the FB automatically changes to "segmented transfer".
You can also directly change to "segmented transfer" via the input.
> The COB ID for the SDO is calculated from the transmitted node ID.
The length of multiframe SDOs is generally not limited.
For systems without a file system (e.g. BasicController CR04nn) the following applies:
► transmit an address to the FB which is accessed by the pointer for writing. The memory area
determined by the start address DATA and the amount of data MAX_LEN must be available!
> If the amount of data is greater than indicated, the transfer is stopped and signalled via RESULT.
For systems with a file system (e.g. PDM360NG CR108n) the following applies:
► transmit the path and name of a file to the FB, in which the data is to be saved in binary format.
> The output RESULT provides information on the status of the SDO transmission.
280
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
>
281
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOREADMULTI
7806
Symbol in CODESYS:
>
Description
7808
CANOPEN_SDOREADMULTI reads the indicated entry in the object directory of a node in the
network. The COB ID for the SDO is calculated from the transmitted node ID according to CANopen
convention.
>
282
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
283
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOWRITE
7825
= SDO write
Unit type = function block (FB)
Unit is contained in the library ifm_CANopen_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7826
CANOPEN_SDOWRITE is an easy function block for editing "Expedited SDOs", i.e. SDOs with max.
4 bytes user data. This type usually represents the bigger part of the SDO communication.
Expedited SDO = expedited service data object
A considerable amount of memory space can be saved due to the limitation of the data volume to
max. 4 bytes of user data because this FB only needs to reserve 4 bytes as buffer storage and does
not create a large data array itself.
>
284
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
285
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOWRITEBLOCK
14961
Symbol in CODESYS:
>
Description
14963
CANOPEN _SDOWRITEBLOCK writes in the indicated entry in the object directory of a node in the
network via SDO block transfer.
You can change to segmented transfer via the FB input if required.
> The COB ID for the SDO is calculated from the transmitted node ID.
> The output RESULT provides information on the status of the SDO transmission.
The length of multiframe SDOs is generally not limited.
For systems without a file system (e.g. BasicController CR04nn) the following applies:
► transmit an address to the FB which is accessed by the pointer for reading.
For systems with a file system (e.g. PDM360NG CR108n) the following applies:
► Transmit the path and name of a file to the FB, from which the data is to be read in binary format.
286
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
>
287
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SDOWRITEMULTI
7832
Symbol in CODESYS:
>
Description
7834
CANOPEN_SDOWRITEMULTI writes the indicated entry in the object directory of a node in the
network. The COB ID for the SDO is calculated from the transmitted node ID according to CANopen
convention.
>
288
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
289
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETSYNCSTATE .............................................................................................................291
CANOPEN_SETSYNCSTATE .............................................................................................................293
15069
290
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETSYNCSTATE
7871
Symbol in CODESYS:
>
Description
7872
CANOPEN_GETSYNCSTATE reads...
• the setting of the SYNC functionality (active / not active),
• the error state of the SYNC functionality (SyncError).
If the PLC CAN runs as CANopen slave, it is signalled via this FB whether SYNC signals are absent or
appear regularly.
Synchronous PDOS etc. are handled in the CAN stack. CANOPEN_GETSYNCSTATE, however,
provides the error state so that the application program can react accordingly.
>
291
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
292
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SETSYNCSTATE
7883
Symbol in CODESYS:
>
Description
7884
>
293
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETGUARDHBERRLIST .................................................................................................295
CANOPEN_GETGUARDHBSTATSLV ................................................................................................297
15071
294
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETGUARDHBERRLIST
7896
Symbol in CODESYS:
>
Description
7898
CANOPEN_GETGUARDHBERRLIST lists all nodes in an array for which the master has detected an
error:
• guarding error
• heartbeat error
>
295
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
296
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETGUARDHBSTATSLV
7902
Symbol in CODESYS:
>
Description
7904
297
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
298
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETEMCYMESSAGES ....................................................................................................300
CANOPEN_GETERRORREGISTER ...................................................................................................302
CANOPEN_SENDEMCYMESSAGE ...................................................................................................304
15073
299
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETEMCYMESSAGES
7921
Symbol in CODESYS:
>
Description
7923
CANOPEN_GETEMCYMESSAGES returns all emergency messages that have been received by the
controller from other nodes in the network since the last deletion of messages.
The list can be reset by setting the according input. A maximum of MAXEMCYMSGS messages is
stored. Each message contains information from which the node it was sent. The most recent
message is in index 0.
>
300
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
301
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_GETERRORREGISTER
7915
Symbol in CODESYS:
>
Description
7917
CANOPEN_GETERRORREGISTER reads the error registers 0x1001 and 0x1003 from the controller.
>
302
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
303
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
CANOPEN_SENDEMCYMESSAGE
7908
Symbol in CODESYS:
>
Description
7910
304
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
305
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
For SAE J1939, ifm electronic provides a number of function elements which will be explained in the
following.
306
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_ENABLE ....................................................................................................................................308
J1939_GETDABYNAME ......................................................................................................................310
J1939_NAME .......................................................................................................................................312
J1939_STATUS ....................................................................................................................................314
15077
307
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_ENABLE
7641
Symbol in CODESYS:
>
Description
7642
308
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
309
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_GETDABYNAME
7664
Symbol in CODESYS:
>
Description
7665
Via J1939_GETDABYNAME, the target address of one or several participants can be determined by
means of the name information.
If a specific value is set on the optional inputs:
the result list will only show the participants with this specific value.
If no value or the default value is set on the optional inputs:
this entry is not taken into account during filtration of the list.
310
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
>
311
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_NAME
7646
Symbol in CODESYS:
>
Description
7648
Via J1939_NAME, the device can be given a name for identification in the network.
By default the name of ifm is used.
The user has the following options to change the name of the device:
► use the information from the CFG file or
► overwrite the requested data via J1939_NAME.
> If no value or a default value is set at the optional inputs:
the preset value is not overwritten.
The following list shows the composition of the 64 bit NAME information according to SAE J1939-81:
Parameter Data type Description
arbitrary address capable 1 bit any desired address available
industry group 3 bits industry group of the device
vehicle system instance 4 bits instance of the vehicle system
vehicle system 7 bits vehicle system
reserved 1 bit reserved
function 8 bits function of the device
function instance 5 bits instance of the function
ECU instance 3 bits instance of the controller
manufacturer code 11 bits manufacturer code (must be applied for at SAE)
identify number 21 bits serial number of the device (should not be overwritten)
312
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
>
313
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_STATUS
7670
Symbol in CODESYS:
>
Description
7672
Via J1939_STATUS, relevant information can be read back to the J1939 stack.
>
>
314
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_SPEC_REQ ..............................................................................................................................316
J1939_SPEC_REQ_MULTI .................................................................................................................318
15079
315
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_SPEC_REQ
15023
Symbol in CODESYS:
>
Description
15026
316
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
317
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_SPEC_REQ_MULTI
15033
Symbol in CODESYS:
>
Description
15036
318
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
319
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_RX .............................................................................................................................................321
J1939_RX_FIFO ...................................................................................................................................323
J1939_RX_MULTI ................................................................................................................................325
15081
320
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_RX
7724
Symbol in CODESYS:
>
Description
7725
J1939_RX is the easiest method for receiving single frame messages. The message read last on the
CAN bus is returned.
>
321
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
322
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_RX_FIFO
7732
Symbol in CODESYS:
>
Description
7733
J1939_RX_FIFO enables receipt of all specified messages and their successive reading from a FIFO.
>
323
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
324
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_RX_MULTI
7736
Symbol in CODESYS:
>
Description
7741
325
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_TX .............................................................................................................................................327
J1939_TX_ENH ....................................................................................................................................328
J1939_TX_ENH_CYCLIC ....................................................................................................................330
J1939_TX_ENH_MULTI .......................................................................................................................332
15083
326
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_TX
7688
Symbol in CODESYS:
>
Description
7689
>
327
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_TX_ENH
7696
= J1939 TX enhanced
Unit type = function block (FB)
Unit is contained in the library ifm_J1939_NT_Vxxyyzz.LIB
Symbol in CODESYS:
>
Description
7697
Additional setting options are provided by J1939_TX_ENH (for: enhanced) for single frame messages:
transmitting priority
data length
Multi frame messages J1939_TX_ENH_MULTI (→ page 332).
>
328
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
329
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_TX_ENH_CYCLIC
7716
Symbol in CODESYS:
>
Description
7718
>
330
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
331
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_TX_ENH_MULTI
7699
Symbol in CODESYS:
>
Description
7705
332
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
333
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_DM1RX .....................................................................................................................................335
J1939_DM1TX ......................................................................................................................................337
J1939_DM1TX_CFG ............................................................................................................................340
J1939_DM3TX ......................................................................................................................................342
15085
334
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_DM1RX
14977
Symbol in CODESYS:
>
Description
7761
335
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
336
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_DM1TX
14993
Symbol in CODESYS:
>
Description
7747
With J1939_TX_DM1 (DM = Diagnostic Message) the controller can only transmit an active error
message to the CAN stack.
> This message is stored in the hardware configuration.
> The message is marked "active" and transmitted once per second as DM1.
> If the error has already occurred, the event counter is incremented.
The event counter is managed by the CAN stack.
> A disjunction of all bits of the trouble codes is executed. As soon as a bit is set in one of the
trouble codes, it is equally set in the lamp state.
Upon arrival of a request at DM2, the CAN stack can read the according information from the
hardware configuration and transmit it.
> When a DM3 message arrives, all inactive errors are deleted in the error memory in the hardware
configuration.
337
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
338
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
339
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_DM1TX_CFG
15424
Symbol in CODESYS:
>
Description
15426
As from runtime system V03.00.03 the CAN stack automatically sends a DM1 message every second
as soon as the FB J1939_ENABLE (→ page 308) is called for the corresponding CAN interface.
► Use the FB J1939_DM1TX_CFG if you do not want the CAN stack to automatically and cyclically
transmit DM1 messages.
The FB offers the following modes for cyclic transmission of DM1 messages:
MODE = 0 The CAN stack sends DM1 "zero active faults" messages in compliance with standards every second.
(preset) A manual transmission of DM1 messages via the FB J1939_DM1TX (→ page 337)is possible.
MODE = 1 The CAN stack does not send DM1 "zero active faults" messages.
DM2 requests are answered automatically.
A manual transmission of DM1 messages via the FBJ1939_DM1TX (→ page 337) is possible.
MODE = 2 The CAN stack does not send cyclic DM1 "zero active faults" messages
Nor does the CAN stack automatically reply to DM2 requests.
>
340
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
341
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
ifm function elements ifm function elements for the device CR1082
>
J1939_DM3TX
15002
Symbol in CODESYS:
>
Description
15004
With J1939_DM3TX (DM = Diagnostic Message) you can delete the inactive DTCs on another device.
> As soon as a DM3 message is received, all inactive errors in the error memory are deleted in the
hardware configuration.
>
>
342
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Diagnosis and error handling ifm function elements for the device CR1082
Diagnosis ..............................................................................................................................................344
Fault ......................................................................................................................................................344
Response to system errors...................................................................................................................344
CAN / CANopen: errors and error handling..........................................................................................344
19598
343
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Diagnosis and error handling Diagnosis
>
8.1 Diagnosis
19601
During the diagnosis, the "state of health" of the device is checked. It is to be found out if and what
→faults are given in the device.
Depending on the device, the inputs and outputs can also be monitored for their correct function.
- wire break,
- short circuit,
- value outside range.
For diagnosis, configuration and log data can be used, created during the "normal" operation of the
device.
The correct start of the system components is monitored during the initialisation and start phase.
Errors are recorded in the log file.
For further diagnosis, self-tests can also be carried out.
>
8.2 Fault
19602
A fault is the state of an item characterized by the inability to perform the requested function, excluding
the inability during preventive maintenance or other planned actions, or due to lack of external
resources.
A fault is often the result of a failure of the item itself, but may exist without prior failure.
In →ISO 13849-1 "fault" means "random fault".
>
In principle, the programmer is responsible to react to the error messages in the application program.
An error description is provided via the error message.
> The system resets the error message as soon as the error causing state is not present anymore.
>
344
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CAN / CANopen: errors and error handling
9 Annex
Additionally to the indications in the data sheets you find summary tables in the annex.
345
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex Address assignment in Ethernet networks
>
NOTE
In the Ethernet network every IP address MUST be unique.
The following IP addresses are reserved for network-internal purposes and are therefore not allowed
as an address for participants: nnn.nnn.nnn.0 | nnn.nnn.nnn.255.
Only network participants whose subnet mask is identical and whose IP addresses are identical with
respect to the subnet mask can communicate with each other.
Rule:
If part of the subnet mask = 255, the corresponding IP address parts must be identical.
If part of the subnet mask = 0, the corresponding IP address parts must be different.
If the subnet mask = 255.255.255.0, 254 participants communicating with each other are possible in
the network.
If the subnet mask = 255.255.0.0, 256x254 = 65 024 participants communicating with each other are
possible in the network.
In the same physical network different subnet masks of the participants are allowed. They form
different groups of participants which cannot communicate with groups of participants having other
subnet masks.
Examples:
Participant A Participant A Participant B Participant B Communication of
IP address Subnet mask IP address Subnet mask participants possible?
346
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
The addresses of the system flags can change if the PLC configuration is extended.
► While programming only use the symbol names of the system flags!
347
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
348
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
349
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
The operating elements of the device are systematically numbered. → Numbering of the operating
elements (→ page 134)
350
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
The operating elements of the device are systematically numbered. → Numbering of the operating
elements (→ page 134)
351
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex System flags
>
352
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex Possible operating modes inputs/outputs
Possible configuration combinations (where permissible) are created by adding the configuration
values.
353
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
The following tables will inform you about important values and settings of the CANopen interfaces.
354
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
Please note the reversed byte order! ( Little Endian or Intel format)
Examples:
Value [hex] Data type Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8
12 BYTE 1 2 – – – – – – – – – – – – – –
1234 WORD 3 4 1 2 – – – – – – – – – – – –
12345678 DWORD 7 8 5 6 3 4 1 2 – – – – – – – –
355
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
The first part of a message is the COB ID. Structure of the 11-bit COB ID:
Nibble 0 Nibble 1 Nibble 2
11 10 9 8 7 6 5 4 3 2 1 0
-- 3 2 1 0 6 5 4 3 2 1 0
-- function code node ID
The COB ID consists of the Function code / Predefined Connectionset (→ page 357) and the node ID.
Example:
Communication object = TPDO1 (TX)
Node number of the device = 0x020 = 32
Calculation:
Function code for the communication object TPDO1 = 0x03
Significance of the function code in the 11-bit COB ID = 0x03 • 0x80 = 0x180
Add the node number (0x020) the COB ID is: 0x1A0
1 A 0
3 2 1 0 3 2 1 0 3 2 1 0
0 0 0 1 1 0 1 0 0 0 0 0
-- 0x03 = 3 0x020 = 32
356
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
Point-to-point messages:
Function code
Communication object COB ID [hex] Related parameter objects [hex]
[hex]
EMERGENCY 1 080 + node ID 1014, 1015
TPDO1 (TX) 3 180 + node ID 1800
RPDO1 (RX) 4 20016 + node ID 1400
TPDO2 (TX) 5 280 + node ID 1801
RPDO2 (RX) 6 30016 + node ID 1401
TPDO3 (TX) 7 380 + node ID 1802
RPDO3 (RX) 8 400 + node ID 1402
TPDO4 (TX) 9 480 + node ID 1803
RPDO4 (RX) A 500 + node ID 1403
Default SSDO (TX) B 58016 + node ID 1200
Default CSDO (RX) C 60016 + node ID 1280
NMT Error Control E 70016 + node ID 1016, 1017
357
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
Please note the reversed byte order! ( Little Endian or Intel format)
DLC = Data Length Code = in CANopen the number of the data bytes in a message.
For →SDO: DLC = 8
SDO command bytes:
Command
Message Data length Description
hex | dec
21 33 request more than 4 bytes send data to slave
22 34 request 1…4 bytes send data to slave
23 35 request 4 bytes send data to slave
27 39 request 3 bytes send data to slave
2B 43 request 2 bytes send data to slave
2F 47 request 1 byte send data to slave
358
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
359
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
After booting, the CAN participate sends the boot-up message once:
COB ID DLC Byte 1
hex 0x700 + node ID 0x1 0x00
dec 1 792 + node ID 1 0
360
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
361
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
With the following network management commands the user can influence the operating mode of
individual or all CAN participants. Structure:
COB ID DLC Byte 1 Byte 2
0x000 X Command Node ID
Node ID = 00 command valid for all nodes in the network at the same time
COB ID NMT command Description
0x000 0x01 = 01 Node ID start_remode_node Set the node to the "operational" state
0x000 0x02 = 02 Node ID stop_remode_node Set the node to the "STOPPED" state
0x000 0x80 = 128 Node ID enter_pre-operational Set the node to the "PRE-OPERATIONAL" state
0x000 0x81 = 129 Node ID reset_node Node reset
0x000 0x82 = 130 Node ID reset_communication Reset the CAN communication of the node
>
NMT state
9963
The status byte informs about the state of the CAN participant.
Permitted transitions:
(1) State is automatically reached at power on
(2) Internal initialisation completed – node
automatically goes to PRE-OPERATIONAL
(3) NMT service "Start Remote Node"
(4) + (7) NMT service "Enter PRE-OPERATIONAL"
(5) + (8) NMT service "Stop Remote Node"
(6) NMT service "Start Remote Node"
(9)...(11) NMT service "Reset Node"
(12)...(14) NMT service "Reset Communication"
362
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
These statuses show the internal status of the CANopen master stack.
They are not defined by the CANopen specification.
State
Description
hex | dec
00 0 not defined
Master waits for a boot-up message of the node.
01 1
OR: Master waits for the expiry of the given guard time.
• Master waits for 300 ms.
02 2 • Master requests the object 0x1000.
• Then the state is set to 3.
The master configures its slaves. To do so, all SDOs generated by the configurator are transmitted to the
03 3
slaves one after the other. Then the master changes to status 5.
After transmission of all SDOs to the slaves the master goes to state 5 and remains in this state. State 5 is the
05 5
normal operating state for the master.
363
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
State
Description
hex | dec
FF -1 The slave is reset by the NMT message "Reset Node" and automatically goes to state 1.
00 0 not defined
state = waiting for BOOTUP
01 1
After max. 2 s or immediately on reception of its boot up message the slave goes to state 2.
state = BOOTUP
02 2
After a delay of 0.5 s the slave automatically goes to state 3.
state = PREPARED
The slave is configured in state 3. The slave remains in state 3 as long as it has received all SDOs generated
by the configurator. It is not important whether during the slave configuration the response to SDO transfers is
abort (error) or whether the response to all SDO transfers is no error. Only the response as such received by
the slave is important – not its contents.
03 3
If in the configurator the option "Reset node" has been activated, a new reset of the node is carried out after
transmitting the object 0x1011 sub-index 1 which then contains the value "load". The slave is then polled again
with the upload of the object 0x1000.
Slaves with a problem during the configuration phase remain in state 3 or directly go to an error state
(state > 5) after the configuration phase.
state = PRE-OPERATIONAL
A node always goes to state 4 except for the following cases:
04 4 it is an "optional" slave and it was detected as non available on the bus (polling for object 0x1000) OR:
the slave is present but reacted to the polling for object 0x1000 with a type in the lower 16 bits other than
expected by the configurator.
state = OPERATIONAL
State 5 is the normal operating state of the slave: [Normal Operation].
If the master was configured to [Automatic startup], the slave starts in state 4 (i.e. a "start node" NMT message
05 5
is generated) and the slave goes automatically to state 5.
If the flag GLOBAL_START was set, the master waits until all slaves are in state 4. All slaves are then started
with the NMT command [Start All Nodes].
A node goes to state 97 if it is optional (optional device in the CAN configuration) and has not reacted to the
SDO polling for object 0x1000.
61 97
If the slave is connected to the network and detected at a later point in time, it is automatically started. To do
so, you must have selected the option [Automatic startup] in the CAN parameters of the master.
62 98 A node goes to state 98 if the device type (object 0x1000) does not correspond to the configured type.
In case of a nodeguarding timeout the slave is set to state 99.
As soon as the slave reacts again to nodeguard requests and the option [Automatic startup] is activated, it is
63 99 automatically started by the master. Depending on the status contained in the response to the nodeguard
requests, the node is newly configured or only started.
To start the slave manually it is sufficient to use the method [NodeStart].
364
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
Node status according to CANopen (with these values the status is also coded by the node in the
corresponding messages).
Status
CANopen status: Description
hex | dec
00 0 BOOTUP BOOTUP message of the node
The node is in the status STOPPED. There is no exchange of data and the node
04 4 STOPPED
cannot be configured, either.
The node is in the status OPERATIONAL and participates in the normal exchange
05 5 OPERATIONAL
of data.
The node is in the status PRE-OPERATIONAL and can be configured by the
7F 127 PRE-OPERATIONAL
master.
If nodeguarding active: the most significant status bit toggles between the messages.
Read the node status from the function block:
Function block used Node status is found here
CANx_MASTER_STATUS Structure element LAST_STATE from the array NODE_STATE_SLAVE
CANx_SLAVE_STATUS Output NODE_STATE
CANOPEN_GETSTATE Output LASTNODESTATE
365
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
366
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
Emergency messages
9973
Device errors in the slave or problems in the CAN bus trigger emergency messages:
COB ID DLC Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
0x80 + object
error code device-specific
node ID 0x1001
Please note the reversed byte order! ( Little Endian or Intel format)
367
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
368
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Annex CANopen tables
>
This object reflects the general error state of a CANopen device. The device is to be considered as
error free if the object 0x1001 signals no error any more.
Bit Meaning (Bedeutung)
0 generic error
1 current
2 voltage
3 temperature
4 communication error
5 device profile specific
6 reserved – always 0
7 manufacturer specific
For an error message more than one bit in the error register can be set at the same time.
Example: CR2033, message "wire break" at channel 2 ( installation manual of the device):
COB-ID DLC Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8
0x80 +
00 FF 81 10 00 00 00 00
node ID
369
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
10 Glossary of Terms C
A CAN
CAN = Controller Area Network
Address CAN is a priority-controlled fieldbus system for
This is the "name" of the bus participant. All large data volumes. There are several
participants need a unique address so that the higher-level protocols that are based on CAN,
signals can be exchanged without problem. e.g. 'CANopen' or 'J1939'.
>
>
Homepage → www.can-cia.org
B
>
CiA DS 304
Baud DS = Draft Standard
Baud, abbrev.: Bd = unit for the data CANopen device profile for safety
transmission speed. Do not confuse baud with communication
"bits per second" (bps, bits/s). Baud indicates
>
>
CiA DS 405
Bus
DS = Draft Standard
Serial data transmission of several participants CANopen specification of the interface to
on the same cable. programmable controllers (IEC 61131-3)
>
>
370
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
DS = Draft Standard
CANopen device profile for encoders
>
D
CiA DS 407 Data type
DS = Draft Standard Depending on the data type, values of different
CANopen application profile for local public sizes can be stored.
transport Data size in the
min. value max. value
>
type memory
CODESYS -3.402823466
REAL 3.402823466 • 1038 32 bits
• 1038
CODESYS® is a registered trademark of 3S –
ULINT 0 18 446 744 073 709 551 615 64 bits
Smart Software Solutions GmbH, Germany.
'CODESYS for Automation Alliance' associates number of
STRING
companies of the automation industry whose char. + 1
hardware devices are all programmed with the
>
>
>
phase. Errors are recorded in the log file.
For further diagnosis, self-tests can also be
Cycle time carried out.
>
371
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
>
DLC EMC
Data Length Code = in CANopen the number EMC = Electro Magnetic Compatibility.
of the data bytes in a message. According to the EC directive (2004/108/EEC)
For →SDO: DLC = 8 concerning electromagnetic compatibility (in
>
>
DTC Ethernet
DTC = Diagnostic Trouble Code = error code Ethernet is a widely used,
In the protocol J1939 faults and errors well be manufacturer-independent technology which
managed and reported via assigned numbers enables data transmission in the network at a
– the DTCs. speed of 10...10 000 million bits per second
>
microcontroller
(2) Engine Control Unit = control device of a EUC
engine EUC = Equipment Under Control.
EUC is equipment, machinery, apparatus or
>
372
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
F Heartbeat
The participants regularly send short signals.
FiFo In this way the other participants can verify if a
participant has failed.
FIFO (First In, First Out) = Operating principle >
I
>
Flash memory
Flash ROM (or flash EPROM or flash memory) ID
combines the advantages of semiconductor ID = Identifier
memory and hard disks. Similar to a hard disk,
the data are however written and deleted Name to differentiate the devices / participants
blockwise in data blocks up to 64, 128, 256, connected to a system or the message
1024, ... bytes at the same time. packets transmitted between the participants.
>
IP address
IP = Internet Protocol.
The IP address is a number which is
necessary to clearly identify an internet
participant. For the sake of clarity the number
373
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
low-power mode
>
Master
ISO 11992 Handles the complete organisation on the bus.
Standard: Interchange of digital information on The master decides on the bus access time
and polls the →slaves cyclically.
electrical connections between towing and >
towed vehicles
• Part 1: Physical and data-link layers Misuse
• Part 2: Application layer for brakes and
The use of a product in a way not intended by
running gear
the designer.
• Part 3: Application layer for equipment other The manufacturer of the product has to warn
than brakes and running gear against readily predictable misuse in his user
• Part 4: Diagnostics
>
information.
>
>
MRAM
J
MRAM = Magnetoresistive Random Access
J1939 Memory
The information is stored by means of
→ SAE J1939 magnetic storage elements. The property of
>
power loss.
>
MSB
Link Most Significant Bit/Byte
>
NMT
LSB
NMT = Network Management = (here: in the
Least Significant Bit/Byte
>
CANopen protocol).
374
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
PDO
O PDO = Process Data Object.
The time-critical process data is transferred by
Obj / object means of the "process data objects" (PDOs).
The PDOs can be freely exchanged between
Term for data / messages which can be the individual nodes (PDO linking). In addition
exchanged in the CANopen network. it is defined whether data exchange is to be
>
event-controlled (asynchronous) or
Object directory synchronised. Depending on the type of data
to be transferred the correct selection of the
Contains all CANopen communication
type of transmission can lead to considerable
parameters of a device as well as
relief for the →CAN bus.
device-specific parameters and data.
>
According to the protocol, these services are
unconfirmed data transmission: it is not
OBV checked whether the receiver receives the
Contains all CANopen communication message. Exchange of network variables
parameters of a device as well as corresponds to a "1 to n connection"
device-specific parameters and data. (1 transmitter to n receivers).
>
>
OPC PDU
OPC = OLE for Process Control PDU = Protocol Data Unit.
Standardised software interface for The PDU is an item of the →CAN protocol
manufacturer-independent communication in →SAE J1939. PDU indicates a part of the
automation technology destination or source address.
>
>
PGN
P PGN = Parameter Group Number
PGN = PDU format (PF) + PDU source (PS)
PC card The parameter group number is an item of the
→CAN protocol →SAE J1939. PGN collects
→PCMCIA card
>
the address parts PF and PS.
375
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
>
Pictogram PWM
Pictograms are figurative symbols which PWM = pulse width modulation
convey information by a simplified graphic The PWM output signal is a pulsed signal
representation. (→ chapter What do the symbols between GND and supply voltage.
and formats mean? (→ page 7)) Within a defined period (PWM frequency) the
>
(proportional–integral–derivative controller)
consists of the following parts: R
• P = proportional part
• I = integral part ratiometric
• D = differential part (but not for the controller Measurements can also be performed
CR04nn, CR253n). ratiometrically. If the output signal of a sensor
>
376
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
rw Self-test
RW = read/ write Test program that actively tests components or
Bidirectional data transmission: Data can be devices. The program is started by the user
read and also changed. and takes a certain time. The result is a test
>
information.
Standard: Recommended Practice for a Serial stopped
Control and Communications Vehicle Network Operating status of a CANopen participant. In
• Part 2: Agricultural and Forestry Off-Road this mode only →NMT commands are
Machinery Control and Communication transferred.
Network >
TCP
>
377
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Glossary of Terms
Template
A template can be filled with content.
Here: A structure of pre-configured software
elements as basis for an application program.
>
U
UDP
UDP (User Datagram Protocol) is a minimal
connectionless network protocol which belongs
to the transport layer of the internet protocol
family. The task of UDP is to ensure that data
which is transmitted via the internet is passed
to the right application.
At present network variables based on →CAN
and UDP are implemented. The values of the
variables are automatically exchanged on the
basis of broadcast messages. In UDP they are
implemented as broadcast messages, in CAN
as →PDOs.
According to the protocol, these services are
unconfirmed data transmission: it is not
checked whether the receiver receives the
message. Exchange of network variables
corresponds to a "1 to n connection"
(1 transmitter to n receivers).
>
Use, intended
Use of a product in accordance with the
information provided in the instructions for use.
>
W
Watchdog
In general the term watchdog is used for a
component of a system which watches the
function of other components. If a possible
malfunction is detected, this is either signalled
or suitable program branchings are activated.
The signal or branchings serve as a trigger for
other co-operating system components to
solve the problem.
>
wo
WO = write only
Unidirectional data transmission: Data can only
be changed and not read.
378
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Index
CAN_TX_ENH_CYCLIC ......................................................................251
11 Index CANopen
Tables .......................................................................................................... 354
A CANopen error code ............................................................................366
CANopen status of the node ...............................................................365
About this manual ....................................................................................5
CANopen tables...................................................................................354
Access the device with SSH ................................................................120
CANOPEN_ENABLE ...........................................................................260
Access the device with Telnet .............................................................120
CANOPEN_GETBUFFERFLAGS .......................................................262
Access to the Linux runtime system ....................................................119
CANOPEN_GETEMCYMESSAGES...................................................300
Activate network variable support .......................................................101
CANOPEN_GETERRORREGISTER ..................................................302
Activate the access protection for an IEC project .................................92
CANOPEN_GETGUARDHBERRLIST ................................................295
Add additional libraries ........................................................................115
CANOPEN_GETGUARDHBSTATSLV ...............................................297
Address ................................................................................................370
CANOPEN_GETNMTSTATESLAVE ..................................................269
Address assignment in Ethernet networks ..........................................346
CANOPEN_GETODCHANGEDFLAG ................................................273
Analogue inputs .....................................................................................22
CANOPEN_GETSTATE ......................................................................264
Analogue video input .............................................................................25
CANOPEN_GETSYNCSTATE ............................................................291
Annex ...................................................................................................345
CANOPEN_NMTSERVICES ...............................................................270
Application program ...............................................................................27
CANOPEN_READOBJECTDICT ........................................................274
Application software.............................................................................370
CANOPEN_SDOREAD .......................................................................278
Architecture..........................................................................................370
CANOPEN_SDOREADBLOCK ...........................................................280
Audio signalling device (buzzer) ............................................................15
CANOPEN_SDOREADMULTI ............................................................282
Automatically restore system files .........................................................84
CANOPEN_SDOWRITE .....................................................................284
B CANOPEN_SDOWRITEBLOCK .........................................................286
CANOPEN_SDOWRITEMULTI...........................................................288
Backup CANOPEN_SENDEMCYMESSAGE ..................................................304
Save the system files .................................................................................... 72
CANOPEN_SETSTATE ......................................................................266
Save the system information......................................................................... 71
CANOPEN_SETSYNCSTATE ............................................................293
Baud.....................................................................................................370
CANOPEN_WRITEOBJECTDICT ......................................................275
Binary inputs ..........................................................................................21
Characteristics of the pressure point ...................................................141
Binary output..........................................................................................23
CiA .......................................................................................................370
Boot loader ..........................................................................................370
CiA DS 304 ..........................................................................................370
Boot-up message.................................................................................360
CiA DS 401 ..........................................................................................370
Bus .......................................................................................................370
CiA DS 402 ..........................................................................................370
BUZZER_CLICK ..................................................................................194
CiA DS 403 ..........................................................................................370
BUZZER_ON .......................................................................................195
CiA DS 404 ..........................................................................................370
C CiA DS 405 ..........................................................................................370
CiA DS 406 ..........................................................................................371
Calibration of the touch screen............................................................142
CiA DS 407 ..........................................................................................371
Camera visualisation .............................................................................18
Clamp 15..............................................................................................371
CamsOffOnPageSwitch.......................................................................173
COB ID.................................................................................................371
CAN ...............................................................................................24, 370
CODESYS ...........................................................................................371
CAN / CANopen
CODESYS programming manual ............................................................7
errors and error handling............................................................................. 344
CODESYS visualisation elements.......................................................130
CAN stack ............................................................................................370
Complete and transmit the project (global network variables) ............103
CAN test
Components of the runtime system.......................................................33
Receive data.................................................................................................. 67
Transmit data................................................................................................. 66 Configuration
camera image .............................................................................................. 144
CAN_ENABLE .....................................................................................232
Configuration of the camera image .....................................................144
CAN_RECOVER .................................................................................233
Configuration of the inputs and outputs...............................................123
CAN_REMOTE_REQUEST ................................................................254
Configure camera image .....................................................................152
CAN_REMOTE_RESPONSE..............................................................256
Configure CAN interfaces ......................................................................89
CAN_RX ..............................................................................................238
Configure input ....................................................................................124
CAN_RX_ENH.....................................................................................239
Configure IP parameter of ethernet interface ........................................37
CAN_RX_ENH_FIFO ..........................................................................241
Configure output ..................................................................................124
CAN_RX_RANGE ...............................................................................243
Configure the camera bitmap in the dialogue [Bitmap Configuration] 145
CAN_RX_RANGE_FIFO .....................................................................245
Configure the controller .........................................................................88
CAN_SETDOWNLOADID ...................................................................234
Configure the device as CANopen master ............................................89
CAN_STATUS .....................................................................................235
Configure the device as CanSlave ........................................................90
CAN_TX ...............................................................................................248
Configure the IP parameter manually....................................................39
CAN_TX_ENH .....................................................................................249
Configuring functions of operating elements .......................................133
379
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Index
380
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Index
Insert an analogue camera image in a CODESYS project .................151 Limitations for program and data memories ..........................................16
Insert an Ethernet camera image in a CODESYS project ..................144 Limitations for visualisations ................................................................129
Install and set up mobile camera.........................................................143 Link ......................................................................................................374
Install fonts (true type fonts) ................................................................137 LOAD_SPLASH_SCREEN..................................................................171
Install the CODESYS programming system..........................................30 LSB ......................................................................................................374
Install the device-specific target package .............................................30
Installation ..............................................................................................29 M
Instructions ..........................................................................................373 MAC-ID ................................................................................................374
Integrate libraries .................................................................................102 Master ..................................................................................................374
Intended use ........................................................................................373 Mirror the camera image at its horizontal axis ........................... 146, 152
Interfaces ...............................................................................................19 Misuse..................................................................................................374
Internal parameters............................................................. 209, 212, 217 MMI ......................................................................................................374
IP address............................................................................................373 Movement of elements ........................................................................131
ISO 11898 ............................................................................................374 MRAM ..................................................................................................374
ISO 11992 ............................................................................................374 MSB .....................................................................................................374
ISO 16845 ............................................................................................374
N
J
Navigation key .......................................................................................49
J1939 ...................................................................................................374 Network management (NMT) ..............................................................361
J1939_DM1RX ....................................................................................335 Network management commands.......................................................362
J1939_DM1TX .....................................................................................337 Network variables via UDP ....................................................................97
J1939_DM1TX_CFG ...........................................................................340 NMT .....................................................................................................374
J1939_DM3TX .....................................................................................342 NMT state ............................................................................................362
J1939_ENABLE ...................................................................................308 NMT state for CANopen master ..........................................................363
J1939_GETDABYNAME .....................................................................310 NMT state for CANopen slave .............................................................364
J1939_NAME.......................................................................................312 Node ....................................................................................................375
J1939_RX ............................................................................................321 Node Guarding ....................................................................................375
J1939_RX_FIFO ..................................................................................323 NORM_DINT .......................................................................................182
J1939_RX_MULTI ...............................................................................325 NORM_REAL ......................................................................................183
J1939_SPEC_REQ .............................................................................316 Note the cycle time! .............................................................................111
J1939_SPEC_REQ_MULTI ................................................................318 Note! ......................................................................................................10
J1939_STATUS ...................................................................................314 Notes..............................................................................................32, 124
J1939_TX.............................................................................................327 Notes on visualisations ........................................................................126
J1939_TX_ENH ...................................................................................328 Notizen • Notes • Notes .......................................................................384
J1939_TX_ENH_CYCLIC ...................................................................330 Numbering of the operating elements .................................................134
J1939_TX_ENH_MULTI ......................................................................332
O
K
Obj / object ...........................................................................................375
Key assignment in recovery mode ........................................................33 Object 0x1001 (error register) .............................................................369
Key functionality.....................................................................................44 Object directory....................................................................................375
Key LEDs ...............................................................................................15 OBV .....................................................................................................375
KEY_CLICK .........................................................................................196 OPC .....................................................................................................375
KEY_MAPPING ...................................................................................174 Open the configuration dialogue ................................................ 145, 152
Keywords for edit controls ...................................................................135 Operating elements ...............................................................................15
Operating instructions............................................................................43
L Operating modes ...................................................................................21
LED ......................................................................................................374 Operating modes of the inputs / outputs .............................................353
Libraries ...............................................................................................110 Operating sequence ............................................................................112
Library ifm_CANopen_NT_Vxxyyzz.LIB..............................................161 Operating states ....................................................................................28
Library ifm_CR1082_Vxxyyzz.LIB .......................................................157 Operation
Library ifm_J1939_NT_Vxxyyzz.LIB ...................................................163 Enter a text using the on-screen keyboard ................................................... 48
Library ifm_NetVarLib_NT_Vxxyyzz.LIB .............................................163 Navigate in the file directory .......................................................................... 47
Library ifm_PDM_input_V01yyzz.LIB ..................................................159 Navigate in the setup menu .......................................................................... 45
Navigate within a menu screen ..................................................................... 46
Library ifm_PDM360NG_linux_syscall_asynch_V02yyzz.LIB ............158
Operational ..........................................................................................375
Library ifm_PDM360NG_special_V02yyzz.LIB ...................................158
Output parameters ...............................................................................171
Library ifm_PDM360NG_USB_LL_V02yyzz.LIB.................................159
Outputs (technology) .............................................................................23
Library ifm_PDM360NG_USB_Vxxyyzz.lib .........................................159
OverlayVisu .........................................................................................205
Library ifm_PDMng_util_Vxxyyzz.LIB .................................................158
Overview
Library ifm_RAWCan_NT_Vxxyyzz.LIB ..............................................160
documentation modules for ecomatmobile devices ....................................... 6
381
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Index
382
ifm Programming manual PDM360 NG Touch (CR1082) V02.03.xx CODESYS 2.3 2015-08-27
Index
T
Target...................................................................................................377
TCP ......................................................................................................377
Template ..............................................................................................378
Test transmission of the global network variables ..............................109
Texts ....................................................................................................126
TOGGLE ..............................................................................................184
Touchscreen ..........................................................................................49
TouchScreenDisable ...........................................................................172
Transmit projects .................................................................................109
U
UDP .....................................................................................................378
Update the runtime system....................................................................34
Update the runtime system of the device ..............................................31
USB........................................................................................................24
USB_STORAGE_HANDLER ..............................................................191
USB_STORAGE_MANAGER .............................................................186
USB_STORAGE_REMOVE ................................................................188
Use access protection ...........................................................................91
Use edit controls ..................................................................................135
Use of optical and acustical feedback .................................................136
Use of the Ethernet camera image in CODESYS ...............................147
Use of touch screen functions .............................................................139
Use the analogue camera image in CODESYS ..................................154
Use visual feedback.............................................................................141
Use visualisations ................................................................................125
Use, intended.......................................................................................378
V
Variables ................................................................................................96
VERSION .............................................................................................227
Visualisation limits ...............................................................................128
W
watchdog..................................................................................... 111, 378
Watchdog .............................................................................................378
383
12 Notizen • Notes • Notes
13 ifm weltweit • ifm worldwide • ifm à l’échelle
internationale
Version: 2015-03-06 8310