14.12.2012 Views

COGNEX DM100_200 ControlCommands - Bci GmbH

COGNEX DM100_200 ControlCommands - Bci GmbH

COGNEX DM100_200 ControlCommands - Bci GmbH

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

DMCC Overview<br />

DataMan Control Commands Documentation 3.5<br />

Overview<br />

DataMan Control Commands (DMCC) are a method of configuring and controlling a DataMan reader from a COM<br />

port, either directly or programatically through a custom application. Depending on the DataMan reader you are<br />

using, the COM port connection be either RS232, USB, or the Telnet protocol in the case of the DataMan <strong>200</strong>. By<br />

default, the DataMan <strong>200</strong> reader is configured to communicate over TCP port number 23, but you can use the<br />

Setup Tool to assign a different port number as necessary.<br />

Cognex recommends using HyperTerminal, a built-in Windows communications application, to test your ability to<br />

connect to an available reader.<br />

Command Syntax<br />

All DMCC commands are formed of a stream of ASCII printable characters with the following syntax:<br />

command-header command [arguments] footer<br />

For example:<br />

||>trigger on\CR\LF<br />

Command Header Syntax<br />

||checksum:command-id><br />

All options are colon separated ASCII text. A header without the header-option block will use header defaults.<br />

checksum<br />

0: no checksum (default)<br />

1: last byte before footer is XOR of bytes<br />

command-id<br />

An integer command sequence that can be reported back in acknowledgement.<br />

Header Examples<br />

Command<br />

The command is an ASCII typable string possibly followed by data. All command names and public parameters<br />

data are case insensitive. Only a single command may be issued within a header-footer block. Commands,<br />

parameters and arguments are separated by a space character.<br />

Commands<br />

Short names specifing an action.<br />

A commonly used command is GET or SET followed by a Parameter and Value.<br />

Parameters<br />

Short names specifing a device setting.<br />

Parameter names are orgainzed with a group of similar commands with one level of structural orgaization<br />

separated by a period ('.').<br />

Arguments<br />

Boolean: ON or OFF<br />

Integer: 123456<br />

String: ASCII text string enclosed by quotes (“).The string content is passed to a function to translate the<br />

string to the final format. The following characters must be backslash escaped: quote (\”), backslash (\\),<br />

pipe (\|), tab (\t), CR(\r), LF (\n).<br />

Footer<br />

Example Description<br />

||> Default Header<br />

||0:123> Header indicating no-checksum and ID of 123<br />

||1> Header indicating checksum after command and data.<br />

The footer is a carriage return and linefeed (noted as \CR\LF or \r\n).<br />

Reader Response<br />

The reader will have one of several response formats. The choice of response format is a configured using the<br />

SET COM.DMCC-RESPONSE command. Note that while the reader can process a stream of DMCC commands, it<br />

is typically more robust to either wait for a response, or insert a delay between consecutive commands.<br />

Silent: (Default) No response will be sent from the reader. Invalid commands are ignored without feedback.<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 1 of 24<br />

27.12.2010


DMCC Overview<br />

Command responses are sent in space delimited ASCII text without a header or footer.<br />

Extended: The reader responds with a header data footer block similar to the command format. Symbol<br />

read/no-read data returned from the reader is encoded in base64 as described in RFC 2045.<br />

||checksum:command-id[status]<br />

checksum<br />

The response uses the same checksum format as the command sent to the reader.<br />

0: no checksum<br />

1: last byte before footer is XOR of bytes<br />

command-id<br />

The command-id sent to the reader is retuned in the response header.<br />

status<br />

An integer in ASCII text format.<br />

0: no error<br />

1: reader initiated read-string<br />

100: unidentified error<br />

101: command invalid<br />

102: parameter invalid<br />

103: checksum incorrect<br />

104: parameter rejected/altered due to reader state<br />

Examples<br />

Command Silent Response<br />

||>GET<br />

SYMBOL.DATAMATRIX\r\n<br />

||>SET<br />

SYMBOL.DATAMATRIX<br />

ON\r\n<br />

||>TRIGGER ON\r\n decoded data or no-read<br />

response<br />

DataMan Control Commands Documentation 3.5<br />

DataMan Control Commands<br />

Action Commands<br />

System Commands<br />

Camera & Light Commands<br />

Decoder Commands<br />

Symbology Commands<br />

Data Formatting Commands<br />

Data Validation Commands<br />

Code Quality Commands<br />

I/O Commands<br />

Communication Commands<br />

DataMan Control Commands Documentation 3.5<br />

Action Commands<br />

Extended<br />

Response Description<br />

ON ||[0]ON\r\n Is the DataMatrix<br />

symbology enabled?<br />

no response ||[0]\r\n Enable the DataMatrix<br />

symbology.<br />

||[0]\r\n ||[1]<br />

decoded data or no-read<br />

response in base64\r\n<br />

Trigger Command<br />

Set/Get Command Arguments Range Meaning Description<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 2 of 24<br />

27.12.2010


DMCC Overview<br />

TRIGGER state [ON|OFF] enable/disable Software Trigger<br />

TRAIN.CODE state [ON|OFF] enable/disable Train symbology using<br />

next sucessful decode.<br />

TRAIN.BRIGHT type<br />

[ON|OFF] ON: Start Train<br />

Brightness<br />

Algorithm<br />

OFF: Abort Train<br />

Brightness<br />

Algorithm<br />

Generate a fixed value<br />

for the exposure<br />

setting based on the<br />

particular scene,<br />

similar to the Optimize<br />

Brightness button in<br />

the Setup Tool.<br />

TRAIN.FOCUS state [ON|OFF] enable/disable Optimize lens focus<br />

DM<strong>200</strong> series only<br />

TRAIN.MATCH-STRING Triggers the reader<br />

and sets the match<br />

string valid to the<br />

value of the decoded<br />

string. Match String<br />

validation must be<br />

enabled for this<br />

command to work.<br />

INPUT.VIRTUAL line<br />

state<br />

[0-7]<br />

[ON|OFF]<br />

enable/disable<br />

Software Virtual Input<br />

Trigger is equivalent to<br />

line 0.<br />

CONFIG.DEFAULT Resets the deviceâ€s<br />

configuration settings<br />

to factory defaults.<br />

Device identification<br />

and communications<br />

settings are not<br />

changed.<br />

DEVICE.DEFAULT Resets all device<br />

settings to factory<br />

defaults. This<br />

command reboots the<br />

device.<br />

CONFIG.SAVE Save Configuration to<br />

Non-Volatile Memory<br />

CONFIG.RESTORE Restore Configuration<br />

from Non-Volatile<br />

Memory<br />

REBOOT Reboot the Device<br />

Rebooting the Device<br />

restores the<br />

Configuration stored in<br />

Non-Volatile Memory.<br />

Commands will not be<br />

processed for several<br />

seconds while the<br />

device reboots. If<br />

communication<br />

settings are changed,<br />

connection with device<br />

may be lost.<br />

Note that when<br />

connected via USB-<br />

COM, the application<br />

must release the COM<br />

port.<br />

BEEP repetition<br />

level<br />

[0-3]<br />

[0-2]<br />

Page 3 of 24<br />

Command audio beep<br />

GET RESULT Send Last Result. By<br />

default the the result<br />

string is in ASCII<br />

format, but this can be<br />

changed to Base64<br />

with the<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

System Commands<br />

DATA.RESULT-<br />

ENCODING command.<br />

STATISTICS.RESET Reset all statistics.<br />

OUTPUT.GOOD Virtual Good-Read<br />

Device beeps, flashes<br />

indicator lights, and<br />

sets output lines as if<br />

