XIAO nRF52840 NFC标签模拟实战：从原理到动态应用开发

1. 项目概述：为什么要在XIAO nRF52840上玩NFC？

如果你手头有一块Seeed Studio XIAO nRF52840（或者带传感器的Sense版本），除了用它做蓝牙项目、跑TinyML，有没有想过它内置的NFC功能能玩出什么花样？这块小小的板子，核心是一颗Nordic Semiconductor的nRF52840 SoC，它集成了一个完整的NFC标签前端（NFCT）。这意味着，你不需要外接任何模块，就能让这块开发板变身成一个可编程的NFC标签，或者读取其他NFC标签的信息。

听起来可能有点抽象，我举几个实际的例子。你可以用它做一个智能名片，手机一碰就自动弹出你的联系方式、个人主页；可以做一个智能家居的触发开关，手机碰一下，就自动打开客厅的灯或者播放音乐；甚至可以结合板载的传感器，做一个“碰一碰记录环境数据”的数据记录器。前段时间网上很火的“NFC音乐墙”，原理上完全可以用这块板子来实现——每个板子预存一首歌的链接或指令，手机靠近不同的板子，就能播放不同的音乐。这比用静态的NTAG标签酷多了，因为你的程序可以动态改变NFC标签里的内容，或者根据传感器数据做出不同的响应。

这个项目，就是带你彻底吃透XIAO nRF52840上这颗NFCT外设的用法。我会从最基础的原理讲起，手把手带你完成Arduino环境下的配置、代码编写，再到几个有代表性的实战应用。无论你是想快速实现一个点子，还是想深入理解NFC-A Type 2 Tag的底层通信，这篇文章都能给你一份可以直接“抄作业”的指南。

2. 核心硬件与NFC原理浅析

在动手写代码之前，我们得先搞清楚手头的“武器”和它工作的“战场”。XIAO nRF52840的核心是nRF52840芯片，而NFC功能则由其内部的NFCT（NFC Tag）外设实现。

2.1 nRF52840的NFCT外设能力边界

首先必须明确一点：nRF52840的NFCT是一个标签前端。这是一个关键定位，它决定了我们能做什么、不能做什么。

• 它能做什么（Tag Emulation模式）：模拟一个符合NFC Forum Type 2 Tag标准的被动NFC标签。在这种模式下，开发板就像一个普通的NFC贴纸（比如NTAG213），等待NFC读卡器（最常见的就是你的手机）来靠近、供电并读取数据。板子本身不需要额外供电（理论上，但为了运行程序通常需要），能量由读卡器通过射频场提供。这是我们将要主要使用的模式。
• 它不能做什么：它不是一个完整的NFC读卡器。这意味着你不能直接用这块板子去主动读取另一张NFC卡片或标签的信息。如果你想实现读卡功能，通常需要外接一个专用的NFC读卡器芯片（如PN532），并通过I2C或SPI与XIAO通信。

为什么这么设计？主要是成本和功耗。对于很多物联网设备，它们只需要被手机便捷地识别和交互（例如配对、获取URL），模拟标签是最高效、最省电的方式。nRF52840的NFCT被设计用来优化这种场景。

2.2 NFC-A与Type 2 Tag：通信的基础协议

我们的板子模拟的是NFC-A (ISO/IEC 14443 Type A)接口下的Type 2 Tag。你可以把它理解为一套标准的“对话规则”。

• NFC-A：规定了射频场的频率（13.56MHz）、调制方式、编码规则等物理层和链路层的细节。手机和我们的板子就在这个“频道”上通话。
• Type 2 Tag：规定了内存结构、访问命令和权限。它把标签的存储空间想象成一个个“块”（Block），每个块通常16字节。有专门的命令来读（READ）写（WRITE）这些块。

一个Type 2 Tag的内存布局大致如下：

当你的手机靠近一个模拟成功的标签时，底层会发生一系列复杂的交互：激活射频场、选择标签类型、读取UID、然后根据应用需求读取特定块的数据。幸运的是，Arduino库为我们封装了这些底层细节，我们只需要关心：“我要在标签里存什么数据？”

2.3 XIAO nRF52840的硬件连接

