10- ESP8266自主WiFi配网

Author：teacherXue

一、ESP8266接入网络

前面我们已经可以使用nodemcu来读取传感器数据，或者控制外设。但这些功能和普通的单片机没有本质差别。物联网是需要接入网络的，传统的单片机系统还需要其他的设备中转才能互相连接以及访问公网。而ESP8266自带wifi功能，其本身就能充当智能网关的角色，ESP32芯片更是提供了蓝牙功能。

1. 固定SSID以STA身份接入

在有路由器的场合，mcu多数作为从设备来工作即可，也就是STA身份，ESP芯片支持AP主设备、STA从设备、AP+STA主从设备模式。下面我们先通过固定方式接入我们所需要的WiFi路由器。

1）新建项目Lot_wifi_test_v1.0，设置串口波特率。

2）引入arduino框架自带库ESP8266WiFi。

#include <ESP8266WiFi.h>

3）定义连接wifi所需的账户密码

const char *ssid = "要连接的ssid";
const char *password = "密码";

4） Setup里面参考以下代码。

void setup()
{
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);//设置wifi模式为从设备STA模式，不声明默认为AP+STA
  // 获得当前mcu网络中主机名称
  Serial.printf("Default hostname: %s\n", WiFi.hostname().c_str());
  // 初始化 Wi-Fi
  WiFi.begin(ssid, password);
  Serial.print("正在连接 WiFi..");
  while (WiFi.status() != WL_CONNECTED)
  {
    Serial.print('.');
    delay(1000);
  }
  Serial.println(WiFi.localIP());//打印获得的IP地址
  Serial.print("RRSI: ");
  Serial.println(WiFi.RSSI());//打印wifi的信号强度
}

5） 烧录程序，观察串口调试结果。

我们可以看到，串口打印出了连接到WiFI后的IP地址，还有MCU的hostname（来自于芯片id），最后输出WiFi信号的强度值。因为loop中我们没写任何代码，所以它后续并不会做什么。我们可以使用同一网络的计算机设备ping这个地址，可以看到如下结果。

二、WiFi自主配网

上一案例中，虽然代码比较简单，如果是自己做实验非常快速。但是如果场景发生了变化，如果是要销售的产品，如何知道用户的WiFi环境。所以在产品开发上该方法不可取。WiFi配网应该交给客户通过比较简单直接的方式进行。

1. 配网方式

1）WiFi配网

MCU没有配网前，芯片工作在AP模式。SSID和密码预先写好，告知客户。客户使用WiFi设备连接芯片。然后打开web网页，扫描周围的WiFi热点，选择并输入密码进行配网。连接成功后，芯片转为从设备继续工作。

2）蓝牙配网

ESP8266并没有蓝牙功能，但可以通过串口蓝牙设备扩展。如果是ESP32则自带了蓝牙功能。可以通过手机和芯片进行蓝牙配对后，通过蓝牙通信传输WiFi配置信息。

2. 安装WiFimanager扩展库

继续拿来主义，WiFimanager扩展库提供了非常便捷的WiFi配网功能。下面就来看一下如何使用WiFimanager进行WiFi配网。

1. 新建项目Lot_wifi_test_v2.0

2. 修改串口通信速率

3. 安装WiFimanager扩展库。

这里需要注意：platformio扩展库下载的WiFimanager比较老旧，里面的案例也未能提供我们所需要的，所以我们将采取导入外部扩展库的方式。

打开arduino软件，我们将使用他来获得扩展库（其实去git上去获得这个扩展库也是可以的）。打开软件的工具 -> 管理扩展库-> 输入WiFiManager搜索后向下滚动，找到WiFiManager扩展库安装。

打开主界面 文件-> 首选项 ->找到项目文件夹位置。

该目录下的libraries目录就是下载的库文件目录。可以看到下载的WiFiManager库

将该目录用鼠标拖拽到（你也可以copy到目标文件夹）platformIO项目目录的lib目录下。

在项目文件中打开该扩展库的案例中的basic案例。

3. 代码解析

1）引入支持库后我们需要创建wifimanager对象。

WiFiManager wm;

2）有些被注释掉的代码调用，仔细阅读，可能在某些场合有应用价值，例如擦除芯片设置。因为如果芯片被成功接入网络，那么它将不会再次出现配网界面，如果我们要改变网络配置，可以通过某些外置按钮来触发擦除操作。

// wm.resetSettings();

3）扩展库有三种建立连接的方式

• 默认芯片ID的AP匿名连接。

• 指定的AP名称匿名连接。

• 指定AP名称并指定连接密码，此方式比较安全。

wm.autoConnect(); //从芯片id自动生成AP名称
wm.autoConnect("AutoConnectAP"); // 匿名连接
wm.autoConnect("AutoConnectAP","password"); //指定AP和密码

5) 完整的代码如下

#include <WiFiManager.h> // https://github.com/tzapu/WiFiManager
void setup() {    
    Serial.begin(115200); 
    // WiFiManager，本地初始化。一旦它的任务完成了，就没有必要再让它存在了
    WiFiManager wm;

    // 擦除设置，它们被保存在芯片中
    // wm.resetSettings();

    //自动连接使用保存的凭证，
//如果连接失败，它将启动一个具有指定名称的接入点("AutoConnectAP")，
//如果为空将自动生成SSID，如果密码为空将是匿名AP (wm.autoConnect())
//然后进入阻塞循环等待配置并返回成功结果

    bool res;
    // res = wm.autoConnect(); //从芯片id自动生成AP名称
    // res = wm.autoConnect("AutoConnectAP"); // 匿名连接
    res = wm.autoConnect("xm_"+ ESP.getChipId(),"12345678"); // 指定密码的AP
    //根据返回结果判断连接是否生效
    if(!res) {
        Serial.println("Failed to connect");
        // ESP.restart();
    } 
    else {
        //WiFi连接成功    
        Serial.println("connected...yeey :)");
    }

}

void loop() {
    // put your main code here, to run repeatedly:   
}

5) 烧录代码并运行

用手机扫描AP热点，找到xm开头后跟16进制数字的AP名称就是MCU芯片，输入密码12345678连接，自动打开浏览器页面跳转至192.168.4.1，此时为配网页面。选择第一项配网，会扫描附近WiFi热点，选择需要连接的热点，并输入密码保存。连接成功后页面跳转MCU已经转为从设备工作状态。

串口信息显示如下