o2i5xx gb software manual

Software manualO2I5xx

1139

6497

/ 00

03

/ 20

21

GB

/

O2I5xx

2

Contents1 Preliminary note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.1 Symbols used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2 Legal and copyright information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3 Open source information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Safety instructions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 Intended use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

4 Disclaimer of warranties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

5 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105.2 Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105.3 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

5.3.1 Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

6 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

7 Command line parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

8 Start page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158.1 Find sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

8.1.1 Connecting the device manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178.2 Connecting a device that has already been used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178.3 Playing back image captures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

8.3.1 Converting an image capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

9 Structure of the user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

10 Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

11 Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2311.1 Images & trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

11.1.1 Add new image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3011.1.2 Trigger mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3011.1.3 Frame rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3111.1.4 Focus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3111.1.5 Reference image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3111.1.6 Exposure time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3211.1.7 Analogue gain factor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3211.1.8 Illumination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3211.1.9 Filter type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3211.1.10 Filter strength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3311.1.11 Invert image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3311.1.12 Image quality check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

11.2 Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3411.2.1 Add new model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3611.2.2 1D barcode: Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

11.2.2.1 1D barcode: Code family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3811.2.2.2 1D barcode: Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3811.2.2.3 1D barcode: Number of codes per ROI group . . . . . . . . . . . . . . . . . . . . . . . . . 3811.2.2.4 1D barcode: Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3911.2.2.5 1D barcode: Measure ISO quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3911.2.2.6 1D barcode: Check char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4011.2.2.7 1D barcode: Contrast min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4011.2.2.8 1D barcode: Min code length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4111.2.2.9 1D barcode: Quiet zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4111.2.2.10 1D barcode: Use bar orientation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4211.2.2.11 1D barcode: Symbology identifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4211.2.2.12 1D barcode: Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4211.2.2.13 1D barcode: Orientation tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4311.2.2.14 1D barcode: Number of scanlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4311.2.2.15 1D barcode: Majority voting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4311.2.2.16 1D barcode: Merge scanlines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

O2I5xx

3

11.2.2.17 1D barcode: Minimum identical scanlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4411.2.2.18 1D barcode: Start/Stop tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4411.2.2.19 1D barcode: Element size variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4411.2.2.20 1D barcode: Barcode height min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.2.2.21 1D barcode: Barcode width min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.2.2.22 1D barcode: ROI size check. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

11.2.3 2D data code: Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4511.2.3.1 2D data code: Code family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4711.2.3.2 2D data code: Presets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4711.2.3.3 2D data code: Encoding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4711.2.3.4 2D data code: Number of codes per ROI group . . . . . . . . . . . . . . . . . . . . . . . . 4811.2.3.5 2D data code: Timeout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4811.2.3.6 2D data code: Quality grading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4811.2.3.7 2D data code: Polarity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5111.2.3.8 2D data code: Strict quiet zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5111.2.3.9 2D data code: Symbology identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5111.2.3.10 2D data code: Contrast tolerance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5211.2.3.11 2D data code: Finder pattern tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5311.2.3.12 2D data code: Module grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5311.2.3.13 2D data code: Max slant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5311.2.3.14 2D data code: Mirrored . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5411.2.3.15 2D data code: Symbol shape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5411.2.3.16 2D data code: Symbol columns min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5411.2.3.17 2D data code: Symbol columns max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5411.2.3.18 2D data code: Symbol rows min. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5411.2.3.19 2D data code: Symbol rows max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5511.2.3.20 2D data code: Symbol size min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5511.2.3.21 2D data code: Symbol size max. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5511.2.3.22 2D data code: ROI size check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

