KoamTac KDC100 Owner's manual



ProgrammingManual
KDC100
July,2009
REVISION
2.82

KDC100 Programming Manual
1
Copyright, License and Warning page
Copyright©2009 by KoamTac, Inc. All rights reserved
No part of this publication may be reproduced or used in any form, or by any electrical or mechanical
means, without permission in writing from KoamTac, Inc.
The material in this manual is subject to change without notices.
KoamTac reserves the right to make changes to any product to improve reliability, function, or design.
KoamTac doesn’t assume any product liability arising out of, or in connection with, the application or
use of any product, circuit, or application described herein.
Follow all warnings and instructions marked on manual and units
Use only the power source specified in this manual or marked on the units
TO PREVENT FIRE OR SHOCK HAZARD, DO NOT EXPOSE THIS UNIT TO ANY TYPE OF MOISTURE
DO NOT LOOK DIRECTLY INTO LASER or point the laser into another person’s eyes. Exposure to the beam MAY
CAUSE EYE DAMAGE.
CAUTION
Changes or modifications not expressly approved by the manufacturer responsible for compliance
could void the user’s authority to operate the equipment
WARNING
This device complies with part 15 of the FCC Rules. Operation is subject to the following two
conditions: (1) This device may not cause harmful interference, and (2) this device must accept any
interference received, including interference that may cause undesired operation.
INFORMATION TO USER:
This equipment has been tested and found to comply with the limit of a Class B digital device,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection
against harmful interference in a residential installation. This equipment generates, uses and can
radiate radio frequency energy and, if not installed and used in accordance with the instructions, may
cause harmful interference to radio communications. However, there is no guarantee that interference
will not occur in a particular installation; if this equipment does cause harmful interference to radio or
television reception, which can be determined by turning the equipment off and on, the user is
encouraged to try to correct the interference by one or more of the following measures:
1. Reorient / Relocate the receiving antenna.
2. Increase the separation between the equipment and receiver.
3. Connect the equipment into an outlet on a circuit difference from that to which the receiver is
connected.
4. Consult the dealer or an experienced radio/TV technician for help
CAUTION
RISK OF EXPLOSION IF BATTERY IS REPLACED BY AN INCORRECT TYPE.
DISPOSE USED BATTERIES ACCORDING TO THE INSTRUCTIONS

KDC100 Programming Manual
2
Table of Contents
Internal data buffer......................................................................................................................... 4
Data Format .................................................................................................................................... 4
How many barcodes can be stored? ................................................................................. 6
What happens when the buffer is full? ............................................................................. 6
Commands Set .................................................................................................................................. 7
‘B’ (Read battery level) ............................................................................................................. 9
‘C’ (Set date and time) ............................................................................................................ 10
‘c’ (Read date and time) ......................................................................................................... 11
‘D’ (Software trigger) ............................................................................................................... 12
‘E’ (Erase all stored data) ...................................................................................................... 13
‘e’ (Erase the last stored data) ........................................................................................... 14
‘F’ (Factory default) .................................................................................................................. 15
‘GB0’ (Unlock button) .............................................................................................................. 16
‘GB1’ (Lock button) ................................................................................................................... 17
‘Gb0’ (Beeper off) ....................................................................................................................... 18
‘Gb1’ (Beeper on) ....................................................................................................................... 19
‘GC0’ (Disable port connection status display) ......................................................... 20
‘GC1’ (Enable port connection status display) ........................................................... 21
‘GD0’ (Unlock date and time setting) .............................................................................. 22
‘GD1’ (Lock date and time setting) .................................................................................. 23
‘GM’ (Message start position) ............................................................................................. 24
‘GMB0’ (Failure Alert Beep) .................................................................................................. 25
‘GMB1’ (Success Alert Beep) ............................................................................................... 26
‘GMS’ (Message display duration) ..................................................................................... 27
‘GMT’ (Display message) ....................................................................................................... 28
‘GS0’ (Finish Synchronization) ............................................................................................ 29
‘GS1’ (Start Synchronization) .............................................................................................. 30
‘GTG’ (Read termination character) ................................................................................ 32
‘GW’ (Menu Password Protection) .................................................................................... 33
‘GX0’ (Disable Auto Menu Exit) .......................................................................................... 34
‘GX1’ (Enable Auto Menu Exit) ............................................................................................ 35
‘GY0’ (Display data, type, date and time) ..................................................................... 36
‘GY1’ (Display data, date and time, battery status) ................................................ 37
‘GY2’ (Display data, type, battery status) ..................................................................... 38
‘H’ (Set handshake mode) ..................................................................................................... 39
‘h’ (Read handshake mode) .................................................................................................. 40
‘L’ (Set minimum barcode length) ..................................................................................... 41

