MUR100上位机库函数及演示软件使用说明.docx

1、MUR100上位机库函数及演示软件使用说明MUR-100上位机库函数及演示软件使用说明一USB驱动里面分别有WIN98和WIN2000_xp的驱动安装文件首先把读卡器连接到主机的USB口上要求安装这种硬件的驱动程序1. 对于WIN98第一次连接到USB口时出现的提示框如下点击下一步 选择第一个选项出现下图选择指定位置选项从中选择目录出现下图 点击下一步 点击完成按钮就完成了对USB驱动的安装 点击下一步 选择第一个选项出现下图 选择指定一个位置选项出现下图点击浏览按钮USB驱动安装win2000_xpdrivers 点击完成按钮就完成了对USB驱动的安装演示软件的使用开始进入系统时界面如下图1

2、.选择要进行操作的读卡器类型开始进行操作前这里选择MUR-1002.设置连接参数接下来从设置菜单中选择参数选择选项此时会弹出一个对话框3.连接接着从文件菜单中选择连接选项进行连接连接上后系统界面如下图此时你要选择你想操作的卡型号3.1选择MF1S50/70卡接下来的操作有两个分支只要你选择好要进行操作的各项参数写入数据写入数值和加减还有装载密钥以及更改密钥按钮进行操作了你可以直接双击左边树列表框中的某个数据块来直接选择此数据块这里有必要详细说明一下装载密钥以及更改密钥的功能在其中你可以进行装载密钥操作在以后要验证卡密钥的时候就可以调用RC500USB_authentication2这个函数来进

3、行验证密钥操作3.1.1.2更改密钥点击此按钮会弹出一个更改密钥对话框当你设置好验证参数后读取原始参数此时界面如下在对话框中的两个表格中颜色变为反白的一行表示为对应的卡的原始访问条件在设置好新密钥A和B以及新访问条件后就可以点击按钮进行修改3.1.2循环测试要进行循环操作时此时弹出一个对话框从中你可以选择你循环测试时所要进行的操作每次读写完将卡挂起就开始对卡进行读写操作要进行第二次操作的话然后再放进去才行此时你可以点击循环测试按钮进行测试在这之前首先得确保你已经选择好要进行操作的各项参数要改变只能先中止循环测试再进行更改你只要把卡放到感应区就能自动进行指定的操作循环测试选项前打勾表示已经选择

