diff --git a/docs/rockpi/rocks0/other-os/buildroot.md b/docs/rockpi/rocks0/other-os/buildroot.md new file mode 100644 index 000000000..bc5575d90 --- /dev/null +++ b/docs/rockpi/rocks0/other-os/buildroot.md @@ -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。 + +## 安装编译依赖包 + + +``` +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 +``` + + +## 获取 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。 + + +``` +tar -xvzf rk3308_linux5.10_rkr8_sdk.repo.tar.gz +.repo/repo/repo sync -l +``` + + +## 添加板子 ROCK S0 支持 + +使用 Radxa 维护的 rockchip 仓库。 + + +``` +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 +``` + + +使用 Radxa 维护的 rkbin 仓库。 + + +``` +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 +``` + + +使用 Radxa 维护的 kernel 仓库。 + + +``` +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 +``` + + +## 构建 SDK + +在 SDK 的顶层目录，执行命令： + + +``` +./build.sh +``` + + +然后选中配置文件 `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 中。 + + +``` +upgrade_tool uf update.img +``` + + +在 Windows 主机上，使用 `RKDevTool` 工具，通过 Type-A 烧录口，将系统镜像 `update.img` 烧写到 EMMC 中。 + +- ① : 让设备进入 Maskrom 模式 + +- ② : 选择 `Upgrade Firmware` 选项 + +- ③ : 点击 `Firmware` 选项，选择您编译出来的 `update.img` + +- ④ : 点击 `Upgrade` 按钮，开始烧录系统镜像 + +
+ +
+ +### 烧录镜像到 MicroSD Card 中 + +使用 SDDiskTool 将生成的镜像烧录到 MicroSD Card 中。 + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rocks0/other-os/buildroot.md b/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rocks0/other-os/buildroot.md new file mode 100644 index 000000000..b516973e8 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/rockpi/rocks0/other-os/buildroot.md @@ -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 + + +``` +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 +``` + + +## 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: + + +``` +tar -xvzf rk3308_linux5.10_rkr8_sdk.repo.tar.gz +.repo/repo/repo sync -l +``` + + +## Add ROCK S0 Board Support + +Use the Radxa-maintained rockchip repository: + + +``` +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 +``` + + +Use the Radxa-maintained rkbin repository: + + +``` +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 +``` + + +Use the Radxa-maintained kernel repository: + + +``` +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 +``` + + +## Build the SDK + +From the root of the SDK run: + + +``` +./build.sh +``` + + +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: + + +``` +upgrade_tool uf update.img +``` + + +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. + +
+ +
+ +### Flash the Image to a MicroSD Card + +Use SDDiskTool to write the generated image to a MicroSD card. + +