system/arm/aspeed.rst

3 The QEMU Aspeed machines model BMCs of various OpenPOWER systems and
4 Aspeed evaluation boards. They are based on different releases of the
5 Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the
6 AST2500 with an ARM1176JZS CPU (800MHz), the AST2600
9 The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
44  * SMP (for the AST2600 Cortex-A7)
48  * I2C Controller, including the new register interface of the AST2600
89 The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
90 to load a Linux kernel or from a firmware. Images can be downloaded from the
95 or directly from the OpenBMC GitHub release repository :
99 or directly from the ASPEED Forked OpenBMC GitHub release repository :
118 The machine options specific to Aspeed to boot from a flash image are :
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
125    support for the chip model to boot.
127  * ``spi-model`` to change the default SPI Flash model.
129 To boot the machine from the flash image, use an MTD drive :
137 bigger (64M) SPI for the ``ast2500-evb`` machine, run :
143 When more flexibility is needed to define the flash devices, to use
144 different flash models or define all flash devices (up to 8), the
145 ``-nodefaults`` QEMU option can be used to avoid creating the default
148 Flash devices should then be created from the command line and attached
162 In that case, the machine boots fetching instructions from the FMC0
163 device. It is slower to start but closer to what HW does. Using the
169 The machine options specific to Aspeed machines to boot from an eMMC
174 Only the ``ast2600-evb`` and ``rainier-emmc`` machines have support to
175 boot from an eMMC device. In this case, the machine assumes that the
187 Boot the machine ``rainier-emmc`` with :
195 The ``boot-emmc`` option can be set or unset, to change the default
196 boot mode of machine: SPI or eMMC. This can be useful to boot the
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
212 It should be noted that in this case the eMMC device must not have
213 boot partitions, otherwise the contents will not be accessible to the
214 machine.  This limitation is due to the use of the ``-drive``
217 Ideally, one should be able to define the eMMC device and the
218 associated backend directly on the command line, such as :
226 refactor the sdhci bus model.
233  * ``bmc-console`` to change the default console device. Most of the
234    machines use the ``UART5`` device for a boot console, which is
235    mapped on ``/dev/ttyS4`` under Linux, but it is not always the
238 To change the boot console and use device ``UART3`` (``/dev/ttyS2``
248 The QEMU Aspeed machines model BMCs of Aspeed evaluation boards.
249 They are based on different releases of the Aspeed SoC :
250 the AST2700 with quad cores ARM Cortex-A35 64 bits CPUs (1.6GHz).
252 The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
302 Images can be downloaded from the ASPEED Forked OpenBMC GitHub release repository :
306 Booting the ast2700-evb machine
309 Boot the AST2700 machine from the flash image.
311 There are two supported methods for booting the AST2700 machine with a flash image:
316 corresponds to the BL31 image load address.
338 If users do not specify the ``-bios option``, QEMU will attempt to load the
339 default vbootrom image ``ast27x0_bootrom.bin`` from either the current working
340 directory or the ``pc-bios`` directory within the QEMU source tree.
348 The ``-bios`` option allows users to specify a custom path for the vbootrom
349 image to be loaded during boot. This will load the vbootrom image from the
350 specified path in the ${HOME} directory.
356 Booting the ast2700fc machine
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.
363 Steps to boot the AST2700fc machine:
365 1. Ensure you have the following AST2700A1 binaries available in a directory
375 2. Execute the following command to start ``ast2700fc`` machine:
407 - serial0: Console for the four Cortex-A35 primary processors.
408 - serial1 and serial2: Consoles for the two Cortex-M4 coprocessors.
410 Use ``tio`` or another terminal emulator to connect to the consoles:
422 The QEMU Aspeed machines model mini BMCs of various Aspeed evaluation
423 boards. They are based on different releases of the
424 Aspeed SoC : the AST1030 integrating an ARM Cortex M4F CPU (200MHz).
426 The SoC comes with SRAM, SPI, I2C, etc.
435  * SMP (for the AST1030 Cortex-M4F)
467 The Aspeed machines can be started using the ``-kernel`` to load a
468 Zephyr OS or from a firmware. Images can be downloaded from the