Revision as of 00:32, 14 March 2017

U-Boot Guide

Download U-Boot

Upstream U-Boot

You can clone the u-boot repository by running:

git clone git://git.denx.de/u-boot.git

Alternatively you can use u-boot-rockchip instead which may with some patches not get in mainline:

git clone git://git.denx.de/u-boot-rockchip.git

Rockchip U-Boot

You can clone the u-boot repository by running:

git clone https://github.com/rockchip-linux/u-boot.git

Supported Devices

Upstream U-Boot support Rockchip SoCs:

RK3036, RK3188, RK3288, RK3328, RK3399

RK3036 boards supported:

EVB RK3036 - use evb-rk3036 configuration
Kylin - use kylin_rk3036 configuration

RK3288 boards supported:

EVB RK3288 - use evb-rk3288 configuration
Fennec RK3288 - use fennec-rk3288 configuration
Firefly RK3288 - use firefly-rk3288 configuration
Hisense Chromebook - use chromebook_jerry configuration
Miniarm RK3288 - use miniarm-rk3288 configuration
PopMetal RK3288 - use popmetal-rk3288 configuration
Radxa Rock 2 - use rock2 configuration
ASUS Tinker

RK3188 boards supported:

Radxa Rock - use rock configuration

RK3328 boards supported:

EVB RK3328 - use evb-rk3328 configuration

RK3399 boards supported:

EVB RK3399 - use evb-rk3399 configuration

Configure U-Boot

First you need to chose a correct defconfig for your board;

When you have determined what <board_name> you want to build, configure:

make CROSS_COMPILE=arm-linux-gnueabi- <board_name>_defconfig

You may need to change the U-Boot function/feature support by modify the defconfig file or,

there is also menuconfig to play with settings if you feel like it:

make CROSS_COMPILE=arm-linux-gnueabi- menuconfig

Build U-Boot

Get a toolchain

If you haven't done so before, get a suitable toolchain installed and added to your PATH.

In Ubuntu 14.04, you can use below command to install cross compiler for armv7:

sudo apt-get install gcc-arm-linux-gnueabi

Or for ARM64

sudo apt-get install gcc-aarch64-linux-gnu

Build

For armv7:

make CROSS_COMPILE=arm-linux-gnueabi-

or for ARM64:

make ARCH=arm CROSS_COMPILE=aarch64-linux-gnu-

In order to support debug in ARM DS-5, you may need add ctags in make command:

CFLAGS='-gdwarf-3'

Istall U-Boot

Rockchp SoCs's bootrom need special format named IDBlock at special offset 0x64 block for boot, so we need to package SPL(or Rockchip miniloader) in IDB format.

Rockchp bootrom supports SPL back to bootrom and bootrom load the U-Boot, so the SPL for Rockchip SoCs can option to back to bootrom, usually decide by if the IRAM is enought for driver to load U-Boot.

Using U-Boot SPL

After build complete, U-Boot with SPL support will generate a spl folder with u-boot-spl.bin inside

tools/mkimage -n rk3288 -T rksd -d spl/u-boot-spl.bin  rk3288_idb.img

This image is suppose to flash to offset 0x64.

For u-boot.bin, it's diffrent for SPL back to bootrom or not, if enable CONFIG_ROCKCHIP_SPL_BACK_TO_BROM, we can append the U-Boot to IDB data:

cat u-boot.bin >> rk3288_idb.img

If CONFIG_ROCKCHIP_SPL_BACK_TO_BROM not enabled, no more package operation is need for u-boot-dtb.bin, and it need to flalsh to 0x200 which is decide by CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR.

Support ATF with SPL FIT image

Using Rockchip miniloader

Alternatively, you can use Rockchip miniloader and U-Boot instead which do not need SPL.

The miniloader is package as IDBlock, and the u-boot.bin need to package with rockchip tool:

loaderimage --pack --uboot u-boot.bin rk3288_uboot.img

According to the partitions definition, this output should write to offset 0x4000.

Boot

Boot from eMMC

Boot from SD/TF Card

Creating Image

