You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by xi...@apache.org on 2026/04/29 13:39:26 UTC

(nuttx) branch master updated: doc: Update qemu-i486

This is an automated email from the ASF dual-hosted git repository.

xiaoxiang781216 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git


The following commit(s) were added to refs/heads/master by this push:
     new 9f2db603702 doc: Update qemu-i486
9f2db603702 is described below

commit 9f2db603702883937488344ba97f6a3eb167d2f6
Author: Alan Carvalho de Assis <ac...@gmail.com>
AuthorDate: Tue Apr 28 21:16:32 2026 -0300

    doc: Update qemu-i486
    
    This PR improves the qemu-i486 documentation.
    
    Signed-off-by: Alan C. Assis <ac...@gmail.com>
---
 .../platforms/x86/qemu/boards/qemu-i486/index.rst  | 43 ++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/Documentation/platforms/x86/qemu/boards/qemu-i486/index.rst b/Documentation/platforms/x86/qemu/boards/qemu-i486/index.rst
index 879df26cb0c..9313653160b 100644
--- a/Documentation/platforms/x86/qemu/boards/qemu-i486/index.rst
+++ b/Documentation/platforms/x86/qemu/boards/qemu-i486/index.rst
@@ -4,3 +4,46 @@ qemu-i486
 
 Port of NuttX to QEMU in i486 mode.  This port will also run on real i486
 hardware (Google the Bifferboard).
+
+QEMU
+====
+
+QEMU is a generic and open source machine emulator and virtualizer.
+
+QEMU Installation
+-----------------
+
+You can install QEMU for x86 on Linux Ubuntu this way::
+
+   $ sudo apt install qemu-system-x86
+
+Executing QEMU
+--------------
+
+Running QEMU with the generated ``nuttx.elf`` file::
+
+  $ qemu-system-i386 -cpu 486 -m 2 -kernel nuttx.elf -nographic
+
+Configuration
+=============
+
+Use the default configuration process::
+
+   $ ./tools/configure.sh qemu-i486:<configname>
+
+These are the available configurations:
+
+nsh
+---
+
+Enables the NuttShell for i486 emulated on QEMU.
+After running the QEMU command above with nuttx.elf you will see::
+
+   SeaBIOS (version 1.16.3-debian-1.16.3-2)
+
+   iPXE (https://ipxe.org) 00:03.0 CA00 PCI2.10 PnP PMM+0018AED0+00000000 CA00
+
+   Booting from ROM..
+   NuttShell (NSH) NuttX-12.13.0
+   nsh>
+