社保卡读写器tsw-f4-u3用户手册.doc

社会保障(个人)卡读写器使用手册 1广东德生科技有限公司 社会保障(个人)卡读写器（TSW-F4）用户使用手册广东德生科技有限公司目 录社会保障(个人)卡读写器使用手册 2广东德生科技有限公司 1 社会保障（个人）卡读 写器简介 .....................................31.1 特点 ......................................................31.2 装箱清单 ..................................................31.3 读写器 连接方式 .............................................31.4 指示灯 ....................................................31.5 技术指标 ...................................................32 接口函数使用 说明 ...............................................42.1 C语言函数 .....................................................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 取电，不外带电源 最大功耗：100 mA 环境温度：商业级 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,WIN NT/2000/XP等）运行的动态链接库 (SSSE32.DLL)应用开发者或用户在对读卡器编程时，可使用相应的库名和函数名注：在以下的描述中，使用 C语言风格来说明高级应用编程接口中的函数2.1 C 语言函数2.1.1 “打开设备 ”函数函数：long ICC_Reader_Open(char* dev_Name)功能：该函数通知终端操作系统打开与读卡器所对应的终端设备端口，以便两者建立通信的逻辑关系 （使用读写器已固定的波特率）参数说明：dev_Name：设备名称取值范围”AUTO” 、 ”USB”、 ”COMn”、 ，其中”n”的取值范围为1~9返回值：若正常，返回值为不小于 0的设备句柄；反之返回值为状态码，其含义见 B1.8注：对 16 位 WINDOWS 环境下运行的动态链接库、DOS 环境下运行的静态函数库返回的设备句柄，其含义均不同于 32 位 WINDOWS 环境下动态链接库返回的设备句柄，仅为区分设备之用2.1.2 “关 闭设备 ”函数函数：long ICC_Reader_Close(long ReaderHandle)功能：该函数通知操作系统关闭所指定的设备。

参数说明：ReaderHandle：设备句柄返回值：返回值的含义见 B1.82.1.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~FResponse：指向存放响应数据的存储区的指针返回值：如果对 ICC复位成功，则在 Response的存储区中返回 ICC的复位应答字节，返回社会保障(个人)卡读写器使用手册 5广东德生科技有限公司 值为存储区中的字节数；返回值小于 0为状态码，其含义见 B1.8。

2.1.4 “卡下 电 ”函数函数：long ICC_Reader_PowerOff(long ReaderHandle, unsigned char ICC_Slot_No)功能：该函数要求读卡器撤消与 ICC之间的电气连接参数说明：ReaderHandle：设备句柄；ICC_Slot_No：ICC 连接器号； 返回值：如果该函数成功执行，则返回值为 0；返回值小于 0为状态码，其含义见 B1.82.1.5 “获 取卡片状 态 ”函数函数：long ICC_Reader_GetStatus(long ReaderHandle, unsigned char ICC_Slot_No)功能：查询有无卡以及卡片当前状态信息参数说明：ReaderHandle：设备句柄；ICC_Slot_No：ICC 连接器号； 0x01，0x11返回值：返回 0表示有卡且已上电；返回值小于 0为状态码，其含义见 B1.82.1.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 的存储区无任何数据2.1.7 “取信息 ”函数函数：long ICC_Reader_Libinfo(char* info)功能：该函数取得当前函数库的厂家信息参数说明：info：指向存放厂家信息的存储区的指针表-B1.1 厂家信息的存储格式社会保障(个人)卡读写器使用手册 6广东德生科技有限公司 第 1~16字符 第 17~30字符 第 31、32 字符厂家名称（不足补空格） 设备型号或系列号（不足补空格） 函数库版本号返回值：返回的厂家名称；广东德生科技返回的设备型号或系列号:TSW-F4返回的库版本号升级规则:每次小升级 X0 升为 X1..X2..X3返回值的含义见 B1.8。

2.1.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 信息校验和出错。