the specified read<br />

event occurred.<br />

OUTPUT.NOREAD Virtual No-Read<br />

Device beeps, flashes<br />

indicator lights, and<br />

sets output lines as if<br />

the specified no-read<br />

event occurred.<br />

OUTPUT.DATAVALID-<br />

FAIL<br />

Virtual Data Validation<br />

Failure<br />

Device beeps, flashes<br />

indicator lights, and<br />

sets output lines as if<br />

the specified Data<br />

Validation failure event<br />

occurred.<br />

OUTPUT.CQ-FAIL Virtual Code Quality<br />

Failure<br />

Device beeps, flashes<br />

indicator lights, and<br />

sets output lines as if<br />

the specified Code<br />

Quality failure event<br />

occurred.<br />

UNTRAIN.MODEL type<br />

index<br />

DataMan Control Commands Documentation 3.5<br />

[0-4]<br />

0<br />

0: All<br />

1: Data Matrix<br />

2: QR Code<br />

3:<br />

1D/Stacked/Postal<br />

4: Vericode<br />

Deletes the specified<br />

model.<br />

Set/Get Command Arguments Range Meaning Description<br />

GET DEVICE.TYPE Device Type<br />

GET DEVICE.SERIAL-NUMBER Device Serial Number<br />

GET DEVICE.FIRMWARE-VER Device Firmware Version<br />

GET DEVICE.FEATURE-KEYS Device Feature Keys<br />

SET|GET DEVICE.NAME Device Name<br />

SET|GET POWER.SLEEPTIME secs [0, 60,<br />

120...<br />

600]<br />

seconds Time before entering<br />

power-save mode<br />

DM7550 Series only<br />

SET|GET POWER.SLEEP state [ON|OFF] enable/disable Power Save Mode<br />

Enable<br />

DM7550 Series only<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 4 of 24<br />

27.12.2010


DMCC Overview<br />

SET|GET PRESENT.NEVER2X state [ON|OFF] enable/disable Never Read the Same<br />

Code Twice<br />

Presentation mode only.<br />

SET|GET PRESENT.REREAD ms [0-<br />

10000]<br />

SET|GET PRESENT.RESCAN ms [0-<br />

10000]<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

Camera & Light Commands<br />

milliseconds Presentation Mode Reread<br />

Delay<br />

milliseconds Presentation Mode<br />

Rescan Delay<br />

GET BATTERY.CHARGE Current battery charge<br />

SET|GET VIBRATION state [ON|OFF] enable/disable Enable vibration<br />

DM750 series only.<br />

SET|GET LIGHT.DIRECT state [ON|OFF] enable/disable Direct bright field<br />

DM75x0 series only.<br />

SET|GET COM.BUFFER-DATA state [ON|OFF] enable/disable Offline buffering<br />

DM7550 series only.<br />

DataMan Control Commands Documentation 3.5<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET TRIGGER.TYPE type<br />

[0-5]<br />

0: Single<br />

(external)<br />

1:<br />

Presentation<br />

(internal)<br />

2: Manual<br />

(button)<br />

3: Burst<br />

(external)<br />

4: Self<br />

(internal)<br />

5: Continuous<br />

(external)<br />

Trigger Type<br />

DM7500 Series and<br />

DM700 Series support<br />

only Presentation and<br />

Manual trigger types<br />

SET|GET TRIGGER.DELAY milliseconds [0-10000] Trigger Delay<br />

Delay camera<br />

acquisition by specified<br />

number of<br />

milliseconds.<br />

SET|GET CAMERA.INTERVAL ms [17-1000] milliseconds Acquisition Interval<br />

Time Between<br />

Successive Camera<br />

Acquisitions. Only<br />

supported with Burst<br />

and Self trigger types.<br />

SET|GET CAMERA.EXPOSURE type<br />

target<br />

exposure<br />

[ON|OFF]<br />

[0-255]<br />

[0-22]<br />

ON:<br />

Automatic<br />

OFF: Manual<br />

target pixel<br />

value<br />

0: 1/10000<br />

1: 1/7500<br />

2: 1/5000<br />

3: 1/4000<br />

4: 1/3000<br />

5: 1/2500<br />

6: 1/<strong>200</strong>0<br />

7: 1/1500<br />

Camera Parameters<br />

<strong>DM100</strong>, DM<strong>200</strong> and<br />

DM700 series only.<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 5 of 24<br />

27.12.2010


DMCC Overview<br />

gain<br />

SET|GET CAMERA.EXPOSURE auto<br />

SET|GET CAMERA.BURST-<br />

LENGTH<br />

target<br />

exposure<br />

gain<br />

[4-60]<br />

[ON|OFF]<br />

[0-255]<br />

[0-20]<br />

[1-19]<br />

8: 1/1250<br />

9: 1/1000<br />

10: 1/750<br />

11: 1/500<br />

12: 1/300<br />

13: 1/250<br />

14: 1/<strong>200</strong><br />

15: 1/150<br />

16: 1/125<br />

17: 1/100<br />

18: 1/75<br />

19: 1/50<br />

20: 1/40<br />

21: 1/30000<br />

22: 1/15000<br />

camera gain<br />

ON:<br />

Automatic<br />

OFF: Manual<br />

target pixel<br />

value<br />

0: 1/<strong>200</strong>00<br />

1: 1/10000<br />

2: 1/7500<br />

3: 1/5000<br />

4: 1/3000<br />

5: 1/2500<br />

6: 1/<strong>200</strong>0<br />

7: 1/1500<br />

8: 1/1250<br />

9: 1/1000<br />

10: 1/750<br />

11: 1/500<br />

12: 1/300<br />

13: 1/250<br />

14: 1/<strong>200</strong><br />

15: 1/150<br />

16: 1/125<br />

17: 1/100<br />

18: 1/75<br />

19: 1/50<br />

20: 1/40<br />

camera gain<br />

count [2-*] numberimages<br />

Camera Parameters<br />

DM7500 series only.<br />

Burst Length<br />

Number of Acquired<br />

Images in Burst<br />

Trigger-Mode.<br />

Default maximum<br />

values:<br />

* <strong>DM100</strong> max images:<br />

16<br />

* DM<strong>200</strong> max images:<br />

39<br />

Actual maximum can<br />

be increased by<br />

reducing the camera<br />

field of view or<br />

reserving fewer images<br />

for process monitor.<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

SET|GET FOCUS.VALUE value [25-56] Focus value Focus value<br />

DM<strong>200</strong> series only<br />

SET|GET FOCUS.MODE type<br />

[0-1] 0: High<br />

Latency<br />

Triggering<br />

1: Low<br />

Latency<br />

Triggering<br />

DM<strong>200</strong> series only<br />

SET|GET SETUP.PROG-TARGET number Setup Programming<br />

Target<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 6 of 24<br />

27.12.2010


DMCC Overview<br />

Setup to be modified<br />

by subsequent<br />

commands.<br />

DM7500 Series only.<br />

SET|GET SETUP.ENABLE state [ON|OFF] enable/disable Setup Enable<br />

One Setup must always<br />

be enabled. Enable the<br />

desired Setup, before<br />

disabiling another<br />

Setup. DM7500 Series<br />

only.<br />

SET|GET SETUP.NAME name Setup Name<br />

User defined name.<br />

DM7500 Series only.<br />

SET|GET LIGHT.AIMER aimer-mode<br />

SET|GET LIGHT.DIRECT mode<br />

SET|GET LIGHT.DIRECT-<br />

INTENSITY<br />

[0-2]<br />

[0-2]<br />

0: Off<br />

1: LED<br />

2: Laser<br />

0: Off<br />

1: Internal<br />

