Code CR1500 Operating instructions

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 1 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
JavaScript Programming Guide
CR1500, CR1100, and CR2700
July 2019

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 2 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Copyright © 2014 - 2019 Code Corporation.
All Rights Reserved.
The software described in this manual may only be used in accordance with the terms of its license agreement.
No part of this publication may be reproduced in any form, or by any means, without written permission from Code
Corporation. This includes electronic or mechanical means, such as photocopying or recording in information storage and
retrieval systems.
NO WARRANTY. This technical documentation is provided AS-IS. Further, the documentation does not represent a
commitment on the part of Code Corporation. Code Corporation does not warrant that the information is accurate,
complete, or error- free. Any use of the technical documentation is at the risk of the user. Code Corporation reserves the
right to make changes in specifications and other information contained in this document without prior notice. The reader
should consult Code Corporation to determine whether any changes have been made. Code Corporation shall not be liable
for technical or editorial errors or omissions contained herein; nor for incidental or consequential damages resulting from
the furnishing, performance, or use of this material. Code Corporation does not assume any product liability arising out
of, or in connection with, the application or use of any product or application described herein.
NO LICENSE. No license is granted, either by implication, estoppel, or otherwise under any intellectual property rights of
Code Corporation. Any use of hardware, software, and/or technology of Code Corporation is governed by its own
agreement.
The following are trademarks or registered trademarks of Code Corporation:
CodeXML®, Maker, QuickMaker, CodeXML® Maker, CodeXML® Maker Pro, CodeXML® Router, CodeXML® Client SDK,
CodeXML® Filter, HyperPage, CodeTrack, GoCard, GoWeb, ShortCode, GoCode®, Code Router, QuickConnect Code, Rule
Runner®, Cortex®, CortexRM, CortexMobile, Code, Code Reader, CortexAG, CortexStudio, CortexTools, CortexTools2®,
Affinity®, CortexDecoder, CortexJPOS, CR8200 Utility, CR8200 Utility2, and CortexOPOS.
All other product names mentioned in this manual may be trademarks of their respective companies and are hereby
acknowledged.
For patent information, please refer to http://codecorp.com/legal/patents.php.
The Code reader software implements the Mozilla SpiderMonkey JavaScript engine
https://developer.mozilla.org/En/SpiderMonkey/1.8, which is distributed under the terms of the Mozilla Public
License.
The Code reader software is based in part on the work of the Independent JPEG Group.
Code Corporation, 12393 South Gateway Park Place, Suite 600, Draper, UT 84020. www.codecorp.com

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 3 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Table of Contents
13.1 Reader Object..........................................................................................................................................10
Callback Properties......................................................................................................................................................10
reader.onDecodes(Decode Object Array decodes) ...........................................................................................10
reader.onEvent(Event Object event) (CR1100, CR1500) ...................................................................................10
reader.onRawData(data, len) ............................................................................................................................11
reader.onConfigure(string config) .....................................................................................................................11
reader.onPowerChange(int mode)....................................................................................................................12
reader.onBatteryChange(void) ..........................................................................................................................12
reader.onTrigger(triggerButton, buttonAction)(CR2700)..................................................................................12
reader.onDecodeAttempt(count)......................................................................................................................12
reader.periodic(void) .........................................................................................................................................13
reader.tick1Hz(void) ..........................................................................................................................................13
Informational Properties .............................................................................................................................................13
reader.charging..................................................................................................................................................13
reader.green ......................................................................................................................................................13
reader.amber.....................................................................................................................................................13
reader.red..........................................................................................................................................................13
reader.black .......................................................................................................................................................14
reader.softwareVersion.....................................................................................................................................14
reader.baseModel .............................................................................................................................................14
reader.model .....................................................................................................................................................14
reader.readerId..................................................................................................................................................14
reader.hardwareVersion ...................................................................................................................................14
reader.cabled ....................................................................................................................................................14
reader.locked.....................................................................................................................................................15
reader.debug.....................................................................................................................................................15

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 4 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
reader.decodes..................................................................................................................................................15
reader.bdAddr ...................................................................................................................................................15
Reader Methods..........................................................................................................................................................15
reader.runScript.................................................................................................................................................15
reader.configure ................................................................................................................................................16
reader.beep .......................................................................................................................................................16
reader.vibrate ....................................................................................................................................................16
reader.indicateGoodRead..................................................................................................................................16
reader.indicateError ..........................................................................................................................................16
reader.shiftJisToUnicode ...................................................................................................................................17
reader.unicodeToShiftJis ...................................................................................................................................17
reader.indicateData ...........................................................................................................................................17
reader.indicateWireless ....................................................................................................................................17
reader.indicateBattery ......................................................................................................................................17
reader.getKeyboardStatus ................................................................................................................................17
Reader Decodes Object...............................................................................................................................................17
decodes[i].decoderType ....................................................................................................................................17
decodes[i].valid..................................................................................................................................................17
decodes[i].x........................................................................................................................................................18
decodes[i].y........................................................................................................................................................18
decodes[i].bounds .............................................................................................................................................18
decodes[i].time..................................................................................................................................................18
decodes[i].symbology ........................................................................................................................................19
decodes[i].quality_percent................................................................................................................................19
decodes[i].aimSymbology..................................................................................................................................19
decodes[i].symbologyModifier..........................................................................................................................19
decodes[i].aimModifier .....................................................................................................................................19
decodes[i].linkage..............................................................................................................................................19
decodes[i].saPosition ........................................................................................................................................20
decodes[i].saTotal .............................................................................................................................................20
decodes[i].saParity ............................................................................................................................................20
decodes[i].isConfig ............................................................................................................................................20
decodes[i].decodeOutputFormat......................................................................................................................20
decodes[i].data (type string) .............................................................................................................................21
13.2 Storage Object.........................................................................................................................................21
Informational Properties .............................................................................................................................................21
storage.isFull......................................................................................................................................................21
storage.fullness_percent ...................................................................................................................................21
Storage Methods.........................................................................................................................................................21
storage.read.......................................................................................................................................................22
storage.write......................................................................................................................................................22
storage.append..................................................................................................................................................22
storage.rename..................................................................................................................................................22
storage.erase .....................................................................................................................................................22
storage.uploadFile .............................................................................................................................................22
storage.defragment ...........................................................................................................................................23
storage.findFirstInternal ....................................................................................................................................23
storage.findNextInternal ...................................................................................................................................23
storage.findFirst ................................................................................................................................................23
storage.findNext................................................................................................................................................23
storage.size........................................................................................................................................................23
storage.getHeader.............................................................................................................................................24
storage.listFiles..................................................................................................................................................24

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 5 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Data in Code Reader Local Storage .............................................................................................................................24
13.3 Comm Object...........................................................................................................................................24
Informational Properties .............................................................................................................................................25
comm.isConnected ............................................................................................................................................25
Comm methods...........................................................................................................................................................25
comm.connect ...................................................................................................................................................25
comm.disconnect...............................................................................................................................................25
comm.sendPacket..............................................................................................................................................25
comm.sendText .................................................................................................................................................25
comm.sendMessage ..........................................................................................................................................26
comm.getSendStatus.........................................................................................................................................26
comm.sendUsbScanCode ..................................................................................................................................26
comm.sendUsbScanCodes.................................................................................................................................26
comm.sendHidReport........................................................................................................................................27
13.4 Shell Functions.........................................................................................................................................27
help([name])................................................................................................................................................................27
include(name) .............................................................................................................................................................27
print (string) –see reader.print(string) .......................................................................................................................27
gc()...............................................................................................................................................................................27
sleep_ms(time_ms) .....................................................................................................................................................27
format(string format, ...) .............................................................................................................................................27
wdt_pet().....................................................................................................................................................................28
logMessage(string) ......................................................................................................................................................28
13.5 Pre-defined Scripts...................................................................................................................................28
.jseLib.js library functions............................................................................................................................................28
storage.findFirst(regex) .....................................................................................................................................28
storage.findNext()..............................................................................................................................................28
reader.setInterval (func, interval)......................................................................................................................29
reader.clearInterval(intervalId) .........................................................................................................................29
reader.setTimeout (func, delay) ........................................................................................................................29
reader.clearTimeout(timeoutId)........................................................................................................................29
reader.tick1Hz() –default implementation .......................................................................................................29
This implementation is used to manage the internal “interval” timers. ...................................................................................29
cra.js ............................................................................................................................................................................29
reader.onEvent(event).......................................................................................................................................29
reader.onDecodeAttempt(count)......................................................................................................................30
reader.onDecode(decode).................................................................................................................................30
reader.onDecodes(decodes)..............................................................................................................................30
reader.onConfigure(data)..................................................................................................................................30
.codeRules.js................................................................................................................................................................30
rules_onDecodes ...............................................................................................................................................30
rules_onDecodeAttempt ...................................................................................................................................31
rules_onDecode.................................................................................................................................................31
rules_onEvent....................................................................................................................................................31
rules_onConfgure(data).....................................................................................................................................32
Optional Global variables...................................................................................................................................32
.setttings.js ..................................................................................................................................................................32
jsSettings.def(param, val) ..................................................................................................................................33
jsSettings.put(param, val)..................................................................................................................................33
jsSettings.set(param, val)...................................................................................................................................33
jsSettings.reset(param)......................................................................................................................................33
jsSettings.get(param).........................................................................................................................................33

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 6 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
14.1 Sending Keystrokes (CodeXml) .................................................................................................................35
14.2 Glossary and Acronyms............................................................................................................................37
14.3 Encrypting a JavaScript file.......................................................................................................................38
14.4 Supported JavaScript Core........................................................................................................................38
14.5 Symbology Identifier Values.....................................................................................................................39

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 7 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Introduction
Code Corporation (Code) designs, develops, and manufactures image-based readers and software tools for data
collection applications. With expertise in software development, optics, imaging, and Bluetooth™ wireless
technology, Code is an innovative leader in the Auto ID and Data Collection Industries.
Many Code readers combine bar code reading with an easy-to-use JavaScript- based application development.
This user manual is applicable for the CR1100, CR1500 and CR2700 series readers.
Document Purpose
This manual describes the JavaScript application programming interface (API) for the Code readers (CR1100,
CR1500 and CR2700). It is assumed the user has programming knowledge and familiarity with the JavaScript
language.
Code readers read barcodes and can be programmed to transmit code data over a selected
communications link, or to store data in reader memory (batch mode when available).
The programming environment provides interfaces to:
oRead and manipulate data in reader memory
oAccess data sent by host
oTransmit data to a host computer, via communication link
oSelect type of communication link
oSet, change, and retrieve reader configuration settings
Document Audience
This document is designed to guide Code reader users and Developers that wish to customize the behavior of
the reader. The commands outlined are targeted at manipulating data, such as removing characters, translating
one set of characters to another, and providing different types of output, based on the type of barcode read,
appending characters, tabs or new lines, etc.
Document and Coding Conventions
This document employs the following conventions to aid in readability:
Words that are part of the application development description use the Courier New font
Code examples use the bold Courier New font in blue
Variable names that must be supplied by the programmer are: Courier New font and are
enclosed in relational signs; for example: <variable_name>.
The Code reader JavaScript library uses the following naming conventions:
Identifiers:Mixed-case with a capital letter, where words join (soCalledCamelCase), e.g.,
nasaSpaceShuttle, httpServer, codeXml
Acronyms and other initialisms are capitalized like words, e.g., CIMCE, CPU
Variables and Properties: Initial lower case, e.g., thisIsAVariable, thatIsAProperty
Classes (i.e., constructors): Initial capital, e.g., AClassIsCapitalizedCamelCase
Functions: Initial lower case, similar to variables and properties

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 8 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Unit of measure: Suffix to name, separated from name by underscore, using correct case when it’s
significant, e.g., offset_pixels, width_mm, power_mW, powerRatio_dB
Related Documents
Code readers are controlled by a large set of configuration settings that define the behavior of the reader. These
settings are described in Code document D027153 (CR8200 CR950 CR1500 CR1100 CR2700 CRA-A271
Configuration Control Document). Please familiarize yourself with the use of these configuration settings.
Note: Please visit Code’s website at: https://www.codecorp.com/ to obtain CR8200 CR950 CR1500 CR1100
CR2700 CRA-A271 Configuration Control Document from the Documentation section of the product.
Related Utilities
USB Virtual Com Driver: A software driver that creates a virtual COM port for a USB-cabled reader. This driver
enables the reader to be used by a computer program that requires input from a serial device, while being
connected to a USB port.
CortexTools2: Provides host access to all Code reader functionality, including file transfer between host and
reader. Valid communication modes are USB Downloader, USB Virtual Com, and RS232.
These utilities are available at: https://ww2.codecorp.com/downloads.php
JavaScript Resources
While you will not need to be a JavaScript expert, some JavaScript knowledge is required to use Rules, based on
this document. This document is not a JavaScript manual. While there are a number of books on JavaScript
programming, the following sources provide JavaScript reference books and online documents you may find
useful:
JavaScript: The Definitive Guide
by David Flanagan
JavaScript, A Beginner's Guide, Third Edition (Beginner's Guide)
by John Pollock
JavaScript Demystified (Demystified)
by James Keogh.
JavaScript (TM) in 10 Simple Steps or Less
by Arman Danesh
http://www.w3schools.com/jsref/default.asp
http://javascript.internet.com/
http://www.javascript.com/
Regular Expression Resources
You will not need to be a Regular Expression expert, but some Regular Expression knowledge is required to use
Rules, based on this document. This document is not a Regular Expression manual. While there are a number of
books on Regular Expression use, the following sources provide Regular Expression reference books and online
documents you may find useful:

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 9 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Mastering Regular Expressions
by Jeffrey E F Friedl
Beginning Regular Expressions (Programmer to Programmer)
by Andrew Watt
http://en.wikipedia.org/wiki/Regular_expression#Basic_concepts
http://www.regular-expressions.info/
Installing and Running a .codeRules.js script on the Code Reader
The Code-supplied JavaScript file .cra.js is written to check for and include a Code Rules file located on the
reader. The file name must conform to the following regular expression: /^\.codeRules*\.js/
The purpose for Code Rules files is primarily to provide override functions for decode attempt, decode, and
onEvent.
Security
Code supplies an encryption utility for license protection:
Each Code reader contains a unique reader ID
Select features of the reader are protected by license
Code provides a license file that activates protected features
A license file is required for each reader licensed to use protected features
Third-party software may also be protected using an encryption utility
Debugging (See reader.debug)
Programming Concepts
To help the Developer create unique applications for the reader, Code provides an easy-to-use, object-oriented
JavaScript Application Programming Interface (API). The Developer can create complex business applications
with prompts and data-entry, through the JavaScript API.
The features of the programming interface include:
Event handlers
Symbol decoding
Host communications
Local data storage
Code reader configuration
In support of this interface, Code has provided three objects which support these features:
Reader
Storage
Comm
There are also shell functions to provide utility functionality, not directly related to these objects. Using these
features, the user can create robust, interactive, and sophisticated user applications.
A user-defined script may be configured as the default script, or started via a command from a host utility or a
command from a barcode. Please be aware that any JavaScript file that is run remains active (variables &
functions) until the next reset, or until a different script is run. Each time a script is run (executed), the reader
closes, resets, and restarts the JavaScript engine.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 10 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Code JavaScript Objects
JavaScript objects have properties and methods. Code uses the properties to allow user customization of the
JavaScript implementation on the reader. Methods, on the other hand, provide communication between the
JavaScript engine and the reader firmware. All of the custom reader object properties and methods are
described in the following sections:
13.1 Reader Object
The reader object provides application software access to selected Code reader functionality and
information.
Callback Properties
Callback properties are functions that are provided by JavaScript assignments. Most callback
properties have default behavior defined in .cra.js.
reader.onDecodes(Decode Object Array decodes)
The reader.onDecodes function provides processing control to the application program
at the completion of a decode action. The reader.onDecodes(decodes) argument “decodes”is
an array of Decode Objects.
Example:
reader.onDecodes = function(decodes)
{
for(var i = 0; i < decodes.length ; ++i)
comm.sendText(decodes[i].data); // send decoded data to the
host
return true;
}
reader.onEvent(Event Object event) (CR1100, CR1500)
The onEvent property of the reader object provides a way for the user to issue and handle
simulated key press, release, and hold events, which will be processed by JavaScript. onEvent
has an event object passed to it, which has two properties: event.type, and
event.input. Values for type are PRES(1), HOLD(2), and RELS(3), and the values for input
are TRIG(0), WAKE(1), STND(2), INP0(3), and INP1(4).
Example:
const TRIG = 0;
const PRES = 1;
reader.onEvent = function(event)
{
if(event.type == PRES)
reader.beep();
return true;
}

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 11 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
reader.onRawData(data, len)
The reader.onRawData property is called when the reader receives data in a non-packetized
stream, like a configuration command issued from the host console. The stream data comes
as individual characters and a count, and not necessarily as a complete string. Use the count
to assemble the string. You, as the user, must watch for the carriage return as it will be
passed as a normal character, as will all other control characters. Please note that the serial
comm channel is the command channel in serial mode. If you return true from your handler
you must not expect the system to handle normal serial commands, such as CFG. You may
watch for and replace commands (for example, replace 8x commands with the new 82x
commands) by sending the new command with a reader.configure(cmd) when you detect an
old command.
Example:
reader.onRawData = function(data, len)
{
if(len > 0)
comm.sendText(data);
else
return false;
return true;
}
reader.onConfigure(string config)
The onConfigure property of the Code reader calls the specified function when the reader:
Receives a configuration command from a communication port
Decodes a configuration command from a code read by the Code reader
The application uses this property as an event handler to:
Receive notification of command processing
Prevent execution of a command
The function will not be called in response to a reader.configure call.
Return 0 to instruct the reader to process the command, or return 1 to suppress the
command. When a command is suppressed, the firmware will not send any response to the
host, but the JavaScript application may provide its own response to the host.
The onConfigure property is a blocking call, which means other tasks, such as the
reader.tick1Hz or reader.periodic, aren’t guaranteed to work, if called within the
onConfigure property.
Example:
reader.onConfigure = function(confString)
{
if(confString.match(“JSJSG”) === null)
return false;
return true;
}

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 12 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
reader.onPowerChange(int mode)
The reader.onPowerChange property is called when the reader requests permission to
change between active (0), standby (1), sleep (2), and off (3) modes. The user can prevent the
mode from changing by returning “false”, or can accept the change by returning “true”.
Example:
reader.onPowerChange = function(mode)
{
if(mode == 2)
{
comm.sendText(“No Sleep For You”);
return false;
}
return true;
}
reader.onBatteryChange(void)
i
The reader.onBatteryChange property is not yet implemented.
reader.onTrigger(triggerButton, buttonAction)(CR2700)
The reader.onTrigger property allows the user to intercept trigger presses, take actions
to handle the trigger events, and then either absorb the trigger event (return true), or allow
the reader to process the event after JavaScript does its handling of the event (return false).
This allows a wide variety of actions to be programmed for each time a trigger button is
pressed.
Example:
// constants for reader.onTrigger
const mainTrigger = 0;
const frontTrigger = 1;
const rearTrigger = 2;
const triggerPress = 0;
const triggerHold = 1; // hold is pressed for 700 mS
const triggerRelease = 2;
reader.onTrigger = function(Trigger, Type)
{
if( Trigger == frontTrigger )
reader.configure(“CDOPG”);
if(Trigger == rearTrigger && Type == triggerHold)
reader.configure(“CFR”);
return true;
}
reader.onDecodeAttempt(count)
The reader.onDecodeAttempt function is called anytime there is a decode attempt
made, including times that there hasn’t been a valid decode. It takes in an integer that
represents the number of successful decodes that happened during the decode attempt.
Example:
reader.onDecodeAttempt = function(mode)

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 13 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
{
if(count)
comm.sendText(“Successful Decode”);
else
comm.sendText(“No Decode”);
}
reader.periodic(void)
The reader.periodic function property is called on a set periodic rate. This rate is
modifiable via the JSPM_IT parameter. The default value is 1 Hz.
Example:
reader.periodic = function()
{
comm.sendText(“Some Time Has Passed”);
return;
}
reader.tick1Hz(void)
The reader.tick1Hz function property is called once every second. This is a set rate and
is not modifiable.
Example:
reader.tick1Hz = function()
{
comm.sendText(“Some Time Has Passed”);
return;
}
Informational Properties
Informational properties are properties that provide information about the reader when called.
reader.charging
The reader.charging property is not yet implemented.
reader.green
The reader.green property is not yet implemented.
reader.amber
The reader.amber property is not yet implemented.
reader.red
The reader.red property is not yet implemented.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 14 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
reader.black
The reader.black property is not yet implemented.
reader.softwareVersion
The softwareVersion property of the reader object contains a read-only string, comprising the
version number of the firmware currently running in the Code reader.
Example:
swVersion = reader.softwareVersion;
comm.sendText(“Version X.X: “ + swVersion);
reader.baseModel
The base model property of the reader object contains a read-only string, containing the Code
reader base model from the locked flash memory, (“CR1500”), etc.
Example:
rbmod = reader.baseModel
reader.model
The model property of the reader object contains a read-only string, containing the Code
reader model from the locked flash memory, (“2MD0”), etc.
Example:
rmod = reader.model
reader.readerId
The reader ID property of the reader object contains a read-only string, containing the Code
reader unique ID from the locked flash memory, (“FFFFFFFFFFFFFF”), etc.
Example:
rid = reader.readerId;
reader.hardwareVersion
The hardware version property of the reader object contains a read-only string, containing the
Code reader hardware revision number of the reader’s hardware, (“00”), etc.
Example:
hwVersion = reader.hardwareVersion;
comm.sendText(“Version XX: “ + hwVersion);
reader.cabled
The cabled property of the reader object contains a read-only Boolean value, which indicates
whether the reader is cabled or wireless. CR1100 and CR1500 will return true, and CR2700
will return false.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 15 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Example:
if(reader.cabled == true)
reader.indicateError();
reader.locked
Note: The reader.locked property is not yet implemented.
The locked property of the reader object contains a Boolean value, which indicates whether
the reader is locked or not. The locked property also supports unlocking by assigning the
reader.locked property the valid unlock string.
Example:
reader.locked = “magic unlock string”;
if(reader.locked == true)
reader.indicateError();
reader.debug
The debug property of the reader object contains an integer value, which indicates the
reader’s current debug level.
Example:
dbglvl = reader.debug;
reader.debug = 1;
reader.decodes
The decodes property of the reader object contains a decodes object, which corresponds to
the previous decodes object passed to the onDecodes callback.
Example:
dcds = reader.decodes;
reader.bdAddr
The reader.bdAddr property is not yet implemented.
Reader Methods
reader.runScript
The runScript method instructs the Code reader to schedule the load, compile, and execution
of the specified JavaScript. The Code reader schedules execution of the script immediately
after the currently executing event handler or main script completes. The runScript method
does not include a mechanism to return to the calling script. Running a script causes the
currently executing JavaScript context and runtime to close, then opens a new, fresh context
and runtime. Any previously running script settings are lost when this happens. If more than
one script need to work together, use an include (“script”); statement within the main script.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 16 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Example:
var execute = reader.runScript(“codeXml.js”);
reader.configure
The configure method instructs the Code reader to execute a configuration command. It
supersedes readSetting, writeSetting, defaultSettings, and saveSettings. Please review
configuration settings in the CR8200 ICD/CCD, (D026160) for specific details.
Example:
reader.configure(“CDOPPR2”) // Sets maximum 2 barcode decodes per read
reader.beep
The beep method causes the Code reader to beep. The user can call the command with one
(required) to four arguments, which are as follows:
reader.beep(numberOfBeeps, beepOnTime, beepOffTime, delayBeforeBeep).
Example:
// beep 6 times, 250mS on, 1S off each beep, no delay before beep
reader.beep(6, 250, 1000, 0);
// beep once with the default values
reader.beep(1);
reader.vibrate
reader.vibrate can be called without arguments, which gives the default vibrate, or can
be customized by entering values for number of vibration pulses, time on, time off, and the
delay before beginning (in milliseconds).
Example:
// vibrate 3 times, 500mS on, 500mS off, 100mS delay
reader.vibrate(3, 500, 500, 100);
// vibrate once with default values
Reader.vibrate();
reader.indicateGoodRead
This method performs the same indication that a valid decode would produce. The default
behavior is to turn on the green LED for 500mS and beeps once.
Example:
reader.indicateGoodRead();
reader.indicateError
This method turns on the red error LED and performs the same indication that an error would
produce. The default behavior is to beep three times.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 17 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Example:
reader.indicateError();
reader.shiftJisToUnicode
This method converts a valid shiftJIS string to unicode, and returns the resulting string.
Example:
myUnicodeString = reader.shiftJisToUnicode(shiftjisStr);
reader.unicodeToShiftJis
This method converts a valid Unicode string to a shiftJIS encoding, and returns the resulting
string.
Example:
uniString = reader.unicodeToShiftJis(unicodeStr):
reader.indicateData
reader.indicateWireless
reader.indicateBattery
reader.getKeyboardStatus
This method returns an integer representation of a byte value which corresponds to the
current keyboard status. The lowest order bit represents a keyboard “caps lock”. The next bit
represents a keyboard “num lock”.
Example:
keyStat = reader.getKeyboardStatus();
Reader Decodes Object
The decodes object is provided by the onDecodes function. The argument is an array of decode
objects (see onDecodes). The following properties are provided:
decodes[i].decoderType
decodes[i].valid
The decoder marks decoded data as valid or not valid. This flag can be used to signal to the
system that data has already been handled or ignore it.
Example:
var validDecode = decodes[i].valid;

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 18 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
decodes[i].x
The decode.x property is a read-only property that defines the horizontal position, in
pixels, of the barcode that was just decoded, in relation to the entire image captured by the
reader and analyzed by the decode engine. The value for decode.x can be positive or
negative, based on the fact that 0 is the center of the image.
Example:
var hPos = decodes[i].x;
decodes[i].y
The decode.y property is a read-only property that defines the vertical position, in pixels,
of the barcode that was just decoded, in relation to the entire image captured by the reader
and analyzed by the decode engine. The value for decode.y can be positive or negative,
based on the fact that 0 is the center of the image.
Example:
var vPos = decodes[i].y;
decodes[i].bounds
The bounds property is an array of four sets of x- and y-coordinates that give information
about the position of the last decoded barcode. The four points (x, y) indicate the position in
pixels of the four corners of the barcode from the upper left (0, 0) position in the captured
image as integers. Be aware, in some readers the image is rotated 90°, when displayed in
CortexTools.
//The x and y coordinates of the top right corner of the barcode in the image:
pos.tR = (decode.bounds[0].x, decode.bounds[0].y)
//The x and y coordinates of the top left corner of the barcode in the image:
pos.tL = (decode.bounds[1].x, decode.bounds[1].y)
//The x and y coordinates of the bottom left corner of the barcode in the image:
pos.bL = (decode.bounds[2].x, decode.bounds[2].y)
//The x and y coordinates of the bottom right corner of the barcode in the image:
pos.bR = (decode.bounds[3].x, decode.bounds[3].y)
decodes[i].time
The decode.time property is a read-only property that defines the amount of time, in
milliseconds, it took the decode engine to decode the barcode that was just analyzed.
Example:
var decTime = decodes[i].time;

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 19 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
decodes[i].symbology
The decode.symbology property is a read-only property that contains the symbology
index assigned by Code Corporation. Valid values for symbology are defined in Appendix 5.3.
Example:
var symbology = decodes[i].symbology;
decodes[i].quality_percent
The decode quality percent property is a read-only property that defines an internally-defined
image quality value determined by the decode engine, while analyzing the captured image.
This is not the quality of the printed or displayed barcode, but rather the quality of the
captured image for use in decoding.
Example:
var quality_percent = decodes[i].quality_percent;
decodes[i].aimSymbology
Property is a read-only property that gives the first character of the AIM (Automatic
Identification and Mobility) symbology, determined by the decode engine of the barcode that
was just decoded. More information on AIM Standards can be found at the Association for
Automatic Identification & Mobility website.
decodes[i].symbologyModifier
The decode.symbologyModifier property is a read-only property that contains
symbology modifier information for the barcode decoded by the decode engine. Valid values
for symbologyModifier are based on an old proprietary decoder and are defined in the
Appendix. The values are the same as aimModifier for all symbologies, except UPC.
Example:
var symbologyModifier = decodes[i].symbologyModifier;
decodes[i].aimModifier
The decode.aimModifier property is a read-only property that gives the AIM (Automatic
Identification and Mobility) Modifier, determined by the decode engine of the barcode that
was just decoded. More information on AIM Standards can be found at the Association for
Automatic Identification & Mobility website.
Valid values for aimModifier are defined in section 5.3.
decodes[i].linkage
The decode.linkage property is a read-only property that gives information about the
linking code between the segments that make up a composite barcode, if a composite
barcode was just decoded by the decode engine. This property is null if the decoded barcode
was not a composite barcode.

