Tokenworks IDWedgeKB User Manual
Confidential Page 1 8/18/2017
IDWEDGEKB™ USERS GUIDE
USB KEYBOARD – USB VIRTUAL COM PORT
ID SCANNER
VERSION 2.3 SOFTWARE
.
Confidential Page 2 8/18/2017
COPY RIGHT
Copyright 2002 - 2017 TokenWorks, Inc. Printed in the USA
Information in this document is subject to change without notice. No part of this document may be
reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose,
without the express written permission of TokenWorks, Inc.
www.TokenWorks.com (Company Web Site),
www.IDScanner.com (Product Web site)
www.IDScanner.us (Support Site)
TokenWorks®, CardVisor®, CardTool®, IDVisor® , AgeVisor®and IDWedge®are registered trademarks of
TokenWorks, Inc. IDWedgeKB and IDWedgeBT is a TokenWorks Inc trademark.
Confidential Page 3 8/18/2017
Copyright ........................................................................................................................................... 2
Introduction ....................................................................................................................................... 5
Document overview............................................................................................................................ 5
Support Site – IDScanner.us ................................................................................................................ 5
Hardware overview ........................................................................................................................... 6
Power ......................................................................................................................................................... 6
Function Button/indicator ......................................................................................................................... 7
LED Status .................................................................................................................................................. 7
How to Scan or Swipe License ............................................................................................................. 8
Software overview - Formula and Configuration Files ........................................................................... 9
Reading/Writing Formula and Configuration files ..................................................................................... 9
Configuration file – Config.txt .................................................................................................................. 11
Version ................................................................................................................................................ 11
CreditCard ........................................................................................................................................... 11
1DBarcode ........................................................................................................................................... 11
MagTrackCard ..................................................................................................................................... 12
MidInitial ............................................................................................................................................. 12
FirstInitial ............................................................................................................................................ 12
5DigitZip .............................................................................................................................................. 12
DobYYOnly .......................................................................................................................................... 12
ExpYYOnly ........................................................................................................................................... 12
ScanMsg .............................................................................................................................................. 12
DisableMagDL_CC ............................................................................................................................... 12
USBKeyboard ...................................................................................................................................... 13
USBSerialPort ...................................................................................................................................... 13
CharDelay ............................................................................................................................................ 13
Confidential Page 4 8/18/2017
Formula Files – Driverslicense, creditcard, oneDBar, & Magnetic ........................................................... 13
Driverslicense.txt ................................................................................................................................ 14
CreditCard.txt ...................................................................................................................................... 15
OneDbar.txt ........................................................................................................................................ 15
Magnetic.txt ........................................................................................................................................ 16
Control keys ............................................................................................................................................. 19
Inserting Static text .................................................................................................................................. 20
Formula and Config File Testing and Problem.txt................................................................................ 20
Type of tests and example of diagnostic messages ................................................................................. 22
Config.txt test and message ................................................................................................................ 22
Card Formula files test and message .................................................................................................. 22
Magnetic.txt card formula test and message ..................................................................................... 23
Accessing the file system for editing ........................................................................................................ 23
Editing and clearing Problem.txt ............................................................................................................. 24
Additional Information and Examples ................................................................................................ 24
Serial Port Mode ............................................................................................................................... 26
Serial Port Mode DL/ID Card CSV string .................................................................................................. 26
Serial Port Mode Credit Card CSV string .................................................................................................. 27
Serial Port Mode Magnetic cards CSV string ........................................................................................... 28
Examples of Serial Port Mode Output 1D BarCode messages ................................................................. 30
Document Change Log ...................................................................................................................... 31
Appendix A Drivers License Data Stripe Technology ........................................................................... 32
Appendix B IDWedgeKB Dimensions and Specs .................................................................................. 34
Appendix C – Optional KIOSK Cable ................................................................................................... 36
Confidential Page 5 8/18/2017
INT R ODUCTI O N
The IDWedgeKB is a barcode/magnetic card scanner that supports a USB connection to a host
computer and functions as a USB Keyboard device or Virtual Serial Port ID ID/Card Scanner
(depending on configuration). Cards are scanned and parsed into fields, and these fields are sent as
keyboard strokes to the host via the USB keyboard driver or as a fixed order, comma delimited data
string via the USB Virtual Com Port. The configuration of the device, keyboard formulas are defined
by files stored in the IDWedgeKB Flash memory.
DO C U M ENT O V ERVIEW
This document will describe the basic functionality of the IDWedgeKB and how to configure the
application parameters and formulas used to control the output of data from the scanner for the
HID-Keyboard mode and Serial Port mode.
SUPP O RT SI T E – ID S CANNER . U S
Please visit IDScanner.us for latest application notes, software, troubleshooting help for IDWedgeKB. We
use this site to support customers so please review this material.
Confidential Page 6 8/18/2017
HA RD WARE O V ERVIE W
The picture below shows the side view of the IDWedgeKB scanner and the location of the
function button/LED indicator and RJ50 USB connector.
POW E R
The USB cable supplies power to the Scanner. The Scanner should be connected to a standard USB 2.0 or
higher port (i.e. supply 500Ma of power). Note: Some older mobile laptops/tablets do not have standard
USB ports which can drive 500 mA. There is no on/off button, the USB cable connected to the PC is the
equivalent to the powered on state, and removing the cable powers off the Scanner.
The supplied USB – RJ50 cable provides communication and power to the IDWedgeKB scanner.
Confidential Page 7 8/18/2017
FU N C TION BU T TON/I NDICATO R
The Function button/indicator is used to force the scanner into USB flash drive mode and allow access the
configuration memory of the Scanner. If you press and hold this button during power up, you will put the
device into USB Flash drive mode (i.e. USB thumb drive). The configuration and formulas files can be
edited via the File System as well as new firmware copied to the drive memory of the device.
LED STATUS
This LED inside the translucent
Function Button
will flash when the IDWedgeKB is powered on. The
colors and rate of flash determines which mode it is in:
LED Mode Note
Green Flashing flash/sec Boot loader Drive Special Mode for
firmware recovery
Green Flashing– 1 flash/sec Flash Thumb Drive Edit configuration and
formula files
Blue Flashing – 3 flash / sec USB Keyboard Normal Operating
Mode
White Flashing 3 flash / sec USB Serial Com port Normal Operating
Mode
Confidential Page 8 8/18/2017
HO W TO SCA N OR SW I PE LI C E N SE
2D Barcode
Scanning
For states like NY with 2D
bar code and Military IDs,
insert bar code with bar
code facing slot as
shown.
Magnetic Stripe
Swiping
For states like California
with a Magnetic Stripe,
swipe license with
magnetic stripe facing
slot as shown.
Confidential Page 9 8/18/2017
SOFT WARE O V ERVIEW - FORM U LA AND CONFIG U RATION F ILES
The formula and the default configuration files are created by the IDWedgeKB. Users then can modify
these files to customize the behavior of IDWedgeKB. If a file is erased, the default version of the file will
be re-created during next power cycle. Additionally, there are automatic test performed on these files
during power up, to ensure the files adhere to some basic formatting rules. If an error is detected, a
diagnostic file called: Problem.txt will be created and contain the error condition to be fixed, and the
name of the file that contains the error. Once the file’s error(s) have been corrected, the Problem.txt file
will be automatically deleted during the next power cycle. This diagnostic file will remain, until all errors
have been cleared.
REA DING/WR I TING FO RMULA AND CO NFIGURAT I O N FILES
To Access the Formula and Configuration files, you must hold the function button during power up. Once
you have connected via USB cable and can explore the contents of the scanner memory, you will be able
to read and write the Formula and Config.txt file. You can use any SIMPLE text editor like note.exe to
change items in the file and save them to the memory. DO NOT USE WORD AS IT WILL ADD FORMATING
INFORMATION WHICH WILL CORRUPT THE FILE FORMAT.
Press and hold the function button after you connect the USB cable to a PC and you will see the new drive
dialog box below.
Select Continue without scanning, and you will see:
Confidential Page 10 8/18/2017
Open with Windows Explorer.
The file system normally contains 6 files as seen in this screen shot:
The above files control the behavior of IDWedgeKB.
Confidential Page 11 8/18/2017
CONF IGURAT ION FILE – CON F IG.TXT
The IDWedgeKB uses a configuration file called Config.txt to control some basic hardware parameters. If
the file gets erased, it will be re-created automatically using factory default settings during next power on.
If the file contains editing errors or is corrupted and cannot be opened, then a file called Problem.txt will
be written to the SD card. Once the errors have been corrected and the file can be read, the Problem.txt
file will be automatically erased. Tip – If unable to fix config.txt, just erase config.txt to return to factory
default state.
Below is an example of the contents of the default Config.txt file followed by an explanation of what each
field does.
<Version=2.3>
<CreditCard=True>
<1Dbarcode=True>
<MagTrackCard=True>
<MidInitial=False>
<FirstInitial=False>
<5DigitZip=False>
<DobYYOnly=False>
<ExpYYOnly=False>
<ScanMsg=True>
<DisableMagDL_CC=False>
<USBKeyboard=True>
<USBSerialPort=False>
<CharDelay=0>
VE R SION
This is the firmware version, e.g. 2.3 and reflects the latest version of code.
CRE D ITCARD
CreditCard Controls the output of Bank Card scans, if enabled, then Magstripe cards that are identified as
Bank Cards will be parsed and the fields will be available for use in CreditCard.txt formulas. If CreditCard
is disabled, then CreditCard.txt formulas will be disabled.
1DB A RCODE
1DBarcode controls the output of Code 39 and Code128 barcodes, if enabled then OneDbar.txt formula
will be active. If 1DBardcode is disabled, then there will be no output when a Code 39 or Code128 barcode
is scanned.
Loading...