2: External<br />

Aimer Enable<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only<br />

Direct Illumination<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

level [1-13] Intensity Direct Illumination<br />

Intensity<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

SET|GET LIGHT.DIFFUSE state [ON|OFF] enable/disable Diffuse Brightfield<br />

Illumination Enable<br />

DM7500 Series only.<br />

SET|GET LIGHT.DIFFUSE-<br />

INTENSITY<br />

SET|GET LIGHT.DARKFIELD north<br />

east<br />

south<br />

west<br />

SET|GET LIGHT.DARKFIELD-<br />

INTENSITY<br />

SET|GET LIGHT.EXTERNAL-<br />

PRECHARGE-TIME<br />

SET|GET LIGHT.EXTERNAL-<br />

POLARITY<br />

SET|GET CAMERA.BURST-<br />

LENGTH-EXPAND<br />

level [1-12] Intensity Diffuse Brightfield<br />

Illumination Intensity<br />

DM7500 Series only.<br />

north<br />

east<br />

south<br />

west<br />

[ON|OFF]<br />

[ON|OFF]<br />

[ON|OFF]<br />

[ON|OFF]<br />

[1-12]<br />

[1-12]<br />

[1-12]<br />

[1-12]<br />

enable/disable<br />

enable/disable<br />

enable/disable<br />

enable/disable<br />

Intensity<br />

Intensity<br />

Intensity<br />

Intensity<br />

Darkfield Illumination<br />

Quadrants<br />

DM7500 Series only.<br />

Darkfield Illumination<br />

Intensity<br />

DM7500 Series only.<br />

time [1-980] microseconds External light<br />

precharge time.<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only.<br />

polarity<br />

SET|GET CAMERA.FOV left (multiple<br />

of 8)<br />

right (multiple<br />

of 8)<br />

top (multiple<br />

of 4)<br />

bottom<br />

(multiple of 4)<br />

[0-1] 0: active open<br />

1: active<br />

closed<br />

External illlumination<br />

output polarity.<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only.<br />

state [ON|OFF] enable/disable Reserve process<br />

monitor buffers for use<br />

by a burst trigger.<br />

Once enabled, you can<br />

increase the BURST-<br />

LENGTH value.<br />

[0...]<br />

[left+64...]<br />

[0...]<br />

[top+64...]<br />

pixels from<br />

left<br />

pixels from<br />

left<br />

pixels from<br />

top<br />

pixels from<br />

top<br />

Page 7 of 24<br />

The camera field of<br />

view is the area of the<br />

camera used for image<br />

acquisition.<br />

SET|GET CAMERA.FOV-ENABLED state [ON|OFF] enable/disable Indicates whether the<br />

full FoV or a custom<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

DataMan Control Commands Documentation 3.5<br />

Decoder Commands<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

Symbology Commands<br />

FoV will be used for<br />

image acquisition.<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET DECODER.1D-LEARN-<br />

ORIENT<br />

SET|GET DECODER.ROI left (multiple<br />

of 8)<br />

right (multiple<br />

of 8)<br />

top (multiple<br />

of 4)<br />

bottom<br />

(multiple of 4)<br />

state [ON|OFF] enable/disable Learn Orientation of 1D<br />

Symbols<br />

[0...]<br />

[left+64...]<br />

[0...]<br />

[top+64...]<br />

pixels from<br />

left<br />

pixels from<br />

left<br />

pixels from<br />

top<br />

pixels from<br />

top<br />

SET|GET DECODE-ATTEMPTS number [0-6] Number of<br />

decode<br />

attempts per<br />

setup.<br />

SET|GET TRIGGER.THRESHOLD option<br />

SET|GET TRIGGER.POLARITY option<br />

DataMan Control Commands Documentation 3.5<br />

[0-8]<br />

0: 0.1 ms<br />

1: 0.25 ms<br />

2: 0.5 ms<br />

3: 1 ms<br />

4: 2.5 ms<br />

5: 5 ms<br />

6: 10 ms<br />

7: 25 ms<br />

8: 50 ms<br />

[0-1] 0: Rising edge<br />

1: Falling<br />

edge<br />

Decoder Region of<br />

Interest<br />

Image Region<br />

examined by decoder<br />

for enabled symbols.<br />

Pixel coordinates are<br />

relative to the upper<br />

left corner of the<br />

displayed image. Left <<br />

Right and Top <<br />

Bottom.<br />

Values must be outside<br />

the specified<br />

CAMERA.FOV settings<br />

Number of Decode<br />

Attempts<br />

DM7500 Series only.<br />

The reader uses all<br />

enabled setups unless<br />

a decode operation is<br />

successful.<br />

The debounce<br />

threshold used by the<br />

debounce algorithm.<br />

The polarity at which<br />

an input trigger will be<br />

initiated<br />

Set/Get Command Arguments Range Meaning Description<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 8 of 24<br />

27.12.2010


DMCC Overview<br />

SET|GET 2D.ALGORITHM algorithm<br />

[0-1] 0: ID Max ©<br />

1: ID Quick<br />

ID Quick or ID<br />

Max©<br />

SET|GET SYMBOL.DATAMATRIX state [ON|OFF] enable/disable Enable DataMatrix<br />

Symbology<br />

SET|GET DATAMATRIX.ALGORITHM-<br />

VERSION<br />

version<br />

SET|GET DATAMATRIX.USAGE usage-type<br />

SET|GET DATAMATRIX.EXTREME-<br />

PRINT-GROWTH<br />

[0-1] 0: speed<br />

preferred<br />

1: yield preferred<br />

[0-1] 0: Default<br />

1: High speed ink<br />

jet mode<br />

ID Quick usage<br />

type.<br />

DataMatrix Usage<br />

Type<br />

state [ON|OFF] enable/disable Enable extreme<br />

print growth for<br />

DataMatrix<br />

symbols<br />

SET|GET SYMBOL.QR state [ON|OFF] enable/disable Enable QR-Code<br />

Symbology<br />

SET|GET QR.MODEL1 state [ON|OFF] enable/disable QR model-1<br />

SET|GET QR.MODEL2 state [ON|OFF] enable/disable QR model-2<br />

SET|GET QR.MICRO state [ON|OFF] enable/disable Micro QR Code<br />

SET|GET SYMBOL.C128 state [ON|OFF] enable/disable Enable Code 128<br />

Symbology<br />

SET|GET C128.CODESIZE any<br />

min<br />

max<br />

[ON|OFF]<br />

[1-max]<br />

[min-80]<br />

any length code<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

Code 128 Allowed<br />

Size<br />

SET|GET SYMBOL.UPC-EAN state [ON|OFF] enable/disable Enable UPC/EAN<br />

Symbology<br />

SET|GET UPC-EAN.EXPANDED state [ON|OFF] enable/disable UPC/EAN<br />

Expanded<br />

SET|GET UPC-EAN.SUPPLEMENT option<br />

[0-4]<br />

0: Ignore<br />

1: Required<br />

2: Required 2<br />

digit<br />

3: Required 5<br />

digit<br />

4: Not required<br />

UPC/EAN<br />

Supplementals<br />

SET|GET UPC-EAN.DELZERO state [ON|OFF] enable/disable UPC/EAN Delete<br />

Leading Zero<br />

SET|GET UPC-EAN.EAN8SUPL state [ON|OFF] enable/disable UPC/EAN Allow<br />

EAN8<br />

Supplementals<br />

SET|GET UPC-EAN.UPCE1 state [ON|OFF] enable/disable UPC/EAN UPCE1<br />

Enabled<br />

SET|GET SYMBOL.C39 state [ON|OFF] enable/disable Enable Code 39<br />

