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/hikey/96Boards-Hikey-Rev-A1.pdf
14
15 A SoC datasheet can be found here: -
16 https://github.com/96boards/documentation/blob/master/hikey/
17 Hi6220V100_Multi-Mode_Application_Processor_Function_Description.pdf
18
19 Currently the u-boot port supports: -
20 * USB
21 * eMMC
22 * SD card
23 * GPIO
24
25 The HiKey U-Boot port has been tested with l-loader, booting ATF, which then boots
26 U-Boot as the bl33.bin executable.
27
28 Compile from source
29 ===================
30
31 First get all the sources
32
33 > mkdir -p ~/hikey/src ~/hikey/bin
34 > cd ~/hikey/src
35 > git clone https://github.com/96boards/edk2.git
36 > git clone https://github.com/96boards/arm-trusted-firmware.git
37 > git clone https://github.com/96boards/l-loader.git
38 > git clone https://github.com/96boards/burn-boot.git
39
40 Get the BL30 mcuimage.bin binary. It is shipped as part of the UEFI source.
41 The latest version can be obtained from the edk2 repo.
42
43 > cp edk2/HisiPkg/HiKeyPkg/NonFree/mcuimage.bin ~/hikey/bin/
44
45 Get nvme.img binary (check this link is still the latest)
46 > wget -P ~/hikey/bin https://builds.96boards.org/releases/reference-platform/debian/hikey/16.03/bootloader/nvme.img
47
48 Compile U-Boot
49 ==============
50
51 > cd ~/hikey/src/u-boot
52 > make CROSS_COMPILE=aarch64-linux-gnu- hikey_config
53 > make CROSS_COMPILE=aarch64-linux-gnu-
54 > cp u-boot.bin ~/hikey/bin
55
56 Compile ARM Trusted Firmware (ATF)
57 ==================================
58
59 > cd ~/hikey/src/arm-trusted-firmware
60 > make CROSS_COMPILE=aarch64-linux-gnu- all fip \
61 BL30=~/hikey/bin/mcuimage.bin \
62 BL33=~/hikey/bin/u-boot.bin DEBUG=1 PLAT=hikey
63
64 Copy resulting binaries
65 > cp build/hikey/debug/bl1.bin ~/hikey/bin
66 > cp build/hikey/debug/fip.bin ~/hikey/bin
67
68 Compile l-loader
69 ===============
70 > cd ~/hikey/src/l-loader
71 > make BL1=~/hikey/bin/bl1.bin all
72 > cp *.img ~/hikey/bin
73 > cp l-loader.bin ~/hikey/bin
74
75 These instructions are adapted from
76 https://github.com/96boards/documentation/wiki/HiKeyUEFI
77
78 FLASHING
79 ========
80
81 1. Connect the second jumper on J15 BOOT SEL, to go into recovery mode and flash l-loader.bin with
82 the hisi-idt.py utility.
83
84 The command below assumes HiKey enumerated as the first USB serial port
85 > sudo ~/hikey/src/burn-boot/hisi-idt.py -d /dev/ttyUSB0 --img1=~/hikey/bin/l-loader.bin
86
87 2. Once LED 0 comes on solid, HiKey board should be detected as a fastboot device by plugging a USB A to mini B
88 cable from your PC to the USB OTG port of HiKey (on some boards I've found this to be unreliable).
89
90 > sudo fastboot devices
91
92 0123456789ABCDEF fastboot
93
94 3. Flash the images
95
96 > sudo fastboot flash ptable ~/hikey/bin/ptable.img
97 > sudo fastboot flash fastboot ~/hikey/bin/fip.bin
98 > sudo fastboot flash nvme ~/hikey/bin/nvme.img
99
100 4. Disconnect second jumper on J15 BOOT SEL, and reset the board and you will now (hopefully)
101 have ATF, booting u-boot from eMMC. On 'new' boards I've had to do the
102 flashing twice in the past to avoid an ATF error.
103
104 Note: To get USB host working, also disconnect the USB OTG cable used for flashing. Otherwise you
105 will get 'dwc_otg_core_host_init: Timeout!' errors.
106
107 See working boot trace below (by default trace is now output to UART3 not UART0 on latest
108 ATF, U-Boot and Kernel sources): -
109
110 debug EMMC boot: send RST_N .
111 debug EMMC boot: start eMMC boot......
112 load fastboot1!
113
114 Switch to aarch64 mode. CPU0 executes at 0xf9801000!
115
116 INFO: BL1: 0xf9810000 - 0xf9817000 [size = 28672]
117 NOTICE: Booting Trusted Firmware
118 NOTICE: BL1: v1.1(debug):e8b7174
119 NOTICE: BL1: Built : 19:16:44, Sep 8 2015
120 INFO: BL1: RAM 0xf9810000 - 0xf9817000
121 NOTICE: syspll frequency:1190494208Hz
122 NOTICE: succeed to init lpddr3 rank0 dram phy
123 INFO: lpddr3_freq_init, set ddrc 533mhz
124 INFO: init ddr3 rank0
125 INFO: ddr3 rank1 init pass
126 INFO: lpddr3_freq_init, set ddrc 800mhz
127 INFO: init ddr3 rank0
128 INFO: ddr3 rank1 init pass
129 INFO: Elpida DDR
130 INFO: ddr test value:0xa5a55a5a
131 INFO: Hisilicon HiKey platform is initialized
132 INFO: Using FIP
133 INFO: Loading file 'bl2.bin' at address 0xf9818000
134 INFO: File 'bl2.bin' loaded: 0xf9818000 - 0xf9821100
135 NOTICE: BL1: Booting BL2
136 INFO: BL1: BL2 address = 0xf9818000
137 INFO: BL1: BL2 spsr = 0x3c5
138 INFO: [BDID] [fff91c18] midr: 0x410fd033
139 INFO: [BDID] [fff91c1c] board type: 0
140 INFO: [BDID] [fff91c20] board id: 0x2b
141 INFO: init_acpu_dvfs: pmic version 17
142 INFO: init_acpu_dvfs: ACPU_CHIP_MAX_FREQ=0x186a00.
143 INFO: acpu_dvfs_volt_init: success!
144 INFO: acpu_dvfs_set_freq: support freq num is 5
145 INFO: acpu_dvfs_set_freq: start prof is 0x4
146 INFO: acpu_dvfs_set_freq: magic is 0x5a5ac5c5
147 INFO: acpu_dvfs_set_freq: voltage:
148 INFO: - 0: 0x49
149 INFO: - 1: 0x49
150 INFO: - 2: 0x50
151 INFO: - 3: 0x60
152 INFO: - 4: 0x78
153 NOTICE: acpu_dvfs_set_freq: set acpu freq success!NOTICE: BL2: v1.1(debug):e8b7174
154 NOTICE: BL2: Built : 19:16:46, Sep 8 2015
155 INFO: BL2: Loading BL3-0
156 INFO: Using FIP
157 INFO: Loading file 'bl30.bin' at address 0x1000000
158 INFO: Skip reserving memory: 0x1000000 - 0x1023270
159 INFO: File 'bl30.bin' loaded: 0x1000000 - 0x1023270
160 INFO: bl2_plat_handle_bl30: [1000000] 3a334d43 34313032 2f38302f 30203133
161 INFO: bl2_plat_handle_bl30: [10000c8] 0 0 b 0
162 INFO: bl2_plat_handle_bl30: [1000190] 17 0 0 0
163 INFO: bl2_plat_handle_bl30: [1023260] 0 0 0 0
164 INFO: hisi_mcu_load_image: mcu sections 0:
165 INFO: hisi_mcu_load_image: src = 0x1000200
166 INFO: hisi_mcu_load_image: dst = 0xf6000000
167 INFO: hisi_mcu_load_image: size = 512
168 INFO: hisi_mcu_load_image: [SRC 0x1000200] 0x7600 0x201 0x1eae1 0x1ea71
169 INFO: hisi_mcu_load_image: [DST 0xf6000000] 0x7600 0x201 0x1eae1 0x1ea71
170 INFO: hisi_mcu_load_image: mcu sections 1:
171 INFO: hisi_mcu_load_image: src = 0x1000400
172 INFO: hisi_mcu_load_image: dst = 0xf6000200
173 INFO: hisi_mcu_load_image: size = 27828
174 INFO: hisi_mcu_load_image: [SRC 0x1000400] 0xbf00bf00 0x4815b672 0x48154780 0x60014915
175 INFO: hisi_mcu_load_image: [DST 0xf6000200] 0xbf00bf00 0x4815b672 0x48154780 0x60014915
176 INFO: hisi_mcu_load_image: mcu sections 2:
177 INFO: hisi_mcu_load_image: src = 0x10070b4
178 INFO: hisi_mcu_load_image: dst = 0xf6007200
179 INFO: hisi_mcu_load_image: size = 1024
180 INFO: hisi_mcu_load_image: [SRC 0x10070b4] 0x55 0x0 0x0 0x0
181 INFO: hisi_mcu_load_image: [DST 0xf6007200] 0x55 0x0 0x0 0x0
182 INFO: hisi_mcu_load_image: mcu sections 3:
183 INFO: hisi_mcu_load_image: src = 0x10074b4
184 INFO: hisi_mcu_load_image: dst = 0xfff8e000
185 INFO: hisi_mcu_load_image: size = 12704
186 INFO: hisi_mcu_load_image: [SRC 0x10074b4] 0x55 0x0 0x0 0x0
187 INFO: hisi_mcu_load_image: [DST 0xfff8e000] 0x55 0x0 0x0 0x0
188 INFO: hisi_mcu_load_image: mcu sections 4:
189 INFO: hisi_mcu_load_image: src = 0x100a654
190 INFO: hisi_mcu_load_image: dst = 0x5e00000
191 INFO: hisi_mcu_load_image: size = 82912
192 INFO: hisi_mcu_load_image: [SRC 0x100a654] 0x4ff0e92d 0x2cc5f645 0x2600b0ab 0x2c7cf6c0
193 INFO: hisi_mcu_load_image: [DST 0x5e00000] 0x4ff0e92d 0x2cc5f645 0x2600b0ab 0x2c7cf6c0
194 INFO: hisi_mcu_load_image: mcu sections 5:
195 INFO: hisi_mcu_load_image: src = 0x101ea34
196 INFO: hisi_mcu_load_image: dst = 0x5e143e0
197 INFO: hisi_mcu_load_image: size = 12816
198 INFO: hisi_mcu_load_image: [SRC 0x101ea34] 0x33323130 0x37363534 0x42413938 0x46454443
199 INFO: hisi_mcu_load_image: [DST 0x5e143e0] 0x33323130 0x37363534 0x42413938 0x46454443
200 INFO: hisi_mcu_load_image: mcu sections 6:
201 INFO: hisi_mcu_load_image: src = 0x1021c44
202 INFO: hisi_mcu_load_image: dst = 0x5e1c1d0
203 INFO: hisi_mcu_load_image: size = 3060
204 INFO: hisi_mcu_load_image: [SRC 0x1021c44] 0x0 0x0 0x0 0x0
205 INFO: hisi_mcu_load_image: [DST 0x5e1c1d0] 0x0 0x0 0x0 0x0
206 INFO: hisi_mcu_load_image: mcu sections 7:
207 INFO: hisi_mcu_load_image: src = 0x1022838
208 INFO: hisi_mcu_load_image: dst = 0x5e1cdc4
209 INFO: hisi_mcu_load_image: size = 2616
210 INFO: hisi_mcu_load_image: [SRC 0x1022838] 0xf80000a0 0x0 0xf80000ac 0x0
211 INFO: hisi_mcu_load_image: [DST 0x5e1cdc4] 0xf80000a0 0x0 0xf80000ac 0x0
212 INFO: hisi_mcu_start_run: AO_SC_SYS_CTRL2=0
213 INFO: bl2_plat_handle_bl30: mcu pc is 42933301
214 INFO: bl2_plat_handle_bl30: AO_SC_PERIPH_CLKSTAT4 is 39018f09
215 INFO: BL2: TrustZone: protecting 16777216 bytes of memory at 0x3f000000
216 INFO: BL2: Loading BL3-1
217 INFO: Using FIP
218 INFO: Loading file 'bl31.bin' at address 0xf9858000
219 INFO: File 'bl31.bin' loaded: 0xf9858000 - 0xf9861010
220 INFO: BL2: Loading BL3-2
221 INFO: Using FIP
222 WARNING: Failed to access image 'bl32.bin' (-1)
223 WARNING: Failed to load BL3-2 (-1)
224 INFO: BL2: Loading BL3-3
225 INFO: Using FIP
226 INFO: Loading file 'bl33.bin' at address 0x35000000
227 INFO: File 'bl33.bin' loaded: 0x35000000 - 0x3504c468
228 NOTICE: BL1: Booting BL3-1
229 INFO: BL1: BL3-1 address = 0xf9858000
230 INFO: BL1: BL3-1 spsr = 0x3cd
231 INFO: BL1: BL3-1 params address = 0xf9821920
232 INFO: BL1: BL3-1 plat params address = 0x0
233 NOTICE: BL3-1: v1.1(debug):e8b7174
234 NOTICE: BL3-1: Built : 19:16:49, Sep 8 2015
235 INFO: BL3-1: Initializing runtime services
236 INFO: BL3-1: Preparing for EL3 exit to normal world
237 INFO: BL3-1: Next image address = 0x35000000
238 INFO: BL3-1: Next image spsr = 0x3c9
239
240 U-Boot 2015.10-rc2 (Sep 08 2015 - 20:29:33 +0100)hikey
241
242 DRAM: 1008 MiB
243 HI6553 PMIC init
244 MMC: config_sd_carddetect: SD card not present
245 HiKey DWMMC: 0, HiKey DWMMC: 1
246 Card did not respond to voltage select!
247 ** Bad device mmc 1 **
248 Using default environment
249
250 In: serial
251 Out: serial
252 Err: serial
253 Net: Net Initialization Skipped
254 No ethernet found.
255 Hit any key to stop autoboot: 0
256 starting USB...
257 USB0: Core Release: 3.00a
258 scanning bus 0 for devices... 2 USB Device(s) found
259 scanning usb for storage devices... 0 Storage Device(s) found
260 scanning usb for ethernet devices... 0 Ethernet Device(s) found
261