读写卡模块的外设驱动代码编写技巧
6.4 读写卡模块
>>> 6.4.1 基本功能
zlg600a 是zlg 提供的符合14443 标准的13.56mhz 读写卡模块，支持plus cpu、mifare desfirecpu 卡、mifare 1 s50/s70、mifare 0 ultralight、mifare pro 卡，还支持iso7816 协议读写接触式ic 卡。可以搭载两个天线满足不同位置的多卡读写要求，连接从机数多达127 个，支持i2c、uart、rs-232c、rs-485 多种接口。具备主动检测卡进入功能，当检测到卡时，则产生中断且通过串口、i2c 输出数据。
zlg600a 系列读写卡模块选型指南详见表6.18，电源电压为5v，平均电流为77ma，typea、typeb 和plus cpu卡读卡距离分别为7.5cm、4cm 和5cm。
表6.18 选型指南表
由于rs-232c 和rs-485 与uart通信方式完全相同，仅在硬件上增加了一些转换电路，因此后面不再特别说明。在这里仅介绍i2c 和uart 两种通信方式，其引脚含义详见表6.19。
表6.19 通信接口定义
注：方形焊盘为第1 管脚，3.3v 模块j1-5 接3.3v 电源，5v 模块j1-5 接5v 电源。
当使用uart 通信时，只需要连接j1 中的电源引脚和txd、rxd 引脚，其它引脚悬空，将lpc824 的usart0、usart1 或usart2 与zlg600a 相连。当使用i2c 通信时，需要连接j1 中的电源引脚和scl、sda 引脚。由于i2c 从机不能主动向i2c 主机发送数据，因此需要使用int 引脚，用于从机通知主机处理事务。其它未使用的引脚通过10k 的上拉电阻与高电平相连，将lpc824 的i2c0、i2c1、i2c2 或i2c3 与zlg600a 相连。注：scl 和sda 模块内部都有上拉电阻，使用i2c 通信时无需再外接上拉电阻。
>>> 6.4.2 初始化
ametal 已经提供了zlg600a 的驱动函数，在使用其它各功能函数前必须先完成初始化，其初始化函数详见表6.20。
表6.20 zlg600a 初始化接口函数
初始化zlg600a 意在获取zlg600a 的实例句柄（handle），虽然初始化函数不同，但返回值均为zlg600a 的实例句柄，该实例句柄将作为其它功能接口函数handle 的实参。因此，无论选择i2c 或uart 通信方式，只要基于实例句柄编程，则应用程序与具体的通信方式无关。即便底层通信方式改变了，仅需在获取实例句柄时换一个初始化函数，而应用程序“一行代码”都不用修改。
1． uart 初始化
使用uart 时，其初始化函数原型为：
p_dev 为指向am_zlg600_uart_dev_t 类型实例的指针；
p_devinfo 为指向am_zlg600_uart_devinfo_t 类型实例信息的指针。
（1）实例
定义am_zlg600_uart_dev_t 类型（am_zlg600.h）实例如下：
其中，g_zlg600_uart_dev 为用户自定义的实例，其地址作为p_dev 的实参传递。
（2）实例信息
实例信息主要描述了zlg600a 使用uart 通信时的相关信息，包括uart 缓冲区信息、波特率等信息。其类型am_zlg600_uart_devinfo_t 定义（am_zlg600.h）如下：
实例信息主要包含帧格式、zlg600a 模式、波特率和缓冲区信息。
帧格式
frame_fmt 表示初始化时zlg600a 使用的帧格式，为了兼容早期产品，zlg600a 支持新帧格式和旧帧格式，其对应的宏详见表6.21。在初始化完成后，可以通过相应的接口函数修改zlg600a 使用的帧格式。但在初始化时，要知道zlg600a 当前使用的帧格式，出厂默认使用的帧格式为旧帧格式，frame_fmt 的值设置为：am_zlg600_frame_fmt_old。
表6.21 帧格式对应的宏（am_zlg600.h）
注：若本次初始化完成后，通过后续相关功能接口函数更换使用的帧格式（如将旧帧格式更换为新帧格式），那么在系统下次启动调用zlg600a 初始化函数时，需要确保frame_fmt成员的值为更新后的帧格式（如新帧格式）。
zlg600a 模式
now_mode 为初始化时使用的模式，zlg600a 支持3 种模式：自动侦测模式、i2c 模式、uart 模式。其对应的宏详见表6.22，出厂默认为自动侦测模式。
表6.22 模式对应的宏（am_zlg600.h）
注：由于在自动侦测模式下，为了使用uart 通信，需要host 连续发送两次0x20（两次的时间间隔需要30us 以上），便于zlg600a 检测有效波特率，将会使得每次初始化zlg600a 的耗费时间较长。因此在本次初始化完成后，通过后续接口函数将模式固定为uart 模式。更新模式后，系统在下次启动调用zlg600a 初始化函数时，需确保now_mode 成员的值为更新后的模式（如uart 模式）。
在自动侦测模式下，uart、i2c 接口均处于接收状态。若zlg600a 从uart 通信线上检测到有效的波特率（需要host 连续发送两次0x20，且两次的时间间隔在30us 以上，便于zlg600 检测到有效波特率），则模块使用uart 通信方式；若模块从i2c 总线上接收到匹配的从机地址，则模块使用i2c 通信方式。只要其中一个接口先收到有效数据，模块将以此方式与主机通信，且关闭另外一种接口。
在uart 通信模式下，通信接口固定为uart，关闭i2c 接口，无需host再连续发送两次0x20 检测zlg600a 波特率。在i2c 通信模式下，关闭uart接口。在完成初始化后，可以通过相应的接口函数修改zlg600a 使用的模式。但在初始化时，要知道zlg600a 当前使用的模式，出厂默认使用的模式为自动侦测模式，now_mode 的值设置为：
am_zlg600_mode_auto_check。
波特率
baudrate 为uart 波特率，支持波特率的宏定义详见表6.23。在自动侦测模式下，可以选择表中任一有效的波特率，zlg600a 会自动检测使用的波特率。若处于uart 模式，波特率将为固定的值，该值为配置zlg600a 是uart 模式时使用的波特率。
表6.23 支持的uart 波特率对应的宏（am_zlg600.h）
由于出厂默认模式为自动侦测模式，因此该值为任一有效的波特率，如定义波特率为115200，则该值为：am_zlg600_baudrate_115200。
缓冲区信息
当选择uart 方式通信时，发送和接收都需要一个保存数据的缓冲区，以提高数据处理的效率和确保接收数据不会因为正在处理事务而丢失。缓冲区的大小由用户根据实际情况指定，建议在64 字节以上，一般设置为128 字节。p_uart_rxbuf 和rxbuf_size 描述了接收缓冲区的首地址和大小，p_uart_txbuf 和txbuf_size 描述了发送缓冲区的首地址和大小。如果设置128 字节的缓冲区供发送和接收使用，其定义如下：
其中，g_zlg600_uart_txbuf[128]为用户自定义的数组空间供发送使用，充当发送缓冲区，其地址（数组名g_zlg600_uart_txbuf 或首元素地址& g_zlg600_uart_txbuf[0]）作为实例信息中p_uart_txbuf 成员的值，数组大小（这里为128）作为实例信息中txbuf_size 成员的值。同理，g_zlg600_uart_rxbuf[128]充当接收缓冲区，其地址作为实例信息中p_uart_rxbuf 成员的值，数组大小作为实例信息中rxbuf_size 成员的值。基于此，实例信息定义如下：
（3）uart 句柄uart_handle
若选择lpc824 的usart1 与zlg600a 通信，则可以通过lpc82x 的usart1 实例初始化函数am_lpc82x_usart1_inst_init()获得uart 句柄。即：
获得的uart 句柄即可直接作为uart_handle 的实参传递。
（4）实例句柄
zlg600a 初始化函数am_zlg600_uart_init()的返回值即为zlg600a 实例的句柄，该句柄将作为其它功能接口的第一个参数（handle）的实参。
其类型am_zlg600_handle_t（am_zlg600.h）定义如下：
若返回值为null，说明初始化失败；若返回值不为null，说明返回一个有效的handle。
基于模块化编程思想，将初始化相关的实例、实例信息等的定义存放到对应的配置文件中，通过头文件引出实例初始化函数接口，源文件和头文件的程序范例分别详见程序清单6.98 和程序清单6.99。
程序清单6.98 zlg600a（串口通信）实例初始化函数实现（am_hwconf_zlg600.c）
程序清单6.99 zlg600a（串口通信）实例初始化函数声明（am_hwconf_zlg600.h）
后续只需要使用无参数的实例初始化函数，即可获取zlg600a 的实例句柄。即：
2． i2c 初始化
使用i2c 通信方式时，其初始化函数原型为：
p_dev 为指向am_zlg600_i2c_dev_t 类型实例的指针；
p_devinfo 为指向am_zlg600_i2c_devinfo_t 类型实例信息的指针。
（1）实例
定义am_zlg600_i2c_dev_t 类型（am_zlg600.h）实例如下：
其中，g_zlg600_i2c_dev 为用户自定义的实例，其地址作为p_dev 的实参传递。
（2）实例信息
实例信息主要描述了zlg600a 使用i2c 通信时的相关信息，包括i2c 缓冲区信息、波特率等信息。其类型am_zlg600_i2c_devinfo_t 的定义（am_zlg600.h）如下：
实例信息主要包含帧格式、zlg600a 模式、7 位i2c 从机地址和中断引脚信息。
frame_fmt 的含义与使用uart 通信方式时一致，对于出厂设置的模块，frame_fmt 的值应设置为：am_zlg600_frame_fmt_old。
now_mode 的含义与使用uart 通信方式时一致，对于出厂设置的模块，now_mode 的值应设置为：am_zlg600_mode_auto_check。在本次初始化完成后，若通过后续接口函数将模式固定为i2c 模式。则系统在下次启动调用zlg600a 初始化函数时，必须确保now_mode 成员的值为更新后的i2c 模式。
slv_addr 为zlg600a 的7 位i2c 从机地址，出厂默认值为0x59，数据手册中描述为0xb2，该值为8 位地址，右移一位，即移除表示读写方向的位后，值即为0x59。在本次初始化完成后，若通过后续接口函数修改i2c 地址。则系统在下次启动调用zlg600a 初始化函数时，必须确保slv_addr 成员的值为更新后的i2c 地址。
int_pin 为zlg600a 的int 引脚与实际微控制器（如lpc824）连接的引脚号。比如，选择lpc824 的pio0_13 与zlg600a 的 int 引脚相连，则该值应设置为pio0_13。
基于此，实例信息定义如下：
（3）i2c 句柄i2c_handle
若选择lpc824 的i2c1 与zlg600a 通信，则通过lpc82x 的i2c1 实例初始化函数am_lpc82x_i2c1_inst_init()获得i2c 句柄。即：
获得的i2c 句柄即可直接作为i2c_handle 的实参传递。
（4）实例句柄
am_zlg600_i2c_init()与am_zlg600_uart_init()的返回值相同，该返回值为zlg600a 实例的句柄，该句柄将作为其它功能接口的第一个参数（handle）的实参。若返回值为null，说明初始化失败；若返回值不为null，说明返回一个有效的handle。
基于模块化编程思想，将初始化相关的实例、实例信息等的定义存放到对应的配置文件中，通过头文件引出实例初始化函数接口，源文件和头文件的程序范例分别详见程序清单6.100 和程序清单6.101。
程序清单6.100 新增zlg600a 的i2c 通信方式的实例初始化函数（am_hwconf_zlg600.c）
程序清单6.101 am_hwconf_zlg600.h 文件内容更新
后续只需要使用无参数的实例初始化函数，即可获取到zlg600a 的实例句柄。即：
>>> 6.4.3 设备控制类接口函数
zlg600a 支持多种ic 卡，比如，mifare s50/s70、iso7816-3、iso14443（picc）、pluscpu 卡等，每种卡都有对应的命令。命令与接口函数基本上是一一对应的关系，zlg600a的命令较多，分为以下5 类：设备控制类命令、mifare s50/s70 卡类命令、iso7816-3 类命令、iso14443（picc）卡类命令和plus cpu 卡类命令。
设备控制类接口函数与具体卡片没有直接关系，主要用于直接操作zlg600a，比如，获取zlg600a 的设备信息和存储ic 卡密钥等，详见表6.24。
表6.24 zlg600a 设备控制类接口函数（am_zlg600.h）
1． 读取设备信息
该函数意在获取zlg600a 的基本信息，包括产品信息和版本信息等，获取的信息为字符串，比如，“zlg600a v1.00”。其函数原型为：
其中，p_info 为获取信息的指针，由于字符串长度为20 字节，因此需要提供一个长度为20 字节的内存空间，以便存放获取到的信息。若返回值为am_ok，说明获取信息成功，反之失败，范例程序详见程序清单6.102。
程序清单6.102 读取zlg600a 设备信息范例程序
假定选择uart 通信方式，即可使用am_zlg600_uart_inst_init()实例初始化函数获取zlg600a 的实例句柄。同时包含标准c 头文件string.h，便于使用strcmp()函数判断字符串是否为“zlg600a v1.00”？
由于这次使用的是zlg600a v1.00 模块，因此获取的信息一定为“zlg600a v1.00”。如果你使用的是其它型号或版本的模块，则要注意将比较信息的字符串修改，否则就算成功读取信息，比较结果也是不相等的。
2． 装载ic 卡密钥
卡片内存储的数据均是加密的，必须验证成功后才能读写数据。验证就是将用户提供的密钥与卡片内部存储的密钥对比，只有相同才认为验证成功。zlg600a 提供了用于存储卡片验证的密钥的e2prom，装载ic 卡密钥的作用就是将密钥存放到指定的e2prom 存储区，其函数原型为：
其中，key_type 为密钥类型，密钥一般分为2 类，其分别为typea 和typeb。其对应的宏详见表6.25。zlg600a 能保存a 类型密钥16组，b 类型密钥16 组。
表6.25 密钥类型（am_zlg600.h）
注：之所以存在两类密钥，是由于实际卡片中往往存在两类密钥，两类密钥可以更加方便地进行权限管理，比如，typea 验证成功后只能读，而typeb 只有验证成功后才能写入，但权限可以自定义设置。
key_sec 为保存的区号，由于zlg600a 能保存a 类密钥16 组和b 类密钥16 组，因此每种类型保存的区域有16 个，其对应区号为0 ~ 15。
p_key 指向了实际待保存密钥的缓冲区，key_length 为密钥的长度，密钥最大长度为16 字节。保存一组6 字节长度的a 类型密钥至区号0 的范例程序详见程序清单6.103。
程序清单6.103 装载密钥范例程序
当后续需要验证卡片时，只需要指定密钥存放的e2prom 区号0，无需再将密钥发送给zlg600a。
>>> 6.4.4 操作接口函数
mifare 卡是一种符合iso14443 标准的a 型卡，其接口函数详见表6.26。
表6.26 mifare s50/s70 接口函数（am_zlg600.h）
经常使用的公交卡、房卡、水卡和饭卡等均是mifare 卡。比如，s50 和s70，它们的区别在于容量的不同。s50 为1kbyte，共16 个扇区，每个扇区4 块，每块16 字节。s70 为4kbyte，共40 个扇区，前32 个扇区每个扇区4 块，每块16 字节，后8 个扇区每个扇区16 块，每块16 字节。
1． 自动检测
设置自动检测回调函数
当有卡片靠近zlg600a 时，将会自动调用用户设定的回调函数，读取卡片的相关信息，因此需要先设置一个回调函数。其函数原型为：
其中，pfn_callback 为指向回调函数的指针，p_arg 为回调函数的参数。若返回am_ok，表示设置成功，反之失败，范例程序详见程序清单6.104。
程序清单6.104 设置自动检测回调函数范例程序
程序中定义了一个detect_flag 变量，表示是否检测到卡片。如果初始值为0，说明未检测到卡片。在设置自动检测回调函数时，将其地址作为回调函数的p_arg 参数。因此在回调函数中，p_arg 实质上是指向detect_flag 的指针，通过该指针将detect_flag 设置为1，表明当前检测到卡片。
启动自动检测
当设置好回调函数后，即可启动自动检测。其函数原型为：
其中，p_info 为指向自动检测相关信息的指针，其类型am_zlg600_auto_detect_info_t 定义如下：
该信息结构体包含检测模式、天线模式、请求模式和密钥验证相关的信息。
检测模式
ad_mode 表示检测模式，用于配置检测相关动作。当检测到卡片时，是否挂起该卡片，若选择挂起，设置ad_mode 的值为am_zlg600_mifare_card_ad_halt（am_zlg600.h），则在检测到一次该卡片后，就将该卡片挂起，后续检测将忽略该卡片。若需再次检测该卡片，必须将卡片远离zlg600a 后重新靠近才有效。若设置ad_mode 的值为0，则不会挂起卡片，每次自动检测均可以检测到靠近的卡片。
举个简单的例子可能更容易理解，在平常刷公交卡时，当卡片靠近刷卡器时，会扣费一次，刷卡成功。若公交卡不离开刷卡器，则不会再次扣费，此时卡片已经被刷卡器挂起了，不会再被识别到。若将公交卡离开刷卡器后再次靠近，将可能再次扣费。
当ad_mode 的值均设置为am_zlg600_mifare_card_ad_halt 时，则可以避免重复检测到同一张卡片。
天线模式
tx_mode 设置天线的工作模式，zlg600a 有2 个天线tx1 和tx2，4 种工作模式：仅使用tx1、仅使用tx2、tx1 和tx2 交替使用、tx1 和tx2 同时使用，各种模式对应的tx_mode 的值宏定义详见表6.27。
表6.27 天线工作模式（am_zlg600.h）
请求模式
req_mode 表示请求模式，即检测所有的卡还是只检测空闲卡，对应的值宏定义详见表6.28，一般来讲只检测空闲卡。
表6.28 请求模式（am_zlg600.h）
密钥验证
由于绝大部分卡片在检测到卡片时，都要先读取一块数据，因此可以将读取数据作为自动检测的一个附加功能。即在检测到卡片时，自动读取1 块（16 字节）数据。由于读取数据前均需要验证，这就需要在启动自动检测时，指定密钥验证相关的信息。
所谓密钥验证就是将用户提供的密钥与卡片内部存储的密钥对比，只有相等方能验证成功。auth_mode 指定了3 种验证模式，其对应的宏表6.29。
表6.29 验证模式（am_zlg600.h）
如果在自动检测到卡片时，不需要读取数据，则应该将auth_mode 的值设置为am_zlg600_mifare_card_auth_no。由于不会用到信息结构体中key_type、key[16]、key_len、nblock 四个成员的值，因此无需设置。
如果需要读取数据，则必须将auth_mode 置为am_zlg600_mifare_card_auth_e2或am_zlg600_mifare_card_auth_direct，其主要区别是验证密钥存放位置不同。
如果使用“直接验证”（am_zlg600_mifare_card_auth_direct）的方式，则信息结构体的key[16]包含了实际的密钥，key_len 表示了密钥的长度。
如果使用“e2 验证”（am_zlg600_mifare_card_auth_e2）方式，则验证密钥存放在zlg600a 的e2prom 中。此时，信息结构体的key[16] 仅使用了首元素key[0]，其值为密钥在e2prom 中的区号（0 ~ 15）。自动检测时，将使用zlg600a 中e2prom 对应区号中的密钥进行验证。key_len 表示密钥的长度。显然，若使用“e2 验证”，则需要确保已经使用am_zlg600_ic_key_load()将密钥存放到了zlg600a 中e2prom 相应的区域。
信息结构体中的nblock 指定了要验证的块，即读取数据的块，只有该块被验证成功后，才能读取数据。mifare s50 和mifare s70 卡片包含的块数目详见表6.30。
表6.30 常见卡片的块数目（am_zlg600.h）
假定无需读取数据，可以定义自动检测信息如下：
定义好相关信息后，可以使用启动函数启动自动检测，即：
读取卡片信息
当启动自动检测后，若前面注册的回调函数被调用，表明检测到卡片，此时可以使用该接口读取卡片的信息。其函数原型为：
其中，p_card_info 为指向卡片信息的指针，用于获取卡片信息。卡片信息的类型am_zlg600_mifare_card_info_t（am_zlg600.h）定义如下：
该信息结构体包含了天线驱动模式、卡片唯一序列号和读取的数据等相关的信息。
天线驱动模式
tx_mode 表示天线的驱动模式，在启动自动检测时，天线的模式有4 种：仅使用tx1、仅使用tx2、tx1 和tx2 交替使用、tx1 和tx2 同时使用。若启动自动检测时使用的模式为tx1 和tx2 交替使用，那么该值将会被设置为实际检测到卡片的天线。tx_mode 可能被设置的值详见表6.31。
表6.31 读取到的天线驱动模式（am_zlg600.h）
当tx1 和tx2 同时使用时，将无法区分具体检测到卡片的天线。
片唯一序列号
每张卡片都具有一个唯一序列号，即uid。所有卡片的uid 都是不相同的。卡的序列号长度有三种：4 字节、7 字节和10 字节。uid_len 表明了读取到的uid 的长度，uid[10]中存放了读取到的uid（字节数）。
读取的数据
在启动自动检测时，指定了读取卡片数据相关的验证信息，若auth_mode 不为am_zlg600_mifare_card_auth_no，且对应的密钥正确，验证成功，将读取启动自动检测时信息结构体的nblock 成员指定的块（由信息结构体的nblock 指定）的数据。读取的数据存放在card_data[16]数组中，读取卡片信息的范例程序详见程序清单6.105。
程序清单6.105 读取卡片信息范例程序
读取卡片信息成功后，将通过调试串口打印出读取到的uid 信息。并翻转led1 灯的状态，指示读取一次卡片信息成功。
2． 卡片验证
由于卡片内存储的数据是加密的，因此必须验证成功后才能读写数据。验证方式有“e2验证”和“直接验证”，它们的区别是用于验证的密钥存放的位置不同。
e2 验证
用于验证的密钥是存放在zlg600a 的e2prom 中，其函数原型为：
其中，key_type 的类型是密钥类型，它的值为am_zlg600_ic_key_type_a 或am_zlg600_ic_key_type_b，分别代表a 类型密钥和b 类型密钥。
p_uid 为指向uid 高4 字节缓冲区的指针，若uid 为4 字节，其值为获取的uid 的首元素地址，即&card_info.uid[0]；若uid 为7 字节，其值为获取的uid 的第3 号元素的地址，即&card_info.uid[3]；若uid 为10 字节，其值为获取的uid 的第6 号元素的地址，即&card_info.uid[6]。key_sec 为密钥存放在zlg600a 的e2prom 中的区号，该值应该与使用am_zlg600_ic_key_load()函数存储对应密钥时使用的区号一致。
nblock 指定本次验证的块号，返回值为am_ok 时表明验证成功，反之失败，使用区号0 中的a 类密钥验证块1 的范例程序详见程序清单6.106。
程序清单6.106 e2 验证范例程序
自动检测获取卡片信息card_info 详见程序清单6.101，调用am_zlg600_ic_key_load()将密钥存放在在0 区的e2prom 中的程序详见程序清单6.103。
实际上绝大部分卡都是4 字节的，而7 或10 字节的uid 卡极少。如果确定使用的卡片uid 为4 字节，则p_uid 的值为&card_info.uid[0]。
直接验证
用于验证的密钥是由接口函数提供，其函数原型为：
其中，key_type、p_uid、nblock 的含义与“e2 验证”相同，由于需要直接提供密钥，因此使用p_key 指向密钥存放的缓冲区，key_len 表示密钥的长度。返回值为am_ok，表明验证成功，反之失败，直接使用6 字节密钥进行验证的范例程序详见程序清单6.107。
程序清单6.107 直接验证范例程序
程序使用6 字节全0xff 作为密钥验证块1，之所以这样，是因为mifare s50/s70 卡片的密钥出厂默认为全0xff，且密钥长度为6 字节。对于出厂默认设置，使用a 类密钥和b类密钥验证均可。对于一些有权限控制的卡片，如验证a 类密钥后仅只读，验证b 类密钥后可写，则需要根据实际情况进行验证，密钥和权限控制的修改后面会进一步介绍。
3． 读写数据
若验证成功，则开始读写已验证的块。读写数据都是以块为单位的，其大小为16 字节。
读取数据
读取数据就是读取某一块的数据，其函数原型为：
其中，nblock 指定读取的块号，p_buf 为指向存放数据的缓冲区，缓冲区大小为16 字节。返回值为am_ok 时，表明读取数据成功，反之失败。如程序清单6.108 所示为读取块1 数据的范例程序。
程序清单6.108 读取数据范例程序
写入一块数据
写入数据就是将数据写入到某一块，其函数原型为：
其中，nblock 指定写入的块号，p_buf 为指向写入数据的缓冲区，缓冲区大小为16 字节。返回值为am_ok 时，说明写入数据成功，反之失败。如程序清单6.109 所示为写入16 字节数据至块1 的范例程序。
程序清单6.109 写入数据范例程序
如程序清单6.110 所示是展示卡片自动检测、验证和读写数据的综合测试范例程序。
程序清单6.110 zlg600 综合测试范例程序
程序每检测到一次卡片（detect_flag 的值为1），将读取一次信息，然后使用调试串口打印uid 的值，接着进行读写检测。若读写检测失败，表明验证失败，很可能密钥不是初始密钥，已经被修改过了。
由于读取uid 并不需要验证，因此，当测试程序运行时，将常见的公交卡、门禁卡、饭卡等卡靠近zlg600a，均可以读取卡片的uid。由于这些卡片的密钥并不知晓，因此读写数据测试很可能会失败。
>>> 6.4.5 密钥和权限控制
mifare s50/s70 卡的初始密钥全为0xff，显然，对于实际产品来讲，希望能够更改其密钥为其它值。由于存在密钥a和密钥b，可以对每个密钥设定不一样的权限，如验证密钥a后仅只读，验证密钥b 后可写。下面以mifare s50 为例，介绍密钥和权限控制的修改方法。
密钥和权限控制是针对扇区而言的，即一个扇区的密钥是相同的，不同扇区的密钥可以不同。s50 共计16 个扇区，每个扇区4 块，每块16 字节，前3块为普通的数据块，最后一块（尾块）为密钥和权限控制块。对最后一块存储的数据进行修改，即可完成密钥和权限控制的修改。操作最后一块的存储数据时要格外小心，数据稍有错误，就可能导致扇区被锁死。尾块的前6 字节为a 密钥，后6字节为b 密钥，中间4 字节用于权限控制，详见图6.11。
图6.11 尾块格式
如需修改密钥和控制权限，重点在理解字节6、7 和8（字节9 是一个普通的数据）的含义。3 个字节共计24 位，每6 位（分别为c1、c2、c3、
由于存在此关系，因此实际控制位的含义仅通过c1、c2、c3 三个位即可确定。控制尾块和数据块的控制位含义是不同的。对于尾块，其控制了密钥a、密钥b 以及控制区域的访问权限。控制位的含义详见表6.32。
表6.32 尾块控制位含义
表中，“×”表示任何情况下都无权限，“keya”表示通过密钥a 验证后可以取得权限，keyb 表示通过密钥b 验证后可以取得权限，“keya | b”表示通过密钥a 或者密钥b 验证后均可取得权限。由此可见，密钥a 的安全性很高，任何情况下都无法读出。特殊情况下，当c1c2c3 的值为000、010 或001 时，验证密钥a 后即可读取密钥b 区域的数据。
无论什么情况，验证密钥a 后，均可获得控制区域的读权限。通过读取控制区域，可以知道当前c1、c2、c3 的值，以判断需要验证哪个密钥后可以获得密钥区域或控制区域的写权限，进而修改密钥和控制区域的值。比如，当前的c1、c2、c3 的值为0、1、1，为了修改密钥a，则需要先验证密钥b，验证密钥b 后，即可对尾块进行写入，写入时其它数据保持不变，仅修改前6 字节（keya 区域）的值即可完全对密钥a 的修改。
对于数据块，c1、c2、c3 控制了对块中存储数据的操作权限，详见表6.33。
表6.33 数据块控制位含义
同样，表中“×”表示任何情况下都无权限，“keya”表示通过密钥a 验证后可以取得权限，keyb 表示通过密钥b 验证后可以取得权限，“keya | b”表示通过密钥a 或者密钥b 验证后均可取得权限。
加值操作（相当于充值）和减值操作（相当于消费）是对块中存放的值进行增加和减少操作，加值和减值均有对应的命令可以直接使用。例如，当前块1 的c1、c2、c3 控制位的值为0、0、0（默认值），只要密钥a 或密钥b 验证通过后，均可取得数据块的读、写、加值、减值的权限。可以根据实际需要，修改尾块中相应控制位的值（修改时，需确保具有写入控制区域的权限），以对数据进行保护。
需要注意的是，凡是表中标识验证密钥b 后可以取得权限的，在特殊情况下验证密钥b后可能并不能取得权限。在介绍尾块控制位含义时，当c1、c2、c3 的值为000、010 或001时，keyb 区域将可能被读取，详见表6.32。这些情况下，由于密钥b 可能被读取，为了确保安全，此时密钥b 验证将无效，即使密钥b 验证通过，同样无法取得相应的权限。
荣耀v9怎么样?荣耀v9颜值、性能、续航、拍照深度评测:值得购买的一部手机
单片机利用软件抗干扰的滤波方法有哪些详细说明
深度剖析光电子技术和产业现状
中国铁塔2019年取得的各项工作成绩总结
讨论IIR滤波器的应用场合及数字数据类型对滤波的影响
读写卡模块的外设驱动代码编写技巧
突破性的InnoSwitch系列IC的出货量已超过10亿颗
各种传感器工作原理汇总图
Intel 12代酷睿Alder Lake处理器谍照曝光
Tim Cook亲自测试 下一代Apple Watch或将支持一个神秘新功能！
受到COVID-19严重影响的国家将如何正确恢复呢？
FPGA的结构特点与开发
无线射频识别软件和中间件系统简介
苹果确认部分iPhone13存在bug_苹果十三还继续香吗
如何正确安装无线振动传感器
Pixel 4将搭载更新率更高的屏幕让触控更加流畅
数字可调谐滤波器如何实现宽带接收器应用
雅观科技与海康威视共同打造空间智能化生态圈
差压式液位计的结构及工作原理 差压式液位计的种类及应用
微生物检测仪器的特性及参数
>>> 6.4.1 基本功能
zlg600a 是zlg 提供的符合14443 标准的13.56mhz 读写卡模块，支持plus cpu、mifare desfirecpu 卡、mifare 1 s50/s70、mifare 0 ultralight、mifare pro 卡，还支持iso7816 协议读写接触式ic 卡。可以搭载两个天线满足不同位置的多卡读写要求，连接从机数多达127 个，支持i2c、uart、rs-232c、rs-485 多种接口。具备主动检测卡进入功能，当检测到卡时，则产生中断且通过串口、i2c 输出数据。
zlg600a 系列读写卡模块选型指南详见表6.18，电源电压为5v，平均电流为77ma，typea、typeb 和plus cpu卡读卡距离分别为7.5cm、4cm 和5cm。
表6.18 选型指南表
由于rs-232c 和rs-485 与uart通信方式完全相同，仅在硬件上增加了一些转换电路，因此后面不再特别说明。在这里仅介绍i2c 和uart 两种通信方式，其引脚含义详见表6.19。
表6.19 通信接口定义
注：方形焊盘为第1 管脚，3.3v 模块j1-5 接3.3v 电源，5v 模块j1-5 接5v 电源。
当使用uart 通信时，只需要连接j1 中的电源引脚和txd、rxd 引脚，其它引脚悬空，将lpc824 的usart0、usart1 或usart2 与zlg600a 相连。当使用i2c 通信时，需要连接j1 中的电源引脚和scl、sda 引脚。由于i2c 从机不能主动向i2c 主机发送数据，因此需要使用int 引脚，用于从机通知主机处理事务。其它未使用的引脚通过10k 的上拉电阻与高电平相连，将lpc824 的i2c0、i2c1、i2c2 或i2c3 与zlg600a 相连。注：scl 和sda 模块内部都有上拉电阻，使用i2c 通信时无需再外接上拉电阻。
>>> 6.4.2 初始化
ametal 已经提供了zlg600a 的驱动函数，在使用其它各功能函数前必须先完成初始化，其初始化函数详见表6.20。
表6.20 zlg600a 初始化接口函数
初始化zlg600a 意在获取zlg600a 的实例句柄（handle），虽然初始化函数不同，但返回值均为zlg600a 的实例句柄，该实例句柄将作为其它功能接口函数handle 的实参。因此，无论选择i2c 或uart 通信方式，只要基于实例句柄编程，则应用程序与具体的通信方式无关。即便底层通信方式改变了，仅需在获取实例句柄时换一个初始化函数，而应用程序“一行代码”都不用修改。
1． uart 初始化
使用uart 时，其初始化函数原型为：
p_dev 为指向am_zlg600_uart_dev_t 类型实例的指针；
p_devinfo 为指向am_zlg600_uart_devinfo_t 类型实例信息的指针。
（1）实例
定义am_zlg600_uart_dev_t 类型（am_zlg600.h）实例如下：
其中，g_zlg600_uart_dev 为用户自定义的实例，其地址作为p_dev 的实参传递。
（2）实例信息
实例信息主要描述了zlg600a 使用uart 通信时的相关信息，包括uart 缓冲区信息、波特率等信息。其类型am_zlg600_uart_devinfo_t 定义（am_zlg600.h）如下：
实例信息主要包含帧格式、zlg600a 模式、波特率和缓冲区信息。
帧格式
frame_fmt 表示初始化时zlg600a 使用的帧格式，为了兼容早期产品，zlg600a 支持新帧格式和旧帧格式，其对应的宏详见表6.21。在初始化完成后，可以通过相应的接口函数修改zlg600a 使用的帧格式。但在初始化时，要知道zlg600a 当前使用的帧格式，出厂默认使用的帧格式为旧帧格式，frame_fmt 的值设置为：am_zlg600_frame_fmt_old。
表6.21 帧格式对应的宏（am_zlg600.h）
注：若本次初始化完成后，通过后续相关功能接口函数更换使用的帧格式（如将旧帧格式更换为新帧格式），那么在系统下次启动调用zlg600a 初始化函数时，需要确保frame_fmt成员的值为更新后的帧格式（如新帧格式）。
zlg600a 模式
now_mode 为初始化时使用的模式，zlg600a 支持3 种模式：自动侦测模式、i2c 模式、uart 模式。其对应的宏详见表6.22，出厂默认为自动侦测模式。
表6.22 模式对应的宏（am_zlg600.h）
注：由于在自动侦测模式下，为了使用uart 通信，需要host 连续发送两次0x20（两次的时间间隔需要30us 以上），便于zlg600a 检测有效波特率，将会使得每次初始化zlg600a 的耗费时间较长。因此在本次初始化完成后，通过后续接口函数将模式固定为uart 模式。更新模式后，系统在下次启动调用zlg600a 初始化函数时，需确保now_mode 成员的值为更新后的模式（如uart 模式）。
在自动侦测模式下，uart、i2c 接口均处于接收状态。若zlg600a 从uart 通信线上检测到有效的波特率（需要host 连续发送两次0x20，且两次的时间间隔在30us 以上，便于zlg600 检测到有效波特率），则模块使用uart 通信方式；若模块从i2c 总线上接收到匹配的从机地址，则模块使用i2c 通信方式。只要其中一个接口先收到有效数据，模块将以此方式与主机通信，且关闭另外一种接口。
在uart 通信模式下，通信接口固定为uart，关闭i2c 接口，无需host再连续发送两次0x20 检测zlg600a 波特率。在i2c 通信模式下，关闭uart接口。在完成初始化后，可以通过相应的接口函数修改zlg600a 使用的模式。但在初始化时，要知道zlg600a 当前使用的模式，出厂默认使用的模式为自动侦测模式，now_mode 的值设置为：
am_zlg600_mode_auto_check。
波特率
baudrate 为uart 波特率，支持波特率的宏定义详见表6.23。在自动侦测模式下，可以选择表中任一有效的波特率，zlg600a 会自动检测使用的波特率。若处于uart 模式，波特率将为固定的值，该值为配置zlg600a 是uart 模式时使用的波特率。
表6.23 支持的uart 波特率对应的宏（am_zlg600.h）
由于出厂默认模式为自动侦测模式，因此该值为任一有效的波特率，如定义波特率为115200，则该值为：am_zlg600_baudrate_115200。
缓冲区信息
当选择uart 方式通信时，发送和接收都需要一个保存数据的缓冲区，以提高数据处理的效率和确保接收数据不会因为正在处理事务而丢失。缓冲区的大小由用户根据实际情况指定，建议在64 字节以上，一般设置为128 字节。p_uart_rxbuf 和rxbuf_size 描述了接收缓冲区的首地址和大小，p_uart_txbuf 和txbuf_size 描述了发送缓冲区的首地址和大小。如果设置128 字节的缓冲区供发送和接收使用，其定义如下：
其中，g_zlg600_uart_txbuf[128]为用户自定义的数组空间供发送使用，充当发送缓冲区，其地址（数组名g_zlg600_uart_txbuf 或首元素地址& g_zlg600_uart_txbuf[0]）作为实例信息中p_uart_txbuf 成员的值，数组大小（这里为128）作为实例信息中txbuf_size 成员的值。同理，g_zlg600_uart_rxbuf[128]充当接收缓冲区，其地址作为实例信息中p_uart_rxbuf 成员的值，数组大小作为实例信息中rxbuf_size 成员的值。基于此，实例信息定义如下：
（3）uart 句柄uart_handle
若选择lpc824 的usart1 与zlg600a 通信，则可以通过lpc82x 的usart1 实例初始化函数am_lpc82x_usart1_inst_init()获得uart 句柄。即：
获得的uart 句柄即可直接作为uart_handle 的实参传递。
（4）实例句柄
zlg600a 初始化函数am_zlg600_uart_init()的返回值即为zlg600a 实例的句柄，该句柄将作为其它功能接口的第一个参数（handle）的实参。
其类型am_zlg600_handle_t（am_zlg600.h）定义如下：
若返回值为null，说明初始化失败；若返回值不为null，说明返回一个有效的handle。
基于模块化编程思想，将初始化相关的实例、实例信息等的定义存放到对应的配置文件中，通过头文件引出实例初始化函数接口，源文件和头文件的程序范例分别详见程序清单6.98 和程序清单6.99。
程序清单6.98 zlg600a（串口通信）实例初始化函数实现（am_hwconf_zlg600.c）
程序清单6.99 zlg600a（串口通信）实例初始化函数声明（am_hwconf_zlg600.h）
后续只需要使用无参数的实例初始化函数，即可获取zlg600a 的实例句柄。即：
2． i2c 初始化
使用i2c 通信方式时，其初始化函数原型为：
p_dev 为指向am_zlg600_i2c_dev_t 类型实例的指针；
p_devinfo 为指向am_zlg600_i2c_devinfo_t 类型实例信息的指针。
（1）实例
定义am_zlg600_i2c_dev_t 类型（am_zlg600.h）实例如下：
其中，g_zlg600_i2c_dev 为用户自定义的实例，其地址作为p_dev 的实参传递。
（2）实例信息
实例信息主要描述了zlg600a 使用i2c 通信时的相关信息，包括i2c 缓冲区信息、波特率等信息。其类型am_zlg600_i2c_devinfo_t 的定义（am_zlg600.h）如下：
实例信息主要包含帧格式、zlg600a 模式、7 位i2c 从机地址和中断引脚信息。
frame_fmt 的含义与使用uart 通信方式时一致，对于出厂设置的模块，frame_fmt 的值应设置为：am_zlg600_frame_fmt_old。
now_mode 的含义与使用uart 通信方式时一致，对于出厂设置的模块，now_mode 的值应设置为：am_zlg600_mode_auto_check。在本次初始化完成后，若通过后续接口函数将模式固定为i2c 模式。则系统在下次启动调用zlg600a 初始化函数时，必须确保now_mode 成员的值为更新后的i2c 模式。
slv_addr 为zlg600a 的7 位i2c 从机地址，出厂默认值为0x59，数据手册中描述为0xb2，该值为8 位地址，右移一位，即移除表示读写方向的位后，值即为0x59。在本次初始化完成后，若通过后续接口函数修改i2c 地址。则系统在下次启动调用zlg600a 初始化函数时，必须确保slv_addr 成员的值为更新后的i2c 地址。
int_pin 为zlg600a 的int 引脚与实际微控制器（如lpc824）连接的引脚号。比如，选择lpc824 的pio0_13 与zlg600a 的 int 引脚相连，则该值应设置为pio0_13。
基于此，实例信息定义如下：
（3）i2c 句柄i2c_handle
若选择lpc824 的i2c1 与zlg600a 通信，则通过lpc82x 的i2c1 实例初始化函数am_lpc82x_i2c1_inst_init()获得i2c 句柄。即：
获得的i2c 句柄即可直接作为i2c_handle 的实参传递。
（4）实例句柄
am_zlg600_i2c_init()与am_zlg600_uart_init()的返回值相同，该返回值为zlg600a 实例的句柄，该句柄将作为其它功能接口的第一个参数（handle）的实参。若返回值为null，说明初始化失败；若返回值不为null，说明返回一个有效的handle。
基于模块化编程思想，将初始化相关的实例、实例信息等的定义存放到对应的配置文件中，通过头文件引出实例初始化函数接口，源文件和头文件的程序范例分别详见程序清单6.100 和程序清单6.101。
程序清单6.100 新增zlg600a 的i2c 通信方式的实例初始化函数（am_hwconf_zlg600.c）
程序清单6.101 am_hwconf_zlg600.h 文件内容更新
后续只需要使用无参数的实例初始化函数，即可获取到zlg600a 的实例句柄。即：
>>> 6.4.3 设备控制类接口函数
zlg600a 支持多种ic 卡，比如，mifare s50/s70、iso7816-3、iso14443（picc）、pluscpu 卡等，每种卡都有对应的命令。命令与接口函数基本上是一一对应的关系，zlg600a的命令较多，分为以下5 类：设备控制类命令、mifare s50/s70 卡类命令、iso7816-3 类命令、iso14443（picc）卡类命令和plus cpu 卡类命令。
设备控制类接口函数与具体卡片没有直接关系，主要用于直接操作zlg600a，比如，获取zlg600a 的设备信息和存储ic 卡密钥等，详见表6.24。
表6.24 zlg600a 设备控制类接口函数（am_zlg600.h）
1． 读取设备信息
该函数意在获取zlg600a 的基本信息，包括产品信息和版本信息等，获取的信息为字符串，比如，“zlg600a v1.00”。其函数原型为：
其中，p_info 为获取信息的指针，由于字符串长度为20 字节，因此需要提供一个长度为20 字节的内存空间，以便存放获取到的信息。若返回值为am_ok，说明获取信息成功，反之失败，范例程序详见程序清单6.102。
程序清单6.102 读取zlg600a 设备信息范例程序
假定选择uart 通信方式，即可使用am_zlg600_uart_inst_init()实例初始化函数获取zlg600a 的实例句柄。同时包含标准c 头文件string.h，便于使用strcmp()函数判断字符串是否为“zlg600a v1.00”？
由于这次使用的是zlg600a v1.00 模块，因此获取的信息一定为“zlg600a v1.00”。如果你使用的是其它型号或版本的模块，则要注意将比较信息的字符串修改，否则就算成功读取信息，比较结果也是不相等的。
2． 装载ic 卡密钥
卡片内存储的数据均是加密的，必须验证成功后才能读写数据。验证就是将用户提供的密钥与卡片内部存储的密钥对比，只有相同才认为验证成功。zlg600a 提供了用于存储卡片验证的密钥的e2prom，装载ic 卡密钥的作用就是将密钥存放到指定的e2prom 存储区，其函数原型为：
其中，key_type 为密钥类型，密钥一般分为2 类，其分别为typea 和typeb。其对应的宏详见表6.25。zlg600a 能保存a 类型密钥16组，b 类型密钥16 组。
表6.25 密钥类型（am_zlg600.h）
注：之所以存在两类密钥，是由于实际卡片中往往存在两类密钥，两类密钥可以更加方便地进行权限管理，比如，typea 验证成功后只能读，而typeb 只有验证成功后才能写入，但权限可以自定义设置。
key_sec 为保存的区号，由于zlg600a 能保存a 类密钥16 组和b 类密钥16 组，因此每种类型保存的区域有16 个，其对应区号为0 ~ 15。
p_key 指向了实际待保存密钥的缓冲区，key_length 为密钥的长度，密钥最大长度为16 字节。保存一组6 字节长度的a 类型密钥至区号0 的范例程序详见程序清单6.103。
程序清单6.103 装载密钥范例程序
当后续需要验证卡片时，只需要指定密钥存放的e2prom 区号0，无需再将密钥发送给zlg600a。
>>> 6.4.4 操作接口函数
mifare 卡是一种符合iso14443 标准的a 型卡，其接口函数详见表6.26。
表6.26 mifare s50/s70 接口函数（am_zlg600.h）
经常使用的公交卡、房卡、水卡和饭卡等均是mifare 卡。比如，s50 和s70，它们的区别在于容量的不同。s50 为1kbyte，共16 个扇区，每个扇区4 块，每块16 字节。s70 为4kbyte，共40 个扇区，前32 个扇区每个扇区4 块，每块16 字节，后8 个扇区每个扇区16 块，每块16 字节。
1． 自动检测
设置自动检测回调函数
当有卡片靠近zlg600a 时，将会自动调用用户设定的回调函数，读取卡片的相关信息，因此需要先设置一个回调函数。其函数原型为：
其中，pfn_callback 为指向回调函数的指针，p_arg 为回调函数的参数。若返回am_ok，表示设置成功，反之失败，范例程序详见程序清单6.104。
程序清单6.104 设置自动检测回调函数范例程序
程序中定义了一个detect_flag 变量，表示是否检测到卡片。如果初始值为0，说明未检测到卡片。在设置自动检测回调函数时，将其地址作为回调函数的p_arg 参数。因此在回调函数中，p_arg 实质上是指向detect_flag 的指针，通过该指针将detect_flag 设置为1，表明当前检测到卡片。
启动自动检测
当设置好回调函数后，即可启动自动检测。其函数原型为：
其中，p_info 为指向自动检测相关信息的指针，其类型am_zlg600_auto_detect_info_t 定义如下：
该信息结构体包含检测模式、天线模式、请求模式和密钥验证相关的信息。
检测模式
ad_mode 表示检测模式，用于配置检测相关动作。当检测到卡片时，是否挂起该卡片，若选择挂起，设置ad_mode 的值为am_zlg600_mifare_card_ad_halt（am_zlg600.h），则在检测到一次该卡片后，就将该卡片挂起，后续检测将忽略该卡片。若需再次检测该卡片，必须将卡片远离zlg600a 后重新靠近才有效。若设置ad_mode 的值为0，则不会挂起卡片，每次自动检测均可以检测到靠近的卡片。
举个简单的例子可能更容易理解，在平常刷公交卡时，当卡片靠近刷卡器时，会扣费一次，刷卡成功。若公交卡不离开刷卡器，则不会再次扣费，此时卡片已经被刷卡器挂起了，不会再被识别到。若将公交卡离开刷卡器后再次靠近，将可能再次扣费。
当ad_mode 的值均设置为am_zlg600_mifare_card_ad_halt 时，则可以避免重复检测到同一张卡片。
天线模式
tx_mode 设置天线的工作模式，zlg600a 有2 个天线tx1 和tx2，4 种工作模式：仅使用tx1、仅使用tx2、tx1 和tx2 交替使用、tx1 和tx2 同时使用，各种模式对应的tx_mode 的值宏定义详见表6.27。
表6.27 天线工作模式（am_zlg600.h）
请求模式
req_mode 表示请求模式，即检测所有的卡还是只检测空闲卡，对应的值宏定义详见表6.28，一般来讲只检测空闲卡。
表6.28 请求模式（am_zlg600.h）
密钥验证
由于绝大部分卡片在检测到卡片时，都要先读取一块数据，因此可以将读取数据作为自动检测的一个附加功能。即在检测到卡片时，自动读取1 块（16 字节）数据。由于读取数据前均需要验证，这就需要在启动自动检测时，指定密钥验证相关的信息。
所谓密钥验证就是将用户提供的密钥与卡片内部存储的密钥对比，只有相等方能验证成功。auth_mode 指定了3 种验证模式，其对应的宏表6.29。
表6.29 验证模式（am_zlg600.h）
如果在自动检测到卡片时，不需要读取数据，则应该将auth_mode 的值设置为am_zlg600_mifare_card_auth_no。由于不会用到信息结构体中key_type、key[16]、key_len、nblock 四个成员的值，因此无需设置。
如果需要读取数据，则必须将auth_mode 置为am_zlg600_mifare_card_auth_e2或am_zlg600_mifare_card_auth_direct，其主要区别是验证密钥存放位置不同。
如果使用“直接验证”（am_zlg600_mifare_card_auth_direct）的方式，则信息结构体的key[16]包含了实际的密钥，key_len 表示了密钥的长度。
如果使用“e2 验证”（am_zlg600_mifare_card_auth_e2）方式，则验证密钥存放在zlg600a 的e2prom 中。此时，信息结构体的key[16] 仅使用了首元素key[0]，其值为密钥在e2prom 中的区号（0 ~ 15）。自动检测时，将使用zlg600a 中e2prom 对应区号中的密钥进行验证。key_len 表示密钥的长度。显然，若使用“e2 验证”，则需要确保已经使用am_zlg600_ic_key_load()将密钥存放到了zlg600a 中e2prom 相应的区域。
信息结构体中的nblock 指定了要验证的块，即读取数据的块，只有该块被验证成功后，才能读取数据。mifare s50 和mifare s70 卡片包含的块数目详见表6.30。
表6.30 常见卡片的块数目（am_zlg600.h）
假定无需读取数据，可以定义自动检测信息如下：
定义好相关信息后，可以使用启动函数启动自动检测，即：
读取卡片信息
当启动自动检测后，若前面注册的回调函数被调用，表明检测到卡片，此时可以使用该接口读取卡片的信息。其函数原型为：
其中，p_card_info 为指向卡片信息的指针，用于获取卡片信息。卡片信息的类型am_zlg600_mifare_card_info_t（am_zlg600.h）定义如下：
该信息结构体包含了天线驱动模式、卡片唯一序列号和读取的数据等相关的信息。
天线驱动模式
tx_mode 表示天线的驱动模式，在启动自动检测时，天线的模式有4 种：仅使用tx1、仅使用tx2、tx1 和tx2 交替使用、tx1 和tx2 同时使用。若启动自动检测时使用的模式为tx1 和tx2 交替使用，那么该值将会被设置为实际检测到卡片的天线。tx_mode 可能被设置的值详见表6.31。
表6.31 读取到的天线驱动模式（am_zlg600.h）
当tx1 和tx2 同时使用时，将无法区分具体检测到卡片的天线。
片唯一序列号
每张卡片都具有一个唯一序列号，即uid。所有卡片的uid 都是不相同的。卡的序列号长度有三种：4 字节、7 字节和10 字节。uid_len 表明了读取到的uid 的长度，uid[10]中存放了读取到的uid（字节数）。
读取的数据
在启动自动检测时，指定了读取卡片数据相关的验证信息，若auth_mode 不为am_zlg600_mifare_card_auth_no，且对应的密钥正确，验证成功，将读取启动自动检测时信息结构体的nblock 成员指定的块（由信息结构体的nblock 指定）的数据。读取的数据存放在card_data[16]数组中，读取卡片信息的范例程序详见程序清单6.105。
程序清单6.105 读取卡片信息范例程序
读取卡片信息成功后，将通过调试串口打印出读取到的uid 信息。并翻转led1 灯的状态，指示读取一次卡片信息成功。
2． 卡片验证
由于卡片内存储的数据是加密的，因此必须验证成功后才能读写数据。验证方式有“e2验证”和“直接验证”，它们的区别是用于验证的密钥存放的位置不同。
e2 验证
用于验证的密钥是存放在zlg600a 的e2prom 中，其函数原型为：
其中，key_type 的类型是密钥类型，它的值为am_zlg600_ic_key_type_a 或am_zlg600_ic_key_type_b，分别代表a 类型密钥和b 类型密钥。
p_uid 为指向uid 高4 字节缓冲区的指针，若uid 为4 字节，其值为获取的uid 的首元素地址，即&card_info.uid[0]；若uid 为7 字节，其值为获取的uid 的第3 号元素的地址，即&card_info.uid[3]；若uid 为10 字节，其值为获取的uid 的第6 号元素的地址，即&card_info.uid[6]。key_sec 为密钥存放在zlg600a 的e2prom 中的区号，该值应该与使用am_zlg600_ic_key_load()函数存储对应密钥时使用的区号一致。
nblock 指定本次验证的块号，返回值为am_ok 时表明验证成功，反之失败，使用区号0 中的a 类密钥验证块1 的范例程序详见程序清单6.106。
程序清单6.106 e2 验证范例程序
自动检测获取卡片信息card_info 详见程序清单6.101，调用am_zlg600_ic_key_load()将密钥存放在在0 区的e2prom 中的程序详见程序清单6.103。
实际上绝大部分卡都是4 字节的，而7 或10 字节的uid 卡极少。如果确定使用的卡片uid 为4 字节，则p_uid 的值为&card_info.uid[0]。
直接验证
用于验证的密钥是由接口函数提供，其函数原型为：
其中，key_type、p_uid、nblock 的含义与“e2 验证”相同，由于需要直接提供密钥，因此使用p_key 指向密钥存放的缓冲区，key_len 表示密钥的长度。返回值为am_ok，表明验证成功，反之失败，直接使用6 字节密钥进行验证的范例程序详见程序清单6.107。
程序清单6.107 直接验证范例程序
程序使用6 字节全0xff 作为密钥验证块1，之所以这样，是因为mifare s50/s70 卡片的密钥出厂默认为全0xff，且密钥长度为6 字节。对于出厂默认设置，使用a 类密钥和b类密钥验证均可。对于一些有权限控制的卡片，如验证a 类密钥后仅只读，验证b 类密钥后可写，则需要根据实际情况进行验证，密钥和权限控制的修改后面会进一步介绍。
3． 读写数据
若验证成功，则开始读写已验证的块。读写数据都是以块为单位的，其大小为16 字节。
读取数据
读取数据就是读取某一块的数据，其函数原型为：
其中，nblock 指定读取的块号，p_buf 为指向存放数据的缓冲区，缓冲区大小为16 字节。返回值为am_ok 时，表明读取数据成功，反之失败。如程序清单6.108 所示为读取块1 数据的范例程序。
程序清单6.108 读取数据范例程序
写入一块数据
写入数据就是将数据写入到某一块，其函数原型为：
其中，nblock 指定写入的块号，p_buf 为指向写入数据的缓冲区，缓冲区大小为16 字节。返回值为am_ok 时，说明写入数据成功，反之失败。如程序清单6.109 所示为写入16 字节数据至块1 的范例程序。
程序清单6.109 写入数据范例程序
如程序清单6.110 所示是展示卡片自动检测、验证和读写数据的综合测试范例程序。
程序清单6.110 zlg600 综合测试范例程序
程序每检测到一次卡片（detect_flag 的值为1），将读取一次信息，然后使用调试串口打印uid 的值，接着进行读写检测。若读写检测失败，表明验证失败，很可能密钥不是初始密钥，已经被修改过了。
由于读取uid 并不需要验证，因此，当测试程序运行时，将常见的公交卡、门禁卡、饭卡等卡靠近zlg600a，均可以读取卡片的uid。由于这些卡片的密钥并不知晓，因此读写数据测试很可能会失败。
>>> 6.4.5 密钥和权限控制
mifare s50/s70 卡的初始密钥全为0xff，显然，对于实际产品来讲，希望能够更改其密钥为其它值。由于存在密钥a和密钥b，可以对每个密钥设定不一样的权限，如验证密钥a后仅只读，验证密钥b 后可写。下面以mifare s50 为例，介绍密钥和权限控制的修改方法。
密钥和权限控制是针对扇区而言的，即一个扇区的密钥是相同的，不同扇区的密钥可以不同。s50 共计16 个扇区，每个扇区4 块，每块16 字节，前3块为普通的数据块，最后一块（尾块）为密钥和权限控制块。对最后一块存储的数据进行修改，即可完成密钥和权限控制的修改。操作最后一块的存储数据时要格外小心，数据稍有错误，就可能导致扇区被锁死。尾块的前6 字节为a 密钥，后6字节为b 密钥，中间4 字节用于权限控制，详见图6.11。
图6.11 尾块格式
如需修改密钥和控制权限，重点在理解字节6、7 和8（字节9 是一个普通的数据）的含义。3 个字节共计24 位，每6 位（分别为c1、c2、c3、
由于存在此关系，因此实际控制位的含义仅通过c1、c2、c3 三个位即可确定。控制尾块和数据块的控制位含义是不同的。对于尾块，其控制了密钥a、密钥b 以及控制区域的访问权限。控制位的含义详见表6.32。
表6.32 尾块控制位含义
表中，“×”表示任何情况下都无权限，“keya”表示通过密钥a 验证后可以取得权限，keyb 表示通过密钥b 验证后可以取得权限，“keya | b”表示通过密钥a 或者密钥b 验证后均可取得权限。由此可见，密钥a 的安全性很高，任何情况下都无法读出。特殊情况下，当c1c2c3 的值为000、010 或001 时，验证密钥a 后即可读取密钥b 区域的数据。
无论什么情况，验证密钥a 后，均可获得控制区域的读权限。通过读取控制区域，可以知道当前c1、c2、c3 的值，以判断需要验证哪个密钥后可以获得密钥区域或控制区域的写权限，进而修改密钥和控制区域的值。比如，当前的c1、c2、c3 的值为0、1、1，为了修改密钥a，则需要先验证密钥b，验证密钥b 后，即可对尾块进行写入，写入时其它数据保持不变，仅修改前6 字节（keya 区域）的值即可完全对密钥a 的修改。
对于数据块，c1、c2、c3 控制了对块中存储数据的操作权限，详见表6.33。
表6.33 数据块控制位含义
同样，表中“×”表示任何情况下都无权限，“keya”表示通过密钥a 验证后可以取得权限，keyb 表示通过密钥b 验证后可以取得权限，“keya | b”表示通过密钥a 或者密钥b 验证后均可取得权限。
加值操作（相当于充值）和减值操作（相当于消费）是对块中存放的值进行增加和减少操作，加值和减值均有对应的命令可以直接使用。例如，当前块1 的c1、c2、c3 控制位的值为0、0、0（默认值），只要密钥a 或密钥b 验证通过后，均可取得数据块的读、写、加值、减值的权限。可以根据实际需要，修改尾块中相应控制位的值（修改时，需确保具有写入控制区域的权限），以对数据进行保护。
需要注意的是，凡是表中标识验证密钥b 后可以取得权限的，在特殊情况下验证密钥b后可能并不能取得权限。在介绍尾块控制位含义时，当c1、c2、c3 的值为000、010 或001时，keyb 区域将可能被读取，详见表6.32。这些情况下，由于密钥b 可能被读取，为了确保安全，此时密钥b 验证将无效，即使密钥b 验证通过，同样无法取得相应的权限。
荣耀v9怎么样?荣耀v9颜值、性能、续航、拍照深度评测:值得购买的一部手机
单片机利用软件抗干扰的滤波方法有哪些详细说明
深度剖析光电子技术和产业现状
中国铁塔2019年取得的各项工作成绩总结
讨论IIR滤波器的应用场合及数字数据类型对滤波的影响
读写卡模块的外设驱动代码编写技巧
突破性的InnoSwitch系列IC的出货量已超过10亿颗
各种传感器工作原理汇总图
Intel 12代酷睿Alder Lake处理器谍照曝光
Tim Cook亲自测试 下一代Apple Watch或将支持一个神秘新功能！
受到COVID-19严重影响的国家将如何正确恢复呢？
FPGA的结构特点与开发
无线射频识别软件和中间件系统简介
苹果确认部分iPhone13存在bug_苹果十三还继续香吗
如何正确安装无线振动传感器
Pixel 4将搭载更新率更高的屏幕让触控更加流畅
数字可调谐滤波器如何实现宽带接收器应用
雅观科技与海康威视共同打造空间智能化生态圈
差压式液位计的结构及工作原理 差压式液位计的种类及应用
微生物检测仪器的特性及参数