Ubuntu 18.04
-
Download kernel source file from:
https://github.com/96boards-hikey/linux/tree/hikey970-v4.9
-
Make sure ARM64 GCC complier is installed: sudo apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
-
Go to the source folder and set up the enviroment variable for cross compie and buld kernel .config:
export CROSS_COMPILE=aarch64-linux-gnu-
make ARCH=arm64 hikey970_defconfig
-
Change .config with:
make ARCH=arm64 menuconfig
-
Build kernel:
make ARCH=arm64
-
The kernel image file is:
arch/arm64/boot/Image
-
git clone https://github.com/mengzhuo/hikey970-ubuntu-image and enter the folder
-
Replace the Image file with compiled kernel image in folder rootfs/boot
-
Run the build.sh. (might need "sudo apt-get install img2simg binfmt-support qemu qemu-user-static debootstrap")
-
The sparse rootfs image file is generate in the new created build folder, e.g. ubuntu_bionic.hikey970.v1.0-6-g775823b.sparse.img
-
Rename the sparse image file as rootfs.sparse.img.
-
Currently there are two version at the moment, hikey970_debin_0531_support_uvc or ubuntu_bionic.hikey971.v1.0. I used the ubuntu_bionic.hikey971.v1.0.
-
If host is Linux, install fastboot by "sudo apt install fastboot". If host is windows, install adb tool using the adb-setup-1.3.exe in download folder, which will install the fastboot to C:\abd and remember to add this path to system PATH variable. If you don't know how to do that, just Google :)
-
Set the board to adb mode through the four keys switch:
ON, OFF, ON, OFF.
-
Connect the cable to setup Type-C port. Power on the board.
-
I used the ubuntu_bionic.hikey971.v1.0 version, so just replace the rootfs.sparse.img file with the compiled one above and run update_hikey970.sh in the folder and wait for it finishes. (PS: use 64gtoendprm_ptable.img instead of prm_patable.img in the script to avoid the fractional partition. In this case, no need to use resize2fs command to extend the rootfs partition any more.)
-
Once installed, power off the board and change the four keys back to:
ON, OFF, OFF, OFF.
-
Pluging the Type-C UART cable to the board and power on it. The default user is 'hi' and password is 'hikey970'.
-
Change the content of file /etc/netplan/01-dhcp.yaml as the file '01-dhcp.yaml' in the folder.
PS: If you cannot make it work with netplan, just leave it. Connect the board to a router with internet connection and then the board is online by default DHCP. Install the ifupdown and enable it as the default network manager. By modifying the /etc/network/interfaces and /etc/resolv.conf, it can also the network configuration in old fashion.
-
Change the content of file /etc/apt/sources.list as the file 'sources.list' in the folder.
-
Run the command in file 'locale' in the folder.
-
Set the host ip address as 192.168.1.1 and share the internet through it and then install the xfce4: sudo apt update && sudo apt install xfce4
-
Now it is time to enjoy the debian on Hikey970. E.g. ssh -X hi@192.168.1.97. Notice, there is no display manager yet. You need to install either xdm/gdm/lightdm etc. to display the desktop at startup. (Some additional packages: autoconf automake intltool pkg-config glib2.0 gtk+2.0 dbus-glib2.0 xfconf gio2.0 libglade2.0 perl libwnck-3-dev gudev-1.0)
Please note that LeMaker has provided pre-built image for Hikey970. Please follow the link to download tar file and follow the installation guide:
http://www.lemaker.org/product-hikey970-resource.html
It seems I cannot access to LeMaker website for some reason. In case it disappeared, the link to pre-built image Lebuntu and Lebian are added.
Lebuntu: https://mega.nz/file/wTJkHb5R#AyaDuaFC4a-wdD9nVZ0jNS-b8mCMEvr0mg7FhWTba2s
Lebian: https://mega.nz/file/JW4GmKxR#DF6RhlFRwlKHB3n-KBONQDqugsJVdzxtLGH4E_YU8jo
(PS: only Lebian has the mali GPU driver)
One of the drawback of this pre-compiled image is that some kernel modules are not preloaded at boot, for example the fdti_sio. In order to have those kernel modules after boot, you need to compile the kernel modules manually from the source.
-
Copy the source to the /lib/modules on the board and rename it according to the current linux kernel information:
cp -r #(you download folder)/hikey970-v4.9 /lib/modlues/$(uname -r)
-
Go to the folder "/lib/modlues/$(uname -r)" and go through the step 1-4 in Hikey 970 Build Linux Kernel section. By openning the graphical configure interface, navigate to : "Device Drivers -> USB Support -> USB Serial Converter Support" and select 'M'module "USB FTDI Single Port Serial Driver". Then choose exit and save the configuration.
-
Build the additional kernel module with
make ARCH=arm64 M=drivers/usb/serial/
make ARCH=arm64 modules
make ARCH=arm64 modlues_install
-
You will see generated kernel module .ko files under drivers/usb/serial/ folder. Take the fdti_sio.ko for example, it can be loaded by insmod comamnd (need to load the module usbserial.ko first):
insmod drivers/usb/serial/usbserial.ko
insmod drivers/usb/serial/fdti_sio.ko
And unloaded using rmmod command:
rmmod drivers/usb/serial/fdti_sio.ko
rmmod drivers/usb/serial/usbserial.ko
Use lsmod command to check if they are loaded successfully. You can also use modprobe command to do steps 3 and 4.
Now you can attach the serieal connection device to the USB port and access them through /dev/ttyUSB* (* is the an integer number). This method is also valid for other kernel modules.
PS: All the commands executed above are under superuser mode, so run sudo -s before doing them. There are some prerequisite packages, please refer to https://help.ubuntu.com/community/Kernel/Compile. And if you are also interested in building up your own custom kernel module, follow this helloworld guide here: https://www.tldp.org/LDP/lkmpg/2.6/html/x181.html.
-
HDMI Display Overscan
-
Unallocated space within OS partition and small rootfs partition
-
Bluetooth Driver Halts because the invalid definition in DeviceTree
-
No access to GPS yet
-
No access to AI core yet
-
No Mali G72 userspace binary driver, hence no OpenCL support at the moment
-
If the board is fully connected with 2 usb (e.g. keyboard and mouse), 1 HDMI (e.g. monitor), 1 RJ45 (e.g. Ethernet) and 1 UART, there is a chance the Ethernet will not work. If remove everything except the RJ45, it will bring the Ethernet back. Then you can use the USB but not the HDMI as the board does not support hot plugin of HDMI.
1.It turns out the display overscan is caused by the compatibility of monitor with this board. It is solved by using another monitor.
2.Use resize2fs command to expand the full partition size. Install GParted (sudo apt install gparted) and resize the rootfs parition.
6.The latest Lebian from Lemaker has delivered userspace binary driver for G72. The binary library is /usr/lib/aarch64-linux-gnu/libmali.so. By installing the pocl, two OpenCL platforms can be found on Hikey 970. (Notice that Mali-G72 does not support cl_khr_fp64. )
./clinfo
Found 2 platform(s).
*******************0th platform******************************
platform[0xcd5c490]: profile: FULL_PROFILE
platform[0xcd5c490]: version: OpenCL 2.0 v1.r10p0-01rel0.e990c3e3ae25bde6c6a1b96097209d52
platform[0xcd5c490]: name: ARM Platform
platform[0xcd5c490]: vendor: ARM
platform[0xcd5c490]: extensions: cl_khr_global_int32_base_atomics cl_khr_global_int32_extended_atomics cl_khr_local_int32_base_atomics cl_khr_local_int32_extended_atomics cl_khr_byte_addressable_store cl_khr_3d_image_writes cl_khr_int64_base_atomics cl_khr_int64_extended_atomics cl_khr_fp16 cl_khr_icd cl_khr_egl_image cl_khr_image2d_from_buffer cl_khr_depth_images cl_arm_core_id cl_arm_printf cl_arm_thread_limit_hint cl_arm_non_uniform_work_group_size cl_arm_import_memory cl_arm_shared_virtual_memory
platform[0xcd5c490]: Found 1 device(s).
------------------------0th device------------------------
device[0xcdbc7f0]: NAME: Mali-G72
device[0xcdbc7f0]: VENDOR: ARM
device[0xcdbc7f0]: PROFILE: FULL_PROFILE
device[0xcdbc7f0]: VERSION: OpenCL 2.0 v1.r10p0-01rel0.e990c3e3ae25bde6c6a1b96097209d52
device[0xcdbc7f0]: EXTENSIONS: cl_khr_global_int32_base_atomics cl_khr_global_int32_extended_atomics cl_khr_local_int32_base_atomics cl_khr_local_int32_extended_atomics cl_khr_byte_addressable_store cl_khr_3d_image_writes cl_khr_int64_base_atomics cl_khr_int64_extended_atomics cl_khr_fp16 cl_khr_icd cl_khr_egl_image cl_khr_image2d_from_buffer cl_khr_depth_images cl_arm_core_id cl_arm_printf cl_arm_thread_limit_hint cl_arm_non_uniform_work_group_size cl_arm_import_memory cl_arm_shared_virtual_memory
device[0xcdbc7f0]: DRIVER_VERSION: 2.0
device[0xcdbc7f0]: Type: GPU
device[0xcdbc7f0]: EXECUTION_CAPABILITIES: Kernel
device[0xcdbc7f0]: GLOBAL_MEM_CACHE_TYPE: Read-Write (2)
device[0xcdbc7f0]: CL_DEVICE_LOCAL_MEM_TYPE: Global (2)
device[0xcdbc7f0]: SINGLE_FP_CONFIG: 0x3f
device[0xcdbc7f0]: QUEUE_PROPERTIES: 0x3
device[0xcdbc7f0]: VENDOR_ID: 1646329857
device[0xcdbc7f0]: MAX_COMPUTE_UNITS: 12
device[0xcdbc7f0]: MAX_WORK_ITEM_DIMENSIONS: 3
device[0xcdbc7f0]: MAX_WORK_GROUP_SIZE: 384
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_CHAR: 16
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_SHORT: 8
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_INT: 4
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_LONG: 2
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_FLOAT: 4
device[0xcdbc7f0]: PREFERRED_VECTOR_WIDTH_DOUBLE: 0
device[0xcdbc7f0]: MAX_CLOCK_FREQUENCY: 767
device[0xcdbc7f0]: ADDRESS_BITS: 64
device[0xcdbc7f0]: MAX_MEM_ALLOC_SIZE: 1073741824
device[0xcdbc7f0]: IMAGE_SUPPORT: 1
device[0xcdbc7f0]: MAX_READ_IMAGE_ARGS: 128
device[0xcdbc7f0]: MAX_WRITE_IMAGE_ARGS: 64
device[0xcdbc7f0]: IMAGE2D_MAX_WIDTH: 65536
device[0xcdbc7f0]: IMAGE2D_MAX_HEIGHT: 65536
device[0xcdbc7f0]: IMAGE3D_MAX_WIDTH: 65536
device[0xcdbc7f0]: IMAGE3D_MAX_HEIGHT: 65536
device[0xcdbc7f0]: IMAGE3D_MAX_DEPTH: 65536
device[0xcdbc7f0]: MAX_SAMPLERS: 16
device[0xcdbc7f0]: MAX_PARAMETER_SIZE: 1024
device[0xcdbc7f0]: MEM_BASE_ADDR_ALIGN: 1024
device[0xcdbc7f0]: MIN_DATA_TYPE_ALIGN_SIZE: 128
device[0xcdbc7f0]: GLOBAL_MEM_CACHELINE_SIZE: 64
device[0xcdbc7f0]: GLOBAL_MEM_CACHE_SIZE: 524288
device[0xcdbc7f0]: GLOBAL_MEM_SIZE: 4294967296
device[0xcdbc7f0]: MAX_CONSTANT_BUFFER_SIZE: 65536
device[0xcdbc7f0]: MAX_CONSTANT_ARGS: 8
device[0xcdbc7f0]: LOCAL_MEM_SIZE: 32768
device[0xcdbc7f0]: ERROR_CORRECTION_SUPPORT: 0
device[0xcdbc7f0]: PROFILING_TIMER_RESOLUTION: 1000
device[0xcdbc7f0]: ENDIAN_LITTLE: 1
device[0xcdbc7f0]: AVAILABLE: 1
device[0xcdbc7f0]: COMPILER_AVAILABLE: 1
*******************1th platform******************************
platform[0xffffaa0e7398]: profile: FULL_PROFILE
platform[0xffffaa0e7398]: version: OpenCL 1.2 pocl 1.2 RelWithDebInfo, LLVM 7.0.1, SLEEF, POCL_DEBUG, FP16
platform[0xffffaa0e7398]: name: Portable Computing Language
platform[0xffffaa0e7398]: vendor: The pocl project
platform[0xffffaa0e7398]: extensions: cl_khr_icd
platform[0xffffaa0e7398]: Found 1 device(s).
------------------------0th device------------------------
device[0xcdbcaf0]: NAME: pthread-cortex-a53
device[0xcdbcaf0]: VENDOR: ARM
device[0xcdbcaf0]: PROFILE: FULL_PROFILE
device[0xcdbcaf0]: VERSION: OpenCL 1.2 pocl HSTR: pthread-aarch64--linux-gnueabihf-cortex-a53
device[0xcdbcaf0]: EXTENSIONS: cl_khr_byte_addressable_store cl_khr_global_int32_base_atomics cl_khr_global_int32_extended_atomics cl_khr_local_int32_base_atomics cl_khr_local_int32_extended_atomics cl_khr_3d_image_writes cl_khr_fp16 cl_khr_fp64
device[0xcdbcaf0]: DRIVER_VERSION: 1.2
device[0xcdbcaf0]: Type: CPU
device[0xcdbcaf0]: EXECUTION_CAPABILITIES: Kernel Native
device[0xcdbcaf0]: GLOBAL_MEM_CACHE_TYPE: Read-Write (2)
device[0xcdbcaf0]: CL_DEVICE_LOCAL_MEM_TYPE: Global (2)
device[0xcdbcaf0]: SINGLE_FP_CONFIG: 0x6
device[0xcdbcaf0]: QUEUE_PROPERTIES: 0x2
device[0xcdbcaf0]: VENDOR_ID: 5045
device[0xcdbcaf0]: MAX_COMPUTE_UNITS: 8
device[0xcdbcaf0]: MAX_WORK_ITEM_DIMENSIONS: 3
device[0xcdbcaf0]: MAX_WORK_GROUP_SIZE: 4096
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_CHAR: 16
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_SHORT: 8
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_INT: 4
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_LONG: 2
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_FLOAT: 4
device[0xcdbcaf0]: PREFERRED_VECTOR_WIDTH_DOUBLE: 2
device[0xcdbcaf0]: MAX_CLOCK_FREQUENCY: 1844
device[0xcdbcaf0]: ADDRESS_BITS: 64
device[0xcdbcaf0]: MAX_MEM_ALLOC_SIZE: 2147483648
device[0xcdbcaf0]: IMAGE_SUPPORT: 1
device[0xcdbcaf0]: MAX_READ_IMAGE_ARGS: 128
device[0xcdbcaf0]: MAX_WRITE_IMAGE_ARGS: 128
device[0xcdbcaf0]: IMAGE2D_MAX_WIDTH: 8192
device[0xcdbcaf0]: IMAGE2D_MAX_HEIGHT: 8192
device[0xcdbcaf0]: IMAGE3D_MAX_WIDTH: 2048
device[0xcdbcaf0]: IMAGE3D_MAX_HEIGHT: 2048
device[0xcdbcaf0]: IMAGE3D_MAX_DEPTH: 2048
device[0xcdbcaf0]: MAX_SAMPLERS: 16
device[0xcdbcaf0]: MAX_PARAMETER_SIZE: 1024
device[0xcdbcaf0]: MEM_BASE_ADDR_ALIGN: 1024
device[0xcdbcaf0]: MIN_DATA_TYPE_ALIGN_SIZE: 128
device[0xcdbcaf0]: GLOBAL_MEM_CACHELINE_SIZE: 64
device[0xcdbcaf0]: GLOBAL_MEM_CACHE_SIZE: 1048576
device[0xcdbcaf0]: GLOBAL_MEM_SIZE: 4534318080
device[0xcdbcaf0]: MAX_CONSTANT_BUFFER_SIZE: 524288
device[0xcdbcaf0]: MAX_CONSTANT_ARGS: 8
device[0xcdbcaf0]: LOCAL_MEM_SIZE: 524288
device[0xcdbcaf0]: ERROR_CORRECTION_SUPPORT: 0
device[0xcdbcaf0]: PROFILING_TIMER_RESOLUTION: 1
device[0xcdbcaf0]: ENDIAN_LITTLE: 1
device[0xcdbcaf0]: AVAILABLE: 1
device[0xcdbcaf0]: COMPILER_AVAILABLE: 1
7.Switching from Netplan to NetworkManager make it slightly better. Then you need to update the /etc/network/interface with following content:
auto lo
iface lo inet loopback
auto enp6s0
iface enp6s0 inet static
address 192.168.1.97
netmask 255.255.255.0
gateway 192.168.1.97
And update the /etc/resolv.conf with following content:
nameservers 192.168.1.1
Then do "sudo ifdown enp6s0 && sudo ifup enp6s0". It should bring you the internet through the host as using the Netplan.