4、在密钥编辑框中输入卡的密钥后点击按钮则会弹出一个更改密钥对话框来进行更改密钥操作点击速度测试按钮可以进行读写卡速度测试三库函数说明1.1 unsigned char _stdcall RC500USB_init(入口参数此函数的功能是打开USB无函数功能1.3unsigned char _stdcall RC500USB_request(unsigned char mode, unsigned short &tagtype入口参数HALT状态的除外此函数发送Request命令返回值否则返回错误码bcnt:为预选卡所分配的位的个数此函数开始防冲突操作0表示成功1.5unsigned char _

5、stdcall RC500USB_anticoll2(unsigned char encoll,unsigned char bcnt,unsigned long &snr入口参数则使能多张卡进入天线区则不允许多张卡进入通常Bcnt=0snr:返回卡的序号函数功能返回值否则返回错误码snr:卡的序号size:返回卡的容量函数功能返回值否则返回错误码mode:密钥类型,密钥A:0x00,密钥B:0x04secnr:要验证的卡扇区号函数功能在进行对卡片的读写操作之前在系统初始化时返回值否则返回错误码mode:密钥类型,密钥A:0x00,密钥B:0x04secnr:要验证的卡扇区号keynr:用于证实

6、的密匙区号函数功能在进行对卡片的读写操作之前在系统初始化时返回值否则返回错误码mode:密钥类型,密钥A:0x00,密钥B:0x04key:存储密钥缓冲区secnr:要验证的卡扇区号函数功能写减等操作前若卡中的密钥与所传输的密码相匹配函数将返回MI_OK返回值否则返回错误码无函数功能即使之处于Halt模式只能用ALL 方式进行选择返回值否则返回错误码addr:块号(0x00-0x3fdata:块数据此函数功能是读取卡的一个块的数据0表示成功1.12unsigned char _stdcall RC500USB_write(unsigned char addr,unsigned char *da

7、ta 入口参数长度16个字节函数功能返回值否则返回错误码addr: 块号(0x00-0x3fvalue: 要写入的值函数功能返回值否则返回错误码addr: 块号(0x00-0x3fvalue: 存储要读出的值函数功能返回值否则返回错误码mode:模式加C1H复制C2H返回值否则返回错误码mode:密钥类型,密钥A:0x00,密钥B:0x04secnr:要载入的读卡器中的密钥区号key:密码这条指令的功能是将RC500中的密匙与卡中的密匙进行验证必须成功执行此指令主控设备将把每个扇区的密码加载到读卡器中0表示成功1.17unsigned char _stdcall RC500USB_reset(

8、unsigned char msec入口参数msec:射频电路关闭时间函数功能若msec=0Request命令到来返回值否则返回错误码无函数功能关闭RC500Config(0表示成功1.19unsigned char _stdcall RC500USB_config(void入口参数模块每次上电复位之后才能进行进一步的操作0表示成功1.20unsigned char _stdcall RC500USB_get_info(unsigned char *info入口参数依次为0x30,0x88,0xf8,0x00,0xXXinfo5-info8为RC500的序列号函数功能返回值否则返回错误码无函数

9、功能返回值否则返回错误码无函数功能0表示成功1.23unsigned char _stdcall RC500USB_buzzer(unsigned char contrl, unsigned char opentm, unsigned char closetm, unsigned char repcnt入口参数如下表相应位为1时该器件动作取值取值此函数输出一驱动信号可驱动蜂鸣器和绿色发光管间隙时间和重复次数可调0表示成功1.24unsigned char _stdcall RC500USB_read_E2(unsigned char addr,unsigned char length,unsi

10、gned char *data入口参数被读RC500内EEPROM首址被读数据长度dataRC500内EEPROM的数据读出0表示成功1.25unsigne d char _stdcall RC500USB_write_E2(unsigned char addr,unsigned char length,unsigned char *data入口参数RC500内EEPROM的写入首址0x30-0x7E被写数据长度data此函数将数据写入RC500内EEPROM中0x10-0x2F为启动寄存器初始化文件区0x80-0x1FF为只读密钥区0x7F为模块波特率参数存贮区返回值否则返回错误码keybl

11、ock4 字节密码首址函数功能返回值否则返回错误码block4 字节数据首址函数功能返回值否则返回错误码block4 字节数据首址函数功能返回值否则返回错误码2.库函数使用方法2.1调用动态库方法首先总共有四个文件RC500USB.libEasyD12_500.dll1在工程文件中加入RC500USB.lib文件首先得调用LoadLibrary函数来加载RC500USB.dll,用完后调用FreeLibrary函数来卸载之则可以按照以下步骤来调用语法:Public|PrivateDeclareFunctionnameLiblibnameAliasaliasname(arglistAstypeD

12、eclare语句的语法包含下面部分可选PrivateName动态链接库的入口处区分大小写必选包含所声明的函数动态链接库名或代码资源名可选表示将被调用的函数在动态链接库(DLL中还有另外的名称就可以使用这个参数常数或任何其它过程的名称相同时如果该动态链接库函数中的某个字符不符合动态链接库的命名约定时Aliasname动态链接库则aliasname是动态链接库中该函数入口处的名称则随后的字符必须指定该函数入口处的顺序号可选代表调用该函数时需要传递参数的变量表可选Function返回值的数据类型Boolean Long Single Decimal String或Variant或对象类型Option

13、alByVal|ByRefParamArrayvarname(Astype部分描述可选表示参数不是必需的则arglist中的后续参数都必需是可选的如果使用了ParamArrayByValByRef例如2.2库函数使用流程2.2.1操作MIFARES70/S50卡时的操作流程2.2.2操作SHC1102卡时的操作流程注只有在操作SHC1102卡时需要复位2.3使用举例2.3.1 操作MIFARE S70/S50例子#include “RC500USB.h”unsigned long snr;unsigned short type;unsigned char size;unsigned char

14、data16;unsigned char szpwd6=0xff,0xff,0xff,0xff,0xff,0xff;for(int i=0;i16;i+datai=i;long value=0x500;RC500USB_init(; /打开USBwhile(1if(RC500USB_request (0,type!=0 /对第一个读卡器进行操作continue;if(RC500USB_anticoll(0,snr!=0 /进行防碰撞选择printf(%xn,value;RC500USB_halt(; /使卡进入halt状态RC500USB_buzzer(1,25,25,1; /让蜂鸣器响一次s

15、leep(50;2.3.2 操作SHC1102例子unsigned short type;unsigned char data4;unsigned char szpwd4=0xff,0xff,0xff,0xff;for(int i=0;i4;i+datai=i;RC500USB_init(; /打开端口和设定波特率while(1RC500USB _reset(2; /让天线复位2msif(RC500USB_request (0,type!=0 /发送请求命令continue;if(RC500USB_authshc1102(8,szpwd!=0 /验证密钥continue;if(RC500USB

16、_wirteshc1102(2,data!=0 /往第二块写入数据continue;if(RC500USB_readshc1102(2,data!=0 /读取第二块的数据continue;RC500USB_buzzer(1,25,25,1; /让蜂鸣器响一次sleep(50;附录函数名称执行时间RC500USB_request3.295RC500USB_anticoll3.911RC500USB_anticoll23.930RC500USB_select4.024RC500USB_authentication4.946RC500USB_authentication25.970R C500USB

17、_authkey6.922RC500USB_halt4.020RC500USB_read5.000RC500USB_write10.285RC500USB_writeval10.400RC500USB_readval5.101RC500USB_value15.644RC500USB_load_key9.967RC500USB_reset2.914RC500USB_close0.911RC500USB_config30.979RC500USB_set_control_bit0.941RC500USB_clr_control_bit1.847RC500USB_buzzer1.965RC500USB

18、_read_E23.551(16bytesRC500USB_write_E29.914(16bytesRC500USB_authshc11024.040RC500USB_readshc11023.848RC500USB_writeshc110221.036 错误码列表 名称 MI_OK, COMM_OK MI_NOTAGERR MI_CRCERR MI_EMPTY MI_AUTHERR MI_PARITYERR MI_CODEERR MI_SENDRERR MI_NOTAUTHERR MI_BITCOUNTERR MI_BYTECOUNTERR MI_TRANSERR MI_WRITEERR

19、MI_INCRERR MI_DECRERR MI_READERR MI_COLLERR MI_QUIT MIS_CHK_OK MIS_CHK_FAILED MIS_CHK_COMPERR COMM_ERR 值 0 1 2 3 4 5 6 8 10 11 12 14 15 16 17 18 24 30 0 1 2 255 描述 函数调用成功 在有效区域内没有卡 从卡中接收到了错误的 CRC 校验和 值溢出 不能验证 从卡中接收到了错误的校验位 通信错误 在防冲突时读到了错误的串行码 卡没有验证 从卡中接收到了错误数量的位 从卡中接收了错误数量的字节 调用 Transfer 函数出错 调用 Write 函数出错 调用 Increment 函数出错 调用 Decrment 函数出错 调用 Read 函数出错 冲突错 上一次了送命令时被打断 Check Write 正确 Check Write 出错 Check Write:写出错 串行通信错误 比较出错