Tom Rini | 10e4779 | 2018-05-06 17:58:06 -0400 | [diff] [blame] | 1 | # SPDX-License-Identifier: GPL-2.0+ |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 2 | # |
| 3 | # Copyright (C) 2015 Google. Inc |
| 4 | # Written by Simon Glass <sjg@chromium.org> |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 5 | |
| 6 | U-Boot on Rockchip |
| 7 | ================== |
| 8 | |
| 9 | There are several repositories available with versions of U-Boot that support |
| 10 | many Rockchip devices [1] [2]. |
| 11 | |
| 12 | The current mainline support is experimental only and is not useful for |
| 13 | anything. It should provide a base on which to build. |
| 14 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 15 | So far only support for the RK3288 and RK3036 is provided. |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 16 | |
| 17 | |
| 18 | Prerequisites |
| 19 | ============= |
| 20 | |
| 21 | You will need: |
| 22 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 23 | - Firefly RK3288 board or something else with a supported RockChip SoC |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 24 | - Power connection to 5V using the supplied micro-USB power cable |
| 25 | - Separate USB serial cable attached to your computer and the Firefly |
| 26 | (connect to the micro-USB connector below the logo) |
| 27 | - rkflashtool [3] |
| 28 | - openssl (sudo apt-get install openssl) |
| 29 | - Serial UART connection [4] |
| 30 | - Suitable ARM cross compiler, e.g.: |
| 31 | sudo apt-get install gcc-4.7-arm-linux-gnueabi |
| 32 | |
| 33 | |
| 34 | Building |
| 35 | ======== |
| 36 | |
Simon Glass | b32ae5f | 2019-01-21 14:53:22 -0700 | [diff] [blame^] | 37 | At present 12 RK3288 boards are supported: |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 38 | |
Xu Ziyuan | 3da09a8 | 2016-07-05 18:06:30 +0800 | [diff] [blame] | 39 | - EVB RK3288 - use evb-rk3288 configuration |
jk.kernel@gmail.com | b1aeb09 | 2016-07-26 18:28:29 +0800 | [diff] [blame] | 40 | - Fennec RK3288 - use fennec-rk3288 configuration |
Xu Ziyuan | 535b3dc | 2016-08-01 08:46:19 +0800 | [diff] [blame] | 41 | - Firefly RK3288 - use firefly-rk3288 configuration |
| 42 | - Hisense Chromebook - use chromebook_jerry configuration |
Simon Glass | b32ae5f | 2019-01-21 14:53:22 -0700 | [diff] [blame^] | 43 | - Asus C100P Chromebook - use chromebook_minnie configuration |
| 44 | - Asus Chromebit - use chromebook_mickey configuration |
Jernej Skrabec | 971e53a | 2017-03-30 01:23:14 +0200 | [diff] [blame] | 45 | - MiQi RK3288 - use miqi-rk3288 configuration |
Wadim Egorov | e2c69d6 | 2017-06-19 12:36:41 +0200 | [diff] [blame] | 46 | - phyCORE-RK3288 RDK - use phycore-rk3288 configuration |
jk.kernel@gmail.com | 7a614ac | 2016-07-26 18:28:30 +0800 | [diff] [blame] | 47 | - PopMetal RK3288 - use popmetal-rk3288 configuration |
Xu Ziyuan | 535b3dc | 2016-08-01 08:46:19 +0800 | [diff] [blame] | 48 | - Radxa Rock 2 - use rock2 configuration |
Jernej Skrabec | 3c6372d | 2017-03-30 01:23:13 +0200 | [diff] [blame] | 49 | - Tinker RK3288 - use tinker-rk3288 configuration |
Simon Glass | b32ae5f | 2019-01-21 14:53:22 -0700 | [diff] [blame^] | 50 | - Vyasa RK3288 - use vyasa-rk3288 configuration |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 51 | |
Simon Glass | b32ae5f | 2019-01-21 14:53:22 -0700 | [diff] [blame^] | 52 | Two RK3036 boards are supported: |
huang lin | 86d0a90 | 2015-11-17 14:20:31 +0800 | [diff] [blame] | 53 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 54 | - EVB RK3036 - use evb-rk3036 configuration |
| 55 | - Kylin - use kylin_rk3036 configuration |
huang lin | 86d0a90 | 2015-11-17 14:20:31 +0800 | [diff] [blame] | 56 | |
Simon Glass | b32ae5f | 2019-01-21 14:53:22 -0700 | [diff] [blame^] | 57 | One RK3328 board is supported: |
| 58 | |
| 59 | - EVB RK3328 |
| 60 | |
| 61 | Five RK3399 boards are supported (aarch64): |
| 62 | |
| 63 | - EBV RK3399 - use evb_rk3399 configuration |
| 64 | - Firefly RK3399 - use the firefly_rk3399 configuration |
| 65 | - Puma - use puma_rk3399 configuration |
| 66 | - Ficus - use ficus-rk3399 configuration |
| 67 | - Rock960 (Vamrs) - use rock960-rk3399 configuration |
| 68 | |
| 69 | Four RK3368 boards are supported: |
| 70 | |
| 71 | - Sheep - use sheep-rk3368 configuration |
| 72 | - Lion - use lion-rk3368 configuration |
| 73 | - Geekbox - use geekbox configuration |
| 74 | - EVB PX5 - use evb-px5 configuration |
| 75 | |
| 76 | One RK3128 board is supported: |
| 77 | |
| 78 | - EVB RK3128 - use evb-rk3128 configuration |
| 79 | |
| 80 | One RK3229 board is supported: |
| 81 | |
| 82 | - EVB RK3229 - use evb-rk3229 configuration |
| 83 | |
| 84 | Two RV1108 boards are supported: |
| 85 | |
| 86 | - EVB RV1108 - use evb-rv1108 configuration |
| 87 | - Elgin R1 - use elgin-rv1108 configuration |
| 88 | |
| 89 | One RV3188 baord is supported: |
| 90 | |
| 91 | - Raxda Rock - use rock configuration |
| 92 | |
| 93 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 94 | For example: |
| 95 | |
| 96 | CROSS_COMPILE=arm-linux-gnueabi- make O=firefly firefly-rk3288_defconfig all |
| 97 | |
| 98 | (or you can use another cross compiler if you prefer) |
| 99 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 100 | |
| 101 | Writing to the board with USB |
| 102 | ============================= |
| 103 | |
| 104 | For USB to work you must get your board into ROM boot mode, either by erasing |
| 105 | your MMC or (perhaps) holding the recovery button when you boot the board. |
| 106 | To erase your MMC, you can boot into Linux and type (as root) |
| 107 | |
| 108 | dd if=/dev/zero of=/dev/mmcblk0 bs=1M |
| 109 | |
| 110 | Connect your board's OTG port to your computer. |
| 111 | |
| 112 | To create a suitable image and write it to the board: |
| 113 | |
Jeffy Chen | 0510e2b | 2015-11-27 12:07:18 +0800 | [diff] [blame] | 114 | ./firefly-rk3288/tools/mkimage -n rk3288 -T rkimage -d \ |
Simon Glass | 1510ffe | 2015-08-30 16:55:52 -0600 | [diff] [blame] | 115 | ./firefly-rk3288/spl/u-boot-spl-dtb.bin out && \ |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 116 | cat out | openssl rc4 -K 7c4e0304550509072d2c7b38170d1711 | rkflashtool l |
| 117 | |
| 118 | If all goes well you should something like: |
| 119 | |
| 120 | U-Boot SPL 2015.07-rc1-00383-ge345740-dirty (Jun 03 2015 - 10:06:49) |
| 121 | Card did not respond to voltage select! |
| 122 | spl: mmc init failed with error: -17 |
| 123 | ### ERROR ### Please RESET the board ### |
| 124 | |
| 125 | You will need to reset the board before each time you try. Yes, that's all |
| 126 | it does so far. If support for the Rockchip USB protocol or DFU were added |
| 127 | in SPL then we could in principle load U-Boot and boot to a prompt from USB |
| 128 | as several other platforms do. However it does not seem to be possible to |
| 129 | use the existing boot ROM code from SPL. |
| 130 | |
| 131 | |
| 132 | Booting from an SD card |
| 133 | ======================= |
| 134 | |
| 135 | To write an image that boots from an SD card (assumed to be /dev/sdc): |
| 136 | |
Jeffy Chen | 0510e2b | 2015-11-27 12:07:18 +0800 | [diff] [blame] | 137 | ./firefly-rk3288/tools/mkimage -n rk3288 -T rksd -d \ |
Simon Glass | 1510ffe | 2015-08-30 16:55:52 -0600 | [diff] [blame] | 138 | firefly-rk3288/spl/u-boot-spl-dtb.bin out && \ |
| 139 | sudo dd if=out of=/dev/sdc seek=64 && \ |
Kever Yang | c121f8a | 2017-11-02 15:16:35 +0800 | [diff] [blame] | 140 | sudo dd if=firefly-rk3288/u-boot-dtb.img of=/dev/sdc seek=16384 |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 141 | |
| 142 | This puts the Rockchip header and SPL image first and then places the U-Boot |
Goldschmidt Simon | 4d93057 | 2017-11-10 11:38:32 +0000 | [diff] [blame] | 143 | image at block 16384 (i.e. 8MB from the start of the SD card). This |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 144 | corresponds with this setting in U-Boot: |
| 145 | |
Kever Yang | c121f8a | 2017-11-02 15:16:35 +0800 | [diff] [blame] | 146 | #define CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR 0x4000 |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 147 | |
| 148 | Put this SD (or micro-SD) card into your board and reset it. You should see |
| 149 | something like: |
| 150 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 151 | U-Boot 2016.01-rc2-00309-ge5bad3b-dirty (Jan 02 2016 - 23:41:59 -0700) |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 152 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 153 | Model: Radxa Rock 2 Square |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 154 | DRAM: 2 GiB |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 155 | MMC: dwmmc@ff0f0000: 0, dwmmc@ff0c0000: 1 |
| 156 | *** Warning - bad CRC, using default environment |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 157 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 158 | In: serial |
| 159 | Out: vop@ff940000.vidconsole |
| 160 | Err: serial |
| 161 | Net: Net Initialization Skipped |
| 162 | No ethernet found. |
| 163 | Hit any key to stop autoboot: 0 |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 164 | => |
| 165 | |
Xu Ziyuan | 5401eb8 | 2016-07-12 19:09:49 +0800 | [diff] [blame] | 166 | The rockchip bootrom can load and boot an initial spl, then continue to |
Heinrich Schuchardt | f435978 | 2018-06-03 20:41:29 +0200 | [diff] [blame] | 167 | load a second-stage bootloader (ie. U-Boot) as soon as the control is returned |
| 168 | to the bootrom. Both the RK3288 and the RK3036 use this special boot sequence. |
| 169 | The configuration option enabling this is: |
Xu Ziyuan | 5401eb8 | 2016-07-12 19:09:49 +0800 | [diff] [blame] | 170 | |
Heinrich Schuchardt | f435978 | 2018-06-03 20:41:29 +0200 | [diff] [blame] | 171 | CONFIG_SPL_ROCKCHIP_BACK_TO_BROM=y |
Xu Ziyuan | 5401eb8 | 2016-07-12 19:09:49 +0800 | [diff] [blame] | 172 | |
| 173 | You can create the image via the following operations: |
| 174 | |
| 175 | ./firefly-rk3288/tools/mkimage -n rk3288 -T rksd -d \ |
| 176 | firefly-rk3288/spl/u-boot-spl-dtb.bin out && \ |
| 177 | cat firefly-rk3288/u-boot-dtb.bin >> out && \ |
| 178 | sudo dd if=out of=/dev/sdc seek=64 |
| 179 | |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 180 | If you have an HDMI cable attached you should see a video console. |
| 181 | |
huang lin | 86d0a90 | 2015-11-17 14:20:31 +0800 | [diff] [blame] | 182 | For evb_rk3036 board: |
Jeffy Chen | 0510e2b | 2015-11-27 12:07:18 +0800 | [diff] [blame] | 183 | ./evb-rk3036/tools/mkimage -n rk3036 -T rksd -d evb-rk3036/spl/u-boot-spl.bin out && \ |
huang lin | 86d0a90 | 2015-11-17 14:20:31 +0800 | [diff] [blame] | 184 | cat evb-rk3036/u-boot-dtb.bin >> out && \ |
| 185 | sudo dd if=out of=/dev/sdc seek=64 |
| 186 | |
| 187 | Note: rk3036 SDMMC and debug uart use the same iomux, so if you boot from SD, the |
| 188 | debug uart must be disabled |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 189 | |
Heiko Stübner | fdf967c | 2017-03-24 00:41:34 +0100 | [diff] [blame] | 190 | |
Jagan Teki | 387fd4b | 2017-09-27 23:03:12 +0530 | [diff] [blame] | 191 | Booting from an SD card on RK3288 with TPL |
| 192 | ========================================== |
| 193 | |
| 194 | Since the size of SPL can't be exceeded 0x8000 bytes in RK3288, it is not possible add |
| 195 | new SPL features like Falcon mode or etc. |
| 196 | |
| 197 | So introduce TPL so-that adding new features to SPL is possible because now TPL should |
| 198 | run minimal with code like DDR, clock etc and rest of new features in SPL. |
| 199 | |
| 200 | As of now TPL is added on Vyasa-RK3288 board. |
| 201 | |
| 202 | To write an image that boots from an SD card (assumed to be /dev/mmcblk0): |
| 203 | |
| 204 | ./tools/mkimage -n rk3288 -T rksd -d ./tpl/u-boot-tpl.bin out && |
| 205 | cat ./spl/u-boot-spl-dtb.bin >> out && |
| 206 | sudo dd if=out of=/dev/mmcblk0 seek=64 && |
Jagan Teki | 354a9f8 | 2017-11-10 17:18:43 +0530 | [diff] [blame] | 207 | sudo dd if=u-boot-dtb.img of=/dev/mmcblk0 seek=16384 |
Jagan Teki | 387fd4b | 2017-09-27 23:03:12 +0530 | [diff] [blame] | 208 | |
Heiko Stübner | fdf967c | 2017-03-24 00:41:34 +0100 | [diff] [blame] | 209 | Booting from an SD card on RK3188 |
| 210 | ================================= |
| 211 | |
| 212 | For rk3188 boards the general storage onto the card stays the same as |
| 213 | described above, but the image creation needs a bit more care. |
| 214 | |
| 215 | The bootrom of rk3188 expects to find a small 1kb loader which returns |
| 216 | control to the bootrom, after which it will load the real loader, which |
Philipp Tomsich | 16c689c | 2017-10-10 16:21:15 +0200 | [diff] [blame] | 217 | can then be up to 29kb in size and does the regular ddr init. This is |
| 218 | handled by a single image (built as the SPL stage) that tests whether |
| 219 | it is handled for the first or second time via code executed from the |
| 220 | boot0-hook. |
Heiko Stübner | fdf967c | 2017-03-24 00:41:34 +0100 | [diff] [blame] | 221 | |
| 222 | Additionally the rk3188 requires everything the bootrom loads to be |
| 223 | rc4-encrypted. Except for the very first stage the bootrom always reads |
| 224 | and decodes 2kb pages, so files should be sized accordingly. |
| 225 | |
| 226 | # copy tpl, pad to 1020 bytes and append spl |
Philipp Tomsich | 16c689c | 2017-10-10 16:21:15 +0200 | [diff] [blame] | 227 | tools/mkimage -n rk3188 -T rksd -d spl/u-boot-spl.bin out |
Heiko Stübner | fdf967c | 2017-03-24 00:41:34 +0100 | [diff] [blame] | 228 | |
| 229 | # truncate, encode and append u-boot.bin |
| 230 | truncate -s %2048 u-boot.bin |
| 231 | cat u-boot.bin | split -b 512 --filter='openssl rc4 -K 7C4E0304550509072D2C7B38170D1711' >> out |
| 232 | |
| 233 | |
Xu Ziyuan | add8d49 | 2016-07-18 09:56:46 +0800 | [diff] [blame] | 234 | Using fastboot on rk3288 |
| 235 | ======================== |
Xu Ziyuan | add8d49 | 2016-07-18 09:56:46 +0800 | [diff] [blame] | 236 | - Write GPT partition layout to mmc device which fastboot want to use it to |
| 237 | store the image |
| 238 | |
| 239 | => gpt write mmc 1 $partitions |
| 240 | |
| 241 | - Invoke fastboot command to prepare |
| 242 | |
| 243 | => fastboot 1 |
| 244 | |
| 245 | - Start fastboot request on PC |
| 246 | |
| 247 | fastboot -i 0x2207 flash loader evb-rk3288/spl/u-boot-spl-dtb.bin |
| 248 | |
| 249 | You should see something like: |
| 250 | |
| 251 | => fastboot 1 |
| 252 | WARNING: unknown variable: partition-type:loader |
| 253 | Starting download of 357796 bytes |
| 254 | .. |
| 255 | downloading of 357796 bytes finished |
| 256 | Flashing Raw Image |
| 257 | ........ wrote 357888 bytes to 'loader' |
| 258 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 259 | Booting from SPI |
| 260 | ================ |
| 261 | |
| 262 | To write an image that boots from SPI flash (e.g. for the Haier Chromebook): |
| 263 | |
Simon Glass | 2ac4648 | 2015-12-29 05:22:45 -0700 | [diff] [blame] | 264 | ./chromebook_jerry/tools/mkimage -n rk3288 -T rkspi \ |
| 265 | -d chromebook_jerry/spl/u-boot-spl-dtb.bin spl.bin && \ |
| 266 | dd if=spl.bin of=spl-out.bin bs=128K conv=sync && \ |
| 267 | cat spl-out.bin chromebook_jerry/u-boot-dtb.img >out.bin && \ |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 268 | dd if=out.bin of=out.bin.pad bs=4M conv=sync |
| 269 | |
| 270 | This converts the SPL image to the required SPI format by adding the Rockchip |
| 271 | header and skipping every 2KB block. Then the U-Boot image is written at |
| 272 | offset 128KB and the whole image is padded to 4MB which is the SPI flash size. |
| 273 | The position of U-Boot is controlled with this setting in U-Boot: |
| 274 | |
| 275 | #define CONFIG_SYS_SPI_U_BOOT_OFFS (128 << 10) |
| 276 | |
| 277 | If you have a Dediprog em100pro connected then you can write the image with: |
| 278 | |
| 279 | sudo em100 -s -c GD25LQ32 -d out.bin.pad -r |
| 280 | |
| 281 | When booting you should see something like: |
| 282 | |
| 283 | U-Boot SPL 2015.07-rc2-00215-g9a58220-dirty (Jun 23 2015 - 12:11:32) |
| 284 | |
| 285 | |
| 286 | U-Boot 2015.07-rc2-00215-g9a58220-dirty (Jun 23 2015 - 12:11:32 -0600) |
| 287 | |
| 288 | Model: Google Jerry |
| 289 | DRAM: 2 GiB |
| 290 | MMC: |
| 291 | Using default environment |
| 292 | |
| 293 | In: serial@ff690000 |
| 294 | Out: serial@ff690000 |
| 295 | Err: serial@ff690000 |
| 296 | => |
| 297 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 298 | Future work |
| 299 | =========== |
| 300 | |
| 301 | Immediate priorities are: |
| 302 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 303 | - USB host |
| 304 | - USB device |
Simon Glass | 419bf14 | 2016-01-21 19:45:25 -0700 | [diff] [blame] | 305 | - Run CPU at full speed (code exists but we only see ~60 DMIPS maximum) |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 306 | - NAND flash |
| 307 | - Support for other Rockchip parts |
| 308 | - Boot U-Boot proper over USB OTG (at present only SPL works) |
| 309 | |
| 310 | |
| 311 | Development Notes |
| 312 | ================= |
| 313 | |
| 314 | There are plenty of patches in the links below to help with this work. |
| 315 | |
| 316 | [1] https://github.com/rkchrome/uboot.git |
| 317 | [2] https://github.com/linux-rockchip/u-boot-rockchip.git branch u-boot-rk3288 |
| 318 | [3] https://github.com/linux-rockchip/rkflashtool.git |
| 319 | [4] http://wiki.t-firefly.com/index.php/Firefly-RK3288/Serial_debug/en |
| 320 | |
| 321 | rkimage |
| 322 | ------- |
| 323 | |
| 324 | rkimage.c produces an SPL image suitable for sending directly to the boot ROM |
| 325 | over USB OTG. This is a very simple format - just the string RK32 (as 4 bytes) |
| 326 | followed by u-boot-spl-dtb.bin. |
| 327 | |
| 328 | The boot ROM loads image to 0xff704000 which is in the internal SRAM. The SRAM |
| 329 | starts at 0xff700000 and extends to 0xff718000 where we put the stack. |
| 330 | |
| 331 | rksd |
| 332 | ---- |
| 333 | |
| 334 | rksd.c produces an image consisting of 32KB of empty space, a header and |
| 335 | u-boot-spl-dtb.bin. The header is defined by 'struct header0_info' although |
| 336 | most of the fields are unused by U-Boot. We just need to specify the |
| 337 | signature, a flag and the block offset and size of the SPL image. |
| 338 | |
| 339 | The header occupies a single block but we pad it out to 4 blocks. The header |
| 340 | is encoding using RC4 with the key 7c4e0304550509072d2c7b38170d1711. The SPL |
| 341 | image can be encoded too but we don't do that. |
| 342 | |
| 343 | The maximum size of u-boot-spl-dtb.bin which the boot ROM will read is 32KB, |
| 344 | or 0x40 blocks. This is a severe and annoying limitation. There may be a way |
| 345 | around this limitation, since there is plenty of SRAM, but at present the |
| 346 | board refuses to boot if this limit is exceeded. |
| 347 | |
| 348 | The image produced is padded up to a block boundary (512 bytes). It should be |
| 349 | written to the start of an SD card using dd. |
| 350 | |
| 351 | Since this image is set to load U-Boot from the SD card at block offset, |
| 352 | CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR, dd should be used to write |
| 353 | u-boot-dtb.img to the SD card at that offset. See above for instructions. |
| 354 | |
| 355 | rkspi |
| 356 | ----- |
| 357 | |
| 358 | rkspi.c produces an image consisting of a header and u-boot-spl-dtb.bin. The |
| 359 | resulting image is then spread out so that only the first 2KB of each 4KB |
| 360 | sector is used. The header is the same as with rksd and the maximum size is |
| 361 | also 32KB (before spreading). The image should be written to the start of |
| 362 | SPI flash. |
| 363 | |
| 364 | See above for instructions on how to write a SPI image. |
| 365 | |
Simon Glass | b42f7e4 | 2016-01-21 19:45:08 -0700 | [diff] [blame] | 366 | rkmux.py |
| 367 | -------- |
| 368 | |
| 369 | You can use this script to create #defines for SoC register access. See the |
| 370 | script for usage. |
| 371 | |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 372 | |
| 373 | Device tree and driver model |
| 374 | ---------------------------- |
| 375 | |
| 376 | Where possible driver model is used to provide a structure to the |
| 377 | functionality. Device tree is used for configuration. However these have an |
| 378 | overhead and in SPL with a 32KB size limit some shortcuts have been taken. |
| 379 | In general all Rockchip drivers should use these features, with SPL-specific |
| 380 | modifications where required. |
| 381 | |
Jacob Chen | 615cacc | 2016-10-08 13:47:42 +0800 | [diff] [blame] | 382 | GPT partition layout |
| 383 | ---------------------------- |
| 384 | |
| 385 | Rockchip use a unified GPT partition layout in open source support. |
| 386 | With this GPT partition layout, uboot can be compatilbe with other components, |
| 387 | like miniloader, trusted-os, arm-trust-firmware. |
| 388 | |
| 389 | There are some documents about partitions in the links below. |
| 390 | http://rockchip.wikidot.com/partitions |
Simon Glass | f874fdc | 2015-08-30 16:55:43 -0600 | [diff] [blame] | 391 | |
| 392 | -- |
| 393 | Simon Glass <sjg@chromium.org> |
| 394 | 24 June 2015 |