国腾GTICR-100身份证阅读器函数包开发手册

广州万特信息科技有限公司独家整理

2013.03

国腾身份证阅读器文档控制

GTICR100-01文档更新记录

目   录

1     国腾GTICR-100身份证阅读器概述

2     身份证阅读器函数包定义.... 4

3     开发函数列表.... 4

4     开发函数调用流程.... 6

5     国腾二代证阅读器开发函数说明.... 6

6     用户信息函数组使用时的调用顺序说明.... 11

7     一个完整的示例：.... 12

1         国腾GTICR-100身份证阅读器概述

   本手册是操作身份证阅读器应用函数的定义格式、调用方法和返回值的说明。

1.      使用USB接口则请先安装对应系统的USB驱动；

2.      termb.dll是主DLL， WltRS.dll被termb.dll调用；用户可不必关心WltRS.dll，但2个DLL要求要放在同一个目录下；

3.      termb.dll和WltRS.dll同时拷贝到调用此Dll的应用软件Exe文件所在目录下。

4.      termb.dll 输出的文件放在调用者(*.exe)所在目录；

2         身份证阅读器函数开发包定义

应用函数开发包含在下列文件：

termb.dll       API函数的动态联接库

       （termb.dll的输出文件放在调用者所在目录中）

适用操作系统：

      Windows NT: 需要NT 3.1版或以后版本

   Windows:    需要 Windows 98、Windows 2000或以后版本

适用开发语言：

   Visual C++  5.0 及以后版本

   Visual Basic 5.0 及以后版本

   DELPHI        3.0 及以后版本

   PowerBuilder 6.0 及以后版本

3       开发函数列表

4         开发函数调用流程

5       国腾二代证阅读器开发函数说明

5.1 初始化串口

原    型：int InitComm (int Port)

说    明：本函数用于计算机的设备初始化。

参    数：Port：  设置设备号

返回 值：

示   例：

             #include<termb.h>

      int main()

             {

                    int li_ret=0;

      int li_Port=1;

                            li_ret=InitComm(li_Port);

             return li_ret;

             }

5.2 关闭串口

原    型：

            int CloseComm(void)

说    明：本函数用于关闭计算机已经打开的串口。

参    数：无

返回 值：

示   例：

             #include<termb.h>

      int main()

             {

             int li_ret=0;

                            li_ret=CloseComm()

             return li_ret;

             }

5.3 卡认证

原    型：int Authenticate (void)

说    明：本函数用于读卡器和卡片之间的合法身份确认。

参    数：无

返回 值：

注意：若卡片放置后发生认证错误时，应移走卡片重新放置。

示   例：

             #include<termb.h>

      int main()

      {

                    intli_ret=0;

                            li_ret=authenticate ()

                    returnli_ret;

      }

注意：若采用查询方式自动判断卡片是否放置，则间隔时间建议大于300ms。

5.4读卡操作

原    型：int Read_Content(int Active)；

说    明：本函数用于通过读卡器从非接触卡中读取相应信息。

参    数：Active   读取信息类型

返回 值：

注意：

1、  读完基本信息后，若需要立即读取最新住址信息或芯片管理号，在未移走卡片的情况下可以不用卡认证；

2、  单独读取最新住址信息或芯片管理号时，需要先进行卡认证；

3、若卡片放置后发生读卡错误时，应移走卡片重新放置。

文字信息采用GB 13000的UCS-2进行存储，各项目分配如下：

芯片管理号分配如下：

5.5 用户信息函数组

      该组函数用于读取当前系统缓冲中的二代证卡内信息。该组函数具有如下特点：

l      得到的字符信息全部为ANSI编码方式；可以直接用来显示；

l      得到的字符信息已经按照相关标准作了相应转换；将性别编码转换成了相应的文字信息（如1-“男”），将民族编码转换成了相应的文字信息（如04-“藏”）；

l      该组函数返回值表示一致，含义如下：

0：表示取到的字符信息不完整，增大strTmp参数分配的内存，就可完整读出信息；

 （用户信息各字段的长度定义见下表）

非0：表示读出的字节总数；

用户信息各字段的长度定义           （单位：字节）

A．             读取卡内姓名信息

原    型：int STDCALLGetPeopleName(char *strTmp, unsigned int strLen);

说    明：本函数用于读取ANSI字符编码方式的姓名信息；

参    数：[out] strTmp  读到的信息；

             　[in]  strLen   表示strTmp 参数分配的内存空间大小（单位：字节）；

