This is a cache of https://www.96boards.org/documentation/consumer/hikey/hikey960/build/android-mainline.md.html. It is a snapshot of the page at 2024-12-21T01:52:28.776+0000.
Build the android-mainline kernel for <strong>hikey</strong>960 - 96Boards

Build the android-mainline kernel for hikey960

Since the ACK (Android Common Kernel) android-mainline branch in AOSP does not officially support the hikey960 dev board, Linaro does some work to keep this combination working on a best-effort basis. Here are some instructions on how to build the ACK android-mainline kernel for this dev board for people interested in it.

The instruction is based on the Android Building Kernels document.

Repo sync the android-mainline source

$ mkdir android-kernel && cd android-kernel
$ repo init -u https://android.googlesource.com/kernel/manifest \
        -b common-android-mainline
$ repo sync -j$(nproc)

Git clone the external module repository

$ git clone -b android-mainline-linaro \
        https://android-git.linaro.org/git/kernel/hikey-modules \
        hikey-modules-linaro/hikey960/android-mainline

Apply out of tree patches

Since there are some out of tree patches used as temporary workaround, they should be applied before start building the kernel.

$ cd common && \
        ../hikey-modules-linaro/hikey960/android-mainline/patchsets/apply.sh && \
        cd -

Build the kernel

$ tools/bazel run \
        --config=release \
        //hikey-modules-linaro/hikey960/android-mainline:hikey960_dist

Artifacts path

The kernel/dtb/ko files could be found under the directory of out/android-mainline/dist:

$ ls -1 out/android-mainline/dist/Image* out/android-mainline/dist/*.dtb
out/android-mainline/dist/Image
out/android-mainline/dist/Image.gz
out/android-mainline/dist/hi3660-hikey960.dtb
...
$

Build AOSP with the android-mainline kernel files

For the instructions on how to build the userspace images with the AOSP tree, the instructions on Android Open Source Project for hikey960 boards could be referred to.

Download the AOSP tree:

$ repo init -u https://android.googlesource.com/platform/manifest -b master
$ repo sync -j$(nproc)

Delete all files under ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/ , then copy all the artifact files from the kernel build dist directory to ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/

$ cp ${KERNEL_TOPDIR}/out/android-mainline/* \
        ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/

Build the Android Userspace:

$ ./device/linaro/hikey/fetch-vendor-package.sh
$ . ./build/envsetup.sh
$ lunch hikey960-userdebug
$ make TARGET_KERNEL_USE=mainline -j$(nproc)

To test with the android-mainline GKI kernel, please check the latest android-mainline kernel_aarch64 build, In artifacts, download the Image.gz file and copy it to ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/, concatenate the DTB:

$ cat ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/Image.gz \
        ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/hi3660-hikey960.dtb > \
        ${AOSP_TOPDIR}/device/linaro/hikey-kernel/hikey960/mainline/Image.gz-dtb

Build again with the new kernel using the instructions above.

Flash and deploy to the board

Please flash with the ./device/linaro/hikey/installer/hikey960/flash-all.sh script to deploy the new images.

One may refer to the Installing local images document for details.

$ ./device/linaro/hikey/installer/hikey960/flash-all.sh