# ESP32-8266 配网
**Repository Path**: jun-tian/esp32-web-distribution-network
## Basic Information
- **Project Name**: ESP32-8266 配网
- **Description**: web配网，smartconfig配网，BluFi蓝牙配网
- **Primary Language**: C++
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 9
- **Forks**: 1
- **Created**: 2022-03-22
- **Last Updated**: 2024-11-22
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ESP32-8266 配网
#### web配网
web配网-强制门户配网，连接开放Ap,登陆：192.168.4.1，设置SSID，password，连接网络，关闭配网AP。长按GPIO0 3秒以上清楚配网信息，重新配网。
设备内做了个小web服务器通过网页交换SSID和PWD。这个方式比较友好，不依赖外部app或小程序，保密性更好，产品可用性更好。（苹果等个别手机不能打开配网页面可直接浏览器登陆192.168.4.1）。
#### **操作方法：**
1. 连接开放Ap,
1. 强制门户配网，
1. 或登陆：192.168.4.1
1. 设置SSID，password，
1. 连接网络，
1. 关闭配网AP。
1. 长按GPIO0 3秒以上清除配网信息，
1. 重新配网
#### web配网代码
```
#include
#include
#include
#include //用于设备域名 MDNS.begin("esp32")
#include //用于esp_wifi_restore() 删除保存的wifi信息
//************************************WEB配网***********************************************
const byte DNS_PORT = 53; //设置DNS端口号
const int webPort = 80; //设置Web端口号
const int resetPin = 0; //设置重置按键引脚,用于删除WiFi信息
const int LED = 2; //设置LED引脚
const char* AP_SSID = "ESP32-4_1"; //设置AP热点名称
//const char* AP_PASS = ""; //设置AP热点密码
const char* HOST_NAME = "MY_ESP32"; //设置设备名
String scanNetworksID = ""; //用于储存扫描到的WiFi ID
int connectTimeOut_s = 15; //WiFi连接超时时间，单位秒
IPAddress apIP(192, 168, 4, 1); //设置AP的IP地址
String wifi_ssid = ""; //暂时存储wifi账号密码
String wifi_pass = ""; //暂时存储wifi账号密码
//定义根目录首页网页HTML源代码
#define ROOT_HTML "
WIFI Config by lwang
"
//定义成功页面HTML源代码
#define SUCCESS_HTML "
successd,wifi connecting...
Please close this page manually.
"
DNSServer dnsServer; //创建dnsServer实例
WebServer server(webPort); //开启web服务, 创建TCP SERVER,参数: 端口号,最大连接数
//初始化AP模式
void initSoftAP() {
WiFi.mode(WIFI_AP); //配置为AP模式
WiFi.softAPConfig(apIP, apIP, IPAddress(255, 255, 255, 0)); //设置AP热点IP和子网掩码
if (WiFi.softAP(AP_SSID)) { //开启AP热点,如需要密码则添加第二个参数
//打印相关信息
Serial.println("ESP-32S SoftAP is right.");
Serial.print("Soft-AP IP address = ");
Serial.println(WiFi.softAPIP());
Serial.println(String("MAC address = ") + WiFi.softAPmacAddress().c_str());
} else { //开启热点失败
Serial.println("WiFiAP Failed");
delay(1000);
Serial.println("restart now...");
ESP.restart(); //重启复位esp32
}
}
//初始化DNS服务器
void initDNS() {
//判断将所有地址映射到esp32的ip上是否成功
if (dnsServer.start(DNS_PORT, "*", apIP)) {
Serial.println("start dnsserver success.");
} else {
Serial.println("start dnsserver failed.");
}
}
//初始化WebServer
void initWebServer() {
//给设备设定域名esp32,完整的域名是esp32.local
if (MDNS.begin("esp32")) {
Serial.println("MDNS responder started");
}
//必须添加第二个参数HTTP_GET，以下面这种格式去写，否则无法强制门户
server.on("/", HTTP_GET, handleRoot); // 当浏览器请求服务器根目录(网站首页)时调用自定义函数handleRoot处理，设置主页回调函数，必须添加第二个参数HTTP_GET，否则无法强制门户
server.on("/configwifi", HTTP_POST, handleConfigWifi); // 当浏览器请求服务器/configwifi(表单字段)目录时调用自定义函数handleConfigWifi处理
server.onNotFound(handleNotFound); //当浏览器请求的网络资源无法在服务器找到时调用自定义函数handleNotFound处理
server.begin(); //启动TCP SERVER
Serial.println("WebServer started!");
}
//扫描WiFi
bool scanWiFi() {
Serial.println("scan start");
// 扫描附近WiFi
int n = WiFi.scanNetworks();
Serial.println("scan done");
if (n == 0) {
Serial.println("no networks found");
scanNetworksID = "no networks found";
return false;
} else {
Serial.print(n);
Serial.println(" networks found");
for (int i = 0; i < n; ++i) {
// Print SSID and RSSI for each network found
Serial.print(i + 1);
Serial.print(": ");
Serial.print(WiFi.SSID(i));
Serial.print(" (");
Serial.print(WiFi.RSSI(i));
Serial.print(")");
Serial.println((WiFi.encryptionType(i) == WIFI_AUTH_OPEN) ? " " : "*");
scanNetworksID += "" + WiFi.SSID(i) + "
";
delay(10);
}
return true;
}
}
void connectToWiFi(int timeOut_s) {
Serial.println("进入connectToWiFi()函数");
//设置为STA模式并连接WIFI
WiFi.mode(WIFI_STA);
WiFi.setAutoConnect(true);//设置自动连接
//用字符串成员函数c_str()生成一个const char*指针，指向以空字符终止的数组,即获取该字符串的指针。
if (wifi_ssid != "") {
Serial.println("用web配置信息连接.");
WiFi.begin(wifi_ssid.c_str(), wifi_pass.c_str());
wifi_ssid = "";
wifi_pass = "";
} else {
Serial.println("用nvs保存的信息连接.");
WiFi.begin();//连接上一次连接成功的wifi
}
int Connect_time = 0; //用于连接计时，如果长时间连接不成功，复位设备
while (WiFi.status() != WL_CONNECTED) { //等待WIFI连接成功
Serial.print(".");
digitalWrite(LED, !digitalRead(LED));
delay(500);
Connect_time ++;
if (Connect_time > 2 * timeOut_s) { //长时间连接不上，重新进入配网页面
digitalWrite(LED, LOW);
Serial.println("");
Serial.println("WIFI autoconnect fail, start AP for webconfig now...");
wifiConfig(); //转到网页端手动配置wifi
return; //跳出 防止无限初始化
}
}
if (WiFi.status() == WL_CONNECTED) {
Serial.println("WIFI connect Success");
Serial.printf("SSID:%s", WiFi.SSID().c_str());
Serial.printf(", PSW:%s\r\n", WiFi.psk().c_str());
Serial.print("LocalIP:");
Serial.print(WiFi.localIP());
Serial.print(" ,GateIP:");
Serial.println(WiFi.gatewayIP());
Serial.print("WIFI status is:");
Serial.print(WiFi.status());
digitalWrite(LED, HIGH);
server.stop();
}
}
//用于配置WiFi
void wifiConfig() {
initSoftAP();
initDNS();
initWebServer();
scanWiFi();
}
//处理网站根目录“/”(首页)的访问请求,将显示配置wifi的HTML页面
void handleRoot() {
if (server.hasArg("selectSSID")) {
server.send(200, "text/html", ROOT_HTML + scanNetworksID + "");
} else {
server.send(200, "text/html", ROOT_HTML + scanNetworksID + "