Skip to content

docs: add rock s0 buildroot #1207

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jack-ma merged 1 commit into from
Dec 23, 2025
Merged

docs: add rock s0 buildroot #1207

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
123 changes: 123 additions & 0 deletions docs/rockpi/rocks0/other-os/buildroot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,123 @@
---
sidebar_position: 1
---

import SSDISKTOOL from "../../../common/general/\_sddisktool.mdx"

# Buildroot 构建

## 环境准备

需要准备一台 Ubuntu 20.04/22.04 x86_64 主机。

也可以使用虚拟主机

- ubuntu-22.04.5-live-server-amd64 虚拟主机，硬盘可用容量不低于 120G。

## 安装编译依赖包

<NewCodeBlock tip="Host-Linux$" type="host">
```
sudo apt update
sudo apt install python2 git rsync gcc g++ make device-tree-compiler bc flex bison lz4 libssl-dev libgmp-dev libmpc-dev expect expect-dev file unzip bzip2 fakeroot bsdmainutils
sudo ln -s /bin/python2 /bin/python
```
</NewCodeBlock>

## 获取 Rockchip 原始 SDK

- [百度网盘](https://pan.baidu.com/s/1RWrkBVUtrAAEEu1dn_G0ww?pwd=e9nj)

- [MEGA](https://mega.nz/file/Jr4iVQrZ#YJl0XwnueoDA2uwXSc3y0H_FfSr3Dn2NMa-F_anCfyg)

## 解压 SDK

在 Ubuntu PC 上，使用如下命令解压 SDK。

<NewCodeBlock tip="Host-Linux$" type="host">
```
tar -xvzf rk3308_linux5.10_rkr8_sdk.repo.tar.gz
.repo/repo/repo sync -l
```
</NewCodeBlock>

## 添加板子 ROCK S0 支持

使用 Radxa 维护的 rockchip 仓库。

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd device/rockchip
git remote add radxa https://github.com/radxa/device-rockchip.git
git fetch radxa
git checkout -b rk3308-linux-5.10 remotes/radxa/rk3308-linux-5.10
```
</NewCodeBlock>

使用 Radxa 维护的 rkbin 仓库。

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd rkbin
git remote add radxa https://github.com/radxa/rkbin.git
git fetch radxa
git checkout -b develop-v2025.04 remotes/radxa/develop-v2025.04
```
</NewCodeBlock>

使用 Radxa 维护的 kernel 仓库。

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd kernel
git remote add radxa https://github.com/radxa/kernel.git
git fetch radxa
git checkout -b linux-5.10-gen-rkr8-buildroot remotes/radxa/linux-5.10-gen-rkr8-buildroot
```
</NewCodeBlock>

## 构建 SDK

在 SDK 的顶层目录，执行命令：

<NewCodeBlock tip="Host-Linux$" type="host">
```
./build.sh
```
</NewCodeBlock>

然后选中配置文件 `rockchip_rk3308_rock_s0_defconfig`。

构建完成后，将会在 `rockdev/` 目录下生成镜像。系统镜像文件是 `update.img`。

## 烧录镜像

### 烧录镜像到 EMMC 中

在 Linux/Mac OS 主机上，使用 [upgrade_tool](https://dl.radxa.com/tools/linux/Linux_Upgrade_Tool_V2.1.zip) 工具，通过 4-Pin USB2.0 OTG 烧录口，将系统镜像 `update.img` 烧写到 EMMC 中。

<NewCodeBlock tip="Host-PC$" type="host">
```
upgrade_tool uf update.img
```
</NewCodeBlock>

在 Windows 主机上，使用 `RKDevTool` 工具，通过 Type-A 烧录口，将系统镜像 `update.img` 烧写到 EMMC 中。

- ① : 让设备进入 Maskrom 模式

- ② : 选择 `Upgrade Firmware` 选项

- ③ : 点击 `Firmware` 选项，选择您编译出来的 `update.img`

- ④ : 点击 `Upgrade` 按钮，开始烧录系统镜像

<div style={{textAlign: 'center'}}>
<img src="/img/rock4/4d/other-os-burn-img.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

### 烧录镜像到 MicroSD Card 中

使用 SDDiskTool 将生成的镜像烧录到 MicroSD Card 中。

<SSDISKTOOL />
120 changes: 120 additions & 0 deletions i18n/en/docusaurus-plugin-content-docs/current/rockpi/rocks0/other-os/buildroot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
---
sidebar_position: 1
---

import SSDISKTOOL from "../../../common/general/\_sddisktool.mdx"

# Buildroot Build

## Environment Preparation

Prepare an Ubuntu 20.04/22.04 x86_64 host machine.

You can also work inside a virtual machine:

- ubuntu-22.04.5-live-server-amd64 VM with at least 120G of free disk space.

## Install Build Dependencies

<NewCodeBlock tip="Host-Linux$" type="host">
```
sudo apt update
sudo apt install python2 git rsync gcc g++ make device-tree-compiler bc flex bison lz4 libssl-dev libgmp-dev libmpc-dev expect expect-dev file unzip bzip2 fakeroot bsdmainutils
sudo ln -s /bin/python2 /bin/python
```
</NewCodeBlock>

## Download the Rockchip Reference SDK

- [Baidu Cloud](https://pan.baidu.com/s/1RWrkBVUtrAAEEu1dn_G0ww?pwd=e9nj)

- [MEGA](https://mega.nz/file/Jr4iVQrZ#YJl0XwnueoDA2uwXSc3y0H_FfSr3Dn2NMa-F_anCfyg)

## Extract the SDK

On the Ubuntu host, run the following commands to unpack the SDK:

<NewCodeBlock tip="Host-Linux$" type="host">
```
tar -xvzf rk3308_linux5.10_rkr8_sdk.repo.tar.gz
.repo/repo/repo sync -l
```
</NewCodeBlock>

## Add ROCK S0 Board Support

Use the Radxa-maintained rockchip repository:

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd device/rockchip
git remote add radxa https://github.com/radxa/device-rockchip.git
git fetch radxa
git checkout -b rk3308-linux-5.10 remotes/radxa/rk3308-linux-5.10
```
</NewCodeBlock>

Use the Radxa-maintained rkbin repository:

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd rkbin
git remote add radxa https://github.com/radxa/rkbin.git
git fetch radxa
git checkout -b develop-v2025.04 remotes/radxa/develop-v2025.04
```
</NewCodeBlock>

Use the Radxa-maintained kernel repository:

<NewCodeBlock tip="Host-Linux$" type="host">
```
cd kernel
git remote add radxa https://github.com/radxa/kernel.git
git fetch radxa
git checkout -b linux-5.10-gen-rkr8-buildroot remotes/radxa/linux-5.10-gen-rkr8-buildroot
```
</NewCodeBlock>

## Build the SDK

From the root of the SDK run:

<NewCodeBlock tip="Host-Linux$" type="host">
```
./build.sh
```
</NewCodeBlock>

Then choose the `rockchip_rk3308_rock_s0_defconfig` configuration file.

After the build finishes, images are produced under the `rockdev/` directory. The system image file is `update.img`.

## Flash the Image

### Flash the Image to eMMC

On a Linux or macOS host, use [upgrade_tool](https://dl.radxa.com/tools/linux/Linux_Upgrade_Tool_V2.1.zip) over the 4-pin USB2.0 OTG port to flash the `update.img` system image into eMMC:

<NewCodeBlock tip="Host-PC$" type="host">
```
upgrade_tool uf update.img
```
</NewCodeBlock>

On Windows, use `RKDevTool` via the Type-A flashing port to write `update.img` into eMMC:

- ①: Put the device into Maskrom mode.
- ②: Choose the `Upgrade Firmware` option.
- ③: Click `Firmware` and select the generated `update.img`.
- ④: Click `Upgrade` to start flashing the system image.

<div style={{textAlign: 'center'}}>
<img src="/en/img/rock4/4d/other-os-burn-img.webp" style={{width: '100%', maxWidth: '1200px'}} />
Copy link
Contributor

@windsurf-bot windsurf-bot bot Dec 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The image path /en/img/rock4/4d/other-os-burn-img.webp references a ROCK 4 image rather than a ROCK S0 specific image. Consider updating this to use a ROCK S0 specific screenshot to avoid confusion for users.

Copy link
Contributor Author

@EESN-W EESN-W Dec 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

没有问题，共用图片

</div>

### Flash the Image to a MicroSD Card

Use SDDiskTool to write the generated image to a MicroSD card.

<SSDISKTOOL />