KDC100 Programming Manual
3
‘l’ (Read minimum barcode length) .................................................................................. 42
‘M’ (Read serial number) ........................................................................................................ 43
‘N’ (Get # of stored barcode) ............................................................................................... 44
‘O’ (Set barcode option) ......................................................................................................... 45
‘o’ (Read barcode option) ...................................................................................................... 46
‘P’ (Download all stored barcode) ..................................................................................... 47
‘p’ (Download n
th
stored barcode) ..................................................................................... 49
‘S’ (Select symbology) ............................................................................................................. 51
‘s’ (Read selected symbology) ............................................................................................ 53
‘T’ (Set Timeout) ......................................................................................................................... 54
‘t’ (Read timeout value) .......................................................................................................... 55
‘U’ (Set data process mode) ................................................................................................. 56
‘u’ (Read data process mode) ............................................................................................. 57
‘V’ (Read firmware version) .................................................................................................. 58
‘W’ (Wake up) ............................................................................................................................... 59
‘w’ (Set data format) ................................................................................................................ 60
‘Z’ (Set security level) ............................................................................................................. 61
‘z’ (Read security level) .......................................................................................................... 62
Wedging Data Format and Handshake Mode .................................................................. 63
Barcode only format ................................................................................................................ 63
Packet data format and disabled Handshake mode ............................................... 63
Packet data format and enabled Handshake mode ................................................ 63
Miscellaneous.................................................................................................................................. 64
KDC100 sends "?" character ............................................................................................... 64
Contact Information ..................................................................................................................... 65

KDC100 Programming Manual
4
KoamTac KDC100 provides easy and extensive commands set to application developers who wish to
control the KDC100 and resulting data for their application.
Internal data buffer
KDC100 has 190K bytes flash memory where it stores the read barcodes. Its capacity, in terms of
number of barcodes, depends on the size of barcodes. Barcodes are stored sequentially as they are
scanned in the internal flash memory. The maximum number of stored barcodes is 10,240 with 190K
byte limitation.
Data Format
User can distinguish Normal mode, Master/Slave Application and user created Application records by
checking the second last byte in the record. It is user created Application record if the second last
byte is 0xFF in hexadecimal (11111111 in binary). It is either Normal mode or Master/Slave
Application records if the second last byte is NOT 0xFF. User can further distinguish Normal mode
and Master/Slave Application records by checking the first two bits of barcode type byte defined in the
below.
Normal mode and Master/Slave Application
KDC100 stores the read barcodes in the internal flash memory in the following data format:
C0 Y0 D0 T0 C1 Y1 D1 T1 ….. ….. ….. ….. Cn Yn Dn Tn
Where
C0, C1,…, Cn : Total number of each barcode data (1 byte)
o2 bytes for KDC200P/KDC300, 1 byte for KDC100/200
Y0,Y1,…, Yn : Type of each barcode(1 byte)
oThe 1st 3 bits distinguish Normal mode or Master/Slave Application records
−Bit 5 : 1 if matching slave data, 0 if mismatching slave data
−Bit 6 : 1 if master data, 0 if slave data
−Bit 7 : 1 if data is collected in Master/Slave Application, 0 if data is collected
in Normal mode
oThe remaining 5 bits indicate barcode type
D0,D1,…,Dn : Actual barcode data of each barcode (variable size)
T0, T1,…,Tn : Timestamp of each barcode (4 bytes)

KDC100 Programming Manual
5
Barcodes are stored sequentially as they are scanned in the internal flash memory. Since barcodes
can have different lengths, we need to keep track of length information as well. For each barcode we
first store the length of barcode plus 1 (1 byte), then the barcode type (1 byte), and then the barcode
value (without the string terminator ‘\0’).
The timestamp field has 6 sub-fields as follows:
MSB LSB
Years
(6 bits)
Months
(4 bits)
Days
(5 bits)
AM/PM
(1 bit)
Hours
(4 bits)
Minutes
(6 bits)
Seconds
(6 bits)
Note:
(1) The base year is 2000. It means the year is 2000 if Years field is 0.
(2) The Hours range is 0 – 11 and AM/PM bit 0 means AM, and 1 means PM
User Applications generated by Application Generator
KDC100 stores the read barcodes in the internal flash memory in the following data format:
C0 Y0 D0 T0 Q0 C1 Y1 D1 T1 Q1. ….. Cn Yn Dn Tn Qn.
Where
C0, C1,…, Cn : Total number of each barcode data (1 byte)
o2 bytes for KDC200P/KDC300, 1 byte for KDC100/200
Y0,Y1,…, Yn : Type of each barcode(1 byte)
oThe 1st 2 bits indicate record type
0 : Data collected in Normal mode
1 : Step 1 data collected in Application mode
2 : Step 2 data collected in Application mode
3 : Step 3 data collected in Application mode
oThe remaining 6 bits indicate barcode type
D0,D1,…,Dn : Actual barcode data of each barcode (variable size)
T0, T1,…,Tn : Timestamp of each barcode (4 bytes)
Q0, Q1,…,Qn : (2 bytes)
oThe 1st byte indicates Predefined or User Application
0xFF : User Application
oThe 2nd byte indicates Quantity

KDC100 Programming Manual
6
MSB(bit 7) is the compliant data indicator
−0: Compliant data
−1: Not compliant data
Remaining 7 bits indicate quantity (1~128)
Barcodes are stored sequentially as they are scanned in the internal flash memory. Since barcodes
can have different lengths, we need to keep track of length information as well. For each barcode we
first store the length of barcode plus 1 (1 byte), then the barcode type (1 byte), and then the barcode
value (without the string terminator ‘\0’).
The timestamp field has 6 sub-fields as follows:
MSB LSB
Years
(6 bits)
Months
(4 bits)
Days
(5 bits)
AM/PM
(1 bit)
Hours
(4 bits)
Minutes
(6 bits)
Seconds
(6 bits)
Note:
(1) The base year is 2000. It means the year is 2000 if Years field is 0.
(2) The Hours range is 0 – 11 and AM/PM bit 0 means AM, and 1 means PM
How many barcodes can be stored?
The number of barcodes that can be stored in these bytes depends on the size of the barcodes
Example: If only UPCA barcodes are scanned and the check digit is not transmitted, then each
barcode takes up 11 (barcode data) + 2 (length and type) + 4 (time stamp) = 17 bytes. The maximum
number of UPCA barcodes that can be saved is 204,800/17 =12,047. However, the maximum
number of barcodes can be stored is 10,240. Therefore, KDC100 can store 10,240 UPCA barcodes.
What happens when the buffer is full?
When the internal flash memory is full, KDC100 displays “Buffer Full” message and ignores the
command to scan barcodes.

KDC100 Programming Manual
7
Commands Set
KDC100 has various commands and they are quite simple. They are shown in the following table.
zCommand parameters are either character or hexadecimal numbers. Please read each
command description and example carefully.
z0xNN means one byte data “NN” in hexadecimal format. For example, 0x30 means
hexadecimal number 30 which is equivalent to character “0”.
zUser should transmit the command string within 2 seconds to avoid timeout and undesired
output.
zIt is recommended to insert proper delay (about 100msec) between characters when
transmitting the command string.
zIt is recommended to send “W” command first to wake up KDC100 before sending individual
commands.
Command Input Output Description
B None value @ Returns current battery capacity(value = 0~100)
C YMDHmS @ Setting new date and time of KDC100
c None YMDHmS @ Returns current date and time of KDC100
D None @ or ! Reading barcode (Software trigger)
E None @ Erase all stored barcodes
e None @ Erase the last stored barcode
F None @ Set internal options to factory default setting
G
B0 None @ Unlock buttons for normal operation
B1 None @
Lock buttons to prevent undesired accidental
operation
b0 None @ Disable beep sound
b1 None @ Enable beep sound
C0 None @ Disable Serial and USB connection status display
C1 None @ Enable Serial and USB connection status display
D0 None @ Unlock date and time setting
D1 None @ Lock date and time setting
M
<value# ;
value#># @ or ! Set start display position of message from Host
S<value># @ or ! Set message display duration from Host
T<value><CR> @ Display message from Host on KDC
MB0 @ Failure Alert Beep
MB1 @ Success Alert Beep
S0 None @ Start Synchronization Mode
S1 None @ Finish Synchronization Mode
TS Value# @ or ! Set termination character after barcode data if data
format is barcode only
TG None value @ Get termination character setting after barcode data
if data format is barcode only
W 0 @ Disable menu password protection
1<password># @ Enable menu password protection
X 0 @ Disable automatic menu exit feature
1 @ Enable automatic menu exit feature
Y0 None @ Display scanned barcode data, barcode type, date
and time
Y1 None @ Display scanned barcode data, date and time,

KDC100 Programming Manual
8
battery status
Y0 Note @ Display scanned barcode data, barcode type,
battery status
H value # @ Enable/Disable handshake mode while transferring
packet data
h None
value @ Get handshake state
L value # @ or ! Set minimum barcode length
l None value @ Get minimum barcode length
M None
value @ Get serial number of KDC
N None value @ Get number of barcodes stored
O value # @ or ! Set scan options and flags
o None value @ Get scan options and flags
P None
Data Upload all stored barcode data
p value # Data Upload Nth stored barcode
S value # @ or ! Set decoding symbologies
s None value @ Get current decoding symbologies
T value # @ or ! Set decoding timeout
t None value @ Get current barcode read timeout
U value # @ or ! Set data process mode (Wedge, Store)
u None value @ Get barcode handling mode selected by command
'U'
V None string @ Get firmware version
W None @ Wake up KDC100 from sleep mode
w value # @ or ! Select wedging data format (Barcode only, packet
data)
Z value # @ or ! Set security level
z None value @ Get current security level

