树莓派Pico MicroPython驱动RC522 RFID读卡器无打印输出问题

硬件连接逐点核对（SPI0通道） #

所有接线必须和驱动代码里传入的引脚参数严格对应，接错任意一个引脚都会导致完全无响应：

• MFRC522片选（SDA/CS）：接Pico SPI0对应的片选GPIO，引脚号必须和驱动初始化时传入的cs参数完全一致
• MFRC522时钟（SCK）：接Pico SPI0的SCK固定引脚（GP2）
• MFRC522主机输出从机输入（MOSI）：接Pico SPI0的MOSI固定引脚（GP3）
• MFRC522主机输入从机输出（MISO）：接Pico SPI0的MISO固定引脚（GP4）
• MFRC522硬件复位（RST）：接Pico任意空闲GPIO，引脚号必须和驱动初始化时传入的rst参数完全一致
• MFRC522 IRQ引脚：悬空不接，大部分MicroPython驱动不依赖该引脚，误接会拉低总线导致通信失败
• MFRC522供电：仅接Pico的3.3V输出，绝对禁止接5V电源，否则会损坏读卡器或Pico
• 共地连接：MFRC522的GND必须和Pico的GND直接连通，无共地会导致SPI通信电平不匹配，完全无法握手

SPI通信参数校验 #

• 速率设置：MFRC522不支持高速SPI通信，Pico初始化SPI0时波特率必须设置在1MHz~2MHz区间，不要直接使用MicroPython默认的10MHz高速配置，高速SPI会导致通信握手失败
• 模式匹配：MFRC522的SPI通信模式为CPOL=0、CPHA=0，初始化时必须显式传入polarity=0, phase=0参数，模式错位会导致总线读取的数据全为0或全为0xFF
• 基础连通验证：在驱动初始化完成后，手动读取MFRC522的版本寄存器（地址0x37），正常应返回0x88或0x92，如果读取值为固定的全0或全0xFF，说明SPI总线本身未连通，不需要往上排查业务逻辑

代码逻辑排查 #

• 运行状态验证：在主读卡循环的最开头加一句固定的print("loop running")，如果串口连这句循环心跳都没有，说明程序在MFRC522初始化阶段就卡住或崩溃，没有进入主循环
• 逻辑分支检查：确认找卡、读UID的判断分支没有写反、没有被异常捕获块静默吞掉——很多时候代码实际检测到了卡片，但因为判断条件写错，根本没有走到打印UID的语句
• 平台适配校验：确认使用的MicroPython版mfrc522.py是专门适配RP2040（Pico）平台的，不要直接套用ESP32/ESP8266平台的同功能驱动，不同平台的GPIO操作、SPI接口逻辑存在差异，会导致驱动初始化完全失效
• 硬件适配注意：Iduino版MFRC522的天线增益默认配置和通用版MFRC522有区别，如果驱动没有对应调整天线增益寄存器参数，会导致检测距离不足1mm，甚至完全无法触发找卡动作，表现为串口无任何卡片ID输出

快速定位小技巧 #

• 用万用表测量MFRC522的3.3V引脚电压，确认供电稳定在3.2V~3.4V区间，杜邦线连接的场景经常会因为线损导致供电不足，读卡器无法正常启动
• 更换已知正常的M1卡（Classic 1K）测试，排除测试卡片本身失效的问题

内容的提问来源于stack exchange，提问作者HeyNobody