基于Arduino与PN532的NFC模块开发实战：从硬件连接到NDEF读写

1. 项目缘起：当NFC遇见可穿戴与模块化

最近在整理工作室的物料时，翻出来一块几年前入手的“古董”——一块来自Seeed Studio的Xadow NFC模块。它静静地躺在元件盒里，上面落了一层灰。当时买它，是看中了它小巧的尺寸和I2C接口，想用在某个可穿戴艺术项目上，后来项目搁浅，模块也就吃灰了。这次重新拿起它，一方面是怀旧，另一方面也是发现，即便在今天，这种将复杂功能（NFC）封装成标准接口（I2C）的模块化思路，对于快速原型开发、教育以及小型化设备集成，依然有着独特的价值。

Xadow是Seeed Studio推出的一套模块化电子原型系统，其核心特点是超薄、小巧、接口统一（使用一种特殊的FPC软排线连接），非常适合可穿戴设备、物联网小玩意等对空间有苛刻要求的场景。我手头这块“Xadow - NFC”模块，本质上就是一个集成了NFC控制器和天线，并通过I2C总线与主控器（如Arduino）通信的“黑盒子”。你不需要去深究NFC的射频电路如何设计、天线如何匹配，只需要通过几根线（VCC, GND, SDA, SCL）告诉它“读一下标签”或者“往标签里写点数据”，它就能帮你搞定。

这听起来很简单，但实际用起来，从硬件连接到软件驱动，再到理解NFC数据格式（NDEF），每一步都有需要注意的细节。网上关于通用NFC模块（如PN532）的教程很多，但针对这块特定Xadow模块的、结合最新Arduino IDE和库的完整实践记录却不多见。我花了些时间重新让它“跑”了起来，并把整个过程、遇到的坑以及一些扩展想法记录下来。无论你是想复活一块同样的老模块，还是对如何将NFC功能优雅地集成到你的Arduino项目中感兴趣，希望这篇都能给你提供一条清晰的路径。

2. 硬件拆解与连接：认识你的Xadow NFC模块

在写第一行代码之前，我们必须先和硬件打好交道。这块Xadow NFC模块的型号通常是基于NXP的PN532芯片，这是一款在Arduino生态中非常流行的NFC控制器。模块正面最显眼的是一个方形的线圈，那就是NFC天线。模块的背面则是一些必要的电容、电阻以及一个关键的电压转换芯片。

2.1 核心芯片与接口辨识

模块的核心是PN532芯片。它负责处理所有NFC的底层通信协议（如ISO14443A），而我们通过I2C与它对话。为什么用I2C？对于Arduino项目来说，I2C只需要两根数据线（SDA, SCL）就能实现多设备通信，比SPI（需要CS、MOSI、MISO、SCK四根线）更节省宝贵的IO口，尤其适合Xadow这种追求极致紧凑的系统。

模块上通常会有几个标识点：

  1. 接口：一个Xadow标准的FPC插座。你需要一根Xadow to DuPont线（或类似的转接线）将其转换成我们熟悉的杜邦线母头，以便连接到Arduino开发板。
  2. 引脚定义：转接线上或模块PCB上会标明引脚。最关键的四根线是：
    • VCC：电源正极。这里有一个大坑：早期的Xadow模块工作电压可能是3.3V，而Arduino Uno的IO口电压是5V。虽然I2C总线有一定兼容性，但直接连接有风险。务必查看你的模块规格！我手上的模块标明是3.3V，所以我使用了Arduino Uno的3.3V引脚供电。
    • GND：电源地线。
    • SDA：I2C数据线。
    • SCL：I2C时钟线。
  3. LED指示灯：模块上可能有一个小LED，在读写操作时会闪烁，这是判断模块是否工作的最直观方式。

2.2 与Arduino Uno的连接实战

