ESP8266 Arduino开发之路(12)— HTTP网络服务器
一、前言
超文本传输协议(Hyper Text Transfer Protocol,HTTP)是一个简单的请求-响应协议,它通常运行在TCP之上,它指定了客户端可能发送给服务器什么样的消息以及得到什么样的响应,,我们使用浏览器打开的网页使用的就是HTTP协议。接下来我们会参数在ESP8266-NodeMCU上建立一个HTTP网络服务器,然后通过浏览器来访问它。
参考文章:建立基本网络服务器
通过网络服务实现NodeMCU开发板基本控制
二、编写代码
接下来我们编写代码实现网络服务器的功能,其中需要用到ESP8266WebServer.h
头文件及其库函数。
/*
ESP8266-NodeMCU作为HttpServer服务器
*/
#include <ESP8266WiFi.h> // 本程序使用ESP8266WiFi库
#include <ESP8266WebServer.h> // web服务器通信库需要使用
/* 1. 设置Wifi接入信息 */
const char* ssid = "SixLab"; // 需要连接到的WiFi名
const char* password = "sixlab123"; // 连接的WiFi密码
/* 2. 创建一个web服务器对象,使用80端口,HTTP网络服务器标准端口号即为80 */
ESP8266WebServer esp8266_server(80);
/* 3. 处理访问网站根目录“/”的访问请求 */
void handleRoot() {
esp8266_server.send(200, "text/plain", "Hello from ESP8266"); // NodeMCU将调用此函数。
}
/* 4. 设置处理404情况的函数'handleNotFound' */
void handleNotFound(){ // 当浏览器请求的网络资源无法在服务器找到时,
esp8266_server.send(404, "text/plain", "404: Not found"); // NodeMCU将调用此函数。
}
void setup() {
/* 1. 初始化串口通讯波特率为115200*/
Serial.begin(115200);
/* 2. 开启wifi连接,连接成功后打印IP地址 */
WiFi.mode(WIFI_STA); // 设置Wifi工作模式为STA,默认为AP+STA模式
WiFi.begin(ssid, password); // 通过wifi名和密码连接到Wifi
Serial.print("\r\nConnecting to "); // 串口监视器输出网络连接信息
Serial.print(ssid); Serial.println(" ..."); // 显示NodeMCU正在尝试WiFi连接
int i = 0; // 检查WiFi是否连接成功
while (WiFi.status() != WL_CONNECTED) // WiFi.status()函数的返回值是由NodeMCU的WiFi连接状态所决定的。
{ // 如果WiFi连接成功则返回值为WL_CONNECTED
delay(1000); // 此处通过While循环让NodeMCU每隔一秒钟检查一次WiFi.status()函数返回值
Serial.print("waiting for ");
Serial.print(i++); Serial.println("s...");
}
Serial.println(""); // WiFi连接成功后
Serial.println("WiFi connected!"); // NodeMCU将通过串口监视器输出"连接成功"信息。
Serial.print("IP address: "); // 同时还将输出NodeMCU的IP地址。这一功能是通过调用
Serial.println(WiFi.localIP()); // WiFi.localIP()函数来实现的。该函数的返回值即NodeMCU的IP地址。
/* 3. 开启http网络服务器功能 */
esp8266_server.begin(); // 启动http网络服务器
esp8266_server.on("/", handleRoot); // 设置请求根目录时的处理函数函数
esp8266_server.onNotFound(handleNotFound); // 设置无法响应时的处理函数
Serial.println("HTTP esp8266_server started");// 告知用户ESP8266网络服务功能已经启动
}
void loop() {
esp8266_server.handleClient(); // 处理http访问,需要一直运行
}
三、运行
编译上传运行,可以看到串口打印如下所示,我们可以看到,ESP8266已经获取到IP地址且启动了HTTP服务器。
我们打开浏览器,在地址栏中输入IP地址:192.168.3.59
,可以看到网页已经获取成功且显示出来了
然后我们打开手机浏览器也可以访问
四、显示网页
刚才我们可以看到,我们收到的只是一串字符串,接下来我们将编写代码显示一个网页,
/*
* ESP8266-NodeMCU作为HttpServer服务器
*/
#include <ESP8266WiFi.h> // 本程序使用ESP8266WiFi库
#include <ESP8266WebServer.h> // web服务器通信库需要使用
/* 1. 设置Wifi接入信息 */
const char* ssid = "SixLab"; // 需要连接到的WiFi名
const char* password = "sixlab123"; // 连接的WiFi密码
/* 2. 创建一个web服务器对象,使用80端口,HTTP网络服务器标准端口号即为80 */
ESP8266WebServer esp8266_server(80);
/* 3. 处理访问网站根目录“/”的访问请求 */
void handleRoot() {
String htmlCode = "<!DOCTYPE html> <html>\n";
htmlCode +="<head><meta charset=\"UTF-8\"/>\n";
htmlCode +="<title>ESP8266 Butoon Ctrl</title>\n";
htmlCode +="</head> <body>\n";
htmlCode +="<h2 align=\"center\">esp8266控制开关</h2>";
htmlCode +="<p><form action=\"/LED1_ON\" method=\"POST\" align=\"center\"><input type=\"submit\" value=\"打开前台灯\"></form></p>\n";
htmlCode +="<p><form action=\"/LED2_ON\" method=\"POST\" align=\"center\"><input type=\"submit\" value=\"打开大厅灯\"></form></p>\n";
htmlCode +="<p><form action=\"/LED3_ON\" method=\"POST\" align=\"center\"><input type=\"submit\" value=\"打开走廊灯\"></form></p>\n";
htmlCode +="</body>\n";
esp8266_server.send(200, "text/html", htmlCode); // NodeMCU将调用此函数。
}
/* 4. 设置处理404情况的函数'handleNotFound' */
void handleNotFound(){ // 当浏览器请求的网络资源无法在服务器找到时,
esp8266_server.send(404, "text/plain", "404: Not found"); // NodeMCU将调用此函数。
}
void setup() {
/* 1. 初始化串口通讯波特率为115200*/
Serial.begin(115200);
Serial.println("");
/* 2. 开启wifi连接,连接成功后打印IP地址 */
WiFi.mode(WIFI_STA); // 设置Wifi工作模式为STA,默认为AP+STA模式
WiFi.begin(ssid, password); // 通过wifi名和密码连接到Wifi
Serial.print("\r\nConnecting to "); // 串口监视器输出网络连接信息
Serial.print(ssid); Serial.println(" ..."); // 显示NodeMCU正在尝试WiFi连接
int i = 0; // 检查WiFi是否连接成功
while (WiFi.status() != WL_CONNECTED) // WiFi.status()函数的返回值是由NodeMCU的WiFi连接状态所决定的。
{ // 如果WiFi连接成功则返回值为WL_CONNECTED
delay(1000); // 此处通过While循环让NodeMCU每隔一秒钟检查一次WiFi.status()函数返回值
Serial.print("waiting for ");
Serial.print(i++); Serial.println("s...");
}
Serial.println(""); // WiFi连接成功后
Serial.println("WiFi connected!"); // NodeMCU将通过串口监视器输出"连接成功"信息。
Serial.print("IP address: "); // 同时还将输出NodeMCU的IP地址。这一功能是通过调用
Serial.println(WiFi.localIP()); // WiFi.localIP()函数来实现的。该函数的返回值即NodeMCU的IP地址。
/* 3. 开启http网络服务器功能 */
esp8266_server.begin(); // 启动http网络服务器
esp8266_server.on("/", handleRoot); // 设置请求根目录时的处理函数函数
esp8266_server.onNotFound(handleNotFound); // 设置无法响应时的处理函数
Serial.println("HTTP esp8266_server started");// 告知用户ESP8266网络服务功能已经启动
}
void loop() {
esp8266_server.handleClient(); // 处理http访问,需要一直运行
}
我们在其中将esp8266_server.send()
这个函数进行了修改,其中第二个参数"text/html"
表示 我们发送的是一个html格式文件,而不是字符串
esp8266_server.send(200, "text/html", htmlCode); // NodeMCU将调用此函数。
因为htmlCode
是我们用字符串拼接出来的,所以其中有许多转义字符\
,将转义字符去掉后如下html原文如下所示,
<!DOCTYPE html> <html>
<head><meta charset=\"UTF-8\"/>
<title>ESP8266 Butoon Ctrl</title>
</head> <body>
<h1 align="center">esp8266控制开关</h1>
<p><form action="/LED1_ON" method="POST" align="center"><input type="submit" value="打开前台灯"></form> </p>
<p><form action="/LED2_ON" method="POST" align="center"><input type="submit" value="打开大厅灯"></form> </P>
<p><form action="/LED3_ON" method="POST" align="center"><input type="submit" value="打开走廊灯"></form> </P>
</body>
我们编译上传运行后通过浏览器访问如下所示