diff --git a/docs/linkr/linkr/firmware-update.mdx b/docs/linkr/linkr/firmware-update.mdx index 09ad1b72e..d3e35634d 100644 --- a/docs/linkr/linkr/firmware-update.mdx +++ b/docs/linkr/linkr/firmware-update.mdx @@ -6,166 +6,137 @@ title: 固件更新 # 固件更新 -瑞莎灵控（Radxa Linkr）支持通过 Web 管理界面上传固件包进行**本地升级**，用于获取新功能、问题修复与安全更新。固件文件从 GitHub Releases 下载，上传后由设备自动校验、解密并安装。 +瑞莎灵控（Radxa Linkr）支持网页直接更新固件和线刷固件。 -:::info 当前版本 -固件下载页面：[https://github.com/radxa-linkr/linkr/releases](https://github.com/radxa-linkr/linkr/releases) +对于网页更新固件失败或者无法正常使用，可以参考线刷固件的方式给灵控刷入最新固件。 -最新发布示例：`linkr-ota-1.0.1.bin`（文件名中的版本号随发布更新而变化）。 -::: +## 固件下载 -## 更新前准备 +- GitHub 发布：[瑞莎灵控（Radxa Linkr）](https://github.com/radxa-linkr/linkr/releases) -1. **确认当前版本**：在 **关于 → 设备信息** 中查看「当前固件版本」，与待安装版本对比，确保为更高版本。 -2. **下载固件包**：访问 [GitHub Releases](https://github.com/radxa-linkr/linkr/releases)，在对应版本的 **Assets** 区域下载 `linkr-ota-<版本号>.bin` 文件到本地电脑。 -3. **保持网络稳定**：升级过程中请保持浏览器与灵控的连接，避免关闭页面或断开网络。 -4. **预留存储空间**：固件包约 50～60 MB，设备需有足够可用空间；空间不足时会提示「存储空间不足」。 -5. **避免中断**：升级期间设备系统指示灯为**白色闪烁**（参见[产品概述](./product-introduction)），请勿断电或拔线。 +- 百度网盘下载：[瑞莎灵控（Radxa Linkr）：提取码 1234](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -## 操作步骤 +说明：网页更新固件下载 `.bin` 格式的文件，线刷固件下载 `.img` 格式的文件。 -### 1. 进入系统更新 +## 固件更新 -1. 打开灵控管理 Web 界面并登录。 -2. 点击左侧边栏的 **系统设置**（设置图标）。 -3. 找到 **系统更新** 一行，点击右侧 **更新** 按钮。 +优先推荐使用网页更新固件的方式进行固件更新，若灵控固件更新失败或者无法正常使用，再使用线刷固件的方式更新固件。 -### 2. 打开本地升级 + -在弹出的 **系统更新** 对话框中： + -1. 确认当前选中 **本地升级** 标签页（标签旁 `?` 图标可查看固件下载地址）。 -2. 若尚未下载固件，可点击 `?` 旁的链接跳转至 [GitHub Releases](https://github.com/radxa-linkr/linkr/releases) 下载。 +网页更新固件需要主机可以正常访问灵控控制的设备，我们需要在 [linkr.now](https://linkr.now/) 的控制界面进行固件的上传与更新 -### 3. 上传固件文件 +- 访问被控设备界面 -在 **点击或拖拽文件到此区域上传** 区域： +进入被控设备的控制界面进行灵控固件更新： -- **点击**上传区域，从本地选择已下载的 `linkr-ota-*.bin` 文件；或 -- **拖拽**固件文件到上传区域。 +① : 进入设置选项 -上传开始后，界面会显示进度条与当前阶段。 +② : 选择 `System Update` 进行固件更新 -### 4. 等待升级完成 +③ : 将需要刷入的固件文件放进去 -升级分为以下阶段： +
+ +
-| 阶段 | 界面提示 | 说明 | -| ------ | ------------------ | ------------------------------ | -| 上传中 | 上传中... | 固件文件从浏览器传输到灵控设备 | -| 升级中 | 升级中... | 设备校验签名、解密并写入固件 | -| 完成 | 已升级，请重启设备 | 安装完成，需重启后生效 | +- 更新固件 -升级过程中可点击 **取消** 中止操作（安装接近完成时建议不要取消）。 +将固件文件放进去后，系统会自动上传、安装固件，最后重启设备后生效。 -### 5. 重启设备 +
+ +
-当进度达到 100% 并提示 **已升级，请重启设备** 时： + -1. 点击 **重启** 按钮，设备将自动重启。 -2. 重启后浏览器会跳转到登录页，使用原账号密码重新登录。 -3. 在 **关于 → 设备信息** 中确认固件版本已更新。 + -:::caution 注意 -重启会短暂中断灵控服务与远程连接。请在合适的时间窗口执行升级，并确保被控主机不会因灵控重启而受影响。 -::: +以线刷的方式更新固件需要在 Windows 平台下进行。 -## 下载固件 +电脑需要安装 [DriverAssistant](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) 驱动和下载 [SocToolKit](https://github.com/radxa-linkr/linkr/releases/download/Tools/SocToolKit_V1.94.zip) 工具。 -### 官方发布页 +- 驱动安装 -[https://github.com/radxa-linkr/linkr/releases](https://github.com/radxa-linkr/linkr/releases) +下载 [DriverAssistant](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) 压缩包并解压，找到 `DriverInstall.exe` 并以管理员身份运行，点击 `Install Driver` 选项进行驱动安装。 -### 如何选择版本 +
+ +
-1. 打开 Releases 页面，查看最新 **Tag**（如 `v1.0.1`）。 -2. 展开该版本的 **Assets**，下载 `linkr-ota-<版本号>.bin`。 -3. 建议阅读 Release Notes 了解变更内容与已知问题。 +- 进入 Maskrom 模式 -### 文件说明 +按住灵控上的用户按键，使用 USB-C 数据线连接灵控的侧边 USB-C 数据/供电接口和电脑，连接成功后松开用户按键。 -| 项目 | 说明 | -| -------- | --------------------------------------------------- | -| 文件格式 | `linkr-ota-.bin`（加密 OTA 固件包） | -| 典型大小 | 约 50～60 MB | -| 来源 | 仅从官方 GitHub Releases 下载，勿使用来历不明的文件 | +详细步骤： -### 国内镜像（百度网盘） +① : 按住灵控上的用户按键 -如果从 GitHub Releases 下载速度较慢或访问不便，可以使用以下百度网盘镜像下载相同版本的固件包： +② : 使用 USB-C 转 USB-A 数据线连接灵控和电脑 -- **链接**：[https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -- **提取码**：`1234` +③ : 松开灵控上的用户按键 -:::caution 校验与安全 +
+ +
-- 镜像中的固件版本与 GitHub Releases 保持一致；下载后请确认文件名仍为 `linkr-ota-<版本号>.bin`。 -- 如 GitHub Releases 页面提供了同版本固件的 SHA256，请优先比对哈希后再上传到设备。 -- 百度网盘分享链接如失效，请以 [GitHub Releases](https://github.com/radxa-linkr/linkr/releases) 为准。 - ::: +- 工具下载 -## 版本规则 +下载 [SocToolKit](https://github.com/radxa-linkr/linkr/releases/download/Tools/SocToolKit_V1.94.zip) 压缩包并解压，找到 `SocToolKit.exe` 并以管理员身份运行。 -设备在安装前会自动校验固件版本： +- 选择产品芯片 -| 情况 | 结果 | -| -------------------------- | ---------------------------------- | -| 固件版本 **高于** 当前版本 | 允许升级 | -| 固件版本 **等于** 当前版本 | 拒绝，提示「版本号与当前版本相同」 | -| 固件版本 **低于** 当前版本 | 拒绝，提示「版本号低于当前版本」 | +① : 选择 `RV1106` 芯片型号 -不支持降级安装。如需回退版本，请联系技术支持。 +② : 点击 `OK` 确认选项 -## 常见问题 +
+ +
-### 提示需要重启后才能再次升级 +- 更新固件 -若上次升级已完成安装但尚未重启，再次尝试升级时会提示：**检测到您之前有升级操作，需要重启后才能再次升级**。 +① : 确认软件已经识别到 Maskrom 设备 -处理方式：点击 **重启** 完成上次升级，重启后再进行新的升级操作。 +② : 点击 `Firmware ...` 选择需要刷入的固件 -### 存储空间不足 +③ : 点击 `Upgrade` 选项更新固件 -固件包需写入设备本地存储。请删除不必要的虚拟磁盘镜像或其他占用空间的文件后重试。 +
+ +
-### 上传或升级失败 +- 更新固件成功 -- 确认下载的是完整、未损坏的 `linkr-ota-*.bin` 文件，可尝试重新下载。 -- 检查浏览器与灵控之间的网络连接是否稳定。 -- 刷新页面后重新上传，避免同时开启多个升级任务。 -- 升级失败后，设备通常仍运行原固件；若出现异常，可长按 FN 键 10 秒恢复出厂设置（会清除所有配置）。 +软件的右边信息输出区提示 `... OK` 说明固件更新成功。 -### 升级过程中能否关闭页面？ +
+ +
-不建议。关闭页面可能导致上传中断。若已上传完成并进入「升级中」阶段，设备会在本地继续处理，但无法在同一页面查看进度或执行重启操作。建议保持页面打开直至提示重启。 + -### 如何查看当前固件版本？ - -**系统设置** 所在侧边栏 → **关于** → **设备信息** → **当前固件版本**。 - -### 在线升级是否可用？ - -当前 Web 界面以 **本地升级** 为主：先从 GitHub 下载固件，再在界面上传。本地升级标签旁的 `?` 图标提供了官方下载地址快捷入口。 - -## 升级流程示意 - -```text -GitHub Releases 下载 linkr-ota-*.bin - ↓ -系统设置 → 系统更新 → 更新 - ↓ -本地升级 → 点击或拖拽上传固件 - ↓ -上传中 → 升级中（设备指示灯白色闪烁） - ↓ -已升级，请重启设备 → 点击重启 - ↓ -重新登录，确认版本号 -``` - -## 相关链接 - -- [固件下载（GitHub Releases）](https://github.com/radxa-linkr/linkr/releases) -- [固件下载（百度网盘镜像，提取码 1234）](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -- [产品概述 - LED 指示灯](./product-introduction#led-指示灯) -- [常见问题](#常见问题) + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/linkr/linkr/firmware-update.mdx b/i18n/en/docusaurus-plugin-content-docs/current/linkr/linkr/firmware-update.mdx index 475a515ff..c447a71e6 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/linkr/linkr/firmware-update.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/linkr/linkr/firmware-update.mdx @@ -6,166 +6,137 @@ title: Firmware Update # Firmware Update -Radxa Linkr supports **local upgrade** by uploading a firmware package through the web management interface, which is used to obtain new features, bug fixes, and security updates. The firmware file is downloaded from GitHub Releases, and the device automatically verifies, decrypts, and installs it after upload. +Radxa Linkr supports firmware update directly via the web and flashing firmware via USB cable. -:::info Current Version -Firmware download page: [https://github.com/radxa-linkr/linkr/releases](https://github.com/radxa-linkr/linkr/releases) +If the web firmware update fails or the device cannot work properly, you can refer to the firmware flashing method to flash the latest firmware onto Linkr. -Latest release example: `linkr-ota-1.0.1.bin` (the version number in the file name changes with each release). -::: +## Firmware Download -## Before Updating +- GitHub Releases: [Radxa Linkr](https://github.com/radxa-linkr/linkr/releases) -1. **Check the current version**: In **About → Device Information**, view the "Current Firmware Version" and compare it with the version to be installed to make sure it is a higher version. -2. **Download the firmware package**: Visit [GitHub Releases](https://github.com/radxa-linkr/linkr/releases), and download the `linkr-ota-.bin` file from the **Assets** section of the corresponding version to your local computer. -3. **Keep the network stable**: Please keep the connection between the browser and Linkr during the upgrade process; do not close the page or disconnect the network. -4. **Reserve storage space**: The firmware package is about 50-60 MB, and the device needs to have enough free space. If space is insufficient, the message "Insufficient storage space" will be displayed. -5. **Avoid interruption**: During the upgrade, the device's system indicator LED is **flashing white** (see [Product Overview](./product-introduction)). Do not power off or unplug cables. +- Baidu Pan Download: [Radxa Linkr: Extraction code 1234](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -## Operation Steps +Note: The web firmware update downloads a file in `.bin` format, while the USB flashing downloads a file in `.img` format. -### 1. Go to System Update +## Firmware Update -1. Open the Linkr management web interface and log in. -2. Click **System Settings** (the settings icon) in the left sidebar. -3. Find the **System Update** row, and click the **Update** button on the right. +It is recommended to use the web firmware update method first. If the Linkr firmware update fails or the device cannot work properly, then use the USB flashing method to update the firmware. -### 2. Open Local Upgrade + -In the **System Update** dialog that pops up: + -1. Confirm that the **Local Upgrade** tab is currently selected (the `?` icon next to the tab can be used to view the firmware download address). -2. If you have not downloaded the firmware yet, you can click the link next to `?` to jump to [GitHub Releases](https://github.com/radxa-linkr/linkr/releases) to download. +Web firmware update requires the host computer to be able to access the Linkr-controlled device. We need to upload and update firmware in the management interface at [linkr.now](https://linkr.now/). -### 3. Upload the Firmware File +- Access the controlled device interface -In the **Click or drag a file to this area to upload** area: +Enter the management interface of the controlled device to update the Linkr firmware: -- **Click** the upload area and select the downloaded `linkr-ota-*.bin` file from your local disk; or -- **Drag** the firmware file into the upload area. +① : Go to the Settings option -After upload starts, the interface will display a progress bar and the current stage. +② : Select `System Update` for firmware update -### 4. Wait for the Upgrade to Complete +③ : Upload the firmware file that needs to be flashed -The upgrade is divided into the following stages: +
+ +
-| Stage | UI Message | Description | -| --------- | ----------------------------------- | --------------------------------------------------------------------- | -| Uploading | Uploading... | The firmware file is transferred from the browser to the Linkr device | -| Upgrading | Upgrading... | The device verifies the signature, decrypts, and writes the firmware | -| Complete | Upgraded, please restart the device | The installation is complete; takes effect after restart | +- Update Firmware -You can click **Cancel** to abort the operation during the upgrade (it is recommended not to cancel once installation is nearly complete). +After uploading the firmware file, the system will automatically upload, install the firmware, and finally restart the device for the changes to take effect. -### 5. Restart the Device +
+ +
-When the progress reaches 100% and the message **Upgraded, please restart the device** is shown: + -1. Click the **Restart** button, and the device will restart automatically. -2. After the restart, the browser will jump to the login page. Log in with your original username and password. -3. In **About → Device Information**, confirm that the firmware version has been updated. + -:::caution Note -A restart will briefly interrupt the Linkr service and remote connection. Please perform the upgrade in an appropriate time window, and make sure that the target host will not be affected by the Linkr restart. -::: +Flashing firmware via USB needs to be performed on a Windows platform. -## Download the Firmware +The computer needs to install the [DriverAssistant](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) driver and download the [SocToolKit](https://github.com/radxa-linkr/linkr/releases/download/Tools/SocToolKit_V1.94.zip) tool. -### Official Release Page +- Driver Installation -[https://github.com/radxa-linkr/linkr/releases](https://github.com/radxa-linkr/linkr/releases) +Download and extract the [DriverAssistant](https://dl.radxa.com/tools/windows/DriverAssitant_v5.14.zip) package, find `DriverInstall.exe` and run it as administrator, then click the `Install Driver` option to install the driver. -### How to Choose a Version +
+ +
-1. Open the Releases page and look at the latest **Tag** (e.g. `v1.0.1`). -2. Expand the **Assets** of that version, and download `linkr-ota-.bin`. -3. It is recommended to read the Release Notes for the changes and known issues. +- Enter Maskrom Mode -### File Description +Press and hold the user button on Linkr, use a USB-C data cable to connect the USB-C data/power port on the side of Linkr to the computer, and release the user button after the connection is successful. -| Item | Description | -| ------------ | -------------------------------------------------------------------------------------- | -| File format | `linkr-ota-.bin` (encrypted OTA firmware package) | -| Typical size | About 50-60 MB | -| Source | Download only from the official GitHub Releases. Do not use files from unknown sources | +Detailed steps: -### China Mirror (Baidu Pan) +① : Press and hold the user button on Linkr -For users in mainland China where GitHub access may be slow or limited, a Baidu Pan mirror of the same firmware package is also available: +② : Use a USB-C to USB-A data cable to connect Linkr to the computer -- **Link**: [https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -- **Extraction code**: `1234` +③ : Release the user button on Linkr -:::caution Verification & Security +
+ +
-- The mirror keeps the same firmware versions as the official GitHub Releases. After downloading, please confirm the file name is still `linkr-ota-.bin`. -- If the GitHub Releases page provides a SHA256 for the same version, please compare the hash before uploading to the device. -- If the Baidu Pan share link is no longer valid, please use the [GitHub Releases](https://github.com/radxa-linkr/linkr/releases) as the source of truth. - ::: +- Tool Download -## Version Rules +Download and extract the [SocToolKit](https://github.com/radxa-linkr/linkr/releases/download/Tools/SocToolKit_V1.94.zip) package, find `SocToolKit.exe` and run it as administrator. -The device automatically verifies the firmware version before installation: +- Select Product Chip -| Case | Result | -| ---------------------------------------------------- | ---------------------------------------------------------------------------------- | -| Firmware version **higher than** the current version | Allowed to upgrade | -| Firmware version **equal to** the current version | Rejected, with the message "The version number is the same as the current version" | -| Firmware version **lower than** the current version | Rejected, with the message "The version number is lower than the current version" | +① : Select the `RV1106` chip model -Downgrade installation is not supported. To roll back to a previous version, please contact technical support. +② : Click `OK` to confirm the selection -## FAQ +
+ +
-### "A Restart Is Required Before Upgrading Again" +- Update Firmware -If the previous upgrade has been installed but the device has not been restarted, attempting to upgrade again will prompt: **A previous upgrade operation was detected. The device needs to be restarted before another upgrade can be performed.** +① : Confirm that the software has recognized the Maskrom device -How to handle: Click **Restart** to complete the previous upgrade, and then perform the new upgrade operation after the restart. +② : Click `Firmware ...` to select the firmware to be flashed -### Insufficient Storage Space +③ : Click the `Upgrade` option to update the firmware -The firmware package needs to be written to the device's local storage. Please delete unnecessary virtual disk images or other space-consuming files and try again. +
+ +
-### Upload or Upgrade Failed +- Firmware Update Successful -- Confirm that the downloaded `linkr-ota-*.bin` file is complete and not corrupted. Try downloading it again. -- Check whether the network connection between the browser and Linkr is stable. -- Refresh the page and re-upload. Avoid running multiple upgrade tasks at the same time. -- After an upgrade failure, the device usually still runs the original firmware. If there is an abnormality, you can long-press the FN key for 10 seconds to restore factory settings (this will clear all configuration). +The information output area on the right side of the software shows `... OK`, indicating that the firmware update has succeeded. -### Can I Close the Page During the Upgrade? +
+ +
-Not recommended. Closing the page may cause the upload to be interrupted. If the upload is already complete and the "Upgrading" stage has been entered, the device will continue processing locally, but you will not be able to view the progress or perform the restart on the same page. It is recommended to keep the page open until the restart prompt appears. + -### How to View the Current Firmware Version? - -The sidebar where **System Settings** is located → **About** → **Device Information** → **Current Firmware Version**. - -### Is Online Upgrade Available? - -The current web interface is mainly **local upgrade**: first download the firmware from GitHub, and then upload it in the interface. The `?` icon next to the local upgrade tab provides a shortcut to the official download address. - -## Upgrade Process Overview - -```text -Download linkr-ota-*.bin from GitHub Releases - ↓ -System Settings → System Update → Update - ↓ -Local Upgrade → Click or drag to upload the firmware - ↓ -Uploading → Upgrading (device indicator LED flashing white) - ↓ -Upgraded, please restart the device → Click Restart - ↓ -Log in again and confirm the version number -``` - -## Related Links - -- [Firmware Download (GitHub Releases)](https://github.com/radxa-linkr/linkr/releases) -- [Firmware Download (Baidu Pan mirror, extraction code 1234)](https://pan.baidu.com/s/1AZgLUDaU8hJKhZjqTT_sMQ?pwd=1234) -- [Product Overview - LED Indicators](./product-introduction#led-indicators) -- [FAQ](#faq) + diff --git a/static/img/linkr/linkr-maskrom.webp b/static/img/linkr/linkr-maskrom.webp new file mode 100644 index 000000000..4f4177e18 Binary files /dev/null and b/static/img/linkr/linkr-maskrom.webp differ diff --git a/static/img/linkr/online_update_firmware_01.webp b/static/img/linkr/online_update_firmware_01.webp new file mode 100644 index 000000000..6ca361a0b Binary files /dev/null and b/static/img/linkr/online_update_firmware_01.webp differ diff --git a/static/img/linkr/online_update_firmware_02.webp b/static/img/linkr/online_update_firmware_02.webp new file mode 100644 index 000000000..37ef31435 Binary files /dev/null and b/static/img/linkr/online_update_firmware_02.webp differ diff --git a/static/img/linkr/online_update_firmware_03.webp b/static/img/linkr/online_update_firmware_03.webp new file mode 100644 index 000000000..37ef31435 Binary files /dev/null and b/static/img/linkr/online_update_firmware_03.webp differ diff --git a/static/img/linkr/usb_firmware_succ.webp b/static/img/linkr/usb_firmware_succ.webp new file mode 100644 index 000000000..972f92350 Binary files /dev/null and b/static/img/linkr/usb_firmware_succ.webp differ diff --git a/static/img/linkr/usb_update_firmware_01.webp b/static/img/linkr/usb_update_firmware_01.webp new file mode 100644 index 000000000..efd14e19b Binary files /dev/null and b/static/img/linkr/usb_update_firmware_01.webp differ diff --git a/static/img/linkr/usb_update_firmware_02.webp b/static/img/linkr/usb_update_firmware_02.webp new file mode 100644 index 000000000..a9c274da6 Binary files /dev/null and b/static/img/linkr/usb_update_firmware_02.webp differ