Microscan MS-4 User Manual

MS-4 Imag er

User’s Man ual

P/N 83-000004 Rev E

Copyright and Disclaimer

Microscan Systems, Inc.

1201 S.W. 7th Street
Renton, WA 98057
U.S.A.
Tel: [phone]
Fax: [phone]
[e-mail]

Microscan Europe

Tel: [phone]
Fax: [phone]

Microscan Asia Pacific R.O.

Tel: [phone]
Fax: [phone]

Copyright ©2008
by Microscan Systems, Inc.
1201 S.W . 7th Street, Renton, WA, U.S.A. 98057

[phone] FAX: [phone]

ISO 9001:2000 Certification No. 06-1080
Issued by TüV USA

All rights reserved. The information contained herein is proprietary and is provided solely for the purpose
of allowing customers to operate and/or service Microscan manufactured equipment and is not to be
released, reproduced, or used for any other purpose without written permission of Microscan.

Throughout this manual, trademarked names might be used. Rather than put a trademark (™) symbol in
every occurrence of a trademarked name, we state herein t hat we are using the names on ly in an editoria l
fashion, and to the benefit of the trademark owner, with no intenti on of infringement.

Disclaimer

The information and specifications described in this manual are subject to change without notice.

Latest Manual Version

For the latest version of this manual, see the Download Center on our web site at:

www.microscan.com. For technical support email: [e-mail]

ii MS-4 Imager User’s Manual

Introduction

Microscan Limited Warranty Statement and Exclusions

What Is Covered?

Microscan Systems Inc. warrants to the original purchaser that products manufactured by it will be free
from defects in material and workmanship und er normal us e and servi ce for a perio d of on e year from t he
date of shipment. This warra nty is specifically limited to, at Microscan’s sole option, repair or replacement
with a functionally equivalent unit and return without charge for service or return freight.

What Is Excluded?

This limited warranty specifically excludes the following: (1) Any products or parts that have been subject
to misuse, neglect, accident, unauthorized repair, improper installation, or abnormal conditions or opera­tions; (2) Any products or parts that have been transferred by the original purchaser; (3) Customer mis­adjustment of settings contrary to the proced ure described in the Micros can Systems Inc . owners manual;
(4) Upgrading software versions at customer re quest unless required to meet specificati ons in eff ect at the
time of purchase; (5) Units returned and found to have no failure will be excluded; (6) Claims for damage
in transit are to be directed to the freight carrier upon receipt . Any use of the product i s at purchaser’s own
risk. This limited warranty is t he o nly wa rra nty provi ded b y Micro scan Systems I nc. regard ing the produ ct.
Except for the limited warranty above, the product is provid ed “as is.” To the maximum extent permitted by
law , this express warranty excludes all other warranties, express or implied, including but not limited to,
implied warranties of merchantability and. Technical support questions may be directed to: help­[e-mail] Register your product with Microscan: www.microscan.com/register fitness for a
particular purpose. Microscan Systems Inc. does not warrant that the functions contained in the product
will meet any requirements or needs purchaser may have, or that the product wi ll operate error free, or in
an uninterrupted fashion, or that any def ects or errors in the prod uct will be corrected, or that the product i s
compatible with any particular machinery.

Limitation of Liability

In no event shall Microscan Systems Inc. be liable to you or any third party for any special, incidental, or
consequential damages (including, wit hout li mitat ion, indirect , special, punitive, or exemplary da mages for
loss of business, loss of profit s, business i nterruption, or l oss of business info rmation), whether in contract,
tort, or otherwise, even if Microscan Systems Inc. has been advised of the possibility of such damages.
Microscan Systems Inc.’s ag gregate liabili ty with respect to its obl igations under this wa rranty or otherwise
with respect to the product and documentation or otherwise shall not exceed the amount paid by you for
the product and documentation. Some jurisdictions do not allow the exclusion or limitation of incidental or
consequential damages or limitat ions o n an impl ied warranty, so the above limitation or exclusion may not
apply to you. This warranty gives you specific legal rights, and you may also have other rights which may
vary from state to state.

Tel: [phone] | Fax: [phone] | [e-mail]

MS-4 Imager User’s Manual iii

Table of Contents

Table of Contents

Chapter 1 Quick Start

Step 1 Check Required Hardware...........................................................1-2

Step 2 Connect the System.....................................................................1-3

Step 3 Position Imager and Symbol........................................................1-4

Step 4 Install ESP ...................................................................................1-5

Step 5 Select Model................................................................................1-6

Step 6 Select Communications Protocol.................................................1-7

Step 7 Locate the Symbol in the FOV.....................................................1-8

Step 8 Calibrate Settings.......................................................................1-10

Step 9 Test Read Rate..........................................................................1-11

Step 10 Configure the Imager in ESP...................................................1-12

Step 11 Make Menu Changes and Save in ESP................................... 1-13

Chapter 2 Using ESP

EZ Mode..................................................................................................2-2

Application Mode.....................................................................................2-3

Menu Toolbar ..........................................................................................2-4

Connecting .............................................. ............................... ... .. ......... 2-12

View........................................... ... ............................ ............................ 2-13

Navigating in ESP ........................................... ..................................... 2-14

Send/Receive Options.......................................................................... 2-15

Using EZ Trax .......................................................................................2-17

Chapter 3 Communications

Communications by ESP.........................................................................3-2

Communications Serial Commands........................................................3-3

Host Port Connections ....................................... .....................................3-4

Host Port Protocol .............................................. ... ..................................3-5

ACK/NAK Options...................................................................................3-7

Polling Mode Options..............................................................................3-8

RS-422 Status................... .. ... ............................... ... ... ............................3-9

Auxiliary Port Connections ............................................... ... ... ...............3-10

Auxiliary Port System Data Status ........................................................3-18

Daisy Chain Autoconfigure....................................................................3-19

Response Timeout................................................................................3-20

LRC Status............................................................................................3-21

Protocol Configuration Examples..........................................................3-22

USB HID Interface.......................................................................... ... ... .3-23

ASCII Character Entry Modifier.............................................................3-32

Preamble...............................................................................................3-33

Postamble .............................................................................................3-34

Chapter 4 Calibration

Calibration Serial Commands..................................................................4-2

iv MS-4 Imager User’s Manual

Calibration Overview ...............................................................................4-2

Calibration Options..................................................................................4-3

Calibration by ESP ................................................................................4-10

Initiating Calibration.............. .. ... ............................... ... ... .......................4-12

Additional Notes about Calibration ........................................................4-17

Chapter 5 Read Cycle

Read Cycle by ESP.................................................................................5-2

Read Cycle Serial Commands ................................................................5-3

Read Cycle Setup....................................................................................5-4

Multisymbol..............................................................................................5-5

Trigger Mode and Duration......................................................................5-6

External Trigger Polarity........................................................................5-11

Serial Trigger.................. ... ... .............................. ... ... .............................5-12

Start Trigger Character (Non-Delimited)................................................5-13

Stop Trigger Character (Non-Delimited)................................................5-13

End of Read Cycle.................................................................................5-14

Capture Mode........................................................... ............................ .5-16

Capture Timing..................................... ............................ .....................5-20

Image Processing Timeout....................................................................5-22

Image Storage.......................................................................................5-23

Minimum Good Reads...........................................................................5-25

Setting Up the Imager for EZ Trax.........................................................5-26

Introduction

Chapter 6 Symbologies

Symbologies by ESP...............................................................................6-2

Symbologies Serial Commands ..............................................................6-3

Data Matrix..............................................................................................6-4

QR Code................................................................... ............................ ...6-6

Code 39...................................................................................................6-7

Code 128 / EAN 128..............................................................................6-10

BC412....................................................................................................6-13

Interleaved 2 of 5...................................................................................6-14

Code 93.................................................................................................6-17

Codabar.................................................................................................6-18

UPC / EAN.............................................................................................6-21

GS1 DataBar (RSS) ................................... ...........................................6-25

PDF417 .................................................................................................6-27

MicroPDF417.........................................................................................6-29

Composite .............................................................................................6-30

Narrow Margins / Symbology Identifier..................................................6-31

Background Color..................................................................................6-33

Chapter 7 I/O Parameters

I/O Parameters by ESP...........................................................................7-2

I/O Parameters Serial Commands...........................................................7-3

Symbol Data Output................................................................................7-4

MS-4 Imager User’s Manual v

Table of Contents

No Read Message...................................................................................7-6

Bad Symbol Message .............................................................................7-8

No Symbol Message ...............................................................................7-8

1D / Stacked Symbology Qualification....................................................7-9

2D Symbology Qualification ..................................................................7-10

Read Duration Output ...........................................................................7-16

Output Indicators............ ... .. ............................... ... ... .............................7-17

Beeper...................................................................................................7-21

LED Configuration.................................................................................7-22

Serial Verification .............................. ... ... ..............................................7-23

EZ Button ..............................................................................................7-25

EZ Button Modes...................................................................................7-27

Configurable Output 1...........................................................................7-29

Trend Analysis Output 1........................................................................7-32

ISO/IEC 16022 Symbol Quality Output 1 .............................................. 7-35

Diagnostic Output 1...............................................................................7-38

Configurable Output 2...........................................................................7-39

Trend Analysis Output 2........................................................................7-39

ISO/IEC 16022 Symbol Quality Output 2 .............................................. 7-39

Diagnostic Output 2...............................................................................7-39

Configurable Output 3...........................................................................7-40

Trend Analysis Output 3........................................................................7-40

ISO/IEC 16022 Symbol Quality Output 3 .............................................. 7-40

Diagnostic Output 3...............................................................................7-40

Power-On/Reset Counts .......................................................................7-41

Time Since Reset................... ... ... ............................... .. ... .....................7-42

Service Message...................................................................................7-43

Frame Information............. .. ... ............................... ... ... ..........................7-44

Image Output.........................................................................................7-45

Database Identifier Output ....................................................................7-48

Quality Output .......................................................................................7-49

Configuring EZ Trax Output ..................................... .............................7-50

Chapter 8 Symbol Quality

Symbol Quality Serial Commands...........................................................8-2

Overview of Symbol Quality............................................. .......................8-3

Symbol Quality by ESP...........................................................................8-4

Symbol Quality Separator / Data Matrix Output Mode ............................8-8

ISO/IEC 16022 Symbol Quality Output ................................................. 8-10

ISO/IEC 16022 Symbol Quality Output by ESP .................................... 8-12

Microscan Symbol Quality Output.........................................................8-13

Microscan Symbol Quality Output by ESP............................................8-16

Chapter 9 Matchcode

Matchcode by ESP..................................................................................9-2

Matchcode Serial Commands .................................................................9-2

vi MS-4 Imager User’s Manual

Overview of Matchcode...........................................................................9-3

Matchcode Type............. ... ... .............................. ... ... ...............................9-4

Match Replace...................................... ............................ .......................9-9

Mismatch Replace............. ... .. ............................... ... ... ..........................9-10

New Master Pin.....................................................................................9-11

Chapter 10 Camera and IP Setup

Camera and IP Setup by ESP...............................................................10-2

Camera and IP Setup Serial Commands ..............................................10-3

Video .....................................................................................................10-4

Evaluation..............................................................................................10-5

Calibration .............................................................................................10-9

Window of Interest...............................................................................10-10

Configuration Database.......................................................................10-13

Dynamic Setup....................................................................................10-14

Pixel Sub-Sampling.............................................................................10-15

Camera................................................................................................10-16

Focal Distance.....................................................................................10-18

Focal Distance Table (Read-Only)......................................................10-19

IP Threshold........................................................................................10-20

Number of Symbols in Field of View....................................................10-22

Image Processing Timeout..................................................................10-23

Damaged Symbol................................................................................10-24

IP Mode...............................................................................................10-25

Hollow Mode........................................................................................10-26

Mirrored Image....................................................................................10-27

Illumination Brightness ........................................................................10-28

Skew Correction ..................................................................................10-29

Introduction

Chapter 11 Configuration Database

Configuration Database Serial Commands ...........................................11-2

Number of Active Indexes .....................................................................11-3

Configuration Database Status..............................................................11-4

Database Mode.....................................................................................11-9

Save Current Settings to Configuration Database...............................11-14

Load Current Settings from Configuration Database...........................11-15

Request Selected Index Settings ........................................................11-16

Request All Configuration Database Settings .....................................11-17

Chapter 12 Terminal

Terminal Window...................................................................................12-2

Find........................................................................................................12-3

Send......................................................................................................12-4

Macros...................................................................................................12-5

Terminal Window Menus.......................................................................12-6

Chapter 13 Utilities

Serial Utility Commands........................................................................13-2

MS-4 Imager User’s Manual vii

Table of Contents

Read Rate.................................... ... ............................ ..........................13-4

Counters................................................................................................13-5

Device Control............................................................................. ... ... ....13-7

Master Database............... .. ... ............................... ... ... ..........................13-8

Firmware .............................................................................................13-14

Bar Code Configuration.......................................................................13-17

Default / Reset / Save .................................................................... ... ..13-18

Imager Status Requests......................................................................13-20

Other Operational Serial Commands ..................................................13-22

Chapter 14 Output Format

Output Format Serial Commands..........................................................14-2

Output Format Status................ ............................................................14-3

Format Assign.......................................................................................14-4

