STM32F103C8T6驱动CLRC663实现多协议NFC读卡器开发实战-北京尧图网络

STM32F103C8T6和CLRC663这对组合做NFC开发的人多少都听过。去年我接手一个门禁项目要求一张读卡器能同时兼容小区门禁卡、校园一卡通、图书标签还有手机NFC模拟卡翻遍方案最后选了CLRC663这颗芯片。用下来最大的感慨就是芯片能力是真的强但坑也真的不少——尤其是国产模块的接线和时序问题能让新手白折腾好几天。这篇文章把我从硬件选型、接线、驱动移植到最终调通的完整过程写出来包括我踩过的坑和排查思路希望帮你少走弯路。1. 项目概览与硬件选型思路1.1 CLRC663是什么为什么选它CLRC663是NXP推出的一款高性能多协议NFC前端芯片。注意它和RC522这类芯片不一样RC522只支持ISO14443A也就是常见的M1卡S50/S70和NTAG系列。而CLRC663属于NXP NFC前端芯片里的中高端型号完整支持四大协议ISO/IEC 14443A这也是我们常说的Mifare Classic卡如S50、ISO/IEC 14443B很多身份证、银行卡使用、ISO/IEC 15693图书管理、资产盘点常用的长距离卡、以及ISO/IEC 18092也就是NFC Forum定义的NFC-A/B。我当初选它最核心的两个原因是第一一张读卡器要兼容门禁卡14443A、部分校园卡14443B、图书标签15693只有CLRC663能同时搞定这三种第二CLRC663的发射功率可调天线驱动能力比RC522强不少配合适当的天线设计15693卡片的读取距离能做到10厘米以上而RC522一般就是3到5厘米。这对实际项目来说差别很大。再说国产模块这个概念。市面上卖CLRC663模块的国产方案商很多做的模块大小、天线形状、外围电路都不一样。有些是直接照抄NXP的评估板设计有些是精简版。选的时候要重点关注模块是否引出了完整的SPI/I2C/UART接口以及天线是否已经配套调试好。我用的这款模块是SPI接口、板载天线尺寸3cm乘以3cm左右供电3.3V整体很紧凑。1.2 核心应用场景谁能从这篇文章里受益如果你手头正在做这几类项目这篇文章会比较对路门禁考勤一体机需要兼容多种卡型不想给每个卡型单独配读卡器图书档案管理系统要用15693协议做远距离盘点工业产线数据采集需要用到14443B协议卡片电子锁、共享设备、智能硬件需要一个功耗和体积都可控的NFC读写方案。当然如果你是刚接触NFC的初学者这篇文章也不会太吃力。我会把CLRC663的寄存器操作方式、SPI通信细节、和卡片交互的底层流程都讲清楚你不需要先去啃几百页的数据手册。2. 硬件连接与最小系统搭建2.1 STM32F103C8T6与CLRC663接线原理STM32F103C8T6这款芯片堪称入门级ARM的常青树72MHz主频、64KB Flash、20KB RAM跑一个NFC协议栈绰绰有余。它的SPI外设支持最高18MHz的时钟而CLRC663在SPI模式下最高可以跑到10MHz左右具体看模块设计所以两者搭配速度上完全没有瓶颈。接线方式我直接把关键引脚对应关系列出来STM32F103C8T6引脚CLRC663模块引脚说明PA5 (SPI1_SCK)SCKSPI时钟PA6 (SPI1_MISO)MISO主收从发PA7 (SPI1_MOSI)MOSI主发从收PA4 (SPI1_NSS)NSS片选低电平有效PB0RST模块复位低电平复位PB1IRQ中断请求可选用3.3VVCC供电GNDGND共地注意CLRC663的工作电压范围是2.5V到5.5V但国产模块一般板载了稳压和电平转换电路直接用STM32的3.3V供电就可以。千万不要一上来就接5V有的模块没有做5V兼容会烧芯片。关于IRQ引脚很多例程里不接也能跑用轮询方式读寄存器。但我在实际项目里强烈建议接上。CLRC663的很多操作耗时好几个毫秒比如防碰撞和选卡用中断方式可以让CPU去做别的事等中断来了再处理缓冲区数据效率高很多而且逻辑也更清晰。2.2 SPI通信的细节设置CLRC663的SPI模式有两种一种是标准SPI4线另一种是带DLNADynamic Load Modulation的增强模式。我们平时用标准模式就够了。初始化SPI时有几个关键参数要匹配不匹配的话读出来的寄存器值全是0xFF或者0x00典型的不通信号工作模式主机模式时钟极性CPOL0即空闲时SCK为低电平时钟相位CPHA0即第一个边沿采样数据数据帧格式MSB先行速率建议先设1MHz左右等调试稳定后再往上提。这里有个容易踩的坑CLRC663的SPI时序要求比较严格如果CPOL/CPHA设置不对芯片可能完全无响应。我调试时习惯先用逻辑分析仪抓SCK、MOSI、MISO三根线确认数据格式和芯片手册一致再谈后续。还有一点NSS片选信号必须在每次传输片选字节和数据字节前拉低、传输完成后拉高。CLRC663的SPI是地址数据成对的传输方式不像普通Flash那样可以连续读。2.3 天线设计与匹配的避坑心得CLRC663模块的天线匹配其实是整个项目里最容易被忽略、最终影响却最大的部分。模块出厂时天线已经调好能直接工作但如果你自己画板子外接天线就要注意了。NFC天线本质是一个LC谐振回路谐振频率要落在13.56MHz。CLRC663通过TX1和TX2引脚输出射频信号经过匹配电路送到天线。匹配电路的电容电感值不是随便选的需要根据天线线圈的感抗来计算。一般流程是先用矢量网络分析仪测天线线圈的电感量再用公式算出并联谐振电容。对于场景要求不高的项目我有个土办法推荐先用模块自带的板载天线跑通软件再考虑外接天线。只要代码逻辑没问题后面的天线优化只是锦上添花。如果读卡距离太近小于2cm先别急着改代码检查天线匹配电容是不是焊错了。3. 软件框架与驱动移植3.1 CLRC663的寄存器体系速览CLRC663的寄存器数量非常多数据手册里列出了上百个寄存器。刚接触时不需要全记住但有几个关键的必须掌握Command寄存器地址0x00写命令码触发操作比如0x06是软复位0x04是发送数据0x02是读接收缓冲区等FIFOData寄存器地址0x01读写FIFO数据缓冲区FIFOLength寄存器地址0x02当前FIFO里有多少数据IRQ0和IRQ1寄存器地址0x04和0x05中断标志比如接收完成、错误等读取后要写1清除Control寄存器地址0x06控制发射器开关、FIFO清空等RxStatus寄存器地址0x13接收状态。CLRC663的寄存器读写规则是最高位表示方向1读0写低7位是寄存器地址。在SPI模式下要先发一个地址字节再发数据字节写或读数据字节读。3.2 底层SPI驱动编写我把SPI底层的核心代码片段贴出来配合注释说明// SPI1 初始化 void CLRC663_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; // 使能时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // 配置SCK、MOSI、MISO为复用推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); // 配置NSS片选引脚为推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); // 片选默认拉高 // 配置RST引脚为推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); // SPI1 配置 SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_32; // 72MHz/322.25MHz SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }底层读写函数核心是对NSS引脚的时序控制uint8_t CLRC663_ReadReg(uint8_t reg) { uint8_t addr reg; uint8_t val 0; CLRC663_NSS_LOW(); CLRC663_SPI_SendByte(addr); // 最高位默认为0表示写方向但我们先发地址 val CLRC663_SPI_ReceiveByte(); CLRC663_NSS_HIGH(); return val; } uint8_t CLRC663_WriteReg(uint8_t reg, uint8_t val) { uint8_t addr reg; CLRC663_NSS_LOW(); CLRC663_SPI_SendByte(addr); // 发送地址 CLRC663_SPI_SendByte(val); // 发送数据 CLRC663_NSS_HIGH(); return 0; }这里要特别注意一个细节CLRC663的SPI读操作其实有两种方式。第一种就是上面写的发送地址后直接读一个字节但如果你要连续读多个寄存器不需要每次重新拉低NSS可以在一次片选有效期内连续发送地址读取数据。写操作同理一次片选内可以连续写多个寄存器常用于初始化时批量配置。3.3 芯片初始化流程软复位与配置初始化CLRC663的第一步必须是软复位。我一开始跳过软复位直接配置寄存器结果怎么调都读不到卡片后来才意识到问题。软复位是通过Command寄存器写入0x06芯片会执行内部复位之后需要等待一段时间让芯片稳定。然后要执行一个初始化和配置的过程主要设置以下几个关键点关闭CRC或设置合适的CRC预设值等后面的协议操作再开启配置发射器设置TX的驱动电流和调制深度清空FIFO确保无残留数据使能相应的中断比如接收完成中断、错误中断等。void CLRC663_Init(void) { // 硬复位一下确保从干净的状态开始 CLRC663_RST_HIGH(); Delay_ms(10); CLRC663_RST_LOW(); Delay_ms(10); CLRC663_RST_HIGH(); Delay_ms(10); // 软复位 CLRC663_WriteReg(0x00, 0x06); Delay_ms(10); // 检查芯片是否响应 uint8_t version CLRC663_ReadReg(0x7F); // 版本寄存器 // 不同批次芯片返回值不一样常见有0x03、0x04等 }记得读一下版本寄存器能读出值就说明SPI基本通了。如果读出0xFF或0x00优先检查接线、供电和SPI配置不要急着往下走。4. 核心功能实现与代码实战4.1 三协议支持卡片搜索与防碰撞实现NFC读写最核心就是寻卡→防碰撞→选卡→读写这四步。CLRC663的优势在于它把这些逻辑封装成了命令不需要自己逐位处理曼彻斯特编码。以ISO14443A为例最常用的寻卡命令是REQA发送0x26给卡片卡片返回ATQA。然后是防碰撞发送0x93 0x20卡片返回4字节UID。最后是选卡发送0x93 0x70加UID和校验位选卡成功后卡片返回SAK。在CLRC663上执行这些命令的方式是固定的先把要发送的数据写入FIFO然后写Command寄存器触发发送命令接着等中断或轮询标志位再从FIFO读出响应数据。// 发送14443A寻卡命令 REQA返回ATQA高低字节 uint8_t ISO14443A_REQA(uint8_t *atqa) { CLRC663_WriteReg(0x01, 0x26); // 写FIFO数据发送0x26 CLRC663_WriteReg(0x00, 0x04); // Command寄存器写入0x04 Transmit命令 // 等待发送完成这里用简单延时代替中断 Delay_ms(1); // 发送完成后需要切换到接收模式再发送0x26再次请求 // 实际代码中通常使用Transceive命令 }这里我写的是一个简化版实际项目中更推荐用CLRC663的Transceive命令0x16它结合了发送和接收芯片发完数据后自动切换到接收模式。很多国产厂商SDK提供的API底层都是基于Transceive命令的uint8_t CLRC663_Transceive(const uint8_t *sendData, uint8_t sendLen, uint8_t *recvData, uint8_t *recvLen) { // 清空FIFO CLRC663_WriteReg(0x06, 0x01); // Control寄存器清空FIFO // 写入发送数据 for (uint8_t i 0; i sendLen; i) { CLRC663_WriteReg(0x01, sendData[i]); } // 执行Transceive命令 CLRC663_WriteReg(0x00, 0x16); // 等待中断或轮询检查FIFO长度 while (!(CLRC663_ReadReg(0x04) 0x08)); // IRQ0的RxDone位 // 读取接收数据长度 *recvLen CLRC663_ReadReg(0x02); // FIFOLength for (uint8_t i 0; i *recvLen; i) { recvData[i] CLRC663_ReadReg(0x01); } return 0; }4.2 实战读取ISO15693卡片的UID15693协议在CLRC663上的实现和14443A有些不同。最明显的区别是15693的卡片速度慢一些但通信距离更远。读取15693 UID的指令是Inventory盘点命令格式为0x01Flag 0x01Inventory命令码。CLRC663针对15693也有专门的收发流程。// 发送15693 Inventory命令读取UID uint8_t ISO15693_Inventory(uint8_t *uid) { uint8_t sendData[2] {0x01, 0x01}; uint8_t recvData[16]; uint8_t recvLen 0; // 清FIFO和CRC CLRC663_WriteReg(0x06, 0x01); // 开启CRC15693使用CRC16 CLRC663_WriteReg(0x0E, 0x01); // 设置CRC寄存器 CLRC663_Transceive(sendData, 2, recvData, recvLen); // 返回数据格式第一个字节是Flags后面是UID if (recvLen 9) { for (uint8_t i 0; i 8; i) { uid[i] recvData[i 1]; } return 0; } return 1; }15693的一个特点是卡片响应数据比较长读取时FIFO要设置足够的空间。CLRC663的FIFO有256字节正常情况下完全够用。4.3 ISO14443B卡片的操作要点14443B和14443A在物理层就有区别。B类卡使用NRZ编码卡片响应时初始的SOF帧起始格式也不同。CLRC663处理这些底层差异上层代码只需要发送命令字节即可。读写14443B卡片的典型流程发送REQB命令0x05等待卡片的ATQB响应发送ATTRIB命令进行选卡之后就可以进行具体的PICC层操作。这里有个容易出错的地方14443B的卡片时序相对宽松但有的卡对帧格式要求很高。如果发REQB后无响应可以检查一下CLRC663的RxThreshold接收阈值设置有时候默认阈值太高会把弱信号给滤掉。5. 调试经验与问题排查5.1 从头到尾过一遍最常见的6个问题我调试这个模块时把遇到过的典型问题整理成了表格方便你对照排查现象可能原因排查方法读版本寄存器读到0xFFSPI接线错误、CPOL/CPHA不对、NSS时序不对先用万用表测引脚通断再用逻辑分析仪抓波形读版本寄存器读到0x00芯片没上电、RST一直拉低测VCC和GND确认RST引脚电平发送命令后无响应天线没匹配好、发送接收没有正确切换检查天线匹配电容确认执行了Transceive而非纯发送读卡距离特别近1cm天线谐振点偏移、发射功率设置过低调整天线电容提高TXDAC值发射功率寄存器15693卡能读到A类卡读不到天线带宽问题检查天线Q值Q值太高会导致带宽过窄读卡不稳定时好时坏电源纹波大、天线附近有金属干扰增加电源滤波电容远离金属物体测试5.2 我的独家避坑技巧第一点关于电源CLRC663发射瞬间电流会突然升高STM32板子的LDO如果太弱电压会被拉低导致死机。我试过用USB供电的STM32最小系统板直接驱动读卡时偶尔复位。后来换了单独的3.3V稳压模块供电问题就消失了。建议在CLRC663模块的VCC和GND之间加一个100uF的电解电容和一个104的陶瓷电容。第二点关于调试工具用逻辑分析仪看SPI波形非常重要。CLRC663的数据手册里有时序图对比波形能迅速定位是时钟极性问题、片选时序问题、还是数据位顺序问题。没有逻辑分析仪的话在软件里逐步打印寄存器的值也行但效率低很多。第三点关于天线附近的金属CLRC663的射频场对周围环境很敏感。我在测试时发现把模块放在金属桌面和放在塑料盒子上读卡距离差了将近一半。在实际产品设计中天线下方要尽量避免铺铜或者预留足够净空。如果产品必须用金属外壳建议使用铁氧体隔磁片贴在天线背面能有效减少金属涡流损耗。5.3 从能用到好用性能优化建议当你把读卡功能跑通之后想让模块在真实场景里更可靠可以从下面几个方向调优第一个是发射功率调整。CLRC663的发射功率通过TXDAC寄存器调节。默认值一般不是最大功率。如果需要更远的读卡距离可以逐级增大TXDAC值但要配合监测电流功率太大会导致模块过热反而影响稳定性。功耗敏感的产品建议从较小的值开始调试。第二个是接收灵敏度的取舍。CLRC663的RxThreshold寄存器可以调整接收灵敏度。灵敏度调高能读得更远但也更容易被环境电磁干扰误触发。在工业环境里我建议把灵敏度调低一点优先保证稳定性。第三个是天线带宽的平衡。对于需要兼容14443A和15693的应用天线的带宽要照顾到两种协议的载波频率偏差。15693卡片的回波信号频率偏移比14443A大如果天线Q值太高对15693的响应会衰减很厉害。这也是为什么有些模块单独读A类卡很好一读15693就不行的原因。如果你的模块遇到这个情况可以适当降低天线Q值比如增大阻尼电阻牺牲一点点A类卡的读距换回15693的兼容性。6. 项目扩展思路6.1 从读卡到写卡M1卡和NTAG的读写实现读卡只是NFC应用的第一步。实际项目里经常要写卡比如发卡器充值、门禁卡授权。CLRC663对M1卡的读写支持很完善ISO14443A的Mifare Classic协议即传统的M1 S50卡在CLRC663上执行流程为寻卡后选卡然后进行三次认证Mifare Authentication认证成功后可以对块数据进行读或写操作。M1卡的块大小为16字节S50卡共有16个扇区每个扇区4个块。写卡操作需要注意块0是厂商数据区包含UID一般不能改写每个扇区的第4个块是控制块存放KeyA、AccessBits和KeyB如果不小心改错了这张卡可能就废了。6.2 接入RTOSFreeRTOS下的NFC任务设计如果你的项目里不止NFC读写这一个功能还有屏幕显示、按键扫描、网络通信等那肯定要上RTOS。STM32F103C8T6跑FreeRTOS是绰绰有余的20KB RAM够跑几个常规任务。我在FreeRTOS里的典型任务划分是NFC读卡任务优先级中等、UI任务优先较低、通信任务若上云则优先级较高。NFC任务通过队列向其他任务发送读到的卡号而不是直接调UI刷新函数这样能避免任务间的资源竞争。需要注意的一点CLRC663的SPI操作不是线程安全的。如果多个任务都尝试操作CLRC663必须用互斥锁Mutex保护。否则两个任务同时读写FIFO轻则读到错误数据重则芯片状态错乱必须重新初始化。6.3 结合手机NFC模拟卡和双向交互CLRC663虽然本身不能像PN532那样直接做卡模拟即它不能作为一张NFC卡被动被手机读取但你可以利用手机的NFC功能来测试你的CLRC663读卡器。一个很实用的调试技巧把手机的NFC读卡功能打开用手机里的NFC工具类App很多专门用于检测NFC卡片的工具软件去读你的CLRC663模块发射的射频场手机App通常能识别出射频场的协议类型这样你就不需要实体卡片也可以验证模块是否在工作。反过来如果你的产品需要手机App和CLRC663的读卡器交互比如App充值可以让CLRC663把数据写入一张NTAG卡手机读取NTAG卡完成交互。CLRC663本身不能模拟成卡但搭配NTAG标签纸就能组合出一套实用的数据交互方案。7. 最后的个人体会这套方案我前后折腾了小两周最深的感受是CLRC663这个芯片的功能上限很高国产模块的硬件质量也在线但真正决定项目成败的往往是那些不起眼的细节——SPI时序对不对、天线匹配好不好、电源稳不稳、周围有没有金属。把这几个基础打牢后面的协议操作反而是水到渠成的事。如果你是从RC522转过来的第一次跑CLRC663时不要太惊讶于寄存器数量的陡增。RC522只有几十个寄存器而CLRC663的寄存器上百个但只要理解了它的核心工作流命令寄存器FIFO中断标志驾驭起来并不难。实际操作中先跑通初始化读到版本号再跑通寻卡最后再处理具体的卡片读写一步一步来稳扎稳打任何卡都能拿下。

STM32F103C8T6驱动CLRC663实现多协议NFC读卡器开发实战

相关推荐

90DaysOfDevOps 第 31 天：深入理解 Microsoft Azure 计算模型（虚拟机、VMSS、容器与 Serverless）

基于非合作博弈的双层鲸鱼算法求解居民负荷分层调度模型

基于MATLAB的ASK/FSK/PSK数字调制解调系统仿真与误码率分析

更多资讯

2026年10月4日充电桩行业日报：充电量暴涨60%却还排队3小时，下半场拼的不是桩，是调度 | 慧知开源充电桩平台

WorkBuddy Skill 实战：从创建到优化，把高频任务固化成 AI 能力包

WorkBuddy的Skill玩法：查找、安装、创建与优化全解析

WorkBuddy Skill机制详解：从提示词复用迈向AI工作流标准化

Nginx应用与运维——Nginx监控配置及管理（一）

雷达辐射源识别从数据到模型：完整落地管线与避坑指南

今日更新

插件加载失败深度解析：从did not activate到生命周期排查指南

SpringBoot+Vue+MyBatis企业级房屋租赁管理系统源码解析

企业核心数据灾备自动化：用 OpenClaw 备份到本地 + 云端 + 离线存储的 TaoToken 统一通道实践

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？