大家好，我是地瓜机器人的技术支持同学，本篇文章旨在帮助开发者解决以下常见问题：
-
系统烧录后无法启动
-
系统启动后，Wi-Fi 及其他模块异常（不可用）
-
某些软件功能无法正常加载
问题背景
在开发和使用过程中，大家使用的 SD 卡品牌、型号各不相同，这些 SD 卡在 上电时序、启动方式 等方面存在差异，导致系统在某些卡上存在兼容性问题。
为了解决这一问题，我们对 Miniboot 引导程序进行了升级，从而 显著提升了对主流 SD 卡的兼容性。
Miniboot 简介
Miniboot 是一种轻量级的引导程序（bootloader），主要作用是在系统启动早期进行初始化。
在 RDK X5 平台中，Miniboot 固化在板载的 NAND Flash 中，启动后负责加载 SD 卡上的文件系统与核心组件。
Miniboot 升级方式指南
我们为不同情况的用户提供了两种升级路径：
方案一：系统可正常启动 — 自动在线升级
适用于系统可进入、网络正常的场景。
只需执行以下命令即可一键升级：
bash
复制编辑
root@ubuntu:~# rdk-miniboot-update
方案二：系统无法启动 — 手动烧录 Miniboot
适用于系统异常、启动失败的情况。
一、环境准备
| 工具类别 | 下载链接 | 说明 |
|---|---|---|
| 烧录工具 | http://rdk-doc.oss-cn-beijing.aliyuncs.com/doc/asset/rdk_x5/burn/xburn-gui_1.1.3_x64-setup.exe | 烧录miniboot系统的工具（包含RDK系列的各种驱动） |
| miniboot | 推荐版本： https://archive.d-robotics.cc/downloads/miniboot/rdk_x5/product_20250610.zip 所有版本： Index of /downloads/miniboot/rdk_x5/ | 轻量级的启动引导程序 |
| 连接线 | |Micro USB 线 |
二、烧录工具安装
- 下载并安装烧录工具（需在 Windows 系统下操作）
未来我们将提供 macOS 与 Ubuntu 平台的支持
- 安装驱动：保证相关的USB驱动是安装状态
三、硬件连接
使用 Micro-USB 数据线连接开发板和 PC。注意：
-
RDK X5 的 Micro-USB 接口也是 Debug UART 接口
-
确保连接稳定，建议使用质量良好的数据线
四、软件配置参数
打开烧录工具，设置参数如下：
wrap:normal;}| 参数项 | 配置内容 |
|---|---|
| Product Type | X5 |
| Link Type | Serial |
| Download Mode | Xmodem+Xmodem |
| Serial | 选择实际串口号 |
| Baudrate | 115200 |
如下图所示配置即可：
具体配置参考下图
五、开始烧录流程
上电并点击“烧录”
软件会进度到 6% 后暂停，并提示等待重启。
![烧录开始界面]
断电 → 再次上电
此时正式进入烧录阶段
烧录完成
烧录过程大约需要 10 分钟（串口速度较慢，耐心等待）。
验证 Miniboot 是否更新成功
系统启动后，执行以下命令即可查看当前系统信息：
root@ubuntu:~# rdkos_info
该指令将输出当前操作系统版本、Miniboot 版本等关键参数。
大家有问题欢迎随时留言，我们会持续优化使用体验，帮助大家更好的进行开发应用
