1. 从零开始：为什么选择ESP8266-01S做网络请求？

如果你手头正好有一块ESP8266-01S模块，想让它从互联网上获取点数据，比如当前的时间戳，那你算是找对地方了。这可能是很多嵌入式爱好者或物联网项目开发者遇到的第一个“联网”实操。ESP8266-01S以其极小的体积和内置的Wi-Fi与TCP/IP协议栈，成为了连接物理世界与数字世界的经典桥梁。但拿到这个指甲盖大小的模块，看着它那寥寥几个引脚，很多人会懵：怎么让它上网？怎么发请求？AT指令又是什么鬼？

简单来说，你可以把ESP8266-01S想象成一个自带Wi-Fi功能的“对讲机”。你（单片机，比如Arduino Uno）不是直接去操作复杂的网络协议，而是通过一种简单的“口令”——也就是AT指令——来指挥这个“对讲机”去连接Wi-Fi、建立网络连接、发送和接收数据。AT就是“Attention”的缩写，你发指令，它回应，就这么简单。我们今天要做的，就是指挥它向一个特定的网络服务器发起一个HTTP GET请求，获取一个时间戳回来。

为什么是时间戳？因为它在物联网项目里太有用了。你的设备需要知道现在几点，才能定时执行任务、给采集的数据打上时间标签，或者与其他设备同步。直接从网络获取时间，比在设备里维护一个实时时钟（RTC）模块要简单、精准得多，还不用担心断电后时间丢失。

网上教程很多，但很多要么步骤跳跃，要么对关键的细节和背后的“为什么”语焉不详，导致新手照着做也容易卡住。这篇文章，我就以一个过来人的身份，带你完整走一遍流程，不仅告诉你每一步怎么做，更会解释清楚每一步为什么要这么做，以及那些我踩过的、教程里很少写的坑。

2. 硬件连接与通信基础：别在第一步就翻车

在敲代码发指令之前，最基础也最容易出错的一步，就是硬件连接。ESP8266-01S模块引脚很少，但每个都至关重要。

2.1 引脚定义与核心接线

ESP8266-01S通常有8个引脚（有些版本可能略有不同）：

• VCC： 供电脚。至关重要：必须接3.3V！接5V大概率会瞬间烧毁模块。
• GND： 接地。
• CH_PD (或 EN)： 使能脚。高电平（接3.3V）模块正常工作；低电平模块进入休眠。我们通常直接接VCC（3.3V）使其常启。
• GPIO0： 启动模式选择脚。它决定了模块是运行用户程序还是进入固件烧录/AT指令模式。
  • 接GND（低电平）上电：进入固件烧录模式或UART下载模式。如果你想刷写新的AT固件或NodeMCU固件，需要这个状态。
  • 悬空或接3.3V（高电平）上电：进入正常工作模式。我们使用AT指令与它通信，就需要它处于这个模式。对于大多数出厂预烧了AT固件的模块，我们通常让GPIO0悬空即可。
• GPIO2： 内部已上拉，通常悬空即可。在某些早期固件中，它也可能影响启动，但现代AT固件下，悬空一般没问题。
• RST： 复位脚，低电平有效。平时接3.3V（通过一个10K电阻上拉更稳妥），需要复位时短暂接GND。
• RX： 串口接收脚，接你的MCU或USB转TTL的TX脚。
• TX： 串口发送脚，接你的MCU或USB转TTL的RX脚。

最简连接方案（使用USB转TTL工具直接调试）：

1. USB转TTL模块的3.3V—> ESP8266-01S的VCC和CH_PD。
2. USB转TTL模块的GND—> ESP8266-01S的GND。
3. USB转TTL模块的TX—> ESP8266-01S的RX。
4. USB转TTL模块的RX—> ESP8266-01S的TX。
5. ESP8266-01S的GPIO0—>悬空（确保上电前是悬空状态）。
6. ESP8266-01S的RST—> 可以通过一个10K电阻接到3.3V，或者暂时悬空，需要复位时手动用杜邦线碰一下GND。

注意：务必确认你的USB转TTL模块支持并输出的是3.3V电平！市面上很多模块的VCC引脚默认是5V，需要跳线帽或开关切换到3.3V。用错电压是烧模块的头号杀手。

2.2 串口通信参数：对话的暗号

连接好硬件，你还需要在电脑上用一个串口工具（如Arduino IDE的串口监视器、Putty、XCOM等）和ESP8266对话。对话双方必须使用相同的“语速”和“格式”，这就是串口参数：

