123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238 |
- .. 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 SoC solutions provider for tablets & PCs, streaming media
- TV boxes, AI audio & vision, IoT hardware.
- A wide range of Rockchip SoCs with associated boardsare supported in
- mainline U-Boot.
- List of mainline supported rockchip boards:
- * rk3036
- - Rockchip Evb-RK3036 (evb-rk3036)
- - Kylin (kylin_rk3036)
- * rk3128
- - Rockchip Evb-RK3128 (evb-rk3128)
- * 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)
- * 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)
- - 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 Pi 4 (rock-pi-4-rk3399)
- - Rockchip Evb-RK3399 (evb_rk3399)
- - Theobroma Systems RK3399-Q7 SoM - Puma (puma_rk3399)
- * rv1108
- - Rockchip Evb-rv1108 (evb-rv1108)
- - Elgin-R1 (elgin-rv1108)
- * rv3188
- - Radxa Rock (rock)
- Building
- --------
- TF-A
- ^^^^
- TF-A would require to build for ARM64 Rockchip SoCs platforms.
- To build TF-A::
- git clone https://github.com/ARM-software/arm-trusted-firmware.git
- cd arm-trusted-firmware
- make realclean
- make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399
- Specify the PLAT= with desired rockchip platform to build TF-A for.
- U-Boot
- ^^^^^^
- To build rk3328 boards::
- export BL31=/path/to/arm-trusted-firmware/to/bl31.elf
- make evb-rk3328_defconfig
- make
- To build rk3288 boards::
- make evb-rk3288_defconfig
- make
- To build rk3368 boards::
- export BL31=/path/to/arm-trusted-firmware/to/bl31.elf
- make evb-px5_defconfig
- make
- To build rk3399 boards::
- export BL31=/path/to/arm-trusted-firmware/to/bl31.elf
- make evb-rk3399_defconfig
- make
- 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 single boot image using binman and pad_cat.
- To write an image that boots from an SD card (assumed to be /dev/sda)::
- 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 configurations::
- mmc dev 0
- gpt write mmc 0 $partitions
- Connect the USB-OTG cable between host and target device.
- Launch fastboot at target::
- fastboot 0
- Upon successful gadget connection,host show the USB device like::
- lsusb
- Bus 001 Device 020: ID 2207:330c Fuzhou Rockchip Electronics Company RK3399 in Mask ROM mode
- Program the flash::
- 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
- ^^^
- Generating idbloader for SPI boot would require to input a multi image
- image format to mkimage tool instead of concerting (like for MMC boot).
- SPL-alone SPI boot image::
- ./tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin idbloader.img
- TPL+SPL SPI boot image::
- ./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::
- 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 robin [1].
- Create idbloader.img
- .. code-block:: none
- cd u-boot
- ./tools/mkimage -n px30 -T rksd -d rkbin/bin/rk33/px30_ddr_333MHz_v1.15.bin idbloader.img
- cat rkbin/bin/rk33/px30_miniloader_v1.22.bin >> idbloader.img
- sudo dd if=idbloader.img of=/dev/sda seek=64
- Create trust.img
- .. code-block:: none
- cd rkbin
- ./tools/trust_merger RKTRUST/PX30TRUST.ini
- sudo dd if=trust.img of=/dev/sda seek=24576
- Create uboot.img
- .. code-block:: none
- rbink/tools/loaderimage --pack --uboot u-boot-dtb.bin uboot.img 0x200000
- sudo dd if=uboot.img of=/dev/sda seek=16384
- Note:
- 1. 0x200000 is load address and it's an optional in some platforms.
- 2. rkbin binaries are kept on updating, so would recommend to use the latest versions.
- TODO
- ----
- - Add rockchip idbloader image building
- - Add rockchip TPL image building
- - Document SPI flash boot
- - Add missing SoC's with it boards list
- [1] https://github.com/rockchip-linux/rkbin
- .. Jagan Teki <jagan@amarulasolutions.com>
- .. Wednesday 28 October 2020 06:47:26 PM IST
|