en:c2_building_u-boot [ODROID Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== U-boot ======

U-boot must be cross-compiled on an x86 box

===== Toolchain =====
Click one of the site to download toolchain to build U-boot.
  * [[https://releases.linaro.org/14.09/components/toolchain/binaries/gcc-linaro-aarch64-none-elf-4.9-2014.09_linux.tar.xz|Download #1]]
  * [[http://dn.odroid.com/toolchains/gcc-linaro-aarch64-none-elf-4.9-2014.09_linux.tar.xz|Download #2]]
Once the download is done, extract the tarball to **/opt/toolchains/**.
<code>
$ sudo mkdir -p /opt/toolchains
$ sudo tar xvf gcc-linaro-aarch64-none-elf-4.9-2014.09_linux.tar.xz -C /opt/toolchains/
</code>
In order to add the toolchain path to PATH, paste below lines to **$HOME/.bashrc**.
<code>
export ARCH=arm
export CROSS_COMPILE=aarch64-none-elf-
export PATH=/opt/toolchains/gcc-linaro-aarch64-none-elf-4.9-2014.09_linux/bin/:$PATH
</code>
You can apply the change if you login again or import 
to apply this change, login again or evaluate **$HOME/.bashrc** with source command.
<code>
$ source ~/.bashrc
</code>
You can check if the toolchain installed above works properly while checking the version of toolchain. If you can find **gcc version 4.9.2 20140904 (prerelease)** at the end of the line, the toolchain is well installed.
<code>
$ aarch64-none-elf-gcc -v
Using built-in specs.
COLLECT_GCC=aarch64-none-elf-gcc
COLLECT_LTO_WRAPPER=/opt/toolchains/gcc-linaro-aarch64-none-elf-4.9-2014.09_linux/bin/../libexec/gcc/aarch64-none-elf/4.9.2/lto-wrapper
Target: aarch64-none-elf
Configured with: /cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/src/gcc-linaro-4.9-2014.09/configure --build=i686-build_pc-linux-gnu --host=i686-build_pc-linux-gnu --target=aarch64-none-elf --prefix=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/install --with-local-prefix=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/install/aarch64-none-elf --without-headers --with-newlib --enable-threads=no --disable-shared --with-pkgversion='crosstool-NG linaro-1.13.1-4.9-2014.09 - Linaro GCC 4.9-2014.09' --with-bugurl=https://bugs.launchpad.net/gcc-linaro --with-arch=armv8-a --disable-__cxa_atexit --with-gmp=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --with-mpfr=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --with-mpc=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --with-isl=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --with-cloog=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --with-libelf=/cbuild/slaves/oorts/crosstool-ng/builds/aarch64-none-elf-linux/.build/aarch64-none-elf/build/static --enable-lto --enable-linker-build-id --disable-libmudflap --disable-libgomp --disable-libssp --disable-libstdcxx-pch --enable-multiarch --disable-multilib --enable-languages=c,c++,fortran
Thread model: single
gcc version 4.9.2 20140904 (prerelease) (crosstool-NG linaro-1.13.1-4.9-2014.09 - Linaro GCC 4.9-2014.09) 
</code>


===== Checkout & compile =====
You can checkout **U-boot** source tree from **[[https://github.com/hardkernel/u-boot/tree/odroidc-v2011.03|Hardkernel's Github]]**.
<code>
$ git clone https://github.com/hardkernel/u-boot.git -b odroidc2-v2015.01
</code>
Before you compile **U-boot**, you must configure for **ODROID-C2** with following command.
<code>
$ cd u-boot
$ make odroidc2_config
</code>
And finally you can compile **U-boot**. 
<code>
$ make
</code>
===== Installation =====
The bootloader for **ODROID-C2** is consisted with two part, **1st stage bootloader** + **U-boot**. You can find **u-boot.bin** once you compile **U-boot**, as well as **bl1.bin.hardkernel** in the directory **sd_fuse/**. Both binaries must be installed in a card (eMMC or MicroSD).
<WRAP left round tip 70%>
  * The 1st stage bootloader, **bl1.bin.hardkernel**, is provided as prebuilt binary only.
  * The u-boot binary needs to be signed. This is done by an x86-64 executable, **aml_encrypt_gxb**, which is shipped with the u-boot source; source for aml_encrypt_gxb is not available..
</WRAP>
==== Installation to blank card ====
We provide the script, **sd_fuse/sd_fusing.sh**, this helps you to install the bootloader into your blank card eMMC or MicroSD.
  - Insert your card to USB card reader and attach to USB host port of your desktop.
  - Check the device path of your USB card reader.
  - Install the bootloader binaries using **sd_fuse/sd_fusing.sh**.
<code>
$ cd sd_fuse
$ ./sd_fusing.sh <device/path/of/your/card>
</code>

You can download and install the latest version of binaries as following.

Click the following site to download the boot loader of final release version
  * [[http://dn.odroid.com/S905/BootLoader/ODROID-C2/c2_boot_ubuntu_release.tar.gz|Download - Ubuntu 16.04 release v2.0 update Sep 08 2016]]
  * [[http://dn.odroid.com/S905/BootLoader/ODROID-C2/c2_boot_android_release.tar.gz|Download - Android 5.1.1 release v2.2]]

<code>
$ tar zxvf c2_boot_xxx_release.tar.gz
$ cd c2_boot_xxx_release
$ ./sd_fusing.sh <device/path/of/your/card>
</code>
==== Installation using fastboot ====
If you can boot your **ODROID-C2** already and want to install a new **u-boot.bin** built by you. Fastboot helps you to install a **u-boot.bin** into your board.
<code>
$ sudo fastboot flash bootloader sd_fuse/u-boot.bin
</code>
If installation is done, you care reboot your **ODROID-C2** with fastboot.
<code>
$ sudo fastboot reboot
</code>
==== Installation from Linux on C2 ====
You can also install U-boot from Linux with **dd** command. After building U-boot, copy **u-boot.bin** into your **ODROID-C2**. Then do the command below in order to flash your U-boot image to MicroSD or eMMC.
<code>
$ sudo dd if=u-boot.bin of=/dev/mmcblk0 bs=512 seek=97
$ sudo sync
</code>

<WRAP left round tip 80%>
  * You must use the u-boot.bin binary under the folder, "u-boot/sd_fuse/u-boot.bin"
</WRAP>

==== Update from Linux on ODROID-C2 board using u-boot package ====
On ODROID-C2 ubuntu, you can update U-boot with the latest released one using apt-get install command.
<code>
$ sudo apt-get install u-boot
</code>

===== TFTP =====
==== HOST-PC ====
  * **NOTE:** //This step is Ubuntu 14.04 example.//

Install the package:
<code>
$ sudo apt-get install tftpd-hpa
</code>

Edit config file as follows:
<code>
$ sudo vi /etc/default/tftpd-hpa
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="-s -c -l"
</code>

Create TFTP folder:
<code>
sudo mkdir /tftpboot
sudo chmod -R 777 /tftpboot
sudo chown -R nobody /tftpboot
</code>

Restart the app to apply new configuration:
<code>
sudo service tftpd-hpa restart
</code>

Copy //Image//, //meson64_odroidc2.dtb// and //uInitrd// files to ///tftpboot// directory.

==== U-Boot ====
**Assumptions:**
  * TFTP server IP address: //192.168.0.2//
  * ODROID-C2 IP address: //192.168.0.3//

Set the tftp server & board ip address:
<code>
odroidc2# setenv serverip 192.168.0.2
odroidc2# setenv ipaddr 192.168.0.3
</code>

Download images using tftp:
<code>
odroidc2# tftp 0x1000000 meson64_odroidc2.dtb
odroidc2# tftp 0x11000000 Image
odroidc2# tftp 0x13000000 uInitrd
</code>

Booting:
<code>
odroidc2# setenv condev "console=ttyS0,115200n8 console=tty0"
odroidc2# setenv m "1080p60hz"
odroidc2# setenv m_bpp "32"
odroidc2# setenv bootargs "root=UUID=e139ce78-9841-40fe-8823-96a304a09859 rootwait rw ${condev} no_console_suspend hdmimode=${m} m_bpp=${m_bpp} fsck.fix=yes"
odroidc2# booti 0x11000000 0x13000000 0x1000000
</code>

===== How to build u-boot with bl301 firmware =====

Because of the issue of build failure on any platform other than x86-64 and support of buildroot, we've separated bl301 firmware source code from u-boot repository.

In the path, u-boot/fip/gxb/, there is a pre-built bl301.bin binary of the latest version, so you can build just u-boot without a re-build bl301 process.

If you want to modify and update bl301-related source codes by yourself, please refer to the following.

=== Download and Merge ===

You can checkout **bl301 firmware** source tree from **[[https://github.com/hardkernel/u-boot_firmware/tree/odroidc2-bl301|Hardkernel's Github]]**.
<code>
$ git clone https://github.com/hardkernel/u-boot_firmware.git -b odroidc2-bl301
</code>
You should merge bl301 with u-boot before build it.
<code>
$ git clone https://github.com/hardkernel/u-boot.git -b odroidc2-v2015.01
$ git clone https://github.com/hardkernel/u-boot_firmware.git -b odroidc2-bl301

$ cd u-boot

$ git remote add u-boot_firmware ../u-boot_firmware/
$ git fetch u-boot_firmware 
$ git merge --no-commit u-boot_firmware/odroidc2-bl301 
</code>

=== Toolchain to build bl301 ===

bl301.bin source code needs a toolchain, arm-none-eabi-.
Click one of the site to download toolchain to build U-boot.
  * [[http://dn.odroid.com/toolchains/gcc-linaro-arm-none-eabi-4.8-2014.04_linux.tar.xz|Download]]
Once the download is done, extract the tarball to **/opt/toolchains/**.
<code>
$ sudo mkdir -p /opt/toolchains
$ sudo tar xvf gcc-linaro-arm-none-eabi-4.8-2014.04_linux.tar.xz -C /opt/toolchains/
</code>
In order to add the toolchain path to PATH, paste below lines to **$HOME/.bashrc**.
<code>
export PATH=/opt/toolchains/gcc-linaro-arm-none-eabi-4.8-2014.04_linux/bin/:$PATH
</code>
You can apply the change if you login again or import 
to apply this change, login again or evaluate **$HOME/.bashrc** with source command.
<code>
$ source ~/.bashrc
</code>
You can check if the toolchain installed above works properly while checking the version of toolchain.
<code>
Using built-in specs.
COLLECT_GCC=arm-none-eabi-gcc
COLLECT_LTO_WRAPPER=/opt/toolchains/gcc-linaro-arm-none-eabi-4.8-2014.04_linux/bin/../libexec/gcc/arm-none-eabi/4.8.3/lto-wrapper
Target: arm-none-eabi
Configured with: /cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/src/gcc-linaro-4.8-2014.04/configure --build=i686-build_pc-linux-gnu --host=i686-build_pc-linux-gnu --target=arm-none-eabi --prefix=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/install --with-local-prefix=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/install/arm-none-eabi --without-headers --with-newlib --enable-threads=no --disable-shared --with-pkgversion='crosstool-NG linaro-1.13.1-4.8-2014.04 - Linaro GCC 4.8-2014.04' --with-bugurl=https://bugs.launchpad.net/gcc-linaro --disable-__cxa_atexit --with-gmp=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --with-mpfr=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --with-mpc=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --with-isl=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --with-cloog=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --with-libelf=/cbuild/slaves/oorts/crosstool-ng/builds/arm-none-eabi-linux/.build/arm-none-eabi/build/static --enable-lto --enable-linker-build-id --enable-libmudflap --disable-libgomp --enable-libssp --disable-libstdcxx-pch --enable-multilib --enable-languages=c,c++,fortran --with-multilib-list=aprofile
Thread model: single
gcc version 4.8.3 20140401 (prerelease) (crosstool-NG linaro-1.13.1-4.8-2014.04 - Linaro GCC 4.8-2014.04) 
</code>

=== Build ===
And finally you can compile u-boot with bl301 firmware.
<code>
$ cd u-boot
$ make distclean
$ make odroidc2_config
$ make
</code>