⼆代⾝份证验证设备CM008RU⼆次开发控件ID2Control使⽤说明书
⼆代⾝份证验证设备CM008R/U
⼆次开发控件ID2Control 使⽤说明书
⽬录
1. 控件描述 (4)
1.1. 基本描述 (4)
1.2. 控件组成⽂件 (4)
1.3. 控件安装 (4)
1.3.1. 安装⽂件安装 (4)
1.3.
2. ⼿动安装 (5)
2. 属性⽅法列表 (5)
2.1. 属性列表 (5)
2.2. ⽅法列表 (5)
3. 调⽤流程 (6)
3.1. 顺序读卡调⽤流程 (7)
3.1.1. 设臵设备连接端⼝号 (7)
3.1.2. 端⼝打开及关闭 (7)
3.1.3. 设臵RF缓冲区⼤⼩ (7)
3.1.
4. 基本读卡调⽤流程 (8)
3.2. ⾃动读卡调⽤流程 (9)
3.2.1. 设臵设备连接端⼝号 (9)
3.2.2. 开启⾃动读卡功能 (9)
3.2.3. 获取⾝份证相关信息 (9)
3.2.
4. 停⽌⾃动读卡功能 (9)
4. 属性⽅法详细说明 (10)
4.1. 属性 (10)
Port—通讯端⼝号 (10)
Baudrate—串⾏通讯波特率 (10)
AutoOpenPort—是否⾃动打开/关闭端⼝ (10)
4.2. ⽅法 (10)
SetMaxRFByte—设臵RF缓冲区⼤⼩ (10)
OpenPort—打开端⼝ (11)
ClosePort—关闭端⼝ (11)
ResetSAM—复位安全模块 (11)
GetSAMStatus—对安全模块运⾏状态检测 (12)
GetSAMID—取得安全模块编号HEX码 (12)
GetSAMIDToStr—取得安全模块编号字符串 (12)
StartFindIDCard—开始寻卡 (13)
SelectIDCard—选取卡⽚ (13)
ReadBaseMsg—读取基本信息 (13)
ReadNewAppMsg—读取追加信息 (14)
ReadMngInfo—读取卡体管理号 (14)
DecodeToBMP—把WLT⽂件解码到BMP中 (15)
GetJPG—把BMP转换成JPG图像 (15)
GetBaseInfo—获取⾝份证卡上基本信息 (16)
GetAllInfo—获取⾝份证卡上所有信息 (16)
SearchDevice—查设备 (17)
StartAutoReadCard—开启⾃动读卡功能 (17)
StopAutoReadCard—关闭⾃动读卡功能 (17)
GetErrorMsg—获取错误代码对应的信息 (18)
GetNation—获取民族编号对应的民族信息 (18)
GetSex—获取性别代码对应的性别信息 (18)
GetComBaudrate—获取安全模块通讯波特率 (18)
SetCOMBaud—设臵安全模块通讯波特率 (19)
5. 错误代码表 (19)
6. 使⽤⽰例 (20)
6.1. VC调⽤⽰例 (20)
6.2. VB调⽤⽰例 (23)
6.3. Delphi调⽤⽰例 (25)
1.控件描述
1.1.基本描述
⼆代⾝份证验证设备CM008R/U的⼆次开发控件ID2Control是基于公安部安全模块接⼝API函数的基础上开发的，继承了公安部安全模块接⼝所有API函数功能，并增加了相应的转换函数，使得⼆次开发⽤户更易于开发。
控件是⽤VC开发的ActiveX控件，适⽤于所有Windows平台上各种语⾔的开发运⽤。
1.2.控件组成⽂件
ID2Control控件组成⽂件如下：
< 控件主⽂件
sdtapi.dll
WltRS.dll
Hiberfile.dll
Termb.lic 公安部授权⽂件，每个设备对应⼀个⽂件在使⽤时，必须把、sdtapi.dll、WltRS.dll、Hiberfile.dll 四个⽂件拷贝安装到Windows平台系统⽬录下（Win XP/NT/2K是System32，Win98/ME/CE是System），并注册
<⽅可使⽤。使⽤过程中⼀些⽅法会在系统⽬录下产⽣相⽚⽂件DTECCardPicture.bmp和DTECCardPicture.jpg 两个，为当前读到的持卡⼈的相⽚⽂件。另⽤户调⽤公安部解码函数⾃⾏解码相⽚时会在⽤户指定的⽬录下⽣成⽤户指定的相⽚⽂件。
1.3.控件安装
1.3.1.安装⽂件安装
点击开发包内Install⽬录下的执⾏安装，安装程序会⾃动拷贝相应的⽂件到系统⽬录下并注册，⽤户在使⽤中，必须在相应的开发IDE⾥装上
ID2Control控件（选取系统⽬录⾥的）⽅可使⽤，具体安装⽅法请参阅相应的语⾔开发书籍。
1.3.
2.⼿动安装
1.拷贝开发包内ocx⽬录下的四个⽂件、sdtapi.dll、
WltRS.dll、Hiberfile.dll到系统⽬录下（Win XP/NT/2K是System32，Win98/ME/CE是System）；
2.在相应的开发IDE⾥装上ID2Control控件（选取系统⽬录⾥的
<）。
⼿动注册控件⽅法如下：
//注册ID2Control控件
regsvr32 - //卸载ID2Control控件
2.属性⽅法列表
2.1.属性列表
2.2.⽅法列表
3.调⽤流程
⽤ID2Control控件读取第⼆代⾝份证卡内数据的⽅法组合很多，⽤户可以根据实际需要使⽤ID2Control内提供的相关属性及⽅法进⾏组合来读取，在使⽤过程中，控件内的属性⽅法⽤户不⽤每个都⽤到，能实现⽤户相应的功能和取到相应的数据即可。
这⾥提供两种简易的基本⽅法，其相应的读卡调⽤函数流程如下：
3.1.1.设臵设备连接端⼝号
⽅法1：利⽤控件内⽅法SearchDevice可⾃动查到当前接到PC机上的CM008R/U设备，成功后⽤户可通过读取Port属性来获知当前到的设
备连接的端⼝号。（查时需要⼀定的时间）
⽅法2：设臵属性Port值来设臵通讯连接的端⼝号。
控件⽀持USB⼝和串⾏通讯⼝：
串⼝取值为1到16，分别表⽰COM1到COM16；
USB⼝取值为1001到1016，分别表⽰USB1到USB16，
如：ID2Control.Port = 1; //设臵成COM1通讯
ID2Control.Port = 1001; //设臵成USB1通讯
注：控件在串⾏通讯时，默认为115200bps，不建议更改通讯波特率。
3.1.2.端⼝打开及关闭
控件内有⼀属性AutoOpenPort，设臵成TRUE后调⽤任何通讯函数便会⾃动打开关闭相应的端⼝，设臵成FALSE后必须调⽤OpenPort和ClosePort⽅法才能打开和关闭相应的端⼝；
3.1.3.设臵RF缓冲区⼤⼩
CM008R/U设备⽀持的RF缓冲区⼤⼩为24⾄250字节。
⽤户可以通过SetMaxRFByte⽅法来进⾏设臵，如：
ID2Control.SetMaxRFByte(200); //设臵成200字节
详细调⽤⽅法见控件属性⽅法详细说明。
注：⽬前第⼆代⾝份证内⽆追加信息⼀栏，调⽤ReadNewAppMsg时会返回0x91，表⽰证/卡中此项⽆内容。⽤户暂时可以省去调⽤ReadNewAppMsg（即直接跳过流程图上的ReadNewAppMsg步骤）。另在调⽤GetBaseInfo后，会在系统⽬录⾥⽣成当前读到的⼆代⾝份证卡的相⽚⽂件。
3.2.1.设臵设备连接端⼝号
⽅法1：利⽤控件内⽅法SearchDevice可⾃动查到当前接到PC机上的CM008R/U设备，成功后⽤户可通过读取Port属性来获知当前到的设
备连接的端⼝号。（查时需要⼀定的时间）
第三代身份证
⽅法2：设臵属性Port值来设臵通讯连接的端⼝号。