社保卡读写器用户手册样本

资料内容仅供您学习参考，如有不当或者侵权，请联系改正或者删除。社会保障(个人)卡读写器(DP－R123－U－SB)用户使用手册深圳市明华澳汉科技股份有限公司ShenZhenMingWahAoHanHighTechnologyCorporationLtd.目录第一章社会保障(个人)卡读写器简介.....................................21.1特点............................................................21.2装箱清单........................................................21.3读写器连接方式.................................................2指示灯..........................................................2技术指标........................................................2第二章IC卡读写器驱动程序函数说明.....................................32.1函数使用说明.....................................................3

社会保障(个人)卡读写器简介1特点支持IC卡类型A类、AB类;可支持T=0通讯协议的CPU卡;支持对多个卡操作的功能;与PC机通讯采用USB接口;1.2装箱清单读写器一台串口线一条安装盘一张产品质量反馈表一张产品保修卡一张1.3读写器连接方式DP读写器USB接口直接接至计算机上。1.4指示灯三色指示灯:绿色用户卡已插入,闪烁时表示正在对用户卡操作红色未插用户卡或SAM卡橙色用户卡未插入,SAM卡已插入,闪烁时表示正在对SAM卡操作1.5技术指标通讯接口:USB串口的波特率:电源:由键盘取电,不外带电源最大功耗:100mW环境温度:商业级0°70工业级-25°85相对湿度:30%95%抗静电干扰:15KV抗磁场干扰:19奥斯特抗振动能力:振幅0.35mm,频率10-55Hz绝缘电阻:湿热情况下(40°,95%)绝缘电阻应不小于5MΩ。外型尺寸:长宽高110mm85mm60mm重量:约475接口函数使用说明高级应用编程接口本附录描述了读卡器的高级应用编程接口:高级应用编程接口是提供给终端上的应用程序用来与读卡器进行交互操作的函数集。高级应用编程接口的具体表现形式必须包括:能够在32位WINDOWS环境下(WINDOWS95/98/ME,WINNT//XP等)运行的动态链接库(SSSE32.DLL)。能够在16位WINDOWS环境下(WINDOWS3.1等)运行的动态链接库(SSSE16.DLL)。能够在DOS环境下运行的C语言(MSC或BORLANDC)函数库(SSSE16.LIB)。能够在DOS环境下运行的FOXPRO函数库(SSSE16.PLB)。高级应用编程接口的具体表现形式也能够包括:能够在Unix环境下运行的C语言函数库。能够在基于特定硬件平台上的C语言函数库。上述所有高级应用编程接口应具有本规范所规定的统一的库名、函数名、参数类型和顺序。应用开发者或用户在对读卡器编程时,可使用相应的库名和函数名。注:在以下的描述中,分别使用C语言和FOXPRO语言的风格来说明高级应用编程接口中的函数B1B1.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进行冷复位,若冷复位失败读卡器应启动一个热复位。参数说明:ReaderHandle:设备句柄;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之间的电气连接。参数说明:ReaderHandle:设备句柄;ICC_Slot_No:ICC连接器号;返回值:如果该函数成功执行,则返回值为0;返回值小于0为状态码,其含义见B1.8。B1.5”获取卡片状态”函数函数:longICC_Reader_GetStatus(longReaderHandle,unsignedcharICC_Slot_No)功能:查询有无卡以及卡片当前状态信息。参数说明:ReaderHandle:设备句柄;ICC_Slot_No:ICC连接器号;返回值:返回0表示有卡且已上电;返回值小于0为状态码,其含义见B1.8。B1.6”应用命令”函数函数:longICC_Reader_Application(longReaderHandle,unsignedcharICC_Slot_No,longLenth_of_Command_APDU,unsignedchar*Command_APDU,unsignedchar*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”取信息”函数函数: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.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信息校验和出错B2FOXPRO语言函数注:在以下的描述中,所指字符为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.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