Symbology<br />

SET|GET C39.CHKCHAR state [ON|OFF] enable/disable Code 39 Check<br />

Character<br />

SET|GET C39.XMTCHK state [ON|OFF] enable/disable Code 39 Transmit<br />

Check Character<br />

SET|GET C39.ASCII state [ON|OFF] enable/disable Code 39 Full ASCII<br />

SET|GET C39.CODESIZE any<br />

min<br />

max<br />

[ON|OFF]<br />

[1-max]<br />

[min-80]<br />

any length code<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

Code 39 Code Size<br />

SET|GET SYMBOL.C93 state [ON|OFF] enable/disable Enable Code 93<br />

Symbology<br />

Page 9 of 24<br />

SET|GET C93.CODESIZE any [ON|OFF] any length code Code 93 Code Size<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

min<br />

max<br />

[1-max]<br />

[min-80]<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

SET|GET SYMBOL.I2O5 state [ON|OFF] enable/disable Enable Interleaved<br />

2 of 5 Symbology<br />

SET|GET I2O5.CHKCHAR state [ON|OFF] enable/disable I2of5 Check<br />

Character<br />

SET|GET I2O5.XMTCHK state [ON|OFF] enable/disable I2of5 Transmit<br />

Check Character<br />

SET|GET I2O5.CODESIZE any<br />

min<br />

max<br />

[ON|OFF]<br />

[2-max]<br />

[min-80]<br />

any length code<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

I2of5 Code Size<br />

SET|GET SYMBOL.CODABAR state [ON|OFF] enable/disable Enable Codabar<br />

Symbology<br />

SET|GET CODABAR.CHKCHAR state [ON|OFF] enable/disable Codabar Check<br />

Character<br />

SET|GET CODABAR.XMTCHK state [ON|OFF] enable/disable Codabar Transmit<br />

Check Character<br />

SET|GET CODABAR.CODESIZE any<br />

min<br />

max<br />

[ON|OFF]<br />

[1-max]<br />

[min-80]<br />

any length code<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

Codabar Code Size<br />

SET|GET SYMBOL.EAN-UCC state [ON|OFF] enable/disable Enable EAN-UCC<br />

Symbology<br />

SET|GET EAN-UCC.XMTMODE mode<br />

[0-1] 0: Standard<br />

(linear & 2D)<br />

1: Linear only<br />

EAN-UCC Transmit<br />

mode<br />

SET|GET EAN-UCC.CC-C state [ON|OFF] enable/disable Enable or disable<br />

Composite Code C<br />

SET|GET SYMBOL.PHARMACODE state [ON|OFF] enable/disable Enable<br />

Pharamcode<br />

Symbology<br />

SET|GET PHARMA.CODESIZE any<br />

min<br />

max<br />

[ON|OFF]<br />

[1-6]<br />

[1-6]<br />

any length code<br />

minimum code<br />

length<br />

maximum code<br />

length<br />

Expected<br />

Pharmacode size<br />

SET|GET DECODER.1D-TARGET state [ON|OFF] enable/disable Enable target<br />

decoding, where<br />

the reader<br />

attempts to<br />

decode 1D<br />

barcode symbols<br />

that lie only under<br />

the aiming dots.<br />

SET|GET DECODER.1D-USAGE usage<br />

SET|GET DECODER.1D-BIAXIAL-<br />

SEARCH<br />

SET|GET DECODER.1D-SHORT-<br />

QUIET-ZONE<br />

[0-1] 0: Standard<br />

1: Extended<br />

1D Symbology<br />

Usage Type<br />

Page 10 of 24<br />

state [ON|OFF] enable/disable Allow 1D decoding<br />

in 90 degree<br />

offsets to the<br />

trained position.<br />

state [ON|OFF] enable/disable When ON, the<br />

reader is tolerant<br />

with non-standard<br />

(i.e. short) quiet<br />

zones. OFF by<br />

default.<br />

SET|GET SYMBOL.PDF417 state [ON|OFF] enable/disable Enable PDF 417<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

Symbology<br />

SET|GET SYMBOL.MICROPDF417 state [ON|OFF] enable/disable Enable Micro-PDF<br />

417 Symbology<br />

SET|GET SYMBOL.DATABAR state [ON|OFF] enable/disable Enable Databar<br />

SET|GET DATABAR.LIMITED state [ON|OFF] enable/disable Enable DataBar<br />

limited<br />

SET|GET DATABAR.GROUP state [ON|OFF] enable/disable Enable DataBar<br />

group<br />

SET|GET DATABAR.EXPANDED state [ON|OFF] enable/disable Enable Databar<br />

expanded<br />

SET|GET SYMBOL.POSTNET state [ON|OFF] enable/disable Enable POSTNET<br />

Symbology<br />

SET|GET PLANET.XMTCHK state [ON|OFF] enable/disable PLANET Transmit<br />

Check Character<br />

SET|GET SYMBOL.PLANET state [ON|OFF] enable/disable Enable PLANET<br />

Symbology<br />

SET|GET POSTNET.XMTCHK state [ON|OFF] enable/disable POSTNET Transmit<br />

Check Character<br />

SET|GET SYMBOL.4STATE-JAP state [ON|OFF] enable/disable Enable 4-State<br />

Japan Post<br />

Symbology<br />

SET|GET SYMBOL.4STATE-AUS state [ON|OFF] enable/disable Enable 4-State<br />

Australia Post<br />

Symbology<br />

SET|GET SYMBOL.4STATE-UPU state [ON|OFF] enable/disable Enable 4-State<br />

UPU Symbology<br />

SET|GET SYMBOL.4STATE-IMB state [ON|OFF] enable/disable Enable 4-State<br />

Intelligent Mail<br />

Barcode<br />

SET|GET SYMBOL.VERICODE state [ON|OFF] enable/disable Enable Vericode<br />

® symbology<br />

SET|GET PHARMA.CODE-<br />

ORIENTATION<br />

SET|GET PHARMA.HORIZONTAL-<br />

DIRECTION<br />

SET|GET PHARMA.VERTICAL-<br />

DIRECTION<br />

direction<br />

direction<br />

direction<br />

[0-2]<br />

0: Any (default)<br />

1: Horizontal<br />

2: Vertical<br />

[0-1] 0: left-to-right<br />

(default)<br />

1: right-to-left<br />

[0-1] 0: top-to-bottom<br />

(default)<br />

1: bottom-to-top<br />

Preferred<br />

orientation for<br />

decoding<br />

Pharmacode<br />

symbols.<br />

Horizontal<br />

direction<br />

preference for<br />

decoding<br />

Pharmacode<br />

symbols<br />

Vertical direction<br />

preference for<br />

decoding<br />

Pharmacode<br />

symbols<br />

SET|GET MULTICODE.NUM-CODES number [1-128] Number of codes<br />

readers must find<br />

for a successful<br />

read result.<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

SET|GET MULTICODE.PARTIAL-<br />

RESULTS<br />

Page 11 of 24<br />

state [ON|OFF] enable/disable Controls how the<br />

reader interprets<br />

the number of<br />

codes to find. ON<br />

= reader will<br />

return a successful<br />

read if 1 or more<br />

codes are found.<br />

OFF = reader will<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET MULTICODE.IDENTICAL-<br />

SYMBOLS<br />

SET|GET MULTICODE.MAX-NUM-<br />

CODES<br />

SET|GET MULTICODE.SORT-<br />

PRIORITY<br />

SET|GET MULTICODE.HORIZONTAL-<br />

REVERSE<br />

SET|GET MULTICODE.IMAGE-<br />

REVERSE<br />

