跳到主要内容

设备调试

设备调试是通过串口获取设备日志，用于问题跟踪和故障定位。烧录 TuyaOpen 固件后，串口日志是查看设备运行情况的主要方式。

信息

当前 TuyaOpen 支持的 IoT 和 AI+IoT 类芯片不支持 J-Link 类调试工具，统一采用串口日志方式进行调试。

准备工作​

开始调试前，请准备好以下资源。

硬件​

调试工具​

从以下串口调试工具中任选其一：

  • 涂鸦通用串口工具：图形化界面，操作简便。
  • TuyaOpen tos 命令行工具：命令行方式，调试选项灵活。
  • 第三方工具：SSCOM、MobaXterm、PuTTY 等。

配置串口参数​

连接前，请根据芯片型号查询对应的串口号和波特率。参数不正确会导致无法获取可读的日志输出。

芯片型号调试串口波特率备注
Ubuntu--可在 Ubuntu 等 Linux 主机上直接运行
T2Uart2115200-
T3Uart1460800-
T5AIUart1460800-
ESP32/ESP32C3/ESP32S3Uart0115200-
LN882HUart1921600-
BK7231NUart2115200-
提示

请选择正确的调试串口和波特率，否则可能无法获取日志输出。

获取日志​

根据你的使用习惯选择对应的工具。

方法一：使用涂鸦通用串口工具​

推荐大多数用户使用图形化工具，其界面友好、功能完善。请参阅 GUI - tyutool 图形化工具。

方法二：使用 tos 命令行工具​

若你熟悉命令行并希望获得更灵活的选项，请使用此方式。请参阅 tos monitor 命令。

方法三：使用第三方串口工具​

若你习惯使用 SSCOM、MobaXterm、PuTTY 等其他串口工具，请按上表的串口参数进行配置，并参考对应工具的说明文档。

调试技巧​

  • 检查连接：确认硬件连接正确，串口线缆无损坏。
  • 匹配参数：严格按照上表设置串口号和波特率。
  • 分析日志：重点关注启动日志、错误信息和异常输出。
  • 记录问题：及时记录调试过程中发现的问题和对应的解决方案。
备注

若无法获取串口输出，请检查硬件连接、串口参数设置和驱动安装情况。