KDC100 Programming Manual
9
‘B’ (Read battery level)
Parameters: None
Format: ‘B’
Output: ‘<value>@’ where <value> is the capacity of battery (0% to 100%) in hexadecimal and @
means the end of <value>
Purpose: Read the current battery capacity of KDC100
[Example] Output: 0x00 0x00 0x00 0x64 0x40
zIgnore the first three leading NULL bytes
z64% in hexadecimal (100% in decimal)
zHexadecimal 40 is “@” character

KDC100 Programming Manual
10
‘C’ (Set date and time)
Parameters: Date and Time value to be set in KDC100
Format: ‘CYMDHmS’ where Y is year(0 means 2000), M is month(1-12), D is day(1-31), H is
hour(0-23), m is minute(0-59) an S is second(0-59). Y, M, D, H, m and S are numbers in
hexadecimal.
Output: ‘@’
Purpose: Set Date and Time of KDC100
[Example] Send 6 bytes data (0x00, 0x02, 0x03, 0x17, 0x0C, 0x01) to set date and time to
2000/02/03:23:12:01
[Note1] KDC doesn’t check the validity of date and time format. Invalid data can malfunction the
device. Please check the validity of date and time format carefully.
[Note2] Year range is between 1970 and 2069.
Year Hex No.
1970 ~ 1999 0x46 ~ 0x63
2000 ~ 2069 0x00 ~ 0x45

