12bff81b4d
Document the 3 front LEDs modeled on the OpenPOWER Witherspoon BMC
(see commit 7cfbde5ea1 "hw/arm/aspeed: Add the 3 front LEDs drived
by the PCA9552 #1").
Reviewed-by: Cédric Le Goater <clg@kaod.org>
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Message-id: 20201120173953.2539469-4-f4bug@amsat.org
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
105 lines
3.0 KiB
ReStructuredText
105 lines
3.0 KiB
ReStructuredText
Aspeed family boards (``*-bmc``, ``ast2500-evb``, ``ast2600-evb``)
|
|
==================================================================
|
|
|
|
The QEMU Aspeed machines model BMCs of various OpenPOWER systems and
|
|
Aspeed evaluation boards. They are based on different releases of the
|
|
Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the
|
|
AST2500 with an ARM1176JZS CPU (800MHz) and more recently the AST2600
|
|
with dual cores ARM Cortex A7 CPUs (1.2GHz).
|
|
|
|
The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
|
|
etc.
|
|
|
|
AST2400 SoC based machines :
|
|
|
|
- ``palmetto-bmc`` OpenPOWER Palmetto POWER8 BMC
|
|
|
|
AST2500 SoC based machines :
|
|
|
|
- ``ast2500-evb`` Aspeed AST2500 Evaluation board
|
|
- ``romulus-bmc`` OpenPOWER Romulus POWER9 BMC
|
|
- ``witherspoon-bmc`` OpenPOWER Witherspoon POWER9 BMC
|
|
- ``sonorapass-bmc`` OCP SonoraPass BMC
|
|
- ``swift-bmc`` OpenPOWER Swift BMC POWER9
|
|
|
|
AST2600 SoC based machines :
|
|
|
|
- ``ast2600-evb`` Aspeed AST2600 Evaluation board (Cortex A7)
|
|
- ``tacoma-bmc`` OpenPOWER Witherspoon POWER9 AST2600 BMC
|
|
|
|
Supported devices
|
|
-----------------
|
|
|
|
* SMP (for the AST2600 Cortex-A7)
|
|
* Interrupt Controller (VIC)
|
|
* Timer Controller
|
|
* RTC Controller
|
|
* I2C Controller
|
|
* System Control Unit (SCU)
|
|
* SRAM mapping
|
|
* X-DMA Controller (basic interface)
|
|
* Static Memory Controller (SMC or FMC) - Only SPI Flash support
|
|
* SPI Memory Controller
|
|
* USB 2.0 Controller
|
|
* SD/MMC storage controllers
|
|
* SDRAM controller (dummy interface for basic settings and training)
|
|
* Watchdog Controller
|
|
* GPIO Controller (Master only)
|
|
* UART
|
|
* Ethernet controllers
|
|
* Front LEDs (PCA9552 on I2C bus)
|
|
|
|
|
|
Missing devices
|
|
---------------
|
|
|
|
* Coprocessor support
|
|
* ADC (out of tree implementation)
|
|
* PWM and Fan Controller
|
|
* LPC Bus Controller
|
|
* Slave GPIO Controller
|
|
* Super I/O Controller
|
|
* Hash/Crypto Engine
|
|
* PCI-Express 1 Controller
|
|
* Graphic Display Controller
|
|
* PECI Controller
|
|
* MCTP Controller
|
|
* Mailbox Controller
|
|
* Virtual UART
|
|
* eSPI Controller
|
|
* I3C Controller
|
|
|
|
Boot options
|
|
------------
|
|
|
|
The Aspeed machines can be started using the -kernel option to load a
|
|
Linux kernel or from a firmware image which can be downloaded from the
|
|
OpenPOWER jenkins :
|
|
|
|
https://openpower.xyz/
|
|
|
|
The image should be attached as an MTD drive. Run :
|
|
|
|
.. code-block:: bash
|
|
|
|
$ qemu-system-arm -M romulus-bmc -nic user \
|
|
-drive file=flash-romulus,format=raw,if=mtd -nographic
|
|
|
|
Options specific to Aspeed machines are :
|
|
|
|
* ``execute-in-place`` which emulates the boot from the CE0 flash
|
|
device by using the FMC controller to load the instructions, and
|
|
not simply from RAM. This takes a little longer.
|
|
|
|
* ``fmc-model`` to change the FMC Flash model. FW needs support for
|
|
the chip model to boot.
|
|
|
|
* ``spi-model`` to change the SPI Flash model.
|
|
|
|
For instance, to start the ``ast2500-evb`` machine with a different
|
|
FMC chip and a bigger (64M) SPI chip, use :
|
|
|
|
.. code-block:: bash
|
|
|
|
-M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f
|