OURMIFAREdll动态库使用说明Word文档格式.docx

OURMIFAREdll动态库使用说明Word文档格式.docx

《OURMIFAREdll动态库使用说明Word文档格式.docx》由会员分享，可在线阅读，更多相关《OURMIFAREdll动态库使用说明Word文档格式.docx（33页珍藏版）》请在冰豆网上搜索。

本读写器支持ISO14443 

TYPE 

A标准的Mifare 

One系列卡.Mifare 

One卡的内部存储结构分为16个扇区，从第0区到第15区，每个扇区有独立的密码和权限控制字，可作为独立的电子钱包，每个扇区有4个块，序号为第0块、第1块、第2块、第3块，每块16个字节，第3块是卡的密码和权限控制字专用块，禁止在此存放数据。

第0块、第1块、第2块可随意存放数据。

但第0区的第0块已被固化了IC卡出厂信息，此块只能读出信息，不可更改。

每张卡都有一个全球统一的4个字节的序列号。

许多公司销售的读卡器只有读取卡序列号的功能,也能用于一般的考勤系统。

但这类读卡器跟本公司的读写器有着本质的不同，本公司的读写器不仅能读序列号，而且还有服务于IC卡所有用途的功能，比如选中卡、认证、读卡、写卡、改密码、休眠卡能功能.

二、易用函数

大部份软件、一卡通公司，只要使用以下二个函数完全可以达到软件需求，比如读出信息、读出金额、扣费等等。

轻松读卡：

函数名：

piccreadex

功能

超强读卡，使用些函数可以一次性读整个区的第0块、第1块、第2块共3块的信息,并且返回卡序列号。

原始声明

unsignedchar__stdcallpiccreadex（unsignedcharctrlword,unsignedchar*serial,unsignedchararea，unsignedcharkeyA1B0，unsignedchar＊picckey,unsignedchar*piccdata0_2）

输入

1、ctrlword读卡的控制字，ctrlword是一个字节，相当于八个位，每个位只有0和1两种状态：

推荐使用方法如下:

//先定义以下常量

＃defineBLOCK0_EN0x01

#defineBLOCK1_EN0x02

#defineBLOCK2_EN0x04

#defineNEEDSERIAL0x08

＃defineEXTERNKEY0x10

举例:

//以下控制字含义：

读块0、块1、块2，仅读指定序列号的卡,需要每次指定密码

Ctrlword=BLOCK0_EN+BLOCK1_EN+BLOCK2_EN+NEEDSERIAL+EXTERNKEY

读块0、块2,可读任意卡，需要每次指定密码

Ctrlword=BLOCK0_EN+BLOCK2_EN+EXTERNKEY

读块0、块2，可读任意卡，启用芯片内部密码

Ctrlword=BLOCK0_EN+BLOCK2_EN

2、serial只需指向一个至少已分配了4个char空间的可写数组unsignedchar*指针，serial的下标由0开始。

如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值，因为此数组仅用于返回值。

如果指定了NEEDSERIAL,则必须为数组的内容赋值。

3、area是需要读出的区号，则0-15中的某个数。

4、keyA1B0为0时以B密码来认证，为非0时以A密码来认证。

刚出厂的卡以A密码来认证.

5、＊picckey指向存放卡密码的数组（6个char的密码数组）。

6、*piccdata0_2是指向下标个数大于48的字节数组，用于存放3个块的数据，其中下标0～15存放作为读出的块0的数据,下标16～31存放作为读出的块1的数据,下标32～47存放作为读出的块2的数据，

返回

返回unsignedchar值,并将卡本块的数据传值到＊piccdata指向的数组中.

返

回

值

说

明

操作成功，读出的数据有效。

1

0~2块都没读出来,可能刷卡太块。

但卡序列号已被读出来。

2

第0块已被读出,但1～2块读取失败。

卡序列号已被读出来.

3

第0、1块已被读出,但2块读取失败。

卡序列号已被读出来。

8

寻卡错误，根本就没有卡在感应区,*serial无效.

9

有多张卡在感应区，寻卡过程中防冲突失败，*serial无效.

10

该卡可能已被休眠,无法选中，但卡序列号已被读出，*serial数组中的数据有效。

11

密码装载失败。

