WebSocket Client

学习目标

本教程将带你完成 WebSocket Client 的最小可运行示例，并说明验证方法和常见故障。开始前请确认开发板供电稳定，串口驱动已正确安装。

准备工作

• 一块受支持的 ESP32 开发板
• 一根支持数据传输的 USB 线
• ESP-IDF 5.3+ 或 Arduino Core 3.x

实现步骤

1. 创建新工程并选择正确的目标芯片。
2. 按照开发板丝印完成连接，避免 IO 电压超过 3.3V。
3. 编译并烧录下面的最小示例。

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"

void app_main(void) {
    while (1) {
        printf("websocket-client: ready\\n");
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

验证结果

打开串口监视器并使用 115200 波特率。终端应每秒输出一次运行状态。你也可以使用本站的 Web Serial 终端 直接查看。

提示：Web Serial 需要 Chromium 内核浏览器，并且页面必须运行于 HTTPS 或 localhost。

常见错误

现象	排查方法
找不到串口	更换数据线，检查驱动和浏览器权限
烧录超时	按住 BOOT 后短按 RESET，重新开始烧录
输出乱码	确认终端和固件使用相同波特率

下一步

将示例中的状态输出替换为真实业务逻辑，并在量产前加入错误恢复、看门狗和安全配置。