Format Extract.......................................................................................14-5

Format Insert.........................................................................................14-7

Output Filter Configuration ............................................... .....................14-9

Ordered Output Filter ..........................................................................14-13

Appendices

Appendix A General Specifications.........................................................A-2

Appendix B Electrical Specifications.......................................................A-5

Appendix C Serial Configuration Commands..........................................A-6

Appendix D Communications Protocol..................................................A-12

Appendix E ASCII Table........................................................................A-21

Appendix F Interface Standards............................................................A-22

Appendix G Object Detector..................................................................A-23

Appendix H Operational Tips ................................................................A-24

Appendix I USB-to-Serial Virtual COM Port Driver................................A-25

Appendix J Glossary of Terms..............................................................A-28

Index

viii MS-4 Imager User’s Manual

Introduction

About the MS-4 Imager

The key features of the MS-4 are:

• A multi-function EZ button for location, calibration, and symbol reading.

• A target pattern symbol locator that identifies the center point of the field of view.

• A green flash (visible from all angles) to sign al a su cce ssf ul re ad .

• Ability to read both 2D and linear symbols.

• Ability to read difficul t and damaged symbols.

• USB, RS-232, RS-422 connectivity options.

• Standard Density and Low Density options.

About This Manual

This manual provides complete information on setting up, installing, an d configuring the
Imager. The chapters are presented in the order in which an Imager might be set up and
made ready for operation.

Highlighting

Commands are highlighted in rust bold. Cross-references and web links are highlighted
in

blue bold. References to ESP, its toolbar headings (Communications, Read Cycle,

Symbologies, etc.), menu topics, and other points of emphasis, are highlighted in Bold
Initial Caps. References to topic headings within this manual or other documents are

enclosed in quotation marks.

Host Communications

There are four ways to configure and test the MS-4:

1. EZ button.

2. Microscan’s Windows-based ESP (Easy Setup Program), which offers point-and-click
ease of use and visual responses to user adjustments.

3. Serial commands, such as <K100,1>, that can be sent from ESP’s Terminal window
or another terminal program.

4. The tree control menus and graphic interfaces in ESP’s App Mode.

MS-4 Imager User’s Manual ix

Warning and Caution Summary

WARNING

LED LIGHT

DO NOT VIEW DIRECTLY WITH OPTICAL INSTRUMENTS

CLASS 1 LED PRODUCT

LED Output: .564 mW. Wavelength: 470 nm; 525 nm; 617 nm.

IEC 60825-1:1993+A1:1997+A2:2001

LED Aperture Window

Warning and Caution Summary

• Viewing the MS-4’s LED output with optical instruments such as magnifiers, eye loupes,
or microscopes within a distance of 100 mm could cause serious eye injury.

• Maximum LED output: .564 mW.

• Wavelength: 470 nm; 525 nm; 617 nm.

• Location of the MS-4’s LED aperture window:

CAUTION: Use of controls or adjustments or performance of procedure s other than those
specified herein may result in hazardous radiation exposure.

IMPORTANT: The MS-4 is intended for connection to a UL-listed direct plug-i n powe r u nit
marked Class II and rated 5 VDC at 3 Watts, or greater if using electrical accessories.

European models must use a similarly rated Class I or Class II power supply that is certified
to comply with standard for safety EN 60950.

x MS-4 Imager User’s Manual

Introduction

Statement of Agency Compliance

The MS-4 Imager has been tested for compliance with FCC (Federal Communications
Commission) regulations and has been found to conform to all applicable FCC Rules and
Regulations.

To comply with FCC RF exposure compliance requirements, this device must not be co-located
or operate in conjunction with any other antenna or tr ansmitter.

Changes or modifications not expr essly approv ed by the party responsible for compliance
could void the user’s authority to operate the equipment.

The MS-4 Imager has been tested for compliance with CE (Conform ité Europée nne )
standards and guidelines, and has been found to conform to applicable CE standards,
specifically
EN 61000-4-3, ENV 50204, EFT EN
55022, Class B Radiated Emissions

The MS-4 Imager has been tested by an independent electromagnetic compatibility laboratory
in accordance with the applicable specifications and instructions.

the EMC requirements

EN 55024, ESD EN 61000-4-2, Radiated RF Immunity

61000-4-4, Conducted RF Immunity EN 61000-4-6, EN

, and Class B Conducted Emissions.

MS-4 Imager User’s Manual xi

Statement of Agency Compliance

xii MS-4 Imager User’s Manual

Contents

Step 1 Check Required Hardware................................................................................................1-2

Step 2 Connect the System..........................................................................................................1-3

Step 3 Position Imager and Symbol..............................................................................................1-4

Step 4 Install ESP.................................................... ... ............................... ... ... .............................1-5

Step 5 Select Model....................................................... ... ............................................................1-6

Step 6 Select Communications Protocol.......................................................................................1-7

Step 7 Locate the Symbol in the FOV...........................................................................................1-8

Step 8 Calibrate Settings........................................................................................................... 1-10

Step 9 Test Read Rate .............................................................................................................. 1-11

Step 10 Configure the Imager in ESP........................................................................................ 1-12

Step 11 Make Menu Changes and Save in ESP.............. ............................ ............................ . 1-13

1 Quick Start

This section is designed to get your MS-4 Imager up and running quickly, using the EZ
button or ESP (Easy Setup Program). Following these steps will allow you to get a sense
of the Imager’s capabilities and to test sample symbols.

Detailed setup information for installing the Imager into your actual application can be
found in the subsequent chapters.

MS-4 Imager User’s Manual 1-1

Check Required Hardware

Hardware Required (RS-232 / RS-422)

Caution: Be sure that all cables are connected BEFORE applying power to a

system with an external power source (RS-232 / RS-422). Always power down
BEFORE disconnecting any cables.

Hardware Required (USB)

Step 1 — Check Required Hardware

Item Description Part Number

1 MS-4 Imager FIS-0004-XXXXG
2 IB-3PC FIS-0001-0030G

3 Power Supply
4 Comm. Cable 61-000010-02

97-000002-01 (90-264 VAC, +5VDC)
97-100004-15 (24VDC)

To additional imagers
or terminating resistor

1

To host

1-2 MS-4 Imager User’s Manual

Quick Start

Hardware Configuration

(RS-232 / RS-422)

Hardware Configuration

(USB)

Caution: Be sure that all cables are connected BEFORE applying power to a

system with an external power source (RS-232 / RS-422) . Always power down
BEFORE disconnecting any cables.

Step 2 — Connect the System

Connecting by RS-232 / RS-422

• Connect the Imager (1) to the IB-3PC interface (2).

• Connect the comm. cable (4) to the host (5) and to the host connector on the IB-3PC (2).

• Connect power supply (3) to the IB-3PC (2).

• Apply power to the Imager.

Connecting by USB

• Plug the MS-4 Imager’s USB cable into a host USB port. The host will power the Imager.

To additional imagers
or terminating resistor

1

To host

MS-4 Imager User’s Manual 1-3

Position Imager and Symbol

Imager Position Relative to Symbol

Step 3 — Position Imager and Symbol

• Position the Imager at a distance from the symbol that matches the factory pre-set focal
distance. For example, if your MS-4 is pre-set at 4”, position the Imager’s parting line 4”
from the symbol.

• Tip the Imager relative to the symbol to avoid the glare of direct (specular) reflection. The
case parting line should be perpendicular to the plane of the symbol by either pitching the
symbol or the Imager as shown.

• Position the Imager in a place with as little ambient light as possible.

• Symbols can be rotated (tilted) at any angle; however, for best results symbols should
be aligned with the FOV (field of view).

±30°

• In the case of linear symbols, aligning the bars in the direction of their movement (“ladder”
orientation) will minimize the chances of blurring, and will produce better reads.

• Avoid excessive skew or pitch. Maximum skew is ±30°; maximum pitch is ±30°.

Note: For instant setup and validation, the MS-4 can be hand-he ld or placed on it s side.
For accuracy, however, Microscan’s mounting arm adapter kits (P/N 98-000048-01) are
recommended.

1-4 MS-4 Imager User’s Manual

Quick Start

Step 4 — Install ESP

Easy Setup Program (ESP) is Microscan’s propriet ar y setup and te sting ap plication. The
purpose of

When the MS-4 is connected to a host computer (Windows Vista, XP, or 2000), ESP can
be used to configure reader settings an d to set up com m un ica tio ns be tw ee n th e re ad e r
and host.

If installing from the Microscan Tools CD:

1. Insert the Microscan Tools CD in your computer’s CD drive.

2. Select ESP Software from the navigation bar at the left of the screen.

3. Click on ESP Software under the Current Version heading.

4. Click the Run button and follow the prompts in the ESP Setup Wizard.
Note: During installation, you may see an Internet Explorer Security Warning that

states: “The publisher could not be verified.” If you see this warning, click Run to
continue installation.

If downloading from the web:

1. Go to the Download Center at www.microscan.com.

2. Create a new member account or, if you are already a member, enter your user name
and password.

3. Navigate to the “Microscan Soft ware” se ctio n of the Do wnload Center (near th e top of
the page).

4. Click on the link showing the latest version of ESP. Extract the ESP installation files to
a location of your choice on the host computer. Note where your ESP.exe file is stored

on your hard drive.

5. At the end of the installation process, the following icon will appear on your desktop:

ESP

is to provide a quick and easy way to set up and configure Microscan readers.

6. Click the ESP icon to start the program.

System Requirements for ESP

• 166 MHz Pentium processor (recommended)

• Windows Vista, XP, or 2000 operating system

• Internet Explorer 5.0 or higher

• 64 MB minimum RAM

• 40 MB minimum disk space

• 800 x 600 pixel minimum 256 color display

MS-4 Imager User’s Manual 1-5

Select Model

Step 5 — Select Model

When you start ESP, the following menu will appear:

1. Click the MS-4 button and then click OK. If you do not want to make this selection
every time you start ESP, uncheck “Show this window at Startup”.

2. Select the default reader name (MS-4-1), or type a name of your choice in the
Description text field and click OK.

3. Click Yes when this dialog appears:

Note: If you need to select another reader model later, click the Switch Model button
near the top of the screen.

1-6 MS-4 Imager User’s Manual

Quick Start

When you are connected, you will see the green connection indicator in the status bar
at the bottom right of your screen.

If you choose USB protocol:

If you choose RS-232 protocol:

USB:

RS-232:

• Select the
MS-4

from

the

Select

Device

menu

and click

Finish

.

• Click Connect.

Note: If your RS-232 host
settings cannot be
changed to match the
Imager’s settings, check
the Force Connect box.

Step 6 —Select Communications Protocol

Important: The Imager is in Continuous Read Mode by default. For best connection
results, be sure that no symbols are within the Imager’s field of view while attempting to
connect.

• When the

Select Protocol

dialog appears, choose your connection protocol and click

Next

.

• If you are using an RS-232 interface and your connection attempt fails, click the
button, select a different communications port, and try again.

MS-4 Imager User’s Manual 1-7

Autoconnect

Locate the Symbol in the FOV

Center on object
in field of view.

Target pattern shown as it would appear between 3 and 6 inches.

Step 7 — Locate the Symbol in the FOV

• Move the symbol or the Imager so that the blue target pattern is centered over the symbol.
At 2 to 3 inches, the pattern resembles an X. At 3 to 6 inches, the p attern r esembles a V.

It is important for the whole symbol to fall within the field of view (FOV) of the Imager.
The field of view is what appears in ESP’s Locate/Calibrate window.

Locate by EZ Button

If you are not connected to a host computer, the EZ button will allow you to locate a symbol
in the Imager’s FOV.

• Hold down the EZ button for about one second and release when you hear one short beep.
The amber
front of the Imager.

• Center the target pattern on the symbol.

Note: To end all EZ button functions, press the EZ button once and quickly release.

20%

LED will turn on, and you will see the blue target pattern projected from the

1-8 MS-4 Imager User’s Manual

Locate by ESP

•In ESP’s EZ Mode, click the Locate button to enable the target pattern.

Quick Start

You will see the blue target pattern projected from the front of the Imager.

• Center the target pattern over the symbol you wish to read.

Center on object
in field of view.

Target pattern shown as it would appear between 3 and 6 inches.

• Click the Stop button to end the Locate function.

MS-4 Imager User’s Manual 1-9

Calibrate Settings

Step 8 — Calibrate Settings

MS-4 image settings can be adjusted automatically for optimum readability by either the
EZ button or by ESP.

During the calibration routine, the reader will flash its amber read rate percent LEDs and
red illumination LEDs while searching through various focus and camera settings and
determining the best configuration for decoding symbol data. Upon successful completion
of this routine, a green LED pattern will flash brightly and illuminate the symbol. If unsuccessful
the Imager will emit 5 short beeps and stop searching.

,

Calibrate by EZ Button

1. Hold down the EZ button about two seconds and release when you hear two short
beeps. The 20% and 40% LEDs will illuminate.

2. The Imager will search through various camera and IP settings to determine
configuration for decoding symbol data

Important: The object must be centered in the field of view for the calibr ation process
to be successful.

Note: To end all EZ button functions, press the EZ button once and quickly release.

.

the best

Calibrate by ESP

1. Click the Calibrate button.

2. The Imager will search through various camera and IP settings to determine
configuration for decoding symbol data