SET|GET MULTICODE.SYMBOLOGY-<br />

REVERSE<br />

SET|GET MULTICODE.VERTICAL-<br />

REVERSE<br />

Technology Preview<br />

return a successful<br />

read only if<br />

number of codes<br />

found equals<br />

MULTICODE.NUM-<br />

CODES value<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

state [ON|OFF] enable/disable Enables/disables<br />

output of identical<br />

symbols when<br />

multicode is<br />

enabled.<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

symbology<br />

number<br />

symbology<br />

image<br />

vertical<br />

position<br />

horizontal<br />

position<br />

state<br />

state<br />

state<br />

state<br />

[0-4]<br />

[1-128]<br />

[0-3]<br />

[0-3]<br />

[0-3]<br />

[0-3]<br />

0: Total for all<br />

symbologies<br />

1: Data Matrix<br />

2: QR Code<br />

3:<br />

1D/Stacked/Postal<br />

4: Vericode<br />

Range for all four<br />

arguments<br />

indicates sort<br />

priority. Must be<br />

different for each<br />

criteria.<br />

[ON|OFF] ON: sort right to<br />

left<br />

OFF: sort left to<br />

right<br />

[ON|OFF] ON: sort last<br />

image first<br />

OFF: sort first<br />

image first<br />

[ON|OFF] ON: Vericode, 1D,<br />

QR Code, Data<br />

Matrix<br />

OFF: Data Matrix,<br />

QR Code, 1D,<br />

Vericode<br />

[ON|OFF] ON: sort bottom<br />

to top<br />

OFF: sort top to<br />

bottom<br />

Page 12 of 24<br />

The expected<br />

maximum number<br />

of codes to find for<br />

each symbology<br />

grouping 1 - 4; no<br />

expected value for<br />

any single<br />

symbology can<br />

exceed parameter<br />

0, the total<br />

number of codes<br />

to find<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

Sorting order for<br />

multicode results.<br />

Horizontal<br />

positional sorting<br />

order priority.<br />

Image sorting<br />

order preference.<br />

Symbology sorting<br />

order preference.<br />

Vertical position<br />

sorting order<br />

preference.<br />

SET|GET TRAIN.INCREMENTAL state [ON|OFF] enable/disable Indicates whether<br />

incremental<br />

training is used<br />

during the next<br />

attempt to train.<br />

SET|GET TRAIN.AUTO-DISABLE state [ON|OFF] enable/disable Indicates whether<br />

untrained<br />

symbology groups<br />

will be disabled<br />

after the next<br />

attempt to train.<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

DataMan Control Commands Documentation 3.5<br />

Data Formatting Commands<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET FORMAT.PROG-TARG category<br />

[0-3]<br />

0: Universal<br />

1: Data Matrix<br />

2: QR Code<br />

3:<br />

1D/Stacked/Postal<br />

Data Formatting<br />

Programming Target<br />

Data Formatting<br />

Symbology Set to be<br />

modified by<br />

subsequent<br />

commands.<br />

SET|GET FORMAT.STANDARD state [ON|OFF] enable/disable Enable Data<br />

Formatting Standard<br />

Mode<br />

Standard Mode<br />

Formatting Enables:<br />

Leading Text, Data,<br />

Data Delimeter,<br />

Terminating Text,<br />

Terminating CRLF<br />

SET|GET FORMAT.TEXT-BEGIN string leading output<br />

text<br />

Data Formatting<br />

Leading Text<br />

Requires Data<br />

Formatting Standard<br />

Mode Enabled.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET FORMAT.TOKEN string token string Data Formatting<br />

Standard Data<br />

See Data Formatting<br />

Token Table for<br />

available elements.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET FORMAT.TEXT-END string trailing text Data Formatting<br />

Trailing Text<br />

Requires Data<br />

Formatting Standard<br />

Mode Enabled.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET FORMAT.CRLF-END state [ON|OFF] enable/disable Data Formatting CRLF<br />

Terminator<br />

Requires Data<br />

Formatting Standard<br />

Mode Enabled<br />

SET|GET FORMAT.DELIMITER delimiteroption<br />

[0-5]<br />

0: none<br />

1: space<br />

2: comma<br />

3: tab<br />

4: label<br />

5: xml<br />

Page 13 of 24<br />

Data Formatting<br />

Delimiter<br />

Sets the delimeter<br />

between Data<br />

Formatting Tokens.<br />

Requires Data<br />

Formatting Standard<br />

Mode Enabled.<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET FORMAT.MULTICODE-<br />

DELIMITER<br />

Data Formatting Tokens<br />

General Tokens<br />

type<br />

[0-5]<br />

0: none<br />

1: space<br />

2: comma<br />

3: tab<br />

4: label<br />

5: xml<br />

Data Formatting<br />

Delimiter<br />

Sets the delimiter<br />

between codes in a<br />

multicode result.<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only<br />

SET|GET FORMAT.ADVANCED state [ON|OFF] enable/disable Enable Data<br />

Formatting Advanced<br />

Mode<br />

Advanced Mode<br />

Formatting Enables:<br />

Regexp Pattern<br />

Substitution<br />

SET|GET FORMAT.REGEXP string regular expression<br />

string<br />

SET|GET FORMAT.DISCARD-<br />

UNMATCHED<br />

Data Formatting<br />

Regular Expression<br />

Requires Data<br />

Formatting Advanced<br />

Mode Enabled.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

state [ON|OFF] enable/disable Data Formatting<br />

Discard Unmatched<br />

Data<br />

SET|GET DVALID.GS1-FORMAT string GS1 format string Set GS1 format string<br />

Token Description<br />

Sub-string<br />

Full String<br />

Decode Time<br />

Trigger Time<br />

Symbology<br />

Symbology Identifier<br />

Code Position<br />

CR/LF<br />

TAB<br />

SP<br />

Module Size<br />

Contrast<br />

Unused Error Correction<br />

Code Orientation<br />

Total Reads<br />

Total No-Reads<br />

Total Triggers<br />

Missed Triggers<br />

Trigger Index<br />

Consecutive Bad Reads<br />

Custom Event Count 0<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 14 of 24<br />

27.12.2010


DMCC Overview<br />

Validation Tokens<br />

Token Description<br />

Enterprise Identifier<br />

Serial Number<br />

Part Number<br />

Unique Item Identifier<br />

Global Trade Item Number<br />

GTIN of Contained Trade Items<br />

Batch or Lot Number<br />

Expiration Date<br />

Serial Number<br />

Count of Trade Items<br />

Code Quality Tokens<br />

Token Description<br />

Angle Test<br />

Distortion Test<br />

Position Test<br />

Symbol Grade (AIM-DPM)<br />

Minimum Reflectance AIM-DPM Metric<br />

Minimum Reflectance AIM-DPM Grade<br />

Modulation AIM-DPM<br />

Fixed Pattern Damage AIM-DPM<br />

Cell Contrast AIM-DPM Metric<br />

Cell Contrast AIM-DPM Grade<br />

Axial Nonuniformity AIM-DPM Metric<br />

Axial Nonuniformity AIM-DPM Grade<br />

Unused Error Correction AIM-DPM Metric<br />

Unused Error Correction AIM-DPM Grade<br />

Grid Nonuniformity AIM-DPM Metric<br />

Grid Nonuniformity AIM-DPM Grade<br />

Reference Decode AIM-DPM<br />

Print growth Vertical.<br />

Print growth Horizontal.<br />

Overall Print growth (Average of H&V)<br />

Modulation 15415<br />

Axial Non-Uniformity 15415 Metric<br />

Axial Non-Uniformity 15415 Grade<br />

