鸿蒙 IoT 开发：基于 Hi3861 开发板，30 行代码实现“碰一碰”自动配网

📡 前言：从“繁琐”到“无感”

做过 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 的密码发过去（如果是双频合一路由器），但也可能导致配网失败。