Description
HiKey is one of 96boards. Hisilicon Kirin6220 processor is installed on HiKey.
More information are listed in link.
How to build
Code Locations
- Trusted Firmware-A: link
- OP-TEE link
- edk2: link
- OpenPlatformPkg: link
- l-loader: link
- uefi-tools: link
- atf-fastboot: link
Build Procedure
- Fetch all the above repositories into local host. Make all the repositories in the same ${BUILD_PATH}.
git clone https://github.com/ARM-software/arm-trusted-firmware -b integration git clone https://github.com/OP-TEE/optee_os git clone https://github.com/96boards-hikey/edk2 -b testing/hikey960_v2.5 git clone https://github.com/96boards-hikey/OpenPlatformPkg -b testing/hikey960_v1.3.4 git clone https://github.com/96boards-hikey/l-loader -b testing/hikey960_v1.2 git clone https://git.linaro.org/uefi/uefi-tools git clone https://github.com/96boards-hikey/atf-fastboot
-
Create the symbol link to OpenPlatformPkg in edk2.
$cd ${BUILD_PATH}/edk2 $ln -sf ../OpenPlatformPkg
-
Prepare AARCH64 && AARCH32 toolchain. Prepare python.
-
If your hikey hardware is built by CircuitCo, update uefi-tools/platform.config first. (optional) Uncomment the below sentence. Otherwise, UEFI can't output messages on serial console on hikey.
BUILDFLAGS=-DSERIAL_BASE=0xF8015000
If your hikey hardware is built by LeMaker, nothing to do.
-
Build it as debug mode. Create your own build script file or you could refer to build_uefi.sh in l-loader git repository.
BUILD_OPTION=DEBUG export AARCH64_TOOLCHAIN=GCC5 export UEFI_TOOLS_DIR=${BUILD_PATH}/uefi-tools export EDK2_DIR=${BUILD_PATH}/edk2 EDK2_OUTPUT_DIR=${EDK2_DIR}/Build/HiKey/${BUILD_OPTION}_${AARCH64_TOOLCHAIN} # Build fastboot for Trusted Firmware-A. It's used for recovery mode. cd ${BUILD_PATH}/atf-fastboot CROSS_COMPILE=aarch64-linux-gnu- make PLAT=hikey DEBUG=1 # Convert DEBUG/RELEASE to debug/release FASTBOOT_BUILD_OPTION=$(echo ${BUILD_OPTION} | tr '[A-Z]' '[a-z]') cd ${EDK2_DIR} # Build UEFI & Trusted Firmware-A ${UEFI_TOOLS_DIR}/uefi-build.sh -b ${BUILD_OPTION} -a ../arm-trusted-firmware -s ../optee_os hikey
-
Generate l-loader.bin and partition table for aosp. The eMMC capacity is either 8GB or 4GB. Just change "aosp-8g" to "linux-8g" for debian.
cd ${BUILD_PATH}/l-loader ln -sf ${EDK2_OUTPUT_DIR}/FV/bl1.bin ln -sf ${EDK2_OUTPUT_DIR}/FV/bl2.bin ln -sf ${BUILD_PATH}/atf-fastboot/build/hikey/${FASTBOOT_BUILD_OPTION}/bl1.bin fastboot.bin make hikey PTABLE_LST=aosp-8g
Setup Console
-
Install ser2net. Use telnet as the console since UEFI fails to display Boot Manager GUI in minicom. If you don't need Boot Manager GUI, just ignore this section.
$sudo apt-get install ser2net
-
Configure ser2net.
$sudo vi /etc/ser2net.conf
Append one line for serial-over-USB in below. #ser2net.conf
2004:telnet:0:/dev/ttyUSB0:115200 8DATABITS NONE 1STOPBIT banner
-
Start ser2net
$sudo killall ser2net $sudo ser2net -u
-
Open the console.
$telnet localhost 2004
And you could open the console remotely, too.
Flash images in recovery mode
-
Make sure Pin3-Pin4 on J15 are connected for recovery mode. Then power on HiKey.
-
Remove the modemmanager package. This package may cause the idt tool failure.
$sudo apt-get purge modemmanager
-
Run the command to download recovery.bin into HiKey.
$sudo python hisi-idt.py -d /dev/ttyUSB1 --img1 recovery.bin
-
Update images. All aosp or debian images could be fetched from link.
$sudo fastboot flash ptable prm_ptable.img $sudo fastboot flash loader l-loader.bin $sudo fastboot flash fastboot fip.bin $sudo fastboot flash boot boot.img $sudo fastboot flash cache cache.img $sudo fastboot flash system system.img $sudo fastboot flash userdata userdata.img
Boot UEFI in normal mode
- Make sure Pin3-Pin4 on J15 are open for normal boot mode. Then power on HiKey.
- Reference link