设备调试
概述
本文档将指导您如何使用串口调试工具获取设备日志，进行问题跟踪和故障定位。在完成 TuyaOpen 固件烧录后，串口调试是排查设备问题的有效方法。
信息
重要提示：当前 TuyaOpen 支持的 IoT 和 AI+IoT 类芯片暂不支持 JLink 类调试工具，统一采用串口日志方式进行调试。
准备工作
在开始调试前，请确保准备以下必要资源：
硬件设备
- TuyaOpen 支持的开发板或模组
- USB 数据线或 USB-TTL 转接器
调试工具
选择以下任一串口调试工具：
- 涂鸦通用串口工具 - 图形化界面，操作简便
- TuyaOpen 命令行 tos 工具 - 命令行方式，功能强大
- 第三方工具 - SSCOM、MobaXterm、PuTTY 等
调试参数配置
串口参数对照表
开始调试前，请根据您的芯片型号查询对应的调试参数：
| 芯片型号 | 调试串口 | 波特率 | 备注 |
|---|---|---|---|
| Ubuntu | - | - | 可在 Ubuntu 等 Linux 主机上直接运行 |
| T2 | Uart2 | 115200 | |
| T3 | Uart1 | 460800 | |
| T5AI | Uart1 | 460800 | |
| ESP32/ESP32C3/ESP32S3 | Uart0 | 115200 | |
| LN882H | Uart1 | 921600 | |
| BK7231N | Uart2 | 115200 |
提示
配置要点：确保选择正确的调试串口和波特率，否则可能无法正常获取日志信息。
调试步骤
方法一：使用涂鸦通用串口工具
推荐使用涂鸦官方提供的图形化串口调试工具，界面友好，功能完善。
详细使用说明：请参考 串口调试工具使用指南
方法二：使用 tos 命令行工具
适合熟悉命令行的开发者，提供更灵活的调试选项。
详细使用说明：请参考 tos monitor 命令
方法三：使用第三方串口工具
如果您习惯使用其他串口调试工具，如 SSCOM、MobaXterm、PuTTY 等，请参考对应工具的使用说明进行配置。
调试技巧
- 连接检查：确保硬件连接正确，串口线缆无损坏
- 参数匹配：严格按照上表配置串口参数
- 日志分析：关注启动日志、错误信息和异常输出
- 问题记录：及时记录调试过程中发现的问题和解决方案
备注
故障排除：如果无法获取串口输出，请检查硬件连接、串口参数设置和驱动安装情况。