add rk3500 doc

Author: rcitach

bsp/rockchip/rk3500/README.md

@@ -1,75 +1,197 @@
-
-
-
-
 # RK3568 BSP Introduction
 
-[中文页]() | English
+[中文页](./README_ZH.md) | English
 
 ## 1. Introduction
 
-RK3568 is a general-purpose SOC, quad-core 64-bit Cortex-A55 processor, with 22nm lithography process, has frequency up to 2.0GHz and Mali G52 GPU, support 4K decoding and 1080P encoding. Support mangy interfaces such as SATA/PCIE/USB3.0, an 0.8T NPU for lightweight AI applications. Support dual Gigabit Ethernet ports, LPDDR4 memory, etc.
-
-This project ported RT-Thread on RK3568, you can use the RADXA ROCK 3A version of the RK3568 in low-priced, which can even replace the Raspberry Pi 4B.
+### Core Architecture
+
+- **CPU**: Quad-core 64-bit ARM Cortex-A55
+- **Process Node**: 22nm FinFET
+- **Clock Speed**: Up to 1.8GHz (boost)
+
+### Graphics Subsystem
+
+- **GPU**: ARM Mali-G52 MP2
+  - Graphics APIs:
+    - OpenGL ES 3.2/2.0/1.1
+    - Vulkan 1.1
+  - Display Outputs:
+    - HDMI 2.0b
+    - eDP 1.3
+    - MIPI-DSI (4 lanes)
+- **Video Processing**:
+  - Decoding: 4K@60fps (H.265/H.264/VP9)
+  - Encoding: 1080P@60fps (H.264/H.265)
+
+### Memory & Storage
+
+- **RAM Support**:
+  - Dual-channel LPDDR4/LPDDR4X
+  - Max Capacity: 8GB
+- **Storage Options**:
+  - eMMC 5.1 HS400
+  - SD 3.0 UHS-I
+  - Optional SATA III (6Gbps)
+- **High-Speed Interfaces**:
+  - USB 3.0 Type-A/C
+  - PCIe 2.1 (x1 lane)
+
+### AI Acceleration
+
+- **NPU**: 0.8 TOPS INT8
+  - Framework Support:
+    - TensorFlow Lite
+    - MXNet
+    - PyTorch Mobile
+
+### Connectivity
+
+- **Wired**:
+  - Dual Gigabit Ethernet (RGMII)
+- **Wireless**:
+  - Expansion via:
+    - PCIe-based WiFi6
+    - USB Bluetooth 5.0
+
+### Multimedia I/O
+
+- **Camera Input**:
+  - Dual 4-lane MIPI-CSI
+  - Supports up to 13MP sensors
 
 ## 2. Compiling
 
-Usage ARM Developer GNU ToolChain, it support Linux and Windows:
+Use the RT-Thread Smart dedicated toolchain to compile:
 
 ```plaintext
-https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-a/downloads/
-```
-
-
+wget https://github.com/RT-Thread/rt-thread/releases/download/v5.2.0/aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_242520-979be38cba.tar.bz2
 
-Download the `xxx-aarch64-none-elf` of x86_64 hosted platform, set the `RTT_EXEC_PATH` is system environment after decompress the binary.
+sudo tar -xf aarch64-linux-musleabi_for_x86_64-pc-linux-gnu_242520-979be38cba.tar.bz2 -C /opt
+```
 
-Enter directory `rt-thread/bsp/qemu-virt64-aarch64` and input:
+After downloading, extract the toolchain to the /opt directory.Then configure your environment variables:
 
 ```plaintext
-scons
+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"
 ```
 
+Navigate to the rt-thread/bsp/rockchip/rk3500 directory and enter:
 
+```shell
+scons --menuconfig
+```
 
-## 3. Execution
-
-RK3568 has different Kernel install methods according to different boardsit, recommend to install into the SD card: ([Official](https://wiki.t-firefly.com/en/ROC-RK3568-PC/hardware_doc.html)|[RADXA ROCK 3A](https://wiki.radxa.com/Rock3/install/microSD)).
+Select and pull the zlib package in the menu:
+![zlib_pack](./figures/zlib_pack.png)
 
-After install Kernel, storage the `rtthread.bin` to EFI partition (the second partition), and add this line in the front of `boot.cmd` in this partition:
+Then run the following commands to fetch packages and build the project:
 
 ```shell
-fatload mmc 1:1 0x208000 /rtthread.bin;dcache flush;go 0x208000
+source  ~/.env/tools/scripts/pkgs --update
+
+scons
 ```
 
+## 3. Execution
 
+The RK3566 SoC uses different methods to install the kernel depending on the board.It is recommended to install and boot from an SD card.The following steps take the Orange Pi Compute Module 4 as an example:
 
-After modifying the script, build a binary script `boot.scr ` in this partition:
+Connect the serial port of the development board:
+![uart](./figures/uart.png)
 
-```shell
-# Install the uboot-mkimage package on Linux, or use MSYS2 to install the u-boot-tools package on Windows
-mkimage -C none -A arm -T script -d boot.cmd boot.scr
-```
+1. Open a serial terminal, select the correct serial port, and set the baud rate to 1500000.
 
+2. Copy the generated rtthread.bin file to the SD card.
 
+3. Power up the development board and press Ctrl + C on the keyboard to enter U-Boot command line mode.
+![uboot_cmd](./figures/uboot_cmd.png)
 
-According to different boards, the serial port can support up to UART0~9, this project uses UART2 ([Official](https://wiki.t-firefly.com/en/ROC-RK3568-PC/debug.html)|[RADXA ROCK 3A](https://wiki.radxa.com/Rock3/dev/serial-console)) by default, the baud rate is 1500000, please make sure that the serial port used supports this baud rate.
+4. Enter the following command to load and boot the Smart system:
+
+```shell
+fatload mmc 1:1 0x480000 rtthread.bin;booti 0x480000 - 0x8300000
+```
 
 ```plaintext