11.2.4 Creating a region of interest (ROI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5611.2.5 Creating a region of disinterest (ROD) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

11.3 Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5711.4 Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

11.4.1 Logic utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6111.4.2 Logic block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6111.4.3 Output logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6211.4.4 Logic block “Add note” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6311.4.5 Logic blocks “Model results” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6311.4.6 Logic block “Application result” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6711.4.7 Logic blocks “String operations” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6811.4.8 Logic blocks “Binary operations” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6911.4.9 Logic blocks “Arithmetic” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7011.4.10 Logic blocks “Converter” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7011.4.11 Logic blocks “Digitalisation”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7111.4.12 Logic blocks “Logical functions” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7111.4.13 Logic blocks “Output” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7111.4.14 Logic blocks “Pin events” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7211.4.15 Logic block “Statistics” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7211.4.16 Example 1 of “Compare reference code”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7211.4.17 Example 2 of “Compare reference code”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7311.4.18 Example 3 of “Compare reference code”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

11.5 Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7411.5.1 Insert data package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7711.5.2 Example of “Provide overall quality” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

11.6 Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

12 Service report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

13 Device setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8313.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8313.2 Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8413.3 Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8513.4 NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

GB

O2I5xx

4

13.5 FTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8713.6 RTSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8813.7 ifm storage device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

14 Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9114.1 Assigning a static IP address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

List of figures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

List of tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

O2I5xx

5

1 Preliminary noteYou will find instructions, technical data, approvals and further information using the QR code on theunit / packaging or at www.ifm.com.

1.1 Symbols usedRequirement

Instructions

Reaction, result

[...] Designation of keys, buttons or indications

Cross-reference

Important noteNon-compliance may result in malfunction or interference.

InformationSupplementary note

1.2 Legal and copyright information© All rights reserved by ifm electronic gmbh. No part of these instructions may be reproduced andused without the consent of ifm electronic gmbh.

All product names, pictures, companies or other brands used on our pages are the property of therespective rights owners.

• AS-i is the property of AS-International Association, (→ www.as-interface.net)

• CAN is the property of Robert Bosch GmbH, Germany (→ www.bosch.de)

• CAN is the property of CiA (CAN in Automation e.V.), Germany (→ www.can-cia.org)

• CODESYS™ is the property of CODESYS GmbH, Germany (→ www.codesys.com)

• DeviceNet™ is the property of ODVA™ (Open DeviceNet Vendor Association), USA(→ www.odva.org)

• EtherNet/IP® is the property of → ODVA™

• EtherCAT® is a registered trademark and patented technology, licensed byBeckhoff Automation GmbH, Germany.

• IO-Link® is the property of PROFIBUS Nutzerorganisation e.V., Germany (→ www.io-link.com)

• ISOBUS is the property of AEF - Agricultural Industry Electronics Foundation e.V., Germany(→ www.aef-online.org)

• Microsoft® is the property of Microsoft Corporation, USA (→ www.microsoft.com)

• Modbus® is the property of Schneider Electric SE, France (→ www.schneider-electric.com)

• PROFIBUS® is the property of PROFIBUS Nutzerorganisation e.V., Germany(→ www.profibus.com)

• PROFINET® is the property of → PROFIBUS Nutzerorganisation e.V., Deutschland

• Windows® is the property of → Microsoft Corporation, USA

1.3 Open source informationThis product can contain Free Software or Open Source Software from various software developerswhich is subject to the following licenses: General Public License version 1, version 2 and version 3(General Public License version 3 in conjunction with the GNU Compiler Collection Runtime Library

GB

http://www.ifm.com

http://www.as-interface.net/

http://www.bosch.de

http://www.can-cia.org/

http://www.codesys.com/

http://www.odva.org/

http://www.io-link.com/

http://www.aef-online.org/

http://www.microsoft.com/

http://www.schneider-electric.com/

http://www.profibus.com/

O2I5xx

6

Exception version 3.1), Lesser General Public License version 2.1, Lesser General Public Licenseversion 3, Berkeley Software Distribution („This product includes software developed by the Universityof California, Berkeley and its contributors“), The Academic Free License version 2.1. For thecomponents subject to the General Public License in their respective versions the following applies:

This program is free software: you can redistribute it and/or modify it under the terms of the GNUGeneral Public License as published by the Free Software Foundation. If version 1 applies to thesoftware: either version 1 of the License or (at your option) any later version; if version 2 (or 2.1)applies to the software: either version 2 (or 2.1) of the License or (at your option) any later version; ifversion 3 applies to the software: either version 3 of the License or (at your option) any later version.The following disclaimer of the software developers applies to the software components that aresubject to the General Public License or the Lesser General Public License in their respectiveversions: The Free Software is distributed in the hope that it will be useful, but WITHOUT ANYWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR APARTICULAR PURPOSE. See the GNU General Public License and the GNU Lesser General PublicLicense for more details.

The responsibility of ifm electronic gmbh for ifm products, in the case of product-specific software,remains unaffected by the above disclaimer. Please note that the firmware for the ifm products is insome cases provided free of charge. The price of the ifm products has then to be paid for therespective device itself (hardware) and not for the firmware. For the latest information on the licenseagreement for your product please visit www.ifm.com

For binaries that are licensed under any version of the GNU General Public License (GPL) or the GNULGPL you may obtain the complete corresponding source code of the GPL software from us bysending a written request to: [email protected] or to ifm electronic gmbh, Friedrichstraße 1, 45128Essen, Germany.

We charge €30 for each request. Please write “source for product Y” in the memo line of yourpayment. Your request should include (i) the name of the covered binary, (ii) the name and the versionnumber of the ifm product, (iii) your name and (iv) your return address.

This offer is valid to anyone in receipt of this information. This offer is valid for at least three years(from the date you received the GPL/LGPL covered code).

O2I5xx

7

2 Safety instructionsPlease read the operating instructions prior to set-up of the device. The device must be suitable for theapplication without any restrictions.

If the operating instructions or the technical data are not adhered to, personal injury and damage toproperty can occur.

GB

O2I5xx

8

3 Intended useThe software manual describes the functions of the software ifmVisionAssistant:

• recognising the device in the local subnet,

• configuring the device,

• collecting, storing and evaluating data,

• installing and monitoring applications on the device.

As soon as an application has been installed on the device, the device can be operated without theifmVisionAssistant.

O2I5xx

9

4 Disclaimer of warrantiesifm electronic gmbh disclaims to the fullest extent authorized by law any and all warranties, whetherexpress or implied, including, without limitation, any implied warranties of title, non-infringement, quietenjoyment, integration, merchantability or fitness for a particular purpose.

Without limitation of the foregoing, ifm expressly does not warrant that:

• the software will meet your requirements or expectations,

• the software or the software content will be free of bugs, errors, viruses or other defects,

• any results, output, or data provided through or generated by the software will be accurate, up-to-date, complete or reliable,

• the software will be compatible with third party software,

• any errors in the software will be corrected.

Demo software and templatesDemo software and templates are provided “as is” (that is: excluding warranty) and “as available”,without any warranty of any kind, either express or implied. The user acknowledges and agrees to usethe software at user’s own risk. In no event shall ifm be held liable for any direct, indirect, incidental orconsequential damages arising out of the use of or incorrect use the software. The user may use thesoftware solely for demonstration purposes and to assess the software functionalities and capabilities.

Customer-specific software1. The software created and used has been put together by ifm especially for the customer using

modular software components made by ifm for numerous applications (standard software modules)and adapted to the contractual service required (customer-specific application program).

2. Upon complete payment of the purchase price for the customer-specific application program, ifmtransfers the non-exclusive, locally and temporarily unrestricted usage right thereof to thecustomer, without the customer acquiring any rights of any kind to the standard software module onwhich the individual or customer-specific adaptation is based. Notwithstanding these provisions, ifmreserves the right to produce and offer customer-specific software solutions of the same kind forother customers based on other terms of reference. In any case ifm retains a simple right of usageof the customer–specific solution for internal purposes.

3. By accepting the program, the user acknowledges and agrees to use the software at user’s ownrisk. By accepting the program, the user also acknowledges that the software meets therequirements of the specifications agreed upon. ifm disclaims any and all warranties, in particularregarding fitness of the software for a particular purpose.

GB

O2I5xx

10

5 Installation

5.1 System requirementsSoftwareThe following software is required for operation:

• Operating system: Windows 10 (32/64 bits)

• Software ifmVisionAssistant: 2.3 or higher

Other versions

w Other versions of the software or firmware may contain changed or new functions which arenot described in this software manual.

HardwareThe following hardware is required for operation:

• Hard disk: min. 1 GB free memory space

• Monitor: Resolution of min. 1024x768 pixels, 32-bit colour depth

Accessories• Cables for the network connection (Ethernet) for setting the parameters:

– E11898 (2 m, M12 plug/RJ45 plug, 4 poles)

– E12283 (5 m, M12 plug/RJ45 plug, 4 poles)

• Connection cables for voltage supply and process connection:

– EVC070 (2 m, M12 socket, 5 poles, open cable end)

– EVC071 (5 m, M12 socket, 5 poles, open cable end)

• Y splitters:

– EVC847 (splitter for camera and external trigger)

– EVC848 (splitter for camera and external illumination unit)

• Power supply 24 V, 1.6 A

• Mounting set for the device (clamp mounting): E2D500

w Further information about the accessories: www.ifm.com

5.2 Hardwarew Detailed information about installation and electrical connection of the hardware can be

found in the operating instructions of the device.

5.3 SoftwareInstalling the ifmVisionAssistant:

u Download the ifmVisionAssistant from the website: www.ifm.com

http://www.ifm.com

O2I5xx

11

u Copy the zip file to a directory on the PC and unzip.

w The ifmVisionAssistant is installed an can be started via the file „ifmVisionAssistant.exe“.

ifmVisionAssistant does not start

w If the ifmVisionAssistant does not appear within 5-10 seconds after starting:

u Check the system requirements. (Ò System requirements / 10)

u Check the unzipped zip file for completeness.

5.3.1 UninstallUninstalling the ifmVisionAssistant:

u Delete the installation folder of the ifmVisionAssistant.

w The ifmVisionAssistant is uninstalled.

w Existing settings and log files are not deleted.

Deleting the settings and log files:

u Delete the following directory: „ %AppData%\ifm electronic\ifmVisionAssistant “

GB

O2I5xx

12

6 Getting startedThe chapter “First steps” explains the first steps with the device and the ifmVisionAssistant software.

Connecting the deviceInstallation and electrical connection are described in the operating instructions of the device.

Using the ifmVisionAssistantu Start the ifmVisionAssistant software. (Ò Software / 10)

u Click the button [Find device] on the start page. (Ò Find sensor / 16)

w Once the device is connected, the area “Monitor” is displayed.

ifmVisionAssistant: Area “Monitor”The area “Monitor” displays the received data of the device in a live image. In the area “Monitor”, theactive application is monitored.

ifmVisionAssistant: Area “Application”An application sets the device for a specific application. Up to 32 applications can be stored on thedevice. You can quickly switch between the applications.

Typically, an application contains the following settings:

• Camera of the device and trigger: Images and trigger (Ò Images & trigger / 26)

• Search for codes within the image: Models (Ò Models / 34)

• Sequence of the processing of images and models: Flow (Ò Flow / 57)

• Output logic for data transfer to an external controller: Logic (Ò Logic / 60)

• Configuration of the output via the interfaces: Interfaces (Ò Interfaces / 74)

• Collection of statistical data: Test (Ò Test / 78)

Detecting a code with the device

u Click the button [Application]: .

w The area “application” indicates the applications stored on the device. (Ò Application / 23)

u Click the button [Add new application]: .

u Select the [Single-code detection] from the list.

w The wizard [Single-code detection] guides you through adding an application in several steps. Thenthe area “Monitor” is displayed.

The device is now ready for operation and detects the set codes.

O2I5xx

13

7 Command line parametersStarting the ifmVisionAssistant is influenced by command line parameters.

Starting the ifmVisionAssistant via the prompt:

u In the prompt, enter the parameters after “ifmVisionAssistant.exe” separated by a space.

w Example: “ifmVisionAssistant.exe -log”

Starting the ifm Vision Assistant with parameters via the Windows graphical user interface:

u Click on the [ifmVisionAssistant] link on the right.

u Click [Properties] in the submenu.

u Click tab [Shortcut].

u Click the field [Target] and move the cursor to the end of the line.

u Enter space followed by the command line parameter.

u Click [OK].

The following command line parameters are available:

Command line parameters Description

-disableclosebtn Disables the button [Close] on the start page.

-log Creates a log file for a detailed fault analysis.The log file is saved in the following folder:"%APPDATA%\ifmelectronic\ifmVisionAssistant\logs"

-autoconnect filename.xml Automatically establishes the connection to a device. Thefile “filename.xml” must contain the following XML code:<?xml version="1.0"encoding="UTF-8"?><sensor><sensorType>O2I5xx</sensorType><addressType>IP</addressType><name>My sensor</name><address><ip>192.168.0.69</ip><pcic_port>50010</pcic_port><web_port>80</web_port><mac>00:02:01:21:b9:ee</mac></address></sensor>

GB

O2I5xx

14

Command line parameters Description

-geometry [screen]:[width]x[height]+[x]+[y] Sets the window size and position of the ifmVisionAssistant(incl. window frame). The minimum window size is1024x768 pixels.Example:-geometry 1:1380x768+0+0"

The window is placed on screen 1 (screen=1).The window size incl. Windows window frame is set to1380x768 (width = 1380 and height = 768).The window is positioned at the top left (x=0 and y=0).When negative values are entered for the window position xand y, the opposite corner is used as zero point. Example:“+0+0” window at the top left“-0+0” window at the top right“+0-0” window at the bottom left“-0-0” window at the bottom right-frameless starts the ifmVisionAssistant

-frameless Starts the ifmVisionAssistant without the native windowframe.

O2I5xx

15

8 Start pageThe start page contains the basic functions of the ifmVisionAssistant.

Fig. 1: Start page

Symbol Name Description

Zoom out Reduces the size of the window.

Zoom in Enlarges the window.

Full screen Displays the window in full screen.

Exit Closes the software.

Tab. 1: Title bar

w With the F11 key, you can switch between full screen and window view.

Name Description

Device status Displays information about the hardware and firmware of theconnected device.The information can be saved in a text file for diagnostics bythe support people.For the function [Device status], the device must be connect-ed.

Wiring Displays information on wiring and connection aids.

GB

O2I5xx

16

Name Description

Settings Sets the language and colour of the user interface.

Help Displays the documentation and contact information of thesupport.

Tab. 2: Menu bar

Button Name Description

Find sensor Searches for connected devices and dis-plays them in a list. (Ò Find sen-sor / 16)For this function, the device must beconnected.

Recent Displays devices that have already beenused before in a list. (Ò Connecting adevice that has already beenused / 17)For this function, the device must beconnected.

Replay Plays back a saved image capture. (ÒPlaying back image captures / 17)

Tab. 3: Buttons

8.1 Find sensorThis function searches for new devices and displays them in a list. A device can then be connected.

Preparationsu Connect the device to the voltage supply.

u Connect the device to a PC via Ethernet.

u Unblock the following ports in the network firewall:- UDP port:“3321”- TCP/HTTP: “80” and “8080”- TCP: “50010“

Connecting a new device

u Click the button [Find sensor]:

w The ifmVisionAssistant searches for connected devices. A list shows the devices found and theirsettings.

u Select a found device.

w The connection to the device will be established.

Connection problems

w If the device is not found:

u Check the connections and the operating status of the device.

u The IP addresses of the device and the PC must be in the same subnet.

u Connect the device to the PC directly via Ethernet without network devices (e.g. router).

u Connect the device manually. (Ò Connecting the device manually / 17)

Messages in the ifmVisionAssistant

w With the key combination Ctrl+C, the text of a message is copied to the clipboard.

O2I5xx

17

8.1.1 Connecting the device manuallyA device can be connected manually by entering the IP address.

u Click the button [Find sensor]:

u Click the message [Manual connection].

w The window “Manual connection” is displayed.

u Select [O2I manual connection] in the list.

u Enter the IP address of the device.

w The default IP address is “192.168.0.69“.

u Click on the button [Connect].

Connection problems

w The IP addresses of the device and the PC must be in the same subnet.

8.2 Connecting a device that has already been usedThis function displays devices that have already been used before in a list. The devices can then beconnected.

u Click the button [Recent]:

w The window “Recent” is displayed.

u Select a device from the list.

w The device is connected.

8.3 Playing back image capturesThe function [Replay] plays back a saved image capture. The function contains the following operatingelements:

Operating element Name Description

Previous image Jumps to the previous image.

Replay Starts the replay.

Next image Jumps to the next image.

Pause Pauses the replay.

Progress bar Indicates the current position of the re-play.

[Open other file] Open other file Opens another image capture.

Tab. 4: Operating elements

Playing back image captures

u Click the button [Replay]:

w A window for opening an image capture is displayed. The image captures are saved in thefollowing folder by default: %appdata%\ifm electronic\ifmVisionAssistant\capture

GB

O2I5xx

18

u Select an image capture.

u Click the button [Open].

w The image capture is displayed.

8.3.1 Converting an image captureThis function converts an image capture into another output format. The image capture is convertedvia the following operating elements.

Operating element Type Description

[Output format] List Sets the output format (see table below).

[Output path] Output field Displays the set output directory.

[Output file path] Output field Displays the set output file.

[…] Button Sets the output directory or the outputfile.

[Data format] List Sets the output format (see table below).

[Create surfaces] Checkbox Activates the checkbox [Create surfac-es].

[Output range] List Sets the output range (see table below).

[Convert] Button Starts converting the image capture.

Tab. 5: Operating elements

w Depending on the output format set, some operating elements are not displayed.

Output format

Output format Description

[HDF5 ifm streams (*.h5)] Flexible data container

[Data capture files (*.dat)] Proprietary format

[O3D3XX CSV export of image chunks] Data separated by a comma

[O3D3XX PLY export of point cloud] Point cloud data

Tab. 6: Output format

Data format

Data format Description

[ASCII] Sets the data format to “ASCII”.

[Binary little endian] Sets the data format to “Binary little endian”.

[Binary big endian] Sets the data format to “Binary big endian”.

Tab. 7: Data format

Output range

Output range Description

Whole file Converts the whole image capture.

From the current position to the end of the file Converts from the current position of the progress bar to theend of the image capture.

From start to current position Converts from the start of the image capture to the current po-sition of the progress bar.

Only the next image Converts the next image of the image capture, viewed fromthe current position of the progress bar.

Tab. 8: Output range

O2I5xx

19

9 Structure of the user interfaceThe user interface is divided into the following areas:

3

21

Fig. 2: User interface1 Navigation bar 2 Main area3 Status bar

Navigation barThe buttons in the navigation bar are used to switch between the areas of the ifmVisionAssistant.

Button Name Description

Monitor Displays the received data of the device.(Ò Monitor / 21)

Application Displays the applications. (Ò Applica-tion / 23)

Service report Displays an evaluation of the device. (ÒService report / 81)

Device setup Displays the device configuration. (ÒDevice setup / 83) The device andnetwork are set in the device configura-tion.

Disconnect Disconnects the connection to the de-vice.

Main areaThe function selected with the navigation bar is displayed in the main area.

Status barThe status bar shows current information about the device:

GB

O2I5xx

20

• the window name which is currently open, e.g. “Monitoring screen”

• the temperature of the device

• frame duration of an image, e.g. “232 ms”

The frame duration is the running time of the signal from the trigger input to the processinterface.

O2I5xx

21

10 MonitorThe area “Monitor” displays the received data of the device in a live image. In the area “Monitor”, theactive application is monitored. The device is in the operating mode.

321

4

Fig. 3: Area “Monitor”1 Status indications 2 Live image3 Code details 4 Tabs

Status indicationsThe “status indications” show the states of the digital outputs and the statistics on the activeapplication.

• “Application”: Indicates the name of the active application.

• “Hardware”: Shows the status of the digital outputs. If a signal is present, the yellow LED is on.

• “Current state”: Shows the current state of the application.

• “Overall statistics”: Shows the recorded values of all models of the active application and thenumber of total measurements. The values “Passed” and “Failed” are incremented via a counter.The ratio of the two values is indicated in per cent.

• “Processing time”: Displays the current, maximum and minimum evaluation time.

• [Reset All Statistics]: This button resets the overall statistics.

Live imageThe “live image” displays the current camera image of the device.

Code detailsThe “code details” display details of the code selected in the live image. The type of code determineswhat details are displayed.

TabsThe area “Monitor” contains the following tabs:

GB

O2I5xx

22

Tab Description

[View Options] Sets the live image.

[Record options] Records the data from the camera and the results of the appli-cations.

[Results] Displays the results of models and images. The results can berestricted to certain models or images.

The tab [View options] contains the following operating elements:


Zoom out Reduces the size of the live image.The zoom level can also be changed us-ing the mouse wheel.

Reset zoom Resets the live image to the standardsize.

Zoom in Enlarges the live image.The zoom level can also be changed us-ing the mouse wheel.

Show all ROIs of all models Displays the ROIs of all models in thelive image.

Overlay application reference image Displays the reference image in the liveimage. The button [Overlay applicationreference image] is displayed as soonas a reference image has been saved.(Ò Reference image / 31)The slider adjusts the transparency ofthe reference image. The colour field tothe right of the slider sets the colour ofthe reference image.

The tab [Record options] contains the following operating elements:


Save current image as JPEG Saves the current live image as a JPEGfile.

[Duration] Duration Sets the duration of the image capture.Approx. 250 MB/minute are required.If the duration is set to [Continuous], theimage capture is limited by the freememory capacity of the data carrier.

Start/Stop Starts or stops the image capture. Theimage capture is saved in a file with theextension “*.h5” or “*.dat“.

- / 02:00 Image capture time Shows the duration of the current imagecapture and the maximum capture time.

The tab [Results] contains the following operating elements:


Filter table by selected image Filters the table according to the select-ed image.

Filter table by selected model Filters the table according to the select-ed model.

[Show ROI group results] Show ROI groups results Shows the results of the ROI groups inthe table.

The results can be copied to the clipboard with the key combination Ctrl+C.

O2I5xx

23

11 ApplicationThe area “Application” manages the applications of the connected device. An application containsapplication-specific settings.

Typically, an application contains the following settings:

• Camera of the device and trigger: Images and trigger (Ò Images & trigger / 26)

• Search for codes within the image: Models (Ò Models / 34)

• Sequence of the processing of images and models: Flow (Ò Flow / 57)

• Output logic for data transfer to an external controller: Logic (Ò Logic / 60)

• Configuration of the output via the interfaces: Interfaces (Ò Interfaces / 74)

• Collection of statistical data: Test (Ò Test / 78)

Fig. 4: Area “Application”

A maximum of 32 applications can be managed.

The area “application” contains the following operating elements:

GB

O2I5xx

24


Add new application Displays 2 buttons that can be used toadd a new application:[User-defined mode]: Starts the user-de-fined mode. All settings are displayed.The mode is intended for advanced us-ers.[Single-code detection]: Starts the wiz-ard “Single-code detection”. The wizardguides you through adding an applica-tion in several steps.

Import application Imports one or more applications from afile with the extension “*.o2i5xxapp“.

Export all applications / Export applica-tion

Exports one or more applications to afile with the extension “*.o2i5xxapp“.

Delete all applications / Delete applica-tion

Deletes all applications or a single appli-cation after confirmation.Deleted applications cannot be restored.

Activate Activates the selected application.

Duplicate Duplicates the selected application. Theduplicate can be used for tests, for ex-ample.

Save Saves the changed application details.

Discard unsaved changes Discards the changed application detailsand restores the status saved last.

[Edit application] Edit application Edits the application-specific settings ofthe selected application in the “user-de-fined mode“.If the application was created with thewizard “Single-code detection”, the wiz-ard opens.

[Edit without wizard] Edit without wizard Edits the selected application in the “us-er-defined mode“. All settings are dis-played.The button is only displayed for applica-tions that have been added with the wiz-ard “Single-code detection”.

[Application] Application name Sets the name of the selected applica-tion.

[Application description] Application description Sets a description for the selected appli-cation.

[Application details] Application details Displays details of the selected applica-tion.

Edit applicationThe application is set in the area “Edit application”. An application contains application-specificsettings.

O2I5xx

25

1 2 3

Fig. 5: Area “Edit application”1 Navigation bar 2 Settings3 Main area

The area “Edit application” can be accessed in two ways:

• by adding a new application,

• by editing the selected application.

Navigation barThe buttons in the navigation bar are used to switch between functions.

Function Name Description

Images & trigger Sets the image and trigger settings ofthe application. (Ò Images & trig-ger / 26)

Model settings Sets the code types. (Ò Models / 34)

Flow Sets the evaluation order of the imagesand models. (Ò Flow / 57)

Logic Sets the output logic. (Ò Logic / 60)The model and pin events are assignedto the outputs in the output logic.

GB

O2I5xx

26

Function Name Description

Interfaces Sets the data packages which are sentvia the interface. (Ò Interfaces / 74)

Test Displays statistics and states of the con-nected device. (Ò Test / 78)

SettingsThe selected function is set in the settings.

Main areaThe codes found and the live image are displayed in the main area. The live image contains thefollowing operating elements:


Live image Continuously refreshes the live image in-dependently of the set trigger sourceand frame rate.

Force trigger Refreshes the live image once inde-pendently of the set trigger source.

React to all triggers Refreshes the live image on each triggersignal.

Wait for one trigger Refreshes the live image once on thenext trigger signal.

Save snapshot Saves the current live image in a file. Ifseveral images exist, all are saved in afile. The file has the extension “*.o2i5xx-img”.

Load snapshot Loads the live image from a file. Theloaded file is displayed instead of thelive image. The file has the extension“*.o2i5xximg”.If a file contains several images, theremay be an error message when the liveimage is loaded. Before loading the liveimage, add the number of images in theifmVisionAssistant. (Ò Add new im-age / 30)

Toggle viewfinder Activates the laser marking. The lasermarking marks an area in front of thecamera in which the code is placed forteaching by two red laser points.

Enable code reading Activates the reading of codes. Thefunction detects codes in the live image.

Create rectangle ROI Creates a region of interest (ROI) inwhich codes are detected. (Ò Creating aregion of interest (ROI) / 56)

Create rectangle ROD Creates a region of disinterest (ROD) inwhich no codes are detected. (Ò Creat-ing a region of disinterest (ROD) / 57)

Some buttons are only visible in certain areas of the ifmVisionAssistant.

11.1 Images & triggerThe function “Images & trigger” sets the camera of the device and the triggers.

O2I5xx

27

Fig. 6: Function “Images & trigger”

To detect codes, models have to be added. (Ò Models / 34)

The function “Images & trigger” contains the following operating elements:


Button Adds a new image. (Ò Add new im-age / 30)

Area “Trigger & general”


[Trigger mode] List Sets the trigger. (Ò Triggermode / 30)

[Trigger delay] Input field Sets a time delay in [ms] for the trigger.

GB

O2I5xx

28


[Enable burst trigger] Checkbox / input field Activates the burst trigger. The inputfield is used to set how often the applica-tion is triggered. For example, an appli-cation with 3 set images and burst trig-ger=“10” records a total of 30 images.After the image capture, the images areevaluated. The first image rated as“pass” is output. Other images rated as“pass” are discarded.The burst trigger is particularly suitablefor dynamic applications.

[Trigger gate logic] List Sets the logic of the trigger modes [Gat-ed...]:[High active]: As long as the trigger is on“High”, images are captured with a fixedframe rate. The device stops capturingimages on “Low”.[Low active]: As long as the trigger is on“Low”, images are captured with a fixedframe rate. The device stops capturingimages on “High”.

[Only one result per trigger gate] List Sets the handling of found codes in the[Gated...] trigger modes:[Off]: All recorded images are output.[Relaxed]: The trigger mode [Continu-ous] is active. If the gate is active and acode is found: The gate is immediatelyterminated and the result is output. If nocode is found: The gate is terminatedexternally by a controller or a hardwaretrigger after a certain time. If an image istaken at the time of termination, the im-age will still be evaluated.[Strict]: The trigger mode [Continuous] isactive. If the gate is active and a code isfound: The gate is immediately terminat-ed and the result is output. If no code isfound: The gate is terminated externallyby a controller or a hardware trigger af-ter a certain time. If an image is taken atthe time of termination, the image willnot be evaluated.

[Frame rate] Input field Sets the frame rate to be achieved. (ÒFrame rate / 31)The setting is only available for certaintrigger modes.

[Focus] Input field Sets the focus. (Ò Focus / 31)

Button Automatically optimises the focus.

[Rotated by 180°] Checkbox Rotates the live image by 180°.

[Store reference image] Button Saves the current live image as a refer-ence image. (Ò Reference im-age / 31)

Button Deletes the saved reference image.

Area „l1 New image 1” (name):


Button Copies the image and changes to thenew image.

Button Renames the image.

O2I5xx

29


Button Deletes the image.

Button Deactivates the image.

[Exposure time] Input field Sets the exposure time. (Ò Exposuretime / 32)

Button Automatically sets the exposure time.

[Analogue gain factor] List Sets the amplification factor of the ana-logue signal. (Ò Analogue gain fac-tor / 32)

[Illumination] List Sets the internal and external illumina-tion. (Ò Illumination / 32)

[Illumination internal segments] Button Displays the status of the internal illumi-nation.When internal illumination is active, indi-vidual segments are deactivated and ac-tivated by clicking in the graphic.

[Filter type] List Sets the filter for the image. (Ò Filtertype / 32)

[Filter strength] List Sets the intensity of the selected filtertype. (Ò Filter strength / 33)

[Invert image] Checkbox Inverts the brightness values of the im-age. (Ò Invert image / 33)

Area “Image quality check”


[Enabled] Checkbox Activates the image quality check. (ÒImage quality check / 33) The imagequality check checks the image qualityof the entire image and not only thecode quality.

[Reset statistics] Button Resets the statistics.

[Sharpness] Graphical representation Shows the current measuring range (or-ange line), the measured value (greendot) and the permitted value range (bluebrackets).The blue brackets can be moved withinthe graphic.

[Teach] Button Sets the current measuring range as thepermitted value range.

[Mean brightness] Graphical representation Shows the current measuring range (or-ange line), the measured value (greendot) and the permitted value range (bluebrackets).The blue brackets can be moved withinthe graphic.


[Underexposed area] Graphical representation Shows the current measuring range (or-ange line), the measured value (greendot) and the permitted value range (bluebrackets).The blue brackets can be moved withinthe graphic.


GB

O2I5xx

30


[Overexposed area] Graphical representation Shows the current measuring range (or-ange line), the measured value (greendot) and the permitted value range (bluebrackets).The blue brackets can be moved withinthe graphic.


11.1.1 Add new imageThe button [Add new image] adds a new image. The following settings are saved in an “image”:

• Exposure time

• Analogue gain

• Illumination

• Filter

• Image quality check

Up to 5 images with their own settings can be used in parallel. Several images ensure detection ofcodes with different

• qualities,

• surfaces,

• lighting conditions, etc.

11.1.2 Trigger modeThe list [Trigger mode] contains the following trigger modes:

Trigger mode Description

[Continuous] The device continuously captures images. This mode is usu-ally used for tests.

[Process interface] The device is triggered via the process interface (e.g. by aPLC).

[Positive edge] The device is triggered via the rising edge of an input signal.

[Negative edge] The device is triggered via the falling edge of an input signal.

O2I5xx

31

Trigger mode Description

[Both edges] The device is triggered via the rising and falling edge of an in-put signal.

[Gated HW] If [Trigger gate logic] is set to [High active]: The device startscontinuous image capture with a rising edge. As long as thetrigger is on “High”, images are captured with a fixed framerate. The device stops capturing images on “Low”.With [Trigger gate logic] set to [Low active], the behaviour re-verses.

[Gated PCIC] The device starts continuous image capture with the g com-mand of the process interface:1234L0000000081234g1

Images are captured with a fixed frame rate. The device stopscapturing images with the following g command:1234L0000000081234g0

11.1.3 Frame rateThe input field [Frame rate] defines a maximum frame rate for the device.

Set the frame rate:

u Enter the frame rate in the input field [Frame rate] and confirm with [Enter].

The frame rate only influences the trigger modes [Continuous] and [Process interface].

Depending on which additional settings are active, the requested frame rate will not be reached.

11.1.4 FocusThe input field [Focus] sets the distance in meters [m] between the lens and the code to be read. Theoptimum focus has been reached when the code in the live image is sharply displayed and is detectedby the device.

The set focus is used for all images. The focus cannot be set separately for each image.

The focus can be set in 3 ways:

• via the input field,

• via the slider below the input field,

• automatically via the button [Optimise].

In the input field [Focus], the button appears if the focus has been optimised automatically.A click on the button shows the focus levels found by the automatic focus.

11.1.5 Reference imageThe button [Store reference image] saves the current live image as a reference image. The referenceimage is used as an overlay in the area “Monitor”. (Ò Monitor / 21)

GB

O2I5xx

32

The reference image is displayed as an overlay in the live image and is used to help align the device.For example:

• if the orientation of the device has changed and the original position is to be restored.

• if the device is replaced and the new device is to be aligned in the same way.

11.1.6 Exposure timeThe input field [Exposure time] sets the period in “µs” for the image capture.

The exposure time can be set in 3 ways:

• via the input field,

• via the slider below the input field,

• automatically via the button [Optimise].

11.1.7 Analogue gain factorThe list [Analogue gain factor] sets the gain factor of the analogue signal. The analogue gain factorreacts linearly to the exposure time. Therefore, half of the exposure time can be used with doubleanalogue gain factor. Especially dynamic applications benefit from the short exposure times.

The analogue gain factor increases the image noise.

11.1.8 IlluminationThe list [Illumination] sets the internal and external illumination. The following illuminations areavailable:

Illumination Description

[None] Deactivates the internal and external illumination.

[Internal] Activates the internal illumination of the device. The graphicbelow the list [Illumination] shows the status of the internal il-lumination.When internal illumination is active, individual segments aredeactivated and activated by clicking in the graphic.

[External] Activates the external illumination. The external illuminationunit is connected to switching output OUT2 of the device. Inaddition, the external illumination has to be activated. (Ò In-terfaces / 74) The illumination unit is active as long asswitching output 2 is in the “high” state.

[Both] Activates the internal and external illumination.

The following devices have an additional polarisation filter: O2I500, O2I502 and O2I504.

11.1.9 Filter typeThe list [Filter type] sets filters for the image with which the representation is optimised. The followingfilters available:

Filter type Description

[No filter] Deactivates the filter.

[Erosion] Enlarges dark pixel groups and decreases light pixel gaps.

[Dilatation] Enlarges light pixel groups and decreases dark pixel gaps.

[Median] Reduces noise and noise pixels.

O2I5xx

33

11.1.10 Filter strengthThe list [Filter strength] sets the intensity of the selected filter type. The following filter intensities areavailable:

Filter strength Description

[1 (weak)] Uses a weak intensity for the selected filter type (preset).

[2] …

[3] …

[4] …

[5 (strong)] Uses a strong intensity for the selected filter type.

11.1.11 Invert imageThe checkbox [Invert Image] inverts the brightness values of the selected image: black/white becomeswhite/black.

Inversion of the image is necessary with inverted 1D barcodes, e.g. for lasered metal surfaces.

11.1.12 Image quality checkThe checkbox [Enabled] activates the image quality check. The image quality check checks whetherthe measured values received from the camera are within the permitted value range. The followingmeasured values are recorded:

• Sharpness

• Mean brightness

• Underexposed area (all pixels with grey value < 10)

• Overexposed area (all pixels with grey value > 245)

If a measured value is outside the permitted value range, this can be signalled via the processinterface.

1 12 23

Fig. 7: Image quality check1 Permitted value range 2 Min/max value3 Current measured value

Permitted value rangeThe permitted value range is indicated by the blue square brackets. The brackets can be moved withinthe graphic using the mouse. If the measured value (green dot) is outside the permitted value range

(blue brackets), this is indicated by an exclamation mark: . In addition, this can be signalled via theprocess interface. For this, the process interface must be configured accordingly via the function“Interface”. (Ò Interfaces / 74)

Min/max valueThe min/max values are indicated by the orange dashed lines. The lines mark the min/max values ofthe taught measured values. The lines overlap if the measured value has not yet changed.

The button [Reset statistics] discards the taught min/max values.

The button [Teach] adopts the current min/max values (orange dashed lines) as the default for thepermitted value range (blue square brackets).

GB

O2I5xx

34

Current measured valueThe current measured value is indicated by the green dot. The min/max values are indicated by theorange dashed lines.

Operating elementsThe area “Image quality check” contains the following operating elements:


[Enabled] Checkbox Activates the image quality check.

[Reset statistics] Button Resets the min/max values.

[Sharpness] Blue square brackets Sets the permitted value range (bluebrackets). The brackets can be movedwithin the graphic.

[Teach] Button Adopts the min/max values (orangedashed lines) as the default for the per-mitted value range (blue square brack-ets).

[Mean brightness] Blue square brackets Sets the permitted value range. The bluebrackets can be moved within the graph-ic.


[Underexposed area] Blue square brackets Sets the permitted value range. The bluebrackets can be moved within the graph-ic.


[Overexposed area] Blue square brackets Sets the permitted value range. The bluebrackets can be moved within the graph-ic.


11.2 ModelsThe function “Models” sets the codes. One code family is saved per “model”. Then the devicesearches for this code family. If several code families are to be searched for, a model is added foreach code family.

Several codes of the same code family are

• stored in one model in case of the same search parameters,

• stored in several models in case of different search parameters.

O2I5xx

35

Fig. 8: Function “Models”

The function “Models” contains the following operating elements:


Create new model Adds a new model. (Ò Add new mod-el / 36)

Delete all models Deletes all models. The models are ir-revocably deleted.

Area “M1 New model 1” (model name):


[Type: Bar code 1D][Type: Data code 2D]

Type: Bar code 1DType: Data code 2D

Indicates the code type of the model.The code type is set when the model iscreated.

GB

O2I5xx

36


Copy model Copies the model and changes to thenew model.

Rename model Renames the model.

Delete model Deletes the model.

Return to the default values Resets all settings to the default set-tings.

[Image references] [l1 New image 1] Image references Assigns the model to the selected imag-es.

The following operating elements differ depending on the code type selected:

• 1D barcode: Model (Ò / 36)

• 2D data code: Model (Ò / 45)

11.2.1 Add new modelThe button [Add new model] adds a new model. A model has to be added to detect a code. The codefamily and the associated settings are saved in the model.

Up to 64 models can be created per application.

After clicking the button [Add new model], the following buttons are displayed:

Button Description

[Automatic code search] Starts the wizard “Create model”. The wizard detects the codefamily and creates a matching model.The wizard does not detect the following code families:- PharmaCode- MSI

[Bar code 1D] Creates a model using a 1D barcode. (Ò 1D barcode: Mod-el / 36)

[Data code 2D] Creates a model using a 2D data code. (Ò 2D data code:Model / 45)

11.2.2 1D barcode: ModelA model with the code type “Bar code 1D” contains the following operating elements:


[Code family] List Sets the code family. (Ò 1D barcode:Code family / 38)

[Encoding] List Sets the character encoding. (Ò 1D bar-code: Encoding / 38)

[Number of codes per ROI group] Input field Sets the number of codes per ROIgroup. (Ò 1D barcode: Number of codesper ROI group / 38)

[Timeout] Checkbox Sets a timeout terminating the search forcodes when the time has elapsed. (Ò1D barcode: Timeout / 39)

[Measure ISO quality] Checkbox Sets the quality classification accordingto ISO. (Ò 1D barcode: Measure ISOquality / 39)

O2I5xx

37


[Check char] List Evaluates the check character of a bar-code. (Ò 1D barcode: Checkchar / 40)

Area “Optimisation”


[Contrast min] Input field Sets the minimum contrast betweenforeground and background. (Ò 1D bar-code: Contrast min / 40)

[Min code length] Input field Sets the minimum code length. (Ò 1Dbarcode: Min code length / 41)

[Quiet zone] List Sets the verification of the quiet zones ofa code. (Ò 1D barcode: Quietzone / 41)

[Use bar orientation] Checkbox Improves the code contours. (Ò 1D bar-code: Use bar orientation / 42)

[Symbology identifier] List Displays FNC1 and ECI characters incodes. (Ò 1D barcode: Symbology iden-tifier / 42)

Area “Advanced”


[Orientation] Input field Sets the orientation of the code. (Ò 1Dbarcode: Orientation / 42)

[Orientation tolerance] Input field Sets a zone for the [Orientation] in whichthe code is detected. (Ò 1D barcode:Orientation tolerance / 43)

[Number of scanlines] Input field Sets the number of scanlines for the de-tection of a code. (Ò 1D barcode: Num-ber of scanlines / 43)

[Majority voting] Checkbox Sets the majority voting for the scanlinesof single-line barcodes. (Ò 1D barcode:Majority voting / 43)

[Merge scanlines] Checkbox Sets merging of scanlines of single-linebarcodes. (Ò 1D barcode: Merge scan-lines / 44)

[Min identical scanlines] Input field Sets the minimum number of successful-ly read scanlines. (Ò 1D barcode: Mini-mum identical scanlines / 44)

[Start/stop tolerance] List Sets the tolerance for start and stop pat-terns. (Ò 1D barcode: Start/Stop toler-ance / 44)

[Element size variable] Checkbox Activates the compensation of the small-est element sizes of barcodes. (Ò 1Dbarcode: Element size variable / 44)

Area “Size restriction”


[Barcode height min] List Sets the minimum barcode height. (Ò1D barcode: Barcode height min / 45)

[Barcode width min] List Sets the minimum barcode width. (Ò 1Dbarcode: Barcode width min / 45)

Area “ROI size check”


[Enabled] Checkbox Warns if the code moves further out ofthe ROI with each trigger. (Ò 1D bar-code: ROI size check / 45)

GB

O2I5xx

38

11.2.2.1 1D barcode: Code familyThe list [Code family] sets the code family. The following code families are available for a 1D barcode:

Code families for 1D barcodes

2/5 Industrial

2/5 Interlaced

Codabar

Code 128

Code 39

Code 93

EAN-13 Add-On 2

EAN-13 Add-On 5

EAN-13

EAN-8 Add-On 2

EAN-8 Add-On 5

EAN-8

GS1 DataBar Expanded Stacked

GS1 DataBar Expanded

GS1 DataBar Limited

GS1 DataBar Omnidir

GS1 DataBar Stacked Omnidir

GS1 DataBar Stacked

GS1 DataBar Truncated

GS1-128

MSI

PharmaCode

UPC-A Add-On 2

UPC-A Add-On 5

UPC-A

UPC-E Add-On 2

UPC-E Add-On 5

UPC-E

11.2.2.2 1D barcode: EncodingThe list [Encoding] sets the character encoding of the code contents. The list [Encoding] contains thefollowing trigger modes:

Encoding Description

[Latin-1 / ASCII] Decodes the characters according to ISO 8859-1.

[UTF-8] Decodes the characters according to UTF-8.

11.2.2.3 1D barcode: Number of codes per ROI groupThe input field [Number of codes per ROI group] sets the maximum number of codes to be detectedfor an ROI group. (Ò Creating a region of interest (ROI) / 56)

A search is made for the set number of codes. If more or fewer codes are found, the model isconsidered “failed” in the overall statistics. (Ò Monitor / 21)

O2I5xx

39

Example[Number of codes per ROI group] = “2”

• If 1 ROI exists: 2 codes are searched in this one ROI.

• If 2 ungrouped ROIs exist (each ROI counts as ROI group): 2 codes are searched in each ROI.Altogether, 4 codes are searched.

• If 2 grouped ROIs exist (1 ROI group): 2 codes are searched in this one ROI group. Altogether, 2codes are searched. The codes may

– both be contained in the first ROI,

– both be contained in the second ROI,

– 1 code each contained in each ROI.

A large number of codes to be detected increases the evaluation time of the device.

11.2.2.4 1D barcode: TimeoutThe checkbox [Timeout] sets a timeout terminating the search for codes when the time has elapsed.For example, a maximum decoding time can be ensured with the timeout.

11.2.2.5 1D barcode: Measure ISO qualityThe checkbox [Measure ISO quality] evaluates the code quality of 1D code types following ISO/IEC15416. The evaluation of the code quality is available for the following 1D code types:

• 2/5 Interleaved, 2/5 Industrial

• Code 39, Code 93, Code 128

• EAN8, EAN8 Add-On 2, EAN8 Add-On 5

• EAN13, EAN13 Add-On 2, EAN13 Add-On 5

• UPC-A, UPC-A Add-On 2, UPC-A Add-On 5

• UPC-E, UPC-E Add-On 2, UPC-E Add-On 5

• GS1 Databar

• GS1-128

• MSI bar code

• Codabar

• Pharma code

Set the ISO quality parameters:

u Activate the checkbox [Measure ISO quality].

w The selection field “User-defined quality grade” is displayed. The contained quality parameters aredeselected by clicking [x] and added by clicking [+].

The following quality parameters are available:

Quality parameter Description

[Additional Requirements] Additional requirements

[Decodability] Decodability

[Decode] Decoding

[Defects] Defects

[Minimal Edge Contrast] Minimum edge contrast

[Minimal Reflectance] Minimum reflectance

[Modulation] Modulation

GB

O2I5xx

40

Quality parameter Description

[Symbol Contrast] Symbol contrast

In addition, the following quality parameters are available for GS1 Databar codes:

Quality parameter [Composite ...] Description

[Codeword Yield] Codeword yield


[Decode] Decoding

[Defects] Defects


[Unused Error Correction] Unused error correction

Quality parameter [Composite RAP ...] Description

[Contrast] Contrast


[Defects] Defects

[Minimal Edge Contrast] Minimum edge contrast

[Minimal Reflectance] Minimum reflectance


[Overall] Overall quality

The function increases the evaluation time of the device.

11.2.2.6 1D barcode: Check charThe list [Check char] evaluates the check character of a barcode. The check character is used tocheck whether the user data of the barcode has been read correctly.

Some code types contain a check character by default. For these code types, the content of the checkcharacter cannot be read.

For code types such as “Code 39”, “Codabar”, “2/5 Industrial” and “2/5 Interleaved”, the list [Checkchar] is used to set how the check character is handled.

The list [Check char] contains the following settings:

Check char Description

[Absent] The barcode does not contain a check character. The com-plete content of the barcode is interpreted as user data.

[Present] The barcode contains a check character. The correctness ofthe user data is checked using the check character. If thechecksum of the user data does not correspond to the checkcharacter, the barcode is classified as unreadable and is notprovided as a result.The content of the check character is not provided.

[Preserved] The barcode contains a check character. The correctness ofthe user data is checked using the check character. If thechecksum of the user data does not correspond to the checkcharacter, the barcode is classified as unreadable and is notprovided as a result.The content of the check character is provided.

The default setting is [Absent].

11.2.2.7 1D barcode: Contrast minThe input field [Contrast min] sets the minimum contrast between foreground and background. If acode has a lower contrast, it is not detected.

O2I5xx

41

“0” is preset.

11.2.2.8 1D barcode: Min code lengthThe input field [Min code length] sets the minimum code length. If a code is of shorter code length, it isnot detected.

“0” is preset.

The value “3” is preset for the code types “2/5 Industrial” and “5/2 Interleaved”. Code lengths“<3” lead to reading errors with these code types: The code types are erroneously detected intexts and samples.

11.2.2.9 1D barcode: Quiet zoneThe list [Quiet zone] sets the verification of quiet zones of a code. The quiet zone is at least of thewidth of the narrowest bar of the barcode.

The list [Quiet zone] contains the following settings:

Quiet zone Description

[false] Detects the codes when the quiet zones do not meet thespecified minimum widths.The setting can lead to the detection of small codes within alarge code.

[true] Detects the codes when the quiet zones do meet the speci-fied minimum widths. The following table contains the speci-fied minimum widths as a multiple of a module width.

[Tolerant] The codes are detected if a limited number of corners occur inthe quiet zones. Maximum 1 corner per 4 module widths is al-lowed.

[Custom] A factor is entered in the input field. The factor defines theminimum width of the quiet zones.With factor “1”, codes are detected if the quiet zone is at least1 x the width of the narrowest bar of the barcode. The follow-ing table contains the specified minimum widths as a multipleof a module width.Factor “2” requires double the minimum widths.

The following quiet zones apply to 1D barcodes:

Code families for 1D barcodes Minimum width left quiet zone Minimum width right quiet zone

2/5 Industrial 10 10

2/5 Interlaced 10 10

Codabar 10 10

Code 128 10 10

Code 39 10 10

Code 93 10 10

EAN-13 Add-On 2 7 5

EAN-13 Add-On 5 7 5

EAN-13 11 7

EAN-8 Add-On 2 7 5

EAN-8 Add-On 5 7 5

EAN-8 7 7

GS1 DataBar Expanded Stacked 1 1

GS1 DataBar Expanded 1 1

GS1 DataBar Limited 1 1

GS1 DataBar Omnidir 1 1

GB

O2I5xx

42

Code families for 1D barcodes Minimum width left quiet zone Minimum width right quiet zone

GS1 DataBar Stacked Omnidir 1 1

GS1 DataBar Stacked 1 1

GS1 DataBar Truncated 1 1

GS1-128 10 10

MSI 10 10

PharmaCode 5 5

UPC-A Add-On 2 9 5

UPC-A Add-On 5 9 5

UPC-A 9 9

UPC-E Add-On 2 9 5

UPC-E Add-On 5 9 5

UPC-E 9 7

11.2.2.10 1D barcode: Use bar orientationThe checkbox [Use bar orientation] improves code contours. This allows for more stable results whenrotating the code, which is especially important for position tracking.

11.2.2.11 1D barcode: Symbology identifierThe list [Symbology identifier] shows whether the code contains an FNC1 and ECI character.

The list [Symbology identifier] contains the following settings:

Symbology identifier Description

[Off] Deactivates the output of the symbology identifier.

[Only mandatory] Activates the output of required symbology identifiers.

FNC1 characterThe FNC1 character (Function 1 Character) indicates that the data in the symbol is formattedaccording to certain industry and application standards.

ECI markThe ECI (Extended Channel Interpretation) protocol indicates that the data is formatted with a 6-digitcode according to specific code tables. This can be an international character set, for example. In theoutput stream, the data is encoded as “\nnnnnn”. If the symbol contains one or more ECI codes, allbackslashes in the normal data stream “\” (ASCII code 92) are doubled.

Only the actual value according to the specifications for Code 128 and GS1-128 is returned assymbology identifier.

If necessary, the symbology identifier, which is composed of the prefix and the value “m”, must bemanually prefixed to the decoded string (usually only if m>1).

Code Prefix

Code 128 ]C0

