API接口函数库使用说明部文件：V1.0.20发布时间：2015-04-29版本更新记录目录API接口函数库使用说明 (1)1. 文档概述 (6)1.1. 文档围 (6)1.2. 面向对象 (6)1.3. 参考资料 (6)2. 函数库介绍 (6)2.1. 功能 (6)2.2. 性能 (7)3. 运行环境 (7)3.1. 硬设备 (7)3.2. 软件的运行平台 (7)3.3. 函数调用方法 (8)3.3.1. Delphi调用32位动态库的方法 (8)3.3.2. VB调用32位动态库的方法 (9)3.3.3. VC调用32位动态库的方法 (11)4. API介绍 (11)4.1. 函数调用流程 (11)4.1.1. 非接触式存储卡API调用流程 (11)4.1.2. 非接触式CPU卡片API调用流程 (12)4.1.3. 接触式CPU卡片API调用流程 (12)4.1.4. 接触式存储卡片API调用流程 (12)4.1.5. API调用流程 (12)4.1.6. 函数操作结果信息表 (16)4.2. 设备操作函数组 (19)4.2.1 打开读写器device_open (19)4.2.2 关闭读写器device_close (19)4.2.3 判断设备通讯类型device_gettype (19)4.2.4 设置通讯波特率device_setbaud (20)4.2.5 获取读写器版本信息device_version (20)4.2.6 读写器蜂鸣device_beep (21)4.2.7 LED灯控制 device_ledctrl (21)4.2.8 获取读写器生产序列号 device_readsnr (22)4.2.9 获取设备状态 get_device_status (22)4.2.10 读取读卡器的EEPROM (23)4.2.11更新读卡器的EEPROM (23)4.2.12 复位串口配置信息 ReSetupComm (24)4.2.13 读卡器软复位 device_reset (24)4.2.14 获取设备状态扩展 get_device_statusEx (25)4.2.15 获取非接触式CPU卡卡片状态 dev_cardstate (25)4.2.16 获取接触式CPU卡到位状态 ICC_GetStatus (26)4.2.17 读EMID号Dev_GetEMID (26)4.3 接触式卡片操作函数 (27)4.3.1 判断接触式卡片状态sam_slt_getstate (27)4.3.2 接触式卡片上电复位sam_slt_reset (28)4.3.3 接触式卡设置复位波特率sam_slt_reset_baud (28)4.3.4 接触式卡片下电sam_slt_powerdown (29)4.4. 非接触 CPU 卡函数 (29)4.4.1 激活非接触式卡open_card (29)4.4.2 设置非接触式卡片为halt状态 rf_halt (30)4.4.3 应用层传输命令card_APDU (31)4.5 非接触式存储卡操作函数 (31)4.5.1 激活非接触式存储卡rf_card (31)4.5.2 非接触式存储卡认证扇区 rf_authentication (33)4.5.3 非接触式存储卡读数据rf_read (33)4.5.4 非接触式存储卡写数据rf_write (34)4.5.5 非接触式存储卡读值块rf_readval (34)4.5.6 非接触式存储卡写值块rf_initval (35)4.5.7 非接触式存储卡加值rf_increment (35)4.5.8 非接触式存储卡减值rf_decrement (36)4.5.9 非接触式存储卡值传送 rf_transfer (36)4.6 二代操作函数 (37)4.6.1 卡操作指令-读卡IDCard_Read (37)4.6.2 卡操作指令-读卡IDCard_ReadCard (39)4.6.3卡操作指令根据索引获取数据IDCard_GetCardInfo (40)4.6.4 获取二代证模块ID IDCard_GetModeID (40)4.6.5 读卡模块扩展一IDCard_ReadCard_Extra (41)4.6.6 设置二代证照片存储路径 IDCard_SetPhotoPath (41)4.6.7 设置二代证照片名字 IDCard_SetPhotoName (42)4.6.8 读二代证信息扩展二 IDCard_ReadCard_Ex (42)4.6.9 删除所有二代证照片文件delete_all_photofile (44)4.6.10 获取卡ID号IDCard_Read_IDNUM (44)4.6.11 获取卡IDCard_Name (45)4.6.12 获取卡性别IDCard_Sex (45)4.6.13 获取卡名族IDCard_Nation (46)4.6.14 获取卡出生日期IDCard_Birthday (46)4.6.15 获取卡出生地址IDCard_Address (47)4.6.16 获取卡号IDCard_IDNumber (47)4.6.17 获取卡签发机构IDCard_IssueDepartment (48)4.6.18 获取卡有效期起始日期IDCard_ValidFromDate (48)4.6.19 获取卡有效期截止日期IDCard_ValidExpiryDate (49)4.6.20 获取卡预留信息IDCard_Reserve (49)4.6.21 获取非接触式卡片类型CLCard_Open (50)4.6.22 获得读卡过程中生成文件的Base64编码 GetFileBase64Buffer (51)4.6.23 读取二代证信息扩展三 IDCard_ReadCard_ExTwo (51)4.6.24 wlt转bmp文件 iWlttoBmp (52)4.6.25 读二代证追加信息 (52)4.7 工具函数 (53)4.7.1 将 16 进制数转换为 ASCII 字符hex_asc (53)4.7.2 将 ASCII 字符转换为 16 进制数asc_hex (53)4.7.3 DES 算法加密函数rf_encrypt (54)4.7.4 DES 算法解密函数 rf_decrypt (55)4.7.5 将 16 进制数转换为 Base64 字符hex_base64 (56)4.7.6 将 Base64字符转换为16进制数base64_hex (56)4.7.7 DES 算法加密函数des_encrypt (57)4.7.8 DES 算法解密函数des_decrypt (57)4.7.9 TDES 算法加密函数des3_encrypt (58)4.7.10 TDES 算法解密函数des3_decrypt (59)4.7.11 将 ASCII 字符转换为 10 进制数asc_dec (60)4.8 接触式存储卡操作函数 (60)4.8.1 设置接触式存储卡种类contact_settype (61)4.8.2 识别接触式存储卡种类contact_identifytype (62)4.8.3 接触式存储卡密码校验contact_passwordcheck (63)4.8.4 接触式存储卡读数据contact_read (63)4.8.5 接触式存储卡写数据contact_write (64)4.8.6 接触式存储卡密码初始化（更改密码）contact_passwordinit (65)4.9 磁条卡操作函数 (65)4.9.1 获取磁条卡数据magnetic_read (65)4.9.2 设置磁条卡数据输出方式set_magnetic_mode (66)4.10 外挂密码键盘 (67)4.10.1 密码键盘下载主密钥 (67)4.10.2 密码键盘下载工作密钥(密钥为密文) (67)4.10.3 密码键盘激活主密钥和工作密钥 (68)4.10.4 密码键盘设置键盘输入密码的长度 (68)4.10.5 密码键盘设置键盘超时时间 (69)4.10.6 获取键盘输入的密码(明文传输) (69)4.10.7 获取键盘输入的密码(密文传输) (70)4.11 AT88SC1604卡 (70)4.11.1 读数据 srd_1604 (71)4.11.2 写数据 swr_1604 (71)4.11.3 校验应用区密码 csc_1604 (72)4.11.4 校验擦除密码 cesc_1604 (73)4.11.5 擦除数据 ser_1604 (73)4.11.6 写密码 wsc_1604 (74)4.11.7 伪个人化 fakefus_1604 (74)4.11.8 个人化 psnl_1604 (75)4.12 金融IC卡 (75)4.12.1读取金融IC卡卡号和 (75)1.文档概述1.1.文档围该手册主要介绍二代证读写器、相关接口函数库的使用以及相关API的介绍。
在附录中介绍了读写器支持的卡型的卡片特性。
1.2.面向对象购买了二代证读写器，欲使用二代证读写器进行二次开发的开发人员。
1.3.参考资料(农行)金融IC卡读写器通讯协议说明2.函数库介绍2.1.功能API函数库提供了使用二代证读卡器对卡片操作时所用到的函数接口，包括以下几个方面：A. 设备操作函数组B. 接触式卡片操作函数C. 非接触式卡片操作函数D. 操作函数E. 磁条卡操作函数F. 外挂键盘操作函数2.2.性能1.读写器通过串口或HID无驱设备与PC机进行通讯，不需要安装驱动程序。
2.API接口函数库封装了通过PC机来操作二代证读卡器时用到的各个函数，用户在执行操作时，只需调用相应的函数接口即可，不需要编写对读卡器的操作函数。
3.运行环境3.1.硬设备为运行本产品，您需要的硬设备的最小配置如下：A.处理器：80X86B.存：64KBC.硬盘：2.0GBB接口一个E.RS232串口一个3.2.软件的运行平台为运行本产品，您需要的支持软件如下：A. 操作系统：Win 7/Windows Vista/Win2003/WinXP/Win2000；B. 程序编写工具：VC/VB/PB/Delphi等；3.3.函数调用方法3.3.1.Delphi调用32位动态库的方法语法：[Public Private | protected] Function FunctionName([Var] [Arg1:DataType1;] [Arg2:DataType2;...]) [:ReturnDataType]; far;stdcall;external‘libname’ [Name AliasName];调用语句的语法包含下面部分：●关键字Public（可选），表示函数可以被程序代码中的任意部分访问。