Grid Non-Uniformity 15415 Metric<br />

Grid Non-Uniformity 15415 Grade<br />

Unused Error Correction 15415 Metric<br />

Unused Error Correction 15415 Grade<br />

Reference Decode 15415<br />

Fixed Pattern Damage 15415<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 15 of 24<br />

27.12.2010


DMCC Overview<br />

Symbol Contrast 15415 Metric<br />

Symbol Contrast 15415 Grade<br />

Symbol Grade 15415<br />

Extreme Reflectance<br />

Symbol Grade AS9132-LE<br />

Cell Contrast AS9132-LE Metric<br />

Cell Contrast AS9132-LE Grade<br />

Cell Fill Horizontal AS9132-LE Metric<br />

Cell Fill Horizontal AS9132-LE Grade<br />

Cell Fill Vertical AS9132-LE Metric<br />

Cell Fill Vertical AS9132-LE Grade<br />

Distortion Angle AS9132 Metric<br />

Distortion Angle AS9132 Grade<br />

Symbol Grade AS9132-DP<br />

Size and Ovality Failure AS9132-DP Metric<br />

Size and Ovality Failure AS9132-DP Grade<br />

Position Failure AS9132-DP Metric<br />

Position Failure AS9132-DP Grade<br />

Dark Field light angle<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

DataMan Control Commands Documentation 3.5<br />

Data Validation Commands<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET DVALID.PROG-TARG category<br />

SET|GET DVALID.TYPE type<br />

SET|GET DVALID.DODCNSTRT construct<br />

[1-3]<br />

[0-4]<br />

[0-2]<br />

1: DataMatrix<br />

2: QR Code<br />

3: Linear/<br />

Postal/<br />

Stacked<br />

0: None<br />

1: DoD UID<br />

2: ISO<br />

3: Pattern<br />

4: Match<br />

String<br />

5: GS1<br />

0: Any<br />

1: Construct<br />

#1<br />

2: Construct<br />

#2<br />

Data Validation<br />

Programming Target<br />

Data Validation<br />

Symbology Set to be<br />

modified by subsequent<br />

commands.<br />

Data Validation DoD<br />

Construct<br />

Page 16 of 24<br />

SET|GET DVALID.DOD-EXEID string expected-EID DoD Expected Enterprise<br />

ID (EID)<br />

SET|GET DVALID.DOD-EXPN string expected-PN DoD Expected Part<br />

Number<br />

See the Overview topic<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET DVALID.ISO-<br />

CONSTRUCT<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

Code Quality Commands<br />

construct<br />

[0-1] 0: ISO 15434<br />

1: ISO 15434<br />

& ISO 15418<br />

for formatting<br />

requirements for the<br />

string argument.<br />

ISO Construct<br />

SET|GET DVALID.MATCH-STRING string match-string Data Validation Match-<br />

String<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET DVALID.MATCH-STRING-<br />

PARAMS<br />

increment<br />

start<br />

length<br />

step<br />

no-read<br />

validation-fail<br />

[ON|OFF]<br />

[0-*]<br />

[1-*]<br />

[-2|-<br />

1|0|1|2]<br />

[ON|OFF]<br />

[ON|OFF]<br />

enable/disable<br />

start position<br />

of numerical<br />

match<br />

number of<br />

digits<br />

increment<br />

enable/disable<br />

update on noread<br />

enable/disable<br />

update on<br />

validation<br />

failure<br />

Data Validation Match-<br />

String Paramters<br />

SET|GET DVALID.PATTERN string pattern-string Data Validation Pattern<br />

Regexp Data Validation.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET DVALID.FAIL-ACTION action<br />

[0-3]<br />

0: Transmit<br />

"Validation<br />

Failure"<br />

1: Transmit<br />

"Validation<br />

Failure" +<br />

decoded<br />

string<br />

2: Transmit<br />

annotated<br />

decode string<br />

3: Transmit<br />

nothing<br />

Data Validation Failure<br />

Action<br />

SET|GET DVALID.FAIL-XMT-CRLF state [ON|OFF] enable/disable Data Validation<br />

Transimit CRLF on<br />

Failure<br />

DataMan Control Commands Documentation 3.5<br />

Set/Get Command Arguments Range Meaning Description<br />

Page 17 of 24<br />

SET|GET CQ state [ON|OFF] enable/disable Enable Code Quality<br />

Code Quality<br />

Measurements require<br />

reader calibration and<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET CQ.METRICS metric<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

I/O Commands<br />

[0-3]<br />

0: AIM-DPM<br />

1: ISO/IEC<br />

15415<br />

2: AS9132<br />

Laser-etch<br />

3: AS9132<br />

Dot-peen<br />

the Verification Feature<br />

Key<br />

Code Quality Enabled<br />

Metrics<br />

SET|GET CQ.PROCESSM state [ON|OFF] enable/disable Code Quality Process<br />

Control Metrics<br />

SET|GET CQ.UNITS option<br />

[0-3]<br />

0: mils<br />

1: mm<br />

2: inches<br />

3: pixels<br />

Code Quality Units<br />

GET CQ.CALIB-DATE Device Code Quality<br />

Calibration Date<br />

SET|GET CQ.ILLUMINATION illuminationoption<br />

state<br />

SET|GET CQ.MINPASS metric<br />

DataMan Control Commands Documentation 3.5<br />

min-pass<br />

[0-4]<br />

[ON|OFF]<br />

[0-1]<br />

[0-4]<br />

0: Direct on<br />

axis<br />

1: 30-deg All<br />

Quadrants<br />

2: 30-deg E-<br />

W Quadrants<br />

3: 30-deg N-S<br />

Quadrants<br />

4: Custom<br />

enable/disable<br />

0: AIM-DPM<br />

1: ISO/IEC<br />

15415<br />

0: F<br />

1: D<br />

2: C<br />

3: B<br />

4: A<br />

Code Quality<br />

Illumination Option<br />

DM7500 Series does not<br />

support Direct-on-axis<br />

Code Quality<br />

illumination.<br />

Code Quality Minimum<br />

Passing Grade<br />

Determines the<br />

threshold for "validation<br />

failure action" including<br />

beep and configured line<br />

output.<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET DECODER.TIMEOUT ms [0-<br />

10000]<br />

SET|GET BEEP.GOOD repetition<br />

level<br />

SET|GET BEEP.NO-READ repetition<br />

level<br />

[0-3]<br />

[0-2]<br />

[0-3]<br />

[0-2]<br />

milliseconds Decoder Timeout<br />

Maximum allowed<br />

decode time.<br />

<strong>DM100</strong> series and<br />

DM<strong>200</strong> series only.<br />

number of<br />

beeps<br />

0: Lo pitch<br />

1: Med pitch<br />

2: Hi pitch<br />

number of<br />

beeps<br />

0: Lo pitch<br />

1: Med pitch<br />

2: Hi pitch<br />

Good Read Beep<br />

Settings<br />

Page 18 of 24<br />

No-Read Beep Settings<br />

SET|GET BEEP.DATAVALID-FAIL repetition [0-3] number of Data Validation Failure<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

Technology Preview<br />

level<br />

SET|GET BEEP.CQ-FAIL repetition<br />

level<br />

SET|GET RESULT.NO-READ-<br />

STRING<br />

SET|GET BUTTON.3SEC-ACTION mode<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

[0-2]<br />

[0-3]<br />

[0-2]<br />

beeps<br />

0: Lo pitch<br />

1: Med pitch<br />

2: Hi pitch<br />

number of<br />

beeps<br />

0: Lo pitch<br />

1: Med pitch<br />

2: Hi pitch<br />

Beep Settings<br />

