Cognex DataMan Istruzioni operative

DataMan®Communications

and Programming Guide

2020 August 13

Revision: 6.1.9.1

Legal Notices

The software described in this document is furnished under license, and may be used or copied only in accordance with

the terms of such license and with the inclusion of the copyright notice shown on this page. Neither the software, this

document, nor any copies thereof may be provided to, or otherwise made available to, anyone other than the licensee.

Title to, and ownership of, this software remains with Cognex Corporation or its licensor. Cognex Corporation assumes

no responsibility for the use or reliability of its software on equipment that is not supplied by Cognex Corporation.

Cognex Corporation makes no warranties, either express or implied, regarding the described software, its

merchantability, non-infringement or its fitness for any particular purpose.

The information in this document is subject to change without notice and should not be construed as a commitment by

Cognex Corporation. Cognex Corporation is not responsible for any errors that may be present in either this document or

the associated software.

Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document

may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, nor

transferred to any other media or language without the written permission of Cognex Corporation.

Portions of the hardware and software provided by Cognex may be covered by one or more U.S. and foreign patents, as

well as pending U.S. and foreign patents listed on the Cognex web site at: cognex.com/patents.

The following are registered trademarks of Cognex Corporation:

Cognex, 2DMAX, Advantage, AlignPlus, Assemblyplus, CheckitwithChecker, Checker, CognexVisionforIndustry,

CognexVSOC, CVL, DataMan, DisplayInspect, DVT, EasyBuilder, Hotbars, IDMax, In-Sight, LaserKiller, MVS-8000,

OmniView, PatFind, PatFlex, PatInspect, PatMax, PatQuick, SensorView, SmartView, SmartAdvisor, SmartLearn,

UltraLight, VisionSolutions, VisionPro, VisionView

The following are trademarks of Cognex Corporation:

The Cognex logo, 1DMax, 3D-Locate, 3DMax, BGAII, CheckPoint, CognexVSoC, CVC-1000, FFD, iLearn, In-Sight

(design insignia with cross-hairs), In-Sight2000, InspectEdge, Inspection Designer, MVS, NotchMax, OCRMax,

PatMaxRedLine, ProofRead, SmartSync, ProfilePlus, SmartDisplay, SmartSystem, SMD4, VisiFlex, Xpand

Other product and company trademarks identified herein are the trademarks of their respective owners.

Legal Notices

Table of Contents

Legal Notices 2

Table of Contents 3

Symbols 4

About This Manual 5

Networking 6

Connecting Your DataMan to the Network 6

Connecting Your Fixed-Mount DataMan Reader to the Network 6

Connecting Your Handheld DataMan Reader to the Network 6

Connecting Your DataMan Intelligent Base Station to the Network 10

Direct Connection to Your Computer 11

Connecting Your Reader Across Subnets 16

Troubleshooting a Network Connection 17

DataMan Application Development 18

DMCC Overview 18

Command Syntax 18

DataMan SDK Development 20

Scripting 24

Script-Based Data Formatting 24

Error Management 28

Output 49

Code Completion and Snippets 51

Custom Communication Protocol API 53

Table of Contents

Symbols

The following symbols indicate safety precautions and supplemental information:

WARNING:This symbol indicates a hazard that could cause death, serious personal injury or electrical shock.

CAUTION:This symbol indicates a hazard that could result in property damage.

Note: This symbol indicates additional information about a subject.

Tip: This symbol indicates suggestions and shortcuts that might not otherwise be apparent.

Symbols

About This Manual

The DataMan Communications and Programming Guide provides information on how to integrate DataMan readers into

your particular environment, including:

lNetwork configuration

lDataMan Control Commands (DMCC) API

The DataMan reader connected to a network can be triggered to acquire images by several methods:

lusing the DataMan Setup Tool

ltrigger bits

lthrough a DMCC command

lmanipulating objects through industrial protocols

For information on industrial protocols, see the DataMan Industrial Protocol Manual. All the other methods are explained

in detail in this document.

About This Manual

Networking