以最常见的Arduino Uno为例，连接方式如下：

  1. 准备：Xadow NFC模块， Xadow转杜邦线， Arduino Uno， 4根杜邦线（公对母）。
  2. 电压确认：我的模块是3.3V，因此我将转接线的VCC连接到Uno的3.3V输出引脚。如果你不确定，先从3.3V尝试，避免烧毁模块。
  3. 连接I2C：Uno的I2C接口是固定的：
    • SDA->Analog 4 (A4)
    • SCL->Analog 5 (A5)将转接线的SDA和SCL分别连接到这两个引脚。
  4. 连接地线：GND连接到Uno的任意GND引脚。
  5. 检查：连接完成后，给Arduino上电。如果模块有LED，可能会轻微亮起或在上电瞬间闪烁一下。

注意：如果你使用的是3.3V逻辑的Arduino板（如Arduino Due, ESP32, ESP8266），那么VCC可以直接接3.3V，并且I2C电平匹配完美。如果主控是5V逻辑（如Uno），而模块是3.3V，I2C通信通常能工作是因为模块的I2C引脚是耐5V的（但并非绝对，需查芯片手册）。最稳妥的方式是使用双向电平转换器（如TXB0104）在SDA和SCL线上，但我实测这款Xadow模块与Uno直接连接可以正常工作。

3. 软件环境搭建与库的抉择

硬件连好了，下一步就是让Arduino能和它“说话”。我们需要一个翻译官——也就是驱动程序库。

3.1 Arduino IDE与库管理器

确保你使用的是较新版本的Arduino IDE（1.8.x或2.0+）。打开IDE，前往“工具” -> “管理库…”，打开库管理器。

3.2 关键库：Adafruit_PN532

在库管理器中搜索“PN532”。你会看到好几个结果，最常见的是“Adafruit PN532”和“Seeed Arduino PN532”。这里我强烈推荐使用Adafruit_PN532库。原因如下：

  • 维护活跃：Adafruit库更新更频繁，对新版IDE兼容性好。
  • 功能完整：支持I2C、SPI、HSU（高速UART）多种模式，示例丰富。
  • 社区支持好：遇到问题更容易找到解决方案。

点击“Adafruit PN532”库旁边的“安装”按钮。安装时，它会提示你同时安装依赖库“Adafruit BusIO”，务必一起安装。

为什么不直接用Seeed的库？Seeed的库可能更早针对其模块编写，但在我测试时，其示例代码在最新环境下可能需要调整，而Adafruit库的通用性更好，经过大量项目验证。

3.3 验证连接：运行第一个示例程序

