【花雕学编程】Arduino动手做（246）---ESP8266 实现网络控制

  【花雕学编程】239种传感器执行器系列实验（资料代码+仿真编程+图形编程）
   实验二百四十六：ESP8266串口wifi模块 NodeMCU Lua V3物联网开发板 CH340
   实验项目之十七：通过网络服务实现ESP8266开发板基本控制

实验开源代码

/*
  【花雕学编程】239种传感器执行器系列实验（资料代码+仿真编程+图形编程）
   实验二百四十六：ESP8266串口wifi模块 NodeMCU Lua V3物联网开发板 CH340
   实验项目之十七：通过网络服务实现ESP8266开发板基本控制
*/

#include <ESP8266WiFi.h>        // 本程序使用 ESP8266WiFi库
#include <ESP8266WiFiMulti.h>   //  ESP8266WiFiMulti库
#include <ESP8266WebServer.h>   //  ESP8266WebServer库
 
ESP8266WiFiMulti wifiMulti;     // 建立ESP8266WiFiMulti对象,对象名称是 'wifiMulti'
 
ESP8266WebServer esp8266_server(80);// 建立网络服务器对象，该对象用于响应HTTP请求。监听端口（80）
 
void setup(void){
  Serial.begin(9600);   // 启动串口通讯
  Serial.println(" ");
  Serial.println(" ");
  pinMode(LED_BUILTIN, OUTPUT); //设置内置LED引脚为输出模式以便控制LED
  
  wifiMulti.addAP("zhz", "z156721"); // 将需要连接的一系列WiFi ID和密码输入这里
  wifiMulti.addAP("zhz3", "z156721"); // ESP8266-NodeMCU再启动后会扫描当前网络
  wifiMulti.addAP("zhz3_5G", "z156721"); // 环境查找是否有这里列出的WiFi ID。如果有
  Serial.println("Connecting ...");       // 则尝试使用此处存储的密码进行连接。
  
  int i = 0;                                 
  while (wifiMulti.run() != WL_CONNECTED) {  // 此处的wifiMulti.run()是重点。通过wifiMulti.run()，NodeMCU将会在当前
    delay(1000);                             // 环境中搜索addAP函数所存储的WiFi。如果搜到多个存储的WiFi那么NodeMCU
    Serial.print(i++); Serial.print(' ');    // 将会连接信号最强的那一个WiFi信号。
  }                                          // 一旦连接WiFI成功，wifiMulti.run()将会返回“WL_CONNECTED”。这也是
                                             // 此处while循环判断是否跳出循环的条件。
  
  // WiFi连接成功后将通过串口监视器输出连接成功信息 
  Serial.println('\n');
  Serial.print("Connected to ");
  Serial.println(WiFi.SSID());              // 通过串口监视器输出连接的WiFi名称
  Serial.print("IP address:\t");
  Serial.println(WiFi.localIP());           // 通过串口监视器输出ESP8266-NodeMCU的IP
 
  esp8266_server.begin();                           // 启动网站服务
  esp8266_server.on("/", HTTP_GET, handleRoot);     // 设置服务器根目录即'/'的函数'handleRoot'
  esp8266_server.on("/LED", HTTP_POST, handleLED);  // 设置处理LED控制请求的函数'handleLED'
  esp8266_server.onNotFound(handleNotFound);        // 设置处理404情况的函数'handleNotFound'
 
  Serial.println("HTTP esp8266_server started");//  告知用户ESP8266网络服务功能已经启动
}
 
void loop(void){
  esp8266_server.handleClient();                     // 检查http服务器访问
}
 
/*设置服务器根目录即'/'的函数'handleRoot'
  该函数的作用是每当有客户端访问NodeMCU服务器根目录时，
  NodeMCU都会向访问设备发送 HTTP 状态 200 (Ok) 这是send函数的第一个参数。
  同时NodeMCU还会向浏览器发送HTML代码，以下示例中send函数中第三个参数，
  也就是双引号中的内容就是NodeMCU发送的HTML代码。该代码可在网页中产生LED控制按钮。 
  当用户按下按钮时，浏览器将会向NodeMCU的/LED页面发送HTTP请求，请求方式为POST。
  NodeMCU接收到此请求后将会执行handleLED函数内容*/
void handleRoot() {       
  esp8266_server.send(200, "text/html", "<form action="/LED" method="POST"><input type="submit" value="Toggle LED"></form>");
}
 
//处理LED控制请求的函数'handleLED'
void handleLED() {                          
  digitalWrite(LED_BUILTIN,!digitalRead(LED_BUILTIN));// 改变LED的点亮或者熄灭状态
  esp8266_server.sendHeader("Location","/");          // 跳转回页面根目录
  esp8266_server.send(303);                           // 发送Http相应代码303 跳转  
}
 
// 设置处理404情况的函数'handleNotFound'
void handleNotFound(){
  esp8266_server.send(404, "text/plain", "404: Not found"); // 发送 HTTP 状态 404 (未找到页面) 并向浏览器发送文字 "404: Not found"
}
复制代码

代码解读
1、包含库：
#include <ESP8266WiFi.h>：包含ESP8266WiFi库，用于处理WiFi连接。
#include <ESP8266WiFiMulti.h>：包含ESP8266WiFiMulti库，用于管理多个WiFi网络。
#include <ESP8266WebServer.h>：包含ESP8266WebServer库，用于创建和管理HTTP服务器。

2、对象定义：
ESP8266WiFiMulti wifiMulti;：创建一个ESP8266WiFiMulti对象，用于管理多个WiFi网络。
ESP8266WebServer esp8266_server(80);：创建一个ESP8266WebServer对象，监听80端口，用于处理HTTP请求。

3、初始化和连接WiFi：
Serial.begin(9600);：初始化串口通信，波特率为9600。
pinMode(LED_BUILTIN, OUTPUT);：设置内置LED引脚为输出模式。
wifiMulti.addAP("zhz3", "z156721"); ：添加需要连接的WiFi网络及其密码。
while (wifiMulti.run() != WL_CONNECTED) { ... }：尝试连接到列表中的WiFi网络，连接成功后打印连接信息。

4、启动HTTP服务器：
esp8266_server.begin();：启动HTTP服务器。
esp8266_server.on("/", HTTP_GET, handleRoot);：设置根目录（"/"）的处理函数handleRoot。
esp8266_server.on("/LED", HTTP_POST, handleLED);：设置处理LED控制请求的函数handleLED。
esp8266_server.onNotFound(handleNotFound);：设置处理404错误的函数handleNotFound。

5、主循环：
esp8266_server.handleClient();：处理HTTP客户端请求。

6、处理函数：
handleRoot：处理根目录请求，发送一个包含LED控制按钮的HTML表单。
handleLED：处理LED控制请求，切换LED状态并重定向回根目录。
handleNotFound：处理404错误，发送404状态码和错误信息。

7、运行结果
串口输出：
连接WiFi的过程和结果。
连接成功后，输出连接的WiFi名称和ESP8266的IP地址。
服务器启动信息。
浏览器访问：
访问ESP8266的IP地址，会看到一个LED控制按钮。
点击按钮，LED状态会切换，并且浏览器会重定向回根目录。

实验串口返回情况

在手机端打开浏览器，输入IP地址：192.168.28.40，点击按钮可以控制板载LED的亮灭