社保卡读写器用户手册.doc

社保卡读写器用户手册

社会保障(个人)卡读写器
（DP－R123－U－SB）
用户使用手册

深圳市明华澳汉科技股份有限公司
ShenZhen MingWah AoHan High Technology Corporation Ltd.

目 录

第一章 社会保障(个人)卡读写器简介.....................................2
1.1 特点............................................................2
1.2 装箱清单........................................................2
1.3 读写器连接方式.... .............................................2
1.4 指示灯..........................................................2
1.5 技术指标........................................................2
第二章 IC卡读写器驱动程序函数说明.....................................3
2.1 函数使用说明.....................................................3

第一章 社会保障（个人）卡读写器简介

1. 1特点

l 支持IC卡类型A类、AB类；
l 可支持T=0通讯协议的CPU卡；
l 支持对多个卡操作的功能；
l 及PC机通讯采用USB接口；
1.2 装箱清单
读写器 一台
串口线 一条
安装盘 一张
产品质量反馈表 一张
产品保修卡 一张

1.3 读写器连接方式
DP读写器USB接口直接接至计算机上。
1.4 指示灯
三色指示灯：绿色 用户卡已插入，闪烁时表示正在对用户卡操作
红色 未插用户卡或SAM卡
橙色 用户卡未插入，SAM卡已插入，闪烁时表示正在对SAM卡操作

1.5 技术指标
l 通讯接口：USB
l 串口的波特率：
l 电源：由键盘取电，不外带电源
l 最大功耗：100 mW
l 环境温度：商业级 0°~ 70 °C
工业级 -25°~ 85 °C
l 相对湿度：30% ~ 95%
l 抗静电干扰：15KV
l 抗磁场干扰：19奥斯特
l 抗振动能力：振幅0.35mm，频率10-55Hz，三个轴方向扫频振动
l 绝缘电阻：湿热情况下（40°，95%）绝缘电阻应不小于5MΩ。
l 外型尺寸：长´宽´高110mm´85mm´60mm
l 重量： 约475克

第二章 接口函数使用说明

高级应用编程接口
本附录描述了读卡器的高级应用编程接口：
高级应用编程接口是提供给终端上的应用程序用来及读卡器进行交互操作的函数集。
高级应用编程接口的具体表现形式必须包括：
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　“关闭设备”函数
函数：
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连接器号；用户卡连接器号 0x0n，SAM卡连接器号0x1n，其中”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)
功能：
查询有无卡以及卡片当前状态信息。
参数说明：
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是一个稳定版本。

返回值的含义见B1.8。

B1.8　函数返回值
表-B1.2 高级编程接口C语言函数的返回值
应用编程的标识符
返回值
含义
IFD_OK
0
执行成功
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：设备句柄。
返回值：
返回值为两个字符的状态码，其含义见B2.8。

B2.3　“卡上电”或“热复位“函数
函数：
ICCR_Pon(R_Handle,ICCSlotNo)
功能：
该函数要求读卡器对ICC进行冷复位，若冷复位失败读卡器应启动一个热复位。
参数说明：
R_Handle：设备句柄；
ICCSlotNo：ICC连接器号；用户卡连接器号 0x0n，SAM卡连接器号0x1n，其中”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　“应用命令”函数
函数：
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_OK
00
执行成功
IFD_ICC_TypeError
01
卡片类型不对
IFD_ICC_NoExist
02
无卡
IFD_ICC_NoPower
03
有卡未上电
IFD_ICC_NoResponse
04
卡片无应答
IFD_ConnectError
11
读卡器连接错
IFD_UnConnected
12
未建立连接(没有执行打开设备函数)
IFD_BadCommand
13
(动态库)不支持该命令
IFD_ParameterError
14
(发给动态库的)命令参数错
IFD_CheckSumError
15
信息校验和出错

11 / 11