库安装好后，我们来做一个最简单的测试：扫描NFC标签。

  1. 在Arduino IDE中，点击“文件” -> “示例” -> “Adafruit PN532” -> “readall”。
  2. 打开这个示例代码。
  3. 关键修改：示例代码默认可能使用软件I2C或硬件I2C，并可能指定非标准的I2C地址。对于Xadow模块，我们需要确保它使用Arduino的硬件I2C，并指定正确的地址。
    • 在setup()函数前，找到初始化代码。通常类似：
      Adafruit_PN532 nfc(PN532_IRQ, PN532_RESET);
      对于I2C连接，我们需要使用另一个构造函数。将初始化行改为：
      Adafruit_PN532 nfc(PN532_I2C_ADDRESS, &Wire);
      PN532_I2C_ADDRESS通常是0x24（7位地址）。&Wire表示使用硬件I2C（Wire）对象。
    • 完整的setup()函数开头可能像这样：
      void setup(void) { Serial.begin(115200); while (!Serial) delay(10); // 等待串口打开，用于Leonardo/Micro等 Serial.println("Hello!"); nfc.begin(); uint32_t versiondata = nfc.getFirmwareVersion(); if (! versiondata) { Serial.print("Didn't find PN53x board"); while (1); // halt } ... }
  4. 将代码上传到Arduino Uno。
  5. 打开串口监视器，波特率设置为115200。
  6. 将一张NFC标签（比如门禁卡、银行卡、或空白NTAG标签）靠近模块天线。
  7. 如果一切正常，你会在串口监视器中看到类似以下的输出：
    Hello! Found chip PN532 Firmware ver. 1.6 Waiting for an ISO14443A Card... Found an ISO14443A card UID Length: 7 bytes UID Value: 0xXX 0xXX 0xXX 0xXX 0xXX 0xXX 0xXX
    这表示你的硬件连接和基础驱动成功了！模块正确识别到了PN532芯片，并读出了标签的UID（唯一标识符）。

4. 深入NFC数据操作：读写NDEF格式信息

仅仅读UID就像只知道一个人的身份证号，但不知道他叫什么、是做什么的。NFC标签更强大的功能在于存储和交换数据，而这通常遵循NDEF（NFC Data Exchange Format）格式。NDEF是一种标准化的消息格式，可以包含文本、URL、电话号码、智能海报等多种类型的记录。

4.1 理解NDEF：数据的“信封”与“信纸”

你可以把NDEF想象成一个信封。信封上写着一些信息（记录类型、长度等），信封里装着实际的内容（比如一个网址、一段文字）。一个NDEF消息可以包含多个记录（多个信封叠在一起）。

对于Arduino，我们要做的就是：

  1. 创建一个NDEF消息（信封）。
  2. 向里面添加NDEF记录（信纸），并指定记录类型和内容。
  3. 将这个完整的消息写入到NFC标签中。
  4. 或者，从标签中读取NDEF消息并解析出来。

4.2 实战：向标签写入一个网址

我们使用Adafruit_PN532库中更高级的示例。在示例菜单中，找到“Adafruit PN532” -> “WriteUrl”。这个示例演示了如何将一个URL写入标签。

仔细阅读这个示例代码，它的核心逻辑如下：

  1. 准备NDEF消息对象：NdefMessage message。
  2. 创建URI记录：NdefRecord record = NdefRecord::createUri(“https://www.seeedstudio.com”);这里创建了一个指向Seeed Studio官网的URI记录。你可以替换成任何你想要的网址。
  3. 添加记录到消息：message.addRecord(record);。
  4. 准备写入：代码会先检查标签是否可写（nfc.tagPresent()），然后尝试格式化标签为NDEF可用的类型（nfc.ntag2xx_WriteNDEFURI）。
  5. 执行写入：对于NTAG2xx系列标签（最常见的一种），库提供了便捷函数ntag2xx_WriteNDEFURI。对于其他类型，可能需要更通用的write函数。

上传并运行这个示例。按照串口监视器的提示，将一张空白的NTAG标签靠近模块。写入成功后，你可以用手机的NFC功能去感应这个标签。如果你的手机NFC是开启的，应该会自动弹出浏览器并打开你写入的网址！这就是NFC标签最经典的应用场景之一。

4.3 实战：从标签读取文本信息

写入网址很酷，但写入自定义文本呢？我们来自定义一个写入文本的例子，并读取它。

写入文本的代码片段：

#include <Adafruit_PN532.h> #include <NdefMessage.h> #include <NdefRecord.h> Adafruit_PN532 nfc(PN532_I2C_ADDRESS, &Wire); void setup(void) { Serial.begin(115200); nfc.begin(); // ... 初始化检测PN532代码同上 ... Serial.println("Place a blank NTAG2xx tag on the module to write."); // 等待标签出现 uint8_t uid[] = { 0, 0, 0, 0, 0, 0, 0 }; uint8_t uidLength; if (!nfc.readPassiveTargetID(PN532_MIFARE_ISO14443A, uid, &uidLength)) { return; // 没检测到标签 } // 1. 创建NDEF消息 NdefMessage message; // 2. 创建文本记录 // 参数：语言编码（如”en“）， 文本内容 NdefRecord textRecord = NdefRecord::createTextRecord(“en”, “Hello from Xadow NFC!”); message.addRecord(textRecord); // 3. 获取消息的字节流 uint8_t ndefBuf[128]; uint8_t messageSize = message.getEncodedSize(); if (messageSize > sizeof(ndefBuf)) { Serial.println(“Message too large for buffer”); return; } message.encode(ndefBuf); // 4. 写入标签 (这里以NTAG213为例，容量144字节) // 注意：需要先知道标签的具体类型和容量，调用对应的写函数 // 更通用的方法是使用 nfc.ntag2xx_WritePage，但需要计算页地址 // 对于简单文本，也可以使用库的 writeNDEFURI 变种，但这里演示通用流程 Serial.println(“Writing NDEF message...”); // 此处简化，实际需根据标签类型分页写入 ndefBuf 中的数据 // 建议先使用库的示例‘readwrite’或‘ntag2xx_write’作为模板 }

重要提示：直接写入原始NDEF字节流到标签需要精确知道标签的内存映射（哪个页存什么）。对于新手，更安全的方法是使用库提供的ntag2xx_WriteNDEFURI写网址，或者深入研究examples/readwrite这个示例，它展示了更底层的页读写操作。对于写自定义文本，一个更简单的方法是先用手机APP（如NFC Tools）将文本写入标签，然后用Arduino来读。

读取NDEF消息（无论内容是网址还是文本）： 使用示例“readwrite”或“readall”中关于NDEF读取的部分。核心函数是nfc.readPassiveTargetID检测标签，然后nfc.ntag2xx_ReadNDEF或通用的nfc.read函数获取数据，最后使用NdefMessage类来解码。

// 假设已检测到标签并获取了uid uint8_t ndefBuf[256]; uint16_t messageLength = sizeof(ndefBuf); bool success = nfc.ntag2xx_ReadNDEF(ndefBuf, &messageLength); if (success) { NdefMessage message = NdefMessage(ndefBuf, messageLength); int recordCount = message.getRecordCount(); for (int i = 0; i < recordCount; i++) { NdefRecord record = message.getRecord(i); if (record.getTnf() == TNF_WELL_KNOWN) { if (record.getType() == “T”) { // 文本记录 String languageCode = “”; String text = “”; record.getText(languageCode, text); Serial.print(“Text: “); Serial.println(text); Serial.print(“Lang: “); Serial.println(languageCode); } else if (record.getType() == “U”) { // URI记录 String url = record.getUri(); Serial.print(“URL: “); Serial.println(url); } } } }

这段代码会尝试解析标签中的NDEF消息，并判断记录类型是文本(T)还是URI(U)，然后打印出内容。

5. 项目构思与进阶应用：超越简单的读写

让模块读写标签只是第一步。结合Arduino的其他能力，我们可以做出更有趣的东西。

5.1 项目一：NFC触发的智能储物盒

想象一个带锁的盒子，只有刷特定的NFC卡才能打开。

  • 硬件：Xadow NFC模块， Arduino， 一个小型舵机（控制锁舌）， 一个电池盒。
  • 逻辑：
    1. Arduino循环检测NFC标签。
    2. 当检测到标签时，读取其UID。
    3. 将读取到的UID与预先存储在代码中的“授权UID”列表进行比较。
    4. 如果匹配，则驱动舵机旋转一定角度，打开锁舌，并点亮一个绿色LED 2秒钟，然后舵机归位锁上。
    5. 如果不匹配，则点亮红色LED，蜂鸣器响一声报警。
  • 关键代码：核心就是UID比对。nfc.readPassiveTargetID函数会将读取到的UID存入一个数组，将这个数组与预设的数组用memcmp函数进行比较即可。

5.2 项目二：NFC音乐墙或信息点播站

这灵感来源于一些互动展览。墙上贴着许多NFC标签，每个标签写入不同的指令或标识符。

  • 硬件：Xadow NFC模块， Arduino， 一个MP3解码板（如DFPlayer Mini）， 音箱。
  • 逻辑：
    1. 在每个NFC标签里，写入一个简单的文本指令，如“track01”、“play_story_2”、“volume_up”。
    2. Arduino读取标签内容。
    3. 根据不同的文本指令，通过串口向DFPlayer Mini发送对应的控制命令（播放指定曲目、调整音量等）。
  • 优势：无需屏幕和复杂菜单，物理触碰标签即可触发不同音频内容，体验非常直观。

5.3 与物联网平台结合

通过Arduino的WiFi或以太网扩展，可以将NFC读取事件上传到云端。

  • 场景：员工考勤、设备使用日志、宠物喂食记录。
  • 流程：刷卡（标签） -> Arduino读取UID并获取时间 -> 通过HTTP/MQTT协议将{“uid”: “xx:xx:xx:xx”, “time”: “2023-10-27T10:00:00”, “event”: “check_in”}这样的JSON数据发送到服务器（如Node-RED, Blynk, ThingsBoard）-> 服务器进行记录或触发后续自动化流程。

6. 调试心得与常见问题排查

在折腾这块老模块的过程中，我踩过几个坑，这里分享出来帮你避雷。

6.1 模块无响应或找不到PN532芯片

  • 症状：串口一直打印“Didn‘t find PN53x board”。
  • 排查步骤：
    1. 电压确认：这是首要怀疑对象。用万用表测量模块VCC和GND之间的电压，确保在3.3V左右（或模块要求的电压）。连接5V可能不工作甚至损坏模块。
    2. 接线复查：SDA和SCL是否接反？是否接触不良？杜邦线是“线材刺客”，经常内部断裂。尝试换一组线，或者直接将线焊在模块焊盘上测试。
    3. I2C地址：PN532的I2C地址默认为0x24（7位），但有些模块可以通过电阻配置为0x48。你可以运行一个I2C扫描程序（Arduino IDE示例“Wire” -> “scanner”）来查看总线上有哪些设备。如果扫描不到任何设备，说明物理连接或电源有问题；如果扫描到0x24或0x48以外的地址，就在代码中修改PN532_I2C_ADDRESS。
    4. 库冲突：确保只安装了Adafruit_PN532库。如果安装了多个PN532库，可能会引起编译错误或运行时冲突。

6.2 可以找到芯片但无法读取标签

  • 症状：初始化成功，但一直“Waiting for an ISO14443A Card…”，标签靠近没反应。
  • 排查步骤：
    1. 天线与距离：NFC是近场通信，距离非常近（通常<5cm）。确保标签直接放在模块的天线线圈上方。尝试稍微移动位置。模块天线周围不要有大的金属物体，会严重干扰磁场。
    2. 标签类型：确认你的标签是ISO14443A标准的（MIFARE Classic, NTAG, Ultralight等）。库的readPassiveTargetID函数第一个参数就是PN532_MIFARE_ISO14443A。如果你用的是其他类型的卡（如Felica），需要调用不同的函数。
    3. 供电不足：如果使用USB供电，且连接了其他耗电设备，可能导致NFC模块供电不稳。尝试单独给Arduino和模块供电，或者使用外接电源。

6.3 写入标签失败

  • 症状：读取正常，但写入时失败，提示写保护或格式化错误。
  • 原因与解决：
    1. 标签已写保护：很多标签有一块“锁定位”区域，一旦写入特定值，部分或全部存储区就永久只读了。检查你是否在尝试写入一个已经被锁定的标签。务必使用全新的、未锁定的标签进行写入测试。
    2. 容量不足：你尝试写入的数据超过了标签的容量。NTAG213只有144字节用户内存，NTAG215有504字节，NTAG216有888字节。计算一下你的NDEF消息大小。一个简单的URL通常没问题，但如果你想写入长文本或图片，就需要大容量标签。
    3. 格式不正确：在写入NDEF数据前，需要先对标签进行“格式化”，即写入NDEF消息头（Capability Container）。ntag2xx_WriteNDEFURI函数内部会处理这个。如果你是自己分页写，必须正确写入CC内容，否则手机会无法识别为NDEF标签。

6.4 代码编译错误

  • “Adafruit_PN532.h: No such file or directory”：库没有正确安装。通过库管理器重新安装，并关闭重启Arduino IDE。
  • “NdefMessage”相关错误：Adafruit_PN532库依赖于Adafruit的NDEF库。确保你安装的是完整的“Adafruit PN532”库，它会自动拉取所需依赖（如Adafruit_BusIO, Adafruit_NDEF）。如果仍有问题，可以在库管理器中单独搜索“Adafruit NDEF”并安装。

这块小小的Xadow NFC模块，就像一扇通往物理世界与数字世界交互的大门。它的价值不在于性能多强悍，而在于其极致的模块化和易用性，将复杂的射频通信简化成了几条简单的I2C指令。从复活一个老旧模块的过程中，我再次体会到，在嵌入式开发里，清晰的文档、正确的库、耐心的调试，比拥有最新最强的硬件更重要。当你成功让手机“叮”的一声识别出自己写入的标签时，那种连接虚实世界的成就感，正是创客乐趣的源泉。如果你手边也有类似吃灰的模块，不妨拿出来，照着上面的步骤试试，给它赋予新的生命。