mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-04 18:41:03 +00:00
1be82afa80
Use proper project name in comments, Kconfig, readmes. Reviewed-by: Neil Armstrong <neil.armstrong@linaro.org> Acked-by: Ilias Apalodimas <ilias.apalodimas@linaro.org> Reviewed-by: Stefan Roese <sr@denx.de> Reviewed-by: Qu Wenruo <wqu@suse.com> Signed-off-by: Michal Simek <michal.simek@amd.com> Link: https://lore.kernel.org/r/0dbdf0432405c1c38ffca55703b6737a48219e79.1684307818.git.michal.simek@amd.com
438 lines
11 KiB
ReStructuredText
438 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-pi-4-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)
|
|
|
|
* rk3588
|
|
- Rockchip EVB (evb-rk3588)
|
|
- Edgeble Neural Compute Module 6 SoM - Neu6a (neu6a-io-rk3588)
|
|
- 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 and pad_cat.
|
|
|
|
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
|
|
^^^
|
|
|
|
The SPI boot method requires the generation of idbloader.img with help of the mkimage tool.
|
|
|
|
SPL-alone SPI boot image:
|
|
|
|
.. code-block:: bash
|
|
|
|
./tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin idbloader.img
|
|
|
|
TPL+SPL SPI boot image:
|
|
|
|
.. code-block:: bash
|
|
|
|
./tools/mkimage -n rk3399 -T rkspi -d tpl/u-boot-tpl.bin:spl/u-boot-spl.bin idbloader.img
|
|
|
|
Copy SPI boot images into SD card and boot from SD:
|
|
|
|
.. code-block:: bash
|
|
|
|
sf probe
|
|
load mmc 1:1 $kernel_addr_r idbloader.img
|
|
sf erase 0 +$filesize
|
|
sf write $kernel_addr_r 0 ${filesize}
|
|
load mmc 1:1 ${kernel_addr_r} u-boot.itb
|
|
sf erase 0x60000 +$filesize
|
|
sf write $kernel_addr_r 0x60000 ${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
|