Cognex DataMan 370 Series Mode d'emploi

DataMan®Communications

and Programming Guide

2022 December 22

Revision: 6.1.14.3

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 25

Script-Based Data Formatting 25

Error Management 29

Output 56

Code Completion and Snippets 58

Custom Communication Protocol API 60

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

Autres manuels pour DataMan 370 Series

Table des matières

Autres manuels Cognex Lecteur de codes-barres

Cognex

Cognex In-Sight 2800 Series Manuel utilisateur

Cognex

Cognex DataMan 60 Manuel utilisateur

Cognex

Cognex DataMan 280 Series Manuel utilisateur

Cognex

Cognex DataMan 700 series Manuel utilisateur

Cognex

Cognex DataMan 503 Manuel utilisateur

Cognex

Cognex DataMan 260 Manuel utilisateur

Cognex

Cognex DataMan 9500 Manuel utilisateur

Cognex

Cognex DM503 Manuel utilisateur

Cognex

Cognex MX-1000 Manuel utilisateur

Cognex

Cognex DataMan 8000 Series Manuel utilisateur

Cognex

Cognex Advantage 182 Series Instructions de montage

Cognex

Cognex DataMan 470 Series Manuel utilisateur

Cognex

Cognex DataMan DM474 Manuel utilisateur

Cognex

Cognex DataMan 8000 Series Manuel utilisateur

Cognex

Cognex DataMan 150 Manuel utilisateur

Cognex

Cognex DataMan DT150 Manuel utilisateur

Cognex

Cognex DataMan 150 Manuel utilisateur

Cognex

Cognex VisionPro Trevista CI Dome Manuel utilisateur

Cognex

Cognex DataMan 360 Series Manuel utilisateur

Cognex

Cognex DataMan 475 Verifier Manuel utilisateur

Cognex

Cognex DataMan 302L Manuel utilisateur

Cognex

Cognex DataMan 280 Series Manuel utilisateur

Cognex

Cognex DataMan 8072 Manuel utilisateur

Cognex

Cognex DataMan 300 Series Manuel utilisateur

Manuels Lecteur de codes-barres populaires d'autres marques

POSMicro

POSMicro Datalogic PowerScan D7100 Manuel utilisateur

Marson

Marson MT780 Guide de configuration rapide

NCR

NCR RealPOS Manuel utilisateur

Motorola

Motorola SE3300 Guide de configuration rapide

Element

Element P130BT Manuel utilisateur

Motorola

Motorola Symbol LS3008 Manuel d'installation et d'exploitation

Meec tools

Meec tools OBD-II / VAG Manuel utilisateur

SICK

SICK CLP 100 Manuel utilisateur

Royal Tag SA

Royal Tag SA I-Read Manuel utilisateur

Welch Allyn

Welch Allyn IMAGETEAM 3800 Manuel utilisateur

Meteor

Meteor 8310 Manuel utilisateur

Denso

Denso BHT-500B Manuel utilisateur

Datalogic

Datalogic Heron HD3130 Manuel utilisateur

Motorola

Motorola MP6000 Instructions de montage

Newland

Newland NLS-HR15-BT Manuel utilisateur

ARTDEV

ARTDEV AS-1310 Manuel utilisateur

Aopos

Aopos AS290 Manuel utilisateur

ENS

ENS 367-5455 Manuel utilisateur