Name
Date
Size
#Lines
LOC

..--

KconfigH A D06-Mar-2018173 1610

MAINTAINERSH A D20-Apr-2016169 76

MakefileH A D06-May-2018138 71

READMEH A D28-Aug-20188.9 KiB228190

build-tf.makH A D14-Oct-20151.1 KiB4337

hikey.cH A D06-May-201810.7 KiB488337

README

1 Introduction
2 ============
3 
4 HiKey is the first certified 96Boards Consumer Edition board. The board/SoC has: -
5 * HiSilicon Kirin 6220 eight-core ARM Cortex-A53 64-bit SoC running at 1.2GHz.
6 * ARM Mali 450-MP4 GPU
7 * 1GB 800MHz LPDDR3 DRAM
8 * 4GB eMMC Flash Storage
9 * microSD
10 * 802.11a/b/g/n WiFi, Bluetooth
11 
12 The HiKey schematic can be found here: -
13 https://github.com/96boards/documentation/blob/master/consumer/hikey/hikey620/hardware-docs/HiKey_schematics_LeMaker_version_Rev_A1.pdf
14 
15 The SoC datasheet can be found here: -
16 https://github.com/96boards/documentation/blob/master/consumer/hikey/hikey620/hardware-docs/Hi6220V100_Multi-Mode_Application_Processor_Function_Description.pdf
17 
18 Currently the u-boot port supports: -
19 * USB
20 * eMMC
21 * SD card
22 * GPIO
23 
24 The HiKey U-Boot port has been tested with l-loader, booting ATF, which then boots
25 U-Boot as the bl33.bin executable.
26 
27 Compile from source
28 ===================
29 
30 First get all the sources
31 
32   > mkdir -p ~/hikey/src ~/hikey/bin
33   > cd ~/hikey/src
34   > git clone https://github.com/96boards-hikey/edk2 -b testing/hikey960_v2.5
35   > git clone https://github.com/ARM-software/arm-trusted-firmware
36   > git clone https://github.com/96boards-hikey/l-loader -b testing/hikey960_v1.2
37   > git clone https://github.com/96boards-hikey/OpenPlatformPkg -b testing/hikey960_v1.3.4
38   > git clone https://github.com/96boards-hikey/atf-fastboot
39   > wget https://snapshots.linaro.org/96boards/reference-platform/components/uefi-staging/latest/hikey/release/hisi-idt.py
40 
41 Get the BL30 mcuimage.bin binary. It is shipped as part of the UEFI source.
42 The latest version can be obtained from the OpenPlatformPkg repo.
43 
44   > cp OpenPlatformPkg/Platforms/Hisilicon/HiKey/Binary/mcuimage.bin ~/hikey/bin/
45 
46 Get nvme.img binary
47   > wget -P ~/hikey/bin https://snapshots.linaro.org/96boards/reference-platform/components/uefi-staging/latest/hikey/release/nvme.img
48 
49 Compile U-Boot
50 ==============
51 
52   > cd ~/hikey/src/u-boot
53   > make CROSS_COMPILE=aarch64-linux-gnu- hikey_config
54   > make CROSS_COMPILE=aarch64-linux-gnu-
55   > cp u-boot.bin ~/hikey/bin
56 
57 Compile ARM Trusted Firmware (ATF)
58 ==================================
59 
60   > cd ~/hikey/src/arm-trusted-firmware
61   > make CROSS_COMPILE=aarch64-linux-gnu- all fip \
62     SCP_BL2=~/hikey/bin/mcuimage.bin \
63     BL33=~/hikey/bin/u-boot.bin DEBUG=1 PLAT=hikey
64 
65 Copy the resulting FIP binary
66   > cp build/hikey/debug/fip.bin ~/hikey/bin
67 
68 Compile ATF Fastboot
69 ====================
70 
71   > cd ~/hikey/src/atf-fastboot
72   > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=hikey DEBUG=1
73 
74 Compile l-loader
75 ================
76   > cd ~/hikey/src/l-loader
77   > ln -sf ~/hikey/src/arm-trusted-firmware/build/hikey/debug/bl1.bin
78   > ln -sf ~/hikey/src/arm-trusted-firmware/build/hikey/debug/bl2.bin
79   > ln -sf ~/hikey/src/atf-fastboot/build/hikey/debug/bl1.bin fastboot.bin
80   > make hikey PTABLE_LST=aosp-8g
81 
82 Copy the resulting binaries
83   > cp *.img ~/hikey/bin
84   > cp l-loader.bin ~/hikey/bin
85   > cp recovery.bin ~/hikey/bin
86 
87 These instructions are adapted from
88 https://github.com/ARM-software/arm-trusted-firmware/blob/master/docs/plat/hikey.rst
89 
90 FLASHING
91 ========
92 
93 1. Connect the second jumper on J15 BOOT SEL, to go into recovery mode and flash l-loader.bin with
94 the hisi-idt.py utility. Then connect a USB A to B mini cable from your PC to the USB OTG port of HiKey and execute the below command.
95 
96 The command below assumes HiKey enumerated as the first USB serial port
97 
98   > sudo python ~/hikey/src/hisi-idt.py -d /dev/ttyUSB0 --img1 ~/hikey/bin/recovery.bin
99 
100 2. Once LED 0 comes on solid, HiKey board should be detected as a fastboot device.
101 
102   > sudo fastboot devices
103 
104 0123456789ABCDEF	fastboot
105 
106 3. Flash the images
107 
108   > sudo fastboot flash ptable ~/hikey/bin/prm_ptable.img
109   > sudo fastboot flash loader ~/hikey/bin/l-loader.bin
110   > sudo fastboot flash fastboot ~/hikey/bin/fip.bin
111   > sudo fastboot flash nvme ~/hikey/bin/nvme.img
112 
113 4. Disconnect second jumper on J15 BOOT SEL, and reset the board and you will now (hopefully)
114    have ATF, booting u-boot from eMMC.
115 
116    Note: To get USB host working, also disconnect the USB OTG cable used for flashing. Otherwise you
117    will get 'dwc_otg_core_host_init: Timeout!' errors.
118 
119 See working boot trace below on UART3 available at Low Speed Expansion header: -
120 
121 NOTICE:  BL2: v1.5(debug):v1.5-694-g6d4f6aea
122 NOTICE:  BL2: Built : 09:21:42, Aug 29 2018
123 INFO:    BL2: Doing platform setup
124 INFO:    ddr3 rank1 init pass
125 INFO:    succeed to set ddrc 150mhz
126 INFO:    ddr3 rank1 init pass
127 INFO:    succeed to set ddrc 266mhz
128 INFO:    ddr3 rank1 init pass
129 INFO:    succeed to set ddrc 400mhz
130 INFO:    ddr3 rank1 init pass
131 INFO:    succeed to set ddrc 533mhz
132 INFO:    ddr3 rank1 init pass
133 INFO:    succeed to set ddrc 800mhz
134 INFO:    Samsung DDR
135 INFO:    ddr test value:0xa5a55a5a
136 INFO:    BL2: TrustZone: protecting 16777216 bytes of memory at 0x3f000000
137 INFO:    BL2: TrustZone: protecting 4194304 bytes of memory at 0x3e800000
138 INFO:    [BDID] [fff91c18] midr: 0x410fd033
139 INFO:    init_acpu_dvfs: pmic version 17
140 INFO:    init_acpu_dvfs: ACPU_CHIP_MAX_FREQ=0x186a00.
141 INFO:    acpu_dvfs_volt_init: success!
142 INFO:    acpu_dvfs_set_freq: support freq num is 5
143 INFO:    acpu_dvfs_set_freq: start prof is 0x4
144 INFO:    acpu_dvfs_set_freq: magic is 0x5a5ac5c5
145 INFO:    acpu_dvfs_set_freq: voltage:
146 INFO:      - 0: 0x49
147 INFO:      - 1: 0x49
148 INFO:      - 2: 0x50
149 INFO:      - 3: 0x60
150 INFO:      - 4: 0x78
151 NOTICE:  acpu_dvfs_set_freq: set acpu freq success!INFO:    BL2: Loading image id 2
152 INFO:    Loading image id=2 at address 0x1000000
153 INFO:    Image id=2 loaded: 0x1000000 - 0x1023d00
154 INFO:    hisi_mcu_load_image: mcu sections 0:
155 INFO:    hisi_mcu_load_image:  src  = 0x1000200
156 INFO:    hisi_mcu_load_image:  dst  = 0xf6000000
157 INFO:    hisi_mcu_load_image:  size = 31184
158 INFO:    hisi_mcu_load_image:  [SRC 0x1000200] 0x8000 0x3701 0x7695 0x7689
159 INFO:    hisi_mcu_load_image:  [DST 0xf6000000] 0x8000 0x3701 0x7695 0x7689
160 INFO:    hisi_mcu_load_image: mcu sections 1:
161 INFO:    hisi_mcu_load_image:  src  = 0x1007bd0
162 INFO:    hisi_mcu_load_image:  dst  = 0x5e00000
163 INFO:    hisi_mcu_load_image:  size = 93828
164 INFO:    hisi_mcu_load_image:  [SRC 0x1007bd0] 0xf000b510 0x2103fb3d 0xf0004604 0xf003fb57
165 INFO:    hisi_mcu_load_image:  [DST 0x5e00000] 0xf000b510 0x2103fb3d 0xf0004604 0xf003fb57
166 INFO:    hisi_mcu_load_image: mcu sections 2:
167 INFO:    hisi_mcu_load_image:  src  = 0x101ea54
168 INFO:    hisi_mcu_load_image:  dst  = 0x5e16e84
169 INFO:    hisi_mcu_load_image:  size = 15428
170 INFO:    hisi_mcu_load_image:  [SRC 0x101ea54] 0x9 0x1020640 0x10001 0x8f0d180
171 INFO:    hisi_mcu_load_image:  [DST 0x5e16e84] 0x9 0x1020640 0x10001 0x8f0d180
172 INFO:    hisi_mcu_load_image: mcu sections 3:
173 INFO:    hisi_mcu_load_image:  src  = 0x1022698
174 INFO:    hisi_mcu_load_image:  dst  = 0x5e22a10
175 INFO:    hisi_mcu_load_image:  size = 3060
176 INFO:    hisi_mcu_load_image:  [SRC 0x1022698] 0x0 0x0 0x0 0x0
177 INFO:    hisi_mcu_load_image:  [DST 0x5e22a10] 0x0 0x0 0x0 0x0
178 INFO:    hisi_mcu_load_image: mcu sections 4:
179 INFO:    hisi_mcu_load_image:  src  = 0x102328c
180 INFO:    hisi_mcu_load_image:  dst  = 0x5e23604
181 INFO:    hisi_mcu_load_image:  size = 2616
182 INFO:    hisi_mcu_load_image:  [SRC 0x102328c] 0xf80000a0 0x0 0xf80000ac 0x0
183 INFO:    hisi_mcu_load_image:  [DST 0x5e23604] 0xf80000a0 0x0 0xf80000ac 0x0
184 INFO:    hisi_mcu_start_run: AO_SC_SYS_CTRL2=0
185 INFO:    plat_hikey_bl2_handle_scp_bl2: MCU PC is at 0x42933301
186 INFO:    plat_hikey_bl2_handle_scp_bl2: AO_SC_PERIPH_CLKSTAT4 is 0x3b018f09
187 WARNING: BL2: Platform setup already done!!
188 INFO:    BL2: Loading image id 3
189 INFO:    Loading image id=3 at address 0xf9858000
190 INFO:    Image id=3 loaded: 0xf9858000 - 0xf9860058
191 INFO:    BL2: Loading image id 5
192 INFO:    Loading image id=5 at address 0x35000000
193 INFO:    Image id=5 loaded: 0x35000000 - 0x35061cd2
194 NOTICE:  BL2: Booting BL31
195 INFO:    Entry point address = 0xf9858000
196 INFO:    SPSR = 0x3cd
197 NOTICE:  BL31: v1.5(debug):v1.5-694-g6d4f6aea
198 NOTICE:  BL31: Built : 09:21:44, Aug 29 2018
199 WARNING: Using deprecated integer interrupt array in gicv2_driver_data_t
200 WARNING: Please migrate to using an interrupt_prop_t array
201 INFO:    ARM GICv2 driver initialized
202 INFO:    BL31: Initializing runtime services
203 INFO:    BL31: cortex_a53: CPU workaround for disable_non_temporal_hint was applied
204 INFO:    BL31: cortex_a53: CPU workaround for 843419 was applied
205 INFO:    BL31: cortex_a53: CPU workaround for 855873 was applied
206 INFO:    BL31: Preparing for EL3 exit to normal world
207 INFO:    Entry point address = 0x35000000
208 INFO:    SPSR = 0x3c9
209 
210 
211 U-Boot 2018.09-rc1 (Aug 22 2018 - 14:55:49 +0530)hikey
212 
213 DRAM:  990 MiB
214 HI6553 PMIC init
215 MMC:   config_sd_carddetect: SD card present
216 Hisilicon DWMMC: 0, Hisilicon DWMMC: 1
217 Loading Environment from FAT... Unable to use mmc 1:1... Failed (-5)
218 In:    uart@f7113000
219 Out:   uart@f7113000
220 Err:   uart@f7113000
221 Net:   Net Initialization Skipped
222 No ethernet found.
223 Hit any key to stop autoboot:  0
224 starting USB...
225 USB0:   scanning bus 0 for devices... 2 USB Device(s) found
226        scanning usb for storage devices... 0 Storage Device(s) found
227        scanning usb for ethernet devices... 0 Ethernet Device(s) found
228