Tokenworks IDWedgeKB User Manual

Usb keyboard – usb virtual com port id scanner

Advertisement

Quick Links

IDWEDGEKB™ USERS GUIDE
USB KEYBOARD – USB VIRTUAL COM PORT
ID SCANNER
VERSION 2.3 SOFTWARE
.
Confidential
Page 1
8/18/2017

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the IDWedgeKB and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Tokenworks IDWedgeKB

  • Page 1 IDWEDGEKB™ USERS GUIDE USB KEYBOARD – USB VIRTUAL COM PORT ID SCANNER VERSION 2.3 SOFTWARE Confidential Page 1 8/18/2017...
  • Page 2: Copyright

    (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 2 8/18/2017...
  • Page 3: Table Of Contents

    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 ..................
  • Page 4 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: Introduction

    INTRODUCTION 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.
  • Page 6: Hardware Overview

    HARDWARE OVERVIEW The picture below shows the side view of the IDWedgeKB scanner and the location of the function button/LED indicator and RJ50 USB connector. POWER The USB cable supplies power to the Scanner. The Scanner should be connected to a standard USB 2.0 or higher port (i.e.
  • Page 7: Function Button/Indicator

    File System as well as new firmware copied to the drive memory of the device. LED STATUS Function Button This LED inside the translucent will flash when the IDWedgeKB is powered on. The colors and rate of flash determines which mode it is in: Mode Note...
  • Page 8: How To Scan Or Swipe License

    HOW TO SCAN OR SWIPE LICENSE 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.
  • Page 9: Software Overview - Formula And Configuration Files

    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.
  • Page 10 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 10 8/18/2017...
  • Page 11: Configuration File - Config.txt

    CONFIGURATION FILE – CONFIG.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.
  • Page 12: Magtrackcard

    MAGTRACKCARD MagTrackCard controls the output of Magstripe cards like Student Ids, AAA cards, etc.If enabled, the Magstripe.txt formulas will be active if a magnetic card is identified. If disabled, then Magstripe.txt formulas will be disabled. MIDINITIAL The MidInitial controls the output of the Middle name filed, if set to true then only the middle initial will be output, if set to false then the whole middle name (if available) will be output.
  • Page 13: Usbkeyboard

    If the USBKeyboard and USBSerialPort are both True or both False, then the USB flash drive will be activated when the IDWedgeKB is plugged into a PC so the user can fix this error in the config.txt file. Note: Please visit Serial port section of manual for instructions on installing virtual usb com port drivers.
  • Page 14: Driverslicense.txt

    DRIVERSLICENSE.TXT The Drivers license formula uses capital letter to represent the fields on a drivers license, ether barcode or magstripe cards; F – First name M – Middle name L – Last name T – Title A - Address C - City S - State Z –...
  • Page 15: Creditcard.txt

    CREDITCARD.TXT The Credit Card formula uses lower case letters to represent the fields on a credit card. a = Track1 Raw data b = Track2 Raw data f = first name, l= last name p = PAN or credit card number y = ExpYY, m = ExpMM n = Scanner S/N...
  • Page 16: Magnetic.txt

    The Magnetic Formula used to send fields to the host and is stored in a file on the SD card. To Access the Config.txt file, you must boot the IDWedgeKB while holding the battery button. The magnetic parsing formula will allow for two tracks to be parsed and two fields of specific lengths and specific offsets to be parsed per track for a total of 4 fields.
  • Page 17 If no second offset is required, then these fields are populated with zero and the unused lowercase field designators are not required For example, 1,1,6,0,0,2,1,6,0,0 q{TAB}s{TAB} Raw data can be extracted from each track by using the value 99 for the length. If you want to extract the Raw Data from tracks 1 and 2: 1,0,99,0,0,2,0,99,0,0 q{TAB}s{TAB}...
  • Page 18 The following list of cards is used to identify Drivers License/ID cards, Credit Cards and AAA cards. Track2 starts with and a length of Card Type ;000000 >28 old AZ state ID/DL ;06360 >28 old AK state ID/DL >36 Newfoundland ID/DL >36 Newfoundland ID/DL >28...
  • Page 19: Control Keys

    CONTROL KEYS The control keys are the non-printing keyboard strokes used in between the parsed field in the formula. The examples so far have included the Tab key {TAB} and the Enter key {ENTER}. The format of the control keys is an all-capital key word surrounded by curly braces (except for Pause). Each curly brace must be paired with another (left, right) or the formula will not work.
  • Page 20: Inserting Static Text

    The formula and configuration files are created by the IDWedgeKB when it is first powered up at the factory. User 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.
  • Page 21 This file was created because a problem was found in the above file, it will be deleted when the problem is cleared. To restore a default version of any file, just erase the file and reboot For more details, See IDWedgeKB user manual at www.idscanner.com...
  • Page 22: Type Of Tests And Example Of Diagnostic Messages

    TYPE OF TESTS AND EXAMPLE OF DIAGNOSTIC MESSAGES The type of tests that are performed on the files depends on the contents, there are up to 4 different tests run on a file to determine if it meets minimum requirements. CONFIG.TXT TEST AND MESSAGE The configuration file contains four different tests.
  • Page 23: Magnetic.txt Card Formula Test And Message

    ACCESSING THE FILE SYSTEM FOR EDITING The process for accessing the file system of IDWedgeKB involves holding the side function button depressed, while plugging in the USB cable. After the initial install which may load some drivers, you will...
  • Page 24: Editing And Clearing Problem.txt

    Open with Windows Explorer. EDITING AND CLEARING PROBLEM.TXT Once you have accessed the file system, you can use Windows Notepad app to edit the text files. Below is an example of a simple formula to print a two line address to a text file for DriverLicense.txt: F{TAB}M{TAB}L{ENTER}A{TAB}C{TAB}S{TAB}Z{ENTER} This next example shows an error in the number of braces (extra brace on end) that would create the Problem.txt file with a message Curly Brace { } Pair test fails in DriversLicense.txt...
  • Page 25 Ensure nothing is trying to pair with the device during power up/Bit test or else the BIT test will fail, see appendix 1. Example of the Pause command in a formula: F{TAB}M{TAB}L{TAB}A{TAB}C{TAB}S{TAB}Z{Pause 5} The above formula prints out a typical contact with name and address and after the last field, which is Zip code;...
  • Page 26: Serial Port Mode

    USB Virtual Com Port Driver with directions available for download at: http://www.idscanner.us/idwedge- kb/idwedgekb-virtual-com-serial-port-inf-driver-signed/ SERIAL PORT MODE DL/ID CARD CSV STRING For Drivers License/ID cards the data will be output using a fixed formula string that represents each field, separated by a comma.
  • Page 27: Serial Port Mode Credit Card Csv String

    Example of Drivers License Serial Mode Output: SOH, STX = 01,02 ETX,EOT = 03,04 SERIAL PORT MODE CREDIT CARD CSV STRING For credit cards the data will be output using a formula string that represents each field, separated by a comma.
  • Page 28: Serial Port Mode Magnetic Cards Csv String

    Example of Bank Card Output: SOH, STX = 01,02 ETX,EOT = 03,04 SERIAL PORT MODE MAGNETIC CARDS CSV STRING The Magnetic cards will still require a formula, and that formula should be modified to include Commas to create the CSV string. The Magnetic.txt stores the formula for Magnetic cards and must have two lines of data;...
  • Page 29 Below is an example of the Magnetic.txt file for the formula above. Example: 1,2,4,6,9,2,1,5,6,5 q[,]r[,]s[,]t If no second offset is required, then these fields are populated with zero and the unused lowercase field designators are not required For example, 1,1,6,0,0,2,1,6,0,0 q[,]s If you want to extract the Raw Data from tracks 1 and 2: 1,0,99,0,0,2,0,99,0,0...
  • Page 30: Examples Of Serial Port Mode Output 1D Barcode Messages

    EXAMPLES OF SERIAL PORT MODE OUTPUT 1D BARCODE MESSAGES For 1D barcodes – if enabled, the output will be the start / end characters plus the 1D barcode. Example of 1DBarcode: SOH, STX = 01,02 ETX,EOT = 03,04 Confidential Page 30 8/18/2017...
  • Page 31: Document Change Log

    DOCUMENT CHANGE LOG Version Description of Change Author Date Initial 10272016 1.01 Format Changes 11012016 1.02 Add file system test feature 11102016 1.03 Review latest firmware, create open issues at end 12142016 of document, and highlight in yellow in doc 1.04 Resolve open issues 12262016...
  • Page 32: Appendix A Drivers License Data Stripe Technology

    The ID Scanner Reads 2D Bar Codes and Magnetic Stripes. This section explains how to recognize which is on the drivers license. For latest details on which state has which technology – visit https://www.tokenworks.com/coverage-chart/ If a license has both, we suggest you scan the 2D Bar code first and the magnetic stripe to verify the information on the screen is the same from both scans.
  • Page 33 MILITARY IDS To Scan Military IDs, SCAN the 2D Bar Code. DO NOT SCAN THE 1D BAR CODE OR MAGNETIC STRIPE Confidential Page 33 8/18/2017...
  • Page 34: Appendix B Idwedgekb Dimensions And Specs

    APPENDIX B IDWEDGEKB DIMENSIONS AND SPECS Confidential Page 34 8/18/2017...
  • Page 35 Confidential Page 35 8/18/2017...
  • Page 36: Appendix C - Optional Kiosk Cable

    APPENDIX C – OPTIONAL KIOSK CABLE An optional Kiosk connector and cable allow fixed mounted installations for Kiosks. This connector and cable are used in place of the standard side USB cable which has RJ50 connector CN8436 Kiosk Cable Confidential Page 36 8/18/2017...

This manual is also suitable for:

Idwedgekb

Table of Contents