这部分非常简单，因为NFCT功能已经集成，你不需要连接任何额外的导线。NFC天线被直接集成在XIAO nRF52840开发板的PCB上，就是板上那个方形的线圈。你唯一要确保的是：

1. 通过USB-C口为板子正常供电（或使用电池）。
2. 在编程时，避免有大型金属物体紧贴线圈区域，以免影响天线性能。

注意：XIAO nRF52840 Sense版本额外集成了麦克风、IMU等传感器，但其NFC部分与基础版完全相同，本教程完全适用。

3. 开发环境搭建与核心库解析

我们将使用最广泛的Arduino IDE进行开发。虽然也可以用PlatformIO，但Arduino库的支持目前最为直接。

3.1 安装板卡支持与核心库

1. 安装Arduino IDE：从Arduino官网下载并安装最新稳定版（如1.8.x或2.x）。建议使用2.x版本，库管理更友好。
2. 添加板卡支持：
   • 打开Arduino IDE，进入“文件” -> “首选项”。
   • 在“附加开发板管理器网址”中，填入：

     https://files.seeedstudio.com/arduino/package_seeeduino_boards_index.json

   • 然后打开“工具” -> “开发板” -> “开发板管理器”。
   • 搜索“Seeed nRF52”，找到“Seeed nRF52 Boards by Seeed Studio”，点击安装。这个过程会下载nRF52840所需的编译工具链和核心框架，可能需要一些时间。
3. 选择开发板与端口：
   • 安装完成后，在“工具” -> “开发板”中选择“Seeed XIAO nRF52840 (Sense)”。
   • 将板子通过USB连接电脑，在“工具” -> “端口”中选择对应的串口（通常显示为XIAO nRF52840或类似）。

3.2 理解并安装NFC库：Adafruit_PN532的“变体”

这里有一个非常重要的点：我们使用的是Adafruit_PN532库，但不是用来驱动PN532读卡器，而是利用它内部已经实现的、与NFC标签通信的高级逻辑。nRF52840的底层驱动（NFCT）会将自己“伪装”成一个PN532兼容的设备，供上层库调用。

1. 安装库：打开“工具” -> “管理库...”。搜索“Adafruit PN532”。选择由Adafruit维护的版本进行安装。安装时，通常会提示你同时安装依赖库Adafruit BusIO，一并确认安装。
2. 库的适配性：这个库原本是为PN532硬件读卡器设计的，但Nordic在其nRF5 SDK的示例中，通过实现一组相同的底层接口（如_readPassiveTargetID），使得这个库可以在nRF52840上无缝工作，用于标签模拟。这是开源生态中一种巧妙的“代码复用”。

3.3 验证基础NFC功能：一个简单的“Hello NFC”示例

在深入复杂应用前，我们先上传一个最简单的测试程序，确保整个链路是通的。

#include <Adafruit_PN532.h> // 定义必要的引脚（对于XIAO nRF52840，这些是虚拟的，但库需要） #define PN532_IRQ (2) #define PN532_RESET (3) // 未连接，但需要定义 Adafruit_PN532 nfc(PN532_IRQ, PN532_RESET); void setup(void) { Serial.begin(115200); while (!Serial) delay(10); // 等待串口连接，仅用于调试 Serial.println("Hello! XIAO nRF52840 NFC Tag Emulation Test"); nfc.begin(); uint32_t versiondata = nfc.getFirmwareVersion(); if (! versiondata) { Serial.println("Didn't find PN53x board"); while (1); // 停住 } // 打印固件版本信息 Serial.print("Found chip PN5"); Serial.println((versiondata>>24) & 0xFF, HEX); Serial.print("Firmware ver. "); Serial.print((versiondata>>16) & 0xFF, DEC); Serial.print('.'); Serial.println((versiondata>>8) & 0xFF, DEC); // 配置板子以模拟Type 2 Tag nfc.SAMConfig(); // 定义NDEF消息：一个纯文本 Serial.println("Setting tag data to 'Hello from XIAO!'"); uint8_t ndefUri[] = { 0xD1, // MB/ME/CF/1/IL/TNF 字段组合，表示这是一个NDEF记录 0x01, // 类型长度 0x0C, // 载荷长度 (12字节) 'T', // 类型为 "T" (文本) 0x02, // 状态字节，语言编码为2字节（'en'） 'e', 'n', 'H','e','l','l','o',' ','f','r','o','m',' ','X','I','A','O','!' }; // 开始模拟标签 nfc.startPassiveTargetIDDetection(PN532_MIFARE_ISO14443A); Serial.println("Waiting for an NFC reader (e.g., your phone)..."); } void loop(void) { // 等待手机靠近 if (nfc.tagPresent(100)) { // 检查100毫秒内是否有读卡器 Serial.println("Tag detected by reader!"); // 这里可以添加更复杂的交互逻辑 delay(1000); // 简单延时，避免频繁触发 } }

