Tools and images for HiKey960
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build-from-source
ds5-jtag-scripts
trace32-jtag-scripts
LICENSE-hikey_idt
README-flash-uefi.md
README-technical.md
README.md
config
hikey_idt
hisi-bl31.bin
hisi-fastboot.img
hisi-lpm3.img
hisi-nvme.img
hisi-ptable.img
hisi-sec_fastboot.img
hisi-sec_uce_boot.img
hisi-sec_usb_xloader.img
hisi-sec_xloader.img
recovery-flash-uefi-prebuilt.sh
recovery-flash.sh

README.md

Base Firmware files and installation

This sections shows how to install all base firmware components for the HiKey960. Once finished with these instructions, please continue to the HiKey960 documentation landing page to flash an operating system.


  • Step 1: Material and Preperations
  • Step 2: Dependencies
  • Step 3: Enter recovery/forced-download mode on HiKey960
  • Step 4: Flash Base Firmware
  • Step 5: Explore other modes, proceed to OS installation
  • Troubleshooting

Step 1: Materials and Preperations

Materials

Preperations

There are two versions of HiKey960: v1 and v2. One important difference you should know is: v1 is using Jumper (J2001), while v2 is using DIP switch (SW2201). Both are located in the bottom side of board.

There are two versions of HiKey960
v1 uses Jumpers (J2001)
v2 uses DIP Switches (SW2201)

**Both version of switches are located on the bottom of the board.

Jumper / DIP Switch comparison
Jumper Pin 1-2 = DIP switch 1
Jumper Pin 3-4 = DIP switch 2
Jumper Pin 5-6 = DIP switch 3
  • To boot into fastboot mode everytime set switch 1 & 3 to ON state and switch 2 to OFF state.
  • To boot into fastboot mode at every alternate rebooot set switch 1 to ON and switch 2 & 3 to OFF state.
  • To boot into recovery mode set switch 1 & 2 to ON state and switch 3 to OFF state

Step 2: Dependencies

Host Linux Machine

  • Remove modemmanager. At least in Ubuntu 14.04 and 16.04 verions, we found a conflicting issue if modemmanager is installed and active. Modemmanager monitors ttyUSBx's incoming data, when it reads some given pattern, it will send some bytes back into the tty as response. And those bytes sent by modemmanager can make board side recovery flashing tool confuse and fail. Solution is to uninstall this service. If you have a doubt whether you are safe to remove it or not, double confirm here: ModemManager homepage.
$ sudo dpkg -s modemmanager
$ sudo apt-get remove modemmanager
  • Android SDK “Platform-Tools” for Linux can be downloaded here
  • Use terminal to clone this repository into desired folder and cd into tools-images-hikey960
$ git clone https://github.com/96boards-hikey/tools-images-hikey960
$ cd tools-images-hikey960

Step 3: Enter recovery/forced-download mode on HiKey960:

  • Remove power from the board
  • Change Jumper/DIP switch settings, to enter recovery/forced-download mode:
Name Link / Switch State
Auto Power up Link 1-2 / Switch 1 closed / ON
Recovery Link 3-4 / Switch 2 closed / ON
Fastboot Link 5-6 / Switch 3 open / OFF
  • Apply power to the board using 96Boards compliant power supply
  • Insert USB Type-C cable (OTG port) to the board, and connect the other end to your Linux PC
  • Check whether there is a device node "/dev/ttyUSBx". If there is, it means your PC has detected the target board; If there is not, try to repeat previous steps.

Step 4: Flash base firmware

Once again using the terminal on your host machine, execute the following command. Be sure to replace /dev/ttyUSBx with the USB value detected by your machine.

$ sudo ./recovery-flash.sh /dev/ttyUSBx

After it completes, the base firmware will be flashed to the device, this does not mean OS.

The board will then be in fastboot mode.

Step 5: Explore other modes, proceed to OS installation

Name Link / Switch Normal Mode Fastboot Mode Recovery Mode
Auto Power up Link 1-2 / Switch 1 closed / ON closed / ON closed / ON
Recovery Link 3-4 / Switch 2 open / OFF open / OFF closed / ON
Fastboot Link 5-6 / Switch 3 open / OFF closed / ON open / OFF

Troubleshooting

  • If recovery script "./recovery-flash.sh /dev/ttyUSBx" fail to run to completion and you see "< waiting for any device >" in a loop, then try uninstalling modemmanager from your host machine. The script will work after that. Don't forget to install modemmanager back after recovery.
  • If you run into trouble, see the README-technical.md file in this directory.