保姆级教程：基于STM32与FM17520芯片，从零搭建一个NFC门禁读卡器（附完整代码）

基于STM32与FM17520的NFC门禁读卡器全流程开发指南

在智能门禁系统领域，NFC技术因其安全性和便捷性已成为主流选择。本文将带您从零开始构建一个完整的NFC门禁读卡器原型，基于STM32微控制器与FM17520非接触式读写芯片，涵盖硬件设计、驱动开发、协议实现到应用逻辑的全过程。不同于简单的功能演示，我们更注重工程实践中的模块化设计和代码可移植性，让您获得可直接用于实际项目的解决方案。

1. 硬件架构设计与元器件选型

1.1 核心器件功能解析

FM17520作为国产高性能NFC读写芯片，支持ISO14443 Type A协议，与STM32通过SPI接口通信。其典型工作参数如下：

硬件设计时需特别注意电源管理部分：

// 典型电源连接方案 PVDD -> 3.3V // 必须与STM32电平匹配 DVDD -> 3.3V AVDD -> 3.3V TVDD -> 3.3V

1.2 天线设计要点

天线性能直接影响读卡距离和稳定性，建议：

• 使用线径0.5mm的漆包线绕制4圈方形天线
• 天线尺寸约50mm×50mm
• 匹配电路采用50Ω传输线设计
• 预留可调电容位置(典型值10-30pF)

提示：天线端子焊接方向错误会导致无法寻卡，这是常见硬件问题

2. STM32底层驱动实现

2.1 SPI接口配置

使用STM32CubeMX生成初始化代码时，需注意以下关键参数：

hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_32; hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB;

2.2 寄存器读写函数封装

FM17520采用地址映射寄存器控制，需实现基础读写操作：

uint8_t FM17520_ReadReg(uint8_t addr) { uint8_t tx_data[2] = {addr | 0x80, 0x00}; uint8_t rx_data[2]; HAL_GPIO_WritePin(FM17520_CS_GPIO_Port, FM17520_CS_Pin, GPIO_PIN_RESET); HAL_SPI_TransmitReceive(&hspi1, tx_data, rx_data, 2, 100); HAL_GPIO_WritePin(FM17520_CS_GPIO_Port, FM17520_CS_Pin, GPIO_PIN_SET); return rx_data[1]; } void FM17520_WriteReg(uint8_t addr, uint8_t value) { uint8_t tx_data[2] = {addr & 0x7F, value}; HAL_GPIO_WritePin(FM17520_CS_GPIO_Port, FM17520_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, tx_data, 2, 100); HAL_GPIO_WritePin(FM17520_CS_GPIO_Port, FM17520_CS_Pin, GPIO_PIN_SET); }

3. FM17520功能模块开发

3.1 芯片初始化流程

完整的初始化序列应包括：

1. 复位芯片（硬件或软件复位）
2. 配置Timer寄存器设置超时参数
3. 设置RF通信参数（波特率、调制深度等）
4. 开启射频场并校准天线
5. 配置IRQ中断触发条件

典型初始化代码结构：

void FM17520_Init(void) { // 1. 硬件复位 HAL_GPIO_WritePin(FM17520_RST_GPIO_Port, FM17520_RST_Pin, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(FM17520_RST_GPIO_Port, FM17520_RST_Pin, GPIO_PIN_SET); HAL_Delay(50); // 2. 配置基础寄存器 FM17520_WriteReg(0x00, 0x8F); // CommandReg FM17520_WriteReg(0x01, 0x00); // ModeReg FM17520_WriteReg(0x02, 0x80); // TxControlReg // 3. RF参数设置 FM17520_WriteReg(0x11, 0x40); // RxSelReg FM17520_WriteReg(0x13, 0x3F); // TimerReloadReg // 4. 开启射频场 FM17520_WriteReg(0x00, 0x8D); }

3.2 卡片检测与UID读取

实现MIFARE卡片检测的核心流程：

typedef struct { uint8_t uid[10]; uint8_t uidLen; uint8_t sak; } NFC_CardInfo; uint8_t FM17520_DetectCard(NFC_CardInfo *card) { uint8_t status = FM17520_ReadReg(0x05); // ComIrqReg if(status & 0x20) { // 检测到卡片 FM17520_WriteReg(0x00, 0x26); // 发送REQA命令 uint8_t atqa[2]; FM17520_ReadFIFO(atqa, 2); if(atqa[0] != 0x00 || atqa[1] != 0x04) return 0; // 非TypeA卡片 FM17520_WriteReg(0x00, 0x93); // 发送ANTICOLLISION命令 uint8_t uid[10]; FM17520_ReadFIFO(uid, 10); card->uidLen = uid[0] == 0x88 ? 10 : 7; memcpy(card->uid, uid, card->uidLen); return 1; } return 0; }

4. 门禁系统应用层实现

4.1 卡片验证逻辑设计

典型门禁系统采用UID白名单验证机制：

#define MAX_CARDS 20 const uint8_t authorizedCards[MAX_CARDS][4] = { {0x12, 0x34, 0x56, 0x78}, {0x9A, 0xBC, 0xDE, 0xF0}, // ...其他授权卡片UID }; uint8_t isCardAuthorized(uint8_t *uid) { for(int i=0; i<MAX_CARDS; i++) { if(memcmp(uid, authorizedCards[i], 4) == 0) { return 1; } } return 0; }

4.2 完整工作流程整合

主程序应实现状态机控制：

void main(void) { HAL_Init(); SystemClock_Config(); MX_SPI1_Init(); FM17520_Init(); while(1) { NFC_CardInfo card; if(FM17520_DetectCard(&card)) { if(isCardAuthorized(card.uid)) { unlockDoor(); // 驱动门锁继电器 logAccess(card.uid); // 记录访问日志 } else { soundAlarm(); // 触发未授权警报 } HAL_Delay(1000); // 防重复检测 } HAL_Delay(100); } }

5. 调试技巧与性能优化

5.1 常见问题排查指南

开发过程中可能遇到的典型问题及解决方案：

5.2 低功耗模式实现

FM17520支持三种节能模式：

1. Soft Power Down：保持寄存器状态，关闭射频

   FM17520_WriteReg(0x00, 0x80); // CommandReg FM17520_WriteReg(0x01, 0x10); // ModeReg

2. Hard Power Down：完全断电，需重新初始化
3. Deep Power Down：最低功耗模式，电流<1μA

实际项目中，可根据门禁使用频率选择不同模式。例如夜间可切换至Soft Power Down，定期唤醒检测卡片。