上传与测试：

1. 将代码上传到XIAO nRF52840。
2. 打开串口监视器，波特率设为115200。你应该看到“Found chip PN5...”和等待读卡器的提示。
3. 用一部支持NFC的安卓手机（确保NFC功能已打开），靠近板子上的天线线圈。
4. 串口监视器会打印“Tag detected by reader!”。同时，你的手机通常会弹出一个通知，显示它读取到了一段文本“Hello from XIAO!”。如果手机安装了NFC工具类App（如“NFC Tools”），可以更清晰地看到读取到的NDEF记录内容。

这个例子虽然简单，但验证了从库初始化、标签模拟到被手机识别的完整流程。如果这一步成功了，恭喜你，硬件和基础环境已经就绪。

4. 深入NDEF：让NFC数据被手机智能识别

上一节我们硬编码了一段字节数组作为NDEF消息。但要让手机（或其他NFC设备）能智能地识别并做出相应动作（如打开浏览器、添加联系人），我们需要遵循标准的NDEF（NFC Data Exchange Format）格式。

4.1 NDEF记录结构解析

NDEF消息由一个或多个NDEF记录组成。一个记录就像一封信，包含信封（记录头）和信纸（载荷）。

• 记录头：包含重要标志，如是否为消息的起始/结束记录、载荷类型等。最重要的字段是TNF（类型名称格式）和类型（Type）。
• 载荷：实际存放的数据，比如URL、文本、电话号码。

对于最常见的场景：

• URI（网址）：TNF=0x01 (Well-Known)，Type="U"。载荷的第一个字节是URI前缀码（例如0x01代表http://www.），后面跟着URI的剩余部分。
• 文本：TNF=0x01 (Well-Known)，Type="T"。载荷的第一个字节是状态字节（包含语言编码长度），后面是语言代码和实际文本。

手动构造这些字节数组非常繁琐且容易出错。因此，我们使用一个更高级的库来帮忙。

4.2 使用ArduinoNDEF库简化操作

为了更方便地创建NDEF消息，我们引入另一个库：ArduinoNDEF。它可能不在Arduino库管理器中，需要手动安装。

1. 下载库：从GitHub（如don的ArduinoNDEF仓库）下载ZIP文件。
2. 安装库：在Arduino IDE中，点击“项目” -> “加载库” -> “添加.ZIP库...”，选择下载的ZIP文件。
3. 编写更清晰的代码：以下示例展示如何创建一个包含URL的NDEF消息。

#include <Adafruit_PN532.h> #include <NDEF.h> #include <NDEFMessage.h> #include <NDEFRecord.h> #define PN532_IRQ (2) #define PN532_RESET (3) Adafruit_PN532 nfc(PN532_IRQ, PN532_RESET); void setup(void) { Serial.begin(115200); while (!Serial); nfc.begin(); nfc.SAMConfig(); // 1. 创建一个NDEF消息容器 NDEFMessage message; // 2. 创建一个URI记录 // 参数：URI前缀码， URI字符串 // 0x01 代表 "http://www." NDEFRecord uriRecord = NDEFRecord::createUriRecord(0x01, "seeedstudio.com/xiao"); // 3. 将记录添加到消息中 message.addRecord(uriRecord); // 4. 获取编码后的字节数组和长度 int encodedSize = message.getEncodedSize(); uint8_t ndefBuffer[encodedSize]; message.encode(ndefBuffer); // 5. 将NDEF消息设置为标签模拟的内容 // 注意：这里需要调用nRF5 SDK底层函数，Adafruit库未直接暴露此接口。 // 实际中，我们需要使用Seeed或Nordic提供的特定示例代码。 // 以下为概念性代码： // nfc.ntag2xx_EmulateStart(ndefBuffer, encodedSize); Serial.println("NDEF Message created for URI: http://www.seeedstudio.com/xiao"); Serial.println("Waiting for NFC reader..."); } void loop(void) { // 模拟循环 if (nfc.tagPresent(50)) { Serial.println("Interacted!"); delay(1000); } }

