system/arm/aspeed.rst

1 …-evb``, ``ast2600-evb``, ``ast2700-evb``, ``bletchley-bmc``, ``fuji-bmc``, ``fby35-bmc``, ``fp5280…
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).
15 - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
16 - ``quanta-q71l-bmc``      OpenBMC Quanta BMC
17 - ``supermicrox11-bmc``    Supermicro X11 BMC (ARM926EJ-S)
18 - ``supermicrox11spi-bmc``    Supermicro X11 SPI BMC (ARM1176)
22 - ``ast2500-evb``          Aspeed AST2500 Evaluation board
23 - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
24 - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
25 - ``sonorapass-bmc``       OCP SonoraPass BMC
26 - ``fp5280g2-bmc``         Inspur FP5280G2 BMC
27 - ``g220a-bmc``            Bytedance G220A BMC
28 - ``yosemitev2-bmc``       Facebook YosemiteV2 BMC
29 - ``tiogapass-bmc``        Facebook Tiogapass BMC
33 - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex-A7)
34 - ``rainier-bmc``          IBM Rainier POWER10 BMC
35 - ``fuji-bmc``             Facebook Fuji BMC
36 - ``bletchley-bmc``        Facebook Bletchley BMC
37 - ``fby35-bmc``            Facebook fby35 BMC
38 - ``qcom-dc-scm-v1-bmc``   Qualcomm DC-SCM V1 BMC
39 - ``qcom-firework-bmc``    Qualcomm Firework BMC
42 -----------------
44  * SMP (for the AST2600 Cortex-A7)
45  * Interrupt Controller (VIC)
46  * Timer Controller
47  * RTC Controller
48  * I2C Controller, including the new register interface of the AST2600
51  * X-DMA Controller (basic interface)
52  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
53  * SPI Memory Controller
54  * USB 2.0 Controller
56  * SDRAM controller (dummy interface for basic settings and training)
57  * Watchdog Controller
58  * GPIO Controller (Master only)
62  * LPC Peripheral Controller (a subset of subdevices are supported)
63  * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA
65  * Secure Boot Controller (AST2600)
66  * eMMC Boot Controller (dummy)
67  * PECI Controller (minimal)
68  * I3C Controller
69  * Internal Bridge Controller (SLI dummy)
73 ---------------
76  * PWM and Fan Controller
77  * Slave GPIO Controller
78  * Super I/O Controller
79  * PCI-Express 1 Controller
80  * Graphic Display Controller
81  * MCTP Controller
82  * Mailbox Controller
84  * eSPI Controller
87 ------------
89 The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
93    https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
101    https://github.com/AspeedTech-BMC/openbmc/releases
108 .. code-block:: bash
110   $ qemu-system-arm -M ast2600-evb -nographic \
111         -kernel arch/arm/boot/zImage \
112         -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
113         -initrd rootfs.cpio
120  * ``execute-in-place`` which emulates the boot from the CE0 flash
121    device by using the FMC controller to load the instructions, and
124  * ``fmc-model`` to change the default FMC Flash model. FW needs
127  * ``spi-model`` to change the default SPI Flash model.
131 .. code-block:: bash
133   $ qemu-system-arm -M romulus-bmc -nic user \
134 	-drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic
137 bigger (64M) SPI for the ``ast2500-evb`` machine, run :
139 .. code-block:: bash
141   -M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f
145 ``-nodefaults`` QEMU option can be used to avoid creating the default
151 .. code-block:: bash
153   $ qemu-system-arm -M ast2600-evb \
154         -blockdev node-name=fmc0,driver=file,filename=/path/to/fmc0.img \
155 	-device mx66u51235f,bus=ssi.0,cs=0x0,drive=fmc0 \
156 	-blockdev node-name=fmc1,driver=file,filename=/path/to/fmc1.img \
157 	-device mx66u51235f,bus=ssi.0,cs=0x1,drive=fmc1 \
158 	-blockdev node-name=spi1,driver=file,filename=/path/to/spi1.img \
159 	-device mx66u51235f,cs=0x0,bus=ssi.1,drive=spi1 \
160 	-nographic -nodefaults
164 machine option ``execute-in-place`` has a similar effect.
172  * ``boot-emmc`` to set or unset boot from eMMC (AST2600).
174 Only the ``ast2600-evb`` and ``rainier-emmc`` machines have support to
179 .. code-block:: bash
181    $ dd if=/dev/zero of=mmc-bootarea.img count=2 bs=1M
182    $ dd if=u-boot-spl.bin of=mmc-bootarea.img conv=notrunc
183    $ dd if=u-boot.bin of=mmc-bootarea.img conv=notrunc count=64 bs=1K
184    $ cat mmc-bootarea.img obmc-phosphor-image.wic > mmc.img
185    $ truncate --size 16GB mmc.img
187 Boot the machine ``rainier-emmc`` with :
189 .. code-block:: bash
191    $ qemu-system-arm -M rainier-bmc \
192          -drive file=mmc.img,format=raw,if=sd,index=2 \
193          -nographic
195 The ``boot-emmc`` option can be set or unset, to change the default
197 ``ast2600-evb`` machine from an eMMC device (default being SPI) or to
198 boot the ``rainier-bmc`` machine from a flash device (default being
201 As an example, here is how to to boot the ``rainier-bmc`` machine from
202 the flash device with ``boot-emmc=false`` and let the machine use an
205 .. code-block:: bash
207    $ qemu-system-arm -M rainier-bmc,boot-emmc=false \
208         -drive file=flash.img,format=raw,if=mtd \
209         -drive file=mmc.img,format=raw,if=sd,index=2 \
210         -nographic
214 machine.  This limitation is due to the use of the ``-drive``
220 .. code-block:: bash
222    -blockdev node-name=emmc0,driver=file,filename=mmc.img \
223    -device emmc,bus=sdhci-bus.2,drive=emmc0,boot-partition-size=1048576,boot-config=8
225 This is not yet supported (as of QEMU-10.0). Work is needed to
233  * ``bmc-console`` to change the default console device. Most of the
241 .. code-block:: bash
243   -M ast2500-evb,bmc-console=uart3
245 Aspeed 2700 family boards (``ast2700-evb``)
250 the AST2700 with quad cores ARM Cortex-A35 64 bits CPUs (1.6GHz).
257 - ``ast2700-evb``          Aspeed AST2700 Evaluation board (Cortex-A35)
258 - ``ast2700fc``            Aspeed AST2700 Evaluation board (Cortex-A35 + Cortex-M4)
261 -----------------
262  * Interrupt Controller
263  * Timer Controller
264  * RTC Controller
265  * I2C Controller
268  * X-DMA Controller (basic interface)
269  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
270  * SPI Memory Controller
271  * USB 2.0 Controller
273  * SDRAM controller (dummy interface for basic settings and training)
274  * Watchdog Controller
275  * GPIO Controller (Master only)
279  * LPC Peripheral Controller (a subset of subdevices are supported)
280  * Hash/Crypto Engine (HACE) - Hash support only. TODO: Crypto
282  * eMMC Boot Controller (dummy)
283  * PECI Controller (minimal)
284  * I3C Controller
285  * Internal Bridge Controller (SLI dummy)
288 ---------------
289  * PWM and Fan Controller
290  * Slave GPIO Controller
291  * Super I/O Controller
292  * PCI-Express 1 Controller
293  * Graphic Display Controller
294  * MCTP Controller
295  * Mailbox Controller
297  * eSPI Controller
300 ------------
304    https://github.com/AspeedTech-BMC/openbmc/releases
306 Booting the ast2700-evb machine
313 Manual boot using ``-device loader``:
315 It causes all 4 CPU cores to start execution from address ``0x430000000``, which
318 .. code-block:: bash
320   IMGDIR=ast2700-default
321   UBOOT_SIZE=$(stat --format=%s -L ${IMGDIR}/u-boot-nodtb.bin)
323   $ qemu-system-aarch64 -M ast2700-evb \
324        -device loader,force-raw=on,addr=0x400000000,file=${IMGDIR}/u-boot-nodtb.bin \
325        -device loader,force-raw=on,addr=$((0x400000000 + ${UBOOT_SIZE})),file=${IMGDIR}/u-boot.dtb \
326        -device loader,force-raw=on,addr=0x430000000,file=${IMGDIR}/bl31.bin \
327        -device loader,force-raw=on,addr=0x430080000,file=${IMGDIR}/optee/tee-raw.bin \
328        -device loader,cpu-num=0,addr=0x430000000 \
329        -device loader,cpu-num=1,addr=0x430000000 \
330        -device loader,cpu-num=2,addr=0x430000000 \
331        -device loader,cpu-num=3,addr=0x430000000 \
332        -smp 4 \
333        -drive file=${IMGDIR}/image-bmc,format=raw,if=mtd \
334        -nographic
336 Boot using a virtual boot ROM (``-bios``):
338 If users do not specify the ``-bios option``, QEMU will attempt to load the
340 directory or the ``pc-bios`` directory within the QEMU source tree.
342 .. code-block:: bash
344   $ qemu-system-aarch64 -M ast2700-evb \
345       -drive file=image-bmc,format=raw,if=mtd \
346       -nographic
348 The ``-bios`` option allows users to specify a custom path for the vbootrom
352 .. code-block:: bash
354   -bios ${HOME}/ast27x0_bootrom.bin
359 AST2700 features four Cortex-A35 primary processors and two Cortex-M4 coprocessors.
360 **ast2700-evb** machine focuses on emulating the four Cortex-A35 primary processors,
361 **ast2700fc** machine extends **ast2700-evb** by adding support for the two Cortex-M4 coprocessors.
367  * u-boot-nodtb.bin
368  * u-boot.dtb
370  * optee/tee-raw.bin
371  * image-bmc
372  * zephyr-aspeed-ssp.elf (for SSP firmware, CPU 5)
373  * zephyr-aspeed-tsp.elf (for TSP firmware, CPU 6)
377 .. code-block:: bash
379   IMGDIR=ast2700-default
380   UBOOT_SIZE=$(stat --format=%s -L ${IMGDIR}/u-boot-nodtb.bin)
382   $ qemu-system-aarch64 -M ast2700fc \
383        -device loader,force-raw=on,addr=0x400000000,file=${IMGDIR}/u-boot-nodtb.bin \
384        -device loader,force-raw=on,addr=$((0x400000000 + ${UBOOT_SIZE})),file=${IMGDIR}/u-boot.dtb \
385        -device loader,force-raw=on,addr=0x430000000,file=${IMGDIR}/bl31.bin \
386        -device loader,force-raw=on,addr=0x430080000,file=${IMGDIR}/optee/tee-raw.bin \
387        -device loader,cpu-num=0,addr=0x430000000 \
388        -device loader,cpu-num=1,addr=0x430000000 \
389        -device loader,cpu-num=2,addr=0x430000000 \
390        -device loader,cpu-num=3,addr=0x430000000 \
391        -drive file=${IMGDIR}/image-bmc,if=mtd,format=raw \
392        -device loader,file=${IMGDIR}/zephyr-aspeed-ssp.elf,cpu-num=4 \
393        -device loader,file=${IMGDIR}/zephyr-aspeed-tsp.elf,cpu-num=5 \
394        -serial pty -serial pty -serial pty \
395        -snapshot \
396        -S -nographic
401 .. code-block:: bash
407 - serial0: Console for the four Cortex-A35 primary processors.
408 - serial1 and serial2: Consoles for the two Cortex-M4 coprocessors.
412 .. code-block:: bash
419 Aspeed minibmc family boards (``ast1030-evb``)
424 Aspeed SoC : the AST1030 integrating an ARM Cortex M4F CPU (200MHz).
430 - ``ast1030-evb``          Aspeed AST1030 Evaluation board (Cortex-M4F)
433 -----------------
435  * SMP (for the AST1030 Cortex-M4F)
436  * Interrupt Controller (VIC)
437  * Timer Controller
438  * I2C Controller
441  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
442  * SPI Memory Controller
443  * USB 2.0 Controller
444  * Watchdog Controller
445  * GPIO Controller (Master only)
447  * LPC Peripheral Controller (a subset of subdevices are supported)
448  * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA
450  * Secure Boot Controller
451  * PECI Controller (minimal)
455 ---------------
457  * PWM and Fan Controller
458  * Slave GPIO Controller
459  * Mailbox Controller
461  * eSPI Controller
462  * I3C Controller
465 ------------
467 The Aspeed machines can be started using the ``-kernel`` to load a
471    https://github.com/AspeedTech-BMC/zephyr/releases
475 .. code-block:: bash
477   $ qemu-system-arm -M ast1030-evb -nographic \
478         -kernel zephyr.elf