GS1-128 ]C1

11.2.2.12 1D barcode: OrientationThe input field [Orientation] sets the orientation of the code.

O2I5xx

43

Fig. 9: Orientation of the code

A code is detected if the average orientation of its bars corresponds to the value [Orientation].

[0°] are preset.

The value range is “-90...90°”.

For “PharmaCode”, the value range is: “-180...180°”.

The input field [Orientation tolerance] extends the individual value [Orientation] to a range. (Ò1D barcode: Orientation tolerance / 43)

11.2.2.13 1D barcode: Orientation toleranceThe input field [Orientation tolerance] sets a tolerance for the function [Orientation]. The code isdetected if the average orientation of its bars is in the range [Orientation tolerance].

[90°] are preset.

The value range is “0...90°”.


With the maximum value [90°], all codes are detected, independently of the orientation.

11.2.2.14 1D barcode: Number of scanlinesThe input field [Num scanlines] sets the number of scanlines for detecting a code. The function reactsdifferently for single-row and stacked barcodes.

With a single-row barcode, scanning stops as soon as a barcode has been detected. A single-rowbarcode of poor quality requires more scanlines than a code of good quality. For a code of averagequality, a value of “2...5” is sufficient. The value must be increased when the code is no longerdetected.

With a stacked barcode, all scanlines are evaluated. A stacked barcode is composed of several rows(maximum 11 rows). The number of scanlines can be reduced if a low number of rows is expected.

