rockchip: Remove ARCH= references from documentation
[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 type-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
39 Compile ATF
40 ===========
41
42   > cd arm-trusted-firmware
43   > make realclean
44   > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 bl31
45
46   Get bl31.elf in this step, copy it to U-Boot root dir:
47   > cp build/rk3399/release/bl31/bl31.elf ../u-boot/
48
49   Or you can get the bl31.elf directly from Rockchip:
50   > cp rkbin/rk33/rk3399_bl31_v1.00.elf ../u-boot/bl31.elf
51
52
53 Compile U-Boot
54 ==============
55
56   > cd ../u-boot
57   > export CROSS_COMPILE=aarch64-linux-gnu-
58   > make evb-rk3399_defconfig
59   for firefly-rk3399, use below instead:
60   > make firefly-rk3399_defconfig
61   > make
62   > make u-boot.itb
63
64   Get spl/u-boot-spl.bin and u-boot.itb in this step.
65
66 Compile rkdeveloptool
67 =====================
68
69 Get rkdeveloptool installed on your Host in this step.
70
71 Follow instructions in latest README, example:
72   > cd ../rkdeveloptool
73   > autoreconf -i
74   > ./configure
75   > make
76   > sudo make install
77
78 Both origin binaries and Tool are ready now, choose either option 1 or
79 option 2 to deploy U-Boot.
80
81 Package the image
82 =================
83
84 Package the image for U-Boot SPL(option 1)
85 --------------------------------
86   > cd ..
87   > tools/mkimage -n rk3399 -T rksd -d spl/u-boot-spl.bin idbspl.img
88
89   Get idbspl.img in this step.
90
91 Package the image for Rockchip miniloader(option 2)
92 ------------------------------------------
93   > cd ..
94   > cp arm-trusted-firmware/build/rk3399/release/bl31.elf rkbin/rk33
95   > ./rkbin/tools/trust_merger rkbin/tools/RK3399TRUST.ini
96   > ./rkbin/tools/loaderimage --pack --uboot u-boot/u-boot-dtb.bin uboot.img
97
98   Get trust.img and uboot.img in this step.
99
100 Flash the image to eMMC
101 =======================
102
103 Flash the image with U-Boot SPL(option 1)
104 -------------------------------
105 Power on(or reset with RESET KEY) with MASKROM KEY preesed, and then:
106   > rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
107   > rkdeveloptool wl 64 u-boot/idbspl.img
108   > rkdeveloptool wl 0x4000 u-boot/u-boot.itb
109   > rkdeveloptool rd
110
111 Flash the image with Rockchip miniloader(option 2)
112 ----------------------------------------
113 Power on(or reset with RESET KEY) with MASKROM KEY preesed, and then:
114   > rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
115   > rkdeveloptool ul rkbin/rk33/rk3399_loader_v1.08.106.bin
116   > rkdeveloptool wl 0x4000 u-boot/uboot.img
117   > rkdeveloptool wl 0x6000 u-boot/trust.img
118   > rkdeveloptool rd
119
120 You should be able to get U-Boot log in console/UART2(baurdrate 1500000)
121 For more detail, please reference to:
122 http://opensource.rock-chips.com/wiki_Boot_option