KoamTac KDC200 KDC250 Owner's manual

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

KDC200 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

KDC200 Programming Manual
2
Table of Contents
Internal data buffer......................................................................................................................... 5
Data Format .................................................................................................................................... 5
How many barcodes can be stored? ................................................................................. 7
What happens when the buffer is full? ............................................................................. 7
Commands Set .................................................................................................................................. 8
‘B’ (Read battery level) ........................................................................................................... 11
‘bT0’ (Read Bluetooth options) ........................................................................................... 12
‘bT1’ (Bluetooth power on/off) ............................................................................................ 13
‘bT2’ (Bluetooth pairing Mode) ........................................................................................... 14
‘bT3’ (Bluetooth auto connection) .................................................................................... 15
‘bT5’ (Bluetooth auto power off) ........................................................................................ 17
‘bT6’ (Bluetooth disconnection beep warning) .......................................................... 18
‘bT70’ (Read Bluetooth auto power off timeout value) .......................................... 19
‘bT71’ (Set Bluetooth auto power off timeout value) ............................................. 20
‘bT80’ (Disable Bluetooth power off message to host) ......................................... 21
‘bT81’ (Enable Bluetooth power off message to host) ........................................... 22
‘bT9’ (Bluetooth MAC address) ........................................................................................... 23
‘bTA0’ (Set KDC200 in Bluetooth Slave Mode) ........................................................... 24
‘bTA1’ (Set KDC200 in Bluetooth Master Mode) ........................................................ 25
‘bTC’ (Activates a connection to predefined Bluetooth MAC address and PIN
code)
................................................................................................................................................ 26
‘bTD’ (Set Bluetooth MAC address) .................................................................................. 27
‘bTE’ (Set Bluetooth PIN code) ........................................................................................... 28
‘C’ (Set date and time) ............................................................................................................ 29
‘c’ (Read date and time) ......................................................................................................... 30
‘D’ (Software trigger) ............................................................................................................... 31
‘E’ (Erase memory) .................................................................................................................... 32
‘e’ (Erase the last stored data) ........................................................................................... 33
‘F’ (Factory default) .................................................................................................................. 34
‘GB0’ (Unlock button) .............................................................................................................. 35
‘GB1’ (Lock button) ................................................................................................................... 36
‘Gb0’ (Beeper off) ....................................................................................................................... 37
‘Gb1’ (Beeper on) ....................................................................................................................... 38
‘GC0’ (Disable port connection status display) ......................................................... 39
‘GC1’ (Enable port connection status display) ........................................................... 40
‘GD0’ (Unlock date and time setting) .............................................................................. 41
‘GD1’ (Lock date and time setting) .................................................................................. 42

KDC200 Programming Manual
3
‘GM’ (Message start position) ............................................................................................. 43
‘GMB0’ (Failure Alert Beep) .................................................................................................. 44
‘GMB1’ (Success Alert Beep) ............................................................................................... 45
‘GMS’ (Message display duration) ..................................................................................... 46
‘GMT’ (Display message) ....................................................................................................... 47
‘GS0’ (Finish Synchronization) ............................................................................................ 48
‘GS1’ (Start Synchronization) .............................................................................................. 49
GTS’ (Set termination character) ...................................................................................... 50
‘GTG’ (Read termination character) ................................................................................ 51
‘GW’ (Menu Password Protection) .................................................................................... 52
‘GX0’ (Disable Auto Menu Exit) .......................................................................................... 53
‘GX1’ (Enable Auto Menu Exit) ............................................................................................ 54
‘GY0’ (Display data, type, date and time) ..................................................................... 55
‘GY1’ (Display data, date and time, battery status) ................................................ 56
‘GY2’ (Display data, type, battery status) ..................................................................... 57
‘H’ (Set handshake mode) ..................................................................................................... 58
‘h’ (Read handshake mode) .................................................................................................. 59
‘L’ (Set minimum barcode length) ..................................................................................... 60
‘l’ (Read minimum barcode length) .................................................................................. 61
‘M’ (Read serial number) ........................................................................................................ 62
‘N’ (Get # of stored barcode) ............................................................................................... 63
‘O’ (Set barcode option) ......................................................................................................... 64
‘o’ (Read barcode option) ...................................................................................................... 65
‘P’ (Download all stored barcode) ..................................................................................... 66
‘p’ (Download n
th
stored barcode) ..................................................................................... 68
‘S’ (Select symbology) ............................................................................................................. 70
‘s’ (Read selected symbology) ............................................................................................ 72
‘T’ (Set Timeout) ......................................................................................................................... 73
‘t’ (Read timeout value) .......................................................................................................... 74
‘U’ (Set data process mode) ................................................................................................. 75
‘u’ (Read data process mode) ............................................................................................. 76
‘V’ (Read firmware version) .................................................................................................. 77
‘W’ (Wake up) ............................................................................................................................... 78
‘w’ (Set data format) ................................................................................................................ 79
‘Z’ (Set security level) ............................................................................................................. 80
‘z’ (Read security level) .......................................................................................................... 81
Wedging Data Format and Handshake Mode .................................................................. 82
Barcode only format ................................................................................................................ 82
Packet data format and disabled Handshake mode ............................................... 82
Packet data format and enabled Handshake mode ................................................ 82

KDC200 Programming Manual
4
Miscellaneous.................................................................................................................................. 83
KDC200 sends "?" character ............................................................................................... 83
KDC200 sends one to three leading “NULL” bytes .................................................. 83
Contact Information ..................................................................................................................... 84

KDC200 Programming Manual
5
KoamTac KDC200 provides easy and extensive commands set to application developers who wish to
control the KDC200 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
KDC200 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)