With the preset value “0”, a certain number of scanlines is used depending on the code type:

Code type Description

Single-row barcode: Code 128, EAN 13, GS1 DataBar Limitedetc.

10

Stacked barcode: GS1 DataBar Stacked (Omnidirectional) 20

Stacked barcode: GS1 DataBar Expanded Stacked Stacked 55

If an image contains many incorrect code candidates, the evaluation time of the device isreduced with a small value of [Num scanlines].

11.2.2.15 1D barcode: Majority votingThe checkbox [Majority voting] sets the majority voting for scanning single-row barcodes. The functionreduces the number of incorrectly detected codes. If the function is activated, the result detected bythe majority of all scanlines is used as overall result.

GB

O2I5xx

44


11.2.2.16 1D barcode: Merge scanlinesThe checkbox [Merge scanlines] sets merging of scanlines in single-row barcodes. If no barcode wasdetected, scanlines are merged. A barcode is searched again in the merged scanlines whichincreases the chance of detection.


11.2.2.17 1D barcode: Minimum identical scanlinesThe input field [Min identical scanlines] sets the minimum number of successfully detected scanlines.As soon as the minimum number is reached, the function forwards the result of the scan. The functionreduces the probability of erroneously detecting barcodes.

The following applies with the value “0”:

• The contents of a single-row barcode are already transferred with the first successful scanline.

• The contents of a multi-row barcode are transferred when each row of the barcode has beenscanned successfully.

The following values are preset:

Code type Preset value

2/5 Industrial 2

2/5 Interleaved 2

All other code types 0

If “Majority voting” is also activated, the performance of “Min identical scanlines” changes. (Ò1D barcode: Majority voting / 43)

If “Merge scanlines” is also activated, “Min identical scanlines” sets the number of scanlines withsuccessfully detected edges. (Ò 1D barcode: Merge scanlines / 44)

11.2.2.18 1D barcode: Start/Stop toleranceThe list [Start/Stop tolerance] sets the tolerance of the scanline for the start and stop patterns ofcodes.

The list [Start/Stop tolerance] contains the following settings:

Start/Stop tolerance Description

High Detects a code with a higher probability. Poorly readablecodes can be misrecognised.

Low Detects a code with a lower probability. Poorly readablecodes are rarely misrecognised.

The list [Start/Stop tolerance] is only available for code types [Code 128] and [GS1-128].

11.2.2.19 1D barcode: Element size variableThe checkbox [Element size variable] compensates the smallest element sizes. The smallest elementsizes of a barcode can vary in size due to perspective-related distortions or distorted surfaces, makingthe barcode difficult to read. If the checkbox is activated, such distortions are balanced out wherepossible.

The checkbox [Element size variable] is only available for code types [GS1 DataBarExpanded Stacked], [GS1 DataBar Expanded] and [GS1 DataBar Limited].

O2I5xx

45

11.2.2.20 1D barcode: Barcode height minThe list [Barcode height min] sets the minimum barcode height. The barcode height is automaticallydetected in the default setting. The user-defined setting improves the detection of codes.

The list [Barcode height min] contains the following settings:

Barcode height min Description

[Automatic] Automatically sets the barcode height.

[Custom] Manually sets the barcode height in pixels. The smallest pos-sible value is “8 pixels”.

11.2.2.21 1D barcode: Barcode width minThe list [Barcode width min] sets the minimum barcode width. The barcode width is automaticallydetected in the default setting. The user-defined setting improves the detection of codes.

The list [Barcode width min] contains the following settings:

Barcode width min Description

[Automatic] Automatically sets the barcode width.

[Custom] Manually sets the barcode width in pixels.

11.2.2.22 1D barcode: ROI size checkThe checkbox [Enabled] activates the function “ROI size check”. The function provides a warning if thecode moves to the edge of the defined ROI.

The function can be used as a predictive maintenance tool. The results of the function are forwardedto a controller if desired.

ExamplePackages, each with a code to be read, move on a belt. If the belt speed or the position of thepackages does not match the trigger rate of the device exactly, the packages and thus the codes willmove out of the ROI. If the code is completely outside the ROI, it will be no longer read. The function“ROI size check” warns against this.

The function “ROI size check” contains the following input fields:

Input field Description

[Threshold ROI warning] If the distance of at least one code contour to the ROI falls be-low the set value, a warning is issued.If a code is found, the warning area is displayed in colour inthe live image.

[Threshold distance to mean position] A mean value is formed from N read codes and stored as themean position (Nmax = 100, where N = number of codesread). If the distance of a read code is greater than the setvalue, a warning is issued.The mean value is reset if a code is not read successfully.The last N positions are displayed in the form of a “track” inthe live image.

[Threshold movement score] If a code continues to move in the same direction in severalconsecutive images, the probability that it will continue tomove in that direction increases. If the probability exceeds theset value, a warning is issued.

11.2.3 2D data code: ModelA model with a “Data code 2D” contains the following operating elements:

GB

O2I5xx

46


[Code family] List Sets the code family. (Ò 2D data code:Code family / 47)

[Presets] List Prepares the model to detect certaincodes. (Ò 2D data code: Presets / 47)

[Encoding] List Sets the character encoding. (Ò 2D datacode: Encoding / 47)

[Number of codes per ROI group] Input field Sets the number of codes per ROIgroup. (Ò 2D data code: Number ofcodes per ROI group / 48)

[Timeout] Checkbox Sets a timeout terminating the search forcodes when the time has elapsed. (Ò2D data code: Timeout / 48)

[Quality grading] List Sets the quality grading. (Ò 2D datacode: Quality grading / 48)

Area “Optimisation”


[Polarity] List Sets the polarity of the code to be de-tected. (Ò 2D data code: Polarity / 51)

[Strict quiet zone] Checkbox Sets the behaviour in the event of a faultin the quiet zone of a code. (Ò 2D datacode: Strict quiet zone / 51)

[Symbology identifier] List Displays FNC1 and ECI characters incodes. (Ò 2D data code: Symbologyidentifier / 51)

Area “Advanced”


[Contrast tolerance] List Sets the tolerance to contrast differenc-es for finding codes. (Ò 2D data code:Contrast tolerance / 52)

[Finder pattern tolerance] List Sets the behaviour in the event of errorsin the finder pattern of the code. (Ò 2Ddata code: Finder pattern toler-ance / 53)

[Module grid] List Sets the calculation of the centre of amodule. (Ò 2D data code: Modulegrid / 53)

[Max slant] Input field Sets the maximum slant of the L-shapedfinder pattern relative to a right angle.(Ò 2D data code: Max slant / 53)

[Mirrored] List Sets the detection of mirrored codes. (Ò2D data code: Mirrored / 54)

Area “Size restriction”


[Symbol shape] List Restricts the form of the codes to be de-tected. (Ò 2D data code: Symbolshape / 54)

[Symbol columns min] Input field Sets the minimum number of columnsfor the detection of a code. (Ò 2D datacode: Symbol columns min / 54)

[Symbol columns max] Input field Sets the maximum number of columnsfor the detection of a code. (Ò 2D datacode: Symbol columns max / 54)

[Symbol rows min] Input field Sets the minimum number of rows forthe detection of a code. (Ò 2D datacode: Symbol rows min / 54)

O2I5xx

47


[Symbol rows max] Input field Sets the maximum number of rows forthe detection of a code. (Ò 2D datacode: Symbol rows max / 55)

[Symbol size min] Input field Sets the minimum number of symbol el-ements on the X/Y axis for the detectionof a code. (Ò 2D data code: Symbolsize min / 55)

[Symbol size max] Input field Sets the maximum number of symbol el-ements on the X/Y axis for the detectionof a code. (Ò 2D data code: Symbolsize max / 55)

Area “ROI size check”


[Enabled] Checkbox Warns if the code moves further out ofthe ROI with each trigger. (Ò 2D datacode: ROI size check / 55)

11.2.3.1 2D data code: Code familyThe list [Code family] sets the code family. The following code families are available for a 2D datacode:

Code families for 2D data codes

Data Matrix ECC 200

QR Code

Micro QR Code

PDF417

Aztec Code

GS1 DataMatrix

GS1 QR Code

GS1 Aztec Code

11.2.3.2 2D data code: PresetsThe list [Presets] prepares the model to detect certain codes.

The list [Presets] contains the following settings:

Presets Description

[Standard detection] Sets the fast detection of codes. Codes with a good contrastof a sufficient size are detected.

[Enhanced detection] Sets the reliable detection of codes. Inverted codes andcodes with difficult contrast and size conditions are detected.

[Maximum detection] Sets the detection of codes with defects or hidden finder pat-terns. The probability of detecting existing codes increasescompared to [Standard detection] and [Enhanced detection].

11.2.3.3 2D data code: EncodingThe list [Encoding] sets the character encoding of the code contents. The list [Encoding] contains thefollowing trigger modes:

Encoding Description

[Latin-1 / ASCII] Decodes the characters according to ISO 8859-1.

[UTF-8] Decodes the characters according to UTF-8.

GB

O2I5xx

48

11.2.3.4 2D data code: Number of codes per ROI groupThe input field [Number of codes per ROI group] sets the maximum number of codes to be detectedfor an ROI group. (Ò Creating a region of interest (ROI) / 56)

A search is made for the set number of codes. If more or fewer codes are found, the model isconsidered “failed” in the overall statistics. (Ò Monitor / 21)

Example[Number of codes per ROI group] = “2”

• If 1 ROI exists: 2 codes are searched in this one ROI.

• If 2 ungrouped ROIs exist (each ROI counts as ROI group): 2 codes are searched in each ROI.Altogether, 4 codes are searched.

• If 2 grouped ROIs exist (1 ROI group): 2 codes are searched in this one ROI group. Altogether, 2codes are searched. The codes may

– both be contained in the first ROI,

– both be contained in the second ROI,

– 1 code each contained in each ROI.

A large number of codes to be detected increases the evaluation time of the device.

11.2.3.5 2D data code: TimeoutThe checkbox [Timeout] sets a timeout terminating the search for codes when the time has elapsed.For example, a maximum decoding time can be ensured with the timeout.

11.2.3.6 2D data code: Quality gradingThe list [Quality grading] evaluates the code quality of 2D code types.

The list [Quality grading] contains the following settings:

Quality grading Description

None No quality grading set.

[ISO quality] Sets the grading of the quality following ISO/IEC 15415. Thenthe overall quality can be set.

[AIM / ISO-TR29158 quality] Sets the grading of the quality following AIM DPM-1-2006.Then the overall quality can be set.

[SEMI T10 quality] Sets the grading of the quality following SEMI T10.The quality grading [SEMI T10 quality] is only available for thecode family [Data Matrix ECC200].

Setting the quality grading:

u Select a quality grading from the list [Quality grading].

w The selection field “User-defined quality grade” is displayed. The contained quality parameters aredeselected by clicking [x] and added by clicking [+].

The quality parameters are calculated on the basis of the selected quality grading. The followingis required for the standard-compliant quality assessment of the image capture:

- a defined illumination and measurement geometry

- an adjustment of the image brightness by means of a calibrated code

- the definition of a measurement device suitable for the application.

ISO qualityThe quality grading [ISO quality] evaluates code quality in 5 levels:

O2I5xx

49

Code quality Description

4 passed, very good, highest quality

3 passed

2 passed

1 passed

0 not passed, lowest quality

The quality grading [ISO quality] contains the following quality parameters:

Qua

lity

para

met

er

Dat

a M

atrix

ECC

200

QR

Cod

e

Mic

ro Q

RC

ode

PDF4

17

Azt

ec C

ode

GS1

Dat

aM

atrix

GS1

QR

Cod

e

GS1

Azt

ecC

ode

Des

crip

tion

Axial non-uniformity ● ● ● - ● ● ● ● Ratio of the module size inhorizontal and vertical di-rection.

Contrast ● ● ● - ● ● ● ● Contrast of the modulesrelative to the background.

Modulation ● ● ● ● ● ● ● ● Uniformity of the light anddark modules.

Decode ● ● ● - ● ● ● ● Rating “4” if the code canbe decoded, otherwise 0”.

Fixed pattern damage ● ● ● - ● ● ● ● Error rate in the 3 basic el-ements of the code (finderpattern, alternating patternand quiet zone).

Format information - ● ● - - - ● - Contains information onerror correction and themask pattern.

Grid non-uniformity ● ● ● - ● ● ● ● Orientation of the modulesrelative to the specificsymbol grid.

Print growth ● ● ● - ● ● ● ● Ratio dark/light modules inthe alternating pattern.

Reflectance ● ● ● - ● ● ● ● Assessment of the ampli-tude between the DataCo-de modules.

Unused error correction ● ● ● ● ● ● ● ● Error of the code andshare of the available errorcorrection mechanisms tosuccessfully decode thecode.

Version information - ● ● - - - ● - Contains information onthe version of the QRcode.

Codeword yield - - - ● - - - - Assessment of the relativenumber of correctly decod-ed words.

Decodability - - - ● - - - - Assessment of the relativenumber of correctly decod-ed words.

Defects - - - ● - - - - Assessment of the bar/gaprepresentation of the code.

Start/Stop pattern - - - ● - - - - Assessment of the startand stop patterns.

„●“: Quality grading available„-”: Quality grading not available

AIM / ISO-TR29158 qualityThe quality grading [AIM / ISO-TR29158 quality] contains the following quality parameters:

GB

O2I5xx

50

Qua

lity

para

met

er

Dat

a M

atrix

ECC

200

QR

Cod

e

Mic

ro Q

RC

ode

PDF4

17

Azt

ec C

ode

GS1

Dat

aM

atrix

GS1

QR

Cod

e

GS1

Azt

ecC

ode

Des

crip

tion

Axial non-uniformity ● ● ● - ● ● ● ● Ratio of the module size inhorizontal and vertical di-rection.

Cell contrast ● ● ● - ● ● ● ● Contrast of the modulesrelative to the background.

Cell modulation ● ● ● - ● ● ● ● Uniformity of the light anddark modules.

Decode ● ● ● - ● ● ● ● Rating “4” if the code canbe decoded, otherwise 0”.

Fixed pattern damage ● ● ● - ● ● ● ● Error rate in the 3 basic el-ements of the code (finderpattern, alternating patternand quiet zone).

Format information - ● ● - - - ● - Contains information onerror correction and themask pattern.

Grid non-uniformity ● ● ● - ● ● ● ● Orientation of the modulesrelative to the specificsymbol grid.

Print growth ● ● ● - ● ● ● ● Ratio dark/light modules inthe alternating pattern.

Reflectance ● ● ● - ● ● ● ● Assessment of the ampli-tude between the DataCo-de modules.

Unused error correction ● ● ● - ● ● ● ● Error of the code andshare of the available errorcorrection mechanisms tosuccessfully decode thecode.

Version information - ● ● - - - ● - Contains information onthe version of the QRcode.

„●“: Quality grading available„-”: Quality grading not available

SEMI T10 qualityThe quality grading [SEMI T10 quality] returns the following values:

Value Description

P1 row Pixel coordinates of corner 1.

P1 column Pixel coordinates of corner 1.







Rows Number of lines [Modules].

Columns Number of columns [Modules].

Symbol contrast Contrast between light and dark modules in % related to 255grey levels.

Symbol contrast SNR Signal-to-noise ratio of “Symbol contrast”.

O2I5xx

51

Value Description

Horizontal mark growth Relative width of dark modules, related to the total width of alight and dark module [%]:Width_dark / (width_dark + width_light) * 100The optimum value is 50% (dark and light modules have thesame width). The value increases as the dark modules be-come wider. The value decreases as the light modules be-come wider.

Vertical mark growth Relative height of dark modules, related to the total height ofa light and dark module [%]:Height_dark / (height_dark + height_light) * 100The optimum value is 50% (dark and light modules have thesame height). The value increases as the dark modules be-come higher. The value decreases as the light modules be-come higher.

Data matrix cell width Average module width [pixels]

Data matrix cell height Average module height [pixels]

Horizontal mark misplacement Shifting of the modules of the “Alternating Pattern” (the alter-nating light-dark pattern at the top and left edge of the code).Indication in [%] referred to the module width. A value close tozero is ideal.

Vertical mark misplacement Shifting of the modules of the “Alternating Pattern” (the alter-nating light-dark pattern at the top and left edge of the code).Indication in [%] referred to the module height. A value closeto zero is ideal.

Cell defects Incorrectly classified symbol pixels [%] (i.e. light instead ofdark or vice versa). A value close to zero is ideal.

Finder pattern defects Incorrectly classified pixel of the finder pattern [%]. A valueclose to zero is ideal.

Unused error correction Percentage value of the unused error correction. One value isused per Reed Solomon block. The code size determines howoften the value occurs.

11.2.3.7 2D data code: PolarityThe list [Polarity] sets the polarity of the code to be detected.

The list [Polarity] contains the following settings:

Polarity Description

[Dark on light] Detects dark codes on a light background.

[Light on dark] Detects light codes on a dark background.

[Any] Detects dark codes on a light background and light codes ona dark background.

11.2.3.8 2D data code: Strict quiet zoneThe checkbox [Strict quiet zone] sets the behaviour in the event of a fault in the quiet zone of a code.The quiet zone is an empty zone framing the code. The quiet zone separates the code from otherobjects.

If the checkbox [Strict quiet zone] is activated, codes with a damaged quiet zone are not detected. Inaddition, the erroneous detection of Micro QR Codes within text or QR codes is reduced.

The code type “Aztec Code” does not have a quiet zone.

11.2.3.9 2D data code: Symbology identifierThe list [Symbology identifier] shows whether the code contains an FNC1 and ECI character.

The list [Symbology identifier] contains the following settings:

GB

O2I5xx

52

Symbology identifier Description

[Off] Deactivates the output of the symbology identifier.

[Only mandatory] Activates the output of required symbology identifiers.

FNC1 characterThe FNC1 character (Function 1 Character) indicates that the data in the symbol is formattedaccording to certain industry and application standards.

ECI markThe ECI (Extended Channel Interpretation) protocol indicates that the data is formatted with a 6-digitcode according to specific code tables. This can be an international character set, for example. In theoutput stream, the data is encoded as “\nnnnnn”. If the symbol contains one or more ECI codes, allbackslashes in the normal data stream “\” (ASCII code 92) are doubled.

Only the actual value according to the specifications for Data Matrix, QR Code, Aztec Code, PDF417and DotCode is returned as symbology identifier:

(m∈[0,6] (QR-Code),m∈[0,12] (Data Matrix ECC 200 und Aztec Code),m∈[0,2] (PDF417) bzw.m∈[0,5] (DotCode))

If necessary, the symbology identifier, which is composed of the prefix and the value “m”, must bemanually prefixed to the decoded string (usually only if m>1).

Code Prefix

Data Matrix ECC 200 ]d

QR Code ]Q

Aztec Code ]z

PDF417 ]L

DotCode ]J

GS1 DataMatrix ]d2

GS1 QR Code ]Q3

GS1 Aztec Code ]z1

GS1 DotCode ]J1

DotCodes are supported from firmware version “1.22”.

11.2.3.10 2D data code: Contrast toleranceThe list [Contrast tolerance] sets the tolerance to contrast differences for code finding. Contrastdifferences are, for example, glare or reflections.

The list [Contrast tolerance] is only available for the code family [Data Matrix ECC200].

The list [Contrast tolerance] contains the following settings:

Contrast tolerance Description

[Low] Sets the tolerance of code finding with contrast differences tolow.Under normal conditions, contrast differences are detected.This setting is suited for most applications. The setting has al-most no influence on the evaluation time.

O2I5xx

53

Contrast tolerance Description

[High] Sets the tolerance of code finding with contrast differences tohigh.The setting has a significant influence on the evaluation time.

[Any] Sets the tolerance of code finding with contrast differencesbased on an algorithm.

11.2.3.11 2D data code: Finder pattern toleranceThe list [Finder pattern tolerance] sets the behaviour in the event of errors in the finder pattern of thecode. The limiting lines framing the DataMatrix code are called finder pattern.

The [Finder pattern tolerance] is only available for the code family [Data Matrix ECC200].

The list [Finder pattern tolerance] contains the following settings:

Finder pattern tolerance Description

[Low] Sets the finder pattern tolerance to “low”. The code is detect-ed if there is a high degree of finder pattern and there is al-most no noise.

[High] Sets the finder pattern tolerance to “high”. The code is detect-ed if the finder pattern is defective or partly hidden. Onlycodes with a module grid of the same size are detected. (Ò2D data code: Module grid / 53)Perspective distortions reduce the detection rate.

[Any] Sets the finder pattern tolerance to “any”. The code is detect-ed if- there is a high degree of finder pattern and there is almostno noise or- the finder pattern is defective or partly hidden.

11.2.3.12 2D data code: Module gridThe list [Module grid] sets the calculation of the centre of a module. A DataMatrix code consists ofseveral modules.

The [Module grid] is preset to [Fixed] and cannot be changed if the “Finder pattern tolerance” isset to [High].

The [Module grid] is only available for the code family [Data Matrix ECC200].

The list [Module grid] contains the following settings:

Module grid Description

[Fixed] Uses constant spacing for the module grid.

[Variable] Uses the alternating pattern opposite the finder pattern (L-pat-tern) for the module grid.

[Any] Uses the module grids [Fixed] and [Variable] one after theother.

11.2.3.13 2D data code: Max slantThe input field [Max slant] sets the maximum slant of the L-shaped finder pattern relative to a rightangle. The angle is indicated in degrees and corresponds to the distortion occurring when the code isprinted or an image is captured.

The [Max slant] is only available for the code family [Data Matrix ECC200]

“30°” are preset. The value range is “0...30°”.

GB

O2I5xx

54

11.2.3.14 2D data code: MirroredThe list [Mirrored] sets the detection of mirrored codes. Codes are detected which are mirrored on thevertical or horizontal axis.

The list [Mirrored] contains the following settings:

Mirrored Description

[No] Deactivates the detection of mirrored codes.

[Yes] Activates the detection of mirrored codes.

[Any] Activates the detection of mirrored and non-mirrored codes.

11.2.3.15 2D data code: Symbol shapeThe list [Symbol shape] restricts the shape of the codes to be detected.

If [Finder pattern tolerance] is set to [Low], the function [Symbol shape] is ignored.

If [Finder pattern tolerance] is set to [High] or [Any], the setting [Rectangle] or [Square]considerably reduces the evaluation time.

The [Symbol shape] is only available for the code family [Data Matrix ECC200].

The list [Symbol shape] contains the following settings:

Symbol shape Description

[Rectangle] Activates the detection of rectangular codes.

[Square] Activates the detection of square codes.With the symbol shape “Square”, the number of rows and col-umns is set with the input fields [Symbol size min] and [Sym-bol size max].

[Any] Activates the detection of codes regardless of the symbolshape.

11.2.3.16 2D data code: Symbol columns minThe input field [Symbol columns min] sets the minimum number of columns for the detection of acode.

Depending on the [Symbol shape], use the following values for [Symbol columns min]:

Symbol shape Symbol columns min

[Rectangle] >= 18

[Any] >= 10

11.2.3.17 2D data code: Symbol columns maxThe input field [Symbol columns max] sets the maximum number of columns for the detection of acode.

Depending on the [Symbol shape], use the following values for [Symbol columns max]:

Symbol shape Symbol columns max

[Rectangle] <= 48

[Any] <= 144

11.2.3.18 2D data code: Symbol rows minThe input field [Symbol rows min] sets the minimum number of rows for the detection of a code.

Depending on the [Symbol shape], use the following values for [Symbol rows min]:

O2I5xx

55

Symbol shape Symbol rows min

[Rectangle] >= 8

[Any] >= 8

11.2.3.19 2D data code: Symbol rows maxThe input field [Symbol rows max] sets the maximum number of rows for the detection of a code.

Depending on the [Symbol shape], use the following values for [Symbol rows max.]:

Symbol shape Symbol rows max

[Rectangle] <= 16

[Any] <= 144

11.2.3.20 2D data code: Symbol size minThe input field [Symbol size min] sets the minimum number of symbol elements on the X/Y axis for thedetection of a code.

The input field [Symbol size min] is only available when the symbol shape [Square] is set.

Use the following values for the symbol shape [Square]:

Symbol shape Symbol size min

[Square] >= 10

11.2.3.21 2D data code: Symbol size maxThe input field [Symbol size max.] sets the maximum number of symbol elements on the X/Y axis forthe detection of a code.

The input field [Symbol size max] is only available when the symbol shape [Square] is set.

Use the following values for the symbol shape [Square]:

Symbol shape Symbol size max

[Square] <= 144

11.2.3.22 2D data code: ROI size checkThe checkbox [Enabled] activates the function “ROI size check”. The function provides a warning if thecode moves to the edge of the defined ROI.

The function can be used as a predictive maintenance tool. The results of the function are forwardedto a controller if desired.

