RD接触式IC卡读写器使用手册

1、 目 录第一章 RD系列接触式IC卡读写器简介.3 1.1 概述.3 1.2 读写器型号.3 1.3 装箱清单.41.4 读写器连接方式. .41.5 指示灯.41.6 程序安装.41.7 用户软件.4 1.8 技术指标.5 第二章 演示系统使用说明.6第三章 IC卡读写器驱动程序函数说明.93.1 安装程序主要目录和文件.9 3.2 函数使用规则.9 3.3 各种库函数说明.9 C语言接口函数库.9l 通用函数库.10l AT24C01A/24C02/24C04/24C08/24C16/24C64.13l AT45D041.14l AT88SC102/1604/1604B.15l AT93C

2、46/93C46A.22l SLE4404.23l SLE4406.26l SLE4418/4428.28l SLE4432/4442.30l CPU卡.30 FOXPRO FOR DOS函数库.33 WINDOWS 16位和32位动态库.34 FOXBASE函数库.353.3.5 UNIX函数库.383.3.6 LINUX函数库.38 3.4 VFP、VB、Delphi和PB调用动态库的方法.38 VFP调用16位动态库的方法.38 VFP调用32位动态库的方法.39 VB调用动态库的方法.40 Delphi调用32位动态库的方法.41 PB调用32位动态库的方法.423.4.6 VC调用3

3、2位动态库的方法.42 3.5 IC卡类型代码.43 3.6 函数错误类型代码.433.7 自动卡型测试函数原理说明.443.8 版本兼容性.45附录一 几种常用IC卡的特性 .45第一章 RD系列接触式IC卡读写器简介1.1 概述本公司产读写器功能齐全、性能稳定，在原有RD系列读写器的基础上增加了对SAM卡操作的功能。可方便地应用于工商、邮电、税务、银行、保险、医疗及各种收费、储值、查询等管理系统中。可读写的卡型a. 存贮器（Memory）卡l 美国ATMEL公司的AT24C01A/24C02/24C04/24C08/24C16/AT24C64，AT88SC102， AT88SC1604/1

4、604B，AT45D041，AT93C46/93C46A卡 l 德国SIEMENS公司的SLE4432/4442，SLE4418/4428，SLE4404，SLE4406卡 l 以及其他公司的兼容卡片(ISSI 24C01A/16) b. CPU卡(符合T=0/T=1通讯协议) 特点l 可读写多种Memory卡和支持T=0、T=1通讯协议的CPU卡；l 支持对SAM卡操作的功能；l 与PC机通讯采用RS232串口，波特率为1200 115200BPS；l 对于使用SAM卡的用户，可以选择内置于读写器的小卡座，也可以选择通过卡槽操作的大卡座。l 提供诸多开发平台的接口函数和应用范例。1.2 读写

5、器型号 (S) RD -X X -XC：表示CPU卡读写器；MX：表示混合型读写器，可读写Memory卡和CPU卡； 卡座类型：T-推推式，B-推拔式，Z-自弹式 放置方式：I-内置，E-外置RD系列读写器。前面加S表示某种卡型专用读写器 例如：RD-EB-MX 为外置推拨式可读写Memory卡和CPU卡的混合型读写器 1.3 装箱清单 读写器 一台 串口线 一条 安装盘 一张 用户手册 一本（根据需要提供） 产品保修卡 一张1.4 读写器连接方式XXXX读写器有两个PS/2接口和一个串口，PS/2接口中的一个与计算机的键盘口连接，另一个与键盘相连，串口直接接至计算机的串口上。1.5 指示灯三

