固件升级

注意： 本文是为 Ruff 1.5.0 之前的版本准备的升级教程。如果你的固件是新版本，请访问这里获取新版的固件升级方式。

固件，是 Ruff 一个重要的组成部分，它是一个运行在开发板上的系统，也是我们的 Ruff 应用运行的根基。

当 Ruff 发布新版本时，请在下载最新版 SDK 的同时，更新对应版本的固件，以便二者配合，达到最佳的使用体验。

升级前准备

更新 SDK

在历史软件包下载，找到 Ruff SDK 1.4.0，在系统更新后，将此 SDK 覆盖原有的 SDK。

固件下载

在下载页面，找到最新的固件。下载后，保存到本地。

网络连接

1. 将 Ruff 开发板上的 micro USB 接口与 USB 电源线连接，Ruff 开发板将随即启动。如果是一块全新的开发板，启动完成后会看到红色 LED 闪烁，表示正在等待网络配置。

2. 现在使用 rap wifi 命令为开发板配置 WiFi：

   rap wifi

3. 填写好 SSID 和密码后，rap 将会广播 SSID 及密码。此时开发板会通过 LED 指示网络连接情况：

   • 蓝色 LED 闪烁：开发板已经收到配置，正在尝试连接。
   • 蓝色 LED 常亮：连接成功！
   • 蓝色 LED 闪烁变为红色 LED 闪烁：开发板连接网络失败或超时，需要重新配置。

   开发板与电脑需要在同一网段内。开发板目前仅支持 2.4G 频段，所以请配置支持 2.4G 的热点。部分双频路由 2.4G 与 5G 频段互通，电脑仍然可以连接 5G 热点。

获取开发板 IP

开发板的 IP 地址可以通过如下命令获得：

rap scan

这个命令可以罗列出开发板的 IP 地址。

固件升级

固件升级可以通过运行如下命令：

rap system upgrade path-to-firmware-file -H hostname

这里的 path-to-firmware-file 是固件的存放地址， hostname 是开发板的 IP 地址。

注意

• 升级之前，请确保电源已经插好。
• 该命令将彻底升级，保存在设备的任何信息都将被删除。
• 升级完成之后，请在下载页面更新为最新的 Ruff SDK。

示例

假定固件存放在 ~/Downloads/ruffos-1.5.0.bin，开发板的 IP 地址为 192.168.168.168

rap system upgrade ~/Downloads/ruffos-1.5.0.bin -H 192.168.168.168