ExamplePackages, each with a code to be read, move on a belt. If the belt speed or the position of thepackages does not match the trigger rate of the device exactly, the packages and thus the codes willmove out of the ROI. If the code is completely outside the ROI, it will be no longer read. The function“ROI size check” warns against this.

The function “ROI size check” contains the following input fields:

GB

O2I5xx

56

Input field Description

[Threshold ROI warning] If the distance of at least one code contour to the ROI falls be-low the set value, a warning is issued.If a code is found, the warning area is displayed in colour inthe live image.

[Threshold distance to mean position] A mean value is formed from N read codes and stored as themean position (Nmax = 100, where N = number of codesread). If the distance of a read code is greater than the setvalue, a warning is issued.The mean value is reset if a code is not read successfully.The last N positions are displayed in the form of a “track” inthe live image.

[Threshold movement score] If a code continues to move in the same direction in severalconsecutive images, the probability that it will continue tomove in that direction increases. If the probability exceeds theset value, a warning is issued.

11.2.4 Creating a region of interest (ROI)Within the region of interest (ROI), the device searches for codes. With default setting and when anew model is added, an ROI covering the entire live image is automatically created. Up to 64 regionsof interest can be created per model.

The operating elements for creating a region of interest are only displayed in the model settings.(Ò Models / 34)

Creating a region of interest:

u Select a model.

w If no model exists, one must be added. (Ò Add new model / 36)

u Click the button [Create rectangle ROI]:

u Create the region of interest in the live image by clicking and dragging using the mouse.

w Click and drag to move the created region of interest.

The following functions are used to set the region of interest:

Function Button Description

Change the size and shape of the regionof interest

Click and drag the small square to thenew position to change the region of in-terest.

Rotate region of interest Click and drag the round button to rotatethe region of interest.

Group regions of interest Select several regions of interest whilepressing the Shift key and then click thebutton [Group regions of interest] togroup regions of interest.

Copy region of interest Click the button [Copy region of interest]to copy the selected region of interest.

Delete region of interest Click the button [Delete region of inter-est] to delete the selected region of in-terest.

If a region of interest cannot be selected:

u Click on the name of the region of interest.

O2I5xx

57

11.2.5 Creating a region of disinterest (ROD)Within the region of disinterest (ROD), the device does not search for codes. Up to 64 regions ofdisinterest can be created per model.

The operating elements for creating a region of disinterest are only displayed in the modelsettings. (Ò Models / 34)

Creating a region of disinterest:

u Select a model.

w If no model exists, one must be added. (Ò Add new model / 36)

u Click the button [Create rectangle ROD]:

u Create the region of disinterest in the live image by clicking and dragging using the mouse.

w Click and drag to move the created region of disinterest.

The following functions are used to set the region of disinterest:


Change the size and shape of the regionof disinterest

Click and drag the small square to thenew position to change the region of dis-interest.

Rotate region of disinterest Click and drag the round button to rotatethe region of disinterest.

Copy region of disinterest Click the button [Copy region of disinter-est] to copy the selected region of disin-terest.

Delete region of disinterest Click the button [Delete region of disin-terest] to delete the selected region ofdisinterest.

If a region of disinterest cannot be selected:

u Click on the name of the region of disinterest.

11.3 FlowThe function “Flow” displays the images and models available in a flow chart. In just a few steps

• the evaluation order of the images and models is set,

• images are activated/ deactivated,

• timeouts for models are set.

In addition, the capture times of images and evaluation times of the models are displayed.

GB

O2I5xx

58

1

5

2

43

Fig. 10: Function “Flow”1 Flow settings 2 Start of the flow chart3 Images 4 Model5 End of the flow chart

Flow settingsThe flow settings are used to set the processing order of the images and models.

The flow settings contain the following settings:

Flow settings Type Description

[First fit] Option field Runs the model that first successfullycompletes the search task in the flowchart. The models following in the flowchart are not executed.

[Autosort] Checkbox Runs the model first that successfullydetected a code in the previous pass.

[All Models] Option field Runs all models. The total evaluationtime increases.

[Application timeout] Checkbox Sets a timeout for the application. If theevaluation time of the application ex-ceeds the timeout, the evaluation isstopped.

O2I5xx

59

Flow chartThe flow chart starts with the image underneath “START” (2). (Ò Images & trigger / 26) The activemodels (4) are connected with the blue line. (Ò Models / 34) Disabled models are greyed out andencircled with a dashed line.

The flow chart ends with “OUTPUT” (5). The total evaluation time is displayed underneath “OUTPUT”.The total evaluation time is composed of the capture time of the image and the evaluation times of themodels.

Double-clicking on an image or a model links directly to the respective settings.

The following properties are displayed within an image (3):

• image name

• current camera image

• capture time (corresponds to the exposure and image read-out time of the image)

Within a model (4) the following properties are displayed:

• model name

• code type

• status of the model (code detected)

• number of the codes found

• evaluation time (influenced by the settings of the model) (Ò Models / 34)

• timeout (Ò Models / 34)

Setting imagesThe following functions are used to set images:


Change position - Press the mouse button and move theimage to the new position.

Activate/deactivate Activates the selected image.

Delete Deletes the selected image from the de-vice’s system.

Setting modelsThe following functions are used to set a model:


Change position - Press the mouse button and move themodel to the new position.

Image references Connects the model to an available im-age.

Delete Deletes the selected model from the de-vice’s system.

Timeout - Sets a timeout for the model. If the eval-uation time of the model exceeds thetimeout, the evaluation is stopped.

GB

O2I5xx

60

11.4 LogicThe function “Logic” creates an output logic by means of logic blocks. In addition to binary signals,numbers and strings are also processed. The model and pin data is assigned to the outputs in theoutput logic. Then the data is transferred to a controller (PLC/PC) via the outputs.

14

3

2

Fig. 11: Function “Logic”1 Logic utilities 2 Logic blocks3 Overview area 4 Diagram

Logic utilitiesThe “Logic utilities” import and export an output logic. (Ò Logic utilities / 61) The export saves theoutput logic and makes it interchangeable with other devices.

Logic blocksThe logic blocks are used to create an output logic in the diagram. (Ò Logic block / 61) The logicblocks are placed in the diagram by clicking and dragging using the mouse:

u Click the logic block and keep the mouse button pressed.

u Drag the logic block into the diagram and release the mouse button.

w The logic block is placed.

At the edge of each logic block, there is at least one contact area via which the logic blocks areconnected. (Ò Logic block / 61)

The button [Import logic] imports an output logic.

DiagramThe output logic is created in the diagram. (Ò Output logic / 62) The pin events and the outputs aredisplayed as logic blocks with different designations and font colours. The logic blocks are connectedby connecting lines. The connecting lines represent the data flow between the logic blocks. Next to theinputs of the logic blocks, the current state of the input is displayed.

Overview areaThe overview area displays a reduced overview of the main area. The white frame is shifted using themouse. By this, the logic blocks outside the visible area can be displayed.

O2I5xx

61

11.4.1 Logic utilitiesThe “Logic utilities” import and export the output logic. The export saves the output logic and makes itinterchangeable with other devices.

The function “Logic utilities” contains the following operating elements:


Import logic Imports the output logic from a file withthe extension “*.o2xlgc”.

Export the whole logic Exports the output logic to a file with theextension “*.o2xlgc”.

11.4.2 Logic blockEditing a logic blockLogic blocks can be edited in two ways. The available functions are displayed as buttons for theselected logic block.

The following buttons are used to edit a logic block:


Duplicate Creates a duplicate of the selected logicblock.

Delete Deletes the selected logic block.

Set Sets the selected logic block.

Connecting logic blocksThe contact areas at the border connect the logic blocks.

Fig. 12: Contact areas with connecting line1 Contact areas

Connecting a logic block:

u Click the contact area at the right border of a logic block and keep the mouse button pressed.

w The contact areas of the outputs are at the right border.

u Drag the connecting line to a free contact area on the left border of a logic block and release themouse button.

w The contact areas of the inputs are at the left border.

During connection, the compatibility of the logic block is verified. For example, a numeric outputcannot be connected to a Boolean input.

During connection, the units of measurement of the logic blocks are not verified.

Deleting a connecting line:

u Click the connecting line.

u Click on the button [Delete]:

w The connecting line is deleted.

GB

O2I5xx

62

Selecting several logic blocksBy holding down the Ctrl key and clicking with the left mouse button, several logic blocks are selected.The selected logic blocks can then be exported as a bundle, duplicated or deleted.

The selected logic blocks are highlighted with a frame. The following operating elements are displayedbelow the frame:


Duplicate Duplicates the selected logic blocks.Some logic blocks may only be presentonce in the output logic and thereforecannot be duplicated.

Export Exports the selected logic blocks to a filewith the extension “*.o2xlgc”.

Delete Deletes the selected logic blocks.

11.4.3 Output logicThe output logic is created in the diagram. The model and pin data is assigned to the outputs in theoutput logic. The following rules apply for creating an output logic:

• The pin events are provided as Boolean numbers (1 = true, 0 = false) and assigned to digitaloutputs.

• The model results are numerical values and are processed as follows:

– use of operators,

– digitalisation by comparison with other results or values,

– transfer of digitalised numerical values by applying arithmetic operators and logic functions,

– output of a Boolean value via a digital output or a virtual pin.

The following figure shows an overview of the configuration options in the output logic. The numbersidentify the connection between the logic blocks.

O2I5xx

63

Fig. 13: Output logic

11.4.4 Logic block “Add note”The logic block “Add note” inserts notes into the diagram. The notes contain any text and behave likea sticky note.

The following functions are used to set the logic block:


Edit text - Clicking within the note displays a cursorthat is used to add and edit text.

11.4.5 Logic blocks “Model results”Models (Ò / 34) The logic blocks provide the characteristics of the detected codes at the outputs.

The logic block is set after being placed in the diagram:

List Description

[Code details] Sets the function of the logic block:[Code details]: Provides the code details at the outputs.[Quality grading]: Provides the results of the quality assess-ment at the outputs.[ROI group]: Provides the status of a specific ROI group at theoutputs.[Model overview]: Provides the status of all ROI groups andthe decoding status at the outputs.

[ROI group] Sets the ROI group.

[Code index 0] Sets a specific code.1D barcode: Number of codes per ROI group (Ò / 38)

GB

O2I5xx

64

Logic block with function [Code details]With the function [Code details], the logic block provides the following outputs:

Output Number format Description

[Code content] alphanumeric 1D barcode: Encoding (Ò / 38)

[Code found] bool State of the code:- “Code found”- “Code not found”

[centre X] numerical The centre of the code on the X axis.

[centre Y] numerical The centre of the code on the Y axis.

[Orientation] numerical Orientation of the code in degrees.

[half width] numerical Half width of the code.

[half height] numerical Half height of the code.

[Binary code content] byte array Code content as uncoded raw data (bytearray). Logic blocks “Binary opera-tions” (Ò / 69)

Logic block with function [Quality grading]With the function [Quality grading], the logic block provides the following outputs for 1D barcodes:


[User-defined overall quality] float The overall quality of the code corre-sponds to the individual characteristicwith the poorest rating, depending onthe quality parameters set.

[Overall quality] float The overall quality of the code corre-sponds to the individual characteristicwith the poorest effect. The followingquality gradings exist:0-4 (0 = bad; 4 = very good)A-F (F = bad; A = very good)The grading 0-4 or A-F is determined bythe standard used.

[Additional requirements] float Specific requirements of the symbology

[Decodability] float Deviations of the symbol element widthsfrom the nominal value. The nominal val-ue is defined in the symbology standard.

[Decode] float Readability of the code:“4”: readable“0”: not readable

[Defects] float Defects are irregularities in the grey-scale value profile of symbol elements orquiet zones.

[Minimum edge contrast] float Assessment of the minimum contrastbetween two adjoining symbol elementsin the grey-scale value profile (light todark element or dark to light element).

[Minimum reflectance] float Minimum reflection value of the grey-scale value profile:“4”: the minimum reflection value is “<=0.5” of the maximum reflection value“0”: the minimum reflection value is “>0.5” of the maximum reflection value

[Modulation] float Uniformity of the light and dark bars.

[Symbol contrast] float Contrast of the bars against the back-ground.

With the function [Quality grading], the logic block provides the following outputs for 2D data codesand the quality grading “ISO”:

O2I5xx

65


[User-defined overall quality] float The overall quality of the code corre-sponds to the individual characteristicwith the poorest effect, depending on thequality parameters set.

[Overall quality] float The overall quality of the code corre-sponds to the individual characteristicwith the poorest effect. The followingquality gradings exist:0-4 (0 = bad; 4 = very good)A-F (F = bad; A = very good)The grading 0-4 or A-F is determined bythe standard used.

[Contrast] float Contrast of the modules relative to thebackground.

[Modulation] float Uniformity of the light and dark modules.

[Fixed pattern damage] float Error rate in the 3 basic elements of thecode: finder pattern, alternating patternand quiet zone.


[Axial non-uniformity] float Ratio of the module size in horizontaland vertical direction.

[Grid non-uniformity] float Orientation of the modules relative to thespecific symbol grid.

[Unused error correction] float Codes with error correction have redun-dancy for correcting reading errors. Thevalue indicates how much of the redun-dancy is not used during reading.

[Reflectance] float Assessment of the amplitude betweenthe DataCode modules.

[Print growth] float Ratio dark/light modules in the alternat-ing pattern.

[Contrast uniformity] float Smallest numerical value for the modu-lation in the entire code.

[Aperture] float Size indication of the synthetic aperturein relation to the module size of the sym-bol. The aperture is used to create thereference grey-scale image which is re-quired for the quality assessment.

[Format Information (µQR/QR only)] float Assessment of the modules containingthe format information.

[Version Information (µQR/QR only)] float Assessment of the modules containingthe version information.

With the function [Quality grading], the logic block provides the following outputs for 2D data codesand the quality grading “AIM / ISO-TR29158”:


[User-defined overall quality] float Overall quality of the code correspondsto the individual characteristic with thepoorest effect. Depends on the set quali-ty parameters.

[Overall quality] float Overall quality of the code correspondsto the individual characteristic with thepoorest effect.

[Cell contrast] float Contrast of the modules relative to thebackground.

[Cell modulation] float Uniformity of the light and dark modules.

GB

O2I5xx

66


[Fixed pattern damage] float Error rate in the 3 basic elements of thecode: finder pattern, alternating patternand quiet zone.


[Axial non-uniformity] float Ratio of the module size in horizontaland vertical direction.

[Grid non-uniformity] float Orientation of the modules relative to thespecific symbol grid.

[Unused error correction] float Error of the code and share of the avail-able error correction mechanisms tosuccessfully decode the code.

[Mean light] float Assessment of the image quality, calcu-lated via the medium grey-scale value ofthe centres of the bright DataCode mod-ules. The values are in the range“0.0” (0 %) to “1.0” (100 %) of the fullgrey-scale range (255 for byte images).

[Reflectance] float Assessment of the amplitude betweenthe DataCode modules.

[Print growth] float Ratio dark/light modules in the alternat-ing pattern.

[Contrast uniformity] float Smallest numerical value for the modu-lation in the entire code.

[Aperture] float Size indication of the synthetic aperturein relation to the module size of the sym-bol. The aperture is used to create thereference grey-scale image which is re-quired for the quality assessment.

[Format information (mqr/qr only)] float Assessment of the modules containingthe format information.

[Version information (mqr/qr only)] float Assessment of the modules containingthe version information.

With the function [Quality grading], the logic block provides the following outputs for 2D data codesand the quality grading “SEMI T10”:


[P1 row] float Corner 1 position Y coordinates

[P1 column] float Corner 1 position X coordinates







[Rows] float ECC200 N (rows)

[Columns] float ECC200 M (columns)

[Symbol contrast] float The value for symbol contrast desig-nates the contrast between light anddark classified symbol pixels in percentof the full grey-scale value range (255for byte images).

[Symbol contrast SNR] float Symbol contrast SNR is the correspond-ing signal-to-noise ratio.

O2I5xx

67


[Horizontal mark growth] float Module width relative to the sum of lightand dark modules [%]

[Vertical mark growth] float Module height relative to the sum of lightand dark modules [%]