6、色指示灯：绿色 用户卡已插入，闪烁时表示正在对用户卡操作 红色 未插用户卡或SAM卡 橙色 用户卡未插入，SAM卡已插入，闪烁时表示正在对SAM卡操作1.6 程序安装 步骤：l 将内置读写器安装在计算机内；或将外置读写器连接在计算机通讯口上；l 接通读写器电源；l 将随机软盘插入驱动器A：或B：中l 在WINDOWS95/98环境下双击MWRD.EXE；l 按照安装程序的提示和要求进行安装；注意：安装程序在根目录下建立MWRD的目录（缺省），所有驱动软件均在此目录下。安装完毕后请仔细阅读README.TXT文件。1.7 用户软件(V6.5) 用户软件包括三部分：演示系统、驱动程序、应用范例和兼

7、容库a. 演示系统 提供WINDOWS版演示程序DEMO.EXE。b. 驱动程序l C语言接口函数库(Borland C3.1)l FOXPRO FOR DOS(2.5/2.6) 接口函数库l WINDOWS 16位动态库l WINDOWS 32位动态库l FOXBASE(2.0/2.1)接口函数库l UNIX函数库(SCO UNIX5.0)l LINUX函数库（Red hat 6.0）c. 应用范例 随盘应提供VB5、VB3、PB5、DELPHI3、VFP3、FORPRO FOR DOS(2.5/2.6)、BC3.1、FOXBASE(2.0/2.1)、UNIX(SCO5.0)、LINUX（R

8、ed hat6.0）等的应用范例。d. 兼容库V5.4 为了兼容NRD系列及RDZ、RDB、RDT型读写器及其驱动程序Ver5.X，在RD系列读写器Ver6.4以上的驱动程序中增加了兼容库。使用旧读写器的客户，只要购置RD系列读写器及其兼容库，可不必更改源程序即可完成平稳过渡。1.8 技术指标l 通讯接口：RS232串口l 串口的波特率：1200 115200BPSl 电源：由键盘取电，不外带电源l 最大功耗：100 mW l 环境温度：商业级 0° 70 °C 工业级 -25° 85 °Cl 相对湿度：30% 95%l 抗静电干扰：15KVl 抗磁场干

9、扰：19奥斯特l 抗振动能力：振幅0.35mm，频率10-55Hz，三个轴方向扫频振动l 绝缘电阻：湿热情况下（40°，95%）绝缘电阻应不小于5M。l 外型尺寸：内置式长´宽´高138mm´120mm´25mm 外置式长´宽´高150mm´118mm´100mml 重量： 内置式约200克；外置式约500克 第二章 演示系统使用说明该演示系统可对ATMEL、SIEMENS等Memory卡和符合T=0/T=1通讯协议的CPU卡读写操作。图1 演示系统主界面1 演示系统主界面分五个功能区，分别说明如下：l

10、设备信息提示 可显示用户软件版本号、硬件版本号、产品序列号l 设备操作- 密码操作 可设置密码、更改密码、读出密码和比较密码- 设备计数 读写器发卡时可做计数之用。- 设备蜂鸣 可按设置时间要求执行鸣叫。- EEPROM读写 可向EEPROM中写入有关设备的一些备注信息- 自动弹卡 自弹式读写器可执行弹卡操作。l 卡片选择 卡片选择分手动选择卡型和自动检测卡型两种，卡片选择完成以后，按下卡片操作按钮，进入相应的Memory卡或CPU卡操作界面，实现各自的功能操作。l 建立连接 初次运行系统时，系统按自动测试方式建立连接，并将成功连接的参数保存在系统文件中。下次运行时系统将自动按保存的参数建立连

11、接。 也可以指定通讯口和波特率（或并口方式）建立连接。 连接成功后，用户可以更换读写器端口和波特率值（或并口方式），指定连接方式后，执行更改连接。自动测试将按照并口0x378、并口0x278、串口1串口4的顺序自动测试并连接。l 提示信息提示信息显示各项操作的结果或出错信息。鼠标双点框内文字可清空该区域。l 帮助文件按F1键或在卡片操作界面单击？图标，则弹出RD读写器帮助系统。该帮助系统功能十分详尽，包括如何使用演示软件、读写设备介绍、支持卡型介绍、库函数介绍和读写器常见问题解答五大部分。第三章 IC卡读写器驱动函数说明3.1 安装程序主要目录和文件 README.TXT 版本说明 DRVER