重要提示：上面的nfc.ntag2xx_EmulateStart函数在标准的Adafruit_PN532库中可能不存在。这是因为将NDEF数据注入到标签模拟引擎，需要调用nRF52840更底层的驱动API（如nfc_tag_emulation）。Seeed Studio通常会提供一个整合好的示例。你需要去Seeed的官方Wiki或GitHub仓库查找名为“NFC_Example”或“NFCT_Emulation”的示例代码，那里面包含了如何正确调用nfc_tag_emulation函数的完整流程。我们的代码展示了如何使用ArduinoNDEF库构造标准消息，最后一步需要替换为官方示例中的正确函数调用。

4.3 实战：创建智能名片（vCard）

一个更实用的例子是创建电子名片。当手机读取后，可以直接弹出添加联系人的选项。

// 假设已正确初始化nfc对象并配置为标签模拟模式 void createVCardTag() { // vCard数据（简化版） String vCardData = "BEGIN:VCARD\r\n"; vCardData += "VERSION:3.0\r\n"; vCardData += "FN:Zhang San\r\n"; // 姓名 vCardData += "ORG:Seeed Studio\r\n"; // 组织 vCardData += "TEL;TYPE=CELL:+86 13800138000\r\n"; // 电话 vCardData += "EMAIL:zhangsan@example.com\r\n"; // 邮箱 vCardData += "URL:https://www.seeedstudio.com\r\n"; // 网址 vCardData += "END:VCARD"; // 创建一个MIME类型记录。vCard的MIME类型是 "text/vcard" NDEFRecord mimeRecord; mimeRecord.setTnf(TNF_MIME_MEDIA); mimeRecord.setType("text/vcard"); // 设置类型 // 将String转换为uint8_t数组 uint8_t payload[vCardData.length() + 1]; vCardData.getBytes(payload, sizeof(payload)); mimeRecord.setPayload(payload, vCardData.length()); NDEFMessage message; message.addRecord(mimeRecord); // ... (后续：编码message并启动标签模拟，需参考官方完整示例) Serial.println("VCard NDEF message created."); }

当手机读取到这个标签时，系统识别到text/vcardMIME类型，就会自动询问是否要将此联系人信息保存到通讯录。这就是NDEF标准化的威力——数据有了明确的语义，接收设备就知道该如何处理它。

5. 进阶应用：动态NFC与传感器联动

静态数据固然有用，但让NFC标签的内容“活”起来才是XIAO nRF52840的真正优势。结合板载的处理器和传感器，我们可以实现动态内容生成。

5.1 基于环境传感器的动态URL

假设我们想做一个环境监测标签，手机碰一下，就能看到当前的温湿度数据。我们无法在标签里存储一个实时变化的数值，但可以存储一个指向云端服务的URL，并将实时数据作为参数传递。

思路：

1. 板子读取传感器（如Sense版的温湿度传感器）数据。
2. 将数据通过Wi-Fi或蓝牙上传到某个云平台（如Blynk、Thingspeak），或者本地服务器，并生成一个唯一的数据ID或页面。
3. 板子动态生成一个包含这个数据ID的URL，并将其设置为NFC标签的内容。
4. 手机读取到这个URL，打开浏览器即可查看实时或历史数据。

由于XIAO nRF52840本身不带Wi-Fi，这里以蓝牙传输数据到手机，再由手机App转发到云端为例，描述概念流程：

