From 3d3b02d942ee811057800d3fef2f700b2bb8142c Mon Sep 17 00:00:00 2001 From: Haojian Zhuang Date: Wed, 24 May 2017 09:36:49 +0800 Subject: hikey: add hikey support Add the description on hikey and how to build. Signed-off-by: Haojian Zhuang --- docs/plat/hikey.md | 123 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 docs/plat/hikey.md (limited to 'docs/plat/hikey.md') diff --git a/docs/plat/hikey.md b/docs/plat/hikey.md new file mode 100644 index 00000000..a5e592bb --- /dev/null +++ b/docs/plat/hikey.md @@ -0,0 +1,123 @@ + +Description +==================== + HiKey is one of 96boards. Hisilicon Kirin6220 processor is installed on HiKey. + + More information are listed in [link](https://github.com/96boards/documentation/blob/master/ConsumerEdition/HiKey/Quickstart/README.md). + + +How to build +==================== + +1. Code Locations +----------------- + + * ARM Trusted Firmware: + [link](https://github.com/ARM-software/arm-trusted-firmware) + + * edk2: + [link](https://github.com/96boards-hikey/edk2/tree/testing/hikey960_v2.5) + + * OpenPlatformPkg: + [link](https://github.com/96boards-hikey/OpenPlatformPkg/tree/testing/hikey960_v1.3.4) + + * l-loader: + [link](https://github.com/96boards-hikey/l-loader/tree/testing/hikey960_v1.2) + + * uefi-tools: + [link](https://github.com/96boards-hikey/uefi-tools/tree/testing/hikey960_v1) + + * atf-fastboot: + [link](https://github.com/96boards-hikey/atf-fastboot/tree/master) + + +2. Build Procedure +------------------ + + * Fetch all the above repositories into local host. + Make all the repositories in the same ${BUILD_PATH}. + + * 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 LeMarker, 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 ARM Trust Firmware. 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 & ARM Trust Firmware`
+
`${UEFI_TOOLS_DIR}/uefi-build.sh -b ${BUILD_OPTION} -a ../arm-trusted-firmware hikey`
+
`# Generate l-loader.bin`
+
`cd ${BUILD_PATH}/l-loader`
+
`ln -sf ${EDK2_OUTPUT_DIR}/FV/bl1.bin`
+
`ln -sf ${EDK2_OUTPUT_DIR}/FV/fip.bin`
+
`ln -sf ${BUILD_PATH}/atf-fastboot/build/hikey/${FASTBOOT_BUILD_OPTION}/bl1.bin fastboot.bin`
+
`python gen_loader.py -o l-loader.bin --img_bl1=bl1.bin --img_ns_bl1u=BL33_AP_UEFI.fd`
+
`arm-linux-gnueabihf-gcc -c -o start.o start.S`
+
`arm-linux-gnueabihf-ld -Bstatic -Tl-loader.lds -Ttext 0xf9800800 start.o -o loader`
+
`arm-linux-gnueabihf-objcopy -O binary loader temp`
+
`python gen_loader_hikey.py -o l-loader.bin --img_loader=temp --img_bl1=bl1.bin --img_ns_bl1u=fastboot.bin`
+ + * Generate partition table for aosp. The eMMC capacity is either 4GB or 8GB. Just change "aosp-4g" to "linux-4g" for debian. +
`$PTABLE=aosp-4g SECTOR_SIZE=512 bash -x generate_ptable.sh`
+ + +3. 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`
+ + * Open the console. +
`$telnet localhost 2004`
+
And you could open the console remotely, too.
+ + +4. Flush 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 l-loader.bin into HiKey. +
`$sudo python hisi-idt.py -d /dev/ttyUSB1 --img1 l-loader.bin`
+ + * Update images. All aosp or debian images could be fetched from [link](https://builds.96boards.org/). +
`$sudo fastboot flash ptable prm_ptable.img`
+
`$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`
+ + +5. Boot UEFI in normal mode +----------------------------- + + * Make sure Pin3-Pin4 on J15 are open for normal boot mode. Then power on HiKey. + + * Reference [link](https://github.com/96boards-hikey/tools-images-hikey960/blob/master/build-from-source/README-ATF-UEFI-build-from-source.md) -- cgit v1.2.3