12、: RD系列读写器驱动程序 C.LIB*.* C.DOS静态函数库 FOXPRO.DOS*.* FOXPRO FOR DOS 接口函数库 WINDOWS.DLL*.* WINDOWS32位和16位动态库 UNIX*.* UNIX动态库 FOXBASE*.* FOXBASE函数库 DEMO.WINDEMO.EXE WINDOWS下操作演示软件 EXAMPLES*.* 各种平台的应用范例 MWRD5.4: RD读写器兼容库 C.LIB C.DOS静态函数库 FOXPRO.DOS FOXPRO FOR DOS接口函数库 WINDOWS.DLL WINDOWS32位和16位动态库 Ref5X.TXT

13、使用说明 SRDUSER.DOC SRD-E*P-45D041读写器用户使用手册UNWISEEXE 卸载安装程序 3.2 函数使用规则 (1) 首先调用通讯口初始化函数ic_init()或auto_init()； (2) 如果设备密码已设置有效，则通讯口初始化后必须先核对设备密码，然后再按照对卡操作的顺序调用相应的函数。 出厂时缺省的设备密码为0xffffff，在密码设置有效之前或在密码正确核对的有效期间，均可以读出设备密码。密码核对的有效期指的是在正确核对设备密码以后，到读写器关闭电源为止的时间。在此期间即使您的程序已经退出，原先核对的密码仍然有效。 (3) 在串口通讯方式下，调用WINDO

14、WS 16位/32位动态库或UNIX 函数库时，程序退出之前要执行ic_exit() 函数，关闭串口，释放句柄icdev；否则再次初始化串口将出错。 (4) 函数调用错误类型，请参照函数错误类型代码。所有函数的错误代码均以负数形式返回；Foxpr For Dos和Foxbase例外。注意：函数详细的使用方法，请参考EXAMPLES目录下提供的范例。3.3 各种库函数说明3.3.1 C语言接口函数库包括：a通用函数库 b. AT24C01A/24C02/24C04/24C08/24C16/24C64函数库 c. AT45D041函数库 d. AT88SC102/1604/1604B函数库 e.

15、AT93C46/93C46A函数库 f. SLE4404函数库 g. SLE4406函数库 h. SLE4418/4428函数库i. SLE4432/4442函数库j. CPU卡函数a. 通用函数库(1) int ic_init(int port, long baud)说明：初始化通讯接口调用：Port: 通讯口号0、1、2、3分别代表串口1、2、3、4； 并口为其I/O地址（如0x378） baud: 通讯口为串口时代表波特率，其值可为1200-115200 通讯口为并口时代表半字节或全字节通讯方式，其值为0或1返回： <0 错误 >0 通讯设备标识符举例： icdev=ic_i

16、nit(0,9600); 初始化串口1，波特率为9600 icdev=ic_init(0x378,0); 初始化并口，半字节通讯方式(2) int auto_init(int port, long baud)说明：自动初始化通讯接口调用：同ic_init()返回：同ic_init()注：无论使用串口通讯还是并口通讯，读写器都可保持最近一次设置的波特率值和并口的传输模式。上面的Ic_init()函数是用给定的串行波特率或并行传输模式与读写器通讯，如果读写器保存的串行波特率或并行传输模式与上位机的进行初始化的串行波特率或并行传输模式不同，将会出现初始化失败；而auto_init()函数在出现不同的

17、情况下，它可自动测试读写器当前的串行波特率值或并行传输模式，然后重新设置成上位机要求的串行波特率或并行传输模式并建立好连接。(3) int ic_exit(int icdev)说明： 关闭通讯口调用： icdev: 通讯设备标识符 返回： <0 错误 =0 正确 举例： st=ic_exit(icdev);注：C库中本无此函数，在此仅作为其它函数库的参考(4) int get_status(int icdev,int *state)说明： 返回设备当前状态调用： icdev: 通讯设备标识符 state: 插卡状态 state=1读写器插有卡；state=0读写器无卡 返回： <0

