单片机与物联网 / 系统课时
使用串口监视器
使用串口监视器
串口监视器是观察 ESP32 运行状态最直接的工具。本节用一个持续输出运行时间的示例,完成串口初始化、波特率匹配和日志观察,并建立一套“乱码、无输出、端口占用”时的快速排查顺序。
学习目标
- 在程序中初始化串口并输出可读运行日志。
- 正确选择串口端口与波特率,判断日志是否符合程序执行过程。
- 根据乱码、空白或端口无法打开等现象快速定位问题。
建立可观察的串口输出
串口通信两端必须使用相同波特率。ESP32 开发中常用 115200,程序通过 Serial.begin(115200) 初始化串口,串口监视器也要选择同样的值。下面示例每秒打印一次运行时间,既能确认程序已启动,也能确认主循环仍在持续执行。
void setup() {
Serial.begin(115200);
delay(500);
// 启动标记只输出一次,用来判断设备是否完成复位并进入应用
Serial.println("ESP32 serial ready");
}
void loop() {
// millis() 会持续变化,便于判断程序是否仍在正常运行
Serial.printf("uptime=%lu ms\n", millis());
delay(1000);
}预期输出
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() |
| 烧录时提示端口被占用 | 关闭串口监视器、其他串口终端或后台占用程序 |
| 日志反复从启动位置重新出现 | 设备可能持续复位,应继续检查供电、异常日志和看门狗信息 |
能稳定看到启动标记和持续变化的运行时间后,串口链路就已经可用于后续调试;以后遇到程序行为异常,先用少量关键日志确认“执行到了哪里”,通常比盲目修改代码更快。