B． 其他函数原型如下：

读性别信息：

int _stdcall GetPeopleSex(char*strTmp, unsigned int strLen);      

读民族信息：

int _stdcallGetPeopleNation(char *strTmp, unsigned int strLen);    

读出生日期：

int _stdcallGetPeopleBirthday(char *strTmp, unsigned int strLen);  

读住址信息：

int _stdcallGetPeopleAddress(char *strTmp, unsigned int strLen);    

读身份号码：

int _stdcallGetPeopleIDCode(char *strTmp, unsigned int strLen);    

读签发机关：

int _stdcallGetDepartment(char *strTmp, unsigned int strLen);

读有效启始日期：

int _stdcallGetStartDate(char *strTmp, unsigned int strLen);    

读有效截止日期：

int _stdcallGetEndDate(char *strTmp, unsigned int strLen);    

读保留信息：

int _stdcallGetReserve(char *strTmp, unsigned int strLen);

读照片信息：

int _stdcallGetPhotoBMP(char *Photo, unsigned int Len);

5.6  数据解析函数

以下两个函数主要是用在无卡状态下解析保存在文件中的历史二代证信息；

l       将人员基本信息文件名（带全路径）通过SetBaseData函数送入termb.dll中后，该Dll 将解析人员基本信息；外部程序可通过调用“读用户信息函数组”中的函数得到想要的信息；

l       将人员WLT类型的照片文件名（带全路径）通过SetPhoteData函数送入termb.dll后，在二代证机具联机状态下（不需要卡），该dll将WLT文件解压成BMP文件，外部程序可通过调用“读用户信息函数组”中的GetPhotoBMP函数得到BMP文件的内容信息；

l       参数说明：[in] Fname    文件的全路径名；

l       返回值说明：1——表示正确执行了功能；

0——表示文件已损坏，或非标准格式，或文件大小过大；

A.    设置人员基本信息

int _stdcallSetBaseData(char *FName);

B.    设置人员照片信息；

int _stdcallSetPhoteData(char *FName);

6         用户信息函数组使用时的调用顺序说明

6．1  联机工作状态下：

6．2  无卡时对保存在文件中的信息进行解析时：

备注：上述两种应用场景可灵活的动态切换。

7         一个完整的示例：

DELPHI调用示例：

unit Unit1;

interface

uses

 Windows, Messages, SysUtils,Classes, Graphics, Controls, Forms, Dialogs,

 StdCtrls, Buttons, ExtCtrls;

type

 TForm1 = class(TForm)

   BitBtn1: TBitBtn;

   Button2: TButton;

   Button3: TButton;

   Image1: TImage;

   procedureFormClose(Sender: TObject; var Action: TCloseAction);

   procedureBitBtn1Click(Sender: TObject);

   procedureFormCreate(Sender: TObject);

   procedureButton3Click(Sender: TObject);

   procedureButton2Click(Sender: TObject);

 private

   { Private declarations }

 public

   { Public declarations }

 end;

var

 Form1: TForm1;

mInitComm:Function(Port:integer):integer;Stdcall;

 mCloseComm:Function:integer;stdcall;

mAuthenticate:Function:integer;stdcall;

mRead_Content:Function(Active:integer):integer;stdcall;

GetName:Function(info:pchar;len:integer):integer;stdcall;

GetSex:Function(info:pchar;len:integer):integer;stdcall;

 GetNation:Function(info:pchar;len:integer):integer;stdcall;

GetAddress:Function(info:pchar;len:integer):integer;stdcall;

GetBirthday:Function(info:pchar;len:integer):integer;stdcall;

GetCode:Function(info:pchar;len:integer):integer;stdcall;

 GetDepartment:Function(info:pchar;len:integer):integer;stdcall;

GetStartDate:Function(info:pchar;len:integer):integer;stdcall;

GetEndDate:Function(info:pchar;len:integer):integer;stdcall;

GetReserve:Function(info:pchar;len:integer):integer;stdcall;

 GetPhotoBMP:Function(info:pchar;len:integer):integer;stdcall;

SetBaseData:Function(filename:string):integer;stdcall;

SetPhotoData:Function(filename:string):integer;stdcall;

 DLLHandle:Integer;

implementation

{$R *.DFM}

procedure TForm1.FormCreate(Sender: TObject);

var i:integer;

   DLLPath:String;

begin

DLLPath:=ExtractFiledir(Application.exeName);

DLLPath:=DLLPath+'\termb.dll';

