blob: 254c3bbe966ef02bda98c08c9490d9245a9d74da [file] [log] [blame]
Klaus Goger81039932017-04-07 19:13:38 +02001Introduction
2============
3
4The RK3399-Q7 (Puma) is a system-on-module featuring the Rockchip
5RK3399 in a Qseven-compatible form-factor.
6
7RK3399-Q7 features:
8 * CPU: ARMv8 64bit Big-Little architecture,
9 * Big: dual-core Cortex-A72
10 * Little: quad-core Cortex-A53
11 * IRAM: 200KB
12 * DRAM: 4GB-128MB dual-channel
13 * eMMC: onboard eMMC
14 * SD/MMC
15 * GbE (onboard Micrel KSZ9031) Gigabit ethernet PHY
16 * USB:
17 * USB3.0 dual role port
18 * 2x USB3.0 host, 1x USB2.0 host via onboard USB3.0 hub
19 * Display: HDMI/eDP/MIPI
20 * Camera: 2x CSI (one on the edge connector, one on the Q7 specified CSI ZIF)
21 * NOR Flash: onboard SPI NOR
22 * Companion Controller: onboard additional Cortex-M0 microcontroller
23 * RTC
24 * fan controller
25 * CAN
26
27Here is the step-by-step to boot to U-Boot on rk3399.
28
Quentin Schulzd1b93392021-11-12 15:15:50 +010029Get the Source and build ATF binary
30===================================
Klaus Goger81039932017-04-07 19:13:38 +020031
Quentin Schulzd1b93392021-11-12 15:15:50 +010032 > git clone https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git
Klaus Goger81039932017-04-07 19:13:38 +020033
34Compile the ATF
35===============
36
Quentin Schulzd1b93392021-11-12 15:15:50 +010037 > cd trusted-firmware-a
Klaus Goger81039932017-04-07 19:13:38 +020038 > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 bl31
Quentin Schulzd1b93392021-11-12 15:15:50 +010039 > cp build/rk3399/release/bl31/bl31.elf ../u-boot/bl31.elf
Klaus Goger81039932017-04-07 19:13:38 +020040
41Compile the U-Boot
42==================
43
44 > cd ../u-boot
45 > make CROSS_COMPILE=aarch64-linux-gnu- puma-rk3399_defconfig all
46
47Package the image
48=================
49
Quentin Schulzd1b93392021-11-12 15:15:50 +010050The SPL image for SD-Card/eMMC is readily available in idbloader.img at the
51root of U-Boot after compilation.
52
53Creating an SPL image for SPI-NOR:
54 > tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin idbloader-spi.img
Klaus Goger81039932017-04-07 19:13:38 +020055
56Flash the image
57===============
58
Klaus Goger5f49bc42017-09-11 21:05:00 +020059Copy the SPL to offset 32k for SD/eMMC, offset 0 for NOR-Flash and the FIT
Quentin Schulzd1b93392021-11-12 15:15:50 +010060image to offset 256k.
Klaus Goger81039932017-04-07 19:13:38 +020061
Klaus Goger5f49bc42017-09-11 21:05:00 +020062SD-Card
63-------
64
Quentin Schulzd1b93392021-11-12 15:15:50 +010065 > dd if=idbloader.img of=/dev/sdb seek=64
Philipp Tomsich9eefd0f2017-05-05 19:22:54 +020066 > dd if=u-boot.itb of=/dev/sdb seek=512
Klaus Goger81039932017-04-07 19:13:38 +020067
Klaus Goger5f49bc42017-09-11 21:05:00 +020068eMMC
69----
70
71rkdeveloptool allows to flash the on-board eMMC via the USB OTG interface with
72help of the Rockchip loader binary.
73
74 > git clone https://github.com/rockchip-linux/rkdeveloptool
75 > cd rkdeveloptool
76 > autoreconf -i && ./configure && make
77 > git clone https://github.com/rockchip-linux/rkbin.git
Quentin Schulzd1b93392021-11-12 15:15:50 +010078 > cd rkbin
79 > ./tools/boot_merger RKBOOT/RK3399MINIALL.ini
80 > cd ..
81 > ./rkdeveloptool db rkbin/rk3399_loader_v1.25.126.bin
82 > ./rkdeveloptool wl 64 ../idbloader.img
Klaus Goger5f49bc42017-09-11 21:05:00 +020083 > ./rkdeveloptool wl 512 ../u-boot.itb
84
85NOR-Flash
86---------
87
Quentin Schulzd1b93392021-11-12 15:15:50 +010088rkdeveloptool allows to flash the on-board SPI via the USB OTG interface with
89help of the Rockchip loader binary.
Klaus Goger5f49bc42017-09-11 21:05:00 +020090
Quentin Schulzd1b93392021-11-12 15:15:50 +010091 > git clone https://github.com/rockchip-linux/rkdeveloptool
92 > cd rkdeveloptool
93 > autoreconf -i && ./configure && make
94 > git clone https://github.com/rockchip-linux/rkbin.git
95 > cd rkbin
96 > ./tools/boot_merger RKBOOT/RK3399MINIALL_SPINOR.ini
97 > cd ..
98 > ./rkdeveloptool db rkbin/rk3399_loader_spinor_v1.25.114.bin
99 > ./rkdeveloptool ef
100 > ./rkdeveloptool wl 0 ../idbloader-spi.img
101 > ./rkdeveloptool wl 512 ../u-boot.itb