A successful calibration will display a green frame around the symbol, and the following
message will appear: “Uploading all reader parameters.” After a moment the symbol’s
data and related features will be presented under the “Symb ol Informa tion” box below
the image display window.

.

the best

Calibrate by Serial Command

Send <@CAL> to begin calibration.

1-10 MS-4 Imager User’s Manual

Quick Start

Step 9 — Test Read Rate

This test will let you know the percent of good reads per image captures the Imager is
producing.

Testing by EZ Button

1. To start the read rate test, hold down the EZ setup button about three seconds until you
hear three short beeps. The 20%, 40%, and 60% LEDs will illuminate.

Whi le t h e sy m bol i s be ing dec oded, t he read r ate LED s will indicate the correspond­ing read rate percentage on the back of the unit.

2. To end the read rate test, press the EZ button and quickly relea se.

Testing by ESP

1. Click the Test button to start the read rate test and Stop to end it.

If your symbol has been successfully decoded, its data and related features will be
presented under “Symbol Information.” Also, while the symbol is being decoded, the read
rate LEDs will indicate the corresponding read rate percentage on the back of the unit.

2. To end the test, click the Stop button.

Testing by Serial Command

You can also start a test with the <C> or <Cp> command and end it with the <J> command.

MS-4 Imager User’s Manual 1-11

Configure the Imager in ESP

Step 10 — Configur e the Imager in ESP

To make setup changes to the MS-4, click the App Mode button.

The following modes are accessible by clicking the buttons in the first row of App Mode
icons:

• Establish communications between

• Send or receive commands by clicking the Send/Recv button.

• Make changes to Camera options by clicking the Camera button.

• Access the Terminal window, where you can see symbol data and enter serial commands,
by clicking the Terminal button.

• Review status settings or make changes to operational commands by clicking the Utilities
button.

• Format data for output by clicking the Output Format button.

Click the Configuration button to display the second row of ESP icons.

From here you can make changes in the configuration trees that can be accessed by clicking
the buttons on the second row of icons in the

ESP

and the Imager by clicking the

ESP

window .

Autoconnect

button.

For further details, see ESP Help in the pulldown Help menu.

1-12 MS-4 Imager User’s Manual

Quick Start

1. Left click on the

+ to expand the

desired tree.

2. Double click on
the desired
parameter and
click once in the
selection box to
view options.

5. Right click on the open
screen and select Save to
Reader to implement the
command in the Imager.

4. Left click again on the
open screen to complete
your selection.

3. Place your cursor in the
selection box, scroll down
to the setting you want to
change, and click once on
the setting.

Step 11 — Make Menu Changes and Sa ve in ESP

To make changes t o a configuration setting:

Saving Options

• Send, No Save. Changes will be lost when power is re-applied to the Imager.

• Send and Save. This activates all changes in current memory and saves to the Imager
for power-on.

MS-4 Imager User’s Manual 1-13

Make Menu Changes and Save in ESP

1-14 MS-4 Imager User’s Manual

2 Using ESP

EZ Mode........................ ... ............................ ............................ ............................ .........................2-2

Application Mode...........................................................................................................................2-3

Menu Toolbar..................................................... ... .............................. ... ... ....................................2-4

Connecting..................................................................................................................................2-12

View ............................................................................................................................................2-13

Navigating in ESP........................................... ............................ ............................ ....................2-14

Send/Receive Options ................................................................................................................2-15

Using EZ Trax.............................................................................................................................2-17

Contents

This section is designed to help you underst and the structu re, elements, and app lication of
ESP (Easy Setup Program).

When you open ESP, unless otherwise specified in the ESP Preferences dialog accessible
from the Options heading on the menu toolbar, you will enter EZ Mode for initial setup.
From there, you can enter Application Mode (App Mode) and access several configuration
menus (Communications, Read Cycle, Symbologies, I/O Parameters , Symbol Quality,
Matchcode, and Diagnostics), a Camera setup interface, a Terminal interface, a Uti liti es
interface, and an Output Format interface.

ESP can be used to configure the MS-4 Imager in four different ways.

•

Control Trees:

specific element of Imager operation. For example, the

Host Port Connections
Bits

, and

• Graphic User Interfaces: Imager settings can be configured using such point-and- click
tools as radio buttons, zoom in/zoom out sliders, spin boxes, check boxes, and drag­and-drop functions.

• Terminal: ESP’s Terminal interface allows you to send serial configuration and utility
commands directly to the Imager by typing them in the provided text field.

• Symbol Configuration: The Imager can be configured by reading symbols produced in
ESP’s Bar Code Dialog interface. Symbols can be created by dragging and dropping
configuration settings from the control trees to the Bar Code Value field in the Bar Code
Dialog, and then printing the new symbol.

For ESP system requirements, see Chapter 1, Quick Start.

MS-4 Imager User’s Manual 2-1

Each configuration menu contains a list of all option settings that pertain to that

Data Bits

Communications

option, and then a list of the sub-options

. Each of these sub-options is configurable by using dropdown menus.

Baud Rate, Parity, Stop

menu shows a

EZ Mode

Click Calibrate to begin the initial
calibration routine. Calbration is
explained at the left of the EZ Mode
screen, and also in the “Quick S tart”
chapter of this manual.

Enter App Mode to
access configuration
trees and other setup
features.

Click Locate to activate the MS-4’s blue target pattern
LEDs. Center the target pattern on the symbol. The real-time
display shows you where the symbol is located in the
Imager’s field of view.

Starts read rate test.

Ends read rate test.

Click here to change
from percentage of
good decodes to
decodes per second
while performing a
read rate test.

EZ Mode

In

EZ Mode

to your Imager ,
instructions that will help you with positioning, testing, and calibration.

Test

Click the Test button to start the read rate test for a quick indication of the Imager’s read
capabilities and the limits of your application. When Decodes per Second is unchecked,
the test will count the percentage of decodes relative to the number of actual scans. Click

Stop to end the test.

Calibrate

The calibration routine that will optimize the Imager by comparing read rates at various
camera and image processing set ting s.

you are presented with the

EZ Mode

is the screen you will see. You will be provided with on-screen

Locate, Calibrate

, and

Test

options. After connecting

2-2 MS-4 Imager User’s Manual

Using ESP

Decoded symbol data
is shown in this table.

Click Capture and Decode to
read the symbol in the field of
view, and to see a high resolution
image capture of the symbol.

Click on icons in this row to
access configuration trees
like the one shown here.

Click the Configuration icon to return to full

App Mode view from Camera, Terminal,
Utilities, or Output Format.

Click here for
Ordered Output
and Output Format
features.

Click here to open
the Terminal view.

Camera Setup, advanced
Calibration, Configuration
Database.

Menu toolbar.

Click this icon to
return to EZ Mode.

Application Mode

From EZ Mode, you can click on the App Mode button to access specific configuration
menus, Utilities tools, Camera setup, Output Format options, and a Terminal window
where serial commands can be entered.

Note: The App Mode and EZ Mode buttons appear in the same position to allow easy
switching between these primary modes.

Note: For specific information on any of the icons shown above in the operations bar or
configuration bar, see the corresponding chapters in this manual.

MS-4 Imager User’s Manual 2-3

Menu Toolbar

(Save to Imager)

(Receive Imager

Settings)

Menu Toolbar

File > New

Whenever New is selected, the default configuration of ESP is
loaded.

Open/Save

When Save or Save As is selected, the ESP configuration is
saved to the host computer’s hard drive and available whenever
the same file is selected under Open.

Important: When you save menu changes to your hard drive,
these changes are not saved to your Imager.

below shows how settings can be saved and received between

ESP and the Imager, and ESP and the host hard drive.

The illustration

Import / Export

Import converts the ASCII settings from a text file to ESP configuration settings.
Export converts the active ESP configuration settings to an ASCII text file.

2-4 MS-4 Imager User’s Manual

Model

In Model you can select any of the models shown in ESP’s model
menu. When you choose another model, your current conn ection to
your present model will be terminated.

To connect to another model, select New Model, choose a new
model from the menu, and click OK.

Using ESP

Note: All the models you have enabled by selecting will continue to appear in the Model
menu and that the same menu is repeated when clicking the Switch Model icon.

When you save your ESP file, you will be saving the settings of all the models defined in a
single ESP file.

MS-4 Imager User’s Manual 2-5

Menu Toolbar

Options

The Options menu allows you to save memos and set up ESP
Preferences.

Note: Preferences will be saved and loaded into ESP when
ESP is opened next, whether or not you save the ESP file.

Preferences

General Tab

Reload Last File

At startup, reloads the last file saved to the host computer’s hard drive.

Show Model Prompt

At startup, shows the model menu displaying all supported re aders.

Skip EZ Mode
At startup, skips EZ Mode and opens directly in App Mode.

Show Connect Prompt
At startup, displays the Would you like to connect...? prompt.

Receive After Connect

At startup, loads the Imager’s settings into ESP. (This is not recommended if you want to
preserve your ESP settings for future use.)

Enable Send and Save as Customer Defaults

At startup, enables the Send and Save as Customer Defaults option in the Send/Recv
command.

2-6 MS-4 Imager User’s Manual

Terminal Tab

Using ESP

When Show Non-Printable Characters is checked, characters such as “CRLF” will be
displayed in the Terminal window. When Enhanced Format is checked, the characters
are displayed with more detailed formatting.

Change Keyboard Macros

In this dialog you can first select the function key and then enter your macro keystrokes in the
associated key map. For example, to make
character, select
whenever the

F5

, and then in the

Ctrl-F5

keystroke is pressed, the trigger character will start the read cycle.

Ctrl

Ctrl-F5

row , enter

the keystroke to enable, send a trigger

<trigger character>

and click OK. Then

Change Font

Allows you to modify the font used for decode data received from the Imager on the

Terminal

screen.

Change Echo Font
Allows you to modify the font used for command characters typed into the Terminal view.

Toolbar Style

Displays user-selected toolbar buttons as icons, text only, or both (default).

MS-4 Imager User’s Manual 2-7

Menu Toolbar

Bar Code Options Tab

The Bar Code Options dialog allows you to set the size (in mi ls) of user- created symbo ls.

Sizing Information

Sets the bar width (in thousands of an inch) of user-created symbols. A bar width of 14 is

0.014 inches.

2-8 MS-4 Imager User’s Manual

Grade Report Options Tab

Using ESP

Overall Grade Based On

Allows you to choose which symbol characteristics will be considered in generating a
symbol quality grade.

Use Number Grades

Allows you to switch from the default letter grades to number grades in symbol quality
report output.

Show Report Options during ‘Generat e Report’

Sets the symbol quality report output to show the comp le te ar ra y of re po rt opt ion s.

Include Image

Sets the symbol quality report output to include a captured image of the symbol being
analyzed. Bitmap and JPEG image formats are both available. Bitmap images, although
higher resolution, have larger file sizes and take longer to load.

MS-4 Imager User’s Manual 2-9

Menu Toolbar

Advanced Tab

The Auto Sync dialog at the top of the Advanced tab allows you to determine whether
Auto Sync will be automatically enabled in sections of ESP where it is used, or if it will ask
you before it enables Auto Sync functions.

Always Ask Before Auto Sync Occurs

If you check this option box, you are then able to determine what specific Auto Sync
functions will be enabled. Receive Settings from the Reader will automatically send
the Imager’s settings to ESP when Auto Sync is enabled. Send ESP Settings to the
Reader will automatically send all Imager configuration settings chosen in ESP to the
Imager. Do Not Send or Receive Settings creates a condition in which Auto Sync will
not send Imager settings to ESP, or send ESP settings to the Imager.

Show Targeting Pattern During Calibrate and Locate

Allows you to determine whether the blue LED target pattern will be on or off during the

Locate and Calibrate routines.
Send XON with Autoconnect

Sends an

XON (Begin T ransmiss ion

) command to the Imager before starting the

Autoconnect

routine.

2-10 MS-4 Imager User’s Manual

Using ESP

Document Memo

The information you type in the Document Memo field will appear in a context-sensitive text
box whenever your cursor hovers over the Document Memo item on the Options menu.

Model Memo

Similar to Document Memo, the information you type in the Model Memo field will appear
in a context-sensitive text box whenever your cursor hovers over the Model Memo item on
the Options menu. Memos created in Model Memo are specific to the model enable d
when the message was created.

Note:

Memos must be saved in a
If you do not save your current session, any memos that you have entered during the session
will be discarded, and will be unavailable in your next session.

MS-4 Imager User’s Manual 2-11

.esp

file if you want them to available in your next session.

Connecting

When you are connected, you will see the green connection indicator in the status bar
at the bottom right of your screen.

Click Connect.

If you choose USB protocol:

If you choose RS-232 protocol:

USB:

RS-232:

Select the

MS-4
from the Select
Device menu and
click Finish.

The MS-4 Imager’s default trigger mode is

Continuous Read Mode

. The USB version of the MS-4 will

be in a keyboard wedge configuration, causing

ESP

to receive incoming sy mbol data as keyboard text.
This will interfere with the co nn ec tio n at te m pt an d ca us e it to fail. Be sure that no symb ols are within
the Imager’s field of view while connec ting to

ESP

.

Note: If your RS-232 host
settings cannot be
changed to match the
Imager’s settings, check
the Force Connect box.