12

密码认证失败。

21

本函数需要引用的动态库ICUSB.DLL不在当前目录下.

22

动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。

dll到正确的位置。

24

操作超时。

可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器.

27

USB传输不稳定导致传输的字符不全.不需理会这个错误，因为基本上是不会出现这个错误的.

28

USB传输不稳定导致CRC校验错.不需理会这个错误，因为基本上是不会出现这个错误的。

其他

未知错误

例子及注释

请要本公司网站下载各种开发工具的例子源代码，本函数的声明和输入参数格式可以直接套用，谢谢使用

轻松写卡：

Piccwriteex

超强写卡，使用些函数可以一次性写整个区的第0块、第1块、第2块信息。

unsignedchar__stdcallpiccwriteex（unsignedcharctrlword，unsignedchar＊serial,unsignedchararea，unsignedcharkeyA1B0,unsignedchar*picckey，unsignedchar＊piccdata0_2）

1、ctrlword读卡的控制字,ctrlword是一个字节，相当于八个位，每个位只有0和1两种状态：

推荐使用方法如下：

＃defineBLOCK2_EN0x04

#defineEXTERNKEY0x10

#defineNEEDHALT0x20

举例：

//以下控制字含义:

读块0、块1、块2，仅写指定序列号的卡，需要每次指定密码，写成功后休眠卡

Ctrlword=BLOCK0_EN+BLOCK1_EN+BLOCK2_EN+NEEDSERIAL+EXTERNKEY+NEEDHALT

写块0、块2，可写任意卡,需要每次指定密码，写成功后休眠卡

Ctrlword=BLOCK0_EN+BLOCK2_EN+EXTERNKEY+NEEDHALT

写块0、块2，可写任意卡，启用芯片内部密码，写成功后休眠卡

Ctrlword=BLOCK0_EN+BLOCK2_EN+NEEDHALT

2、serial只需指向一个至少已分配了4个char空间的可写数组unsignedchar*指针，serial的下标由0开始.如果在控制字中没有指定NEEDSERIAL，则Serial数组的内容无需赋值，因为此数组仅用于返回值。

如果指定了NEEDSERIAL，则必须为该数组的内容赋值。

3、area是需要准备写的区号,则0-15中的某个数.

4、keyA1B0为0时以B密码来认证,为非0时以A密码来认证。

刚出厂的卡以A密码来认证。

5、*picckey指向存放卡密码的数组（6个char的密码数组）。

6、＊piccdata0_2是指向下标个数大于48的字节数组,用于存放3个块的数据,其中下标0～15存放作为准备写的块0的数据，下标16~31存放作为准备写的块1的数据，下标32～47存放作为准备写的块2的数据，

返回unsignedchar值，并将卡本块的数据传值到＊piccdata指向的数组中。

操作成功，写卡数据有效。

0～2块都没写进去,可能刷卡太块。

第0块已写进去，但1~2块写失败.

第0、1块已被写进去，但2块读写失败。

寻卡错误,根本就没有卡在感应区,*serial无效。

有多张卡在感应区,寻卡过程中防冲突失败，*serial无效。

该卡可能已被休眠，无法选中，但卡序列号已被读出，＊serial数组中的数据有效。

密码认证失败

本函数需要引用的动态库ICUSB。

DLL不在当前目录下。

动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试,或者重新拷贝动态库OUR_MIFARE.dll到正确的位置。

操作超时.可能是电脑中毒导致USB帧传递调度缓慢,或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。

USB传输不稳定导致传输的字符不全。

不需理会这个错误，因为基本上是不会出现这个错误的。

USB传输不稳定导致CRC校验错。

以上函数是在已知卡密码的情况下操作。

如果需要更改卡密码可通过piccchangesinglekey函数，快速地更改卡密码，piccchangesinglekey详细介绍请查看下面第12页.

让读写器发出声音

函数名:

pcdbeep

让读写器发出声响。

（暂不开放对指示灯的控制，如果有特殊要求请致电本公司）

unsignedchar__stdcallpcdbeep（unsignedlongxms）

xms为响声的时间长度，单位为2毫秒

返回unsignedchar值。

操作成功，。

dll到正确的位置.

操作超时.可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。

USB传输不稳定导致CR