diff --git a/bsp/rockchip/rk3500/Taishanpi-RK3566_CN.md b/bsp/rockchip/rk3500/Taishanpi-RK3566_CN.md new file mode 100644 index 00000000000..2d57bf174b9 --- /dev/null +++ b/bsp/rockchip/rk3500/Taishanpi-RK3566_CN.md @@ -0,0 +1,375 @@ +# Taishanpi-RK3566 板级支持包使用说明 + +中文页 | [English](./Taishanpi-RK3566_ZH.md) + +## 0. 说明 + +此文档使用的Commit: +- `a1c642aa3a2848b47f2a1b52679dc4ee5156f2f4` + +在[原有文档](./README.md)基础上面进行了文档补充和步骤说明，丰富了一下原有内容。 + +## 1. 介绍 + +这份支持包使用说明是根据[泰山派1](https://wiki.lckfb.com/zh-hans/tspi-rk3566/)所写的一份使用指南。 + +[泰山派1中原理图、PCB文件和软件资料全部开源](https://wiki.lckfb.com/zh-hans/tspi-rk3566/open-source-hardware/) + +在本指南中会尽可能的详细介绍使用步骤和相关注意事项。 + +### 1.1. 芯片介绍 + +`Rockchip RK3566` 是中高端 `AIOT` 芯片: + +- 采用`22nm`制程工艺。 +- `4`核`Cortex-A55`的`64`位CPU。 +- 主频高达`1.8GHz`。 +- 集成`ARM Mali-G52 GPU` +- 集成`1Tops`算力的`AI`加速器`NPU`； +- 支持`4K 60FPS`解码。 +- 支持`1080P 60FPS`解码。 +- 支持`5M ISP`和`HDR`。 + +### 1.2. 宿主机环境介绍 + +本次使用的是 `Ubuntu22.04.5 LTS Desktop` 运行在`VMware`中。 + +系统信息如下： + +```bash +$ cat /etc/os-release +PRETTY_NAME="Ubuntu 22.04.5 LTS" +NAME="Ubuntu" +VERSION_ID="22.04" +VERSION="22.04.5 LTS (Jammy Jellyfish)" +VERSION_CODENAME=jammy +ID=ubuntu +ID_LIKE=debian +HOME_URL="https://www.ubuntu.com/" +SUPPORT_URL="https://help.ubuntu.com/" +BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/" +PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy" +UBUNTU_CODENAME=jammy + +``` + +```bash +$ lsb_release -a +No LSB modules are available. +Distributor ID: Ubuntu +Description: Ubuntu 22.04.2 LTS +Release: 22.04 +Codename: jammy +``` + +`Python`版本如下： +```bash +$ python --version +Python 3.10.12 +``` + + +## 2. 环境搭建 + +运行下面的命令安装相关的软件包： + +1. 必要工具： +```bash +sudo apt update && \ +sudo apt install -y python3 python3-pip u-boot-tools device-tree-compiler +``` + +2. 使用`pip`安装工具： +```bash +pip3 install --user tqdm scons +``` + + +3. 设定`python`版本： +```bash +sudo rm -rf /usr/bin/python && \ +sudo ln -s /usr/bin/python3 /usr/bin/python +``` + + +4. 下载 `RT-Thread Smart` 工具链： +```bash +wget https://download.rt-thread.org/download/rt-smart/toolchains/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_latest.tar.bz2 + +``` + +5. 解压： +```bash +sudo tar -xf aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_latest.tar.bz2 -C /opt +``` + +5. 将工具链下载后，解压至`/opt`目录。并设置环境变量 + +> 直接复制全部，然后粘贴到命令行回车即可。 + +```bash +export RTT_CC="gcc" +export RTT_EXEC_PATH="/opt/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu/bin/" +export RTT_CC_PREFIX="aarch64-linux-musleabi-" +export PATH="$RTT_EXEC_PATH:$PATH" +``` + +## 3. 编译 + +进入`rt-thread/bsp/rockchip/rk3566`目录下输入下面的命令: + +进入 `menuconfig` 后直接 保存退出，生成一个 `.config` 文件： + +```bash +scons --menuconfig +``` + +> 拉取`zlib`软件包，我们编译的时候需要用到。 + +```bash +source ~/.env/tools/scripts/pkgs --update +``` + +开始编译： + +> 或者通过 `scons --exec-path="GCC工具链路径"` 命令，在指定工具链位置的同时直接编译。 + +```bash +scons -j$(nproc) +``` + +可以看到在当前`rk3566`文件夹中正常生成`rtthread.elf`与`rtthread.bin`文件。 + +## 3. 运行 + +### 3.1. 为板子烧录镜像 + +因为我需要在 `Uboot` 环境中使用命令进行引导 `rtthread` 系统，所以需要烧录相关的文件。 + +这里我是用的内核是 [泰山派1](https://wiki.lckfb.com/zh-hans/tspi-rk3566/) 的 `Rockchip Linux5.10 SDK`: + +- `Github`：https://github.com/TaishanPi + +- 教程看 [宿主机构建方式](https://wiki.lckfb.com/zh-hans/tspi-rk3566/sdk-compilation/openkylin-sdk-compilation.html) + +编译完成之后会在 `rockdev/` 目录下生成我们所需要的文件 + +将板子的所有镜像全部擦除： + +![rockchip-clean](./figures/rockchip-clean.jpg) + +然后使用`瑞芯微开发工具`烧录下面的`4`个文件： + +> > 注意: 因为我们的SDK是重新进行分区的，所以使用[泰山派1](https://wiki.lckfb.com/zh-hans/tspi-rk3566/)需要下面的`4`个文件，其他板子没有测试，可以自行尝试。 + +- `MiniLoaderAll.bin` +- `parameter.txt` +- `uboot.img` +- `boot.img` + +### 3.2. 格式化TF卡 + +我们需要准备一张 `TF` 卡，用来存放 `rtthread.bin` 文件。 + +下载 `Rufus`：https://rufus.org.cn/ + +设定为下列的模式，然后点击`开始`： + +![rockchip-clean](./figures/rufus.jpg) + + +### 3.3. 制作boot.scr + +> 这里可以直接使用当前目录下的 `boot.scr`，同样也是用下面的方式制作出来的，如果有需求可以根据下面的方法自己制作。 + +前面我们已经安装过 `u-boot-tools` 所以直接使用即可。 + +创建 `boot.cmd`，并写入下面的内容： + +```bash +fatload mmc 1:1 0x480000 rtthread.bin; +fatload mmc 1:1 0x8300000 tspi-rk3566-user-v10-linux.dtb; +booti 0x480000 - 0x8300000; +``` +> 系统启动需要`设备树文件DTB`，这里我们[泰山派1](https://wiki.lckfb.com/zh-hans/tspi-rk3566/)的`dtb`文件是`kernel/arch/arm64/boot/dts/rockchip/tspi-rk3566-user-v10-linux.dtb`，其他的文件有不同的名字，可以根据不同的开发板选择。不然`rtthread`就会无法启动，详情请看文档最后面的 `常见问题与解决办法` + + +运行生成`boot.scr` + +```bash +mkimage -C none -A arm -T script -d boot.cmd boot.scr +``` + +### 3.4. 复制文件到TF卡 + +将下面三个文件复制到TF中： + +- `boot.scr` +- `tspi-rk3566-user-v10-linux.dtb` +- `rtthread.bin` + +![tf](./figures/tf.jpg) + +### 3.5. 运行 + +连接[开发板串口->MoBaXterm](https://wiki.lckfb.com/zh-hans/tspi-rk3566/tool-use/debug-tools-use.html)： + +打开串口工具，选择对应串口，设置波特率为 `1500000` + +因为有 `boot.scr` 会自动引导启动`rtthread`: + +> 注意1：如果卡死在了 `[I/rtdm.ofw] Console: uart0 (fiq-debugger)` 那么看`常见问题与解决办法`。 + +> 注意2：记得每次`rtthread`启动失败(在`uboot`中引导失败后)，都应该将开发板完全断电然后在上电，清空内存。 + +> 注意3：如果多次自动引导失败可以手动在`uboot`界面运行 `boot.cmd` 的内容，手动引导，如果还不行，那就要考虑其他的因素了，例如TF质量问题，传输到TF卡中的文件有损坏等等等。 + +```bash +Hit key to stop autoboot('CTRL+C'): 0 +switch to partitions #0, OK +mmc1 is current device +Scanning mmc 1:1... +Found U-Boot script /boot.scr +reading /boot.scr +197 bytes read in 3 ms (63.5 KiB/s) +## Executing script at 00c00000 +reading rtthread.bin +1220848 bytes read in 104 ms (11.2 MiB/s) +reading tspi-rk3566-user-v10-linux.dtb +167469 bytes read in 17 ms (9.4 MiB/s) +Fdt Ramdisk skip relocation +No misc partition +## Flattened Device Tree blob at 0x08300000 + Booting using the fdt blob at 0x08300000 + Using Device Tree in place at 0000000008300000, end 000000000832be2c +No resource file: logo_kernel.bmp +** Unable to read file logo_kernel.bmp ** +Failed to do_load +VP0 fail to load kernel logo +vp0, plane_mask:0x3f, primary-id:4, curser-id:-1 +vp1, plane_mask:0x0, primary-id:0, curser-id:-1 +vp2, plane_mask:0x0, primary-id:0, curser-id:-1 +## reserved-memory: + drm-logo@00000000: addr=7df00000 size=ad000 + drm-cubic-lut@00000000: addr=7ff00000 size=8000 + ramoops@110000: addr=110000 size=f0000 +Adding bank: 0x00200000 - 0x08400000 (size: 0x08200000) +Adding bank: 0x09400000 - 0x80000000 (size: 0x76c00000) +board seed: Pseudo +Total: 600.154/648.331 ms + +Starting kernel ... + +[I/rtdm.ofw] Booting RT-Thread on physical CPU 0x0 +[I/rtdm.ofw] Machine model: lckfb tspi V10 Board +[I/rtdm.ofw] Earlycon: uart8250 at MMIO/PIO 0x00000000fe660000 (options '') +[I/rtdm.ofw] Memory node(1) ranges: 0x0000000000200000 - 0x0000000008400000 +[I/rtdm.ofw] Memory node(1) ranges: 0x0000000009400000 - 0x0000000080000000 +[I/mm.memblock] System memory: +[I/mm.memblock] [0x0000000000200000, 0x0000000008400000] +[I/mm.memblock] [0x0000000009400000, 0x0000000080000000] +[I/mm.memblock] Reserved memory: +[I/mm.memblock] [0x0000000000110000, 0x0000000000200000] +[I/mm.memblock] [0x0000000000480000, 0x00000000006d0000] +[I/mm.memblock] [0x00000000006d0000, 0x00000000046d0000] +[I/mm.memblock] [0x00000000046d0000, 0x00000000048d0000] +[I/mm.memblock] [0x00000000048d0000, 0x00000000048fa000] +[I/mm.memblock] [0x0000000008300000, 0x000000000832a000] +[I/mm.memblock] [0x000000007df00000, 0x000000007dfad000] +[I/mm.memblock] [0x000000007ff00000, 0x000000007ff08000] +[I/mm.memblock] physical memory region [0x0000000000200000-0x0000000000480000] installed to system page +[I/mm.memblock] physical memory region [0x00000000048fa000-0x0000000008300000] installed to system page +[I/mm.memblock] physical memory region [0x000000000832a000-0x0000000008400000] installed to system page +[I/mm.memblock] physical memory region [0x0000000009400000-0x000000007df00000] installed to system page +[I/mm.memblock] physical memory region [0x000000007dfad000-0x000000007ff00000] installed to system page +[I/mm.memblock] physical memory region [0x000000007ff08000-0x0000000080000000] installed to system page +[I/mm.memblock] 2055 MB memory installed to system page +[I/osi.psci] Using PSCI v1.1 Function IDs +[I/clk.rk3568] set cpu_freq to 1800000000 +[I/rtdm.ofw] Console: uart0 (fiq-debugger) + + \ | / +- RT - Thread Smart Operating System + / | \ 5.2.1 build Jul 30 2025 08:58:40 + 2006 - 2024 Copyright by RT-Thread team +lwIP-2.1.2 initialized! +[I/sal.skt] Socket Abstraction Layer initialize success. +[I/utest] utest is initialize success. +[I/utest] total utest testcase num: (5) +[I/drivers.serial] Using /dev/ttyS0 as default console +Press any key to stop init process startup ... 3 +Press any key to stop init process startup ... 2 +Press any key to stop init process startup ... 1 +Starting init ... +[E/DFS.fs] mount point (/proc) already mounted! +[I/rtdm.mnt] File system initialization done +Hi, this is RT-Thread!! +msh />I/TC: Secondary CPU 1 initializing +I/TC: Secondary CPU 1 switching to normal world boot +o/[C3:2 mS[eIc/ocnpdua.raya 6C4P]U 2 inCiatlila lcipzui n1g + n success +I/TC: Secondary CPU 2 switching to normal world boot +I/TC: Secondary CPU 3 initializing +I/TC: Secondary CPU 3 switching to normal world boot +[I/cpu.aa64] Call cpu 2 on success +[I/cpu.aa64] Call cpu 3 on success + +msh /> +msh /> +``` + +## 常见问题与解决办法 + +### Could not find a valid device tree + +我们没有加载 `.dtb` 设备树文件直接启动就会出现这样的情况： + +```bash +Hit key to stop autoboot('CTRL+C'): 0 +=> +=> +=> +=> +=> +=> fatload mmc 1:1 0x480000 rtthread.bin +reading rtthread.bin +1220848 bytes read in 104 ms (11.2 MiB/s) +=> booti 0x480000 - 0x8300000 +Fdt Ramdisk skip relocation +No misc partition +ERROR: Did not find a cmdline Flattened Device Tree +Could not find a valid device tree +=> +``` + +> 注意：记得每次`rtthread`启动失败(在`uboot`中引导失败后)，都应该将开发板完全断电然后在上电，清空内存。 + +然后将 `kernel/arch/arm64/boot/dts/rockchip/` 文件夹中编译之后的`.dtb`文件转移到TF卡中，然后使用 `fatload`从TF卡中加载到`0x8300000`地址然后再次跳转即可。 + + +### 卡在 `[I/rtdm.ofw] Console: uart0 (fiq-debugger)` 无法启动 + +大概率和你的设备树有关系，在设备树中有一个参数很重要，需要被读取： + +> 这里我贴出我的参数，我的`Debug`串口硬件是`uart2m0` + +> 这个`chosen` 是重要的，如果不清楚，可以参照我这么写。 + +```ini + chosen: chosen { + bootargs = "earlycon=uart8250,mmio32,0xfe660000 console=ttyFIQ0"; + }; + + fiq-debugger { + compatible = "rockchip,fiq-debugger"; + rockchip,serial-id = <2>; + rockchip,wake-irq = <0>; + /* If enable uart uses irq instead of fiq */ + rockchip,irq-mode-enable = <1>; + rockchip,baudrate = <1500000>; /* Only 115200 and 1500000 */ + interrupts = ; + pinctrl-names = "default"; + pinctrl-0 = <&uart2m0_xfer>; + status = "okay"; + }; +``` \ No newline at end of file diff --git a/bsp/rockchip/rk3500/Taishanpi-RK3566_ZH.md b/bsp/rockchip/rk3500/Taishanpi-RK3566_ZH.md new file mode 100644 index 00000000000..5afcd841a92 --- /dev/null +++ b/bsp/rockchip/rk3500/Taishanpi-RK3566_ZH.md @@ -0,0 +1,373 @@ +# Taishanpi-RK3566 Board Support Package (BSP) Usage Guide + +[中文页](./Taishanpi-RK3566_CN.md) | English + +## 0. Code Source Statement + +The commit used in this document: +- `a1c642aa3a2848b47f2a1b52679dc4ee5156f2f4` + +Based on the[original documentation](./README.md), this guide supplements and elaborates on the content with additional documentation and detailed step-by-step instructions. + +## 1. Introduction + +This support package usage guide is written based on the[ TaishanPi 1 ](https://wiki.lckfb.com/zh-hans/tspi-rk3566/)development board. + +[All schematic diagrams, PCB files, and software resources for TaishanPi 1 are open-source](https://wiki.lckfb.com/zh-hans/tspi-rk3566/open-source-hardware/) + +This guide provides detailed instructions and relevant precautions. + +### 1.1. Chip Introduction + +`Rockchip RK3566` is a mid-to-high-end `AIOT` chip: + +- Manufactured using `22nm` process technology +- Quad-core `Cortex-A55` 64-bit CPU +- Clock speed up to `1.8GHz` +- Integrated `ARM Mali-G52 GPU` +- Integrated `1Tops` AI accelerator `NPU` +- Supports `4K 60FPS` decoding +- Supports `1080P 60FPS` encoding +- Supports `5M ISP` and `HDR` + +### 1.2. Host Machine Environment + +This guide uses `Ubuntu22.04.5 LTS Desktop` running on`VMware`. + +System information: + +```bash +$ cat /etc/os-release +PRETTY_NAME="Ubuntu 22.04.5 LTS" +NAME="Ubuntu" +VERSION_ID="22.04" +VERSION="22.04.5 LTS (Jammy Jellyfish)" +VERSION_CODENAME=jammy +ID=ubuntu +ID_LIKE=debian +HOME_URL="https://www.ubuntu.com/" +SUPPORT_URL="https://help.ubuntu.com/" +BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/" +PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy" +UBUNTU_CODENAME=jammy + +``` + +```bash +$ lsb_release -a +No LSB modules are available. +Distributor ID: Ubuntu +Description: Ubuntu 22.04.2 LTS +Release: 22.04 +Codename: jammy +``` + +`Python`version: +```bash +$ python --version +Python 3.10.12 +``` + + +## 2. Environment Setup + +Run the following commands to install required packages: + +1. Essential tools: +```bash +sudo apt update && \ +sudo apt install -y python3 python3-pip u-boot-tools device-tree-compiler +``` + +2. Install tools using `pip`: +```bash +pip3 install --user tqdm scons +``` + + +3. Set `Python version`: +```bash +sudo rm -rf /usr/bin/python && \ +sudo ln -s /usr/bin/python3 /usr/bin/python +``` + + +4. Download `RT-Thread Smart` toolchain: +```bash +wget https://download.rt-thread.org/download/rt-smart/toolchains/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_latest.tar.bz2 + +``` + +5. Extract the toolchain: +```bash +sudo tar -xf aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_latest.tar.bz2 -C /opt +``` + +6. Set environment variables after extraction: + +```bash +export RTT_CC="gcc" +export RTT_EXEC_PATH="/opt/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu/bin/" +export RTT_CC_PREFIX="aarch64-linux-musleabi-" +export PATH="$RTT_EXEC_PATH:$PATH" +``` + +## 3. 编译 + +Navigate to the `rt-thread/bsp/rockchip/rk3566` directory and run: + +After entering `menuconfig`, simply save and exit to generate a `.config` file: + +```bash +scons --menuconfig +``` + +> This command pulls the `zlib` package required for compilation. + +```bash +source ~/.env/tools/scripts/pkgs --update +``` + +Start compilation: + +> Alternatively, use `scons --exec-path="GCC toolchain path"` to specify the toolchain location directly. + +```bash +scons -j$(nproc) +``` + +The `rtthread.elf` and `rtthread.bin` files will be generated in the current `rk3566` directory. + +## 3. Running + +### 3.1. Flashing the Board + +To boot the `rtthread` system using U-Boot commands, flash the following files using the Rockchip development tool. + +This guide uses the [ TaishanPi 1 ](https://wiki.lckfb.com/zh-hans/tspi-rk3566/) `Rockchip Linux5.10 SDK`: + +- `Github`：https://github.com/TaishanPi + +- Tutorial [Host Machine Build Method](https://wiki.lckfb.com/zh-hans/tspi-rk3566/sdk-compilation/openkylin-sdk-compilation.html) + +After compilation, required files will be in the `rockdev/` directory. + +Erase all existing firmware from the board: + +![rockchip-clean](./figures/rockchip-clean.jpg) + +Flash these 4 files using the Rockchip Development Tool: + +> > Note: The TaishanPi 1 SDK uses a custom partition layout. Other boards may require different files. + +- `MiniLoaderAll.bin` +- `parameter.txt` +- `uboot.img` +- `boot.img` + +### 3.2. Formatting the TF Card + +Prepare a TF card to store files. + +Download `Rufus`：https://rufus.org.cn/ + +Configure with these settings and click "Start": + +![rockchip-clean](./figures/rufus.jpg) + + +### 3.3. Creating boot.scr + +> You can use the existing `boot.scr` in this directory, or create your own using the method below. + +Create `boot.cmd` with the following content: + +```bash +fatload mmc 1:1 0x480000 rtthread.bin; +fatload mmc 1:1 0x8300000 tspi-rk3566-user-v10-linux.dtb; +booti 0x480000 - 0x8300000; +``` +> The Device Tree Blob (DTB) file is required for system startup. For TaishanPi 1, the DTB file is located at `kernel/arch/arm64/boot/dts/rockchip/tspi-rk3566-user-v10-linux.dtb`. Other boards may use different DTB files. Without the correct DTB, rtthread will fail to boot (see "Common Issues and Solutions"). + + +Generate `boot.scr` + +```bash +mkimage -C none -A arm -T script -d boot.cmd boot.scr +``` + +### 3.4. Copying Files to TF Card + +Copy these three files to the TF card: + +- `boot.scr` +- `tspi-rk3566-user-v10-linux.dtb` +- `rtthread.bin` + +![tf](./figures/tf.jpg) + +### 3.5. Running + +Connect to the board's serial port using a tool like [MoBaXterm](https://wiki.lckfb.com/zh-hans/tspi-rk3566/tool-use/debug-tools-use.html)： + +- Select the correct serial port +- Set baud rate to `1500000` + +With `boot.scr` present, the system will boot automatically: + +> Note 1: If stuck at `[I/rtdm.ofw] Console: uart0 (fiq-debugger)`, see "Common Issues and Solutions". + +> Note 2: After failed boot attempts, completely power cycle the board to clear memory. + +> Note 3: If automatic boot fails, manually execute the `boot.cmd` content in U-Boot. + +```bash +Hit key to stop autoboot('CTRL+C'): 0 +switch to partitions #0, OK +mmc1 is current device +Scanning mmc 1:1... +Found U-Boot script /boot.scr +reading /boot.scr +197 bytes read in 3 ms (63.5 KiB/s) +## Executing script at 00c00000 +reading rtthread.bin +1220848 bytes read in 104 ms (11.2 MiB/s) +reading tspi-rk3566-user-v10-linux.dtb +167469 bytes read in 17 ms (9.4 MiB/s) +Fdt Ramdisk skip relocation +No misc partition +## Flattened Device Tree blob at 0x08300000 + Booting using the fdt blob at 0x08300000 + Using Device Tree in place at 0000000008300000, end 000000000832be2c +No resource file: logo_kernel.bmp +** Unable to read file logo_kernel.bmp ** +Failed to do_load +VP0 fail to load kernel logo +vp0, plane_mask:0x3f, primary-id:4, curser-id:-1 +vp1, plane_mask:0x0, primary-id:0, curser-id:-1 +vp2, plane_mask:0x0, primary-id:0, curser-id:-1 +## reserved-memory: + drm-logo@00000000: addr=7df00000 size=ad000 + drm-cubic-lut@00000000: addr=7ff00000 size=8000 + ramoops@110000: addr=110000 size=f0000 +Adding bank: 0x00200000 - 0x08400000 (size: 0x08200000) +Adding bank: 0x09400000 - 0x80000000 (size: 0x76c00000) +board seed: Pseudo +Total: 600.154/648.331 ms + +Starting kernel ... + +[I/rtdm.ofw] Booting RT-Thread on physical CPU 0x0 +[I/rtdm.ofw] Machine model: lckfb tspi V10 Board +[I/rtdm.ofw] Earlycon: uart8250 at MMIO/PIO 0x00000000fe660000 (options '') +[I/rtdm.ofw] Memory node(1) ranges: 0x0000000000200000 - 0x0000000008400000 +[I/rtdm.ofw] Memory node(1) ranges: 0x0000000009400000 - 0x0000000080000000 +[I/mm.memblock] System memory: +[I/mm.memblock] [0x0000000000200000, 0x0000000008400000] +[I/mm.memblock] [0x0000000009400000, 0x0000000080000000] +[I/mm.memblock] Reserved memory: +[I/mm.memblock] [0x0000000000110000, 0x0000000000200000] +[I/mm.memblock] [0x0000000000480000, 0x00000000006d0000] +[I/mm.memblock] [0x00000000006d0000, 0x00000000046d0000] +[I/mm.memblock] [0x00000000046d0000, 0x00000000048d0000] +[I/mm.memblock] [0x00000000048d0000, 0x00000000048fa000] +[I/mm.memblock] [0x0000000008300000, 0x000000000832a000] +[I/mm.memblock] [0x000000007df00000, 0x000000007dfad000] +[I/mm.memblock] [0x000000007ff00000, 0x000000007ff08000] +[I/mm.memblock] physical memory region [0x0000000000200000-0x0000000000480000] installed to system page +[I/mm.memblock] physical memory region [0x00000000048fa000-0x0000000008300000] installed to system page +[I/mm.memblock] physical memory region [0x000000000832a000-0x0000000008400000] installed to system page +[I/mm.memblock] physical memory region [0x0000000009400000-0x000000007df00000] installed to system page +[I/mm.memblock] physical memory region [0x000000007dfad000-0x000000007ff00000] installed to system page +[I/mm.memblock] physical memory region [0x000000007ff08000-0x0000000080000000] installed to system page +[I/mm.memblock] 2055 MB memory installed to system page +[I/osi.psci] Using PSCI v1.1 Function IDs +[I/clk.rk3568] set cpu_freq to 1800000000 +[I/rtdm.ofw] Console: uart0 (fiq-debugger) + + \ | / +- RT - Thread Smart Operating System + / | \ 5.2.1 build Jul 30 2025 08:58:40 + 2006 - 2024 Copyright by RT-Thread team +lwIP-2.1.2 initialized! +[I/sal.skt] Socket Abstraction Layer initialize success. +[I/utest] utest is initialize success. +[I/utest] total utest testcase num: (5) +[I/drivers.serial] Using /dev/ttyS0 as default console +Press any key to stop init process startup ... 3 +Press any key to stop init process startup ... 2 +Press any key to stop init process startup ... 1 +Starting init ... +[E/DFS.fs] mount point (/proc) already mounted! +[I/rtdm.mnt] File system initialization done +Hi, this is RT-Thread!! +msh />I/TC: Secondary CPU 1 initializing +I/TC: Secondary CPU 1 switching to normal world boot +o/[C3:2 mS[eIc/ocnpdua.raya 6C4P]U 2 inCiatlila lcipzui n1g + n success +I/TC: Secondary CPU 2 switching to normal world boot +I/TC: Secondary CPU 3 initializing +I/TC: Secondary CPU 3 switching to normal world boot +[I/cpu.aa64] Call cpu 2 on success +[I/cpu.aa64] Call cpu 3 on success + +msh /> +msh /> +``` + +## Common Issues and Solutions + +### Could not find a valid device tree + +This error occurs when booting without loading the `.dtb` device tree file: + +```bash +Hit key to stop autoboot('CTRL+C'): 0 +=> +=> +=> +=> +=> +=> fatload mmc 1:1 0x480000 rtthread.bin +reading rtthread.bin +1220848 bytes read in 104 ms (11.2 MiB/s) +=> booti 0x480000 - 0x8300000 +Fdt Ramdisk skip relocation +No misc partition +ERROR: Did not find a cmdline Flattened Device Tree +Could not find a valid device tree +=> +``` + +Solution: + +1. Power cycle the board completely after failed boot attempts +2. Copy the compiled `.dtb` file from `kernel/arch/arm64/boot/dts/rockchip/` to the TF card +3. Load the `DTB` to address `0x8300000` using `fatload` +4. Execute the boot command again + + +### System Stuck at `[I/rtdm.ofw] Console: uart0 (fiq-debugger)` + +This is typically caused by incorrect device tree configuration. The `chosen` node parameters are critical. + +Example configuration for TaishanPi 1 (Debug UART: `uart2m0`): + +```ini + chosen: chosen { + bootargs = "earlycon=uart8250,mmio32,0xfe660000 console=ttyFIQ0"; + }; + + fiq-debugger { + compatible = "rockchip,fiq-debugger"; + rockchip,serial-id = <2>; + rockchip,wake-irq = <0>; + /* If enable uart uses irq instead of fiq */ + rockchip,irq-mode-enable = <1>; + rockchip,baudrate = <1500000>; /* Only 115200 and 1500000 */ + interrupts = ; + pinctrl-names = "default"; + pinctrl-0 = <&uart2m0_xfer>; + status = "okay"; + }; +``` \ No newline at end of file diff --git a/bsp/rockchip/rk3500/figures/rockchip-clean.jpg b/bsp/rockchip/rk3500/figures/rockchip-clean.jpg new file mode 100644 index 00000000000..eae2deac956 Binary files /dev/null and b/bsp/rockchip/rk3500/figures/rockchip-clean.jpg differ diff --git a/bsp/rockchip/rk3500/figures/rufus.jpg b/bsp/rockchip/rk3500/figures/rufus.jpg new file mode 100644 index 00000000000..3a116a8bc2e Binary files /dev/null and b/bsp/rockchip/rk3500/figures/rufus.jpg differ diff --git a/bsp/rockchip/rk3500/figures/tf.jpg b/bsp/rockchip/rk3500/figures/tf.jpg new file mode 100644 index 00000000000..8d63a47a9ae Binary files /dev/null and b/bsp/rockchip/rk3500/figures/tf.jpg differ