Connecting

When you open ESP and the Select Protocol dialog app ears, choose either RS-232 or
USB protocol and click Next.

Important: If you are using an RS-232 interface and your connection attempt fails, click
the Autoconnect button, select a different communications port, and try again.

2-12 MS-4 Imager User’s Manual

View

Choose a spatial
orientation for the
new symbol.

Set a human­readable caption
for the symbol
that matches the
encoded data, or
write your own
caption.

The symbol you create
will be displayed in the
field at the bottom of the
Bar Code Dialog.

Drag specific configuration
values from the control tree
directly into this field to
encode new symbols.

The View menu allows you to move quickly between interfaces
without using the icon buttons on the App Mode toolbar. It also
allows you to access the Bar Code Dialog.

Bar Code Dialog

Using ESP

In the
wish to encode. This is a useful tool for crea ting confi gurat ion symbo ls,
allowing you to configure your reader by reading the symbols you create.

Bar Code Dialog

you can create symbols by typing the text you

MS-4 Imager User’s Manual 2-13

Navigating in ESP

1. Left click on the + to expand
menu items.

2. Double click the desired
parameter and single click
in the selection box to view
options.

3. Place your cursor in the
selection box, scroll down
to the setting you want to
change, and single click
the setting.

4. Left click again on the open screen to complete the
selection.

5. Right click on the open screen and select Save to
Reader to implement the command in the Imager.
You can send the command without saving it, or you
can send and save the command simultaneously.

The X denotes the
default option setting.

Navigating in ESP

To change Imager settings, or to access the Utilities, Camera, Terminal, or Output Format
views, click the App Mode button.

To return to EZ Mode, click the EZ Mode button.

To make changes to configuration settings in the control trees:

2-14 MS-4 Imager User’s Manual

Using ESP

Send/Receive Options

To access Receive, Save and Default options, click the Send/Recv
button. You can also access these options by right-clicking in any of the
configuration views.

Receiving

From the Send/Recv menu, select Receive Reader Settings.
Caution: Do not select this option if you do not want to upload the Imager’s settings. For

example, if your ESP file has a number of custom settings that you want to maintain and
download into the Imager, these settings would be lost by choosing Yes.

This is useful if you want to receive (upload) the Imag er’s settings and save the m as a file
for future use. For example, if your Imager has settings that you do not want to change,
choosing Yes would allow you to load those settings to ESP and save them in an ESP file
for later retrieval.

Receiving the Imager’s settings will also assure that you will not be subsequently saving
any unwanted changes that you or someone else has made previously in ESP.

Saving

1. Send, No Save
(<A>)

This saves ESP
settings to current
memory.

2. Send and Save
(<Z>)

This activates all changes in current memory and saves to the Imager for power-on.

3. Send and Save as Customer Defaults
(<Zc>)

Use this option to save your own default settings for quick retrieval with a <Zrc>
command.

This option will be visible only if you had checked

Defaults’ in the ESP Preferences dialog.

Enable ‘Send and Save as Customer

MS-4 Imager User’s Manual 2-15

Send/Receive Options

Defaulting

When you select Default Current Menu Settings or Default all ESP Settings, you are
only defaulting the ESP settings.

Advanced Options

Send Current View

This is the same as

Reader

that only the commands in the
current configuration tree are sent.

>

Send No Save

Save to

except

Send Current Command

This is the same as

View

, except that it saves only
the command that is currently
selected.

Send Current

Add / Remove Exception

After you perform a
option, you may see a list of serial commands. These are commands that may be in your
Imager’s firmware, but not included in, or different from, your current version of

You can edit these commands by double-clicking on them and changing them as needed.
It is important to note that these commands will be saved to your Imager whenever you

send a Save to Reader command, or an <A> or a <Z> command.
Also, if there is a corresponding ESP menu item, the ESP Value column for that item will

be blank following a Receive Reader Settings command.

Receive Reader Settings

command1 and you click on the

Add Exception

ESP

.

1. From the Send/Recv button or by right-clicking from within the configuration trees.

2-16 MS-4 Imager User’s Manual

Using ESP

Using EZ Trax

For detailed information about using EZ Trax, refer to the Help menu in EZ Trax software,
or the EZ Trax Quick Start Guide, available on the Microscan Tools CD.

For information about how to configure the MS-4 for use with EZ Trax, see Setting Up the

Imager for EZ Trax in Chapter 5, Read Cycle.

MS-4 Imager User’s Manual 2-17

Using EZ Trax

2-18 MS-4 Imager User’s Manual

Contents

Communications by ESP..............................................................................................................3-2

Communications Serial Commands..............................................................................................3-3

Host Port Connections......................................................... ................................................. ........3-4

Host Port Protocol.................................................... .....................................................................3-5

ACK/NAK Options.........................................................................................................................3-7

Polling Mode Options....................................................................................................................3-8

RS-422 Status...............................................................................................................................3-9

Auxiliary Port Connections........................................................ ... ...............................................3-10

Auxiliary Port System Data Status..............................................................................................3-18

Daisy Chain Autoconfigure .........................................................................................................3-19

Response Timeout......................................................................................................................3-20

LRC Status..................................................................................................................................3-21

Protocol Configuration Examples................................................................................................3-22

USB HID Interface ..................................... ... ............................ ............................ ......................3-23

ASCII Character Entry Modifier...................................................................................................3-32

Preamble.....................................................................................................................................3-33

Postamble...................................................................................................................................3-34

3 Communications

This section explains how to set up communications between the Imager and a host.
With Microscan’s ESP (Easy Setup Program), configuration changes can be made in the

ESP menus and then sent and saved to your Imager. The user can also send serial
commands to the Imager via ESP’s Terminal window.

MS-4 Imager User’s Manual 3-1

Communications by ESP

To open nested
options, single click
the +.

Click this button
to bring up the
Applications
menu.

Click this button
to bring up the
Communication
menu.

To change a setting,
double click the
setting and use your
cursor to scroll
through the options.

Communications by ESP

3-2 MS-4 Imager User’s Manual

Communications

Communications Serial Commands

Host Port Connections <K100,baud rate,parity,stop bits,data bits>
Auxiliary Port Connections <K101,aux port mode,baud rate,parity,stop bits,data

bits,daisy chain ID status,daisy chain ID>
RS-422 Status <K102,status>
Host Port Protocol <K140,protocol,address>
Preamble <K141,status,preamble characters>
Postamble <K142,status,postamble characters>
Response Timeout <K143,response timeout>
LRC <K145,status>
Auxiliary Port System Data Status <K146,aux port system data status>
ACK/NAK Options <K147,RES,REQ,STX,ETX,ACK,NAK>
Polling Mode Options <K148,RES,REQ,STX,ETX,ACK,NAK>
USB HID Reports <K149,Microscan HID IN Report status,Keyboard IN

Report status>
Autoconfiguration Daisy Chain <K150DAISY>

MS-4 Imager User’s Manual 3-3

Host Port Connections

Host Port Connections

The host port can be configured with RS-232 and RS-422 connections.
The following settings define the basic transmission speeds and digital standards that

ensure common formatting.

Baud Rate, Host Port

Usage: Can be used to transfer data faster or to match host port settings.
Definition: The rate at which the reader and host transfer data back and forth.
Serial Cmd: <K100,baud rate,parity,stop bits,data bits>
Default: 115.2K
Options: 0 = 600 1 = 1200 2 = 2400

3 = 4800 4 = 9600 5 = 19.2K
6 = 38.4K 7 = 57.6K 8 = 115.2K
9 = 230K

Parity, Host Port

Usage: Only changed if necessary to match host setting.
Definition: An error detection routine in which one dat a bit per character is se t to 1 or 0

so that the total number of bits in the data field is either even or odd.

Serial Cmd: <K100,baud rate,parity,stop bits,data bits>
Default: None
Options: 0 = None 1 = Even 2 = Odd

Stop Bits, Host Port

Usage: Only changed if necessary to match host setting.
Definition: One or two bits added to the end of each character to indicate th e end of

the character.

Serial Cmd: <K100,baud rate,parity,stop bits,data bits>
Default: One
Options: 0 = One 1 = Two

Data Bits, Host Port

Usage: Only changed if necessary to match host setting.
Definition: One or two bits added to the end of each character to indicate th e end of

the character.

Serial Cmd: <K100,baud rate,parity,stop bits,data bits>
Default: Eight
Options: 0 = Seven 1 = Eight

Note: See USB HID Interface on page 3-23 for protocol information relating to USB.

3-4 MS-4 Imager User’s Manual

Host Port Protocol

Communications

Usage:

Definition: Protocols define the sequence and format in which information is transferred

Serial Cmd: <K140,protocol,address>
Default: Point-to-Point
Options: 0 = Point-to-Point

Note: In all protocol modes, the preamble <K141> and postamble <K142> character
strings can be used to frame the decode data, and both are included in calculating the

LRC Status (Longitudinal Redundancy Check).

In general, the point-to-point protocols will work well in most applications. They
require no address and use RS-232 or RS-422 communications standards.

between the reader and the host, or in the case of Multidrop, between the
readers and a concentrator.

1 = Point-to-Point with RTS/CTS
2 = Point-to-Point with XON/XOFF
3 = Point-to-Point with RTS/CTS and XON/XOFF
4 = ACK/NAK
5 = Polling Mode

Point-to-Point (Standard)

Usage: Used only with RS-232 or RS-422.
Definition: St andard Point-to-Point requires no address and sends the data to the

host whenever it is available, without a request or handshake from the host.

Serial Cmd: <K140,0>

Point-to-Point with RTS/CTS

Usage: A reader initiates a data transfer with an RTS (request-to-send) transmission.

The host, when ready , responds with a CTS (clear-to-send) and the data is
transmitted. RTS and CTS signals are transmitted over two dedicated wires
as defined in the RS-232 standard. Used only with RS-232.

Definition: Point-to-Point with RTS/CTS (request-to-send/clear-to-send) is a simple

hardware handshake protocol that allows a reader to initiate data transfers
to the host.

Serial Cmd: <K140,1>

Point-to-Point with XON/XOFF

Usage:

Definition: This option enables the host to send the XON and XOFF command as a

Serial Cmd: <K140,2>

MS-4 Imager User’s Manual 3-5

If an XOFF has been received from the host, data will not be sent to the host
until the host sends an XON. During the XOFF phase, the host is free to carry
on other chores and accept data from other devices.Used only with RS-232.

single byte transmission command of start (^Q) or stop (^S).

Host Port Protocol

Point-to-Point with RTS/CTS and XON/XOFF

Usage: Used only with RS-232.
Definition: This option is a combination of Point-to-Point with RTS/CTS and Point-

to-Point with XON/XOFF.

Serial Cmd: <K140,3>

ACK/NAK

Definition: See the ACK / NAK Options command <K147> on page 3-7.
Serial Cmd: <K140,4>

Polling Mode

Definition: See the Polling Mode Options command <K148> on page 3-8.
Serial Cmd: <K140,5>

Poll Address

Serial Cmd: <K140,protocol,address>
Default: 1
Options: 1 to 50

1 = Poll address 0x1C, Select address 0x1D
2 = Poll address 0x1E, Select address 0x1F

...

50 = Poll address 0x7E, Select address 0x7F

Note: See USB HID Interface on page 3-23 for protocol information relating to USB.

3-6 MS-4 Imager User’s Manual

ACK / NAK Options

Communications

Definition:

Serial Cmd: <K147,RES,REQ,STX,ETX,ACK,NAK>

These parameters take effect for
RS-422 ports (not on the Auxiliary Port), and are completely independent of
the

Polling Mode Options <K148>

The Imager always follows the protocol in both directions (to and from the
host). There is no option to disable it from either direction.

ACK/NAK <K140,4>

.

on the main RS-232 or

RES-NAK Defaults

RES: (Reset) 00 (disabled)
REQ: (Request) 00 (disabled)
STX: (Start of Text) 00 (disabled)
ETX: (End of Text) 00 (disabled)
ACK: (Acknowledge) 06

NAK: (Negative Acknowledge) 15

The following are general outlines of the ACK/NAK protocol. Items that are framed by
brackets ( [ ] ) can either be disabled or enabled. LRC does not include STX, but it does
include preamble, postamble, and ETX.

Symbol Data Output

TX to host: [STX] [preamble] SYMBOL DATA [postamble] [ETX] [LRC]
Response from host: ACK/NAK. Sent when LRC, ETX, postamble, or timeout (waiting

for more data) are detected (if REQ is disabled) depending on what is enabled.

Commands from Host to Imager

TX to Imager: [STX] <command> [ETX] [LRC]
Response from Imager: ACK/NAK. Sent when LRC, ETX, or command-ending angle

bracket ‘>’ are received, depending on what is enabled.

Command Response from Imager to Host

TX to host: [STX] [preamble] COMMAND RESPONSE DATA [postamble] [ETX] [LRC]
Response from host: ACK/NAK. Sent when LRC, ETX, postamble, command-ending

angle bracket ‘>’, or timeout (waiting for more data) are detected, depending on what is
enabled.

As with Polling Mode <K140,5>, the Imager can optionally perform the REQ and RES
event sequences in ACK/NAK mode. If the sender does not receive an ACK or NAK, it will
send REQ to request such a response (if enabled). When the sender receives an ACK, too
many NAKs, or times out (if already enabled), it will send a RES (if enabled) to terminate the
transaction.