DLLHandle:=LoadLibrary(Pchar(DLLPath));

@mInitComm:=GetProcAddress(DLLHandle,'InitComm');

@mCloseComm:=GetProcAddress(DLLHandle,'CloseComm');

@mAuthenticate:=GetProcAddress(DLLHandle,'Authenticate');

@mRead_Content:=GetProcAddress(DLLHandle,'Read_Content');

@GetName:=GetProcAddress(DLLHandle,'GetPeopleName');

@GetSex:=GetProcAddress(DLLHandle,'GetPeopleSex');

 @GetNation:=GetProcAddress(DLLHandle,'GetPeopleNation');

@GetAddress:=GetProcAddress(DLLHandle,'GetPeopleAddress');

@GetBirthday:=GetProcAddress(DLLHandle,'GetPeopleBirthday');

@GetCode:=GetProcAddress(DLLHandle,'GetPeopleIDCode');

 @GetDepartment:=GetProcAddress(DLLHandle,'GetDepartment');

@GetStartDate:=GetProcAddress(DLLHandle,'GetStartDate');

@GetEndDate:=GetProcAddress(DLLHandle,'GetEndDate');

@GetReserve:=GetProcAddress(DLLHandle,'GetReserve');

@GetPhotoBMP:=GetProcAddress(DLLHandle,'GetPhotoBMP');

@SetBaseData:=GetProcAddress(DLLHandle,'SetBaseData');

@SetPhotoData:=GetProcAddress(DLLHandle,'SetPhotoData');      

end;

procedure TForm1.FormClose(Sender: TObject; var Action:TCloseAction);

begin

 if DLLHandle<>nullthen

   freeLibrary(DLLHandle);

end;

procedure TForm1.BitBtn1Click(Sender: TObject);

begin

 mInitComm(1);

 sleep(1000);

 mAuthenticate;

 sleep(2000);

 mRead_Content(1);

 sleep(2000);

 Button3Click(self);

 Application.ProcessMessages;

 mRead_Content(2);

 sleep(2000);

 mRead_Content(3);

 sleep(1000);

 mRead_Content(5);

 sleep(1000);

 mCloseComm;

end;

procedure TForm1.Button3Click(Sender: TObject);

var info:array[1..100] of char;

   photo:array[1..102400] ofchar;

   fileHandle:THandle;

   Len:integer;

begin

 fillchar(info,100,#0);

 GetName(@info[1],100);

 showmessage(info);

  fillchar(info,100,#0);

 GetSex(@info[1],100);

 showmessage(info);

  fillchar(info,100,#0);

 GetNation(@info[1],100);

 showmessage(info);

  fillchar(info,100,#0);

 GetAddress(@info[1],100);

 showmessage(info);

 fillchar(info,100,#0);

 GetBirthday(@info[1],100);

 showmessage(info);

  fillchar(info,100,#0);

 GetCode(@info[1],100);

 showmessage(info);

 fillchar(info,100,#0);

 GetDepartment(@info[1],100);

 showmessage(info);

  fillchar(info,100,#0);

 GetStartDate(@info[1],100);

 showmessage(info);

 fillchar(info,100,#0);

 GetEndDate(@info[1],100);

 showmessage(info);

 fillchar(info,100,#0);

 GetReserve(@info[1],100);

 showmessage(info);

 fillchar(photo,100,#0);

Len:=GetPhotoBMP(@photo[1],100*1024);

fileHandle:=FileCreate('F:\VC++Project\IDCardReader\Debug\photo.bmp');

 if fileHandle<>0  then

 begin

  FileWrite(fileHandle,photo,Len);

   FileClose(fileHandle);

  image1.Picture.LoadFromFile('F:\VC++Project\IDCardReader\Debug\photo.bmp');

 end;

end;

procedure TForm1.Button2Click(Sender: TObject);

var txtFile:string;

   Wltfile:String;

begin

txtFile:='F:\VC++Project\IDCardReader\Debug\WZ.txt';

wltFile:='F:\VC++Project\IDCardReader\Debug\XP.wlt';

 SetBaseData(txtFile);

 SetPhotoData(wltFile);

 Button3Click(self);

end;

end.

注意：以上为广州万特科技整理的国腾第二代身份证阅读器函数开发包开发使用手册，GTICR-100型号的身份证阅读器开发参考函数，其他产品推荐：新中新 http://www.cntrades.com/b2b/wonte/sell/itemid-15604737.html