• 波特率：115200。这是ESP8266 AT固件最常用的默认波特率。如果通信失败，可以尝试9600、74880等其他波特率，但115200是首选。
• 数据位：8
• 停止位：1
• 校验位：None
• 流控制：None

在串口工具里正确设置这些参数，打开串口，给ESP8266上电。如果一切正常，你可能会在串口监视器里看到一堆乱码或者像“ready”这样的启动信息。先别管，我们主动发起对话。

2.3 发送第一个AT指令：测试连通性

在串口工具的发送框里，输入：

AT

然后记得勾选“发送新行”（或“加回车换行”）。因为AT指令必须以回车换行（\r\n）结尾。点击发送。

如果你看到模块回复：

OK

那么恭喜你，硬件连接和基本通信成功了！模块已经准备好接受你的命令。如果没回复，请按以下顺序排查：

1. 检查供电：VCC是不是3.3V？电流是否足够？ESP8266启动瞬间峰值电流可能超过200mA，劣质USB转TTL或电脑USB口可能供电不足，建议使用外部3.3V电源或带独立供电的USB Hub。
2. 检查接线：TX-RX是否交叉连接？这是最容易接反的。
3. 检查波特率：尝试更换其他波特率（9600, 57600, 74880）。
4. 检查启动模式：确认GPIO0在上电时是悬空或高电平状态。
5. 检查固件：模块可能没有AT固件。需要先刷固件，这又是另一个话题了。

3. AT指令精讲：从连Wi-Fi到发HTTP请求

通信建立后，我们就可以按步骤指挥ESP8266了。整个过程就像给一个智能终端下达一系列命令。

3.1 设置工作模式：是当热点还是连别人？

ESP8266有三种工作模式：

• 模式1 (Station模式)：像手机一样，连接到一个现有的Wi-Fi路由器。
• 模式2 (AP模式)：自己作为一个Wi-Fi热点，让别的设备连接它。
• 模式3 (Station+AP模式)：两者同时兼备。

我们需要它连接家里的路由器上网，所以设为Station模式。发送指令：

AT+CWMODE=1

期待回复：OK。如果想查询当前模式，可以发AT+CWMODE?。

3.2 连接Wi-Fi：输入账号密码

连接你的无线网络，指令格式为：

AT+CWJAP="你的Wi-Fi名称","你的Wi-Fi密码"

例如：

AT+CWJAP="MyHomeWiFi","MyPassword123"

发送后，等待几秒到十几秒。成功连接会回复WIFI CONNECTED和WIFI GOT IP，最后是OK。如果失败，可能会回复FAIL，常见原因有密码错误、信号太弱、路由器不兼容（尽量使用2.4GHz网络）等。

实操心得：如果网络名称或密码中包含特殊字符（如逗号、引号），需要进行转义，比较麻烦。建议在测试阶段使用纯字母数字的简单密码。另外，这个指令是阻塞的，在连接期间模块不会响应其他AT指令。

3.3 查询网络连接状态

连接成功后，可以查询一下获得的IP地址：

AT+CIFSR

它会回复类似+CIFSR:STAIP,"192.168.1.100"的信息，这证明它已经从路由器那里拿到了一个局域网IP，具备了网络通信的基础。

3.4 建立TCP连接：打通到服务器的路

HTTP协议是基于TCP的。在发起HTTP请求前，我们需要先和服务器建立一个TCP连接。这需要知道目标服务器的IP地址（或域名）和端口号。

我们以获取时间戳为例，需要一个提供时间戳API的服务器。一个常用且免费的公共API是httpbin.org的/get端点，它会返回请求的详细信息，其中包含时间戳。但更直接的时间戳服务，我们可以用worldtimeapi.org。

首先，我们需要解析出服务器的域名和端口。对于http://worldtimeapi.org/api/timezone/Asia/Shanghai这个URL：

• 协议：http
• 主机名（域名）：worldtimeapi.org
• 端口：HTTP默认端口是80。如果URL是https，默认端口是443。

建立TCP连接的AT指令是：

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

指令参数依次是：连接类型、远程主机、远程端口。 发送后，等待回复CONNECT和OK。如果失败，可能回复ALREADY CONNECTED（已有连接）或各种错误（如DNS解析失败、网络不通等）。

为什么是TCP而不是直接HTTP？AT指令集把网络通信分层了。CIPSTART负责最底层的TCP/UDP连接建立。HTTP的请求和响应数据，是在这个TCP连接之上，通过CIPSEND指令发送的“载荷”。这种设计让指令集更通用，可以支持其他基于TCP的协议。