// 伪代码/概念流程 #include <Adafruit_PN532.h> #include <NDEF.h> // 假设有温湿度传感器库 #include <Seeed_SHT35.h> // 假设有蓝牙库，例如ArduinoBLE #include <ArduinoBLE.h> SHT35 sensor; float temperature, humidity; void setup() { // 初始化传感器、NFC、蓝牙 sensor.init(); nfc.begin(); nfc.SAMConfig(); BLE.begin(); // ... 配置蓝牙服务和特征值 } void loop() { // 1. 读取传感器数据 temperature = sensor.getTemperature(); humidity = sensor.getHumidity(); // 2. 通过蓝牙将数据发送到已连接的手机App // BLECharacteristic.write(temperature, humidity); // 3. 假设手机App收到数据后，将其上传到云端，并返回一个短链接，例如：https://mycloud.com/data/abc123 // 这里我们模拟这个短链接。实际中，这个链接需要由手机App通过蓝牙回传给板子。 String dynamicUrl = "https://mycloud.com/data/abc123"; // 4. 创建包含此动态URL的NDEF消息 NDEFMessage msg; // 注意：0x01是URI前缀码，代表"http://www."，但我们的链接是https，需要处理。 // 更通用的方法是使用前缀码0x00（无前缀），然后写入完整URL。 // NDEFRecord uriRec = NDEFRecord::createUriRecord(0x00, dynamicUrl.c_str()); // 需要库支持 // 这里简化处理，假设createUriRecord能处理完整URL msg.addRecord(NDEFRecord::createUriRecord(0x00, dynamicUrl.c_str())); // 5. 编码并更新NFC标签模拟的内容 // updateNFCTagContent(msg); // 调用底层API更新模拟标签的数据 // 6. 等待下一次交互或数据更新 delay(10000); // 每10秒更新一次数据和NFC内容 }

这个例子展示了“动态”的含义：NFC标签里的URL不是写死的，而是根据传感器数据或外部输入实时生成的。手机每次触碰，都可能读到不同的链接，指向不同的数据。

5.2 实现简单的交互逻辑（计数器）

一个更简单的动态例子是触碰计数器。每次手机触碰，板子内部的计数器加1，并将新的计数值通过NFC标签返回给手机。

这需要板子在标签模拟模式下，能够响应手机的读操作，并返回不同的数据。这涉及到NFCT的高级事件处理。nRF52840的NFCT支持在收到READ命令时触发中断，我们可以在中断服务程序（ISR）中动态改变要返回的内存数据缓冲区。

核心步骤：

1. 配置NFCT进入仿真模式，并设置好初始的NDEF消息（如“Count: 0”）。
2. 使能READ事件中断。
3. 在READ事件中断服务函数中：
   • 递增计数器。
   • 根据新计数器值，重新生成NDEF消息（如“Count: 1”）。
   • 更新NFCT内部用于响应的数据缓冲区（RAM中特定的寄存器区域）。
4. 手机下次读取时，就会得到更新后的数据。

这部分代码严重依赖nRF5 SDK的底层API，在纯Arduino环境下实现较为复杂。通常，Seeed或Nordic会提供这样的高级示例。你需要查找名为nfc_tag_emulation_callback或类似的示例，它展示了如何挂钩READ事件并修改数据。

5.3 功耗考量：如何实现低功耗触碰唤醒

一个很酷的应用是：板子平时处于深度睡眠（微安级功耗），当NFC读卡器（手机）靠近时，射频场产生的能量被NFCT天线接收，可以产生一个唤醒事件，将CPU从睡眠中唤醒。

实现原理：

1. 在进入深度睡眠前，配置NFCT处于“感应场检测”模式。
2. 当有外部NFC场（手机靠近）时，NFCT会触发一个中断。
3. 这个中断可以作为唤醒源，将系统从深度睡眠中唤醒。
4. 唤醒后，系统再初始化NFCT进入完整的标签模拟模式，与手机进行通信。

这种方式非常适合电池供电的物联网设备，可以实现“零待机功耗”的触碰交互。在nRF5 SDK中，这通常通过配置POWER和NFCT模块的低功耗模式相关寄存器来实现。在Arduino框架下，你可能需要直接调用一些底层库函数或修改板支持包（BSP）中的电源管理代码。

6. 问题排查与调试心得

在实际操作中，你几乎一定会遇到各种问题。这里分享一些我踩过的坑和解决方法。

6.1 常见问题与解决方案

6.2 调试技巧：利用串口和手机App