[Data matrix cell width] float Average module height

[Data matrix cell height] float Average module width

[Horizontal mark misplacement] float Misplacement in horizontal direction [%]

[Vertical mark misplacement] float Misplacement in vertical direction [%]

[Cell defects] float Misclassified symbol pixels [%]

[Finder pattern defects] float Misclassified finder pattern pixels [%]

[First unused error correction] float Unused capacities for error correction[%]

Logic block with function [ROI group]With the function [ROI group], the logic block provides the following outputs:


All codes found bool State of the code:- “All codes found”- “No code found” or “Not all codesfound”

Decoding status numerical State of the selected ROI group:“0”: The ROI group has not yet beencompletely executed.“1”: The ROI group has been completelyexecuted.“2”: The ROI group is not executed dueto timeout.“3”: The ROI group is not completely ex-ecuted because of an unknown error.

Found codes numerical Number of the codes found.

Searched codes numerical Number of the searched codes.

Logic block with function [Model overview]With the function [Model overview], the logic block provides the following outputs:


All groups passed bool State of the ROI groups.

Decoding status numerical State of the selected model:“0”: The model was not completely exe-cuted.“1”: The model was completely execut-ed.“2”: The model is not executed due to atimeout.“3”: The model is executed incompletelydue to unknown errors.

11.4.6 Logic block “Application result”The logic block “Application result” provides the status of the models contained in the application.

The logic block provides the following outputs:

GB

O2I5xx

68


[Models found] bool State of the models contained in the ap-plication:- “All models found” or- “Not all models found”

11.4.7 Logic blocks “String operations”The following logic blocks are provided in the area “String operations”:

Logic block Number format at the input Number format at the out-put Description

[Fixed string] - alphanumeric Provides an adjustable char-acter string which is used foroperations with characterstrings.

[PCIP input string] - alphanumeric Provides an adjustable char-acter string (ID “00” to “09”)which is transferred to a con-troller for operations. Thecharacter string can bechanged during the runtimewith the “J Command” (seeseparate document Program-mers Guide).

[Equal strings] alphanumeric bool Compares the characterstring at both inputs in view ofidentical content:“a==b” = “1”: The characterstrings are identical.“a!=b” = “1”: The characterstrings are not identical.

[Match regex] alphanumeric alphanumeric Applies a regular expression(regex) to the character stringat the input. If an expressionis found, the output [Matchpattern] provides a Boolean“1”. The found expression isprovided at output [Outputstring].Example:For “\b([0-9]{4})\b” the resultis “True”, if the code has ex-actly 4 digits.

[Match pattern] alphanumeric bool Searches a pattern in the in-put string. Wildcards such as“*” and “?” are accepted forthe pattern (example: “*.png”).If the input string contains thepattern, a Boolean “1” is pro-vided at the output.

[Split by delimiter] alphanumeric alphanumeric Searches the delimiter in thecharacter string. The charac-ter string is split at the posi-tions of the delimiter. The splitstring of characters is provid-ed one after the other on the7 outputs without the delimit-er.If the character string is splitin more than 7 segments atthe input, the segments >7are provided at the outputs.

O2I5xx

69


[Split string at position] character string: alphanumer-ic, position: numerical

alphanumeric Splits a character string at acertain position. The splitcharacter string is provided atthe outputs.

[Concatenate] alphanumeric alphanumeric Concatenates up to 7 charac-ter strings, optionally with adelimiter. The character stringand the optional delimiter areprovided via the logic blocks“Fixed string”, for example.

[Selection] bool / alphanumeric alphanumeric If there is a Boolean “0” at theinput “Switch (0/1)”, the char-acter string is provided at theinput “Option 0”.If there is a Boolean “1” at theinput “Switch (0/1)”, the char-acter string is provided at theinput “Option 1”.

11.4.8 Logic blocks “Binary operations”The following logic blocks are provided in the area “Binary operations”:


[Fixed binary data] - byte array Provides adjustable binarydata which is used for opera-tions with binary data.

[Binary data input] - byte array Provides adjustable binarydata (ID “00” to “09”) which istransferred to a controller foroperations. The binary datacan be changed during theruntime with the “J Com-mand” (see separate docu-ment Programmers Guide).

[Equal bytes] byte array bool Compares the binary data atthe inputs in view of identicalcontent:“a==b” = “1”: The binary datais identical.“a!=b” = “1”: The binary datais not identical.

[Split binary by delimiter] byte array byte array Searches the delimiter in thebinary data. The binary datais split at the positions of thedelimiter. The split binary datais provided one after the otherat the 7 outputs without thedelimiter.If the binary data is split inmore than 7 segments at theinput, the segments >7 areprovided at the outputs.

[Split binary at position] byte array byte array Splits the binary data at a cer-tain position. The split binarydata is provided at the out-puts.

[Concatenate binaries] byte array byte array Concatenates up to 7 binarydata, optionally with a delimit-er. The binary data and theoptional delimiter are provid-ed via the logic blocks “Fixedbinary data”, for example.

GB

O2I5xx

70


[Select binary] byte array byte array If there is a Boolean “0” at theinput “Switch (0/1)”, the binarydata is provided at the input“Option 0”.If there is a Boolean “1” at theinput “Switch (0/1)”, the char-acter string is provided at theinput “Option 1”.

11.4.9 Logic blocks “Arithmetic”The following logic blocks are provided in the area “Arithmetic”:


[DIFF] numerical numerical The signals at the inputs aresubtracted. The two outputsprovide the result with differ-ent signs.

[ADD] numerical numerical The signals at the inputs areadded.

[COUNT] bool numerical The signals at the inputs areadded. The Boolean values atthe input are treated as nu-merical values.

[Min/max value] numerical numerical The minimum and maximumvalues are determined on thebasis of the signals at the in-puts.

[Fixed value] – numerical A floating point number is setas a fixed value. The fixedvalue is provided and can beused for the logic blocks“DIFF” and “ADD” (for exam-ple to set an offset).

11.4.10 Logic blocks “Converter”The following logic blocks are provided in the area “Converter”:


[String to number] alphanumeric numerical Converts the alphanumericdata at the input to numericdata at the output.

[Number to string] numerical alphanumeric Converts the numeric data atthe input to alphanumeric da-ta at the output.

[Binary to string] byte array alphanumeric Converts the binary data atthe input to alphanumeric da-ta at the output.

[String to binary] alphanumeric byte array Converts the alphanumericdata at the input to binary da-ta at the output.

[Number to binary] numerical byte array Converts the numeric data atthe input to binary data at theoutput.

O2I5xx

71

11.4.11 Logic blocks “Digitalisation”The following logic blocks are provided in the area “Digitalisation”:


[Check min quality] numerical bool The quality grading value atthe input is compared with anadjustable comparison value.For example, “A-F” or “4-0”can be set as comparison val-ue. If the quality grading valueis better or equal, “1” is pro-vided at the output.

[Comparator] numerical bool The signals at the inputs arecompared to each other. Sig-nals at the outputs:“1”: The relation displayed inthe output name applies.“0”: The relation displayed inthe output name does not ap-ply.

11.4.12 Logic blocks “Logical functions”The area “Logical functions” contains the following logic blocks:


[AND] bool bool The signals at the inputs arecompared to each other. Sig-nals at the output:“1”: All signals at the inputsare “1”.“0”: Minimum one signal atthe inputs is “0”.

[OR] bool bool The signals at the inputs arecompared to each other. Sig-nals at the output:“1”: Minimum one signal atthe inputs is “1”.“0”: All signals at the inputsare “0”.

[NOT] bool bool The signal at the input is in-verted. Signals at the output:“1”: The signal at the input is“0”.“0”: The signal at the input is“1”.

11.4.13 Logic blocks “Output”The following logic blocks are provided in the area “Output”:

Logic block Number format at the input Description

[Output string] alphanumeric Saves the received string. The logicblock [Output string] is available up to10x. The content of the logic blocks isretrieved via the process interface. (ÒInterfaces / 74)

GB

O2I5xx

72


[Binary output] byte array Saves the received binary data. The log-ic block [Binary output] is available up to10x. The byte array has a maximum sizeof 256 bytes. The content of the logicblocks is retrieved via the process inter-face. (Ò Interfaces / 74)

[DIGITAL_OUT1] bool The digital output is switched with orwithout limited pulse duration. The digitaloutputs have the following settings:“Static”: The digital output is switchedwithout limited pulse duration (recom-mended setting).“Pulsed”: The digital output is switchedwith a limited pulse duration (>= 10 ms).

[DIGITAL_OUT2] bool

[Virtual pins bytes 1-8] bool The virtual pins are memory areas totransfer the data from the logic area toan interface.A virtual pin consists of an 8-bit order.The 8 virtual pins are arranged in se-quence to maximum 64 Boolean valuesand provided via an interface. (Ò Inter-faces / 74) Non-assigned virtual pinsprovide a Boolean “0”.

11.4.14 Logic blocks “Pin events”The following logic blocks are provided in the area “Pin events”:

Logic block Number format at the output Description

[Ready for trigger] bool The device is ready for trigger to capturea new image.

[Error] bool The device has found an error.

[Process interface] bool The digital output is switched to “high” or“low” via the process interface with the“o” command.

11.4.15 Logic block “Statistics”The following logic block is provided in the area “Statistics”:


[State definition: pass/fail] bool The result of an application is provided:“1”: The application was successfully ex-ecuted.“0”: The application was not successfullyexecuted.The result is written in the service reportand is available for statistical calcula-tions.

11.4.16 Example 1 of “Compare reference code”A digital signal is provided if the device detects a reference code.

O2I5xx

73

Fig. 14: Example 1 of “Compare reference code”

If the model set in the module “Application results” detects the code, the module “DIGITAL_OUT2”provides the signal “High”. If no code is detected, the module “DIGITAL_OUT2” provides the signal“Low”.

11.4.17 Example 2 of “Compare reference code”A digital signal is provided if two character strings are identical.


GB

O2I5xx

74

If the code content of the set model is identical with the character string in the module “Fixed string”,the module “DIGITAL_OUT2” provides the signal “High”. If no code is detected, the module“DIGITAL_OUT2” provides the signal “Low”.

11.4.18 Example 3 of “Compare reference code”A digital signal is provided if two character strings are identical. One of the character strings can beadapted via the process interface.


If the code content of the set model is identical with the character string in the logic block [PCIP inputstring], the module “DIGITAL_OUT2” provides the signal “High”. If no code is detected, the module“DIGITAL_OUT2” provides the signal “Low”.

The logic block [PCIP input string] is addressed with the “j command” via the process interface.

The “j command” is described in the separate document Programmers Guide.

11.5 InterfacesThe function “Interfaces” sets the interfaces of the selected application. Data packages are definedwhich are sent via the interface.

O2I5xx

75

1 2

34

Fig. 17: Function “Interfaces”1 Settings 2 Main area3 Output string 4 Overview area

SettingsThe area “Settings” contains the following operating elements:


Default value Resets the setting to the default setting.

Name Type Description

[Presets] List Sets sets of preset data packages. Thesets are directly used or adapted. Anadapted set is saved as preset “Cus-tom”.

[Data encoding] List Sets the data encoding:[ASCII][Binary]

[Precision] Input field Sets the number of decimal places.

[Display format] List Sets the display format:[fixed]: fixed-point number[scientific]: exponential

[Decimal separator] Input field Sets the decimal separator. The decimalseparator is a 7-bit character (e.g. “.”).

GB

O2I5xx

76


[Base] List Sets the output format:[Binary]: Base 2[octal]: Base 8[decimal]: Base 10[hex]: Base 16

[Width] Input field Sets the minimum total length of the val-ue.

[Numeric fill] List Sets the values of non-used bits:[on]: Each non-used bit is assigned aBoolean “0” and positive values arepreceded by a plus sign.[off]: Bits which are not used remainblank.

[Fill] Input field Sets the fill character.

[Alignment] List Sets the alignment of the value withinthe defined bit width:[Left][Right]

[Byte order] List Sets the byte order:[little endian]: least significant byte of bi-nary data at the first position or at thelowest memory address.[big endian]: most significant byte of bi-nary data at the first position or at thelowest memory address.[Network byte order]: byte order speci-fied by the network protocol.[Bus-depending order]: byte order speci-fied by the fieldbus.

Main areaThe data packages of the interface are set in the main area. The data packages are displayed asrectangles. The data blocks are connected via dashed connecting lines. The data is sent from left toright in the order of the data blocks.

The “main area” contains the following operating elements:


Add data package Adds a data package at the position. (ÒInsert data package / 77)

Set data package Sets the selected data package.

Delete data package Deletes the selected data package.

Show/hide loops Shows or hides the loop of the datapackage [Models].The data package [Models] consists ofseveral data packages which are con-nected via loops.Depending on the ROIs contained, thisloop is passed through several times.

Output string“Output string” is a character string which is changed with the data packages in the main area.Depending on the selected data encoding in the area “Settings”, “Output string” is displayed as ASCIIor bool code.

The area “Output string” contains the following operating elements:

O2I5xx

77


[Copy to clipboard] Button Copies the “Output string” to the clip-board.

“Output string” cannot be set directly. “Output string” is set via the data packages in the mainarea.

Overview areaThe overview area displays a reduced overview of the main area. The red frame is shifted using themouse. By this, the data packages outside the visible area can be displayed.

11.5.1 Insert data packageA data package is inserted in the main area with the [+] button. After clicking [+], a list opens. The datapackage is set with the elements in the list.

The content of the list is variable and depends on the position of the data package in the“Output string”.

The list contains the following data packages in the area “General”:

Data package Description

[Start string] Adjustable character string for starting a data transfer.

[End string] Adjustable character string for ending a data transfer.

[User-driven input] Adjustable character string within data transfer.

[Index of active application] Index of the active application

[Application decoding time [ms]] Evaluation time of the application in [ms]

The list contains the following data packages in the area “Logic layer”:


[Reading result (pass/fail)] Read result of the logic block “State definition: pass/fail”. (ÒLogic block “Statistics” / 72)

[Number of bytes in output string 0-9] Size in bytes of the content of the logic block “Output string”.(Ò Logic blocks “Output” / 71)

[Output string 0-9] Content of the logic block “Output string”. (Ò Logic blocks“Output” / 71)

[Digital output] Bit order with the values at the digital outputs.

[Virtual output] 8-byte order with the values at the inputs of the virtual pins.

The list contains the following data packages in the area “Application results”:


[Number of images] Number of the images defined for the application.

[Images] The captured images are provided as JPEG one after the oth-er.

[Number of models] Number of the images created for the application.

GB

O2I5xx

78


[Models] The data of the defined models is provided one after the oth-er. The data package is displayed as a program loop. Thecontent of the program loop also consists of data packageswhich can be selected separately:[Model ID]: The “Model ID” consists of a consecutive ID(0-999) in the order in which the models were defined. After999 IDs have been assigned in an application, the IDs of de-leted models are assigned again.[Model decoding status]: Decoding status of the model. (ÒLogic blocks “Model results” / 63)[Model: number of codes searched]: Number of the searchedcodes.[Model: number of codes found]: Number of the codes found.[Model pass/fail]: State definition pass/fail. (Ò Logic block“Statistics” / 72)[Number of ROI groups]: Number of ROI groups in the model.(Ò Logic blocks “Model results” / 63)[Result ROI groups]: Result of the ROI groups.[User-driven input]: Adjustable character string.[Delimiter]: Delimiter to split data packages.


[Delimiter] Delimiter to split data packages.

11.5.2 Example of “Provide overall quality”In the example, the data packages were configured such that the overall quality is provided via theinterface.

Fig. 18: Provide overall quality

11.6 TestThe function “Test” records statistical data on the selected application. During the test, the currentstates of the device are displayed.

O2I5xx

79

1

2

3

5

4

Fig. 19: Function “Test”1 Buttons to control the test 2 State of the digital outputs3 Overall statistics 4 Image quality check5 Test images

The function “Test” contains the following operating elements:


[Start test] Button Starts the test according to the setting“Trigger mode”. (Ò Trigger mode / 30)

[Stop test] Button Stops the test.

Button Forces a trigger manually.

[Reset all statistics] Button Resets all statistics.

Overall statisticsThe overall statistics include the following data:

• number of detected and non-detected codes

• evaluation time of the test images