Note:

See

ACK / NAK Data Flow Examples

scenarios.
Note: See USB HID Interface on page 3-23 for protocol information relating to USB.

MS-4 Imager User’s Manual 3-7

in Appendix D for sample ACK/NAK communications

Polling Mode Options

Polling Mode Options

Definition: These parameters only take ef fect for Polling Mode <K140,5> on the main

RS-232 or RS-422 ports (not on the Auxiliary Port), and are completely
independent of the ACK/NAK Options <K147>.

The values of protocol character s can be changed, but the protocol events
cannot be disabled. The polling mode address is configured in the <K140>
command (see Poll Address on page 3-6).

To enable multidrop protocol, the RS422 port must be enabled, <K102,1>,
in order to turn the transmitter on and off. If RS-232 is enabled instead of
RS422, <K102,0>, then Polling Mode will operate as a Point-to-Point
polling protocol. This is because the RS-232 transmitter is always left on
when enabled.

Serial Cmd: <K148,RES,REQ,STX,ETX,ACK,NAK>

RES-NAK Defaults

RES: (Reset) 04
REQ: (Request) 05
STX: (Start of Text) 02
ETX: (End of Text) 03
ACK: (Acknowledge) 06

NAK: (Negative Acknowledge) 15

Note: See Polling Mode Data Flow Examples in Appendix D for sample Polling Mode
communications scenarios.

Note: See USB HID Interface on page 3-23 for protocol information relating to USB.

3-8 MS-4 Imager User’s Manual

Communications

RS-422 Status

Usage: RS-232 is an industry standard. RS- 422 is used when greater cable le ngths

are required and/or where noise interference is an issue.

Definition: RS-422, if enabled, allows communication through RS-422 I/O lines.

When RS-422 is enabled, RS-232 is disabled.
When RS-422 is disabled, RS-232 is enabled.

Serial Cmd: <K102,status>
Default: Disabled
Options: 0 = Disabled 1 = Enabled

Note: The default setting can only be changed in readers with multiplexed RS-232 / RS-422
ports. It is forced to 1 (enabled) in readers with “d edicated” RS-422 por ts.

Note: The USB version of the MS-4 does not support RS-422.

MS-4 Imager User’s Manual 3-9

Auxiliary Port Connections

Auxiliary Port Connections

The auxiliary port offers an alternative port that can be configured to communicate by
RS232 in several modes, including daisy chain.

As with the host port parameters, the auxiliary port settings (baud rate, parity, stop bits,
and data bits) must be identical with those of the auxiliary device.

Usage: An auxiliary port connects the Imager to a remote display or to other readers

that can display or transfer data.

Definition: These commands set the communication parameters with the auxiliary

port, which can be used to configure menus, send data to the host, display
data transmissions originating from the host, and relay data from other
Imagers set in tandem (daisy chained).

Auxiliary Port Mode

Usage: Can be used to transfer data faster or to match an auxiliary device.
Definition: Determines the flow of data between the auxiliary port device(s), the

Imager, and the host..

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status, daisy chain i.d.>
Default: Disabled
Options: 0 = Disabled 1 = Transparent 2 = Half duplex

3 = Full duplex 4 = Daisy chain

5 = Command Processing

Baud Rate, Auxiliary Port

Usage: Can be used to transfer data faster or to match an auxiliary device.
Definition: The rate at which the Imager and host transfer data back and forth.
Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>
Default: 115.2K
Options: 0 = 600 1 = 1200 2 = 2400

3 = 4800 4 = 9600 5 = 19.2K

6 = 38.4K 7 = 57.6K 8 = 115.2K

9 = 230K

Parity, Auxiliary Port

Usage: Only changed if necessary to match host setting.
Definition: An error detection routine in which one data bit in each cha racter is set to 1

or 0 so that the total number of 1 bits in the data field is even or odd.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>
Default: None
Options: 0 = None 1 = Even 2 = Odd

3-10 MS-4 Imager User’s Manual

Communications

Stop Bits, Auxiliary Port

Usage: Only changed if necessary to match host setting.
Definition: Allows the user to select the last one or two bits in each character to indicate

the end of the character.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>
Default: One
Options: 0 = One 1 = Two

Data Bits, Auxiliary Port

Usage: Only changed if necessary to match host setting.
Definition: Number of bits in each character.
Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>
Default: Eight
Options: 0 = Seven 1 = Eight

Note: The USB version of the MS-4 does not have an Auxiliary Port.

MS-4 Imager User’s Manual 3-11

Auxiliary Port Connections

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Transparent Mode

Usage: A common application, in conjunction with handheld Imagers, is one that

employs an auxiliary readout to detect misapplied symbols.

Definition: In Transparent Mode, data is passed between the auxiliary port and the

host. The Imager buffers data from the auxiliary port and echoes the keyed
data on the auxiliary port.

• Auxiliary port data is passed through to the
host whenever a return key is pressed at the
auxiliary port or whenever symbol data is
sent. If sent with symbol data, it is processed
on a first-in/first-out basis.

• Auxiliary port data to the host is always sent
with a preamble and postamble.

• If the Imager is in a polling mode with the
host, auxiliary port data will still pass
through.

Data Originating from the Imager

• Transmission to the auxiliary port occurs
immediately upon a good read.

• Data sent to the auxiliary port does not include
a preamble or a postamble.

• Communications with the auxiliary port is
always in Point-to-Point protocol, even if the
host is in a polled protocol mode.

Data Originating from the Host

• All host data is echoed to the auxiliary port in
unpolled mode.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

Options: 1 = Transparent

status,daisy chain i.d.>

3-12 MS-4 Imager User’s Manual

Communications

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Half Duplex Mode

Usage: Useful when the user wants symbol data displayed on an auxiliary menu

close to the Imager.

Definition: In Half Duplex Mode all auxiliary port dat a and symbol data is sent directly

to the host. Symbol data is displayed on the auxiliary port menu at the
same time the data is sent to the host.

Data Originating from the Auxiliary Port

• Auxiliary port data to the host is ignored if the
Imager is in a polled mode.

• Auxiliary port data or read data is sent to the

host whenever it is received.

• Auxiliary port data is not echoed.

• Auxiliary port data to the host is always sent

without a preamble or postamble.

Data Originating from the Imager

• Data is transmitted to the auxiliary port at the

same time it is transmitted to the host.

• Data transmission conforms with all parameters

specified in the configuration menu (e.g. Preamble
Postamble, End of Read Cycle).

,

Data Originating from the Host

• All host data is echoed to the auxiliary port in

unpolled mode.

Serial Cmd. <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>

Options: 2 = Half Duplex

MS-4 Imager User’s Manual 3-13

Auxiliary Port Connections

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Host

Aux.
Port

Imager

Full Duplex Mode

Usage: When communication to and from the auxiliary port is required.
Definition: In Full Duplex Mode all auxiliary port data and symbol dat a is sent directly

to the host. Symbol data is not displayed on the auxiliary port menu.

Data Originating from the Auxiliary Port

• Auxiliary port data to the host is ignored if the
Imager is in a polled mode.

• Auxiliary port data or read data is sent to the
host whenever it is received.

• Auxiliary port data is not echoed.

•

Auxiliary port data to the host is always sent
without

Data Originating from the Imager

• Data is not sent to the auxiliary port.

a preamble or postamble.

Data Originating from the Host

• All host data is echoed to the auxiliary port in

unpolled mode.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>

Options: 3 = Full Duplex

3-14 MS-4 Imager User’s Manual

Communications

Daisy Chain Mode

Usage: Useful in applications where:

• More than one symbol type is present.

• A symbol may be present on multiple sides of a package.

• Symbols are presented at different depths.

Definition: In a daisy chain application, readers are connected in tandem or a “daisy

chain” and decoded data is relayed from one reader to another until the
data reaches the host.

A primary reader has its host port linked to the host computer and its auxiliary
port linked to the host port of the first secondary reader in the chain.
Thereafter, each secondary reader’s auxiliary port is linked to the host port
of the secondary reader that is farther from the host in the daisy chain.

Each reader in the chain can be assigned an ID that accomp anies any data
that it sends.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>
Options: 4 = Daisy Chain
Function: Before the primary reader times out, it checks its auxiliary port for data. It

should be set to wait at least 30 mS for each secondary reade r in the d aisy

chain. If no data is received within the read cycle timeout, the primary

reader sends a No Read message to th e host. Otherwise the complete dat a

is sent.

If, for example, the primary reader is set to timeout in 120 mS, the first

secondary reader reader downstream might be se t to 90 mS, the next to 30

mS, and so forth, thus assuring that at least 30 mS elapses between

transmissions.

Daisy-chained readers can send a series of symbols by enabling

and a common multisymbol separator. If the primary reader does not

receive the expected number of symb o ls, No Re ad me ssage s ar e

appended to the dat a string to make up the dif f erence between the n umber

of symbols enabled in Multisymbol and the number of symbols read.

For example, a primary and two secondary readers have Number of

Symbols set to 3 and Multisymbol Separator defined as %. If the primary

and the first secondary reader do not find symbols, but the next secondary

reader registers a good read, the transmitted results would be:

symbol data % No Read % No Read

a

Multisymbol

a. The above example assumes a best-case scenario. Other factors, such as baud rate, dynamic focus
timing, number of characters in a given symbol, and the number of secondary readers in the daisy chain
can affect timing and may need to be included in your calculations for complete accuracy.

MS-4 Imager User’s Manual 3-15

Auxiliary Port Connections

Command Processing Mode

Usage: Allows a user to send configuration settings from the host port to the auxiliary

port.

Definition: When enabled, Command Processing Mode allows commands to be

entered via the auxiliary port and direct externally triggered read cycle data
in one of two ways:

• Bar code data, including the serial trigger (if used), will be transmitted to
the last port from which a command was sent.

• If the last command came from the host port, then externally triggered
read cycle data will only be output to the host port.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits,daisy chain i.d.

status,daisy chain i.d.>

Options: 5 = Command Processing

3-16 MS-4 Imager User’s Manual

Communications

Daisy Chain ID Status

Usage: Used in a daisy chain setup in cases where the host needs to know which

reader in the chain sent the data.

Definition: Each reader in a daisy chain can be assigned a one or two character ID

that will appear in front of decoded data and identify its source.

Serial Cmd: <K101,aux port mode,baud rate,parity,stop bits,data bits, daisy chain i.d.

status, daisy chain i.d.>

Default: Disabled
Options: 0 = Disabled 1 = Enabled

Note: Enable/disable and length must be the same in all readers.

Daisy Chain ID

Usage: Used in a daisy chain setup in cases where the host needs to know which

reader in the chain sent the data.

Definition:

Serial Cmd:

A one or two character prefix which identifies the particular daisy chain
reader from which the data is being sent to the host.

<K101,aux port mode,baud rate,parity,stop bits,data bits,da isy chain i.d.

status,daisy chain i.d.>

Default: 1/
Options: Any one or two ASCII characters.

Important:

For <: <K101h,,,,,,,3C>
For >: <K101h,,,,,,,3E>

, : <K101h,,,,,,,2C>

For

See ASCII Character Entry Modifier on page 3-32 for a detailed explana tion of how to
enter ASCII characters as hex values.

The ASCII characters <, >, and , can only be entered as hex pairs:

MS-4 Imager User’s Manual 3-17

Auxiliary Port System Data Status

Auxiliary Port System Data Status

Definition: When enabled, system data will be routed to the Auxiliary Port. This

includes decoded data and diagnostic warning messages.
When disabled, system data will not be routed to the Auxiliary Port.

Serial Cmd: <K146,aux port system data status>
Default: Disabled
Options: 0 = Disabled 1 = Enabled

Note: The USB version of the MS-4 does not have an Auxiliary Port.

3-18 MS-4 Imager User’s Manual

Communications

Host

Primary

Imager

Secondary

Imager

Secondary

Imager

SSS

Host

Primary

Imager

Secondary

Imager

Secondary

Imager

ESS

Daisy Chain Autoconfigure

Usage: For quick setup and configuration of your da isy c hai n netw or k.
Definition: The command to autoconfigure the daisy chain is sent to the primary

Imager and the software respo nds in the following ways:

• Counts the number of secondary readers in the daisy chain.

• Assigns an internal ID number (1...n) to each secondary reader, where
the first secondary reader is number 1 (the primary reader’s ID being a 0).

• Propagates the communications settings and the relevant operating
modes of the primary Imager to the host and auxiliary ports of each
secondary reader.

• Resets each secondary reader.

• Verifies that each secondary reader has acquired the new settings.

Serial Cmd: <K150DAISY>

Note: All secondary readers must be set to Serial for Daisy Chain to function.
When setting up a daisy chain operation, perform the following steps:

1. Set the primary Imager (the one connected to the host) to Serial.
This sets all the Imagers in the chain to Serial when the command is executed.

Before Autoconfigure you must set the primary Imager to Serial (S):

2. Send <K150DAISY>.

3. If necessary, set the primary Imager to Edge.
After

Autoconfigure

must remain in

you may set the primary Imager to

Serial (S

):

Edge (E

), but the other Imagers

Note: The USB version of the MS-4 does not support this command.