-heap: [0x002663f0 - 0x042663f0]
+reading rtthread.bin
+1188080 bytes read in 102 ms (11.1 MiB/s)
+Fdt Ramdisk skip relocation
+## Flattened Device Tree blob at 0x08300000
+   Booting using the fdt blob at 0x08300000
+  'reserved-memory' linux,cma: addr=10000000 size=800000
+  'reserved-memory' ramoops@110000: addr=110000 size=f0000
+   Using Device Tree in place at 0000000008300000, end 000000000832048e
+Adding bank: 0x00200000 - 0x08400000 (size: 0x08200000)
+Adding bank: 0x09400000 - 0xf0000000 (size: 0xe6c00000)
+Adding bank: 0x1f0000000 - 0x200000000 (size: 0x10000000)
+== DO RELOCATE == Kernel from 0x00280000 to 0x00480000
+Total: 107148.892 ms
+
+Starting kernel ...
+
+[I/rtdm.ofw] Booting RT-Thread on physical CPU 0x0
+[I/rtdm.ofw] Machine model: Rockchip RK3566 Orange Pi CM4 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 - 0x00000000f0000000
+[I/rtdm.ofw] Memory node(1) ranges: 0x00000001f0000000 - 0x0000000200000000
+[I/mm.memblock] System memory:
+[I/mm.memblock]            [0x0000000000200000, 0x0000000008400000]
+[I/mm.memblock]            [0x0000000009400000, 0x00000000f0000000]
+[I/mm.memblock]            [0x00000001f0000000, 0x0000000200000000]
+[I/mm.memblock] Reserved memory:
+[I/mm.memblock]            [0x0000000000110000, 0x0000000000200000]
+[I/mm.memblock]            [0x0000000000480000, 0x00000000006c7000]
+[I/mm.memblock]            [0x00000000006c7000, 0x00000000046c7000]
+[I/mm.memblock]            [0x00000000046c7000, 0x00000000048c7000]
+[I/mm.memblock]            [0x00000000048c7000, 0x00000000048e5000]
+[I/mm.memblock]            [0x0000000008300000, 0x000000000831e000]
+[I/mm.memblock]            [0x0000000010000000, 0x0000000010800000]
+[I/mm.memblock]            [0x00000000edf00000, 0x00000000ee367400]
+[I/mm.memblock]            [0x00000000eff00000, 0x00000000eff08000]
+[I/mm.memblock] physical memory region [0x0000000000200000-0x0000000000480000] installed to system page
+[I/mm.memblock] physical memory region [0x00000000048e5000-0x0000000008300000] installed to system page
+[I/mm.memblock] physical memory region [0x000000000831e000-0x0000000008400000] installed to system page
+[I/mm.memblock] physical memory region [0x0000000009400000-0x0000000010000000] installed to system page
+[I/mm.memblock] physical memory region [0x0000000010800000-0x00000000edf00000] installed to system page
+[I/mm.memblock] physical memory region [0x00000000ee368000-0x00000000eff00000] installed to system page
+[I/mm.memblock] physical memory region [0x00000000eff08000-0x00000000f0000000] installed to system page
+[I/mm.memblock] physical memory region [0x00000001f0000000-0x0000000200000000] installed to system page
+[I/mm.memblock] 4191 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 Operating System
- / | \     4.1.0 build Mar 19 2022 17:17:29
- 2006 - 2022 Copyright by RT-Thread team
+- RT -     Thread Smart Operating System
+ / | \     5.2.1 build Apr 28 2025 09:19:08
+ 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 ...
+[I/rtdm.mnt] File system initialization done
 Hi, this is RT-Thread!!
-msh />
-```
-
-
+msh />I/TC: Secondary CPU 1 initializing
+I/TC: Secondary CPU 1 switching to normal world boot
+[I/cpu.aa64] Call cpu 1 on success
+I/TC: Secondary CPU 3 initializing
+I/TC: Secondary CPU 3 switching to normal world boot
+I/TC: Secondary CPU 2 initializing
+I/TC: Secondary CPU 2 switching to normal world boot
+[I/cpu.aa64] Call cpu 3 on success
+[I/cpu.aa64] Call cpu 2 on success
 
-## 4. Condition
+msh />
+msh />
 
-| Driver | Condition | Remark  |
-| ------ | --------- | ------- |
-| UART   | Support   | UART0~9 |
+```