ESP8266 发起 HTTP 请求

发表于 2020-08-29 分类于技术阅读次数： Disqus：

笔者使用的是刷了 AT 固件的 ESP8266。默认情况下，串口波特率为 115200，换行符为 NL 和 CR。可以通过 AT+GMR 命令查看固件信息：

常见的 AT 命令可以参考以下文章：
ESP8266_AT Wiki
ESP8266 - AT Command Reference

本文将介绍通过 ESP8266 发起 HTTP 请求的方法。首先将 ESP8266 重置，然后设置为 AP + Station 模式。

1
2
3

AT+RST
AT+CWMODE=3
AT+CWLAP

最后一个 AT+CWLAP 命令将搜索附近的 Wi-Fi 并显示出来。
随后，使用 AT+CWJAP 命令，指定 SSID 和密码用于连接 Wi-Fi：

1	AT+CWJAP="ssid","pwd"

将 ssid 和 pwd 根据情况替换。如果连接成功，将返回

1 2	WIFI CONNECTED WIFI GOT IP

接下来就可以发起请求了。我们以 World Time API 为例，这个网站可以根据客户端 IP 获得时间。

发起请求使用 AT+CIPSTART 命令：

1	AT+CIPSTART="TCP","worldtimeapi.org",80

然后用 AT+CIPSEND 指定发送的内容长度。这一步非常关键，需要了解 HTTP 请求报文的格式。请求报文由 4 部分组成：请求行、请求头部、空行、请求数据；换行符为 \r\n。例如，对 World Time API 的请求是这样的：

1
2
3

GET /api/ip.txt HTTP/1.1
Host: worldtimeapi.org

注意最后的空行，它用来标识请求头部的数据已结束。这三行（加上换行符）一共是 52 个字符，因此先输入以下命令：

1	AT+CIPSEND=52

ESP8266 会返回一个 >，提示可以接收请求报文了。然后再输入前面给出的内容：

1
2
3

GET /api/ip.txt HTTP/1.1
Host: worldtimeapi.org

这里没有回显，每输入一行要按一下回车。如果一切正常，HTTP 响应的内容会被打印出来：

>
Recv 52 bytes

SEND OK

+IPD,906:HTTP/1.1 200 OK
Connection: keep-alive
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Access-Control-Expose-Headers: 
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 309
Content-Type: text/plain; charset=utf-8
Cross-Origin-Window-Policy: deny
Date: Thu, 03 Sep 2020 03:51:48 GMT
Server: Cowboy
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Frame-Options: SAMEORIGIN
X-Permitted-Cross-Domain-Policies: none
X-Request-Id: f747d52b-09b0-401c-ae5e-5a36c1489b57
X-Runtime: 1ms
X-Xss-Protection: 1; mode=block
Via: 1.1 vegur

abbreviation: CST
client_ip: 124.64.16.34
datetime: 2020-09-03T11:51:48.793540+08:00
day_of_week: 4
day_of_year: 247
dst: false
dst_from: 
dst_offset: 0
dst_until: 
raw_offset: 28800
timezone: Asia/Shanghai
unixtime: 1599105108
utc_datetime: 2020-09-03T03:51:48.793540+00:00
utc_offset: +08:00
week_number: 36

最后使用 AT+CIPCLOSE 命令结束请求即可。

参考文章：HTTP 概述