SoftAP方案：Wi-Fi配网的黄金法则“100%成功”

遵循SoftAP方案的“黄金法则”，Wi-Fi配网将不再有失败风险。设备自组网机制让连接过程变为“单向引导”——设备主动开放热点并智能适配，确保每次配网都能稳定达成100%成功率。

本文以Air8101开发板为例，演示SoftAP配网示例要点。
 

最新源码及实操教程详见：

https://docs.openluat.com/air8101/luatos/app/wifi/softap/ 

一、主要示例代码解析

1.1 启用AP模式：

启用Air8101开发板AP模式，AP是Access Point的缩写，即无线接入点，它是一个无线网络的中心节点，可以看成是一个服务器。

SoftAP配网也就是让Air8101工作在AP模式下，创建一个Wi-Fi热点，用户使用手机或者电脑连接这个热点，通过配网页面将要连接的Wi-Fi信息发送给Air8101，从而实现配网。

1.2 启动一个HTTP服务器，管理Wi-Fi接入点的配置和连接：

通过HTTP服务器实现对Wi-Fi热点的管理和控制。

可以在网页通过HTTP请求控制LED的开关、发送任意消息、扫描可用的Wi-Fi网络、获取AP列表，以及连接到新的Wi-Fi网络。

二、Air8101配网系统实操

2.1 配网系统展示

通过手机或者电脑登录配网网页（IP地址：192.168.4.1），显示内容如下：

2.2 配网系统实例

使用手机或电脑登录到Air8101开发板的网络IP地址，此时手机或电脑等登录设备作为客户端，而开发板则充当服务端，双方进行简单的通信交流。

以下统一以服务端和客户端来分别指代开发板和登录设备。 

1）客户端通过配网页面点击Wi-Fi扫描按钮

可以实现WiFiScan的功能，显示在配网系统页面以及LuaTools日志中。

如下所示：

2）服务端向配网页面发送消息

用户在客户端网页的输入框中键入消息，然后将这个消息通过POST请求以JSON格式发送到服务端的/msg路径，服务端监听到请求后，解析获取到的消息，并通过log打印出来。

3）客户端通过配网页面发指令，让服务端连接到新的Wi-Fi网络。

如下图所示，服务端连接到Wi-Fi热点: kfyy123，连接成功后，会发布一个“IP_READY”消息。后续可以通过订阅该消息，实现联网后的业务逻辑实现。

三、配网常见问题

3.1 手机或电脑无法打开配网网页IP地址？

注意开发板需要配置成AP模式，创建一个Wi-Fi热点，手机或电脑打开配网网页前，需要先连接上前面创建的热点。

3.2 如何获取开发板的MAC地址？

通过wlan.getMac()接口即可，返回值是以十六进制形式呈现。

3.3 SoftAP配网优缺点

--优点：SoftAP配网方式很可靠，成功率基本达到100%，设备端的代码也简单。

--缺点：需要手动切换手机Wi-Fi连接的网络，先连接到Air8101的AP网络，配置完成后再恢复连接正常Wi-Fi网络，操作上有一定的复杂性。

今天的内容就分享到这里了~

审核编辑 黄宇