Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions docs/common/dev/_rkdeveloptool-gui.mdx
Original file line number Diff line number Diff line change
@@ -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) 页面下载对应平台的安装包。

<Tabs queryString="host-os">
<TabItem value="macos" label="macOS">

下载 `RKDevelopTool-GUI-arm64.dmg`(仅支持 Apple 芯片)。

将 App 拖入 `Applications` 文件夹。如果首次打开时系统提示"文件已损坏",请在终端执行:

```bash
xattr -cr /Applications/RKDevelopTool-GUI.app
```

</TabItem>
<TabItem value="linux" label="Linux">

- 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 及其依赖。

</TabItem>
</Tabs>

:::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)。
4 changes: 4 additions & 0 deletions docs/common/dev/_rkdeveloptool.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
12 changes: 12 additions & 0 deletions docs/rock3/rock3a/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/rock3/rock3c/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/rock4/rock4c+/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/rockpi/rockpis0/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/som/cm/cm3/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/som/cm/cm5/radxa-os/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
12 changes: 12 additions & 0 deletions docs/zero/zero3/low-level-dev/rkdeveloptool-gui.md
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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.

<Tabs queryString="host-os">
<TabItem value="macos" label="macOS">

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
```

</TabItem>
<TabItem value="linux" label="Linux">

- 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.

</TabItem>
</Tabs>

:::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.
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />
Original file line number Diff line number Diff line change
@@ -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

<RkdeveloptoolGui />