Web 服务器 AT 命令

[English]

介绍

重要

默认的 AT 固件不支持此页面下的 AT 命令。如果您需要 ESP32 支持 Web 服务器命令,请自行 编译 ESP-AT 工程,在第五步配置工程里选择:

  • 启用 Component config -> AT -> AT Web Server command support

AT+WEBSERVER: 启用/禁用通过 Web 服务器配置 Wi-Fi 连接

设置命令

命令:

AT+WEBSERVER=<enable>,<server_port>,<connection_timeout>

响应:

OK

参数

  • <enable>: 启用/禁用 Web 服务器。

    • 0: 禁用 Web 服务器并释放相关资源。

    • 1: 启用 Web 服务器,您可以通过微信或者浏览器配置 Wi-Fi 连接信息。

  • <server_port>: Web 服务器端口号。

  • <connection_timeout>: 每个连接的超时时间。单位:秒。范围:[21,60]。

说明

  • 有两种方法可以提供 Web 服务器所需的 HTML 文件。一种是使用 FAT 文件系统,此时需要启用 AT FS 命令。另一种是使用嵌入文件来存储 HTML 文件(默认设置)。

  • 默认的 HTML 文件为 index.html 。如果需要自定义 HTML 文件的显示格式或显示文字,则您直接修改该文件即可;如果需要自定义 HTML 文件的其它内容(例如:增加一个字段),则您需要对应修改源码文件 at_web_server_cmd.c

  • 请确保开放的 socket 的最大数目不能小于 12,您可以在 menuconfig 中设置此项 ./build.py menuconfig > Component config > LWIP > Max number of open sockets,然后重新编译工程(参考文档 本地编译 ESP-AT 工程)。

  • AT 固件默认不支持 Web 服务器 AT 命令(参考文档 see ESP-AT 固件差异),但您可以在 menuconfig 中设置支持 Web 服务器 AT 命令 ./build.py menuconfig > Component config > AT > AT WEB Server command support,然后重新编译工程(参考文档 本地编译 ESP-AT 工程)。

  • ESP-AT 在 ESP32 系列设备中支持强制门户 (captive portal),可参考 示例

  • 更多示例可参考文档 Web Server AT 示例

  • 该命令的实现开源,源码请参考 at/src/at_web_server_cmd.c

  • 请参考 如何实现 OTA 升级 获取更多 OTA 命令。

示例

// 启用 Web 服务器,端口 80,每个连接的超时时间 50 秒
AT+WEBSERVER=1,80,50

// 禁用 Web 服务器
AT+WEBSERVER=0