常见问题
本文档收集了 WS63 开发过程中的常见问题及解答，帮助开发者快速解决遇到的问题。
环境配置
Q: 如何安装开发环境？
A: 请参考快速入门文档中的环境搭建部分，按照步骤配置开发环境。
Q: USB 驱动安装失败怎么办？
A: 请确保使用管理员权限安装，并检查操作系统版本兼容性。建议从官方渠道下载最新版本的驱动程序。
Q: SDK 无法正常启动？
A: 请检查环境变量是否正确配置，确保 Python 版本符合要求，并安装所有必要的依赖包。
开发问题
Q: 如何调试程序？
A: 使用 UART 串口连接开发板，通过调试工具查看日志输出。也可以使用 SWD 调试接口进行硬件调试。
Q: Wi-Fi 连接不稳定？
A: 检查天线接口是否牢固，确保电源供电稳定。尝试更换 Wi-Fi 信道或调整路由器设置。
Q: BLE 无法发现设备？
A: 确认设备已进入可发现模式，检查蓝牙权限是否已开启，确保设备在有效通信范围内。
Q: 星闪通信连接失败？
A: 检查星闪协议版本兼容性，确保两个设备都支持 SLE 1.0 协议，检查天线和电源连接是否正常。
编译问题
Q: 编译报错找不到头文件？
A: 确保已正确配置 SDK 路径，并安装必要的依赖库。检查 BUILD.gn 文件中的 include 路径配置。
Q: 编译时间过长？
A: 可以使用增量编译，只编译修改的模块。也可以使用 -j 参数启用多核编译加速。
Q: 链接报错符号未定义？
A: 检查是否遗漏了必要的库文件链接，确认相关模块已正确添加到编译配置中。
硬件问题
Q: 开发板无法启动？
A: 检查电源连接是否正常，确认 USB 线接触良好。尝试重新烧录固件。
Q: 串口没有输出？
A: 确认串口参数配置正确（默认 115200, 8N1），检查串口线连接是否正确，确保开发板已上电。