1.. SPDX-License-Identifier: GPL-2.0+
2
3Introduction
4============
5
6DeveloperBox is a certified 96boards Enterprise Edition board. The board/SoC has: -
7
8* Socionext SC2A11 24-cores ARM Cortex-A53 on tbe Mini-ATX form factor motherboard
9* 4 DIMM slots (4GB DDR4-2400 UDIMM shipped by default)
10* 1 4xPCIe Gen2 slot and 2 1xPCIe Gen2 slots
11  (1x slots are connected via PCIe bridge chip)
12* 4 USB-3.0 ports
13* 2 SATA ports
14* 1 GbE network port
15* 1 USB-UART serial port (micro USB)
16* 64MB SPI NOR Flash
17* 8GB eMMC Flash Storage
18* 96boards LS connector
19
20The DeveloperBox schematic can be found here: -
21https://www.96boards.org/documentation/enterprise/developerbox/hardware-docs/mzsc2am_v03_20180115_a.pdf
22
23And the other documents can be found here: -
24https://www.96boards.org/documentation/enterprise/developerbox/
25
26
27Currently, the U-Boot port supports: -
28
29* USB
30* eMMC
31* SPI-NOR
32* SATA
33* GbE
34
35The DeveloperBox boots the TF-A and EDK2 as a main bootloader by default.
36The DeveloperBox U-Boot port will replace the EDK2 and boot from TF-A as
37BL33, but no need to combine with it.
38
39Compile from source
40===================
41
42You can build U-Boot without any additinal source code.::
43
44  cd u-boot
45  export ARCH=arm64
46  export CROSS_COMPILE=aarch64-linux-gnu-
47  make SynQuacer_defconfig
48  make -j `noproc`
49
50Then, expand the binary to 1MB for preparing flash.::
51
52  cp u-boot.bin SPI_NOR_UBOOT.fd
53  truncate -s 1M SPI_NOR_UBOOT.fd
54
55Installation
56============
57
58You can install the SNI_NOR_UBOOT.fd via NOR flash writer.
59
60Flashing the U-Boot image on DeveloperBox requires a 96boards UART mezzanine or other mezzanine which can connect to LS-UART0 port.
61Connect USB cable from host to the LS-UART0 and set DSW2-7 to ON, and turn the board on again. The flash writer program will be started automatically; don’t forget to turn the DSW2-7 off again after flashing.
62
63*!!CAUTION!! If you failed to write the U-Boot image on wrong address, the board can be bricked. See below page if you need to recover the bricked board. See the following page for more detail*
64
65https://www.96boards.org/documentation/enterprise/developerbox/installation/board-recovery.md.html
66
67When the serial flasher is running correctly is will show the following boot messages shown via LS-UART0::
68
69
70  /*------------------------------------------*/
71  /*  SC2A11 "SynQuacer" series Flash writer  */
72  /*                                          */
73  /*  Version: cd254ac                        */
74  /*  Build: 12/15/17 11:25:45                */
75  /*------------------------------------------*/
76
77  Command Input >
78
79Once the flasher tool is running we are ready flash the UEFI image::
80
81  flash rawwrite 200000 100000
82  >> Send SPI_NOR_UBOOT.fd via XMODEM (Control-A S in minicom) <<
83
84*!!NOTE!! The flasher command parameter is different from the command for board recovery. U-Boot uses the offset 200000 (2-five-0, 2M in hex) and the size 100000 (1-five-0, 1M in hex).*
85
86After transferring the SPI_NOR_UBOOT.fd, turn off the DSW2-7 and reset the board.
87
88