 |
 EZ-ID data packets - click on pic for larger image |
www.instrument.com - Monday, January 5, 2009
Printer-friendly version of the page "EZ-ID Biometric Reader Developer's Site"
(URL: http://instrument.com/.html)
The EZ-ID Biometric Fingerprint Reader functions as an independent device that communicates via a RS-232 serial connection to a HOST PC. That Host PC could be a standard Desktop PC that we all are familiar with, or it can be used with Intelligent Instrumentation's Family of Data Collection Terminals.
Fingerprints are stored locally on the EZ-ID Biometric Reader and with a request to Identify or Verify a persons fingerprint, the on-board algorithm to validate a persons fingerprint is performed by the device itself.
Communication between the built-in CPU and the Main Controller is performed through the serial port. There are two serial ports in the EX-ID Reader: one is called Channel 0, and the other is Channel 1. The communication speed can be set at 9600, 19200, 38400, 57600, or 115200 bps.
The RS-232 communication link between the EZ-ID reader and the host PC consists of a 12-byte packet representing the command to be executed by the EZ-ID reader. The EZ-ID reader returns a 12-byte packet that represents the results of the command executed.
The registering of fingerprint data might also be up-loaded from the EZ-ID reader and stored on the Host PC. The data representing the fingerprint consists of a binary 816-byte data file. In a networked based application, fingerprints could be registered and stored on the Host PC, then downloaded to the EZ-ID readers.
As stated above, the EZ-ID reader communicates over an RS-232 serial line. The default parameters are 9600 baud, No Parity, 8 Bits, and 1 Stop bit. No hardware control.
Sample programs for the EZ-ID Reader to communicate to our LANpoint PLUS/TIME, LANpointCE.NET and other terminals will be presented here.
The LANpoint PLUS/TIME, LANpointCE.NET, and LANpoint 7 terminals run WindowsCE.NET version 4.2 as their operation systems; since the EZ-ID reader is interfaced through a COM port, the OS really doesn't matter except for how the sample code is compiled and executed.
The LANpointPLUS/TIME LANpointCE.NET and LANpoint 7 terminals run WindowsCE.NET version 4.2 as their operating systems.
The sample programs provided for the LANpointPLUS/TIME and LANpointCE.NET terminals are written using Microsoft Embedded Visual C++ 4.0.
The legacy LANpointCE 3.0 terminals run WindowsCE 3.0 as the operating system
The sample programs provided for the LANpointCE 3.0 terminals are written using Microsoft Embedded Tools C++ 3.0. Note!!! Only the 1995-2000 version works. Please contact the factory on where to download this free version.
|
EZ-ID data packets - click on pic for larger image |
In all cases communicating with the EZ-ID reader means opening a specific serial COM port on the Host Terminal then sending specific commands to the EZ-ID reader. The EZ-ID Reader then responds back.
What is sent to the EZ-ID reader? Commands are sent to the EZ-ID reader in a 12-byte command format.
In the Command field, the command that the EZ-ID Processing Unit executes is specified. Some commands require a parameter to transmit data, and in this case, this is done through Param1 and Param2. If more data is transmitted in addition to Param1 and Param2 (more than 4 bytes data), lwExtraData and hwExtraData fields are used. The low word value of the length of data is stored in lwExtraData field, and the high word value in hwExtraData. The Checksum field is used to detect communication errors. The values of the first 11 bytes (excluding the checksum byte) are summed and then divided by 0x0100 (256). This will create a 1-byte shift. The remaining value from this shift is the checksum byte.
All commands are transmitted to the EZ-ID Reader from the Host terminal. The EZ-ID Reader replies to each command with an acknowledgement using the same format as the Command Packet. (The Command Packet is sent to the EZ-ID Reader from the Host, and the ACK packet is sent to the Host from the EZ-ID Reader.) The EZ-ID Reader sends the result of the command in the ErrorCode field of the ACK. If execution of the command is completed without error, the ErrorCode is ‘0’ (M2ERROR_NONE).
If this all sounds perfectly confusing do not despair, We have developed a DLL that contains calls that you can link with your application to perform all the necessary formatting for commands that need to be issued. Below are eVC++ projects for creating the DLL files.
|
DLL project for Embedded Tools 3.0 eVC++ for the discontinued LANpoint CE 3.0 terminal |
32 kB |
|
|
DLL project for Embedded Visual C++ 4.0 for LANpointCE.NET or LANpoint7 |
162 kB |
|
|
DLL project for Embedded Visual C++ 4.0 for LANpointPLUS/TIME. |
21 kB |
The following screen shots show the screens from the Fingerprint_tradeshow_Net sample program as seen on the LANpoint CE.NET and/or LANpoint7 graphic display.
|
 Fingerprint_tradeshow_Net sample program main page screen shot - click on pic to enlarge |
|
 Fingerprint_tradeshow_Net sample program function choice page screen shot - click on pic to enlarge |
|
|
Application project for Embedded eVC++ 3.0 for the discontinued LANpointCE 3.0 terminal |
362 kB |
|
|
Application project for Embedded Visual C++ 4.0 for the LANpointCE.NET or LANpoint7 terminal |
317 kB |
This is a slightly more sophisticated application for the EZ-ID reader for the LANpointCE.NET and LANpoint7. Below are the Sample Application projects for both terminals.
|
 fingerprint_demo_NET sample program main page screen shot - click on pic to enlarge |
|
 fingerprint_demo_NET sample program function choice page screen shot - click on pic to enlarge |
|
|
Application project for Embedded eVC++ 3.0 for the discontinued LANpointCE 3.0 terminal |
400 kB |
|
|
Application project for Embedded Visual C++ 4.0 for the LANpointCE.NET or LANpoint7 terminal |
448 kB |
For the LANpointPLUS/TIME terminals, you must take into consideration the 2-Line LCD display on the unit. This Embedded Visual C++ 4.0 sample program sends and receives commands to the EZID Reader from the COM2 port of the LANpointPLUS terminal. Tis EZID Reader sample program performs the following funtions on the LANpointPLUS terminal:
1 = Display version of the Fingerprint Reader.
2 = Display number of users in database.
3 = Add a new user to the database.
4 = Display UserID/Name of scanned fingerprint.
6 = Turns on Optic LED.
7 = Turns Off Optic LED.
9 = Erases all users in EZID reader.
0 or q = Exit program.
|
 |
|
|
Application project for Embedded Visual C++ 4.0 for LANpointCE.NET Terminal. |
368 kB |
The LANpointPRO is a DOS based terminal. This program was compiled for DOS with Borland 4.52 and uses a set of serial communcation tools, Greenleaf Comm++ 3.0
|
 EZ-ID sample program for the DOS LANpoint PRO terminal, project development screen shot - click pic to enlarge |
|
|
Application project for LANpointPRO using Borland 4.52. |
33 kB |
Copyright 1996-2009 Intelligent Instrumentation Inc.