DM7500 Series and<br />

DM700 Series only.<br />

Code Quality Failure<br />

Beep Settings<br />

DM7500 Series only.<br />

string no-read-string No-Read Output String<br />

state<br />

[0-2]<br />

[ON|OFF]<br />

0: Train<br />

1: Optimize<br />

Brighness<br />

2: Set Match<br />

String<br />

enable/disable<br />

Three Second Button<br />

Action<br />

SET|GET BUTTON.ENABLE state [ON|OFF] enable/disable Enables or disables the<br />

button on the <strong>DM100</strong>.<br />

SET|GET INPUT.ACTION1 mode<br />

state<br />

SET|GET IO.MODULE type<br />

SET|GET OUTPUT.RESERVED line<br />

reserved<br />

SET|GET OUTPUT.ACTION line<br />

action<br />

SET|GET OUTPUT.PULSE-WIDTH line<br />

ms<br />

SET|GET OUTPUT.EVENTS line<br />

read<br />

no-read<br />

validationfailure <br />

triggeroverrun <br />

bufferoverflow <br />

verificationfailure<br />

[0-2]<br />

[ON|OFF]<br />

0: Train<br />

1: Optimize<br />

Brighness<br />

2: Set Match<br />

String<br />

enable/disable<br />

[0-1] 0: basic<br />

1: extended<br />

[0-7]<br />

[ON|OFF]<br />

[0-7]<br />

[0-1]<br />

[0-7]<br />

[0-1000]<br />

[0-7]<br />

[0-1]<br />

[0-1]<br />

[0-1]<br />

[0-1]<br />

[0-1]<br />

[0-1]<br />

i/o line<br />

number<br />

enable/disable<br />

line number<br />

0: Open<br />

1: Close<br />

i/o line<br />

number<br />

milliseconds<br />

i/o line<br />

number<br />

0: Off<br />

1: On<br />

0: Off<br />

1: On<br />

0: Off<br />

1: On<br />

0: Off<br />

1: On<br />

0: Off<br />

1: On<br />

0: Off<br />

1: On<br />

Input Line 1 Action<br />

IO Module Type<br />

<strong>DM100</strong> Series only.<br />

Output Reserved for<br />

External Illumination.<br />

Line will be control by<br />

acquisition system when<br />

enabled.<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only.<br />

Output Action<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only. Open or<br />

Close output line on<br />

event. Only supported<br />

on line 1.<br />

Output Pulse-width<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only.<br />

Page 19 of 24<br />

Output Events<br />

Configure output line to<br />

signal based on event.<br />

<strong>DM100</strong> and DM<strong>200</strong><br />

series only.<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

DataMan Control Commands Documentation 3.5<br />

Communication Commands<br />

Set/Get Command Arguments Range Meaning Description<br />

SET|GET COM.USB-<br />

COMPATIBILITY-MODE<br />

legacy<br />

SET|GET COM.BAUD-RATE rate<br />

SET|GET COM.PARITY parity<br />

[ON|OFF] ON: use pre-<br />

3.5.0 driver<br />

OFF: default<br />

[0-5]<br />

[0-2]<br />

SET|GET COM.DATA-BITS bits [7,8]<br />

SET|GET COM.STOP-BITS bits [1-8]<br />

SET|GET COM.DMCC-RESPONSE mode<br />

SET|GET DATA.RESULT-<br />

ENCODING<br />

encoding<br />

0: 230400<br />

1: 115<strong>200</strong><br />

2: 57600<br />

3: 38400<br />

4: 19<strong>200</strong><br />

5: 9600<br />

0: None<br />

1: Even<br />

2: Odd<br />

[0|1] 0: Silent<br />

(default)<br />

1: Extended<br />

[0|1] 0: ASCII<br />

(default)<br />

1: Base64<br />

Controls USB driver.<br />

Reboot is required.<br />

<strong>DM100</strong> and DM700<br />

series only.<br />

DMCC response format<br />

Result string encoding.<br />

SET|GET COM.XLATEPRNT state [ON|OFF] enable/disable Translate unprintable<br />

characters that are<br />

embedded in a symbol.<br />

The translated result is<br />

output over the<br />

connection (e.g. COM,<br />

USB, Ethernet, USB-<br />

KEYBOARD). Note that<br />

Data Formatting leading<br />

and terminating text are<br />

not translated. The<br />

characters translated<br />

are ASCII values<br />

between 0x00 and 0x1F.<br />

For example, 0x00 =<br />

, 0x04 = ,<br />

0x0a = , 0x0d =<br />

.<br />

GET DEVICE.MAC-ADDRESS Reader's MAC address<br />

DM<strong>200</strong> series only<br />

SET|GET ETHERNET-IP.ENABLED state [ON|OFF] enable/disable Enabled or disabled<br />

EtherNet/IP<br />

communications.<br />

DM<strong>200</strong> series only<br />

SET|GET NET-LOCAL.IP-ADDRESS string Reader's IP address<br />

Uses dotted decimal<br />

form, such as<br />

"192.168.23.42"<br />

DM<strong>200</strong> series only<br />

SET|GET NET-LOCAL.SUBNET-<br />

MASK<br />

Page 20 of 24<br />

string Reader's subnet mask<br />

Uses dotted decimal<br />

form, such as<br />

"192.168.23.255"<br />

DM<strong>200</strong> series only<br />

SET|GET NET-LOCAL.DHCP state [ON|OFF] enable/disable Enable/Disable DHCP on<br />

reader<br />

DM<strong>200</strong> series only<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET NET-LOCAL.GATEWAY string Reader's default<br />

gateway IP address<br />

Uses dotted decimal<br />

form, such as<br />

"192.168.23.1"<br />

DM<strong>200</strong> series only<br />

SET|GET NET-LOCAL.PORT port [1-<br />

65535]<br />

Setup Tool server TCP<br />

port on reader.<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.ENABLE state [ON|OFF] enable/disable Enable/disable FTP<br />

transfer of reader<br />

images<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.IP-ADDRESS string IP address of target FTP<br />

server<br />

Uses dotted decimal<br />

form, such as<br />

"192.168.23.42"<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.USER-NAME string Username used to login<br />

to target FTP server<br />

DM<strong>200</strong> series only<br />

SET FTP-IMAGE.PASSWORD string Password used to login<br />

to target FTP server<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.CUSTOM-<br />

FILE-NAME<br />

SET|GET FTP-IMAGE.SERVER-<br />

PATH<br />

state [ON|OFF] enable/disable Enable/disable FTP<br />

server generated file<br />

name<br />

DM<strong>200</strong> series only<br />

string Path for FTP image<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.FILE-NAME string File name of FTP image<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-IMAGE.MAX-APPEND value [0-<br />

65535]<br />

SET|GET FTP-IMAGE.IMG-SEND mode<br />

[0-2]<br />

0: "No read"<br />

images<br />

1: "Read"<br />

images<br />

2: All images<br />

Max increment value to<br />

append to image name<br />

DM<strong>200</strong> series only<br />

Which images to FTP<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-RESULT.ENABLE state [ON|OFF] enable/disable Enable/disable FTP<br />

transfer of reader<br />

results<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-RESULT.IP-<br />

ADDRESS<br />

string IP address of target FTP<br />

server<br />

Uses dotted decimal<br />

form, such as<br />

"192.168.23.42"<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-RESULT.USER-NAME string Username used to login<br />

to target FTP server<br />

DM<strong>200</strong> series only<br />

SET FTP-RESULT.PASSWORD string Password used to login<br />

to target FTP server<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-RESULT.FILE-NAME string File name of FTP result<br />

DM<strong>200</strong> series only<br />

