社保卡读写器用户手册

社会保障 个人 卡读写器使用手册 1 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 社会保障社会保障 个人个人 卡读写器卡读写器 DPDP R123R123 U U SBSB 用户用户使用手册使用手册 深圳市明华澳汉科技股份有限公司深圳市明华澳汉科技股份有限公司 ShenZhen MingWah AoHan High Technology Corporation Ltd 社会保障 个人 卡读写器使用手册 2 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 目目 录录 第一章第一章 社会保障社会保障 个人个人 卡读写器简介卡读写器简介 2 1 11 1 特点 2 1 21 2 装箱清单 2 1 31 3 读写器连接方式 2 1 41 4指示灯 2 1 51 5技术指标 2 第二章第二章 ICIC 卡读写器驱动程序函数说明卡读写器驱动程序函数说明 3 2 12 1 函数使用说明 3 社会保障 个人 卡读写器使用手册 3 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 第一章第一章社会保障 个人 卡读写器简介社会保障 个人 卡读写器简介 1 1 1 1 特点特点 支持 IC 卡类型 A 类 AB 类 可支持 T 0 通讯协议的 CPU 卡 支持对多个卡操作的功能 与 PC 机通讯采用 USB 接口 1 21 2 装箱清单装箱清单 读写器 一台 串口线 一条 安装盘 一张 产品质量反馈表 一张 产品保修卡 一张 1 31 3 读写器连接方式读写器连接方式 DP 读写器 USB 接口直接接至计算机上 1 41 4 指示灯指示灯 三色指示灯 绿色 用户卡已插入 闪烁时表示正在对用户卡操作 红色 未插用户卡或 SAM 卡 橙色 用户卡未插入 SAM 卡已插入 闪烁时表示正在对 SAM 卡操作 1 51 5 技术指标技术指标 通讯接口 USB 串口的波特率 电源 由键盘取电 不外带电源 最大功耗 100 mW 环境温度 商业级 0 70 C 工业级 25 85 C 相对湿度 30 95 抗静电干扰 15KV 抗磁场干扰 19 奥斯特 抗振动能力 振幅 0 35mm 频率 10 55Hz 三个轴方向扫频振动 绝缘电阻 湿热情况下 40 95 绝缘电阻应不小于 5M 外型尺寸 长 宽 高 110mm 85mm 60mm 重量 约 475 克 社会保障 个人 卡读写器使用手册 4 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 第二章第二章接口函数使用说明接口函数使用说明 高级应用编程接口 本附录描述了读卡器的高级应用编程接口 高级应用编程接口是提供给终端上的应用程序用来与读卡器进行交互操作的函数集 高级应用编程接口的具体表现形式必须包括 a 可以在 32 位 WINDOWS 环境下 WINDOWS95 98 ME WIN NT 2000 XP等 运行的动态链接库 SSSE32 DLL b 可以在 16 位 WINDOWS 环境下 WINDOWS3 1 等 运行的动态链接库 SSSE16 DLL c 可以在 DOS 环境下运行的 C 语言 MSC 或 BORLAND C 函数库 SSSE16 LIB d 可以在 DOS 环境下运行的 FOXPRO 函数库 SSSE16 PLB 高级应用编程接口的具体表现形式也可以包括 a 可以在 Unix 环境下运行的 C 语言函数库 b 可以在基于特定硬件平台上的 C 语言函数库 上述所有高级应用编程接口应具有本规范所规定的统一的库名 函数名 参数类型和 顺序 应用开发者或用户在对读卡器编程时 可使用相应的库名和函数名 注 在以下的描述中 分别使用 C 语言和 FOXPRO 语言的风格来说明高级应用编程接口 中的函数 B1 C 语言函数 B1 1 打开设备 函数 函数 long ICC Reader Open char dev Name 功能 该函数通知终端操作系统打开与读卡器所对应的终端设备端口 以便两者建立通信的 逻辑关系 使用读写器已固定的波特率 参数说明 dev Name 设备名称 取值范围 AUTO COMn 其中 n 的取值范围为1 9 返回值 若正常 返回值为不小于 0 的设备句柄 反之返回值为状态码 其含义见 B1 8 注 对 16 位 WINDOWS 环境下运行的动态链接库 DOS 环境下运行的静态函数库返回的 设备句柄 其含义均不同于 32 位 WINDOWS 环境下动态链接库返回的设备句柄 仅为区分设 备之用 B1 2 关闭设备 函数 社会保障 个人 卡读写器使用手册 5 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 函数 long ICC Reader Close long ReaderHandle 功能 该函数通知操作系统关闭所指定的设备 参数说明 ReaderHandle 设备句柄 返回值 返回值的含义见 B1 8 B1 3 卡上电 或 热复位 函数 函数 long ICC Reader PowerOn long ReaderHandle unsigned char ICC Slot No unsigned char Response 功能 该函数要求读卡器对 ICC 进行冷复位 若冷复位失败读卡器应启动一个热复位 参数说明 ReaderHandle 设备句柄 ICC Slot No ICC连接器号 用户卡连接器号 0 x0n SAM 卡连接器号 0 x1n 其中 n 的取值范围为 1 F Response 指向存放响应数据的存储区的指针 返回值 如果对 ICC 复位成功 则在 Response 的存储区中返回 ICC 的复位应答字节 返回值 为存储区中的字节数 返回值小于 0 为状态码 其含义见 B1 8 B1 4 卡下电 函数 函数 long ICC Reader PowerOff long ReaderHandle unsigned char ICC Slot No 功能 该函数要求读卡器撤消与 ICC 之间的电气连接 参数说明 ReaderHandle 设备句柄 ICC Slot No ICC连接器号 返回值 如果该函数成功执行 则返回值为 0 返回值小于 0 为状态码 其含义见 B1 8 B1 5 获取卡片状态 函数 函数 long ICC Reader GetStatus long ReaderHandle unsigned char ICC Slot No 功能 查询有无卡以及卡片当前状态信息 社会保障 个人 卡读写器使用手册 6 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 参数说明 ReaderHandle 设备句柄 ICC Slot No ICC连接器号 返回值 返回 0 表示有卡且已上电 返回值小于 0 为状态码 其含义见 B1 8 B1 6 应用命令 函数 函数 long ICC Reader Application long ReaderHandle unsigned char ICC Slot No long Lenth of Command APDU unsigned char Command APDU unsigned char Response APDU 功能 该函数用于将符合 ISO7816 中所规定的基本和特殊功能的行业间交换用命令发送给指 定的 ICC 连接器 并获得对应的响应 参数说明 ReaderHandle 设备句柄 ICC Slot No ICC连接器号 Lenth of Command APDU 其值为Command APDU所指向缓冲区中的字节数 Command APDU 指向存放命令的缓冲区的指针 Response APDU 指向存放响应数据的存储区的指针 包括 sw1 sw2 返回值 如果函数执行成功 则在 Response APDU的存储区中返回响应数据 函数返回值为存 储区中的字节数 返回值小于 0 为状态码 其含义见 B1 8 Response APDU的存储区无任 何数据 B1 7 取信息 函数 函数 long ICC Reader Libinfo char info 功能 该函数取得当前函数库的厂家信息 参数说明 info 指向存放厂家信息的存储区的指针 表 B1 1 厂家信息的存储格式 第 1 16 字符第 17 30 字符第 31 32 字符 厂家名称 不足补空格 设备型号或系列号 不足补空格 函数库版本号 返回值 返回的厂家名称 明华澳汉公司 返回的设备型号或系列号 DP 123 SB 返回的库版本号升级规则 每次小升级 X0 升为 X1 X2 X3 直到 X0 是一个稳定版本 社会保障 个人 卡读写器使用手册 7 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 返回值的含义见 B1 8 B1 8 函数返回值 表 B1 2 高级编程接口 C 语言函数的返回值 应用编程的标识符返回值含义 IFD OK0 执行成功 IFD ICC TypeError 1 卡片类型不对 IFD ICC NoExist 2 无卡 IFD ICC NoPower 3 有卡未上电 IFD ICC NoResponse 4 卡片无应答 IFD ConnectError 11 读卡器连接错 IFD UnConnected 12 未建立连接 没有执行打开设备函数 IFD BadCommand 13 动态库 不支持该命令 IFD ParameterError 14 发给动态库的 命令参数错 IFD CheckSumError 15 信息校验和出错 B2 FOXPRO 语言函数 注 在以下的描述中 所指字符为 ASCII 字符 B2 1 打开设备 函数 函数 ICCR Open dev Name 功能 该函数通知终端操作系统打开与读卡器所对应的终端设备端口 以便两者建立通信的 逻辑关系 参数说明 dev Name 设备名称 取值范围 AUTO COMn USBn LPTn 其中 n 的取 值范围为 1 9 返回值 返回值为一字符串 前两个字符为函数执行状态码 其含义见 B2 8 若执行成功 第 3 4 个字符为函数执行后返回的设备句柄 R Handle 该句柄仅为区分设备之用 B2 2 关闭设备 函数 函数 ICCR Close R Handle 功能 该函数通知操作系统关闭所指定的设备 参数说明 R Handle 设备句柄 社会保障 个人 卡读写器使用手册 8 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 返回值 返回值为两个字符的状态码 其含义见 B2 8 B2 3 卡上电 或 热复位 函数 函数 ICCR Pon R Handle ICCSlotNo 功能 该函数要求读卡器对 ICC 进行冷复位 若冷复位失败读卡器应启动一个热复位 参数说明 R Handle 设备句柄 ICCSlotNo ICC 连接器号 用户卡连接器号 0 x0n SAM卡连接器号 0 x1n 其中 n 的取值范围为 1 F 返回值 返回值为一字符串 前两个字符为函数执行状态码 其含义见 B2 8 若执行成功 第 3 4 两个字符为复位应答中的字节数 十六进制 从第五字符起为 ICC 的复位应答字符 字符个数为字节数的 2 倍 B2 4 卡下电 函数 函数 ICCR Poff R Handle ICCSlotNo 功能 该函数要求读卡器撤消与 ICC 之间的电气连接 参数说明 R Handle 设备句柄 ICCSlotNo ICC 连接器号 返回值 返回值为两个字符的状态码 其含义见 B2 8 B2 5 获取卡片状态 函数 函数 ICCR GetS R Handle ICCSlotNo 功能 查询有无卡以及卡片当前状态信息 参数说明 R Handle 设备句柄 ICCSlotNo ICC 连接器号 返回值 返回值为两个字符的状态码 00 表示有卡且已上电 其他含义见 B2 8 B2 6 应用命令 函数 社会保障 个人 卡读写器使用手册 9 深圳市明华澳汉科技股份有限公司 TEL 0755 FAX 函数 ICCR App R Handle ICCSlotNo ComAPDU 功能 该函数用于将符合 ISO7816 中所规定的基本和特殊功能的行业间交换用命令发送给指 定的 ICC 连接器 并获得对应的响应 参数说明 R Handle 设备句柄 ICCSlotNo ICC 连接器号 ComAPDU 命令字符串 每两字符表示发送命令的一字节 返回值 返回值为一字符串 前两个字符为函数执行状态码 其含义见 B2 8 若执行成功 第 3 4 5 6 字符为响应数据的字节数 十六进制 从第 7 字符起为响应数据字符 字符 个数为字节数的 2 倍 B2 7 取信息 函数 函数 ICCR Linfo 功能 该函数取得当前函数库的厂家信息 参数说明 返回值 返回值为一字符串 前两个字符为函数执行状态码 其含义见 B2 8 若执行成功 从 第 3 字符起为厂家信息字符串 表 B2 1 厂家信息的存储格式 第 1 16 字符第 17 30 字符第 31 32 字符 厂家名称 不足补空格 设备型号或系列号 不足补空格 函数库版本号 B2 8 函数返回值 表 B2 2 高级编程接口 FOXPRO 函数的返回值 应用编程的标识符返回值含义 IFD OK00 执行成功 IFD IC