Follow linux-user-guide to build kernel and uboot.
get uboot-spl.img and u-boot-dtb.img

<code>tools/mkimage -n rk3288 -T rksd -d spl/u-boot-spl-dtb.bin uboot-spl.img</code>

`build boot.img`

<code>sudo dd if=/dev/zero of=boot.img bs=1M count=128
sudo mkfs.fat boot.img
mkdir boot
sudo mount  boot.img boot
sudo cp zImage boot
sudo cp rk3288-fennec.dtb boot
sudo mkdir boot/extlinux
sudo cp extlinux.conf boot/extlinux
sudo umount boot</code>

Download rootfs image and rename it

<code>mv linaro-rootfs.img rootfs.img</code>

Making a SD Card for updating

Download ramdisk source and build.

<code>sh ./mk-initrd.sh</code>

Format SD card

<code>chen@chen-HP-ProDesk-680-G1-TWR:~/work/linaro-alip/ramdisk/update$ sudo gdisk /dev/sdb
GPT fdisk (gdisk) version 0.8.8

Partition table scan:
  MBR: protective
  BSD: not present
  APM: not present
  GPT: present

Found valid GPT with protective MBR; using GPT.

Command (? for help): o
This option deletes all partitions and creates a new protective MBR.
Proceed? (Y/N): y

Command (? for help): n
Partition number (1-128, default 1): 1
First sector (34-126613470, default = 2048) or {+-}size{KMGTP}: 8192
Last sector (8192-126613470, default = 126613470) or {+-}size{KMGTP}: 
Current type is 'Linux filesystem'
Hex code or GUID (L to show codes, Enter = 8300): 
Changed type of partition to 'Linux filesystem'

Command (? for help): w

Final checks complete. About to write GPT data. THIS WILL OVERWRITE EXISTING
PARTITIONS!!

Do you want to proceed? (Y/N): y
OK; writing new GUID partition table (GPT) to /dev/sdc.
Warning: The kernel is still using the old partition table.
The new table will be used at the next reboot.
The operation has completed successfully.</code>

<code>sudo umount /dev/sdb1
sudo mkfs.fat /dev/sdb1</code>

<code>tools/mkimage -n rk3288 -T rksd -d spl/u-boot-spl-dtb.bin out&&
sudo dd if=out of=/dev/sdb seek=64&&sudo dd if=u-boot-dtb.img of=/dev/sdb seek=256</code>

Copy zimage, dts and ramdisk to /dev/sdb1

<code>cp arch/arm/boot/zImage /media/chen/9F35-9565/
cp arch/arm/boot/dts/rk3288-fennec.dtb /media/chen/9F35-9565/rk3288-fennec.dtb
cp ../rk-initrd-build/initrd.img /media/chen/9F35-9565/</code>

Add extlinux/extlinux.conf to /dev/sdb1

<code>label kernel-4.4
    kernel /zImage
    fdt /rk3288-fennec.dtb
    initrd /initrd.img
    append  earlyprintk console=ttyS2,115200n8 rw root=/dev/ram0 rootfstype=ext4 init=/sbin/init ramdisk_size=49152</code>

Copy u-boot-dtb.img uboot-spl.img boot.img rootfs.img and update.sh to /dev/sdb1

<code>mkdir /media/chen/9F35-9565/update
cp u-boot-dtb.img /media/chen/9F35-9565/update
cp uboot-spl.img /media/chen/9F35-9565/update
cp boot.img /media/chen/9F35-9565/update
cp rootfs.img /media/chen/9F35-9565/update
cp update.sh /media/chen/9F35-9565/update</code>

Updating the board

Boot the board and it will flash image to eMMC

Boot from USB-Disk

Netboot/TFTP

Distro boot

U-Boot download

In U-Boot, there are multi way to update image for system, you can chose any of one easy use for you.

fastboot

See fastboot

@@ Line 12: / Line 12: @@
 <pre>git clone git://git.denx.de/u-boot-rockchip.git</pre>
-== Rockchp U-Boot ==
+== Rockchip U-Boot ==
 You can clone the u-boot repository by running:

Difference between revisions of "U-Boot"