1. 串口是你的眼睛：在代码的关键节点（初始化成功、数据生成后、触发事件时）添加Serial.println()输出状态信息。这是判断程序流是否按预期执行的最基本方法。
2. 手机NFC工具App是数据验证器：
   • NFC Tools：非常适合查看NDEF记录。它能清晰地解析出URI、文本、vCard等内容。如果这里显示正确，说明你的NDEF编码没问题。
   • Mifare Classic Tool：更适合查看底层数据。它可以显示读取到的所有扇区、块的内容（十六进制和ASCII格式）。当你需要确认写入的原始字节是否正确时，这个工具非常有用。
3. 逻辑分析仪（进阶）：如果问题非常底层（如通信根本未建立），可以考虑用逻辑分析仪抓取NFCT相关引脚的波形。但这需要一定的硬件知识和设备。

6.3 关于“NFC中继攻击”的误解

在搜索资料时，你可能会看到“NFC中继攻击”这个词。这里必须澄清：XIAO nRF52840的NFCT功能与此无关，也无法用于此类攻击。

NFC中继攻击通常需要两个设备：一个靠近原卡，另一个靠近读卡器，两者通过远程通信（如Wi-Fi）接力转发信号，以延长有效通信距离。这需要设备能同时模拟读卡器和标签，或者进行复杂的信号转发。nRF52840的NFCT只是一个简单的标签模拟前端，不具备这种双向、实时、低延迟转发复杂信号的能力。请不要尝试将其用于任何安全测试或攻击场景，这超出了它的设计范围和本教程的初衷。

7. 项目拓展思路与资源汇总

掌握了基础之后，你可以尝试将这些知识组合起来，创造更有趣的项目。

7.1 创意项目灵感

1. 智能设备配网器：为你的ESP32智能灯做一个“碰碰配网”工具。XIAO nRF52840预先存储了Wi-Fi SSID和密码（或一个配网令牌）。新设备出厂时，工人只需用手机碰一下这个XIAO板子，就能将网络配置信息写入手机App，再由App配置给智能设备。比手动输入或蓝牙配网更快捷。
2. 交互式展览标签：在博物馆或画廊，将XIAO nRF52840 Sense藏在展品后面。它可以检测到有人靠近（通过红外或雷达传感器），然后动态改变NFC标签内容。例如，白天显示展品基本信息，晚上显示闭馆时间；或者根据参观者在展品前停留的时间，显示不同深度的介绍文字链接。
3. 基于触碰的任务触发器：与家庭自动化平台（如Home Assistant）结合。在墙上安装多个XIAO板子，每个模拟不同的URL。Home Assistant可以设置一个Webhook触发器，当收到特定URL的访问请求时，就执行一个自动化（如“关闭所有灯”、“播放睡眠音乐”）。你只需用手机碰一下对应的板子，就能触发场景。

7.2 进一步学习的资源

1. 官方文档：
   • Seeed Studio Wiki：搜索“XIAO nRF52840 NFC”，这是最权威的起点，通常有最基础的示例。
   • Nordic Semiconductor Infocenter：查阅nRF52840产品规格书和nRF5 SDK文档中关于NFCT外设的章节。这是理解底层原理的终极资料。
2. 代码仓库：
   • Seeed Studio GitHub：查找Seeed-Studio/Seeed_Arduino_NFC或相关仓库，里面可能有更完整的示例。
   • Arduino Core for nRF5：在GitHub上搜索此项目，了解Arduino层是如何封装NFCT驱动的。
3. 社区与论坛：
   • Seeed Studio Forum：在NFC或XIAO板块提问，社区活跃度较高。
   • Nordic DevZone：如果你遇到非常底层的驱动问题，这里是向Nordic工程师提问的好地方（但问题需要足够具体和深入）。

从我个人的经验来看，在XIAO nRF52840上玩转NFC，最难的不是写代码，而是理清“库-驱动-硬件”之间的调用关系。很多时候，官方的一个完整示例代码胜过千言万语。所以，当你卡住时，第一件事就是去翻找Seeed或Nordic提供的示例项目，仔细对照其中的初始化和数据流处理部分。一旦跑通了第一个动态NFC应用，你会发现这片小小的射频天地，能为你物联网项目带来的交互便捷性，绝对是超值的。