KDC100 Programming Manual
11
‘c’ (Read date and time)
Parameters: None
Format: ‘c’
Output: ‘YMDHmS@’ where Y is year(0 means 2000), M is month(1-12), D is day(1-31), H is
hour(0-23), m is minute(0-59) an S is second(0-59) and @ means the end of data. Y, M, D,
H, m and S are hexadecimal numbers. Year range is between 1970 and 2069.
Year Hex No.
1970 ~ 1999 0x46 ~ 0x63
2000 ~ 2069 0x00 ~ 0x45
Purpose: Read current Date and Time of KDC100
[Example] Output: 0x00, 0x02, 0x03, 0x17, 0x0C, 0x01
z0x00: Year 2000
z0x02: February
z0x03: 3rd
z0x17: 23 Hour (Hexadecimal 17 is equal to 23 in decimal)
z0x0C: 12 Min. (Hexadecimal C is equal to 12 in decimal)
z0x01: 1 Sec
z2000/02/03:23:12:01

KDC100 Programming Manual
12
‘D’ (Software trigger)
Parameters: None
Format: ‘D’
Output: ‘!’ – KDC100 internal flash memory is full or Reading is failed
‘@’ – Barcode reading success
Purpose: Software trigger. It starts barcode scanning process. Scanning stops once a barcode is
decoded or predefined scanning timeout occurs