• number of the total measurements

Image quality checkThe image quality check checks whether the measured values received from the camera are withinthe permitted value range. (Ò Image quality check / 33)

Test imagesImage capture generates test images while the test is active. The test images are chronologicallysorted. The most current test image is on the very left.

Additional information is saved with each test image:

GB

O2I5xx

80

• status of the digital outputs OUT1 and OUT2

• overall statistics

• capture time as from test start in minutes:seconds

By clicking on a test image, it is displayed enlarged in the area “Live image”. The states of the digitaloutputs and the overall statistics are displayed at the time the test image is captured.

Clicking the reduced test image several times switches between the selected test image and thelast recorded test image.

O2I5xx

81

12 Service reportThe area “Service Report” creates an evaluation of the last 25 pass and fail evaluations withinformation on the software and hardware of the device. The service report can be exported forsupport requests.

Fig. 20: Area “Service report”

The area “Service report” contains the following operating elements:


Reload Reloads the evaluation of the service re-port. Reloading may take up to 1 min.

Export Exports the evaluation of the service re-port to a folder.

Area “Sort and filter”:

GB

O2I5xx

82


[Sort by] List Sorts the evaluation according to the fol-lowing characteristics:[Newest first]: The most recent measure-ments are displayed first.[Failed -> passed] Failed measurementsare displayed first.[Passed -> failed] Passed measure-ments are displayed first.[OUT1 -> OUT2]: Output 1 is displayedbefore output 2.[OUT2 -> OUT1]: Output 2 is displayedbefore output 1.[Application name] The measurementsare sorted alphabetically by the name ofthe application.[Duration long -> short]: The longestmeasurement is displayed first.[Duration short -> long]: The shortestmeasurement is displayed first.

[Filter status failed] Checkbox Filters the measurements with the status“Failed” if the checkbox is deactivated.

[Filter status passed] Checkbox Filters the measurements with the status“Passed” if the checkbox is deactivated.

[Filter OUT1 active] Checkbox Filters the measurements with activeoutput 1 if the checkbox is deactivated.

[Filter OUT1 inactive] Checkbox Filters the measurements with inactiveoutput 1 if the checkbox is deactivated.

[Filter OUT2 active] Checkbox Filters the measurements with activeoutput 2 if the checkbox is deactivated.

[Filter OUT2 inactive] Checkbox Filters the measurements with inactiveoutput 2 if the checkbox is deactivated.

The evaluation is not filtered by default.

O2I5xx

83

13 Device setupThe device and the networks used are set in the area “Device setup”.

1

Fig. 21: Area “Device setup”.1 List

The area “Device setup” contains the following list items:

Item Description

[General] Sets the device, updates the firmware and imports/exports thesettings. (Ò General / 83)

[Network] Sets the Ethernet interface. (Ò Network / 84)

[Interfaces] Sets the process interfaces. (Ò Interfaces / 85)

[NTP] Synchronises the time of the device. (Ò NTP / 86)

[FTP] Sets the connection to an FTP server. (Ò FTP / 87)

[RTSP] Sets the real-time streaming protocol. (Ò RTSP / 88)

[ifm storage device] Sets the ifm storage device. (Ò ifm storage device / 89)

13.1 GeneralThe item [General] sets the device, updates the firmware and imports/exports the settings.

The item [General] contains the following operating elements:


Button Saves the settings on the device.

GB

O2I5xx

84


Button Resets the changed settings.

[Name] Input field Sets the name of the device.

[Description] Input field Sets a description for the device.

[Password protection] Switch Activates the password protection. Pass-word protection activates write protec-tion for the following areas:- “Application”- “Device setup”- Teaching via button on the deviceThe password unlocks the areas. Thearea “Monitor” can always be accessed,regardless of password protection.

[Change password] Button Changes the password.If the password is lost, contact the man-ufacturer's support with the serial num-ber of the device.

[Enable button teach] Switch Activates teaching via button. The button“Teach” on the device is used to teachthe device directly (see operating in-structions).

[Save and restore statistics on applica-tion switch]

Switch Saves the statistics of an application be-fore switching to another application.If there are already statistics saved foran application, they are restored.

[Export] Button Exports the settings of the device to afile.

[Import] Button Imports the settings of the device from afile.The settings and applications on the de-vice are overwritten when importing.

[Update] Button Updates the firmware of the device.The current firmware version is shownnext to the button.In order for the firmware to update suc-cessfully, a static IP address is assignedto the device beforehand. (Ò Assigninga static IP address / 91)

[Reset] Button Restores the factory settings and de-letes all settings and applications.

[Reboot] Button Reboots the device.

13.2 NetworkThe item [Network] sets the Ethernet interface.

The item [Network] contains the following operating elements:




O2I5xx

85


[DHCP] Switch Activates the automatic assignment ofthe network settings (DHCP).With activated DHCP, the input fields [IPaddress], [Subnet mask] and [Gateway]are not available.

[IP address] Input field Changes the IP address of the device(default value: “192.168.0.69“).The device must be rebooted if the pro-cess interface is used after a change ofthe IP address. If TCP/IP is used as pro-cess interface, it is not necessary to re-boot the device.

[Connected via ...] Output field Displays the current connection type andIP address.

[Subnet mask] Input field Sets the subnet mask of the device (de-fault value: “255.255.255.0”).

[Gateway] Input field Sets the gateway of the device (defaultvalue: “192.168.0.201”).

MAC address Output field Displays the MAC address of the device.

13.3 InterfacesThe item [Interfaces] sets the process interfaces. In addition, a wiring test can be carried out.

The item [Interface] contains the following operating elements:




[Process interface version] List Sets the version of the process interfaceprotocol. Currently only version “V3” issupported.

[TCP/IP port for PCIC] Input field Sets the TCP/IP port for the data of theprocess interface with a socket connec-tion (default value: “50010”).

[PCIC TCP/IP schema auto update] Switch Activates the corresponding PCIC dataoutput (see operating instructions) whenthe active application is changed.If the switch is deactivated, the PCIC da-ta output of the previous application re-mains active when the active applicationis changed (see operating instructions).Only if the connection to the device isseparated, will the PCIC data outputchange.

[Active fieldbus] List Sets the fieldbus for the communicationwith connected controllers.The setting has an effect on all applica-tions.

[Producing size] Input field Sets the size of the “Producing” memo-ry, if- the output buffer of the PLC is toosmall,- the length of the data to be sent is tobe limited.Value range: “16-450 bytes”

GB

O2I5xx

86


[Consuming size] Input field Sets the size of the “Consuming” memo-ry, if- the input buffer of the PLC is too small,- the length of the data to be sent is tobe limited.Value range: “8-450 bytes”

[Web interface EDS file URL] Button Downloads the EDS file from the device.The EDS file (Electronic Data Sheet) isused to prepare a controller for Ether-Net/IP.

[Output logic] List Sets the output logic of the digital out-puts of the device:[PNP]: Switch positive potential to theoutput.[NPN]: Switch ground to output.

[IO debouncing] Switch Activates the debouncing of the trigger.Then a signal has to be present for atleast 4 ms to be detected as trigger sig-nal. Shorter signals are ignored.

[External illumination] List Reserves the digital output OU2 for theexternal illumination (see operating in-structions):[Disabled]: The external illumination isnot used and is deactivated.[Using OUT2]: The digital output OUT2is reserved for the external illumination.Output OUT2 is no longer available as alogic block. (Ò Logic blocks “Out-put” / 71)

[OUT 1] Switch Switches the digital output OUT1. Thewiring test must be active.

[OUT 2] Switch Switches the digital output OUT2. Thewiring test must be active.

[Start] Button Starts the wiring test to test the digitaloutputs. During the wiring test, the appli-cations are disabled.

13.4 NTPThe item [NTP] synchronises the time of the device. The clock is synchronised via the Network TimeProtocol (NTP).

In the event of connection problems, activate port “123” in the firewall.

The clock is not buffered by a battery. If the current supply fails, the clock is reset.

The item [NTP] contains the following operating elements:




[Activate NTP] Switch Activates the Network Time Protocol.

O2I5xx

87


[NTP server IP] Input field Sets the IP address of the server. Thedate and the time are synchronised withthe server. Several servers can be set.Besides the IP address, the status of theserver is displayed:[green field]: The server responds.[red field]: The server does not respond.[grey field]: So far no request has beensent to the server.

Button Checks the IP address of the server.

Button Deletes the IP address of the server.The button is only displayed after check-ing an IP address.

Button Adds a server.The button is only displayed after check-ing an IP address.

[Synchronisation time] Input field Sets the waiting time of the NTP serverwhen the device is restarted. During thewaiting time the device is not accessiblefor the ifmVisionAssistant.

[Current time set on device] Output field Displays the time currently used in thedevice.

13.5 FTPThe item [FTP] sets the connection to an FTP server. The device sends current images andconfigurations to the FTP server if certain events occur.

FTP transfers data such as user name and password unencrypted. The data can be read andmanipulated by third parties.

u Do not use the user name and the password of the FTP server for other services.

u Restrict the visibility of the FTP server to the local network.

u Do not use the function [FTP] if the FTP server is visible on the internet.

In the event of connection problems, activate ports “20” and “21” in the firewall.

The item [FTP] contains the following operating elements:




Button Adds a server.

[Status of the FTP server] Output field Displays the status of the server via acoloured field:[green field]: The server responds.[red field]: The server does not respond.[grey field]: So far no request has beensent to the server.

Button Renames the server.

GB

O2I5xx

88


Button Deletes the IP address of the server.

[Activate] Checkbox Activates the client of the device.

Area “Connection”


[Server IP] [Port] Input field Sets the IP address and the port of theFTP server (default value of the port:“21”).

[User] [Password] Input field Sets the user name and the password ofthe FTP server if authentication is re-quired.

Area “Folders”


[Push decoding results] Checkbox Activates the transfer of decoding resultsto the FTP server.

[Path] Input field Sets the path to transfer the decodingresults.

[Push image data] Checkbox Activates the transfer of the image datato the FTP server.

[Path] Input field Sets the path to transfer the image data.

[Push device and application configura-tion data]

Checkbox Activates the transfer of device and ap-plication data to the FTP server.

[Path] Input field Sets the path to transfer the device andapplication data.

Area ”Configuration”


[Passive mode] Checkbox Activates the passive mode. The pas-sive mode reduces connection problemsin context with a firewall.

[Keep alive] Checkbox Activates the keep-alive function. De-pending on the configuration, the con-nection is quickly stopped on the serverside. With the keep-alive function, theconnection remains active.

[Warranty of data transfer] Checkbox Activates the warranty of data transfer. Itis ensured that all data is transferred. Ifthe data is not transferred fast enough, itis possible that- image capture is delayed,- the frame rate is reduced.

[Result types that should be pushed] List Sets the result type which is transferredto the FTP server:[Only fail results][Only pass results][All results]

13.6 RTSPThe item [RTSP] controls the transfer of the live image as video data stream. The stream can bereplayed with a client software (video player with RTSP support).

As soon as the item [RTSP] is active and the following conditions apply, the live image of the device istransmitted:

O2I5xx

89

• an application is active, (Ò Application / 23)

• at least one model has been added. (Ò Add new model / 36)

Together with the live image, the ROIs are transmitted, depending on the model set. (Ò Models / 34)The live image can be retrieved via the displayed URL.


In the event of connection problems, activate port “554” in the firewall.

The item [RTSP] contains the following operating elements:




[Activate RTSP] Switch Activates the Real-Time Streaming Pro-tocol.

[Frame rate] Slider / input field Sets the transferred images per second.High values lead to smoother imagetransitions and require more band widthin the network.

[Image quality] Slider / input field Sets the quality of the images. High val-ues increase the image quality, reducethe compression and increase the re-quired bandwidth.Small values reduce the image quality,increase the compression and reducethe required bandwidth.

[Port] Output field Displays the preset port.

[RTSP stream url:] Output field Displays the URL set for retrieving theRTSP. Clicking on the URL opens theURL in a compatible video player.Right-click to copy the URL to the clip-board.

13.7 ifm storage deviceThe item [ifm storage device] sets the ifm storage device of the device. The ifm storage device islocated behind a service lid in the device (see operating instructions). The configuration of the deviceand error images are saved on the ifm storage device. The stored content can be accessed via a webinterface.

If the device fails due to a defect, the configuration is saved on the ifm storage device and can bequickly transferred to a replacement device (see operating instructions).

The ifm storage device must not be inserted in a PC, notebook etc.

u Only use the ifm storage device with the devices O2I5xx.

The item [ifm storage device] contains the following operating elements:




GB

O2I5xx

90


[Enable failed image storage] Checkbox Activates saving of images to the ifmstorage device in case of an error.

[Enable configuration change storage] Checkbox Activates saving of configurations on theifm storage device.

[Format storage] Button Formats the ifm storage device.Formatting cannot be reversed. All dataon the ifm storage device is deleted.

[Import config] Button Imports the configuration saved last onthe ifm storage device.After clicking the button, the configura-tions for the import are selected:[General settings][Network][Application settings]The currently used configuration is over-written by the import.

[Error state] Output field Displays the status of the ifm storagedevice.

[Web interface URL] Output field Displays the URL to the web interface ofthe ifm storage device.A click on the URL shows the content ofthe ifm storage device in the web brows-er.

O2I5xx

91

14 Appendix

14.1 Assigning a static IP addressBelow you find a description of how to assign a static IP address to the PC. A static IP address isnecessary if

• the assignment of a dynamic IP address is not possible due to the network configuration,

• the firmware of the device is to be updated.

The details of the network settings in this document describe the procedure for PCs with theoperating system Windows 10. Changing network settings in a PC requires administrator rights.The following ports must be enabled in the firewall:

- UDP: 3321

- TCP/HTTP: 80 and 8080

- TCP: 50010

Assigning a static IP address:

u Open the [Network and Sharing Centre] in Windows.

u Click the name of the local network.

w The window [Ethernet Status] opens.

u Click the button [Properties].

w The window [Ethernet Properties] opens.

u Activate the checkbox [Internet Protocol Version 4 (TCP/IPv4)].

u Click the button [Properties].

w The window [Internet Protocol Version 4 (TCP/IPv4) Properties] opens.

u Activate the option field [Use the following IP address].

u Set “192.168.0.1” for the IP address.

u Set “255.255.255.0” for the subnet mask.

u Set “192.168.0.201” for the default gateway.

u Click the button [OK].

GB

O2I5xx

92

List of figuresFig. 1 Start page ............................................................................................................................ 15Fig. 2 User interface ...................................................................................................................... 19Fig. 3 Area “Monitor”...................................................................................................................... 21Fig. 4 Area “Application” ................................................................................................................ 23Fig. 5 Area “Edit application” ......................................................................................................... 25Fig. 6 Function “Images & trigger” ................................................................................................. 27Fig. 7 Image quality check ............................................................................................................. 33Fig. 8 Function “Models” ................................................................................................................ 35Fig. 9 Orientation of the code ........................................................................................................ 43Fig. 10 Function “Flow” .................................................................................................................... 58Fig. 11 Function “Logic” ................................................................................................................... 60Fig. 12 Contact areas with connecting line ...................................................................................... 61Fig. 13 Output logic.......................................................................................................................... 63Fig. 14 Example 1 of “Compare reference code”............................................................................. 73Fig. 15 Example 2 of “Compare reference code”............................................................................. 73Fig. 16 Example 3 of “Compare reference code”............................................................................. 74Fig. 17 Function “Interfaces”............................................................................................................ 75Fig. 18 Provide overall quality.......................................................................................................... 78Fig. 19 Function “Test”..................................................................................................................... 79Fig. 20 Area “Service report” ........................................................................................................... 81Fig. 21 Area “Device setup”. ............................................................................................................ 83

O2I5xx

93

List of tablesTab. 1 Title bar...................................................................................................................... 15Tab. 2 Menu bar.................................................................................................................... 15Tab. 3 Buttons....................................................................................................................... 16Tab. 4 Operating elements ................................................................................................... 17Tab. 5 Operating elements ................................................................................................... 18Tab. 6 Output format............................................................................................................. 18Tab. 7 Data format ................................................................................................................ 18Tab. 8 Output range.............................................................................................................. 18

GB

o2i5xx gb software manual

Documents