18、 错误 =0 正确， 举例： int status; st=get_status(icdev,&status); (5) int dv_beep(int icdev,int time)说明： 读写器蜂鸣调用： icdev: 通讯设备标识符 time: 蜂鸣时间，值范围0-255（单位10ms）返回： <0 错误 =0 .正确 举例： st=ic_beep(icdev,100);(6) int auto_pull(int icdev)说明： 自动弹卡调用： icdev: 通讯设备标识符 返回： <0 错误 =0 正确 举例： st=auto_pull(icdev);(7) i

19、nt turn_on(int icdev)说明： 对卡上电调用： icdev: 通讯设备标识符 返回： <0 错误 =0 正确举例： st=turn_on(icdev);(8) int turn_off(int icdev)说明： 对卡下电调用： icdev: 通讯设备标识符 返回： <0 错误 =0 正确举例： st=turn_off(icdev); (9) int srd_ver(int icdev,int len,unsigned char *databuff)说明： 读取设备版本号调用： icdev: 通讯设备标识符 len: 版本号字符串长度，其值为18 databuff

20、: 存放读取的版本号字符串返回： <0 错误 =0 正确举例： unsigned char databuff18; st=srd_ver(icdev,18,databuff);(10) int set_baud(int icdev,long baud)说明： 设置串口方式下的波特率或并口的通讯方式，设置完 毕后,必须重新初始化通讯口。调用： icdev: 通讯设备标识符。 baud: 串口时代表波特率，其值可为1200-115200 并口时代表半字节或全字节方式，其值分别为0或1 返回： <0 错误 =0 正确举例： st=set_baud(icdev,57600); 设置读写器串

21、口波特率为57600。(11) long chk_baud(int port)说明： 自动检测通讯方式。该函数要在初始化通讯口前使用调用： Port: 通讯口号0、1、2、3代表串口1、2、3、4; 并口则使用其I/O地址（如0x378）。返回： <0 错误 >=0 正确。返回串口的波特率或并口的通讯方式（0或1）举例： st=chk_baud(0x378); (12) int srd_dvsc(int icdev,int len,unsigned char *databuff)说明： 读出设备密码调用： icdev: 通讯设备标识符 len: 密码字符串长度，其值为3 datab

22、uff: 存放读取的密码字符串返回： <0 错误 =0 正确举例： unsigned char databuff3; st=srd_dvsc(icdev,3,databuff);(13) int swr_dvsc(int icdev,int len,unsigned char *databuff)说明： 改写设备密码调用： icdev: 通讯设备标识符 len: 密码字符串长度，其值为3 databuff: 存放要写入的密码字符串返回： <0 错误 =0 正确举例： unsigned char databuff3=a,b,c; st=swr_dvsc(icdev,3,databuf

23、f);(14) int cmp_dvsc(int icdev,int len,unsigned char *databuff)说明： 比较设备密码调用： icdev: 通讯设备标识符 len: 密码字符串长度，其值为3 databuff: 存放要比较的密码字符串返回： <0 错误 =0 正确举例： unsigned char databuff3=a,b,c; st= cmp_dvsc(icdev,3,databuff);(15) int setsc_md(int icdev,int mode)说明： 设置设备密码模式 mode=0时设置设备密码有效，在设备加电时必须先核对 设备密码才能对