D028868 CR1500 CR1100 CR2700 JavaScript Programming Guide User Manual Page 20 of 41
The Code Corporation  12393 South Gateway Park Place, Suite 600, Draper, UT 84020  [phone]  FAX [phone]
Example:
var link = decodes[i].linkage;
if( link === null ) print(“not composite\n”);
decodes[i].saPosition
In order to handle larger messages, that are practical, in a single symbol, a data message can
be distributed across several QR Code symbols. Up to 16 QR Code symbols may be appended
in a structured format to convey more data. If a symbol is part of a structured append, this
will be indicated by a structured append block in barcode text.
The position index of the symbol within the set of QR Code symbols in the structured append
format and is an integer between 1 and 16 (including the boundaries) in string format.
Example:
var numSplits = decodes[i].saTotal;
var idx = decodes[i].saPosition;
print(“this is ”+ idx + “ of ”+ numSplits + “\n”);
decodes[i].saTotal
The total amount of the symbol within the set of QR Code symbols in the structured append
format. It's an integer between 2 and 16 (including the boundaries) in string format.
Example:
var numSplits = decodes[i].saTotal;
decodes[i].saParity
Parity Date: It shall be an 8-bit byte value obtained by using the GetParity method, with the
original input data as its parameter. It is identical in all symbols in the structured append,
enabling verification that all symbols read form part of the same structured append message.
Example:
var parity = decodes[i].saParity;
decodes[i].isConfig
The decoder marks decoded data that matches configuration code formatting with isConfig
true. JavaScript must then decide the appropriate way to handle or not handle the code.
Example:
var isConfigCode = decodes[i].isConfig;
decodes[i].decodeOutputFormat
The decode.decodeOutputFormat property is a read-only property that gives the type of
output the JavaScript should expect.
Value
Definition
0
Raw output: No formatting applied by the decoder