rockchip: evb-rk3399: correct README for board bring up
[oweals/u-boot.git] / board / rockchip / evb_rk3399 / README
1 Introduction
2 ============
3
4 RK3399 key features we might use in U-Boot:
5 * CPU: ARMv8 64bit Big-Little architecture,
6 *      Big: dual-core Cortex-A72
7 *      Little: quad-core Cortex-A53
8 * IRAM: 200KB
9 * DRAM: 4GB-128MB dual-channel
10 * eMMC: support eMMC 5.0/5.1, suport HS400, HS200, DDR50
11 * SD/MMC: support SD 3.0, MMC 4.51
12 * USB: USB3.0 typc-C port *2 with dwc3 controller
13 *      USB2.0 EHCI host port *2
14 * Display: RGB/HDMI/DP/MIPI/EDP
15
16 evb key features:
17 * regulator: pwm regulator for CPU B/L
18 * PMIC: rk808
19 * debug console: UART2
20
21 In order to support Arm Trust Firmware(ATF), we can use either SPL or
22 miniloader from rockchip to do:
23 * do DRAM init
24 * load and verify ATF image
25 * load and verify U-Boot image
26
27 Here is the step-by-step to boot to U-Boot on rk3399.
28
29 Get the Source and prebuild binary
30 ==================================
31
32   > mkdir ~/evb_rk3399
33   > cd ~/evb_rk3399
34   > git clone https://github.com/ARM-software/arm-trusted-firmware.git
35   > git clone https://github.com/rockchip-linux/rkbin.git
36   > git clone https://github.com/rockchip-linux/rkdeveloptool.git
37
38 Compile the ATF
39 ===============
40
41   > cd arm-trusted-firmware
42   > make realclean
43   > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 bl31
44
45   Or you can get the bl31.elf directly from Rockchip:
46   cp rkbin/rk33/rk3399_bl31_v1.00.elf ../u-boot/bl31.elf
47
48   Get bl31.elf in this step, copy it to U-Boot root dir:
49   > cp bl31.elf ../u-boot/
50
51 Compile the U-Boot
52 ==================
53
54   > cd ../u-boot
55   > export ARCH=arm64
56   > export CROSS_COMPILE=aarch64-linux-gnu-
57   > make evb-rk3399_defconfig
58   for firefly-rk3399, use below instead:
59   > make firefly-rk3399_defconfig
60   > make
61   > make u-boot.itb
62
63   Get spl/u-boot-spl.bin and u-boot.itb in this step.
64
65 Compile the rkdeveloptool
66 =======================
67   Follow instructions in latest README
68   > cd ../rkdeveloptool
69   > autoreconf -i
70   > ./configure
71   > make
72   > sudo make install
73
74   Get rkdeveloptool in you Host in this step.
75
76 Both origin binaries and Tool are ready now, choose either option 1 or
77 option 2 to deploy U-Boot.
78
79 Package the image
80 =================
81
82 Package the image for U-Boot SPL(option 1)
83 --------------------------------
84   > cd ..
85   > tools/mkimage -n rk3399 -T rksd -d spl/u-boot-spl.bin idbspl.img
86
87   Get idbspl.img in this step.
88
89 Package the image for Rockchip miniloader(option 2)
90 ------------------------------------------
91   > cd ..
92   > cp arm-trusted-firmware/build/rk3399/release/bl31.elf rkbin/rk33
93   > ./rkbin/tools/trust_merger rkbin/tools/RK3399TRUST.ini
94   > ./rkbin/tools/loaderimage --pack --uboot u-boot/u-boot-dtb.bin uboot.img
95
96   Get trust.img and uboot.img in this step.
97
98 Flash the image to eMMC
99 =======================
100
101 Flash the image with U-Boot SPL(option 1)
102 -------------------------------
103 Power on(or reset with RESET KEY) with MASKROM KEY preesed, and then:
104   > rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
105   > rkdeveloptool wl 64 u-boot/idbspl.img
106   > rkdeveloptool wl 0x4000 u-boot/u-boot.itb
107   > rkdeveloptool rd
108
109 Flash the image with Rockchip miniloader(option 2)
110 ----------------------------------------
111 Power on(or reset with RESET KEY) with MASKROM KEY preesed, and then:
112   > rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
113   > rkdeveloptool ul rkbin/rk33/rk3399_loader_v1.08.106.bin
114   > rkdeveloptool wl 0x4000 u-boot/uboot.img
115   > rkdeveloptool wl 0x6000 u-boot/trust.img
116   > rkdeveloptool rd
117
118 You should be able to get U-Boot log in console/UART2(baurdrate 1500000)
119 For more detail, please reference to:
120 http://opensource.rock-chips.com/wiki_Boot_option