24、设备操作；mode=1时设置设备密码无效。调用： icdev: 通讯设备标识符 mode: 密码模式返回： <0 错误 =0 正确举例： st=setsc_md(icdev,0); 设置设备密码有效 (16) int srd_snr(int icdev,int len, unsigned char *databuff)说明： 读出设备标识号调用： icdev: 通讯设备标识符 len: 字符串长度，其值为16 databuff: 存放要读出的标识号字符串返回： <0 错误 =0 正确举例： unsigned char databuff16; st=srd_snr(icdev,16,

25、databuff);(17) int chk_card(int icdev)说明： 测卡类型，仅适用明华公司生产的部分IC卡调用： icdev: 通讯设备标识符返回： <0 错误 >=0 正确；卡类型参照IC卡类型代码举例： st=chk_card(icdev);(18) int ic_encrypt(char *key,char *ptrsource,unsigned int msglen , char * ptrdest)说明： DES算法加密函数调用： key: 加密的密码，长度为8 ptrsource: 原文 msglen: 原文长度必需为8的倍数 ptrdest: 密文返

26、回： <0 错误。其绝对值为错误代码 =0 成功举例： char patrdest16; st=ic_encrypt(“12345678”,”abcdefghabcdefgh”,16,ptrdest) 将长度为16的”abcdefghabcdefgh”用密码“12345678” 加密 (19) int ic_decrypt(char *key,char *ptrdest,unsigned int msglen, char *ptrsource) 说明： DES算法解密函数，使用过程与ic_encrypt相反调用： key: 加密的密码；长度为8 ptrsource: 密文 msglen:

27、 密文长度必需为8的倍数 ptrdest: 原文返回： <0 错误。 其绝对值为错误代码 =0 成功举例： char ptrdest16; st=ic_decrypt(“12345678”,”abcdefghabcdefgh”,16,ptrdest) 将长度为16的”abcdefghabcdefgh”用密码“12345678” 解密(20) unsigned long DES_Encrypt( unsigned char *Key,int KeyLen,unsigned char *Source, unsigned long SrcLen,unsigned char *Result)说明

28、： DES算法加密函数调用： key: 加密的密码 keyLen: 加密的密码长度 Source: 原文 Srclen: 原文长度 Result: 密文返回： 加密后密文长度。 =0 成功举例： char patrdest16; st=ic_encrypt(“1234”,4,”abcdefghabcdef”,14,ptrdest) 将长度为14的”abcdefghabcdef”用密码“1234” 加密注意： 与ic_encrypt（）函数相比，它取消了对密码和加密数据长度必须为8的限制， 它对于非8倍数的处理方式为在数据后自动补0，凑足8的倍数。 (21) unsigned long DES_

29、Decrypt( unsigned char *Key,int KeyLen,unsigned char *Source, unsigned long SrcLen,unsigned char *result)说明： DES算法解密函数，使用过程与des_encrypt相反调用： Key: 解密的密码 Keylen: 解密的密码长度 Source: 密文 SrcLen: 密文的长度。 Result: 原文返回： 解密后原文的长度。举例： char ptrdest14; st=ic_decrypt(“1234”,4,”abcdefghabcdef”,14,ptrdest) 将长度为14的”abc

30、defghabcdef”用密码“1234” 解密注意： 与ic_decrypt（）函数相比，它取消了对密码和加密数据长度必须为8的限制， 它对于非8倍数的处理方式为在数据后自动补0，凑足8的倍数。 (22) int swr_eeprom(int icdev, int offset, int length, unsigned char *databuff);说明: 向EEPROM中写入数据信息调用： icdev： 设备标识符 offset： 偏移地址 0-383 length: 数据长度 1-384 databuff：存要写的数据信息返回： = 0 正确 0 错误 举例： unsigned ch

