u-boot/doc/README.rockchip

1 # SPDX-License-Identifier: GPL-2.0+
6 U-Boot on Rockchip
9 A wide range of Rockchip SoCs are supported in mainline U-Boot
17    - Firefly RK3288 board or something else with a supported RockChip SoC
18    - Power connection to 5V using the supplied micro-USB power cable
19    - Separate USB serial cable attached to your computer and the Firefly
20         (connect to the micro-USB connector below the logo)
21    - rkflashtool [3]
22    - openssl (sudo apt-get install openssl)
23    - Serial UART connection [4]
24    - Suitable ARM cross compiler, e.g.:
25         sudo apt-get install gcc-4.7-arm-linux-gnueabi
33    - EVB RK3288 - use evb-rk3288 configuration
34    - Fennec RK3288 - use fennec-rk3288 configuration
35    - Firefly RK3288 - use firefly-rk3288 configuration
36    - Hisense Chromebook - use chromebook_jerry configuration
37    - Asus C100P Chromebook - use chromebook_minnie configuration
38    - Asus Chromebit - use chromebook_mickey configuration
39    - MiQi RK3288 - use miqi-rk3288 configuration
40    - phyCORE-RK3288 RDK - use phycore-rk3288 configuration
41    - PopMetal RK3288 - use popmetal-rk3288 configuration
42    - Radxa Rock 2 - use rock2 configuration
43    - Tinker RK3288 - use tinker-rk3288 configuration
44    - Vyasa RK3288 - use vyasa-rk3288 configuration
48    - EVB RK3036 - use evb-rk3036 configuration
49    - Kylin - use kylin_rk3036 configuration
53    - EVB RK3328
55 Size RK3399 boards are supported (aarch64):
57    - EBV RK3399 - use evb_rk3399 configuration
58    - Firefly RK3399 - use the firefly_rk3399 configuration
59    - Puma - use puma_rk3399 configuration
60    - Ficus - use ficus-rk3399 configuration
61    - Rock960 (Vamrs) - use rock960-rk3399 configuration
62    - Bob - use chromebook_bob configuration
66    - Sheep - use sheep-rk3368 configuration
67    - Lion - use lion-rk3368 configuration
68    - Geekbox - use geekbox configuration
69    - EVB PX5 - use evb-px5  configuration
73    - EVB RK3128 - use evb-rk3128 configuration
77    - EVB RK3229 - use evb-rk3229 configuration
81    - EVB RV1108 - use evb-rv1108 configuration
82    - Elgin R1 - use elgin-rv1108 configuration
86    - Raxda Rock - use rock configuration
91    CROSS_COMPILE=arm-linux-gnueabi- make O=firefly firefly-rk3288_defconfig all
109    ./firefly-rk3288/tools/mkimage -n rk3288 -T rkimage -d \
110 	./firefly-rk3288/spl/u-boot-spl-dtb.bin out && \
111    cat out | openssl rc4 -K 7c4e0304550509072d2c7b38170d1711 | rkflashtool l
115    U-Boot SPL 2015.07-rc1-00383-ge345740-dirty (Jun 03 2015 - 10:06:49)
117    spl: mmc init failed with error: -17
122 in SPL then we could in principle load U-Boot and boot to a prompt from USB
132    ./firefly-rk3288/tools/mkimage -n rk3288 -T rksd -d \
133 	firefly-rk3288/spl/u-boot-spl-dtb.bin out && \
135    sudo dd if=firefly-rk3288/u-boot-dtb.img of=/dev/sdc seek=16384
137 This puts the Rockchip header and SPL image first and then places the U-Boot
139 corresponds with this setting in U-Boot:
143 Put this SD (or micro-SD) card into your board and reset it. You should see
146    U-Boot 2016.01-rc2-00309-ge5bad3b-dirty (Jan 02 2016 - 23:41:59 -0700)
151    *** Warning - bad CRC, using default environment
162 load a second-stage bootloader (ie. U-Boot) as soon as the control is returned
170    ./firefly-rk3288/tools/mkimage -n rk3288 -T rksd -d \
171 	firefly-rk3288/spl/u-boot-spl-dtb.bin out && \
172    cat firefly-rk3288/u-boot-dtb.bin >> out && \
178 	./evb-rk3036/tools/mkimage -n rk3036 -T rksd  -d evb-rk3036/spl/u-boot-spl.bin out && \
179 	cat evb-rk3036/u-boot-dtb.bin >> out && \
192 So introduce TPL so-that adding new features to SPL is possible because now TPL should
193 run minimal with code like DDR, clock etc and rest of new features in SPL.
195 As of now TPL is added on Vyasa-RK3288 board.
199    ./tools/mkimage -n rk3288 -T rksd -d ./tpl/u-boot-tpl.bin out &&
200     cat ./spl/u-boot-spl-dtb.bin >> out &&
202     sudo dd if=u-boot-dtb.img of=/dev/mmcblk0 seek=16384
212 can then be up to 29kb in size and does the regular ddr init.  This is
215 boot0-hook.
218 rc4-encrypted. Except for the very first stage the bootrom always reads
222 tools/mkimage -n rk3188 -T rksd -d spl/u-boot-spl.bin out
224 # truncate, encode and append u-boot.bin
225 truncate -s %2048 u-boot.bin
226 cat u-boot.bin | split -b 512 --filter='openssl rc4 -K 7C4E0304550509072D2C7B38170D1711' >> out
231 - Write GPT partition layout to mmc device which fastboot want to use it to
236 - Invoke fastboot command to prepare
240 - Start fastboot request on PC
242         fastboot -i 0x2207 flash loader evb-rk3288/spl/u-boot-spl-dtb.bin
247         WARNING: unknown variable: partition-type:loader
260    ./chromebook_jerry/tools/mkimage -n rk3288 -T rkspi \
261 	-d chromebook_jerry/spl/u-boot-spl-dtb.bin spl.bin && \
262    dd if=spl.bin of=spl-out.bin bs=128K conv=sync && \
263    cat spl-out.bin chromebook_jerry/u-boot-dtb.img >out.bin && \
267 header and skipping every second 2KB block. Then the U-Boot image is written at
269 The position of U-Boot is controlled with this setting in U-Boot:
275       sudo em100 -s -c GD25LQ32 -d out.bin.pad -r
279    U-Boot SPL 2015.07-rc2-00215-g9a58220-dirty (Jun 23 2015 - 12:11:32)
282    U-Boot 2015.07-rc2-00215-g9a58220-dirty (Jun 23 2015 - 12:11:32 -0600)
299 - USB host
300 - USB device
301 - Run CPU at full speed (code exists but we only see ~60 DMIPS maximum)
302 - NAND flash
303 - Boot U-Boot proper over USB OTG (at present only SPL works)
312 [2] https://github.com/linux-rockchip/u-boot-rockchip.git branch u-boot-rk3288
313 [3] https://github.com/linux-rockchip/rkflashtool.git
314 [4] http://wiki.t-firefly.com/index.php/Firefly-RK3288/Serial_debug/en
317 -------
320 over USB OTG. This is a very simple format - just the string RK32 (as 4 bytes)
321 followed by u-boot-spl-dtb.bin.
327 ----
330 u-boot-spl-dtb.bin. The header is defined by 'struct header0_info' although
331 most of the fields are unused by U-Boot. We just need to specify the
338 The maximum size of u-boot-spl-dtb.bin which the boot ROM will read is 32KB,
346 Since this image is set to load U-Boot from the SD card at block offset,
348 u-boot-dtb.img to the SD card at that offset. See above for instructions.
351 -----
353 rkspi.c produces an image consisting of a header and u-boot-spl-dtb.bin. The
362 --------
369 ----------------------------
374 In general all Rockchip drivers should use these features, with SPL-specific
378 ----------------------------
382 like miniloader, trusted-os, arm-trust-firmware.
387 --