📡 前言：从“繁琐”到“无感”
做过 ESP32 或 STM32 联网开发的都知道，写一个稳定的 SoftAP 配网网页需要几百行代码。
但在鸿蒙生态中，配网被封装成了系统级服务。
我们利用NAN (Neighbor Awareness Networking)通道，可以让手机发现设备的时间缩短到毫秒级。
硬件准备：
- Hi3861 开发板(润和 BearPi-HM Nano 或类似)。
- NFC 标签贴纸(NTAG213/215/216 均可，成本不到 1 元)。
- 华为/荣耀手机(支持 NFC，系统 HarmonyOS 2.0+)。
🧬 一、 原理揭秘：碰一碰到底发生了什么？
“碰一碰”本质上是一个NFC 触发 + 蓝牙/WiFi 通道传输的过程。
交互流程图 (Mermaid):
💻 二、 软件端：30 行代码开启配网模式
在 Hi3861 的固件代码中，我们不需要手写 Socket 监听，只需要调用鸿蒙提供的WiFi Starter Kit。
在app_demo_netcfg.c(假设的文件名) 中：
#include"wifi_connect.h"#include"nfc_configure.h"// 核心任务入口staticvoidNetCfgTask(void){// 1. 初始化 WiFi 驱动WifiDeviceConfig config={0};// 2. 启动配网服务 (这是鸿蒙特有的 Nano 配网接口)// 这一行代码会自动开启 SoftAP 和 NAN 监听，等待手机发送密码printf("开启碰一碰配网模式...\n");// NET_CFG_NAN_MODE: 极速配网模式if(StartNetCfg(NET_CFG_NAN_MODE,&config)==0){printf("配网成功! SSID: %s, Password: %s\n",config.ssid,config.preSharedKey);// 3. 拿到密码后，连接路由器WifiConnect(config.ssid,config.preSharedKey);}else{printf("配网超时或失败\n");}}// 鸿蒙任务注册标准写法staticvoidNetCfgEntry(void){osThreadAttr_tattr;attr.name="NetCfgTask";attr.attr_bits=0U;attr.cb_mem=NULL;attr.cb_size=0U;attr.stack_mem=NULL;attr.stack_size=10240;// 堆栈大小attr.priority=osPriorityNormal;if(osThreadNew((osThreadFunc_t)NetCfgTask,NULL,&attr)==NULL){printf("创建任务失败\n");}}APP_FEATURE_INIT(NetCfgEntry);解析：核心真的只有StartNetCfg这一行。它内部封装了复杂的 802.11 帧监听、EAPOL 握手和数据解密逻辑。开发者拿到的直接就是解密后的 WiFi 账号密码。
🏷️ 三、 硬件端：NFC 标签写入数据
代码写好了，烧录进板子。但这时候你拿手机碰板子是没反应的，因为手机不知道要连谁。
你需要把设备的身份信息写入 NFC 标签。
NFC 数据格式规范 (应用编排服务格式)：
你需要下载一个 NFC 读写 App (如“NFC Tools”)，写入一条URI 记录：
code: SN:123456789 // 设备序列号 (自定义) &1:1 // 版本号 &2:A1B2C3D4E5F6 // 你的 Hi3861 MAC 地址 (必须真实) &3:1A2B // Product ID (在华为后台申请，测试可用默认) &4:1 // 交互模式关键点：
- MAC 地址：必须与 Hi3861 实际的 MAC 一致，手机通过这个地址在空中“抓”设备。
- Product ID：决定了手机弹窗显示什么图标和名称（是台灯还是风扇）。
🚀 四、 联调实战
- 烧录固件：将代码编译烧录至 Hi3861，复位，串口打印显示
开启碰一碰配网模式...。 - 贴标签：将写入好数据的 NFC 标签贴在开发板天线附近。
- 见证奇迹：
- 手机解锁，开启 NFC 和 WiFi。
- 手机背部触碰标签。
- 手机底部瞬间弹出卡片：“发现未配置的网络设备，是否连接？”
- 点击“连接”，几秒后，串口打印：
配网成功! SSID: MyHome...。
⚠️ 五、 避坑指南
- MAC 地址大小写：NFC 标签里的 MAC 地址通常要求大写且无冒号（如
A0B1C2...），写错了手机搜不到设备。 - NAN vs SoftAP：
NET_CFG_NAN_MODE只有华为/荣耀手机支持，速度极快。如果为了兼容其他安卓手机，可以使用NET_CFG_SOFTAP_MODE，但体验会降级为传统的 AP 配网。 - 频段问题：Hi3861 只支持 2.4G WiFi。如果你的手机连的是 5G WiFi，鸿蒙系统通常会自动把 2.4G 的密码发过去（如果是双频合一路由器），但也可能导致配网失败。
🎯 总结
通过 Hi3861 + HarmonyOS，我们把原本需要几分钟的配网过程压缩到了3 秒。
这不仅是代码的简化，更是“原子化服务”理念的体现。
对于 IoT 开发者来说，掌握“碰一碰”能力，是让你的硬件产品接入鸿蒙生态的第一张门票。
Next Step:
配网成功后，Hi3861 已经连上了互联网。尝试接入华为IoTDA (物联网平台)，结合 MQTT 协议，在手机 App 上远程点亮开发板上的那颗 LED 灯吧！
