configure: expand path variables for meson configure
[qemu/ar7.git] / docs / system / arm / aspeed.rst
blob45f891eb3cadfc3fdd4434b067a176a08f793800
1 Aspeed family boards (``*-bmc``, ``ast2500-evb``, ``ast2600-evb``)
2 ==================================================================
4 The QEMU Aspeed machines model BMCs of various OpenPOWER systems and
5 Aspeed evaluation boards. They are based on different releases of the
6 Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the
7 AST2500 with an ARM1176JZS CPU (800MHz) and more recently the AST2600
8 with dual cores ARM Cortex A7 CPUs (1.2GHz).
10 The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
11 etc.
13 AST2400 SoC based machines :
15 - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
17 AST2500 SoC based machines :
19 - ``ast2500-evb``          Aspeed AST2500 Evaluation board
20 - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
21 - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
22 - ``sonorapass-bmc``       OCP SonoraPass BMC
23 - ``swift-bmc``            OpenPOWER Swift BMC POWER9
25 AST2600 SoC based machines :
27 - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex A7)
28 - ``tacoma-bmc``           OpenPOWER Witherspoon POWER9 AST2600 BMC
30 Supported devices
31 -----------------
33  * SMP (for the AST2600 Cortex-A7)
34  * Interrupt Controller (VIC)
35  * Timer Controller
36  * RTC Controller
37  * I2C Controller
38  * System Control Unit (SCU)
39  * SRAM mapping
40  * X-DMA Controller (basic interface)
41  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
42  * SPI Memory Controller
43  * USB 2.0 Controller
44  * SD/MMC storage controllers
45  * SDRAM controller (dummy interface for basic settings and training)
46  * Watchdog Controller
47  * GPIO Controller (Master only)
48  * UART
49  * Ethernet controllers
52 Missing devices
53 ---------------
55  * Coprocessor support
56  * ADC (out of tree implementation)
57  * PWM and Fan Controller
58  * LPC Bus Controller
59  * Slave GPIO Controller
60  * Super I/O Controller
61  * Hash/Crypto Engine
62  * PCI-Express 1 Controller
63  * Graphic Display Controller
64  * PECI Controller
65  * MCTP Controller
66  * Mailbox Controller
67  * Virtual UART
68  * eSPI Controller
69  * I3C Controller
71 Boot options
72 ------------
74 The Aspeed machines can be started using the -kernel option to load a
75 Linux kernel or from a firmare image which can be downloaded from the
76 OpenPOWER jenkins :
78    https://openpower.xyz/
80 The image should be attached as an MTD drive. Run :
82 .. code-block:: bash
84   $ qemu-system-arm -M romulus-bmc -nic user \
85         -drive file=flash-romulus,format=raw,if=mtd -nographic