MS-4 Imager User’s Manual 3-19

Response Timeout

Response Timeout

Usage: Only used when a response is required from the host. While in Multidrop, if

the Imager does not receive an ACK or NAK from the host after sending
polled data, it will act on a fault. The reader can be set to wait indefinitely by
setting Response Timeout to zero.

Definition: The time that the Imager will wait before timing out if ACK, NAK, and ETX

are enabled, and a host response is expected.

Serial Cmd: <K143,response timeout>
Default: 12 (in 1mS increments)
Options: 0 to 255 (A zero (0) setting causes an indefinite wait.)

Note: See USB HID Interface on page 3-23 for protocol information relating to USB.

3-20 MS-4 Imager User’s Manual

Communications

LRC Status

(Longitudinal Redundancy Check)

Usage: Used when extra data integrity is required.
Definition: An error-checking routine that verifies the accuracy of transmissions. It is

the exclusive OR of all characters following the STX (start of text) up to
and including the ETX (end of text). What this means is that the binary
representation of all the characters in a transmission are cumulatively
added in a column and each resulting odd integer is assign ed a 1 and
each even integer a 0 (two 1s = 0, two 0s = 0, a 1 and a 0 = 1). The extra
LRC character is then appended to the transmission, and the receiver
(usually the host) performs the same addition and compares the results.

Serial Cmd: <K145,status>
Default: Disabled
Options: 0 = Disabled 1 = Enabled

Note: The USB version of the MS-4 does not support this command.

MS-4 Imager User’s Manual 3-21

Protocol Configuration Examples

Protocol Configuration Examples

Point-to-Point (Main Port)

<K100,8,0,1,1> Baud Rate: 115.2K; Parity: None; Stop Bits: 2; Data Bits: 8
<K140,0> Point-to-Point
<K102,0> RS-232 enabled; <K102,1> = RS-422 enabled

Polling Mode (Main Port)

<K100,4,0,1,1> Baud Rate: 9600; Parity: None; Stop Bits: 2; Data Bits: 8
<K140,5,23> Polling Mode; Address: 23
<K102,0> RS-232 Point-to-Point polling
<K143,30> 30 mS Response Timeout

“User-Defined” Polling Mode (Main Port)

<K100,4,0,1,1> Baud Rate: 9600; Parity: None; Stop Bits: 2; Data Bits: 8
<K140,5,12> Polling Mode; Address: 12
<K148,,08,09,18,0B,0C,0D> Default RES (0x04), REQ=0x08; EOT=0x09; STX=0x18;

ETX=0x0B; ACK=0x0C; NAK=0x0D

<K102,0> RS-232 Point-to-Point polling
<K143,40> 40 mS Response Timeout

ACK / NAK (Main Port)

<K100,9,0,1,1> Baud Rate: 230K; Parity: None; Stop Bits: 2; Data Bits: 8
<K140,4> ACK/NAK
<K147,,,01,1B,2E,1F> Default RES and REQ (00, disabled); STX=0x01; ETX=0x1B;

ACK=0x2E; NAK=0x1F

<K102,1> RS-422 enabled; <K102,0> = RS-232 enabled
<K143,50> 50 mS Response Timeout

Auxiliary Port

Listed below are several examples of Auxiliary Port commands.

<K101,2,4,0,1,1> Half Duplex; Baud Rate: 9600; Parity: None; Stop Bits: 2; Data Bits: 8
<K101,1,5,0,1,1> Transparent; Baud Rate: 19.2K; Parity: None; Stop Bits: 2; Data Bits: 8
<K101,3,7,0,1,1> Full Duplex; Baud Rate: 57.6K; Parity: None; Stop Bits: 2; Data Bits: 8
<K101,5,6,0,1,1> Command Processing; Baud Rate: 230K; Parity:

Data Bits: 8

3-22 MS-4 Imager User’s Manual

None; S

top Bits: 2;

Communications

USB HID Interface

The USB version of the MS-4 Imager operates as an HID (Human Interface Device) on the USB
bus. HID-class devices communicate via “report” packets. An HID may support multiple report
types, each of which is identified with a unique report ID. The MS-4 supports two different report
types:

• Microscan HID Report (ID = 1)

• Keyboard Report (ID = 2)
The Imager always outputs the same data for both report types. The user may enable or

disable either report type.
Regardless of the report type used by the host application, the application protocol via USB

is identical to RS-232 / RS-422 ports. HID Reports are used as a channel for standard
Microscan Imager communication, command input, and symbol data output.

Important: No matter how the Imager is configured, it is always able to receive and
respond to commands from the host application using Microscan HID Reports.

MS-4 Imager User’s Manual 3-23

USB HID Interface

Report Options

The following functionality conditions hold true regardless of how

1. The host application must establish a connection with the Imager to receive Microscan
HID IN Reports (symbol data) and to send Microscan HID OUT Reports (commands,
serial triggers).

2. The Imager can always receive

3. The host application can always send commands th rough Microscan HID OUT
Reports. If the command requires a response (a part number, for example), the
Imager will always send the response through Microscan HID IN Reports.

4. The Imager always ignores Keyboard OUT Reports sent by the host operating system.

5. The content of both the Keyboard Reports and Microscan HID IN Reports is identical,
except for Keyboard Reports non-printable data limitations.

Microscan HID OUT Reports

HID Reports

(commands, serial triggers).

are configured:

Microscan HID IN Reports

HID Reports are used as a channel for standard Microscan Imager communication,
command input, and symbol data output. There are two types of Microscan HID
Reports:

Report Type Data Content

Microscan HID IN (Imager to host)
Microscan HID OUT (host to Imager) Commands; serial triggers

Symbol data; No Reads; Service messages

Note: The Imager is always able to receive commands and serial triggers from the host
through Microscan HID OUT Reports, regardless of the Microscan HID IN Report status.
If the Imager receives a command that requests a response, such as a p art number query,
the Imager will send a Microscan HID IN Report regardless of the IN Report status.

Serial Cmd: <K149,Microscan HID IN Report status,Keyboard IN Report status>
Default: 1
Options:

0 = Disabled 1 = Enabled

Microscan HID IN Reports Enabled

When this feature is enabled, the Imager will send Microscan HID IN Reports to the host,
containing data originated by the Imager.

Microscan HID IN Reports Disabled

When this feature is disabled, the Imager will not send
host, containing data originated by the Imager.

Microscan HID IN Reports

to the

3-24 MS-4 Imager User’s Manual

Keyboard IN Reports

Communications

The host operating system will interpret
user were typing keyboard text. The host op erating system send s keystrokes to the cu rrent
application. This is commonly called a

There is one type of Keyboard Report used:

Report Type Data Content

Keyboard IN (Imager to host)

Note: If Keyboard IN Reports is enabled, and Micro scan HID IN Reports is disabled,
the read cycle must be Continuous Read 1 Output, because there will be no External

Trigger or Serial Trigger. It is not possible to send commands to the Imager as Keyboard
OUT Reports. To send commands to the Imager via USB, the host application must
establish a connection with the Imager and send Microscan HID OUT Reports.

Serial Cmd: <K149,Microscan HID IN Report status,Keyboard IN Report status>
Default: 0

Options: 0 = Disabled 1 = Enabled

Keyboard IN Reports

Keyboard Wedge

Symbol data; No Reads; Service messages

from the Imager as if the

configuration.

Keyboard IN Reports Enabled

When this feature is enabled, the Imager will send Keyboard IN Reports to the host,
containing data originated by the Imager.

Keyboard IN Reports Disabled

When this feature is disabled, the Imager will not send Keyboard IN Reports to the host,
containing data originated by the Imager.

MS-4 Imager User’s Manual 3-25

USB HID Interface

Microscan HID Report Format

Size: 64 bytes, fixed-length. The USB HID standard defines all reports as being fixed-length.
Structure: REPORT ID (1) LENGTH (1) DATA (62)

Values in parentheses indicate the size, in bytes, of the field.

Field Descriptions

REPORT ID

Size: 1 byte
Value: 0x01

Note: Report ID is the method employed by USB HID to allow multiple report formats to be
sent and received from the same interface.

LENGTH

Size: 1 byte
Value: 0-62

Note: Length indicates the number of valid data bytes in the fixed-length data field. This is
necessary because the USB HID standards define HID Reports as fixed-length, yet the
Imager or host may require a smaller data size in any given report.

DATA

Size: 62 bytes, fixed-length
Value: 0x00 to 0xFF

Note: The Data field is left-justified, mean ing it begins immediately after the Length field.
All unused data space is NUL (0x00) padded. Data values can be “binary” , meaning that
they span the entire 8 bit range of 0x00 to 0xFF.

3-26 MS-4 Imager User’s Manual

Communications

Report Format Examples

For clarity, all report format examples are shown as follows: report fields separated by an
underscore ( _ ), REPORT ID and LENGTH fields shown as decimal values, data fields
shown as printable ASCII characters, and the number of NUL padding bytes shown as
decimal values (nn).

IN report (to host)

1_11_A]002374938 (51)
REPORT ID = 1 = Microscan HID
LENGTH = 11
DATA = ”A]02374938” = This is a Code 39 symbol.
NUL padding = 51 bytes

OUT report (from host to Imager)

1_27_<K200,3><K220,0,300><K714?> (35)
REPORT ID = 1 = Microscan HID
LENGTH = 27
DA TA = “<K200,3><K220,0,300><K714?>” = These commands enable External Edge, set

a 3 second timeout, and request the No Read configuration command.
NUL padding = 35 bytes

IN report (to host)

1_62_<K714,1, A LONG MESSAGE STREAMED OVER MULTIPLE MICROSCAN HID RE (0)
REPORT ID = 1 = Microscan HID
LENGTH = 62
DA TA = “<K714,1, A LONG MESSAGE STREAMED OVER MULTIPLE MICROSCAN HID

RE” = This shows the response to the <714?> command. Note that the command status
response is not yet complete. See the next report example for the complete response.

NUL padding = 0 bytes

IN report (to host)

1_6_PORTS>(56)
REPORT ID = 1 = Microscan HID
LENGTH = 6
DATA = “PORTS>” = This is the end of the response to the <K714?> command from the

previous example.
The entire <K714> command response is as follows:
DATA = “K714,1, A LONG MESSAGE STREAMED OVER MULTIPLE MICROSCAN HID

REPORTS>” .
NUL padding = 56 bytes

MS-4 Imager User’s Manual 3-27

USB HID Interface

Keyboard Report Format

Size: 9 bytes, fixed-length.
Structure: REPORT ID (1) MODIFIER (1) RESERVED (1) KEYCODES (6)

Values in parentheses indicate the size, in bytes, of the field.

Important: The host application does not need to understand and process Keyboard
Reports. This task be longs to the host operating system. Keyco des are passed to the host

application as if a user were typing keyboard text. The host application must be the active
application in order to receive keystrokes.

Keyboard Reports protocol requires that two reports be sent for every keystroke. The first
report indicates which key is pressed. The second report indicates “no key pressed”, with
all keycodes NUL (0x00) to indicate that all keys have been released. In the case of the
MS-4 Imager, each byte output is equivalent to a keystroke, with a “key pressed” report
and a “no key pressed” report. For this reason, data rates are much slower when using
Keyboard Reports.

Field Descriptions

REPORT ID

Size: 1 byte
Value: 0x02

Note: Report ID is the method employed by USB HID to allow multiple report formats to be
sent and received from the same interface.

MODIFIER

Size: 1 byte
Value: 0x00 to 0xFF

Note: Modifier is an 8 bit field, corresponding to the state of the modifier keys at the time
the keycode field was generated.

Bit Key

0 LEFT CTRL
1 LEFT SHIFT
2 LEFT ALT
3LEFT GUI
4 RIGHT CTRL
5 RIGHT SHIFT
6 RIGHT ALT
7 RIGHT GUI

3-28 MS-4 Imager User’s Manual

Communications

Field Descriptions

RESERVED

Size: 1 byte
Value: 0x00

Note: This field is Reserved. Its value is always NUL (0x00).
KEYCODES

Size: 6 bytes
Value: 0x00 to 0xFF

Note:

The MS-4 Imager translates 8 bit data values into

8 Bit Data Value Keycode Data

0x00 to 0x1F and 0x7F to 0xFF Decimal key ( . ) unless otherwise noted.
CR, 0x0D Enter key
TAB, 0x09 Tab key
ESC, 0x1B ESC key
“Printable” characters, 0x20 to 0x7E These all translate to the keystrokes that produce them.

This includes a-z, 0-9, punctuation, and SHIFT in the
Modifier field, when necessary. Only the first Keycode
in the 6 byte array will be populated.

Keycode

data in the following ways:

MS-4 Imager User’s Manual 3-29

USB HID Interface

USB HID Configuration Options

The user has the following options for configuring and defaulting a USB version of the MS-4:

Configuration Symbols (Data Matrix with “Configure Reader” Flag)

Symbol configuration can be performed “out-of-the-box”, as the MS-4 is configured for
Continuous Read Mode, and Data Matrix is enab led by defa ult. Data Matrix symbols are
used to encode configuration commands when the symbology’s “configure reader” flag is
set.

If the read cycle is changed, or if Data Matrix is disabled, another configuration/default
method must be used. This is because the USB MS-4 has no external trigger, unless the
user has configured the EZ button as a trigger.

