本页面汇总了 RyzoBee / RootMaker / Yoke 模块 / Zoner 平台在使用过程中可能遇到的常见问题。
如果你在连接设备、烧录固件、配置 Wi-Fi、使用模块或运行项目时遇到问题，可以先从本页面选择对应分类进行排查。
如果你不确定问题属于哪一类，可以先从下面几个常见场景开始。
| 问题现象 | 建议查看 |
|---|---|
| 电脑无法识别 RootMaker | 设备连接问题 |
| 固件烧录失败 | 固件烧录问题 |
| Wi-Fi 无法连接 | Wi-Fi 与网络问题 |
| Yoke 模块没有反应 | Yoke 模块问题 |
| 灯光闪烁或颜色异常 | 灯效模块问题 |
| 电机不转或设备重启 | 供电与电机问题 |
| Zoner 项目无法运行 | Zoner 平台问题 |
| 3D 安装后效果异常 | 结构安装问题 |
本分类用于排查 RootMaker 与电脑、USB-C 线缆、电源适配器之间的连接问题。
常见问题包括：
建议优先检查：
- [RootMaker 无法被电脑识别]()
- [如何进入下载模式]()
- [USB-C 线缆选择建议]()
- [串口设备无法显示]()
本分类用于排查通过 Zoner / WebTools / Arduino / ESP-IDF 烧录固件时遇到的问题。
常见问题包括：
建议优先检查：
- [使用 WebTools 烧录固件]()
- [烧录失败排查]()
- [如何重新烧录默认固件]()
- [如何查看串口日志]()
- [固件版本选择说明]()
本分类用于排查 Wi-Fi 配网、网页控制、OTA、云端服务和网络连接相关问题。
常见问题包括：
建议优先检查：
- [Wi-Fi 配网失败怎么办]()
- [设备网页无法打开]()
- [如何查看设备 IP 地址]()
- [OTA 更新失败排查]()
- [2.4GHz Wi-Fi 使用说明]()
本分类用于排查 Yoke 模块连接、识别和运行异常问题。
常见问题包括：
建议优先检查：
- [Yoke 模块无法识别]()
- [Yoke 模块接口方向说明]()
- [是否可以热插拔 Yoke 模块]()
- [多个 Yoke 模块同时使用说明]()
- [Yoke 模块兼容性表]()
本分类主要用于排查 Yoke-TRGBW、RGBW 灯板、灯带和其他灯效类模块。
常见问题包括：
建议优先检查：
- [Yoke-TRGBW 不亮怎么办]()
- [RGBW 颜色显示异常]()
- [灯光闪烁或设备重启]()
- [如何限制灯光亮度]()
- [灯效模块供电说明]()
本分类用于排查显示模块、触摸模块和按键模块相关问题。
常见问题包括：
建议优先检查：
- [显示模块不亮怎么办]()
- [屏幕方向设置说明]()
- [触摸模块误触发排查]()
- [Yoke-KEYW 按键无响应]()
本分类用于排查雷达、二氧化碳传感器、热成像模块以及其他传感器类模块。
常见问题包括：
建议优先检查：
- [Yoke-RAD60 雷达误触发]()
- [Yoke-SCD4x 数据异常]()
- [Yoke-THERM5K 热成像异常]()
- [传感器安装方向说明]()
- [传感器校准说明]()
本分类用于排查电源、电池、电机、无线供电和高功耗模块相关问题。
常见问题包括：
建议优先检查：
- [RootMaker 反复重启怎么办]()
- [电机模块供电说明]()
- [Yoke-MOTO 不工作怎么办]()
- [电池模块使用说明]()
- [无线供电模块使用说明]()
- [高功耗模块使用注意事项]()
本分类用于排查 Zoner 平台、项目模板、配置文件和固件资源相关问题。
常见问题包括：
建议优先检查：
本分类用于排查 Arduino、ESP-IDF、串口调试和自定义开发过程中遇到的问题。
常见问题包括：
建议优先检查：
- [Arduino 开发环境配置]()
- [ESP-IDF 开发环境配置]()
- [编译失败排查]()
- [串口日志查看方法]()
- [示例工程运行说明]()
本分类用于排查 3D 打印安装、结构固定、线缆走线和外壳装配相关问题。
常见问题包括：
建议优先检查：
- [RootMaker 3D 安装建议]()
- [Yoke 模块结构安装建议]()
- [USB-C 维护口设计]()
- [线缆走线设计建议]()
- [灯光扩散结构设计]()
使用 RootMaker 和 Yoke 模块时，请遵守基本电子产品安全要求。
请特别注意：
- [安全使用说明]()
- [供电安全说明]()
- [电池模块安全说明]()
- [高功耗模块注意事项]()
- [儿童使用警告]()
如果你没有在 FAQ 中找到对应答案，可以通过以下方式反馈问题。
提交问题时，建议提供以下信息：
| 信息 | 示例 |
|---|---|
| 使用的 Root 主机 | RootMaker / 硬件版本 |
| 使用的 Yoke 模块 | Yoke-TRGBW、Yoke-RAD60 等 |
| 使用的项目模板 | Minecraft Ore Lamp、人体感应灯等 |
| 固件版本 | 例如 v1.0.0 |
| 使用方式 | Zoner / WebTools / Arduino / ESP-IDF |
| 问题现象 | 不亮、重启、无法烧录、无法联网等 |
| 串口日志 | 如有，请复制关键日志 |
| 图片或视频 | 建议提供接线图、设备状态和异常现象 |
- [如何提交问题反馈]()
- [GitHub Issue]()
- [Discord 社区]()
- [联系技术支持]()