docs/system/arm: Update Nuvoton OpenBMC image guidance
Describe the current OpenBMC target naming and release status for Nuvoton machines. The latest 2.18.0 release no longer includes GSJ, so point users at older 2.14.0 sources and explain how to find Jenkins MTD artifacts. Signed-off-by: Bin Meng <bin.meng@processmission.com> Message-id: 20260627063208.33642-1-bin.meng@processmission.com Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Bin Meng committed
Jun 27, 2026 at 14:32 UTC
24506d7709970044462fcce743a86d72dc317359
1 file changed
+49
-5
docs/system/arm/nuvoton.rst
+49
-5
@@ -94,16 +94,60 @@ Boot options
94
------------
95
96
The Nuvoton machines can boot from an OpenBMC firmware image, or directly into
97
-a kernel using the ``-kernel`` option. OpenBMC images for ``quanta-gsj`` and
98
-possibly others can be downloaded from the OpenBMC jenkins :
97
+a kernel using the ``-kernel`` option. OpenBMC machine names do not always
98
+match QEMU machine names. Check the OpenBMC supported-machine list and Jenkins
99
+for currently available source and pre-built images.
100
+
101
+Known OpenBMC (v2.18.0) target names for QEMU Nuvoton machines per:
102
+
103
+ https://github.com/openbmc/openbmc/blob/2.18.0/meta-phosphor/docs/supported-machines.md
104
+
105
+.. list-table::
106
+ :header-rows: 1
107
+
108
+ * - QEMU machine
109
+ - OpenBMC machine
110
+ * - ``npcm750-evb``
111
+ - ``evb-npcm750``
112
+ * - ``npcm845-evb``
113
+ - ``evb-npcm845``
114
+ * - ``quanta-gbs-bmc``
115
+ - ``gbs``
116
+ * - ``kudo-bmc``
117
+ - ``kudo``
118
+ * - ``mori-bmc``
119
+ - ``mori``
120
+
121
+As of June 2026, the latest OpenBMC release, ``2.18.0``, no longer lists a
122
+``gsj`` machine. To build an image for QEMU's ``quanta-gsj`` machine, use an
123
+older OpenBMC release that still contains ``meta-quanta/meta-gsj``. The
124
+``2.14.0`` release contains the ``gsj`` machine:
125
+
126
+ https://github.com/openbmc/openbmc/tree/2.14.0/meta-quanta/meta-gsj
127
+
128
+Some pre-built OpenBMC images for QEMU Nuvoton machines may be available on
129
+Jenkins:
130
131
https://jenkins.openbmc.org/
132
102
-The firmware image should be attached as an MTD drive. Example :
133
+To find a pre-built MTD image on Jenkins, start from the Jenkins home page and
134
+open the ``latest-master`` job. Select the matrix configuration whose
135
+``target`` matches the OpenBMC machine name, for example
136
+``label=docker-builder,target=gbs``, then open its latest successful build's
137
+artifacts. The MTD image is usually published under
138
+``openbmc/build/tmp/deploy/images/<machine>/`` as
139
+``obmc-phosphor-image-<machine>-<timestamp>.static.mtd``. If Jenkins does not
140
+list a matching target, or the build artifacts do not include an MTD image,
141
+there is no current pre-built MTD image for that machine.
142
+
143
+The firmware image should be attached as an MTD drive. Example:
144
145
.. code-block:: bash
146
106
- $ qemu-system-arm -machine quanta-gsj -nographic \
107
- -drive file=image-bmc,if=mtd,bus=0,unit=0,format=raw
147
+ $ qemu-system-arm -machine quanta-gbs-bmc -nographic \
148
+ -drive file=obmc-phosphor-image-gbs-xxxxxx.static.mtd,if=mtd,bus=0,unit=0,format=raw
149
150
The default root password for test images is usually ``0penBmc``.
151
+
152
+For other machines that don't have pre-built images on Jenkins, build an image
153
+from source by following the OpenBMC build documentation.