EZ Button Configuration

By default, basic calibration can be initiated from the EZ button (3 beeps). Note that this
only changes the camera, image processing, and symbology settings of the Imager. To
default the USB MS-4, hold down the EZ button during power-on.

Note: This only overwrites Power-On settings with Custom Default settings, as when the

<Zrc> command is received. It does not overwrite Power-On settings with Factory

Defaults, as when the <Zrd> command is received. If Custom Defaults are misconfigure d,
another method must be used to default the Imager.

Implementing the Host Operating System API and Establishing a
Connection with the Microscan HID Interface

When a connection is made, the host can send serial configuration/default commands. The
Imager will always be able to receive configuration commands from the host application and
send responses to those commands. However, the Imager can be configured to stop producing
IN Reports to the host from symbol data output and diagnostics (service messages).

3-30 MS-4 Imager User’s Manual

Communications

Configuration Exceptions for USB

Read Cycle Mode

By default, the Imager operates in Continuous Read Mode. If the Imager is configured
using Data Matrix symbols, the read cycle mode should be the last item changed before
saving the configuration settings and beginning operation. This is because all read cycle

modes other than Continuous Read Mode require a trigger event. In USB, a trigger event
can only be initiated by serial command. To send a trigger command the Imager, the host
application must establish a connection with the Imager’s Microscan HID interface and
send the trigger command in a Microscan HID Report.

The following read cycle conditions are required for USB MS-4:

Serial Cmd: <K200,read mode>
Default: Continuous
Options: 0 = Continuous Mode 1 = Coninuous Read 1 Output Mode

2 = Level Mode 3 = Edge Mode
4 = Serial Mode 5 = Serial and Edge Mode

Important:

• To use Level Mode, you must enable Undelimited Start Trigger Character <K229>
and Undelimited End Trigger Character <K230>.

• To use Edge Mode, you must enable and use the Undelimited St art Trigger Character

<K229>.

• To use Serial Mode, you must use the Delimited Trigger defined by <K201>, or enable
and use the Undelimited Start Trigger Character <K229>.

• To use Serial and Edge Mode, you must use the Delimited Trigger defined by

<K201>, or enable and use the Undelimited Start Trigger Character <K229>.

Communications

For the USB version of MS-4, no communications serial co mmands have any effect on the
Imager except the following:

• USB HID Report Status <K149>

• Preamble <K141>

•Postamble <K142>

EZ Button

Default on power-on cannot be disabled <K770,,default> = <K770,,1>. This ensures a
level of safety for recovering from misconfigured Power-On settings <Z>. However , it is not
foolproof, as defaulting with the EZ button only recovers Custom Default settings, which
can be misconfigured themselves. For this reason, do not save to Custom Default settings

<Zc> until the Imager’s configuration has been tested.

Symbologies

If the Imager is going to be configured with Data Matrix symbols, do not disable Data Matrix

<K479>. Disabling Data Matrix will prevent the Imager from reading configuration symbols.

MS-4 Imager User’s Manual 3-31

ASCII Character Entry Modifier

ASCII Character Entry Modifier

Commands that require ASCII text fields, such as
be sent to the Imager as hex value pairs (see Appendix E,

Serial Cmd Format: <Knnnh,00-FF>

To enter ASCII fields as hex values (00 to FF), add a lower-case h directly after the command’s

K

number, and then enter the hex value that corresponds with the desired ASCII character.

Example:

Consider the Postamble command:

Serial Cmd: <K142,status,postamble character(s)>

Imagine that your application require s th e ASCII char a cte r > to be the postamble in your
symbol decode output.

The ASCII characters <, >, and
postamble in your symbol decode output, enter the Postamble command as follows:

, can only be entered as hex pairs. So, to make > the

Preamble

and

Postamble

ASCII Table

commands, can

, for conversions).

<K142h,,3E>

Note that the “status” field contains only a
changed is the “postamble character(s)” field. (See Serial Configuration Command

Conventions on page A-10 for a more detailed explanation of this command shortcut.)

, . This is because the only field that is being

3-32 MS-4 Imager User’s Manual

Communications

Preamble

Preamble Status

Usage: Useful for identifying and controlling incoming data. For example, defining

the preamble as a carriage return and a line feed causes each decoded
message to be displayed on its own line.

Definition: Defines a one to four character d at a strin g that can b e added to th e fr ont of

the decoded data.

Serial Cmd: <K141,status,preamble character(s)>
Default: Disabled
Options: 0 = Disabled 1 = Enabled (within any protocol)

Preamble Characters

Serial Cmd: <K141,status,preamble character(s)>
Default: ^M corresponds to: carriage return.
Options: To enter control characters within a serial command, hold down the Ctrl

key while typing the desired character.

Example: <K141,1,CNTL-m> to enter the control character ^M.

Important:

For <: <K141h,,3C>
For >: <K141h,,3E>

, : <K141h,,2C>

For

See ASCII Character Entry Modifier on page 3-32 for a detailed explana tion of how to
enter ASCII characters as hex values.

The ASCII characters <, >, and , can only be entered as hex pairs:

MS-4 Imager User’s Manual 3-33

Postamble

Postamble

Postamble Status

Usage: Useful for identifying and controlling incoming data. For example, defining

the postamble as a carriage return and a line feed causes each decoded
message to be displayed on its own line.

Definition: Allows the user to enable or disable up to four postamble characters that

can be added to the end of the decoded data.

Serial Cmd: <K142,status,postamble character(s)>
Default: Enabled
Options: 0 = Disabled 1 = Enabled (within any protocol)

Postamble Characters

Serial Cmd: <K142,status,postamble character(s)>
Default: ^M^J corresponds to carriage return/line feed.
Options: To enter control characters within a serial command, hold down the control

key while typing the desired character.

Example: <K142,1,CNTL-m CNTL-j> to enter ^M^J.

Important:

For <: <K142h,,3C>
For >: <K142h,,3E>

, : <K142h,,2C>

For

See ASCII Character Entry Modifier on page 3-32 for a detailed explanation of how to
enter ASCII characters as hex values.

The ASCII characters <, >, and , can only be entered as hex pairs:

3-34 MS-4 Imager User’s Manual

4 Calibration

Calibration Serial Commands............................. ..........................................................................4-2

Calibration Overview............................. ............................................................. ... ... .....................4-2

Calibration Options ................................................ .. ... ............................... ... ... .............................4-3

Calibration by ESP...................................................... ... ............................... ... .. .........................4-10

Initiating Calibration ............................................... .............................. ... ... .................................4-12

Additional Notes about Calibration..............................................................................................4-17

Contents

This section shows the MS-4 Imager’s calibration options and their default settings.

MS-4 Imager User’s Manual 4-1

Calibration Serial Commands

Calibration Serial Commands

Calibration Options <K529,gain,shutter speed,symbol type,WOI framing,WOI

margin,line scan height,processing>

Autocalibrate

<

@CAL

>

Calibration Overview

Autocalibration is one of the most powerful features of the MS-4 Imager. The calibration

process can be initiated by serial command, EZ button, or ESP user interface.
When the Imager enters calibration, it runs through an optimization cycle that set s the ideal

parameters for reading symbols at the highest possible level of performance. Autocalibration
can be specially configured to optimize specific parameters, such as gain, shutter speed,
and symbol type.

The calibration process consists of a search pass, medium pass, and fine-tune p ass. During
this process the Imager quickly locates configuration setup, defines a calibration range for
the configuration parameters, and then tunes those parameters for optimal p erformance.

4-2 MS-4 Imager User’s Manual

Calibration

Calibration Options

This command specifies the operation of the Imag er’s calibration feature. The default
configuration is set up to perform calibration on gain and symbol type. The default shutter
speed setting is disabled, because not all applications require shutter speed, and when it
is required, the application-specific settings tend to vary widely.

Note: Background Color (page 6-35) is part of the calibration process regardless of the
calibration setup. After successful completion of the calibration routine, the background
color will be set to the appropriate value, depending on the symbol in the field of view. The

Mirrored Image parameter (p age 10-2 8) is n ot part of the calibration process, and it must

be configured appropriately prior to calibration.

Gain

Definition: When enabled, gain will be calibrated to provide the best available image

quality and performance.
When disabled, gain is fixed and is not part of the calibration process.

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line

scan height,processing>
Default: Enabled
Options: 0 = Disabled 1 = Enabled

MS-4 Imager User’s Manual 4-3

Calibration Options

Shutter Speed

Definition:

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line
Default: Disabled

Options: 0 = Disabled 1 = Enabled

Note:

various line speeds. The configurations shown depend on the Imager’s optical configuration,
and on symbol element size.

The following table shows general guidelines for shutter speed configurations based on

Shutter Speed L ine Speed

0 - 250 static
250 - 750 5” / sec
750 - 1500 10” / sec
1500 - 2000 15” / sec
2000 - 2500 20” / sec

Unless an application is a static setup, the shutter speed setting should be
configured by the user based on the application. For dynamic applications, the
user should configure the shutter speed setting so the calibration process can
optimize the gain for that setting.

scan height,processing>

2 = Fast Shutter

Shutter Speed Disabled

When this feature is disabled, the shutter speed is fixed and is not part of the calibration
process.

Shutter Speed Enabled

When this feature is enabled, shutter speed will be calibrated to provide the best possible
image quality and performance.

Fast Shutter

The calibration process will concentrate on achieving the fastest possible shutter setting that
will still provide good performance. The image quality or contrast may not be as good as
what would be achieved with the Enabled setting. The calibration process is not designed to
choose the fastest shutter speed that can decode a symbol, but rather to optimize for the
fastest shutter speed that still provides good image quality.

4-4 MS-4 Imager User’s Manual

Calibration

Symbol Type

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line

scan height,processing>
Default: Enabled
Options: 0 = Disabled 1 = Enabled

Symbol Type Disabled

When this feature is disabled, only the currently-enabled symbologies will be considered
during the calibration process.

Symbol Type Enabled

When this feature is enabled, autodiscrimination will be in effect during the calibration
process. All symbologies that are readable by the Imager except PDF417 will be considered
during calibration. Any new symbologies successfully decoded duri n g ca lib r ati o n wi l l
remain enabled at the end of the process. All enabled symbologies will remain enabled.

For example, assume that only Code 39 is enabled at the beginning of calibration. If a
Code 128 symbol is read during calibration, then Code 128, as well as Code 39, will be
enabled after the calibration process is complete.

MS-4 Imager User’s Manual 4-5

Calibration Options

Configured WOI

Starting WOI

After Decode

Calibration Passed

Calibration Failed

Configured WOI

After Decode

Calibration Passed Calibration Failed

Window of Interest (WOI) Framing

Definition: If a WOI framing mode is enabled, it will set the camera WOI to a full-size

image when calibration begins. Once a symbol is decoded, the camera
WOI will be re-sized both vertically and horizontally (regardless of which
WOI mode is enabled) to include the symbol plus an additional margin
area. This is done to accelerate the calibration process.

When a successful calibration process is completed, the camera WOI
will be adjusted according to the mode enabled. Otherwise, the original
WOI configuration will be retained.

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line

scan height,processing>
Default: Disabled
Options: 0 = Disabled 1 = Row and Column

2 = Row 3 = Column

4 = Straight Line 5 = Straight Line Framed

If WOI framing is not enabled, the current WOI configuration will be used until a symbol
has been decoded. After a symbol is decoded, the WOI is framed exactly as it would be if
a WOI framing mode was enabled. When the calibration process is complete, the original
WOI configuration is restored. Refer to the diagram below:

4-6 MS-4 Imager User’s Manual

Calibration

Window of Interest Framing Disabled

When this feature is disabled, the Window of Interest is not modified after the calibration
process is complete.

Row and Column

If the calibration process is successful, the Window of Interest will be modified to frame the
symbol as well as an additional margin area around the symbol, determined by the WOI

Margin parameter. Refer to the diagram below:

Column

If the calibration process is successful, the Window of Interest columns will be modified to
vertically frame the symbol, plus an additional margin ar ea around the symbol, d etermined
by the WOI Margin parameter. Refer to the diagram below:

Row

I

f the calibration process is successful, the Window of Interest rows will be modified to horiz ontally

frame the symbol, plus an additional margin area around the symbol, determined by the

Margin

MS-4 Imager User’s Manual 4-7

parameter. Refer to the diag ram below:

WOI

Calibration Options

Straight Line

This feature is intended for use with linear symbologies. If the calibration process is successful,
the orientation of the symbol is determined and the Window of Interest is modified according
to the symbol orientation. The scan line orientation is determined to be vertical if th e
symbol tilt is between 225° and 315°, or between 45° and 135°. Otherwise, the scan line
will be horizontal.

If the symbol is vertical, the image column size will be set by the scan height parameter,
and will be configured for full row resolution. If the symbol is horizontal, the image row size
will be set by the scan height parameter, and will be configured for full column resolution.
The scan line will be centered in the middle of the symbol. If the symbol is tilted such that
the scan line will not pass completely through the symbol, the scan width will be adjusted
to include the entire symbol. Refer to the diagram below:

Straight Line Framed

This parameter is the same as “Straight Line”, except that the Window of Interest will also
frame the scan line on the symbol length as well. The scan line includes the symbol plus
an additional margin area determined by the WOI Margin parameter.

