xref: /openbmc/qemu/docs/system/arm/nuvoton.rst (revision d27532e4)
1Nuvoton iBMC boards (``*-bmc``, ``npcm750-evb``, ``quanta-gsj``)
2================================================================
3
4The `Nuvoton iBMC`_ chips (NPCM7xx) are a family of ARM-based SoCs that are
5designed to be used as Baseboard Management Controllers (BMCs) in various
6servers. They all feature one or two ARM Cortex-A9 CPU cores, as well as an
7assortment of peripherals targeted for either Enterprise or Data Center /
8Hyperscale applications. The former is a superset of the latter, so NPCM750 has
9all the peripherals of NPCM730 and more.
10
11.. _Nuvoton iBMC: https://www.nuvoton.com/products/cloud-computing/ibmc/
12
13The NPCM750 SoC has two Cortex-A9 cores and is targeted for the Enterprise
14segment. The following machines are based on this chip :
15
16- ``npcm750-evb``       Nuvoton NPCM750 Evaluation board
17
18The NPCM730 SoC has two Cortex-A9 cores and is targeted for Data Center and
19Hyperscale applications. The following machines are based on this chip :
20
21- ``quanta-gbs-bmc``    Quanta GBS server BMC
22- ``quanta-gsj``        Quanta GSJ server BMC
23- ``kudo-bmc``          Fii USA Kudo server BMC
24- ``mori-bmc``          Fii USA Mori server BMC
25
26There are also two more SoCs, NPCM710 and NPCM705, which are single-core
27variants of NPCM750 and NPCM730, respectively. These are currently not
28supported by QEMU.
29
30Supported devices
31-----------------
32
33 * SMP (Dual Core Cortex-A9)
34 * Cortex-A9MPCore built-in peripherals: SCU, GIC, Global Timer, Private Timer
35   and Watchdog.
36 * SRAM, ROM and DRAM mappings
37 * System Global Control Registers (GCR)
38 * Clock and reset controller (CLK)
39 * Timer controller (TIM)
40 * Serial ports (16550-based)
41 * DDR4 memory controller (dummy interface indicating memory training is done)
42 * OTP controllers (no protection features)
43 * Flash Interface Unit (FIU; no protection features)
44 * Random Number Generator (RNG)
45 * USB host (USBH)
46 * GPIO controller
47 * Analog to Digital Converter (ADC)
48 * Pulse Width Modulation (PWM)
49 * SMBus controller (SMBF)
50 * Ethernet controller (EMC)
51 * Tachometer
52 * Peripheral SPI controller (PSPI)
53
54Missing devices
55---------------
56
57 * LPC/eSPI host-to-BMC interface, including
58
59   * Keyboard and mouse controller interface (KBCI)
60   * Keyboard Controller Style (KCS) channels
61   * BIOS POST code FIFO
62   * System Wake-up Control (SWC)
63   * Shared memory (SHM)
64   * eSPI slave interface
65
66 * Ethernet controller (GMAC)
67 * USB device (USBD)
68 * SD/MMC host
69 * PECI interface
70 * PCI and PCIe root complex and bridges
71 * VDM and MCTP support
72 * Serial I/O expansion
73 * LPC/eSPI host
74 * Coprocessor
75 * Graphics
76 * Video capture
77 * Encoding compression engine
78 * Security features
79
80Boot options
81------------
82
83The Nuvoton machines can boot from an OpenBMC firmware image, or directly into
84a kernel using the ``-kernel`` option. OpenBMC images for ``quanta-gsj`` and
85possibly others can be downloaded from the OpenBMC jenkins :
86
87   https://jenkins.openbmc.org/
88
89The firmware image should be attached as an MTD drive. Example :
90
91.. code-block:: bash
92
93  $ qemu-system-arm -machine quanta-gsj -nographic \
94      -drive file=image-bmc,if=mtd,bus=0,unit=0,format=raw
95
96The default root password for test images is usually ``0penBmc``.
97