社保卡读写器TSW-F4-U3用户手册

社会保障(个人)卡读写器使用手册1广东德生科技有限公司社会保障(个人)卡读写器（TSW-F4）用户使用手册广东德生科技有限公司社会保障(个人)卡读写器使用手册2广东德生科技有限公司目录1社会保障（个人）卡读写器简介.....................................31.1特点......................................................31.2装箱清单..................................................31.3读写器连接方式.............................................31.4指示灯....................................................31.5技术指标..................................................32接口函数使用说明...............................................42.1C语言函数....................................................42.1.1“打开设备”函数..........................................42.1.2“关闭设备”函数........................................42.1.3“卡上电”或“热复位“函数................................42.1.4“卡下电”函数..........................................52.1.5“获取卡片状态”函数.....................................52.1.6“应用命令”函数........................................52.1.7“取信息”函数...........................................52.1.8函数返回值..........................................6社会保障(个人)卡读写器使用手册3广东德生科技有限公司1社会保障（个人）卡读写器简介1.1特点支持IC卡类型A类、AB类；可支持T=0通讯协议的CPU卡；一个大卡座,一个小卡座(可扩展)与PC机通讯采用USB接口，无需驱动；1.2装箱清单读写器一台安装盘一张用户手册一本（根据需要提供）产品保修卡一张1.3读写器连接方式TSW-F4读写器通过USB口直接接至计算机的USB口上。1.4指示灯三色指示灯：绿色用户卡已插入，闪烁时表示正在对用户卡操作红色未插用户卡或SAM卡橙色用户卡未插入，SAM卡已插入，闪烁时表示正在对SAM卡操作1.5技术指标通讯接口：USB口电源：由USB取电，不外带电源最大功耗：100mA环境温度：商业级0°70°C工业级-25°85°C相对湿度：30%95%抗静电干扰：15KV抗磁场干扰：19奥斯特抗振动能力：振幅0.35mm，频率10-55Hz，三个轴方向扫频振动绝缘电阻：湿热情况下（40°，95%）绝缘电阻应不小于5MΩ。外型尺寸：长宽高110mm85mm60mm重量：约475克社会保障(个人)卡读写器使用手册4广东德生科技有限公司2接口函数使用说明高级应用编程接口本附录描述了读卡器的高级应用编程接口：高级应用编程接口是提供给终端上的应用程序用来与读卡器进行交互操作的函数集。高级应用编程接口的具体表现形式为32位WINDOWS环境下（WINDOWS95/98/ME,WINNT/2000/XP等）运行的动态链接库(SSSE32.DLL)。应用开发者或用户在对读卡器编程时，可使用相应的库名和函数名。注：在以下的描述中，使用C语言风格来说明高级应用编程接口中的函数2.1C语言函数2.1.1“打开设备”函数函数：longICC_Reader_Open(char*dev_Name)功能：该函数通知终端操作系统打开与读卡器所对应的终端设备端口，以便两者建立通信的逻辑关系。（使用读写器已固定的波特率）参数说明：dev_Name：设备名称。取值范围”AUTO”、”USB”、”COMn”、，其中”n”的取值范围为1~9。返回值：若正常，返回值为不小于0的设备句柄；反之返回值为状态码，其含义见B1.8。注：对16位WINDOWS环境下运行的动态链接库、DOS环境下运行的静态函数库返回的设备句柄，其含义均不同于32位WINDOWS环境下动态链接库返回的设备句柄，仅为区分设备之用。2.1.2“关闭设备”函数函数：longICC_Reader_Close(longReaderHandle)功能：该函数通知操作系统关闭所指定的设备。参数说明：ReaderHandle：设备句柄。返回值：返回值的含义见B1.8。2.1.3“卡上电”或“热复位“函数函数：longICC_Reader_PowerOn(longReaderHandle,unsignedcharICC_Slot_No,unsignedchar*Response)功能：该函数要求读卡器对ICC进行冷复位，若冷复位失败读卡器应启动一个热复位。参数说明：ReaderHandle：设备句柄；ICC_Slot_No：ICC连接器号；用户卡连接器号0x0n，SAM卡连接器号0x1n，其中”n”的取值范围为1~F。Response：指向存放响应数据的存储区的指针返回值：社会保障(个人)卡读写器使用手册5广东德生科技有限公司如果对ICC复位成功，则在Response的存储区中返回ICC的复位应答字节，返回值为存储区中的字节数；返回值小于0为状态码，其含义见B1.8。2.1.4“卡下电”函数函数：longICC_Reader_PowerOff(longReaderHandle,unsignedcharICC_Slot_No)功能：该函数要求读卡器撤消与ICC之间的电气连接。参数说明：ReaderHandle：设备句柄；ICC_Slot_No：ICC连接器号；返回值：如果该函数成功执行，则返回值为0；返回值小于0为状态码，其含义见B1.8。2.1.5“获取卡片状态”函数函数：longICC_Reader_GetStatus(longReaderHandle,unsignedcharICC_Slot_No)功能：查询有无卡以及卡片当前状态信息。参数说明：ReaderHandle：设备句柄；ICC_Slot_No：ICC连接器号；0x01，0x11返回值：返回0表示有卡且已上电；返回值小于0为状态码，其含义见B1.8。2.1.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的存储区无任何数据。2.1.7“取信息”函数函数：longICC_Reader_Libinfo(char*info)功能：该函数取得当前函数库的厂家信息参数说明：社会保障(个人)卡读写器使用手册6广东德生科技有限公司info：指向存放厂家信息的存储区的指针。表-B1.1厂家信息的存储格式第1~16字符第17~30字符第31、32字符厂家名称（不足补空格）设备型号或系列号（不足补空格）函数库版本号返回值：返回的厂家名称；广东德生科技返回的设备型号或系列号:TSW-F4返回的库版本号升级规则:每次小升级X0升为X1..X2..X3返回值的含义见B1.8。2.1.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信息校验和出错