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

社会保障(个人)卡读写器
（TSW-F4）
用户使用手册
广东德生科技有限公司
目录
1社会保障（个人）卡读写器简介 (3)
1.1特点 (3)
1.2装箱清单 (3)
1.3读写器连接方式 (3)
1.4指示灯 (3)
1.5技术指标 (3)
2接口函数使用说明 (4)
2.1C语言函数 (4)
2.1.1“打开设备”函数 (4)
2.1.2“关闭设备”函数 (4)
2.1.3“卡上电”或“热复位“函数 (4)
2.1.4“卡下电”函数 (5)
2.1.5“获取卡片状态”函数 (5)
2.1.6“应用命令”函数 (5)
2.1.7“取信息”函数 (5)
2.1.8函数返回值 (6)
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克
2接口函数使用说明
高级应用编程接口
本附录描述了读卡器的高级应用编程接口：
高级应用编程接口是提供给终端上的应用程序用来与读卡器进行交互操作的函数集。

高级应用编程接口的具体表现形式为32位WINDOWS环境下（WINDOWS95/98/ME,WIN NT/2000/XP等）运行的动态链接库(SSSE32.DLL)。

应用开发者或用户在对读卡器编程时，可使用相应的库名和函数名。

注：在以下的描述中，使用C语言风格来说明高级应用编程接口中的函数
2.1C语言函数
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.8。

2.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~F。

Response：指向存放响应数据的存储区的指针
如果对ICC复位成功，则在Response的存储区中返回ICC的复位应答字节，返回值为存储区中的字节数；返回值小于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.8。

2.1.5“获取卡片状态”函数
函数：
long ICC_Reader_GetStatus(long ReaderHandle, unsigned char ICC_Slot_No)
功能：
查询有无卡以及卡片当前状态信息。

参数说明：
ReaderHandle：设备句柄；
ICC_Slot_No：ICC连接器号； 0x01，0x11
返回值：
返回0表示有卡且已上电；返回值小于0为状态码，其含义见B1.8。

2.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：指向存放厂家信息的存储区的指针。

返回的厂家名称；广东德生科技
返回的设备型号或系列号:TSW-F4
返回的库版本号升级规则:每次小升级X0升为X1..X2..X3 返回值的含义见B1.8。

2.1.8函数返回值。