mirror of
https://github.com/AsahiLinux/u-boot
synced 2025-03-05 15:57:39 +00:00
b8fc65473a
ROCK 5A is a Rockchip RK3588S based SBC (Single Board Computer) by Radxa.
There are tree variants depending on the DRAM size : 4G, 8G and 16G.
Specifications:
Rockchip Rk3588S SoC
4x ARM Cortex-A76, 4x ARM Cortex-A55
4/8/16GB memory LPDDR4x
Mali G610MC4 GPU
MIPI CSI 2 multiple lanes connector
4-lane MIPI DSI connector
Audio – 3.5mm earphone jack
eMMC module connector
uSD slot (up to 128GB)
2x USB 2.0, 2x USB 3.0
2x micro HDMI 2.1 ports, one up to 8Kp60, the other up to 4Kp60
Gigabit Ethernet RJ45 with optional PoE support
40-pin IO header including UART, SPI, I2C and 5V DC power in
USB PD over USB Type-C
Size: 85mm x 56mm (Raspberry Pi 4 form factor)
Kernel commits:
d1824cf95799 ("arm64: dts: rockchip: Add rock-5a board")
991f136c9f8d ("arm64: dts: rockchip: Update sdhci alias for rock-5a")
304c8a759953 ("arm64: dts: rockchip: Remove empty line from rock-5a")
cda0c2ea65a0 ("arm64: dts: rockchip: Fix RX delay for ethernet phy on rk3588s-rock5a")
Signed-off-by: Eugen Hristev <eugen.hristev@collabora.com>
Reviewed-by: Kever Yang <kever.yang@rock-chips.com>
430 lines
11 KiB
ReStructuredText
430 lines
11 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+
|
|
.. Copyright (C) 2019 Jagan Teki <jagan@amarulasolutions.com>
|
|
|
|
ROCKCHIP
|
|
========
|
|
|
|
About this
|
|
----------
|
|
|
|
This document describes the information about Rockchip supported boards
|
|
and it's usage steps.
|
|
|
|
Rockchip boards
|
|
---------------
|
|
|
|
Rockchip is a SoC solutions provider for tablets & PCs, streaming media
|
|
TV boxes, AI audio & vision, IoT hardware.
|
|
|
|
A wide range of Rockchip SoCs with associated boards are supported in
|
|
mainline U-Boot.
|
|
|
|
List of mainline supported Rockchip boards:
|
|
|
|
* px30
|
|
- Rockchip Evb-PX30 (evb-px30)
|
|
- Engicam PX30.Core C.TOUCH 2.0 (px30-core-ctouch2-px30)
|
|
- Engicam PX30.Core C.TOUCH 2.0 10.1 (px30-core-ctouch2-of10-px30)
|
|
- Engicam PX30.Core EDIMM2.2 Starter Kit (px30-core-edimm2.2-px30)
|
|
- Firefly Core-PX30-JD4 (firefly-px30)
|
|
- Theobroma Systems PX30-µQ7 SoM - Ringneck (ringneck-px30)
|
|
* rk3036
|
|
- Rockchip Evb-RK3036 (evb-rk3036)
|
|
- Kylin (kylin_rk3036)
|
|
* rk3066
|
|
- Rikomagic MK808 (mk808)
|
|
* rk3128
|
|
- Rockchip Evb-RK3128 (evb-rk3128)
|
|
* rk3188
|
|
- Radxa Rock (rock)
|
|
* rk3229
|
|
- Rockchip Evb-RK3229 (evb-rk3229)
|
|
* rk3288
|
|
- Rockchip Evb-RK3288 (evb-rk3288)
|
|
- Firefly-RK3288 (firefly-rk3288)
|
|
- MQmaker MiQi (miqi-rk3288)
|
|
- Phytec RK3288 PCM-947 (phycore-rk3288)
|
|
- PopMetal-RK3288 (popmetal-rk3288)
|
|
- Radxa Rock 2 Square (rock2)
|
|
- Tinker-RK3288 (tinker-rk3288)
|
|
- Google Jerry (chromebook_jerry)
|
|
- Google Mickey (chromebook_mickey)
|
|
- Google Minnie (chromebook_minnie)
|
|
- Google Speedy (chromebook_speedy)
|
|
- Amarula Vyasa-RK3288 (vyasa-rk3288)
|
|
* rk3308
|
|
- Rockchip Evb-RK3308 (evb-rk3308)
|
|
- Roc-cc-RK3308 (roc-cc-rk3308)
|
|
* rk3326
|
|
- ODROID-GO Advance (odroid-go2)
|
|
* rk3328
|
|
- Rockchip Evb-RK3328 (evb-rk3328)
|
|
- Pine64 Rock64 (rock64-rk3328)
|
|
- Firefly-RK3328 (roc-cc-rk3328)
|
|
- Radxa Rockpi E (rock-pi-e-rk3328)
|
|
* rk3368
|
|
- GeekBox (geekbox)
|
|
- PX5 EVB (evb-px5)
|
|
- Rockchip Sheep (sheep-rk3368)
|
|
- Theobroma Systems RK3368-uQ7 SoM - Lion (lion-rk3368)
|
|
* rk3399
|
|
- 96boards RK3399 Ficus (ficus-rk3399)
|
|
- 96boards Rock960 (rock960-rk3399)
|
|
- Firefly-RK3399 (firefly_rk3399)
|
|
- Firefly ROC-RK3399-PC
|
|
- FriendlyElec NanoPC-T4 (nanopc-t4-rk3399)
|
|
- FriendlyElec NanoPi M4 (nanopi-m4-rk3399)
|
|
- FriendlyElec NanoPi M4B (nanopi-m4b-rk3399)
|
|
- FriendlyARM NanoPi NEO4 (nanopi-neo4-rk3399)
|
|
- Google Bob (chromebook_bob)
|
|
- Google Kevin (chromebook_kevin)
|
|
- Khadas Edge (khadas-edge-rk3399)
|
|
- Khadas Edge-Captain (khadas-edge-captain-rk3399)
|
|
- Khadas Edge-V (hadas-edge-v-rk3399)
|
|
- Orange Pi RK3399 (orangepi-rk3399)
|
|
- Pine64 RockPro64 (rockpro64-rk3399)
|
|
- Radxa ROCK 4C+ (rock-4c-plus-rk3399)
|
|
- Radxa ROCK 4SE (rock-4se-rk3399)
|
|
- Radxa ROCK Pi 4A/B/A+/B+ (rock-pi-4-rk3399)
|
|
- Radxa ROCK Pi 4C (rock-pi-4c-rk3399)
|
|
- Rockchip Evb-RK3399 (evb_rk3399)
|
|
- Theobroma Systems RK3399-Q7 SoM - Puma (puma_rk3399)
|
|
|
|
* rk3566
|
|
- Anbernic RGxx3 (rgxx3-rk3566)
|
|
|
|
* rk3568
|
|
- Rockchip Evb-RK3568 (evb-rk3568)
|
|
- Hardkernel ODROID-M1 (odroid-m1-rk3568)
|
|
- Pine64 Quartz64-A Board (quartz64-a-rk3566_defconfig)
|
|
- Pine64 Quartz64-B Board (quartz64-b-rk3566_defconfig)
|
|
- Pine64 SOQuartz on Blade (soquartz-blade-rk3566_defconfig)
|
|
- Pine64 SOQuartz on CM4-IO (soquartz-cm4-rk3566_defconfig)
|
|
- Pine64 SOQuartz on Model A (soquartz-model-a-rk3566_defconfig)
|
|
|
|
* rk3588
|
|
- Rockchip EVB (evb-rk3588)
|
|
- Edgeble Neural Compute Module 6A SoM - Neu6a (neu6a-io-rk3588)
|
|
- Edgeble Neural Compute Module 6B SoM - Neu6b (neu6b-io-rk3588)
|
|
- Radxa ROCK 5A (rock5a-rk3588s)
|
|
- Radxa ROCK 5B (rock5b-rk3588)
|
|
|
|
* rv1108
|
|
- Rockchip Evb-rv1108 (evb-rv1108)
|
|
- Elgin-R1 (elgin-rv1108)
|
|
|
|
* rv1126
|
|
- Edgeble Neural Compute Module 2 SoM - Neu2/Neu2k (neu2-io-r1126)
|
|
|
|
Building
|
|
--------
|
|
|
|
TF-A
|
|
^^^^
|
|
|
|
TF-A is required when building ARM64 Rockchip SoCs images.
|
|
|
|
To build TF-A:
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone --depth 1 https://github.com/ARM-software/arm-trusted-firmware.git
|
|
cd arm-trusted-firmware
|
|
make realclean
|
|
make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399
|
|
cd ..
|
|
|
|
Specify the PLAT= with desired Rockchip platform to build TF-A for.
|
|
|
|
U-Boot
|
|
^^^^^^
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone --depth 1 https://source.denx.de/u-boot/u-boot.git
|
|
cd u-boot
|
|
|
|
To build px30 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../arm-trusted-firmware/build/px30/release/bl31/bl31.elf
|
|
make evb-px30_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
To build rk3066 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
make mk808_defconfig
|
|
make CROSS_COMPILE=arm-linux-gnueabihf-
|
|
|
|
To build rk3288 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
make evb-rk3288_defconfig
|
|
make CROSS_COMPILE=arm-linux-gnueabihf-
|
|
|
|
To build rk3328 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../arm-trusted-firmware/build/rk3328/release/bl31/bl31.elf
|
|
make evb-rk3328_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
To build rk3368 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../arm-trusted-firmware/build/rk3368/release/bl31/bl31.elf
|
|
make evb-px5_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
To build rk3399 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../arm-trusted-firmware/build/rk3399/release/bl31/bl31.elf
|
|
make evb-rk3399_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
To build rk3568 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../arm-trusted-firmware/build/rk3568/release/bl31/bl31.elf
|
|
[or]export BL31=../rkbin/bin/rk35/rk3568_bl31_v1.34.elf
|
|
export ROCKCHIP_TPL=../rkbin/bin/rk35/rk3568_ddr_1560MHz_v1.13.bin
|
|
make evb-rk3568_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
To build rk3588 boards:
|
|
|
|
.. code-block:: bash
|
|
|
|
export BL31=../rkbin/bin/rk35/rk3588_bl31_v1.33.elf
|
|
export ROCKCHIP_TPL=../rkbin/bin/rk35/rk3588_ddr_lp4_2112MHz_lp5_2736MHz_v1.09.bin
|
|
make evb-rk3588_defconfig
|
|
make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
Flashing
|
|
--------
|
|
|
|
1. Package the image with U-Boot TPL/SPL
|
|
-----------------------------------------
|
|
|
|
SD Card
|
|
^^^^^^^
|
|
|
|
All Rockchip platforms (except rk3128 which doesn't use SPL) are now
|
|
supporting a single boot image using binman.
|
|
|
|
To write an image that boots from a SD card (assumed to be /dev/sda):
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dd if=u-boot-rockchip.bin of=/dev/sda seek=64
|
|
sync
|
|
|
|
eMMC
|
|
^^^^
|
|
|
|
eMMC flash would probe on mmc0 in most of the Rockchip platforms.
|
|
|
|
Create GPT partition layout as defined in $partitions:
|
|
|
|
.. code-block:: bash
|
|
|
|
mmc dev 0
|
|
gpt write mmc 0 $partitions
|
|
|
|
Connect the USB-OTG cable between the host and a target device.
|
|
|
|
Launch fastboot on the target with:
|
|
|
|
.. code-block:: bash
|
|
|
|
fastboot 0
|
|
|
|
Upon a successful gadget connection the host shows the USB device with:
|
|
|
|
.. code-block:: bash
|
|
|
|
lsusb
|
|
# Bus 001 Device 020: ID 2207:330c Fuzhou Rockchip Electronics Company RK3399 in Mask ROM mode
|
|
|
|
Program the flash with:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo fastboot -i 0x2207 flash loader1 idbloader.img
|
|
sudo fastboot -i 0x2207 flash loader2 u-boot.itb
|
|
|
|
Note:
|
|
|
|
For Rockchip 32-bit platforms the U-Boot proper image
|
|
is u-boot-dtb.img
|
|
|
|
SPI
|
|
^^^
|
|
|
|
Write u-boot-rockchip-spi.bin to offset 0 of SPI flash.
|
|
|
|
Copy u-boot-rockchip-spi.bin into SD card and boot from SD:
|
|
|
|
.. code-block:: bash
|
|
|
|
sf probe
|
|
load mmc 1:1 $kernel_addr_r u-boot-rockchip-spi.bin
|
|
sf update $fileaddr 0 $filesize
|
|
|
|
2. Package the image with Rockchip miniloader
|
|
---------------------------------------------
|
|
|
|
Image package with Rockchip miniloader requires rkbin [1].
|
|
|
|
.. code-block:: bash
|
|
|
|
cd ..
|
|
git clone --depth 1 https://github.com/rockchip-linux/rkbin
|
|
|
|
Create idbloader.img:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd u-boot
|
|
./tools/mkimage -n px30 -T rksd -d ../rkbin/bin/rk33/px30_ddr_333MHz_v1.16.bin idbloader.img
|
|
cat ../rkbin/bin/rk33/px30_miniloader_v1.31.bin >> idbloader.img
|
|
sudo dd if=idbloader.img of=/dev/sda seek=64
|
|
|
|
Create trust.img:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd ../rkbin
|
|
./tools/trust_merger RKTRUST/PX30TRUST.ini
|
|
sudo dd if=trust.img of=/dev/sda seek=24576
|
|
|
|
Create uboot.img [2]:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd ../u-boot
|
|
../rkbin/tools/loaderimage --pack --uboot u-boot-dtb.bin uboot.img 0x200000
|
|
sudo dd if=uboot.img of=/dev/sda seek=16384
|
|
|
|
Note:
|
|
|
|
1. rkbin binaries are regularly updated, so it would be recommended to use the latest version.
|
|
2. 0x200000 is a load address and is an option for some platforms.
|
|
|
|
3. Package the RK3066 image with U-Boot TPL/SPL on NAND
|
|
-------------------------------------------------------
|
|
|
|
Unlike later SoC models the rk3066 BootROM doesn't have SDMMC support.
|
|
If all other boot options fail then it enters into a BootROM mode on the USB OTG port.
|
|
This method loads TPL/SPL on NAND with U-Boot and kernel on SD card.
|
|
|
|
SD Card
|
|
^^^^^^^
|
|
|
|
U-Boot expects a GPT partition map and a boot directory structure with files on the SD card.
|
|
|
|
.. code-block:: none
|
|
|
|
Partition Map for MMC device 0 -- Partition Type: EFI
|
|
Part Start LBA End LBA Name
|
|
1 0x00000040 0x00001f7f "loader1"
|
|
2 0x00004000 0x00005fff "loader2"
|
|
3 0x00006000 0x00007fff "trust"
|
|
4 0x00008000 0x0003ffff "boot"
|
|
5 0x00040000 0x00ed7fde "rootfs"
|
|
|
|
Make sure boot and esp flag are set for the boot partition.
|
|
Loader1 partition is not used by RK3066.
|
|
|
|
Boot partition:
|
|
|
|
.. code-block:: none
|
|
|
|
extlinux
|
|
extlinux.conf
|
|
|
|
zImage
|
|
rk3066a-mk808.dtb
|
|
|
|
To write a U-Boot image to the SD card (assumed to be /dev/sda):
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dd if=u-boot-dtb.img of=/dev/sda seek=16384
|
|
sync
|
|
|
|
NAND
|
|
^^^^
|
|
|
|
Bring device in BootROM mode:
|
|
|
|
If bricked and no BootROM mode shows up then connect pin 8 and 9 of the NAND flash
|
|
with a needle while reconnecting to the USB OTG port to a PC.
|
|
|
|
Show connected devices with:
|
|
|
|
.. code-block:: bash
|
|
|
|
lsusb
|
|
# Bus 001 Device 004: ID 2207:300a Fuzhou Rockchip Electronics Company RK3066 in Mask ROM mode
|
|
|
|
|
|
Create NAND image:
|
|
|
|
Size of SPL and TPL must be aligned to 2kb.
|
|
|
|
Program with commands in a bash script ./flash.sh:
|
|
|
|
.. code-block:: bash
|
|
|
|
#!/bin/sh
|
|
|
|
printf "RK30" | dd conv=notrunc bs=4 count=1 of=u-boot-tpl.bin
|
|
truncate -s %2048 u-boot-tpl.bin
|
|
truncate -s %2048 u-boot-spl.bin
|
|
../tools/boot_merger --verbose config-flash.ini
|
|
../tools/upgrade_tool ul ./RK30xxLoader_uboot.bin
|
|
|
|
config-flash.ini:
|
|
|
|
.. code-block:: none
|
|
|
|
[CHIP_NAME]
|
|
NAME=RK30
|
|
[VERSION]
|
|
MAJOR=2
|
|
MINOR=21
|
|
[CODE471_OPTION]
|
|
NUM=1
|
|
Path1=30_LPDDR2_300MHz_DD.bin
|
|
[CODE472_OPTION]
|
|
NUM=1
|
|
Path1=rk30usbplug.bin
|
|
[LOADER_OPTION]
|
|
NUM=2
|
|
LOADER1=FlashData
|
|
LOADER2=FlashBoot
|
|
FlashData=u-boot-tpl.bin
|
|
FlashBoot=u-boot-spl.bin
|
|
[OUTPUT]
|
|
PATH=RK30xxLoader_uboot.bin
|
|
|
|
TODO
|
|
----
|
|
|
|
- Add Rockchip idbloader image building
|
|
- Add Rockchip TPL image building
|
|
- Document SPI flash boot
|
|
- Add missing SoC's with it boards list
|
|
|
|
.. Jagan Teki <jagan@amarulasolutions.com>
|
|
.. Wednesday 28 October 2020 06:47:26 PM IST
|