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
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
71 One RK3128 board is supported:
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
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
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 --