You can connect your DataMan device via a simple Ethernet connection. You can either set the IP address and subnet

mask of your DataMan device manually or let them be configured automatically using DHCP.

Connecting Your DataMan to the Network

Connecting Your Fixed-Mount DataMan Reader to the Network

Supply power to the reader using either a Power over Ethernet (PoE) injector (DataMan 260 series readers) or the

Power and I/O breakout cable (CCB-PWRIO-xx).

Cognex recommends the following connection sequence in case of using a PoE injector:

1. Connect the PoE injector to the Ethernet network (both ends of the patch cable).

2. Connect the power cord (AC 230V/110V) to the PoE injector.

3. Connect the reader to the PoE injector.

To disconnect the reader:

1. Disconnect the reader from the PoE injector.

2. Disconnect the power cord from the PoE injector.

3. Disconnect the PoE injector from the Ethernet network.

Connecting Your Handheld DataMan Reader to the Network

If you are using an Ethernet slide-in with your handheld DataMan reader, power your reader through Power over

Ethernet (PoE) and connect the Ethernet cable of the PoE to the network.

Networking

If you are using a serial slide-in with your handheld DataMan reader, connect the serial cable to your PC, power your

reader through an external power supply and connect your PCto the network.

Connecting Your DataMan to the Network Wirelessly

You can connect to your DataMan reader via the wireless network as well. For this, you need to use the Wi-Fi slide-in

with the device.

Ad-hoc Connection

The default factory settings for the wireless configuration of the device are:

lad-hoc connection

lno encryption and no authentication

lSSID: the name of the device

This means that you can connect to your DataMan without the base station or a router.

To connect to your DataMan reader in ad-hoc mode, perform the following steps:

Networking

1. Make sure that the DataMan device is (re)set to factory settings.

2. Search for the DataMan device among the available wi-fi connections and connect to it.

3. Open the DataMan Setup Tool.

4. Search for the device and connect to it.

5. Once you are connected to your DataMan device in the DataMan Setup Tool, you can configure the wireless

connection.

a. Authentication: only Open Mode can be selected.

b. Encryption method: WEP-40 and WEP-104. You can enter a passphrase for these methods.

Infrastructure Mode

You can set Wireless Infrastructure mode in the DataMan Setup Tool as well.

1. Connect to your device in the DataMan Setup Tool.

2. In the WiFi tab of Communication Settings, select Infrastructure mode from the Network Type combo box. A

warning appears if the SSID name is identical to the device name, as this results in the misconfiguration of the

device.

Networking

3. Select from the following authentication modes:

Authentication mode Encryption mode Requirements

Open System WEP-40, WEP-104 passphrase

WPA-PSK, WPA2-PSK TKIP, AES, TKIP/AES passphrase

EAP-TLS (see the section below) TKIP, AES, TKIP/AES lClient’s certificate

lCA’s certificate

lClient’s private key

lClient’s username

PEAP-MSCHAPV2 (see the section

below)

TKIP, AES, TKIP/AES lCA’s certificate

lClient’s username

lClient’s password

EAP-TLS Authentication Mode

Encryption methods: TKIP, AES, TKIP/AES are supported. All of these methods require specifying several PEM files,

which are created by the user’s local system administrator and contain certificate information.

These certificates are used to encrypt the communication between the Wi-Fi Access Point and the reader.

The following certificates are required:

lClient’s certificate. This must be different for each reader. It may be publicly accessible (for example, on a

company webpage).

lCA’s certificate (CA = Certificate Authority). One such file is created for each authentication server within the

company. It can be publicly accessible.

lClient’s private key. This must be different for each reader. It must not be publicly accessible, and must be stored

and handled confidentially.

Uploading a Certificate File to DataMan

You can upload these files in the DataMan Setup Tool one by one: click the folder button beside the fields and select the

appropriate file to upload it to the device.

A short message shows if a certificate is specified. The text “<not set>” appears in the field if there is no key or certificate

specified.

Networking

Removing a Certificate File from DataMan