SET|GET FTP-RESULT.APPEND type<br />

[ON|OFF] ON: Append<br />

result to<br />

existing file.<br />

OFF:<br />

Overwrite file<br />

Page 21 of 24<br />

Append to or overwrite<br />

file when result is sent<br />

via FTP to the file<br />

specified by FTP-<br />

RESULT.FILE-NAME. The<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

SET|GET TELNET.PORT value [0-<br />

65535]<br />

Technology Preview<br />

DMCC Commands marked with are pre-release documentation. These functions are provided as is in DataMan<br />

Software version 3.5. Future releases may change syntax or remove functionality altogether.<br />

Cognex Corporation assumes no responsibility for the use or reliability of its software on equipment that is not<br />

supplied by Cognex Corporation. Cognex Corporation makes no warranties, either express or implied, regarding<br />

the described software, its merchantability or its fitness for any particular purpose.<br />

The information in this document is subject to change without notice and should not be construed as a<br />

commitment by Cognex Corporation. Cognex Corporation is not responsible for any errors that may be present<br />

in either this document or the associated software.<br />

Copyright © 2010 Cognex Corporation All Rights Reserved<br />

content with<br />

result.<br />

file will be created if it<br />

does not exist.<br />

DM<strong>200</strong> series only<br />

Telnet server TCP port<br />

on reader.<br />

DM<strong>200</strong> series only<br />

SET|GET CUSTOM-CMD.TRIGGER state [ON|OFF] enable/disable Indicates if reader will<br />

respond to the<br />

TRIGGER-ON or<br />

TRIGGER-OFF string.<br />

SET|GET CUSTOM-CMD.TRIGGER-<br />

ON<br />

SET|GET CUSTOM-CMD.TRIGGER-<br />

OFF<br />

string String that will start a<br />

trigger.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

string String that will stop a<br />

trigger.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET CUSTOM-CMD.ECHO state [ON|OFF] enable/disable Indicates if characters<br />

received between a<br />

COMMAND-HEADER and<br />

COMMAND-FOOTER are<br />

echoed.<br />

SET|GET CUSTOM-<br />

CMD.COMMAND-HEADER<br />

SET|GET CUSTOM-<br />

CMD.COMMAND-FOOTER<br />

string Start of the string to be<br />

echoed.<br />

string End of the string to be<br />

echoed.<br />

See the Overview topic<br />

for formatting<br />

requirements for the<br />

string argument.<br />

SET|GET INTER-MESSAGE.DELAY value [0-1000] milliseconds Transmission delay<br />

between buffered read<br />

strings.<br />

DM7550 Series only<br />

SET|GET COM.WAKEUP state [ON|OFF] enable/disable Wakeup Message<br />

SET|GET PROTOCOL mode<br />

DataMan Control Commands Documentation 3.5<br />

Copyright Information<br />

[0-1] 0: DMCC-only<br />

1: Legacy<br />

Mode<br />

Page 22 of 24<br />

This document may not be copied in whole or in part, nor transferred to any other media or language, without<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010


DMCC Overview<br />

the written permission of Cognex Corporation.<br />

The hardware and portions of the software described in this document may be covered by one or more of the<br />

U.S. patents listed on the Cognex web site http://www.cognex.com/patents.asp. Other U.S. and foreign patents<br />

are pending.<br />

DataMan Control Commands Documentation 3.5<br />

Licensed Software<br />

PCRE Licence<br />

PCRE is a library of functions to support regular expressions whose syntax and semantics are as close as possible<br />

to those of the Perl 5 language.<br />

Release 5 of PCRE is distributed under the terms of the "BSD" licence, as specified below. The documentation for<br />

PCRE, supplied in the "doc" directory, is distributed under the same terms as the software itself.<br />

Written by: Philip Hazel <br />

University of Cambridge Computing Service, Cambridge, England. Phone: +44 1223 334714.<br />

Copyright (c) 1997-<strong>200</strong>4 University of Cambridge All rights reserved.<br />

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the<br />

following conditions are met:<br />

� Redistributions of source code must retain the above copyright notice, this list of conditions and the<br />

following disclaimer.<br />

� Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the<br />

following disclaimer in the documentation and/or other materials provided with the distribution.<br />

� Neither the name of the University of Cambridge nor the names of its contributors may be used to<br />

endorse or promote products derived from this software without specific prior written permission.<br />

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS<br />

OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF<br />

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE<br />

COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,<br />

EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF<br />

SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)<br />

HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT<br />

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN<br />

IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE<br />

End<br />

JPEG software<br />

This software is based in part on the work of the Independent JPEG Group.<br />

zlib compression library<br />

This software is based in part on the work of Jean-loup Gailly and Mark Adler.<br />

Parsifal XML Parser<br />

Copyright (c) <strong>200</strong>2-<strong>200</strong>5 Toni Uusitalo released to the public domain <strong>200</strong>2-11-15<br />

http://www.saunalahti.fi/~samiuus/toni/xmlproc/<br />

Parsifal is free for both commercial and non-commercial use and redistribution, provided that author's copyright<br />

and disclaimer are retained intact. You are free to modify Parsifal for your own use and to redistribute Parsifal<br />

with your modifications, provided that the modifications are clearly documented.<br />

DISCLAIMER<br />

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the<br />

implied warranty of Merchantability or fitness for a particular purpose. Please use it AT YOUR OWN RISK.<br />

lwIP TCP/IP stack<br />

Copyright (c) <strong>200</strong>1-<strong>200</strong>4 Swedish Institute of Computer Science. All rights reserved.<br />

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the<br />

following conditions are met:<br />

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the<br />

following disclaimer.<br />

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the<br />

following disclaimer in the documentation and/or other materials provided with the distribution.<br />

3. The name of the author may not be used to endorse or promote products derived from this software<br />

without specific prior written permission.<br />

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

Page 23 of 24<br />

27.12.2010


DMCC Overview<br />

INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A<br />

PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,<br />

INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED<br />

TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS<br />

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT<br />

LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF<br />

THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.<br />

DataMan Control Commands Documentation 3.5<br />

Patent Information<br />

Page 24 of 24<br />

This product is covered by one or more of the below listed US patents, US applications, and/or foreign patents.<br />

http://www.cognex.com/patents will list any relevant subsequently issued patents.<br />

5742037, 5943441, 6215915, 6236769, 6282328, 6381375, 6408109, 6457032, 6690842, 6941026, 7175090,<br />

7181066, 7412106, 7427028, 7549582, 7604174, 7614563, 7617984, US-<strong>200</strong>5-0087601-A1, US-<strong>200</strong>6-<br />

0131418-A1, US-<strong>200</strong>6-0131419-A1, US-<strong>200</strong>6-0133757-A1, US-<strong>200</strong>7-0090193-A1, US-<strong>200</strong>7-0091332-A1, US-<br />

<strong>200</strong>7-0152064-A1, US-<strong>200</strong>7-0170259-A1, US-<strong>200</strong>8-0004822-A1, US-<strong>200</strong>8-0011855-A1, US-<strong>200</strong>8-0142604-A1,<br />

US-<strong>200</strong>8-0143838-A1, US-<strong>200</strong>8-0158365-A1, US-<strong>200</strong>9-0090781-A1, US-<strong>200</strong>9-0108073, US-<strong>200</strong>9-0121027-A1,<br />

US-<strong>200</strong>9-0166424-A1, US-<strong>200</strong>9-0294541-A1, WO06065619A1, and EP1687752<br />

file://C:\Dokumente und Einstellungen\schiermann\Lokale Einstellungen\Temp\~hh7...<br />

27.12.2010

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!