OUR_MIFARE.dll动态库使用说明.doc

动态库使用说明一、动态库简介动态库 用 ++ 开发, 编译成 Release 实体, 适用于 WIN98 、 NT 、 2000 、 XP 、 2003 环境。本文档下面的源代码例子是 C++builder 的调用格式。本动态库是本公司 USB 接口 IC 卡读写器的配套文件, 必须和读写器一起使用。还必须将硬件底层驱动的动态库 放在与 同一个目录下, 否则不能使用。 在调用 时采用的是动态调用的方法,所以在软件运行中可以随时更换 USB 接口。推荐使用动态调用的方法使用本动态库。 IC 卡内部存储结构知识: 本读写器支持 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卡所有用途的功能,比如选中卡、认证、读卡、写卡、改密码、休眠卡能功能。二、易用函数大部份软件、一卡通公司, 只要使用以下二个函数完全可以达到软件需求, 比如读出信息、读出金额、扣费等等。: 函数名: readex 功能超强读卡, 使用些函数可以一次性读整个区的第 0块、第1块、第2 块共 3块的信息,并且返回卡序列号。原始声明 unsigned char __stdcall readex(unsigned char ctrlword,unsigned char *serial,unsigned char area,unsigned char keyA1B0,unsigned char *key,unsigned char *data0_2) 输入 1、 ctrlword 读卡的控制字, ctrlword 是一个字节,相当于八个位,每个位只有 0和1 两种状态: 推荐使用方法如下: //先定义以下常量#define BLOCK0_EN 0x01 #define BLOCK1_EN 0x02 #define BLOCK2_EN 0x04 #define NEEDSERIAL 0x08 #define EXTERNKEY 0x10 举例: //以下控制字含义:读块 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 空间的可写数组 unsigned char * 指针, seria l 的下标由0 开始。如果在控制字中没有指定 NEEDSERIAL ,则 Seria l 数组的内容无需赋值,因为此数组仅用于返回值。如果指定了 NEEDSERIAL ,则必须为数组的内容赋值。 3、 area 是需要读出的区号,则 0-15 中的某个数。 4、 keyA1B0 为0 时以 B 密码来认证, 为非 0 时以 A 密码来认证。刚出厂的卡以A 密码来认证。 5、*key 指向存放卡密码的数组(6个 char 的密码数组)。 6、*data0_2 是指向下标个数大于 48 的字节数组, 用于存放 3 个块的数据, 其中下标 0~15 存放作为读出的块 0 的数据,下标 16~31 存放作为读出的块 1 的数据,下标 32~47 存放作为读出的块 2 的数据, 返回返回 unsigned char 值,并将卡本块的数据传值到*data 指向的数组中。返回值说明 0 操作成功,读出的数据有效。 1 0~2 块都没读出来,可能刷卡太块。但卡序列号已被读出来。 2第0 块已被读出,但 1~2 块读取失败。卡序列号已被读出来。