Click the red X button beside the corresponding field to delete an existing certificate from your device. The certificates

are saved into device backups, and may be completely restored.

PEAP-MSCHAPV2 Authentication Mode

Encryption methods: TKIP, AES, TKIP/AES are supported. All these methods require a PEM file containing the CA’s

certificate, the client’s user name, and a password.

Certificate Files

In the DataMan Setup Tool, the following restrictions apply to the PEM files:

lTheir format must be the industry-standard PEM format (generated by OpenSSL toolkit).

lThe PEM dialect may be either PKCS8 or SSLeay.

lOnly an unencrypted private key and certificate files are allowed.

lThe Client’s private key and certificate must contain exactly one section; the CA’s certificate can contain one or

more certificates.

lMake sure that you know the user name stored within your own certificate file, and use the same name in the

Client’s user name text box. This is necessary because the Setup Tool does not look into the certificate files to

extract this user name information.

When you leave the Wireless tab, a reboot confirmation window pops up and the settings are saved to the device.

Connecting Your DataMan Intelligent Base Station to the Network

1. If you use DMA-IBASE-00, power up your base station using one of these two options:

lIf you want to connect the Ethernet cable directly to the network or your PC, power up the base station

using a 24V power supply.

Networking

Altri manuali per DataMan

Indice

Altri manuali Cognex Lettore di codici a barre

Cognex

Cognex DataMan 360 Series Manuale utente

Cognex

Cognex DataMan 475 Verifier Manuale utente

Cognex

Cognex DataMan Guida per l'amministratore

Cognex

Cognex DataMan 8700 Manuale utente

Cognex

Cognex DataMan DM474 Manuale utente

Cognex

Cognex DataMan 8600 Series Manuale utente

Cognex

Cognex DataMan 260 Series Manuale utente

Cognex

Cognex DATAMAN 500 Manuale utente

Cognex

Cognex DataMan 300 Series Manuale utente

Cognex

Cognex DataMan 50 Manuale utente

Cognex

Cognex DataMan 300 Series Manuale utente

Cognex

Cognex DataMan 470 Series Manuale utente

Cognex

Cognex DataMan 8700 Manuale utente

Cognex

Cognex DataMan 8050 Manuale utente

Cognex

Cognex DataMan 8600 Verifier Series Manuale utente

Cognex

Cognex DATAMAN 500 Manuale utente

Cognex

Cognex DataMan 200 Manuale utente

Cognex

Cognex DataMan 7550 Manuale utente

Cognex

Cognex DataMan 380 Series Manuale utente

Cognex

Cognex VisionPro Trevista CI Dome Manuale utente

Cognex

Cognex DataMan 700 series Manuale utente

Cognex

Cognex DataMan 280 Series Manuale utente

Cognex

Cognex DataMan 280 Series Manuale utente

Cognex

Cognex DataMan 8050 Manuale utente

Manuali Lettore di codici a barre popolari di altre marche

POSMicro

POSMicro Datalogic PowerScan D7100 Manuale utente

Marson

Marson MT780 Guida rapida alla configurazione

NCR

NCR RealPOS Manuale utente

Motorola

Motorola SE3300 Guida rapida alla configurazione

Element

Element P130BT Manuale utente

Motorola

Motorola Symbol LS3008 Manuale di installazione e funzionamento

Meec tools

Meec tools OBD-II / VAG Manuale utente

SICK

SICK CLP 100 Manuale utente

Royal Tag SA

Royal Tag SA I-Read Manuale utente

Welch Allyn

Welch Allyn IMAGETEAM 3800 Manuale utente

Meteor

Meteor 8310 Manuale utente

Denso

Denso BHT-500B Manuale utente

Datalogic

Datalogic Heron HD3130 Manuale utente

Motorola

Motorola MP6000 Istruzioni di montaggio

Newland

Newland NLS-HR15-BT Manuale utente

ARTDEV

ARTDEV AS-1310 Manuale utente

Aopos

Aopos AS290 Manuale utente

ENS

ENS 367-5455 Manuale utente