31、ar databuff3=a,b,c; st=swr_eeprom(icdev,1,3，databuff);(23) int srd_eeprom(int icdev, int offset, int length, unsigned char *databuff);说明: 从EEPROM中读取数据信息调用： icdev： 设备标识符 offset： 偏移地址 0-383 length: 数据长度 1-384 databuff：存要写的数据信息返回： = 0 正确 0 错误 举例： unsigned char databuff3; st=srd_eeprom(icdev,1,3，databuf

32、f);(24) int asc_hex(unsiged char *asc, unsigned char *hex , unsigned long length)；说明: 将ASCII码转换为十六进制数据 参数： asc: 输入要转换的字符串 hex： 存放转换后的字符串 length: 为转换后的字符串长度返回： = 0 正确 0 错误 举例： unsigned char databuff6; st=asc_hex(“a1a2a3a4a5”,databuff,5);(25) int hex_asc(unsigned char *hex, unsigned char *asc, unsigne

33、d long length)；说明： 将十六进制数据转换为ASCII码参数： hex: 输入要转换的字符串 asc： 存放转换后的字符串 length: 为要转换的字符串长度返回： = 0 正确 0 错误 举例： unsigned char databuff15=0xa1,0xa2,0xa3,0xa4,0xa5 ; unsigned char databuff210; st=hex_asc(databuff1,databuff2,5);注意：转换后的字符串长度为2*length(26) int asc_asc(unsigned char *source, unsigned char *dest

34、, unsigned long length);说明： 字符串转换成字符串。专为VB5 ByRef传址方式提供的赋值函数。参数： source: 要转换的ASCII码字符串（声明:Byval source as string) dest ： 转换后的ASCII码字符串（声明:ByRef dest as byte) length: 字符串的长度返回： = 0 正确 0 错误 举例： dim databuff(6) as byte; st=asc_asc(“123abc”,databuff(0),6); VB5环境下，对于ASCII值码大于128的情况，可利用上述三个函数实现正常转换。其中，asc

35、_asc()是专为VB5 ByRef传址方式提供的赋值函数。 DELPHI3、VFP、PB5等开发环境，利用asc_hex()和hex_asc()两个函数可方便地实现ASCII码和十六进制数据的转换。详细请参考Examples目录下的范例。注意：C静态库、Unix、Linux库中没有提供上述三个函数。b. AT24C01A/24C02/24C04/24C08/24C16/24C64函数库 以24C01A为例,其它卡的函数与此类似 int swr_24c01a(int icdev,int offset,int len, unsigned char *databuff)说明： 向指定地址写数据 调

36、用： icdev: 通讯设备标识符 offset: 偏移地址，范围0-127 len: 字符串长度，范围1-128 databuff: 存放要写的数据 返回： <0 错误 =0 正确举例： unsigned char databuff5=s,a,n,n,y; st=swr_24c01a(icdev,0,5,databuff); 将databaff中前5个字节写入从偏移地址0开始的5个字节中 int srd_24c01a(int icdev,int offset,int len, unsigned char *databuff)说明： 从指定地址读数据 调用： icdev: 通讯设备标识符

37、 offset: 偏移地址，范围0-127 len: 字符串长度，范围1-128 databuff: 存放要读出的数据 返回： <0 错误 =0 正确举例： unsigned char databuff5; st=srd_24c01a(icdev,0,5,databuff); 从偏移地址0开始读出5个字节数据放入databuff中 int chk_24c01a(int icdev)说明： 检查卡型是否正确 调用： icdev: 通讯设备标识符 返回： <0 错误 =0 正确举例： st=chk_24c01a(icdev)补充说明：24系列卡偏移地址和长度取值如下: 卡型 offse

38、t len24C01A0-1271-12824C020-2551-25624C040-5111-51224C080-10231-102424C160-20471-204824C640-81911-8912c. AT45D041函数库1 int swr_45d041 (int icdev,int page,int offset,long len,unsigned char *databuff)说明： 向指定地址写数据 调用： icdev: 通讯设备标识符 page: 页面地址，范围0-2047 offset: 偏移地址，范围0-263 len: 字符串长度，范围1-540672 databuff: 存放要写的数据 返回： <0 错误 =0 正确举例： unsigned char databuff5=s,a,n,n,y; st=swr_45d041 (icdev,0，0,5,databuff)