blob: 9b31b0b37906bc56e1aa818d2617d8506833f7d6 [file] [log] [blame]
Klaus Gogera13110a2017-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
29Get the Source and build ATF/Cortex-M0 binaries
30===============================================
31
32 > git clone git://git.theobroma-systems.com/arm-trusted-firmware.git
33 > git clone git://git.theobroma-systems.com/rk3399-cortex-m0.git
34
35Compile the ATF
36===============
37
38 > cd arm-trusted-firmware
39 > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 bl31
Klaus Goger4ce8b4d2017-07-18 21:41:28 +020040 > cp build/rk3399/release/bl31.bin ../u-boot/bl31-rk3399.bin
Klaus Gogera13110a2017-04-07 19:13:38 +020041
42Compile the M0 firmware
43=======================
44
45 > cd ../rk3399-cortex-m0
46 > make CROSS_COMPILE=arm-cortex_m0-eabi-
47 > cp rk3399m0.bin ../u-boot
48
49Compile the U-Boot
50==================
51
52 > cd ../u-boot
53 > make CROSS_COMPILE=aarch64-linux-gnu- puma-rk3399_defconfig all
54
55Package the image
56=================
57
Klaus Gogerc9140342017-09-11 21:05:00 +020058Creating a SPL image for SD-Card/eMMC
59 > tools/mkimage -n rk3399 -T rksd -d spl/u-boot-spl.bin spl_mmc.img
60Creating a SPL image for SPI-NOR
61 > tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin spl_nor.img
62Create the FIT image containing U-Boot proper, ATF, M0 Firmware, devicetree
Jagan Teki1c281dc2019-06-20 15:37:40 +053063 > make CROSS_COMPILE=aarch64-linux-gnu-
Klaus Gogera13110a2017-04-07 19:13:38 +020064
65Flash the image
66===============
67
Klaus Gogerc9140342017-09-11 21:05:00 +020068Copy the SPL to offset 32k for SD/eMMC, offset 0 for NOR-Flash and the FIT
69image to offset 256k card.
Klaus Gogera13110a2017-04-07 19:13:38 +020070
Klaus Gogerc9140342017-09-11 21:05:00 +020071SD-Card
72-------
73
74 > dd if=spl_mmc.img of=/dev/sdb seek=64
Philipp Tomsichf8e3b082017-05-05 19:22:54 +020075 > dd if=u-boot.itb of=/dev/sdb seek=512
Klaus Gogera13110a2017-04-07 19:13:38 +020076
Klaus Gogerc9140342017-09-11 21:05:00 +020077eMMC
78----
79
80rkdeveloptool allows to flash the on-board eMMC via the USB OTG interface with
81help of the Rockchip loader binary.
82
83 > git clone https://github.com/rockchip-linux/rkdeveloptool
84 > cd rkdeveloptool
85 > autoreconf -i && ./configure && make
86 > git clone https://github.com/rockchip-linux/rkbin.git
87 > ./rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
88 > ./rkdeveloptool wl 64 ../spl_mmc.img
89 > ./rkdeveloptool wl 512 ../u-boot.itb
90
91NOR-Flash
92---------
93
94Writing the SPI NOR Flash requires a running U-Boot. For the sake of simplicity
95we assume you have a SD-Card with a partition containing the required files
96ready.
97
98 > load mmc 1:1 ${kernel_addr_r} spl_nor.img
99 > sf probe
100 > sf erase 0 +$filesize
101 > sf write $kernel_addr_r 0 ${filesize}
102 > load mmc 1:1 ${kernel_addr_r} u-boot.itb
103 > sf erase 0x40000 +$filesize
104 > sf write $kernel_addr_r 0x40000 ${filesize}
105
106
107Reboot the system and you should see a U-Boot console on UART0 (115200n8).