KDC100 Programming Manual
13
‘E’ (Erase all stored data)
Parameters: None
Format: ‘E’
Output: ‘@’
Purpose: Erases the internal flash memory completely. All stored data will be lost.

KDC100 Programming Manual
14
‘e’ (Erase the last stored data)
Parameters: None
Format: ‘e’
Output: ‘@’
Purpose: Erases the last stored data.

KDC100 Programming Manual
15
‘F’ (Factory default)
Parameters: None
Format: ‘F’
Output: ‘@’
Purpose: To set KDC100 internal options and flag to the factory default setting
[Note] The factory default settings are:
zAll symbologies are enabled
zAll options are disabled except
−UPCE_ReturnCheckDigit
−UPCA_ReturnCheckDigit
−EAN8_ReturnCheckDigit
−EAN13_ReturnCheckDigit
zMinimum barcode length is set to 4
zTime-out is set to 2 seconds
zSecurity Level is set to 2
zSelect wide scan angle
zSleep timeout is set to 5 seconds
zWedge and Store. Send the scanned barcode to HOST and save into flash
zData format is barcode only

KDC100 Programming Manual
16
‘GB0’ (Unlock button)
Parameters: None
Format: ‘GB0’
Output: ‘@’
Purpose: Unlock KDC100 up, down and scan buttons for normal operation

KDC100 Programming Manual
17
‘GB1’ (Lock button)
Parameters: None
Format: ‘GB1’
Output: ‘@’
Purpose: To lock KDC100 up, down and scan buttons. Locking buttons prevents undesired
accidental operation and keeps KDC100 in sleep mode (battery saving mode)

KDC100 Programming Manual
18
‘Gb0’ (Beeper off)
Parameters: None
Format: ‘Gb0’
Output: ‘@’
Purpose: Disable KDC100 beep sound

KDC100 Programming Manual
19
‘Gb1’ (Beeper on)
Parameters: None
Format: ‘Gb1’
Output: ‘@’
Purpose: To enable KDC100 beep sound