system/arm/aspeed.rst

1 …ast2500-evb``, ``ast2600-evb``, ``ast2700-evb``, ``ast2700fc``, ``bletchley-bmc``, ``fuji-bmc``, `…
6 Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the
7 AST2500 with an ARM1176JZS CPU (800MHz), the AST2600
8 with dual cores ARM Cortex-A7 CPUs (1.2GHz) and more recently the AST2700
9 with quad cores ARM Cortex-A35 64 bits CPUs (1.6GHz)
11 The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
16 - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
17 - ``quanta-q71l-bmc``      OpenBMC Quanta BMC
18 - ``supermicrox11-bmc``    Supermicro X11 BMC (ARM926EJ-S)
19 - ``supermicrox11spi-bmc``    Supermicro X11 SPI BMC (ARM1176)
21 AST2500 SoC based machines :
23 - ``ast2500-evb``          Aspeed AST2500 Evaluation board
24 - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
25 - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
26 - ``sonorapass-bmc``       OCP SonoraPass BMC
27 - ``fp5280g2-bmc``         Inspur FP5280G2 BMC
28 - ``g220a-bmc``            Bytedance G220A BMC
29 - ``yosemitev2-bmc``       Facebook YosemiteV2 BMC
30 - ``tiogapass-bmc``        Facebook Tiogapass BMC
34 - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex-A7)
35 - ``rainier-bmc``          IBM Rainier POWER10 BMC
36 - ``fuji-bmc``             Facebook Fuji BMC
37 - ``bletchley-bmc``        Facebook Bletchley BMC
38 - ``fby35-bmc``            Facebook fby35 BMC
39 - ``qcom-dc-scm-v1-bmc``   Qualcomm DC-SCM V1 BMC
40 - ``qcom-firework-bmc``    Qualcomm Firework BMC
44 - ``ast2700-evb``          Aspeed AST2700 Evaluation board (Cortex-A35)
45 - ``ast2700fc``            Aspeed AST2700 Evaluation board (Cortex-A35 + Cortex-M4)
48 -----------------
50  * SMP (for the AST2600 Cortex-A7)
54  * I2C Controller, including the new register interface of the AST2600
57  * X-DMA Controller (basic interface)
58  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
67  * Front LEDs (PCA9552 on I2C bus)
69  * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA
79 ---------------
85  * PCI-Express 1 Controller
93 ------------
95 The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
99    https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
107    https://github.com/AspeedTech-BMC/openbmc/releases
114 .. code-block:: bash
116   $ qemu-system-arm -M ast2600-evb -nographic \
117         -kernel arch/arm/boot/zImage \
118         -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
119         -initrd rootfs.cpio
126  * ``execute-in-place`` which emulates the boot from the CE0 flash
130  * ``fmc-model`` to change the default FMC Flash model. FW needs
133  * ``spi-model`` to change the default SPI Flash model.
137 .. code-block:: bash
139   $ qemu-system-arm -M romulus-bmc -nic user \
140 	-drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic
143 bigger (64M) SPI for the ``ast2500-evb`` machine, run :
145 .. code-block:: bash
147   -M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f
151 ``-nodefaults`` QEMU option can be used to avoid creating the default
157 .. code-block:: bash
159   $ qemu-system-arm -M ast2600-evb \
160         -blockdev node-name=fmc0,driver=file,filename=/path/to/fmc0.img \
161 	-device mx66u51235f,bus=ssi.0,cs=0x0,drive=fmc0 \
162 	-blockdev node-name=fmc1,driver=file,filename=/path/to/fmc1.img \
163 	-device mx66u51235f,bus=ssi.0,cs=0x1,drive=fmc1 \
164 	-blockdev node-name=spi1,driver=file,filename=/path/to/spi1.img \
165 	-device mx66u51235f,cs=0x0,bus=ssi.1,drive=spi1 \
166 	-nographic -nodefaults
170 machine option ``execute-in-place`` has a similar effect.
178  * ``boot-emmc`` to set or unset boot from eMMC (AST2600).
180 Only the ``ast2600-evb`` and ``rainier-emmc`` machines have support to
185 .. code-block:: bash
187    $ dd if=/dev/zero of=mmc-bootarea.img count=2 bs=1M
188    $ dd if=u-boot-spl.bin of=mmc-bootarea.img conv=notrunc
189    $ dd if=u-boot.bin of=mmc-bootarea.img conv=notrunc count=64 bs=1K
190    $ cat mmc-bootarea.img obmc-phosphor-image.wic > mmc.img
191    $ truncate --size 16GB mmc.img
193 Boot the machine ``rainier-emmc`` with :
195 .. code-block:: bash
197    $ qemu-system-arm -M rainier-bmc \
198          -drive file=mmc.img,format=raw,if=sd,index=2 \
199          -nographic
201 The ``boot-emmc`` option can be set or unset, to change the default
203 ``ast2600-evb`` machine from an eMMC device (default being SPI) or to
204 boot the ``rainier-bmc`` machine from a flash device (default being
207 As an example, here is how to to boot the ``rainier-bmc`` machine from
208 the flash device with ``boot-emmc=false`` and let the machine use an
211 .. code-block:: bash
213    $ qemu-system-arm -M rainier-bmc,boot-emmc=false \
214         -drive file=flash.img,format=raw,if=mtd \
215         -drive file=mmc.img,format=raw,if=sd,index=2 \
216         -nographic
220 machine.  This limitation is due to the use of the ``-drive``
226 .. code-block:: bash
228    -blockdev node-name=emmc0,driver=file,filename=mmc.img \
229    -device emmc,bus=sdhci-bus.2,drive=emmc0,boot-partition-size=1048576,boot-config=8
231 This is not yet supported (as of QEMU-10.0). Work is needed to
232 refactor the sdhci bus model.
239  * ``bmc-console`` to change the default console device. Most of the
247 .. code-block:: bash
249   -M ast2500-evb,bmc-console=uart3
251 Booting the ast2700-evb machine
258 Manual boot using ``-device loader``:
263 .. code-block:: bash
265   IMGDIR=ast2700-default
266   UBOOT_SIZE=$(stat --format=%s -L ${IMGDIR}/u-boot-nodtb.bin)
268   $ qemu-system-aarch64 -M ast2700-evb \
269        -device loader,force-raw=on,addr=0x400000000,file=${IMGDIR}/u-boot-nodtb.bin \
270        -device loader,force-raw=on,addr=$((0x400000000 + ${UBOOT_SIZE})),file=${IMGDIR}/u-boot.dtb \
271        -device loader,force-raw=on,addr=0x430000000,file=${IMGDIR}/bl31.bin \
272        -device loader,force-raw=on,addr=0x430080000,file=${IMGDIR}/optee/tee-raw.bin \
273        -device loader,cpu-num=0,addr=0x430000000 \
274        -device loader,cpu-num=1,addr=0x430000000 \
275        -device loader,cpu-num=2,addr=0x430000000 \
276        -device loader,cpu-num=3,addr=0x430000000 \
277        -smp 4 \
278        -drive file=${IMGDIR}/image-bmc,format=raw,if=mtd \
279        -nographic
281 Boot using a virtual boot ROM (``-bios``):
283 If users do not specify the ``-bios option``, QEMU will attempt to load the
285 directory or the ``pc-bios`` directory within the QEMU source tree.
287 .. code-block:: bash
289   $ qemu-system-aarch64 -M ast2700-evb \
290       -drive file=image-bmc,format=raw,if=mtd \
291       -nographic
293 The ``-bios`` option allows users to specify a custom path for the vbootrom
297 .. code-block:: bash
299   -bios ${HOME}/ast27x0_bootrom.bin
304 AST2700 features four Cortex-A35 primary processors and two Cortex-M4 coprocessors.
305 **ast2700-evb** machine focuses on emulating the four Cortex-A35 primary processors,
306 **ast2700fc** machine extends **ast2700-evb** by adding support for the two Cortex-M4 coprocessors.
308 To boot the AST2700 full-core machine, follow these steps:
310   1. Configure an MTD drive for the four Cortex-A35 primary processors.
313    - SSP (Secondary Service Processor) firmware on CPU 5 (``cpu-num=4``).
314    - TSP (Tertiary Service Processor) firmware on CPU 6 (``cpu-num=5``).
316 .. code-block:: bash
318   IMGDIR=ast2700-default
319   UBOOT_SIZE=$(stat --format=%s -L ${IMGDIR}/u-boot-nodtb.bin)
321   $ qemu-system-aarch64 -M ast2700fc \
322        -device loader,force-raw=on,addr=0x400000000,file=${IMGDIR}/u-boot-nodtb.bin \
323        -device loader,force-raw=on,addr=$((0x400000000 + ${UBOOT_SIZE})),file=${IMGDIR}/u-boot.dtb \
324        -device loader,force-raw=on,addr=0x430000000,file=${IMGDIR}/bl31.bin \
325        -device loader,force-raw=on,addr=0x430080000,file=${IMGDIR}/tee-raw.bin \
326        -device loader,cpu-num=0,addr=0x430000000 \
327        -device loader,cpu-num=1,addr=0x430000000 \
328        -device loader,cpu-num=2,addr=0x430000000 \
329        -device loader,cpu-num=3,addr=0x430000000 \
330        -drive file=${IMGDIR}/image-bmc,if=mtd,format=raw \
331        -device loader,file=${IMGDIR}/ast2700-ssp.elf,cpu-num=4 \
332        -device loader,file=${IMGDIR}/ast2700-tsp.elf,cpu-num=5 \
333        -serial pty -serial pty -serial pty \
334        -snapshot \
335        -S -nographic
339 .. code-block:: bash
347 … the console for the four Cortex-A35 primary processors, ``serial1`` and ``serial2`` are the conso…
350 .. code-block:: bash
357 Aspeed minibmc family boards (``ast1030-evb``)
364 The SoC comes with SRAM, SPI, I2C, etc.
368 - ``ast1030-evb``          Aspeed AST1030 Evaluation board (Cortex-M4F)
371 -----------------
373  * SMP (for the AST1030 Cortex-M4F)
376  * I2C Controller
379  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
386  * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA
393 ---------------
403 ------------
405 The Aspeed machines can be started using the ``-kernel`` to load a
409    https://github.com/AspeedTech-BMC/zephyr/releases
413 .. code-block:: bash
415   $ qemu-system-arm -M ast1030-evb -nographic \
416         -kernel zephyr.elf