KDC200 Programming Manual
6
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
KDC200 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

KDC200 Programming Manual
7
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, KDC200 can store 10,240 UPCA barcodes.
What happens when the buffer is full?
When the internal flash memory is full, KDC200 displays “Buffer Full” message and ignores the
command to scan barcodes.

KDC200 Programming Manual
8
Commands Set
KDC200 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 KDC200 before sending individual
commands.
Command Input Output Description
B None value @ Returns current battery capacity(value = 0~100)
b
T0 None value @ Returns current settings of Bluetooth options
T1 0 @ Turns off Bluetooth power
1 @ Turns on Bluetooth power
T2 None @ or ! Start Bluetooth pairing mode
T3
0 @ or ! Disable auto connection mode of Bluetooth at power
on
1 @ or ! Enable auto connection mode of Bluetooth at power
on
T4 0 @ Disable Bluetooth auto power on function
1 @ Enable Bluetooth auto power on function
T5 0 @ Disable Bluetooth auto power off function
1 @ Enable Bluetooth auto power off function
T6
0 @
Disable beep warning when Bluetooth auto power
off function is disabled
1 @
Enable beep warning when Bluetooth auto power off
function is disabled
T7 0 value @ Returns current Bluetooth auto power off timeout
1 value# @ Set Bluetooth auto power off timeout
T8
0 @ Disable Bluetooth power off message to host
1 BTOFF@ Enable Bluetooth power off message to host
T9 value @ Returns KDC Bluetooth Mac address
TA
0 @ Set Bluetooth device to slave mode
1 @ Set Bluetooth device to master mode
TC @ Connect to predefined Bluetooth MAC address and
PIN code
TD <value># @ or ! Set Bluetooth MAC address
TE <value># @ or ! Set PIN code. No PIN code if <value> is Null.
C YMDHmS @ Setting new date and time of KDC200

KDC200 Programming Manual
9
c None YMDHmS @ Returns current date and time of KDC200
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 Bluetooth, Serial and USB connection status
display
C1 None @
Enable Bluetooth, 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
B0 @ Failure Alert Beep
B1 @ 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,
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 KDC200 from sleep mode

KDC200 Programming Manual
10
w value # @ or ! Select wedging data format (Barcode only, packet
data)
Z value # @ or ! Set security level
z None value @ Get current security level

KDC200 Programming Manual
11
‘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 KDC200
[Example] Output: 0x00 0x00 0x00 0x64 0x40
zIgnore the first three leading NULL bytes
z64% in hexadecimal (100% in decimal)
zHexadecimal 40 is “@” character

