社保卡读写器用户手册文档格式.docx
《社保卡读写器用户手册文档格式.docx》由会员分享,可在线阅读,更多相关《社保卡读写器用户手册文档格式.docx(11页珍藏版)》请在冰豆网上搜索。
●与PC机通讯采用USB接口;
1.2装箱清单
读写器一台
串口线一条
安装盘一张
产品质量反馈表一张
产品保修卡一张
1.3读写器连接方式
DP读写器USB接口直接接至计算机上。
1.4指示灯
三色指示灯:
绿色用户卡已插入,闪烁时表示正在对用户卡操作
红色未插用户卡或SAM卡
橙色用户卡未插入,SAM卡已插入,闪烁时表示正在对SAM卡操作
1.5技术指标
●通讯接口:
USB
●串口的波特率:
●电源:
由键盘取电,不外带电源
●最大功耗:
100mW
●环境温度:
商业级0°
70°
C
工业级-25°
85°
C
●相对湿度:
30%95%
●抗静电干扰:
15KV
●抗磁场干扰:
19奥斯特
●抗振动能力:
振幅0.35mm,频率10-55Hz,三个轴方向扫频振动
●绝缘电阻:
湿热情况下(40°
,95%)绝缘电阻应不小于5MΩ。
●外型尺寸:
长宽高110mm85mm60mm
●重量:
约475克
第二章接口函数使用说明
高级应用编程接口
本附录描述了读卡器的高级应用编程接口:
高级应用编程接口是提供给终端上的应用程序用来与读卡器进行交互操作的函数集。
高级应用编程接口的具体表现形式必须包括:
a.可以在32位WINDOWS环境下(WINDOWS95/98/ME,WINNT/2000/XP等)运行的动态链接库(SSSE32.DLL)。
b.可以在16位WINDOWS环境下(WINDOWS3.1等)运行的动态链接库(SSSE16.DLL)。
c.可以在DOS环境下运行的C语言(MSC或BORLANDC)函数库(SSSE16.LIB)。
d.可以在DOS环境下运行的FOXPRO函数库(SSSE16.PLB)。
高级应用编程接口的具体表现形式也可以包括:
a.可以在Unix环境下运行的C语言函数库。
b.可以在基于特定硬件平台上的C语言函数库。
上述所有高级应用编程接口应具有本规范所规定的统一的库名、函数名、参数类型和顺序。
应用开发者或用户在对读卡器编程时,可使用相应的库名和函数名。
注:
在以下的描述中,分别使用C语言和FOXPRO语言的风格来说明高级应用编程接口中的函数
B1C语言函数
B1.1 “打开设备”函数
函数:
longICC_Reader_Open(char*dev_Name)
功能:
该函数通知终端操作系统打开与读卡器所对应的终端设备端口,以便两者建立通信的逻辑关系。
(使用读写器已固定的波特率)
参数说明:
dev_Name:
设备名称。
取值范围”AUTO”、”COMn”、,其中”n”的取值范围为1~9。
返回值:
若正常,返回值为不小于0的设备句柄;
反之返回值为状态码,其含义见B1.8。
对16位WINDOWS环境下运行的动态链接库、DOS环境下运行的静态函数库返回的设备句柄,其含义均不同于32位WINDOWS环境下动态链接库返回的设备句柄,仅为区分设备之用。
B1.2 “关闭设备”函数
longICC_Reader_Close(longReaderHandle)
该函数通知操作系统关闭所指定的设备。
ReaderHandle:
设备句柄。
返回值的含义见B1.8。
B1.3 “卡上电”或“热复位“函数
longICC_Reader_PowerOn(longReaderHandle,unsignedcharICC_Slot_No,unsignedchar*Response)
该函数要求读卡器对ICC进行冷复位,若冷复位失败读卡器应启动一个热复位。
设备句柄;
ICC_Slot_No:
ICC连接器号;
用户卡连接器号0x0n,SAM卡连接器号0x1n,其中”n”的取值范围为1~F。
Response:
指向存放响应数据的存储区的指针
如果对ICC复位成功,则在Response的存储区中返回ICC的复位应答字节,返回值为存储区中的字节数;
返回值小于0为状态码,其含义见B1.8。
B1.4 “卡下电”函数
longICC_Reader_PowerOff(longReaderHandle,unsignedcharICC_Slot_No)
该函数要求读卡器撤消与ICC之间的电气连接。
如果该函数成功执行,则返回值为0;
B1.5 “获取卡片状态”函数
longICC_Reader_GetStatus(longReaderHandle,unsignedcharICC_Slot_No)
查询有无卡以及卡片当前状态信息。
返回0表示有卡且已上电;
B1.6 “应用命令”函数
longICC_Reader_Application(longReaderHandle,unsignedcharICC_Slot_No,longLenth_of_Command_APDU,unsignedchar*Command_APDU,unsignedchar*Response_APDU)
该函数用于将符合ISO7816中所规定的基本和特殊功能的行业间交换用命令发送给指定的ICC连接器,并获得对应的响应。
Lenth_of_Command_APDU:
其值为Command_APDU所指向缓冲区中的字节数;
Command_APDU:
指向存放命令的缓冲区的指针;
Response_APDU:
指向存放响应数据的存储区的指针(包括sw1,sw2)。
如果函数执行成功,则在Response_APDU的存储区中返回响应数据,函数返回值为存储区中的字节数;
返回值小于0为状态码,其含义见B1.8,Response_APDU的存储区无任何数据。
B1.7 “取信息”函数
longICC_Reader_Libinfo(char*info)
该函数取得当前函数库的厂家信息
info:
指向存放厂家信息的存储区的指针。
表-B1.1厂家信息的存储格式
第1~16字符
第17~30字符
第31、32字符
厂家名称(不足补空格)
设备型号或系列号(不足补空格)
函数库版本号
返回的厂家名称;
明华澳汉公司
返回的设备型号或系列号:
DP_123_SB
返回的库版本号升级规则:
每次小升级X0升为X1..X2..X3
直到X0是一个稳定版本。
B1.8 函数返回值
表-B1.2高级编程接口C语言函数的返回值
应用编程的标识符
返回值
含义
IFD_OK
执行成功
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
信息校验和出错
B2FOXPRO语言函数
在以下的描述中,所指字符为ASCII字符
B2.1 “打开设备”函数
ICCR_Open(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)
ICCSlotNo:
若执行成功,第3、4两个字符为复位应答中的字节数(十六进制),从第五字符起为ICC的复位应答字符(字符个数为字节数的2倍)。
B2.4 “卡下电”函数
ICCR_Poff(R_Handle,ICCSlotNo)
B2.5 “获取卡片状态”函数
ICCR_GetS(R_Handle,ICCSlotNo)
返回值为两个字符的状态码,”00”表示有卡且已上电,其他含义见B2.8。
B2.6 “应用命令”函数
ICCR_App(R_Handle,ICCSlotNo,ComAPDU)
ComAPDU:
命令字符串,每两字符表示发送命令的一字节;
若执行成功,第3、4、5、6字符为响应数据的字节数(十六进制),从第7字符起为响应数据字符(字符个数为字节数的2倍)。
B2.7 “取信息”函数
ICCR_Linfo()
若执行成功,从第3字符起为厂家信息字符串。
表-B2.1厂家信息的存储格式
B2.8 函数返回值
表-B2.2高级编程接口FOXPRO函数的返回值
00
01
02
03
04
11
12
13
14
15