单片机与物联网 / 系统课时

使用串口监视器

使用串口监视器

串口监视器是观察 ESP32 运行状态最直接的工具。本节用一个持续输出运行时间的示例,完成串口初始化、波特率匹配和日志观察,并建立一套“乱码、无输出、端口占用”时的快速排查顺序。

学习目标

  • 在程序中初始化串口并输出可读运行日志。
  • 正确选择串口端口与波特率,判断日志是否符合程序执行过程。
  • 根据乱码、空白或端口无法打开等现象快速定位问题。

建立可观察的串口输出

串口通信两端必须使用相同波特率。ESP32 开发中常用 115200,程序通过 Serial.begin(115200) 初始化串口,串口监视器也要选择同样的值。下面示例每秒打印一次运行时间,既能确认程序已启动,也能确认主循环仍在持续执行。

cpp
void setup() {
  Serial.begin(115200);
  delay(500);

  // 启动标记只输出一次,用来判断设备是否完成复位并进入应用
  Serial.println("ESP32 serial ready");
}

void loop() {
  // millis() 会持续变化,便于判断程序是否仍在正常运行
  Serial.printf("uptime=%lu ms\n", millis());
  delay(1000);
}

预期输出

text
ESP32 serial ready
uptime=<TIME> ms
uptime=<TIME> ms
uptime=<TIME> ms

<TIME> 是设备启动后的毫秒数,实际值会不断变化。只要该数字约每秒增长一次,就说明循环正在按预期执行。

打开串口监视器并匹配参数

使用支持数据传输的 USB 线连接 ESP32 后,在开发工具中选择当前开发板对应的串口,再打开串口监视器。以 Arduino IDE 为例,可先确认开发板与端口,再打开 Serial Monitor,并把波特率设为 115200。

如果打开监视器时错过了启动日志,可以按一次开发板的 EN 或 RESET 键重新启动。串口通常一次只能被一个程序独占;若烧录工具提示端口忙,先关闭正在占用同一端口的串口监视器或其他终端程序。

用日志判断程序执行到哪里

启动标记只出现一次,因此它适合确认复位流程是否真正进入应用;周期日志持续出现,则说明 loop() 仍在运行。调试实际项目时,可以在初始化完成、连接 Wi-Fi、读取传感器或进入异常分支的位置输出短日志,让“程序卡住了”变成“最后执行到了哪一步”。

不要把高频循环中的每次迭代都打印出来。串口输出本身需要时间,日志过密会拖慢任务,甚至改变原本的时序问题。优先输出状态变化、关键参数和错误原因。

处理乱码和无输出

现象 优先检查
全是乱码 程序与监视器波特率是否一致,先统一为 115200
完全没有输出 是否选错端口、USB 线是否仅供电、程序是否执行了 Serial.begin()
烧录时提示端口被占用 关闭串口监视器、其他串口终端或后台占用程序
日志反复从启动位置重新出现 设备可能持续复位,应继续检查供电、异常日志和看门狗信息

能稳定看到启动标记和持续变化的运行时间后,串口链路就已经可用于后续调试;以后遇到程序行为异常,先用少量关键日志确认“执行到了哪里”,通常比盲目修改代码更快。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用串口监视器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通