KDC200 Programming Manual
12
‘bT0’ (Read Bluetooth options)
Parameters: None
Format: ‘bT0’
Output: ‘<value>@’ where <value> is the current selected Bluetooth options in hexadecimal and
@ means the end of <value>
bit 0 : Not used
bit 1 : Bluetooth module power is on(1)/off(0)
bit 2 : Not used
bit 3 : Auto connection mode is enabled(1)/disabled(0)
bit 4 : Auto power on is enabled(1)/disabled(0)
bit 5 : Auto power off is enabled(1)/disabled(0)
bit 6: Beep warning is enabled(1)/disabled(0)
Purpose: Gets current Bluetooth options
[Example] Output: 0x00, 0x00, 0x00, 0x60, 0x40
z0x60: 01100000 in binary, Bit 5, 6 are enabled. Bit 1,3,4 are disabled
z0x40: ASCII code of character “@” in hexadecimal

KDC200 Programming Manual
13
‘bT1’ ( Bluetooth power on/off)
Parameters: 0 or 1
Format: ‘bT1<value>’, where <value> is 0 or 1
value Power Character Hex No.
0 Off "0" 30
1 On "1" 31
Output: ‘@’
Purpose: Turns on(1)/off(0) KDC200 Bluetooth power
[Example] Send 4 bytes data (0x62, 0x54, 0x31, 0x30) to turn off Bluetooth power
z0x62: ASCII code of character “b” in hexadecimal
z0x54: ASCII code of character “T” in hexadecimal
z0x31: ASCII code of character “1” in hexadecimal
z0x30: ASCII code of character “0” in hexadecimal
zbT10

KDC200 Programming Manual
14
‘bT2’ ( Bluetooth pairing Mode)
Parameters: None
Format: ‘bT2’
Output: ‘@’ if successful paring. ‘!’ if paring is failed within 90 seconds
Purpose: KDC200 starts pairing mode

KDC200 Programming Manual
15
‘bT3’ ( Bluetooth auto connection)
Parameters: 0 or 1
Format: ‘bT3<value>’, where <value> is 0 or 1
value Auto Connection Character Hex No.
0 Disable "0" 30
1 Enable "1" 31
Output: ‘@’ if successful. ‘!’ if failed. This command will be failed if sent when KDC200 is
connected to the HOST
Purpose: Enables(1)/Disables(0) KDC200 to try connection to Bluetooth HOST automatically after
power on
[Note] KDC200 auto connection mode can’t be changed to “Disable” from “Enable” while KDC200 is
connected to the host. One should disconnect host connection first then execute “bT30”.

KDC200 Programming Manual
16
‘bT4’ ( Bluetooth auto power on)
Parameters: 0 or 1
Format: ‘bT4<value>’, where <value> is 0 or 1
value Power on Character Hex No.
0 Disable "0" 30
1 Enable "1" 31
Output: ‘@’
Purpose: Enables(1)/Disables(0) KDC200 to turn on Bluetooth module power when scan button is
pressed

KDC200 Programming Manual
17
‘bT5’ ( Bluetooth auto power off)
Parameters: 0 or 1
Format: ‘bT5<value>’, where <value> is 0 or 1
value Power Off Character Hex No.
0 Disable "0" 30
1 Enable "1" 31
Output: ‘@’
Purpose: Enables(1)/Disables(0) KDC200 to turn Bluetooth module power off when KDC200 is
disconnected from Bluetooth host for a period of time defined in ‘bT71’ command. The
default power off time is 5 minutes.

KDC200 Programming Manual
18
‘bT6’ ( Bluetooth disconnection beep warning)
Parameters: 0 or 1
Format: ‘bT6<value>’, where <value> is 0 or 1
value Power on Character Hex No.
0 Disable "0" 30
1 Enable "1" 31
Output: ‘@’
Purpose: Enables(1)/Disables(0) KDC200 to beep on every 15 minutes when Bluetooth power is
on and Bluetooth is disconnected, but Auto power off option is disabled. KDC200 beeps 5
times with short intervals

KDC200 Programming Manual
19
‘bT70’ (Read Bluetooth auto power off timeout value)
Parameters: None
Format: ‘bT70’
Output: ‘<value>@’, where <value> is the timeout value (minute) of Bluetooth auto power off in
hexadecimal and @ means the end of <value>
Purpose: To get current Bluetooth auto power off timeout value
[Example] Output: 0x00, 0x00, 0x00, 0x05, 0x40
z0x05: Bluetooth auto power off is 5 minutes
z0x40: ASCII code of character “@” in hexadecimal