3.5 发送HTTP GET请求：构造并发送数据包

TCP连接建立后，我们就可以通过这个“管道”发送HTTP请求数据了。首先，我们要告诉ESP8266准备发送多长的数据：

AT+CIPSEND=100

这里的数字100是你预估的将要发送的HTTP请求字符串的长度，可以稍微给大一点。发送后，模块会回复>符号，提示你可以开始输入数据了。

此时，你需要输入完整的HTTP请求报文。一个最简单的GET请求如下：

GET /api/timezone/Asia/Shanghai HTTP/1.1 Host: worldtimeapi.org Connection: close

注意：

1. 第一行是请求行：方法GET，路径/api/timezone/Asia/Shanghai，协议版本HTTP/1.1。
2. 第二行是Host头，对于HTTP/1.1是必须的，告诉服务器你要访问哪个主机。
3. 第三行Connection: close告诉服务器，发完这次响应后就可以关闭TCP连接了，这样比较省事。
4. 最后必须有一个空行（也就是连续两个回车换行\r\n\r\n），这是HTTP协议规定的，用于标识请求头结束。在串口工具里，你输入完Connection: close后，需要再按两下回车（确保发送了\r\n\r\n）。

所以，在串口工具看到>后，你实际发送的完整字符序列是（\r\n代表回车换行）：

GET /api/timezone/Asia/Shanghai HTTP/1.1\r\nHost: worldtimeapi.org\r\nConnection: close\r\n\r\n

发送后，模块会开始传输数据，并最终回复SEND OK。

3.6 接收与解析响应：从数据流中提取时间戳

发送请求后，服务器返回的HTTP响应数据会通过串口打印出来。你会看到类似下面的一大段信息：

+IPD,xxx:HTTP/1.1 200 OK Date: Mon, 01 Jan 2024 00:00:00 GMT Content-Type: application/json Content-Length: 200 Connection: close {"abbreviation":"CST","client_ip":"xxx.xxx.xxx.xxx","datetime":"2024-01-01T08:00:00.000000+08:00","day_of_week":1,"day_of_year":1,"dst":false,"dst_from":null,"dst_offset":0,"dst_until":null,"raw_offset":28800,"timezone":"Asia/Shanghai","unixtime":1704067200,"utc_datetime":"2024-01-01T00:00:00.000000+00:00","utc_offset":"+08:00","week_number":1}

+IPD是ESP8266提示有网络数据到来的前缀，后面的xxx是这包数据的长度。紧接着就是HTTP响应头和正文（JSON格式）。

我们需要的信息是unixtime字段的值，也就是1704067200，这就是Unix时间戳（自1970年1月1日以来的秒数）。

如何解析？如果你只是手动调试，用眼睛找就行。但如果要用单片机（如Arduino）自动处理，就需要编写程序来解析这个字符串：先找到+IPD前缀，然后跳过HTTP头（找到第一个\r\n\r\n之后），再在JSON正文中查找"unixtime":这个模式，然后提取后面的数字。

3.7 关闭连接：善后工作

完成数据接收后，最好主动关闭TCP连接以释放资源：

AT+CIPCLOSE

回复CLOSED和OK。

你也可以不关，等服务器因为Connection: close而关闭，或者发送新的AT+CIPSTART指令建立新连接时，旧连接会被自动替代。但显式关闭是个好习惯。

4. 完整流程串讲与自动化脚本示例

上面我们把步骤拆解了，现在我们把它们串起来，形成一个完整的、可以一次性执行的脚本。同时，我们也会探讨如何将这个手动过程，用Arduino等单片机自动化。

4.1 手动串口调试完整指令序列

在串口工具中，你可以依次发送以下指令（每条指令后等待OK或相应回复再发下一条）：

AT AT+CWMODE=1 AT+CWJAP="你的SSID","你的密码" AT+CIFSR AT+CIPSTART="TCP","worldtimeapi.org",80 AT+CIPSEND=100 > GET /api/timezone/Asia/Shanghai HTTP/1.1 Host: worldtimeapi.org Connection: close (等待响应数据...) AT+CIPCLOSE

这就是一个完整的获取时间戳的AT指令流程。

4.2 使用Arduino实现自动化

手动操作只是学习和调试，真正项目中我们需要单片机自动完成这一切。下面是一个基于Arduino IDE的示例代码框架。这个代码会连接Wi-Fi，获取时间戳，并通过串口打印出来。

