post

<h2>How to connection IDWedgeKB using USB Serial CDC driver to Linux Operating system</h2>
IDWedgeKB is a drivers license scanner with embedded drivers license parsing that interfaces to a computer as a USB Keyboard or USB Serial port.
This post details how to connect from Linux to the IDWedgeKB when it&#8217;s setup as a serial device and is targeted at developers who which to communicate directly with the IDwedgeKB via the USB Serial port on Linux computers.  
Most clients will use the USB keyboard interface which is plug and play on Linux, Windows and Apple operating systems.
<h3>Step By Step instructions</h3>
Configure IDWedgeKB to use USB Serial Port instead of USB Keyboard.  This is done by changing configuration parameters stored in config.txt file inside IDwedgeKB flash drive.  See IDwedgeKB User manual for details &#8211; visit www.idscanner.us for IDWedgeKB user manual.
Plug in IDWedgeKB into any USB port of computer.  The IDWedgeKY LED will blink green for about 3 seconds and a flash drive named upload disk may be recognized by the computer.  Then the IDwedgeKB LED will blink WHITE which indicates its in serial port mode.
Start a terminal window on linux and
type&#8212;  lsusb &#8211; which lists the USB devices.  The screenshots shown in this post are for a Raspberry Pi.
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-200139_655x390_scrot.png" alt="linux idwedgekb lsusb" width="655" height="390" class="alignleft size-full wp-image-3747" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
The device 2d94:0004 is the CDC USB Serial driver of the IDWedgeKB.
Type &#8212;  dmesg | grep &#8216;2d94&#8217;  &#8212; 2d94 is TokenWorks USB.org vendor ID
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-200928_655x390_scrot.png" alt="" width="655" height="390" class="alignleft size-full wp-image-3748" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
Note: the usb value 1-1.3 &#8211; the product ID 0001 is the upload disk which appears briefly during boot and the product ID 0004 is the Serial USB CDC driver.
Type &#8212;  dmesg grep | &#8216;usb 1-1.3&#8242; to list details about this USB device
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-200808_655x390_scrot.png" alt="idwedgekb id scanner linux dmesg" width="655" height="390" class="alignleft size-full wp-image-3749" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
This displays all the information known to linux based on the IDwedgeKB based on its USB descriptors.
The IDwedgeKB is recognized as a ttyACM0 device.  To find all the TTY devices recognized by LINUX,
type &#8212;  dmesg |grep &#8216;tty&#8216; to list all the tty devices
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-201017_655x390_scrot.png" alt="dmesg grep 'tty' idwedgekb serial linux" width="655" height="390" class="alignleft size-full wp-image-3750" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
There are a few TTY devices, The USB ACM device ttyACM0 is the IDWedgeKB.
To check the baud rate, type &#8212;  stty -F /dev/ttyACM0
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-201836_655x390_scrot.png" alt="linux determine serial port settings idwedgekb" width="655" height="390" class="alignleft size-full wp-image-3751" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
The baud rate is at 9600, but IDWedgeKB uses 115200, so set the baud rate to 115200 by
Type &#8212;   stty -F /dev/ttyACM0  115200  &#8211; this will set the baud rate to 115K
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-201922_655x390_scrot.png" alt="idwedgekb set baud linux id scanner drivers license reader" width="655" height="390" class="alignleft size-full wp-image-3752" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
Note: The baud rate has been changed on the Raspberry Pi to 115200
Next &#8211; run the screen application to open a serial emulator and interface with the IDWedgeKB.
If the screen app is not installed on the computer &#8211; type &#8212; sudo apt-get install screen &#8211; note: an internet connection is required
Type &#8212;  screen /dev/ttyACM0 &#8211; this will launch screen and allow communication with IDWedgeKB
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-201948_655x390_scrot.png" alt="screen linux serial terminal idwedgekb" width="655" height="390" class="alignleft size-full wp-image-3753" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
A new terminal screen will open.
Hit the enter key a couple of times, you should see ?? which is IDwedgeKB&#8217;s response to an unrecognized command.
Scan a drivers license in IDWedgeKB &#8211; it will output a comma delimited string of fields to the serial port which is displayed below.
<img loading="lazy" decoding="async" src="https://www.idscanner.com/wp-content/uploads/2017/09/2017-09-05-202022_655x390_scrot.png" alt="idwedgekb linux id scanner " width="655" height="390" class="alignleft size-full wp-image-3754" />
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
This shows the drivers license field data output via the USB serial port from IDWedgeKB
Other IDWedgeKB serial commands are
eseek &#8211; this displays the IDwedgeKB serial number
rawdata &#8211; this displays the raw data from the last scan
lastscan &#8211; this displays the last parsed scan data.
&nbsp;
This concludes the post.  Hopefully it helps developers who which to communicate directly with the IDwedgeKB via the USB Serial port on Linux computers
&nbsp;
&nbsp;
Note: This has been tested on a Dell C610 laptop running Ubuntu and a Raspberry Pi Zero W running RASPBIAN STRETCH WITH DESKTOP Version:August 2017
&nbsp;
&nbsp;