qemu-doc: split target sections to separate files
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com> Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Reviewed-by: Alex Bennée <alex.bennee@linaro.org> Tested-by: Alex Bennée <alex.bennee@linaro.org> Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Message-id: 20200228153619.9906-9-peter.maydell@linaro.org Message-id: 20200226113034.6741-9-pbonzini@redhat.com Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
This commit is contained in:
Paolo Bonzini
Peter Maydell
parent
0a3716060f
commit
9d0ba2cd94
|
|
@ -0,0 +1,264 @@
|
|||
@node ARM System emulator
|
||||
@section ARM System emulator
|
||||
@cindex system emulation (ARM)
|
||||
|
||||
Use the executable @file{qemu-system-arm} to simulate a ARM
|
||||
machine. The ARM Integrator/CP board is emulated with the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
|
||||
@item
|
||||
Two PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse.
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
The ARM Versatile baseboard is emulated with the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1136 or Cortex-A8 CPU
|
||||
@item
|
||||
PL190 Vectored Interrupt Controller
|
||||
@item
|
||||
Four PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse.
|
||||
@item
|
||||
PCI host bridge. Note the emulated PCI bridge only provides access to
|
||||
PCI memory space. It does not provide access to PCI IO space.
|
||||
This means some devices (eg. ne2k_pci NIC) are not usable, and others
|
||||
(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
|
||||
mapped control registers.
|
||||
@item
|
||||
PCI OHCI USB controller.
|
||||
@item
|
||||
LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
Several variants of the ARM RealView baseboard are emulated,
|
||||
including the EB, PB-A8 and PBX-A9. Due to interactions with the
|
||||
bootloader, only certain Linux kernel configurations work out
|
||||
of the box on these boards.
|
||||
|
||||
Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
|
||||
enabled in the kernel, and expect 512M RAM. Kernels for The PBX-A9 board
|
||||
should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
|
||||
disabled and expect 1024M RAM.
|
||||
|
||||
The following devices are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
|
||||
@item
|
||||
ARM AMBA Generic/Distributed Interrupt Controller
|
||||
@item
|
||||
Four PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 or SMSC LAN9118 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse
|
||||
@item
|
||||
PCI host bridge
|
||||
@item
|
||||
PCI OHCI USB controller
|
||||
@item
|
||||
LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
|
||||
and "Terrier") emulation includes the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Intel PXA270 System-on-chip (ARM V5TE core)
|
||||
@item
|
||||
NAND Flash memory
|
||||
@item
|
||||
IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
|
||||
@item
|
||||
On-chip OHCI USB controller
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
TI ADS7846 touchscreen controller on SSP bus
|
||||
@item
|
||||
Maxim MAX1111 analog-digital converter on I@math{^2}C bus
|
||||
@item
|
||||
GPIO-connected keyboard controller and LEDs
|
||||
@item
|
||||
Secure Digital card connected to PXA MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@item
|
||||
WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
|
||||
@end itemize
|
||||
|
||||
The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
|
||||
following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP310 System-on-chip (ARM 925T core)
|
||||
@item
|
||||
ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
TI TSC2102i touchscreen controller / analog-digital converter / Audio
|
||||
CODEC, connected through MicroWire and I@math{^2}S busses
|
||||
@item
|
||||
GPIO-connected matrix keypad
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@end itemize
|
||||
|
||||
Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
|
||||
emulation supports the following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
|
||||
@item
|
||||
RAM and non-volatile OneNAND Flash memories
|
||||
@item
|
||||
Display connected to EPSON remote framebuffer chip and OMAP on-chip
|
||||
display controller and a LS041y3 MIPI DBI-C controller
|
||||
@item
|
||||
TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
|
||||
driven through SPI bus
|
||||
@item
|
||||
National Semiconductor LM8323-controlled qwerty keyboard driven
|
||||
through I@math{^2}C bus
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three OMAP on-chip UARTs and on-chip STI debugging console
|
||||
@item
|
||||
Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
|
||||
TUSB6010 chip - only USB host mode is supported
|
||||
@item
|
||||
TI TMP105 temperature sensor driven through I@math{^2}C bus
|
||||
@item
|
||||
TI TWL92230C power management companion with an RTC on I@math{^2}C bus
|
||||
@item
|
||||
Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
|
||||
through CBUS
|
||||
@end itemize
|
||||
|
||||
The Luminary Micro Stellaris LM3S811EVB emulation includes the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Cortex-M3 CPU core.
|
||||
@item
|
||||
64k Flash and 8k SRAM.
|
||||
@item
|
||||
Timers, UARTs, ADC and I@math{^2}C interface.
|
||||
@item
|
||||
OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
|
||||
@end itemize
|
||||
|
||||
The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Cortex-M3 CPU core.
|
||||
@item
|
||||
256k Flash and 64k SRAM.
|
||||
@item
|
||||
Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
|
||||
@item
|
||||
OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
|
||||
@end itemize
|
||||
|
||||
The Freecom MusicPal internet radio emulation includes the following
|
||||
elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Marvell MV88W8618 ARM core.
|
||||
@item
|
||||
32 MB RAM, 256 KB SRAM, 8 MB flash.
|
||||
@item
|
||||
Up to 2 16550 UARTs
|
||||
@item
|
||||
MV88W8xx8 Ethernet controller
|
||||
@item
|
||||
MV88W8618 audio controller, WM8750 CODEC and mixer
|
||||
@item
|
||||
128×64 display with brightness control
|
||||
@item
|
||||
2 buttons, 2 navigation wheels with button function
|
||||
@end itemize
|
||||
|
||||
The Siemens SX1 models v1 and v2 (default) basic emulation.
|
||||
The emulation includes the following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP310 System-on-chip (ARM 925T core)
|
||||
@item
|
||||
ROM and RAM memories (ROM firmware image can be loaded with -pflash)
|
||||
V1
|
||||
1 Flash of 16MB and 1 Flash of 8MB
|
||||
V2
|
||||
1 Flash of 32MB
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@end itemize
|
||||
|
||||
A Linux 2.6 test image is available on the QEMU web site. More
|
||||
information is available in the QEMU mailing-list archive.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the ARM emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
On ARM this implements the "Angel" interface.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
|
@ -0,0 +1,92 @@
|
|||
@node x86 (PC) System emulator
|
||||
@section x86 (PC) System emulator
|
||||
@cindex system emulation (PC)
|
||||
|
||||
@menu
|
||||
* pcsys_devices:: Peripherals
|
||||
* cpu_models_x86:: CPU models
|
||||
* pcsys_req:: OS requirements
|
||||
@end menu
|
||||
|
||||
@node pcsys_devices
|
||||
@subsection Peripherals
|
||||
|
||||
@c man begin DESCRIPTION
|
||||
|
||||
The QEMU PC System emulator simulates the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
i440FX host PCI bridge and PIIX3 PCI to ISA bridge
|
||||
@item
|
||||
Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
|
||||
extensions (hardware level, including all non standard modes).
|
||||
@item
|
||||
PS/2 mouse and keyboard
|
||||
@item
|
||||
2 PCI IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@item
|
||||
PCI and ISA network adapters
|
||||
@item
|
||||
Serial ports
|
||||
@item
|
||||
IPMI BMC, either and internal or external one
|
||||
@item
|
||||
Creative SoundBlaster 16 sound card
|
||||
@item
|
||||
ENSONIQ AudioPCI ES1370 sound card
|
||||
@item
|
||||
Intel 82801AA AC97 Audio compatible sound card
|
||||
@item
|
||||
Intel HD Audio Controller and HDA codec
|
||||
@item
|
||||
Adlib (OPL2) - Yamaha YM3812 compatible chip
|
||||
@item
|
||||
Gravis Ultrasound GF1 sound card
|
||||
@item
|
||||
CS4231A compatible sound card
|
||||
@item
|
||||
PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
|
||||
@end itemize
|
||||
|
||||
SMP is supported with up to 255 CPUs.
|
||||
|
||||
QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
|
||||
VGA BIOS.
|
||||
|
||||
QEMU uses YM3812 emulation by Tatsuyuki Satoh.
|
||||
|
||||
QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
|
||||
by Tibor "TS" Schütz.
|
||||
|
||||
Note that, by default, GUS shares IRQ(7) with parallel ports and so
|
||||
QEMU must be told to not have parallel ports to have working GUS.
|
||||
|
||||
@example
|
||||
@value{qemu_system_x86} dos.img -soundhw gus -parallel none
|
||||
@end example
|
||||
|
||||
Alternatively:
|
||||
@example
|
||||
@value{qemu_system_x86} dos.img -device gus,irq=5
|
||||
@end example
|
||||
|
||||
Or some other unclaimed IRQ.
|
||||
|
||||
CS4231A is the chip used in Windows Sound System and GUSMAX products
|
||||
|
||||
@c man end
|
||||
|
||||
@lowersections
|
||||
@include docs/system/cpu-models-x86.texi
|
||||
@raisesections
|
||||
|
||||
@node pcsys_req
|
||||
@subsection OS requirements
|
||||
|
||||
On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
|
||||
require the host to be running Linux v4.5 or newer. Red Hat Enterprise Linux
|
||||
7 is also supported, since the required functionality was backported.
|
||||
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
@node ColdFire System emulator
|
||||
@section ColdFire System emulator
|
||||
@cindex system emulation (ColdFire)
|
||||
@cindex system emulation (M68K)
|
||||
|
||||
Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
|
||||
The emulator is able to boot a uClinux kernel.
|
||||
|
||||
The M5208EVB emulation includes the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
|
||||
@item
|
||||
Three Two on-chip UARTs.
|
||||
@item
|
||||
Fast Ethernet Controller (FEC)
|
||||
@end itemize
|
||||
|
||||
The AN5206 emulation includes the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MCF5206 ColdFire V2 Microprocessor.
|
||||
@item
|
||||
Two on-chip UARTs.
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the ColdFire emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
On M68K this implements the "ColdFire GDB" interface used by libgloss.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
|
@ -0,0 +1,152 @@
|
|||
@node MIPS System emulator
|
||||
@section MIPS System emulator
|
||||
@cindex system emulation (MIPS)
|
||||
|
||||
@menu
|
||||
* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
|
||||
* nanoMIPS System emulator ::
|
||||
@end menu
|
||||
|
||||
Four executables cover simulation of 32 and 64-bit MIPS systems in
|
||||
both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
|
||||
@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
|
||||
Five different machine types are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A generic ISA PC-like machine "mips"
|
||||
@item
|
||||
The MIPS Malta prototype board "malta"
|
||||
@item
|
||||
An ACER Pica "pica61". This machine needs the 64-bit emulator.
|
||||
@item
|
||||
MIPS emulator pseudo board "mipssim"
|
||||
@item
|
||||
A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
|
||||
@end itemize
|
||||
|
||||
The generic emulation is supported by Debian 'Etch' and is able to
|
||||
install Debian into a virtual disk image. The following devices are
|
||||
emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of MIPS CPUs, default is the 24Kf
|
||||
@item
|
||||
PC style serial port
|
||||
@item
|
||||
PC style IDE disk
|
||||
@item
|
||||
NE2000 network card
|
||||
@end itemize
|
||||
|
||||
The Malta emulation supports the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Core board with MIPS 24Kf CPU and Galileo system controller
|
||||
@item
|
||||
PIIX4 PCI/USB/SMbus controller
|
||||
@item
|
||||
The Multi-I/O chip's serial device
|
||||
@item
|
||||
PCI network cards (PCnet32 and others)
|
||||
@item
|
||||
Malta FPGA serial device
|
||||
@item
|
||||
Cirrus (default) or any other PCI VGA graphics card
|
||||
@end itemize
|
||||
|
||||
The Boston board emulation supports the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Xilinx FPGA, which includes a PCIe root port and an UART
|
||||
@item
|
||||
Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
|
||||
@end itemize
|
||||
|
||||
The ACER Pica emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MIPS R4000 CPU
|
||||
@item
|
||||
PC-style IRQ and DMA controllers
|
||||
@item
|
||||
PC Keyboard
|
||||
@item
|
||||
IDE controller
|
||||
@end itemize
|
||||
|
||||
The MIPS Magnum R4000 emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MIPS R4000 CPU
|
||||
@item
|
||||
PC-style IRQ controller
|
||||
@item
|
||||
PC Keyboard
|
||||
@item
|
||||
SCSI controller
|
||||
@item
|
||||
G364 framebuffer
|
||||
@end itemize
|
||||
|
||||
The Fulong 2E emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Loongson 2E CPU
|
||||
@item
|
||||
Bonito64 system controller as North Bridge
|
||||
@item
|
||||
VT82C686 chipset as South Bridge
|
||||
@item
|
||||
RTL8139D as a network card chipset
|
||||
@end itemize
|
||||
|
||||
The mipssim pseudo board emulation provides an environment similar
|
||||
to what the proprietary MIPS emulator uses for running Linux.
|
||||
It supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of MIPS CPUs, default is the 24Kf
|
||||
@item
|
||||
PC style serial port
|
||||
@item
|
||||
MIPSnet network emulation
|
||||
@end itemize
|
||||
|
||||
@lowersections
|
||||
@include docs/system/cpu-models-mips.texi
|
||||
@raisesections
|
||||
|
||||
@node nanoMIPS System emulator
|
||||
@subsection nanoMIPS System emulator
|
||||
@cindex system emulation (nanoMIPS)
|
||||
|
||||
Executable @file{qemu-system-mipsel} also covers simulation of
|
||||
32-bit nanoMIPS system in little endian mode:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
nanoMIPS I7200 CPU
|
||||
@end itemize
|
||||
|
||||
Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
|
||||
|
||||
Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
|
||||
|
||||
Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
|
||||
|
||||
Start system emulation of Malta board with nanoMIPS I7200 CPU:
|
||||
@example
|
||||
qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
|
||||
-M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
|
||||
-append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
|
||||
@end example
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,78 @@
|
|||
@node PowerPC System emulator
|
||||
@section PowerPC System emulator
|
||||
@cindex system emulation (PowerPC)
|
||||
|
||||
Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
|
||||
or PowerMac PowerPC system.
|
||||
|
||||
QEMU emulates the following PowerMac peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
UniNorth or Grackle PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
2 PMAC IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
NE2000 PCI adapters
|
||||
@item
|
||||
Non Volatile RAM
|
||||
@item
|
||||
VIA-CUDA with ADB keyboard and mouse.
|
||||
@end itemize
|
||||
|
||||
QEMU emulates the following 40P (PREP) peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
2 IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@item
|
||||
PCnet network adapters
|
||||
@item
|
||||
Serial port
|
||||
@item
|
||||
PREP Non Volatile RAM
|
||||
@item
|
||||
PC compatible keyboard and mouse.
|
||||
@end itemize
|
||||
|
||||
Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
|
||||
for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
|
||||
(GPL v2) portable firmware implementation. The goal is to implement a 100%
|
||||
IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the PowerPC emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -g @var{W}x@var{H}[x@var{DEPTH}]
|
||||
|
||||
Set the initial VGA graphic mode. The default is 800x600x32.
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-ppc -prom-env 'auto-boot?=false' \
|
||||
-prom-env 'boot-device=hd:2,\yaboot' \
|
||||
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
|
||||
@end example
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
||||
More information is available at
|
||||
@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
|
||||
|
||||
|
|
@ -0,0 +1,96 @@
|
|||
@node Sparc32 System emulator
|
||||
@section Sparc32 System emulator
|
||||
@cindex system emulation (Sparc32)
|
||||
|
||||
Use the executable @file{qemu-system-sparc} to simulate the following
|
||||
Sun4m architecture machines:
|
||||
@itemize @minus
|
||||
@item
|
||||
SPARCstation 4
|
||||
@item
|
||||
SPARCstation 5
|
||||
@item
|
||||
SPARCstation 10
|
||||
@item
|
||||
SPARCstation 20
|
||||
@item
|
||||
SPARCserver 600MP
|
||||
@item
|
||||
SPARCstation LX
|
||||
@item
|
||||
SPARCstation Voyager
|
||||
@item
|
||||
SPARCclassic
|
||||
@item
|
||||
SPARCbook
|
||||
@end itemize
|
||||
|
||||
The emulation is somewhat complete. SMP up to 16 CPUs is supported,
|
||||
but Linux limits the number of usable CPUs to 4.
|
||||
|
||||
QEMU emulates the following sun4m peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
IOMMU
|
||||
@item
|
||||
TCX or cgthree Frame buffer
|
||||
@item
|
||||
Lance (Am7990) Ethernet
|
||||
@item
|
||||
Non Volatile RAM M48T02/M48T08
|
||||
@item
|
||||
Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
|
||||
and power/reset logic
|
||||
@item
|
||||
ESP SCSI controller with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy drive (not on SS-600MP)
|
||||
@item
|
||||
CS4231 sound device (only on SS-5, not working yet)
|
||||
@end itemize
|
||||
|
||||
The number of peripherals is fixed in the architecture. Maximum
|
||||
memory size depends on the machine type, for SS-5 it is 256MB and for
|
||||
others 2047MB.
|
||||
|
||||
Since version 0.8.2, QEMU uses OpenBIOS
|
||||
@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
|
||||
firmware implementation. The goal is to implement a 100% IEEE
|
||||
1275-1994 (referred to as Open Firmware) compliant firmware.
|
||||
|
||||
A sample Linux 2.6 series kernel and ram disk image are available on
|
||||
the QEMU web site. There are still issues with NetBSD and OpenBSD, but
|
||||
most kernel versions work. Please note that currently older Solaris kernels
|
||||
don't work probably due to interface issues between OpenBIOS and
|
||||
Solaris.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Sparc32 emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -g @var{W}x@var{H}x[x@var{DEPTH}]
|
||||
|
||||
Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
|
||||
option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
|
||||
of 1152x900x8 for people who wish to use OBP.
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-sparc -prom-env 'auto-boot?=false' \
|
||||
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
|
||||
@end example
|
||||
|
||||
@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
|
||||
|
||||
Set the emulated machine type. Default is SS-5.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
@node Sparc64 System emulator
|
||||
@section Sparc64 System emulator
|
||||
@cindex system emulation (Sparc64)
|
||||
|
||||
Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
|
||||
(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
|
||||
Niagara (T1) machine. The Sun4u emulator is mostly complete, being
|
||||
able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
|
||||
Sun4v emulator is still a work in progress.
|
||||
|
||||
The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
|
||||
of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
|
||||
and is able to boot the disk.s10hw2 Solaris image.
|
||||
@example
|
||||
qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
|
||||
-nographic -m 256 \
|
||||
-drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
|
||||
@end example
|
||||
|
||||
|
||||
QEMU emulates the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
UltraSparc IIi APB PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
PS/2 mouse and keyboard
|
||||
@item
|
||||
Non Volatile RAM M48T59
|
||||
@item
|
||||
PC-compatible serial ports
|
||||
@item
|
||||
2 PCI IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Sparc64 emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-sparc64 -prom-env 'auto-boot?=false'
|
||||
@end example
|
||||
|
||||
@item -M [sun4u|sun4v|niagara]
|
||||
|
||||
Set the emulated machine type. The default is sun4u.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
@node Xtensa System emulator
|
||||
@section Xtensa System emulator
|
||||
@cindex system emulation (Xtensa)
|
||||
|
||||
Two executables cover simulation of both Xtensa endian options,
|
||||
@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
|
||||
Two different machine types are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Xtensa emulator pseudo board "sim"
|
||||
@item
|
||||
Avnet LX60/LX110/LX200 board
|
||||
@end itemize
|
||||
|
||||
The sim pseudo board emulation provides an environment similar
|
||||
to one provided by the proprietary Tensilica ISS.
|
||||
It supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of Xtensa CPUs, default is the DC232B
|
||||
@item
|
||||
Console and filesystem access via semihosting calls
|
||||
@end itemize
|
||||
|
||||
The Avnet LX60/LX110/LX200 emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of Xtensa CPUs, default is the DC232B
|
||||
@item
|
||||
16550 UART
|
||||
@item
|
||||
OpenCores 10/100 Mbps Ethernet MAC
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Xtensa emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
|
||||
Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
873
qemu-doc.texi
873
qemu-doc.texi
|
|
@ -176,874 +176,17 @@ various targets are mentioned in the following sections.
|
|||
* MIPS System emulator::
|
||||
* ARM System emulator::
|
||||
* ColdFire System emulator::
|
||||
* Cris System emulator::
|
||||
* Microblaze System emulator::
|
||||
* SH4 System emulator::
|
||||
* Xtensa System emulator::
|
||||
@end menu
|
||||
|
||||
@node x86 (PC) System emulator
|
||||
@section x86 (PC) System emulator
|
||||
@cindex system emulation (PC)
|
||||
|
||||
@menu
|
||||
* pcsys_devices:: Peripherals
|
||||
* cpu_models_x86:: Supported CPU model configurations on x86 hosts
|
||||
* pcsys_req:: OS requirements
|
||||
@end menu
|
||||
|
||||
@node pcsys_devices
|
||||
@subsection Peripherals
|
||||
|
||||
@c man begin DESCRIPTION
|
||||
|
||||
The QEMU PC System emulator simulates the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
i440FX host PCI bridge and PIIX3 PCI to ISA bridge
|
||||
@item
|
||||
Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
|
||||
extensions (hardware level, including all non standard modes).
|
||||
@item
|
||||
PS/2 mouse and keyboard
|
||||
@item
|
||||
2 PCI IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@item
|
||||
PCI and ISA network adapters
|
||||
@item
|
||||
Serial ports
|
||||
@item
|
||||
IPMI BMC, either and internal or external one
|
||||
@item
|
||||
Creative SoundBlaster 16 sound card
|
||||
@item
|
||||
ENSONIQ AudioPCI ES1370 sound card
|
||||
@item
|
||||
Intel 82801AA AC97 Audio compatible sound card
|
||||
@item
|
||||
Intel HD Audio Controller and HDA codec
|
||||
@item
|
||||
Adlib (OPL2) - Yamaha YM3812 compatible chip
|
||||
@item
|
||||
Gravis Ultrasound GF1 sound card
|
||||
@item
|
||||
CS4231A compatible sound card
|
||||
@item
|
||||
PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1 hub.
|
||||
@end itemize
|
||||
|
||||
SMP is supported with up to 255 CPUs.
|
||||
|
||||
QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
|
||||
VGA BIOS.
|
||||
|
||||
QEMU uses YM3812 emulation by Tatsuyuki Satoh.
|
||||
|
||||
QEMU uses GUS emulation (GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
|
||||
by Tibor "TS" Schütz.
|
||||
|
||||
Note that, by default, GUS shares IRQ(7) with parallel ports and so
|
||||
QEMU must be told to not have parallel ports to have working GUS.
|
||||
|
||||
@example
|
||||
@value{qemu_system_x86} dos.img -soundhw gus -parallel none
|
||||
@end example
|
||||
|
||||
Alternatively:
|
||||
@example
|
||||
@value{qemu_system_x86} dos.img -device gus,irq=5
|
||||
@end example
|
||||
|
||||
Or some other unclaimed IRQ.
|
||||
|
||||
CS4231A is the chip used in Windows Sound System and GUSMAX products
|
||||
|
||||
@c man end
|
||||
|
||||
@lowersections
|
||||
@include docs/system/cpu-models-x86.texi
|
||||
@raisesections
|
||||
|
||||
@node pcsys_req
|
||||
@subsection OS requirements
|
||||
|
||||
On x86_64 hosts, the default set of CPU features enabled by the KVM accelerator
|
||||
require the host to be running Linux v4.5 or newer. Red Hat Enterprise Linux
|
||||
7 is also supported, since the required functionality was backported.
|
||||
|
||||
@node PowerPC System emulator
|
||||
@section PowerPC System emulator
|
||||
@cindex system emulation (PowerPC)
|
||||
|
||||
Use the executable @file{qemu-system-ppc} to simulate a complete 40P (PREP)
|
||||
or PowerMac PowerPC system.
|
||||
|
||||
QEMU emulates the following PowerMac peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
UniNorth or Grackle PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
2 PMAC IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
NE2000 PCI adapters
|
||||
@item
|
||||
Non Volatile RAM
|
||||
@item
|
||||
VIA-CUDA with ADB keyboard and mouse.
|
||||
@end itemize
|
||||
|
||||
QEMU emulates the following 40P (PREP) peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
2 IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@item
|
||||
PCnet network adapters
|
||||
@item
|
||||
Serial port
|
||||
@item
|
||||
PREP Non Volatile RAM
|
||||
@item
|
||||
PC compatible keyboard and mouse.
|
||||
@end itemize
|
||||
|
||||
Since version 0.9.1, QEMU uses OpenBIOS @url{https://www.openbios.org/}
|
||||
for the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
|
||||
(GPL v2) portable firmware implementation. The goal is to implement a 100%
|
||||
IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the PowerPC emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -g @var{W}x@var{H}[x@var{DEPTH}]
|
||||
|
||||
Set the initial VGA graphic mode. The default is 800x600x32.
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-ppc -prom-env 'auto-boot?=false' \
|
||||
-prom-env 'boot-device=hd:2,\yaboot' \
|
||||
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'
|
||||
@end example
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
|
||||
More information is available at
|
||||
@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
|
||||
|
||||
@node Sparc32 System emulator
|
||||
@section Sparc32 System emulator
|
||||
@cindex system emulation (Sparc32)
|
||||
|
||||
Use the executable @file{qemu-system-sparc} to simulate the following
|
||||
Sun4m architecture machines:
|
||||
@itemize @minus
|
||||
@item
|
||||
SPARCstation 4
|
||||
@item
|
||||
SPARCstation 5
|
||||
@item
|
||||
SPARCstation 10
|
||||
@item
|
||||
SPARCstation 20
|
||||
@item
|
||||
SPARCserver 600MP
|
||||
@item
|
||||
SPARCstation LX
|
||||
@item
|
||||
SPARCstation Voyager
|
||||
@item
|
||||
SPARCclassic
|
||||
@item
|
||||
SPARCbook
|
||||
@end itemize
|
||||
|
||||
The emulation is somewhat complete. SMP up to 16 CPUs is supported,
|
||||
but Linux limits the number of usable CPUs to 4.
|
||||
|
||||
QEMU emulates the following sun4m peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
IOMMU
|
||||
@item
|
||||
TCX or cgthree Frame buffer
|
||||
@item
|
||||
Lance (Am7990) Ethernet
|
||||
@item
|
||||
Non Volatile RAM M48T02/M48T08
|
||||
@item
|
||||
Slave I/O: timers, interrupt controllers, Zilog serial ports, keyboard
|
||||
and power/reset logic
|
||||
@item
|
||||
ESP SCSI controller with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy drive (not on SS-600MP)
|
||||
@item
|
||||
CS4231 sound device (only on SS-5, not working yet)
|
||||
@end itemize
|
||||
|
||||
The number of peripherals is fixed in the architecture. Maximum
|
||||
memory size depends on the machine type, for SS-5 it is 256MB and for
|
||||
others 2047MB.
|
||||
|
||||
Since version 0.8.2, QEMU uses OpenBIOS
|
||||
@url{https://www.openbios.org/}. OpenBIOS is a free (GPL v2) portable
|
||||
firmware implementation. The goal is to implement a 100% IEEE
|
||||
1275-1994 (referred to as Open Firmware) compliant firmware.
|
||||
|
||||
A sample Linux 2.6 series kernel and ram disk image are available on
|
||||
the QEMU web site. There are still issues with NetBSD and OpenBSD, but
|
||||
most kernel versions work. Please note that currently older Solaris kernels
|
||||
don't work probably due to interface issues between OpenBIOS and
|
||||
Solaris.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Sparc32 emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -g @var{W}x@var{H}x[x@var{DEPTH}]
|
||||
|
||||
Set the initial graphics mode. For TCX, the default is 1024x768x8 with the
|
||||
option of 1024x768x24. For cgthree, the default is 1024x768x8 with the option
|
||||
of 1152x900x8 for people who wish to use OBP.
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-sparc -prom-env 'auto-boot?=false' \
|
||||
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'
|
||||
@end example
|
||||
|
||||
@item -M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|SPARCbook]
|
||||
|
||||
Set the emulated machine type. Default is SS-5.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
@node Sparc64 System emulator
|
||||
@section Sparc64 System emulator
|
||||
@cindex system emulation (Sparc64)
|
||||
|
||||
Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
|
||||
(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
|
||||
Niagara (T1) machine. The Sun4u emulator is mostly complete, being
|
||||
able to run Linux, NetBSD and OpenBSD in headless (-nographic) mode. The
|
||||
Sun4v emulator is still a work in progress.
|
||||
|
||||
The Niagara T1 emulator makes use of firmware and OS binaries supplied in the S10image/ directory
|
||||
of the OpenSPARC T1 project @url{http://download.oracle.com/technetwork/systems/opensparc/OpenSPARCT1_Arch.1.5.tar.bz2}
|
||||
and is able to boot the disk.s10hw2 Solaris image.
|
||||
@example
|
||||
qemu-system-sparc64 -M niagara -L /path-to/S10image/ \
|
||||
-nographic -m 256 \
|
||||
-drive if=pflash,readonly=on,file=/S10image/disk.s10hw2
|
||||
@end example
|
||||
|
||||
|
||||
QEMU emulates the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
UltraSparc IIi APB PCI Bridge
|
||||
@item
|
||||
PCI VGA compatible card with VESA Bochs Extensions
|
||||
@item
|
||||
PS/2 mouse and keyboard
|
||||
@item
|
||||
Non Volatile RAM M48T59
|
||||
@item
|
||||
PC-compatible serial ports
|
||||
@item
|
||||
2 PCI IDE interfaces with hard disk and CD-ROM support
|
||||
@item
|
||||
Floppy disk
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Sparc64 emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -prom-env @var{string}
|
||||
|
||||
Set OpenBIOS variables in NVRAM, for example:
|
||||
|
||||
@example
|
||||
qemu-system-sparc64 -prom-env 'auto-boot?=false'
|
||||
@end example
|
||||
|
||||
@item -M [sun4u|sun4v|niagara]
|
||||
|
||||
Set the emulated machine type. The default is sun4u.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
@node MIPS System emulator
|
||||
@section MIPS System emulator
|
||||
@cindex system emulation (MIPS)
|
||||
|
||||
@menu
|
||||
* recommendations_cpu_models_MIPS:: Supported CPU model configurations on MIPS hosts
|
||||
* nanoMIPS System emulator ::
|
||||
@end menu
|
||||
|
||||
Four executables cover simulation of 32 and 64-bit MIPS systems in
|
||||
both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
|
||||
@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
|
||||
Five different machine types are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A generic ISA PC-like machine "mips"
|
||||
@item
|
||||
The MIPS Malta prototype board "malta"
|
||||
@item
|
||||
An ACER Pica "pica61". This machine needs the 64-bit emulator.
|
||||
@item
|
||||
MIPS emulator pseudo board "mipssim"
|
||||
@item
|
||||
A MIPS Magnum R4000 machine "magnum". This machine needs the 64-bit emulator.
|
||||
@end itemize
|
||||
|
||||
The generic emulation is supported by Debian 'Etch' and is able to
|
||||
install Debian into a virtual disk image. The following devices are
|
||||
emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of MIPS CPUs, default is the 24Kf
|
||||
@item
|
||||
PC style serial port
|
||||
@item
|
||||
PC style IDE disk
|
||||
@item
|
||||
NE2000 network card
|
||||
@end itemize
|
||||
|
||||
The Malta emulation supports the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Core board with MIPS 24Kf CPU and Galileo system controller
|
||||
@item
|
||||
PIIX4 PCI/USB/SMbus controller
|
||||
@item
|
||||
The Multi-I/O chip's serial device
|
||||
@item
|
||||
PCI network cards (PCnet32 and others)
|
||||
@item
|
||||
Malta FPGA serial device
|
||||
@item
|
||||
Cirrus (default) or any other PCI VGA graphics card
|
||||
@end itemize
|
||||
|
||||
The Boston board emulation supports the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Xilinx FPGA, which includes a PCIe root port and an UART
|
||||
@item
|
||||
Intel EG20T PCH connects the I/O peripherals, but only the SATA bus is emulated
|
||||
@end itemize
|
||||
|
||||
The ACER Pica emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MIPS R4000 CPU
|
||||
@item
|
||||
PC-style IRQ and DMA controllers
|
||||
@item
|
||||
PC Keyboard
|
||||
@item
|
||||
IDE controller
|
||||
@end itemize
|
||||
|
||||
The MIPS Magnum R4000 emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MIPS R4000 CPU
|
||||
@item
|
||||
PC-style IRQ controller
|
||||
@item
|
||||
PC Keyboard
|
||||
@item
|
||||
SCSI controller
|
||||
@item
|
||||
G364 framebuffer
|
||||
@end itemize
|
||||
|
||||
The Fulong 2E emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Loongson 2E CPU
|
||||
@item
|
||||
Bonito64 system controller as North Bridge
|
||||
@item
|
||||
VT82C686 chipset as South Bridge
|
||||
@item
|
||||
RTL8139D as a network card chipset
|
||||
@end itemize
|
||||
|
||||
The mipssim pseudo board emulation provides an environment similar
|
||||
to what the proprietary MIPS emulator uses for running Linux.
|
||||
It supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of MIPS CPUs, default is the 24Kf
|
||||
@item
|
||||
PC style serial port
|
||||
@item
|
||||
MIPSnet network emulation
|
||||
@end itemize
|
||||
|
||||
@lowersections
|
||||
@include docs/system/cpu-models-mips.texi
|
||||
@raisesections
|
||||
|
||||
@node nanoMIPS System emulator
|
||||
@subsection nanoMIPS System emulator
|
||||
@cindex system emulation (nanoMIPS)
|
||||
|
||||
Executable @file{qemu-system-mipsel} also covers simulation of
|
||||
32-bit nanoMIPS system in little endian mode:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
nanoMIPS I7200 CPU
|
||||
@end itemize
|
||||
|
||||
Example of @file{qemu-system-mipsel} usage for nanoMIPS is shown below:
|
||||
|
||||
Download @code{<disk_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html}.
|
||||
|
||||
Download @code{<kernel_image_file>} from @url{https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html}.
|
||||
|
||||
Start system emulation of Malta board with nanoMIPS I7200 CPU:
|
||||
@example
|
||||
qemu-system-mipsel -cpu I7200 -kernel @code{<kernel_image_file>} \
|
||||
-M malta -serial stdio -m @code{<memory_size>} -hda @code{<disk_image_file>} \
|
||||
-append "mem=256m@@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
|
||||
@end example
|
||||
|
||||
|
||||
@node ARM System emulator
|
||||
@section ARM System emulator
|
||||
@cindex system emulation (ARM)
|
||||
|
||||
Use the executable @file{qemu-system-arm} to simulate a ARM
|
||||
machine. The ARM Integrator/CP board is emulated with the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
|
||||
@item
|
||||
Two PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse.
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
The ARM Versatile baseboard is emulated with the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1136 or Cortex-A8 CPU
|
||||
@item
|
||||
PL190 Vectored Interrupt Controller
|
||||
@item
|
||||
Four PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse.
|
||||
@item
|
||||
PCI host bridge. Note the emulated PCI bridge only provides access to
|
||||
PCI memory space. It does not provide access to PCI IO space.
|
||||
This means some devices (eg. ne2k_pci NIC) are not usable, and others
|
||||
(eg. rtl8139 NIC) are only usable when the guest drivers use the memory
|
||||
mapped control registers.
|
||||
@item
|
||||
PCI OHCI USB controller.
|
||||
@item
|
||||
LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices.
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
Several variants of the ARM RealView baseboard are emulated,
|
||||
including the EB, PB-A8 and PBX-A9. Due to interactions with the
|
||||
bootloader, only certain Linux kernel configurations work out
|
||||
of the box on these boards.
|
||||
|
||||
Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
|
||||
enabled in the kernel, and expect 512M RAM. Kernels for The PBX-A9 board
|
||||
should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
|
||||
disabled and expect 1024M RAM.
|
||||
|
||||
The following devices are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
|
||||
@item
|
||||
ARM AMBA Generic/Distributed Interrupt Controller
|
||||
@item
|
||||
Four PL011 UARTs
|
||||
@item
|
||||
SMC 91c111 or SMSC LAN9118 Ethernet adapter
|
||||
@item
|
||||
PL110 LCD controller
|
||||
@item
|
||||
PL050 KMI with PS/2 keyboard and mouse
|
||||
@item
|
||||
PCI host bridge
|
||||
@item
|
||||
PCI OHCI USB controller
|
||||
@item
|
||||
LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM devices
|
||||
@item
|
||||
PL181 MultiMedia Card Interface with SD card.
|
||||
@end itemize
|
||||
|
||||
The XScale-based clamshell PDA models ("Spitz", "Akita", "Borzoi"
|
||||
and "Terrier") emulation includes the following peripherals:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Intel PXA270 System-on-chip (ARM V5TE core)
|
||||
@item
|
||||
NAND Flash memory
|
||||
@item
|
||||
IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in "Akita"
|
||||
@item
|
||||
On-chip OHCI USB controller
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
TI ADS7846 touchscreen controller on SSP bus
|
||||
@item
|
||||
Maxim MAX1111 analog-digital converter on I@math{^2}C bus
|
||||
@item
|
||||
GPIO-connected keyboard controller and LEDs
|
||||
@item
|
||||
Secure Digital card connected to PXA MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@item
|
||||
WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
|
||||
@end itemize
|
||||
|
||||
The Palm Tungsten|E PDA (codename "Cheetah") emulation includes the
|
||||
following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP310 System-on-chip (ARM 925T core)
|
||||
@item
|
||||
ROM and RAM memories (ROM firmware image can be loaded with -option-rom)
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
TI TSC2102i touchscreen controller / analog-digital converter / Audio
|
||||
CODEC, connected through MicroWire and I@math{^2}S busses
|
||||
@item
|
||||
GPIO-connected matrix keypad
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@end itemize
|
||||
|
||||
Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
|
||||
emulation supports the following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
|
||||
@item
|
||||
RAM and non-volatile OneNAND Flash memories
|
||||
@item
|
||||
Display connected to EPSON remote framebuffer chip and OMAP on-chip
|
||||
display controller and a LS041y3 MIPI DBI-C controller
|
||||
@item
|
||||
TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
|
||||
driven through SPI bus
|
||||
@item
|
||||
National Semiconductor LM8323-controlled qwerty keyboard driven
|
||||
through I@math{^2}C bus
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three OMAP on-chip UARTs and on-chip STI debugging console
|
||||
@item
|
||||
Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
|
||||
TUSB6010 chip - only USB host mode is supported
|
||||
@item
|
||||
TI TMP105 temperature sensor driven through I@math{^2}C bus
|
||||
@item
|
||||
TI TWL92230C power management companion with an RTC on I@math{^2}C bus
|
||||
@item
|
||||
Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
|
||||
through CBUS
|
||||
@end itemize
|
||||
|
||||
The Luminary Micro Stellaris LM3S811EVB emulation includes the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Cortex-M3 CPU core.
|
||||
@item
|
||||
64k Flash and 8k SRAM.
|
||||
@item
|
||||
Timers, UARTs, ADC and I@math{^2}C interface.
|
||||
@item
|
||||
OSRAM Pictiva 96x16 OLED with SSD0303 controller on I@math{^2}C bus.
|
||||
@end itemize
|
||||
|
||||
The Luminary Micro Stellaris LM3S6965EVB emulation includes the following
|
||||
devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Cortex-M3 CPU core.
|
||||
@item
|
||||
256k Flash and 64k SRAM.
|
||||
@item
|
||||
Timers, UARTs, ADC, I@math{^2}C and SSI interfaces.
|
||||
@item
|
||||
OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
|
||||
@end itemize
|
||||
|
||||
The Freecom MusicPal internet radio emulation includes the following
|
||||
elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Marvell MV88W8618 ARM core.
|
||||
@item
|
||||
32 MB RAM, 256 KB SRAM, 8 MB flash.
|
||||
@item
|
||||
Up to 2 16550 UARTs
|
||||
@item
|
||||
MV88W8xx8 Ethernet controller
|
||||
@item
|
||||
MV88W8618 audio controller, WM8750 CODEC and mixer
|
||||
@item
|
||||
128×64 display with brightness control
|
||||
@item
|
||||
2 buttons, 2 navigation wheels with button function
|
||||
@end itemize
|
||||
|
||||
The Siemens SX1 models v1 and v2 (default) basic emulation.
|
||||
The emulation includes the following elements:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Texas Instruments OMAP310 System-on-chip (ARM 925T core)
|
||||
@item
|
||||
ROM and RAM memories (ROM firmware image can be loaded with -pflash)
|
||||
V1
|
||||
1 Flash of 16MB and 1 Flash of 8MB
|
||||
V2
|
||||
1 Flash of 32MB
|
||||
@item
|
||||
On-chip LCD controller
|
||||
@item
|
||||
On-chip Real Time Clock
|
||||
@item
|
||||
Secure Digital card connected to OMAP MMC/SD host
|
||||
@item
|
||||
Three on-chip UARTs
|
||||
@end itemize
|
||||
|
||||
A Linux 2.6 test image is available on the QEMU web site. More
|
||||
information is available in the QEMU mailing-list archive.
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the ARM emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
On ARM this implements the "Angel" interface.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
@node ColdFire System emulator
|
||||
@section ColdFire System emulator
|
||||
@cindex system emulation (ColdFire)
|
||||
@cindex system emulation (M68K)
|
||||
|
||||
Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
|
||||
The emulator is able to boot a uClinux kernel.
|
||||
|
||||
The M5208EVB emulation includes the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MCF5208 ColdFire V2 Microprocessor (ISA A+ with EMAC).
|
||||
@item
|
||||
Three Two on-chip UARTs.
|
||||
@item
|
||||
Fast Ethernet Controller (FEC)
|
||||
@end itemize
|
||||
|
||||
The AN5206 emulation includes the following devices:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
MCF5206 ColdFire V2 Microprocessor.
|
||||
@item
|
||||
Two on-chip UARTs.
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the ColdFire emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
On M68K this implements the "ColdFire GDB" interface used by libgloss.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
|
||||
@node Cris System emulator
|
||||
@section Cris System emulator
|
||||
@cindex system emulation (Cris)
|
||||
|
||||
TODO
|
||||
|
||||
@node Microblaze System emulator
|
||||
@section Microblaze System emulator
|
||||
@cindex system emulation (Microblaze)
|
||||
|
||||
TODO
|
||||
|
||||
@node SH4 System emulator
|
||||
@section SH4 System emulator
|
||||
@cindex system emulation (SH4)
|
||||
|
||||
TODO
|
||||
|
||||
@node Xtensa System emulator
|
||||
@section Xtensa System emulator
|
||||
@cindex system emulation (Xtensa)
|
||||
|
||||
Two executables cover simulation of both Xtensa endian options,
|
||||
@file{qemu-system-xtensa} and @file{qemu-system-xtensaeb}.
|
||||
Two different machine types are emulated:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
Xtensa emulator pseudo board "sim"
|
||||
@item
|
||||
Avnet LX60/LX110/LX200 board
|
||||
@end itemize
|
||||
|
||||
The sim pseudo board emulation provides an environment similar
|
||||
to one provided by the proprietary Tensilica ISS.
|
||||
It supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of Xtensa CPUs, default is the DC232B
|
||||
@item
|
||||
Console and filesystem access via semihosting calls
|
||||
@end itemize
|
||||
|
||||
The Avnet LX60/LX110/LX200 emulation supports:
|
||||
|
||||
@itemize @minus
|
||||
@item
|
||||
A range of Xtensa CPUs, default is the DC232B
|
||||
@item
|
||||
16550 UART
|
||||
@item
|
||||
OpenCores 10/100 Mbps Ethernet MAC
|
||||
@end itemize
|
||||
|
||||
@c man begin OPTIONS
|
||||
|
||||
The following options are specific to the Xtensa emulation:
|
||||
|
||||
@table @option
|
||||
|
||||
@item -semihosting
|
||||
Enable semihosting syscall emulation.
|
||||
|
||||
Xtensa semihosting provides basic file IO calls, such as open/read/write/seek/select.
|
||||
Tensilica baremetal libc for ISS and linux platform "sim" use this interface.
|
||||
|
||||
Note that this allows guest direct access to the host filesystem,
|
||||
so should only be used with trusted guest OS.
|
||||
|
||||
@end table
|
||||
|
||||
@c man end
|
||||
@include docs/system/target-i386.texi
|
||||
@include docs/system/target-ppc.texi
|
||||
@include docs/system/target-sparc.texi
|
||||
@include docs/system/target-sparc64.texi
|
||||
@include docs/system/target-mips.texi
|
||||
@include docs/system/target-arm.texi
|
||||
@include docs/system/target-m68k.texi
|
||||
@include docs/system/target-xtensa.texi
|
||||
|
||||
@include docs/security.texi
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue