diff --git a/docs/common/dev/_rkdeveloptool-gui.mdx b/docs/common/dev/_rkdeveloptool-gui.mdx new file mode 100644 index 0000000000..917e8f85da --- /dev/null +++ b/docs/common/dev/_rkdeveloptool-gui.mdx @@ -0,0 +1,56 @@ +:::tip +本文介绍的 RKDevelopTool-GUI 是社区维护的第三方图形界面工具，并非 Rockchip 或 Radxa 官方软件。 +::: + +RKDevelopTool-GUI 是社区为 [rkdeveloptool](./rkdeveloptool.md) 开发的跨平台图形界面前端，可用于固件烧录、分区管理和设备调试。 + +RKDevelopTool-GUI 的 macOS 和 Linux 安装包中已经内置编译好的 rkdeveloptool，安装后即可直接使用，无需按照 [rkdeveloptool](./rkdeveloptool.md) 一文自行编译。 + +--- + +## 安装 RKDevelopTool-GUI + +前往项目的 [GitHub Releases](https://github.com/gahingwoo/RKDevelopTool-GUI/releases) 页面下载对应平台的安装包。 + + + + +下载 `RKDevelopTool-GUI-arm64.dmg`（仅支持 Apple 芯片）。 + +将 App 拖入 `Applications` 文件夹。如果首次打开时系统提示"文件已损坏"，请在终端执行： + +```bash +xattr -cr /Applications/RKDevelopTool-GUI.app +``` + + + + +- Debian / Ubuntu（amd64 / arm64）：下载并安装 `rkdeveloptool-gui_*.deb` +- Fedora / openSUSE（x86_64 / aarch64）：下载并安装 `rkdeveloptool-gui-*.rpm` +- 免安装：下载 `RKDevelopTool-GUI-*-x86_64.AppImage` 或 `*-aarch64.AppImage`，添加可执行权限后运行 +- Arch Linux：可从 [AUR](https://aur.archlinux.org/packages/rkdeveloptool-gui) 安装 `rkdeveloptool-gui` + +以上安装包均已静态链接 rkdeveloptool 及其依赖。 + + + + +:::tip +RKDevelopTool-GUI 暂无 Intel 版 macOS 和 Windows 的预编译包。这些平台可以从源码运行（需要 Python 与 PySide6，并自行安装 rkdeveloptool），具体步骤见项目 [README](https://github.com/gahingwoo/RKDevelopTool-GUI)。Windows 用户也可以直接使用 [RKDevTool](./rkdevtool.md)。 +::: + +--- + +## 使用 RKDevelopTool-GUI + +将设备进入 Maskrom 模式并通过 USB 连接到电脑，RKDevelopTool-GUI 会自动检测已连接的设备。图形界面中可以完成： + +- 写入 Loader 与系统镜像 +- 查看、备份分区表 +- 读取芯片型号、Flash ID 等设备信息 +- 重启设备 + +界面底部会显示当前操作对应的 rkdeveloptool 命令行。 + +更多说明见项目 [README](https://github.com/gahingwoo/RKDevelopTool-GUI)。 diff --git a/docs/common/dev/_rkdeveloptool.mdx b/docs/common/dev/_rkdeveloptool.mdx index 9db096717d..d5294d2718 100644 --- a/docs/common/dev/_rkdeveloptool.mdx +++ b/docs/common/dev/_rkdeveloptool.mdx @@ -8,6 +8,10 @@ rkdeveloptool 是 Rockchip 为 Linux/macOS 平台下进行 USB 烧录所开发 rkdeveloptool 可以被认为是[开源版本](https://opensource.rock-chips.com/wiki_Rkdeveloptool)的 upgrade_tool。 +:::tip +不想编译 rkdeveloptool？可以试试第三方图形界面工具 [RKDevelopTool-GUI](./rkdeveloptool-gui.md)，其 macOS 和 Linux 安装包已经内置编译好的 rkdeveloptool。 +::: + --- ## 安装 rkdeveloptool diff --git a/docs/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md b/docs/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..6d8924dcf9 --- /dev/null +++ b/docs/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md b/docs/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..6d8924dcf9 --- /dev/null +++ b/docs/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md b/docs/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..6d8924dcf9 --- /dev/null +++ b/docs/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md b/docs/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..6d8924dcf9 --- /dev/null +++ b/docs/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md b/docs/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..d2de4b0958 --- /dev/null +++ b/docs/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md b/docs/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..04abde2ef4 --- /dev/null +++ b/docs/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md b/docs/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..d2de4b0958 --- /dev/null +++ b/docs/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/docs/zero/zero3/low-level-dev/rkdeveloptool-gui.md b/docs/zero/zero3/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..6d8924dcf9 --- /dev/null +++ b/docs/zero/zero3/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - docs/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx new file mode 100644 index 0000000000..2c19eb860e --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx @@ -0,0 +1,56 @@ +:::tip +RKDevelopTool-GUI, covered in this article, is a community-maintained third-party graphical tool. It is not official Rockchip or Radxa software. +::: + +RKDevelopTool-GUI is a cross-platform graphical front-end for [rkdeveloptool](./rkdeveloptool.md) built by the community. It can be used for firmware flashing, partition management, and device debugging. + +The macOS and Linux packages of RKDevelopTool-GUI already bundle a precompiled rkdeveloptool, so they work right after installation without compiling rkdeveloptool from source as described in [rkdeveloptool](./rkdeveloptool.md). + +--- + +## Installing RKDevelopTool-GUI + +Download the package for your platform from the project's [GitHub Releases](https://github.com/gahingwoo/RKDevelopTool-GUI/releases) page. + + + + +Download `RKDevelopTool-GUI-arm64.dmg` (Apple Silicon only). + +Drag the app into `Applications`. If macOS reports the file is damaged the first time you open it, run: + +```bash +xattr -cr /Applications/RKDevelopTool-GUI.app +``` + + + + +- Debian / Ubuntu (amd64 / arm64): download and install `rkdeveloptool-gui_*.deb` +- Fedora / openSUSE (x86_64 / aarch64): download and install `rkdeveloptool-gui-*.rpm` +- No installation needed: download `RKDevelopTool-GUI-*-x86_64.AppImage` or `*-aarch64.AppImage`, mark it executable, and run it +- Arch Linux: install `rkdeveloptool-gui` from the [AUR](https://aur.archlinux.org/packages/rkdeveloptool-gui) + +All of the above packages statically link rkdeveloptool and its dependencies. + + + + +:::tip +RKDevelopTool-GUI does not provide prebuilt packages for Intel macOS or Windows. On those platforms it can be run from source (requires Python and PySide6, and a separately installed rkdeveloptool) — see the project [README](https://github.com/gahingwoo/RKDevelopTool-GUI) for steps. Windows users can also use [RKDevTool](./rkdevtool.md) directly. +::: + +--- + +## Using RKDevelopTool-GUI + +Put the device into Maskrom mode and connect it over USB — RKDevelopTool-GUI detects connected devices automatically. From the interface you can: + +- Write a Loader and system image +- View and back up the partition table +- Read chip model, Flash ID, and other device info +- Reboot the device + +The bottom of the window shows the equivalent rkdeveloptool command line for the current action. + +See the project [README](https://github.com/gahingwoo/RKDevelopTool-GUI) for further details. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool.mdx index 82cd1c172c..16b1d89be9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool.mdx @@ -10,6 +10,10 @@ rkdeveloptool is a USB flashing software developed by Rockchip for Linux/macOS p rkdeveloptool can be thought of as upgrade_tool for [open source version](https://opensource.rock-chips.com/wiki_Rkdeveloptool). +:::tip +Don't want to compile rkdeveloptool yourself? Try [RKDevelopTool-GUI](./rkdeveloptool-gui.md), a third-party graphical tool whose macOS and Linux packages already bundle a precompiled rkdeveloptool. +::: + --- ## Installation for rkdeveloptool diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..9976e2e7ce --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..9976e2e7ce --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..9976e2e7ce --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..9976e2e7ce --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..bef9e0bf52 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..3b676afe6d --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..bef9e0bf52 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/template/module/radxa-os/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/low-level-dev/rkdeveloptool-gui.md b/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/low-level-dev/rkdeveloptool-gui.md new file mode 100644 index 0000000000..9976e2e7ce --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/low-level-dev/rkdeveloptool-gui.md @@ -0,0 +1,12 @@ +--- +doc_kind: wrapper +source_of_truth: common +imports_resolve_to: + - i18n/en/docusaurus-plugin-content-docs/current/common/dev/_rkdeveloptool-gui.mdx +--- + +import RkdeveloptoolGui from "../../../common/dev/\_rkdeveloptool-gui.mdx"; + +# RKDevelopTool-GUI + +