4-8 MS-4 Imager User’s Manual

Window of Interest (WOI) Margin

Calibration

Definition:

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line
Default: 75 (pixels)

Options: 20 to 640

Sets the margin size that is applied to the calibrated symbol. This parameter
is expressed in number of pixels. If the margin causes the image to exceed
the maximum image size, it will be reduced accordingly.

scan height,processing>

Line Scan Height

Definition: This parameter is only used with the S traight Line modes. It sets the scan

height of the straight-line image, and it is expressed in number of pixels.

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line

scan height,processing>

Default: 64 (pixels)
Options: 3 to 480

Processing

Definition: This setting defines the amount of time and effort the Imager will spend

attempting to decode a symbol for each parameter configuration.

Serial Cmd: <K529,gain,shutter speed,symbol type,WOI framing,WOI margin,line

scan height,processing>
Default: Medium
Options: 0 = Low 1 = Medium

2 = High 3 = Definable

Low

The Imager will spend a low amount of effort attempting to decode the given symbol for
each parameter configuration.

Medium

The Imager will spend a medium amount of effort attempting to decode the given symbol
for each parameter configuration.

High

The Imager will spend a high amount of effort attempting to decode the given symbol for
each parameter configuration.

Definable

The processing time for each image frame is defined by the Image Processing Timeout
parameter <K245>.

MS-4 Imager User’s Manual 4-9

Calibration by ESP

Determines the
amount of time
and effort the
Imager will spend
attempting to
decode a symbol
for each parameter
configuration.
(Low, Medium,
High, Definable).

Initiates the
calibration
routine.

Shutter, Gain,
and Image
Quality values
are all tracked in
real-time during
the calibration
process.

The Window of Interest section of the Calibration interface allows the user to make precise adjustments
to WOI Framing, WOI Margin (in pixels), and the scan height of the straight-line image (in pixels).

Gain and Shutter Speed
are configurable in the

Calibration interface.

Before and After tabs give the user an authentic

representation of the difference in what the Imager
“sees” before and after the calibration routine.

Dropdown menu of 1D and 2D symbologies, and a check
box for enabling or disabling Composite symbologies.

Cancels the
calibration
process, if
necessary.

Calibration by ESP

ESP’s Calibration view incorporates all the functionality of the <K529> (Calibration
Options) command in a single easy-to-use, intuitive interface. This calibration process

allows the user much finer control of individual parameters than the calibration routine in
EZ Mode or on the Video tab.

Before / During Calibration

4-10 MS-4 Imager User’s Manual

After Calibration

Notice the improved image
resolution after the calibration
process is complete.

The calibration
progress bar
indicates that
the process has
been completed.

Saves the optimal configuration parameters
determined by calibration results.

The

Shutter, Gain

, and

Quality

indicator bars
remain stationary at the end
of calibration to provide a
visual reference for the final
values of these parameters.

Calibration

MS-4 Imager User’s Manual 4-11

Initiating Calibration

Initiating Calibration

Calibration can be initiated by serial command, the EZ button, or from the Calibration
interface in ESP.

In ESP, the Calibrate button starts the calibration routine.

To initiate calibration by serial command, enter the serial command
such as
and readability.

ESP

’s

Terminal

interface.

<@CAL>

is a calibration routine that emphasizes contrast

<@CAL>

from a terminal,

See Calibrate by EZ Button on page 1-10 for the EZ button calibration procedure.

4-12 MS-4 Imager User’s Manual

Calibration

Calibration Progress Indicators

During the calibration process, the Imager has a number of ways to communicate its
progress to the user. The following three types of feedback are the primary ways that the
Imager communicates calibration progress.

Read Rate LEDs

When calibration is initiated through a serial command or the EZ button, the Imag er’s read
rate LEDs indicate calibration progress as follows:

LEDs Calibration Progress

20% Search Pass in progress.
20%, 40%, 60% Medium Pass in progress.
20%, 40%, 60%, 80% Fine-Tune Pass in progress.
20%, 40%, 60%, 80%, 100% Calibrated Successfully (holds for green flash duration).

Beeper / Green Flash

The beeper and green LED flash are used to indicate calibration status as shown in the
table below:

Indicator Status

2 quick beeps Calibration has started.
5 quick beeps Calibration has failed.
1 long beep Calibration has been completed successfully.
1 sec. Green Flash Calibration has been completed successfully.

MS-4 Imager User’s Manual 4-13

Initiating Calibration

Calibration Progress Output to Terminal

When initiated by serial command or EZ button, the autocalibration operation will output
progress and process information to a terminal if the system is configured to do so.

Terminal

Depending upon how the calibration options are configured, the autocalibration process
can have up to 3 steps (Search Pass, Medium Pass, Fine-Tune Pass). Calibration data is
shown in a simple table format under 7 category headings, each o f which are defined
below.

Heading Definition

Prog Progress indicator with a range of 0 - 100. Indicates percent complete.
Rating Rating indicator; higher ratings are more favorable.
Decode Number of successful decodes for the pass.
Quality Quality indicator; higher ratings are more favorable.
Shutter Shutter setting under operation.
Gain Gain setting under operation.
Locate Time required to locate symbol, expressed in milliseconds.

Calibration Progress Output Examples (Terminal)

Search Pass

The purpose of Search Pass is to decode a symbol in as few configurations as possible
during calibration. This process is designed to quickly identify symbology type, and any
image processing parameters that are already calibrated.

Running Search Pass

Prog Rating Decode Quality Shutter Gain Locate

1200025000
1400025090
16 0 0 0 250 18 0
18 2174 1 72 250 27 24

4-14 MS-4 Imager User’s Manual

Calibration

Medium Pass

The theory behind Medium Pass is to develop a readable range from which to dial in a
decoded symbol.

Running Medium Pass

Prog Rating Decode Quality Shutter Gain Locate

51 4216 2 8 250 0 5
53 8436 4 20 250 4 4
55 6336 3 24 250 8 4
57 8448 4 32 250 12 4
59 8456 4 40 250 16 5
61 8464 4 48 250 20 4
63 8472 4 56 250 24 5
65 8488 4 72 250 28 5
67 8504 4 88 250 32 5
69 8512 4 96 250 36 5
71 8528 4 112 250 40 6
73 8584 4 168 250 44 5
75 8644 4 228 250 48 5

Rating List (Best):

Rating = 8606; Shutter = 250; Gain = 48
Rating = 8581; Shutter = 250; Gain = 44
Rating = 8553; Shutter = 250; Gain = 40
Rating = 8527; Shutter = 250; Gain = 36
Rating = 8505; Shutter = 250; Gain = 32

Rating = 8488; Shutter = 250; Gain = 28
Rating = 8476; Shutter = 250; Gain = 24

MS-4 Imager User’s Manual 4-15

Initiating Calibration

Fine-Tune Pass

The theory behind Fine-Tune Pass is to dial in a decoded symbol based on the range
supplied by the Medium Pass.

Running Fine Tune Pass

Prog Rating Decode Quality Shutter Gain Locate

77 6416 3 104 250 38 7
79 6424 3 112 250 39 6
81 6424 3 112 250 40 6
84 6432 3 120 250 41 6
86 6448 3 136 250 42 5
88 6464 3 152 250 43 5
90 6476 3 164 250 44 5
93 6488 3 176 250 45 5
95 6506 3 194 250 46 6
97 6524 3 212 250 47 5

100 6538 3 226 250 48 6

Rating List (Best):
Rating = 6527; Shutter = 250; Gain = 48

Rating = 6517; Shutter = 250; Gain = 47
Rating = 6505; Shutter = 250; Gain = 46
Rating = 6491; Shutter = 250; Gain = 45
Rating = 6476; Shutter = 250; Gain = 44

Rating = 6462; Shutter = 250; Gain = 43
Rating = 6449; Shutter = 250; Gain = 42

Calibration PASSED.

4-16 MS-4 Imager User’s Manual

Calibration

Additional Notes about Calibration

The following conditions apply to the Imager’s calibration process. Some of these items
are noted at various points throughout this section, or in other sections of the Imager’s
documentation.

1. The Mirrored Image parameter <K51 4> is not part of the calibration process.

2. Background Color <K451> is calibrated.

3. If Window of Interest (WOI) Framing is enabled, the WOI will be set to full frame
when calibration begins. If WOI Framing is disabled, the current WO I configura tion
will be used for the Search Pass.

4. IP Mode <K527> will not be altered during calibration.

5.

Threshold Mode <K512>

successful calibration,
previous setting. Otherwise, the value will revert to its original state.

6. If Symbol Type is enabled for calibration (Autodiscriminate), then Interleaved 2 of 5

Range Mode Status (Interle aved 2 of 5) <K472>

Interleaved 2 of 5 symbols to be decoded. If an Interleaved 2 of 5 symbol is decoded
during calibration, then symbol length # 1 will be set to the decoded symbol length at
the end of calibration. Otherwise, the symbol lengths will be restored to their original
configurations.

will be set to

Threshold Mode

Adaptive

will remain set to

during calibration. At the end of a

will be enabled. This allows variable-length

Adaptive

regardless of its

7. The symbol size, dimension, and orientation parameters of the No Symbol Message
and Bad Symbol Message, and 2D Symbology Qualification command <K718>
will be updated if calibration is completed successfully.

8. All symbol types that were enabled before calibration will still be enabled after calibration.
For example, if Data Matrix ECC 200 was enabled before calibration, and the calibration
routine was performed on a Code 128 symbol, then after calibration is completed both
Data Matrix ECC 200 and Code 128 will be enabled.

9. The calibration process does not modify the global Composite status <K453>. The
global Composite status must be configured properly before calibration.

10. If the user requires calibration of a stacked symbology <K482>, <K483>, or <K484>,
that symbology must be enabled and configured appropriately before calibration.

11. UPC Supplementals will be disabled during calibration.

12. The Search Pass process will use the configurable Window of Interest for image cap­tures. However, when the search process is completed, the WOI will be reduced to
include only the symbol of interest and some additional boundary area.

MS-4 Imager User’s Manual 4-17

Additional Notes about Calibration

4-18 MS-4 Imager User’s Manual

Contents

Read Cycle by ESP......................................................................................................................5-2

Read Cycle Serial Commands......................................................................................................5-3

Read Cycle Setup.........................................................................................................................5-4

Multisymbol...................................................................................................................................5-5

Trigger Mode and Duration...........................................................................................................5-6

External Trigger Polarity.............................................................................................................5-11

Serial Trigger..............................................................................................................................5-12

Start Trigger Character (Non-Delimited).....................................................................................5-13

Stop Trigger Character (Non-Delimited).....................................................................................5-13

End of Read Cycle......................................................................................................................5-14

Capture Mode............................................... ... ............................ ............................ ...................5-16

Capture Timing......................... ... ............................ ............................ ............................ ...........5-20

Image Processing Timeout.........................................................................................................5-22

Image Storage............................................................................................................................5-23

Minimum Good Reads................................................................................................................5-25

Setting Up the Imager for EZ Trax..............................................................................................5-26

5 Read Cycle

After you’ve established communications and completed basic read rate testing, you will
need to address the spatial and timing parameters associated with your application. This
section explains those parameters.

MS-4 Imager User’s Manual 5-1

Read Cycle by ESP

Click this button
to bring up the
Read Cycle
menu.

T o change a setti ng,
double click the
setting and use your
cursor to scroll
through the options.

To open nested
options, single click
the +.

Read Cycle by ESP

5-2 MS-4 Imager User’s Manual

Read Cycle

Read Cycle Serial Commands

Trigger Mode/Duration <K200,trigger mode,trigger filter duration>
Serial Trigger Character <K201,serial trigger character>
External Trigger State <K202,exter nal trigger state>
End of Read Cycle <K220,end of read cycle,read cycle timeout>
Minimum Good Reads < K221,minimum good reads>
Multisymbol <K222,number of symbols,multisymbol separator>
Start Trigger Character <K229,start character>
Stop Trigger Character <K230,stop character>
Capture Mode <K241,capture mode,number of captures,rapid capture mode>
Capture Timing <K242,time before first capture,time between first and second

captures,,,,,,,,time between seventh and eighth captures>
Image Storage <K244,image storage type,image store mode>
IP Timeout <K245,image processing timeout>

MS-4 Imager User’s Manual 5-3

Read Cycle Setup

Read Cycle Setup

Setting up read cycle and triggering parameters will involve a series of decisions based on
your particular application, as follows:

1. Select the number of symbols to be read in a single cycle. The M S-4 can read multip le
symbols in a single image frame.

2. Decide on the trigger type to be used: if serial, choose a serial character; if external,
choose either Level or Edge.

3. Designate how the read cycle should end (Timeout, New Trigger, Last Frame).

4. Select Capture Mo de, Contin uous Mod e, or Rapid Mode.

5. Select Number of Captures (if in Rapid Capture Mode).

6. Set the Time Before First Capture and Time Between Captures, if any.

Note: The Imager’s camera captures images at a rate of about 16/second (based on a
full-size 640 x 480 image). The capture rate increases as frame sizes decrease.

Note:

If you need to set up your MS-4 for use with

Imager for EZ Trax.

EZ T rax

software, see

Setting Up the

5-4 MS-4 Imager User’s Manual