From 9f2db603702883937488344ba97f6a3eb167d2f6 Mon Sep 17 00:00:00 2001 From: Alan Carvalho de Assis Date: Tue, 28 Apr 2026 21:16:32 -0300 Subject: [PATCH] doc: Update qemu-i486 This PR improves the qemu-i486 documentation. Signed-off-by: Alan C. Assis --- .../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: + +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> +