#include <SoftwareSerial.h> // 定义软串口引脚，连接ESP8266 SoftwareSerial esp8266(2, 3); // RX, TX (连接ESP8266的TX, RX) const char* ssid = "你的Wi-Fi名称"; const char* password = "你的Wi-Fi密码"; const char* host = "worldtimeapi.org"; const int httpPort = 80; void setup() { Serial.begin(115200); // 用于调试输出 esp8266.begin(115200); // ESP8266默认波特率 delay(1000); Serial.println("Initializing..."); // 1. 测试AT指令 sendCommand("AT", 2000); // 2. 设置模式 sendCommand("AT+CWMODE=1", 2000); // 3. 连接Wi-Fi String cmd = "AT+CWJAP=\""; cmd += ssid; cmd += "\",\""; cmd += password; cmd += "\""; sendCommand(cmd, 10000); // 连接Wi-Fi需要较长时间 // 4. 查询IP (可选) sendCommand("AT+CIFSR", 2000); } void loop() { // 5. 建立TCP连接 String startCmd = "AT+CIPSTART=\"TCP\",\""; startCmd += host; startCmd += "\","; startCmd += httpPort; sendCommand(startCmd, 5000); // 6. 准备发送HTTP请求 String request = "GET /api/timezone/Asia/Shanghai HTTP/1.1\r\n"; request += "Host: "; request += host; request += "\r\n"; request += "Connection: close\r\n\r\n"; String sendCmd = "AT+CIPSEND="; sendCmd += String(request.length()); sendCommand(sendCmd, 2000); // 等待 ‘>’ 提示符 // 7. 发送请求数据 esp8266.print(request); // 注意这里是print，不是sendCommand delay(100); // 给模块一点时间处理 // 8. 等待并解析响应 unsigned long timeout = millis(); String response = ""; while (millis() - timeout < 5000) { // 等待5秒 while (esp8266.available()) { char c = esp8266.read(); response += c; timeout = millis(); // 收到数据就刷新超时时间 } } Serial.println("=== Response ==="); Serial.println(response); Serial.println("=== End ==="); // 9. 从response中解析unixtime (这里需要简单的字符串查找) int jsonStart = response.indexOf("\r\n\r\n"); if (jsonStart != -1) { String json = response.substring(jsonStart + 4); int tsIndex = json.indexOf("\"unixtime\":"); if (tsIndex != -1) { int start = tsIndex + 11; // 跳过 "\"unixtime\":" int end = json.indexOf(",", start); if (end == -1) end = json.indexOf("}", start); String timestampStr = json.substring(start, end); long timestamp = timestampStr.toInt(); Serial.print("Parsed Unix Timestamp: "); Serial.println(timestamp); // 这里你可以将timestamp用于你的项目逻辑 } } // 10. 关闭连接 sendCommand("AT+CIPCLOSE", 2000); Serial.println("Wait for next query..."); delay(30000); // 等待30秒后再次执行 } // 发送AT指令并打印结果的辅助函数 void sendCommand(String cmd, int waitTime) { Serial.print("Send: "); Serial.println(cmd); esp8266.println(cmd); // 使用println自动添加\r\n delay(waitTime); // 等待模块响应 Serial.print("Recv: "); while (esp8266.available()) { char c = esp8266.read(); Serial.write(c); } Serial.println(); }

代码关键点解析：

1. SoftwareSerial：因为Arduino Uno通常只有一个硬件串口（Serial）用于电脑调试，我们需要用软串口与ESP8266通信。
2. sendCommand函数：封装了发送指令、等待和打印响应的过程，便于调试。实际项目中，你可能需要更复杂的响应状态判断（比如检查返回的是OK还是ERROR）。
3. 响应解析：response.indexOf("\r\n\r\n")用于定位HTTP响应正文的开始。然后查找"unixtime":并提取其后的数字。这是一个非常简单的解析，对于稳定的API够用。对于复杂的JSON，建议使用ArduinoJson库。
4. 超时处理：while (millis() - timeout < 5000)是一个简单的超时机制，防止因为网络问题卡死。
5. esp8266.print(request)：在发送AT+CIPSEND并收到>提示后，我们直接用print发送HTTP请求字符串，而不是再用sendCommand（因为sendCommand会等待并打印响应，而此刻我们正在发送数据，不是接收指令响应）。

5. 进阶话题与深度避坑指南

当你成功跑通基础流程后，可能会遇到一些更复杂的情况或想优化你的项目。这部分分享一些进阶经验和常见深坑。

