MT明泰_读卡器_API接口函数库使用说明书

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)