5.1 处理更复杂的API与HTTPS请求

上面的例子是HTTP。如今很多API都要求使用HTTPS（端口443）。ESP8266的AT固件是否支持HTTPS取决于固件版本。较新的固件（如安信可提供的V1.7.x及以上）支持AT+CIPSTART="SSL",...。指令类似：

AT+CIPSTART="SSL","api.server.com",443

但请注意，AT指令的SSL/TLS支持可能有限，比如证书验证不完整。对于重要的生产环境，建议使用ESP8266的SDK（如Arduino Core for ESP8266）进行编程，而不是AT指令，因为SDK的网络库功能更强大、稳定。

如果API需要传递查询参数（如?key=value），只需将其附加到请求路径中即可：

GET /api/path?param1=value1¶m2=value2 HTTP/1.1

5.2 连接稳定性与错误处理

在实际环境中，网络是不稳定的。你的代码必须考虑各种错误。

• Wi-Fi连接断开：可以定期发送AT+CWJAP?查询连接状态，如果断开则重连。
• TCP连接失败：AT+CIPSTART可能返回ERROR或DNS Fail。需要实现重试机制，并考虑增加延时。
• 发送数据失败：AT+CIPSEND后可能不返回>，或者发送后不返回SEND OK。这可能是因为上一个连接未正确关闭，可以尝试先发送AT+CIPCLOSE，或者增加发送前的等待时间。
• 缓冲区溢出：ESP8266-01S的内存很小。如果HTTP响应过大，可能导致+IPD数据不完整或模块崩溃。尽量使用只返回必要数据的精简API。

一个健壮的重连逻辑框架：

bool connectWiFi() { int retries = 0; while (retries < 10) { if (sendCommandAndCheck("AT+CWJAP?...", "OK", 10000)) { return true; } delay(1000); retries++; } return false; }

5.3 低功耗考量

ESP8266-01S常用于电池供电设备。使用AT指令时，可以通过以下命令进入深度睡眠：

AT+GSLP=<time_in_milliseconds>

睡眠时间到后，需要通过拉低RST引脚来唤醒模块。唤醒后，模块需要重新连接Wi-Fi。这意味着整个获取时间戳的流程需要重新执行。对于定时获取时间的场景，需要权衡睡眠省下的电量和每次唤醒联网消耗的电量。

5.4 固件版本与指令差异

不同厂家、不同版本的AT固件，指令集可能有细微差别。例如，早期固件连接Wi-Fi的指令可能是AT+CWJAP?查询，AT+CWJAP=设置，而新版本是AT+CWJAP。建议在使用前，先使用AT+GMR查询固件版本，并找到对应的AT指令集手册。

最常见的坑：

1. 供电不足：症状是模块反复重启、响应不稳定、无法连接Wi-Fi。务必保证3.3V电源能提供至少300mA的持续电流。最好使用AMS1117-3.3等稳压模块单独供电。
2. GPIO0状态不对：如果模块一直不响应AT指令，或者上电后不断输出乱码，首先检查GPIO0是否在上电时被意外拉低（进入了烧录模式）。
3. 波特率问题：虽然默认是115200，但有些模块出厂可能是9600或其他速率。如果115200无响应，可以尝试其他常见波特率。甚至可以在上电瞬间观察启动日志的波特率（如74880）。
4. JSON解析错误：手动拼接字符串解析JSON在简单情况下可行，但一旦API返回格式稍有变化（如空格、换行），就容易出错。强烈建议在正式项目中使用ArduinoJson等库来解析，鲁棒性会高很多。
5. AT指令的响应等待：发送指令后，必须留出足够时间让模块处理并回复。delay是最简单的方法，但在实际产品中，最好用非阻塞的方式，通过检查串口是否有“OK”或“ERROR”等关键字来判断指令是否执行完毕。

从我个人的经验来看，ESP8266-01S配合AT指令，是快速验证物联网想法的绝佳工具。它让你无需深入复杂的网络编程，就能让设备“上网”。但它的局限性也明显：内存小、AT指令响应慢、错误处理机制弱。对于复杂的、需要稳定运行的项目，最终往往会转向使用NodeMCU开发板（基于ESP8266，但引脚更多，供电更稳）并直接使用Arduino Core或MicroPython进行开发，这样可以更直接、高效地控制硬件和网络资源。不过，无论如何，通过AT指令入门，是理解物联网设备网络通信基础的一个非常直观的起点。