QEMU System Emulator Targets

QEMU is a generic emulator and it emulates many machines. Most of the options are similar for all machines. Specific information about the various targets are mentioned in the following sections.

Contents:

• Arm System emulator
  • Choosing a board model
  • Board-specific documentation
    • Arm Integrator/CP (integratorcp)
    • Arm MPS2 and MPS3 boards (mps2-an385, mps2-an386, mps2-an500, mps2-an505, mps2-an511, mps2-an521, mps3-an524, mps3-an536, mps3-an547)
      • Machine-specific options
    • Arm Musca boards (musca-a, musca-b1)
    • Arm Realview boards (realview-eb, realview-eb-mpcore, realview-pb-a8, realview-pbx-a9)
    • Arm Server Base System Architecture Reference board (sbsa-ref)
      • Supported devices
      • Board to firmware interface
        • Note
        • DeviceTree information
        • Platform version
    • Arm Versatile boards (versatileab, versatilepb)
      • Booting a Linux kernel
    • Arm Versatile Express boards (vexpress-a9, vexpress-a15)
      • Booting a Linux kernel
    • Aspeed family boards (*-bmc, ast2500-evb, ast2600-evb, ast2700-evb)
      • Supported devices
      • Missing devices
      • Boot options
    • Aspeed minibmc family boards (ast1030-evb)
      • Supported devices
      • Missing devices
      • Boot options
    • Facebook Yosemite v3.5 Platform and CraterLake Server (fby35)
    • Banana Pi BPI-M2U (bpim2u)
      • Supported devices
      • Limitations
      • Boot options
      • Running mainline Linux
      • Banana Pi M2U images
      • Running U-Boot
      • Banana Pi M2U integration tests
    • B-L475E-IOT01A IoT Node (b-l475e-iot01a)
      • Supported devices
      • Missing devices
      • Boot options
    • Boundary Devices SABRE Lite (sabrelite)
      • Supported devices
      • Boot options
      • Running Linux kernel
      • Running U-Boot
    • Calxeda Highbank and Midway (highbank, midway)
    • Canon A1100 (canon-a1100)
    • Cubietech Cubieboard (cubieboard)
    • Emcraft SmartFusion2 SOM kit (emcraft-sf2)
    • Freecom MusicPal (musicpal)
    • Gumstix Connex and Verdex (connex, verdex)
    • Intel Mainstone II board (mainstone)
    • Kyoto Microcomputer KZM-ARM11-01 (kzm)
    • Nokia N800 and N810 tablets (n800, n810)
    • Nordic nRF boards (microbit)
      • Supported devices
      • Missing devices
      • Boot options
    • Nuvoton iBMC boards (*-bmc, npcm750-evb, quanta-gsj)
      • Supported devices
      • Missing devices
      • Boot options
    • NXP i.MX25 PDK board (imx25-pdk)
    • Orange Pi PC (orangepi-pc)
      • Supported devices
      • Limitations
      • Boot options
      • Machine-specific options
      • Running mainline Linux
      • Orange Pi PC images
      • Running U-Boot
      • Running NetBSD
      • Orange Pi PC integration tests
    • Palm Tungsten|E PDA (cheetah)
    • Raspberry Pi boards (raspi0, raspi1ap, raspi2b, raspi3ap, raspi3b, raspi4b)
      • Implemented devices
      • Missing devices
    • Sharp XScale-based PDA models (akita, borzoi, spitz, terrier, tosa)
    • Sharp Zaurus SL-5500 (collie)
    • Siemens SX1 (sx1, sx1-v1)
    • Stellaris boards (lm3s6965evb, lm3s811evb)
    • STMicroelectronics STM32 boards (netduino2, netduinoplus2, stm32vldiscovery)
      • Supported devices
      • Missing devices
      • Boot options
    • ‘virt’ generic virtual platform (virt)
      • Supported devices
      • Machine-specific options
      • Linux guest kernel configuration
      • Hardware configuration information for bare-metal programming
    • Xen Device Emulation Backend (xenpvh)
    • Xilinx Versal Virt (xlnx-versal-virt)
      • Running
      • BBRAM File Backend
      • eFUSE File Backend
      • Using CANFDs for Versal Virt
    • Xilinx Zynq board (xilinx-zynq-a9)
      • Running
  • Emulated CPU architecture support
    • A-profile CPU architecture support
    • R-profile CPU architecture support
    • M-profile CPU architecture support
  • Arm CPU features
    • Arm CPU Features
    • CPU Feature Probing
      • A note about CPU feature dependencies
      • A note about CPU models and KVM
    • Using CPU Features
    • KVM VCPU Features
    • TCG VCPU Features
    • SVE CPU Properties
      • SVE CPU Property Dependencies and Constraints
      • SVE CPU Property Parsing Semantics
      • SVE CPU Property Examples
      • SVE CPU Property Recommendations
      • SME CPU Property Examples
      • SVE User-mode Default Vector Length Property
    • SME CPU Properties
      • SME User-mode Default Vector Length Property
    • RME CPU Properties
      • RME Level 0 GPT Size Property
• AVR System emulator
• ColdFire System emulator
• MIPS System emulator
  • Supported CPU model configurations on MIPS hosts
    • Supported CPU models for MIPS32 hosts
    • Supported CPU models for MIPS64 hosts
    • Supported CPU models for nanoMIPS hosts
    • Preferred CPU models for MIPS hosts
  • nanoMIPS System emulator
• PowerPC System emulator
  • Board-specific documentation
    • AmigaNG boards (amigaone, pegasos2, sam460ex)
      • Eyetech AmigaOne/Mai Logic Teron (amigaone)
        • Emulated devices
        • Firmware
        • Running Linux
      • Genesi/bPlan Pegasos II (pegasos2)
        • Emulated devices
        • Firmware
        • Running Linux
      • aCube Sam460ex (sam460ex)
        • Firmware
        • Emulated devices
        • Running Linux
    • Embedded family boards
    • PowerMac family boards (g3beige, mac99)
      • Supported devices
      • Missing devices
      • Firmware
    • PowerNV family boards (powernv8, powernv9, powernv10)
      • Supported devices
      • Missing devices
      • Firmware
      • Current acceleration status
      • Boot options
        • Complex PCIe configuration
        • Multi sockets
        • BMC configuration
        • NVRAM
      • Maintainer contact information
    • ppce500 generic platform (ppce500)
      • Supported devices
      • Hardware configuration information
      • Boot options
      • Running Linux kernel
      • Running U-Boot
      • Networking
      • Root file system on flash drive
    • Prep machine (40p)
      • Supported devices
    • pSeries family boards (pseries)
      • Supported devices
      • Missing devices
      • Firmware
      • Build directions
      • Running instructions
      • sPAPR devices
        • sPAPR specification
          • sPAPR Dynamic Reconfiguration
            • Dynamic-reconfiguration Connectors
            • Device tree description of DRCs
              • ibm,drc-names
              • ibm,drc-indexes
              • ibm,drc-power-domains
              • ibm,drc-types
            • Guest->Host interface to manage dynamic resources
              • rtas-set-power-level
              • rtas-get-power-level
              • rtas-set-indicator
              • rtas-get-sensor-state:
              • rtas-ibm-configure-connector
            • Hot plug/unplug events
            • Hot plug/unplug event structure
            • ibm,lrdr-capacity
            • ibm,dynamic-reconfiguration-memory
              • ibm,lmb-size
              • ibm,associativity-lookup-arrays
              • ibm,dynamic-memory
              • ibm,dynamic-memory-v2
          • sPAPR hypervisor calls
            • H_RTAS (0xf000)
            • H_LOGICAL_MEMOP (0xf001)
          • NUMA mechanics for sPAPR (pseries machines)
            • Associativity and ibm,associativity property
            • Relative Performance Distance and ibm,associativity-reference-points
          • How the pseries Linux guest calculates NUMA distances
          • pseries NUMA mechanics
            • Translating user distance to kernel distance
            • How associativity domains are assigned
            • Limitations of the implementation
          • Legacy (5.1 and older) pseries NUMA mechanics
          • Hypervisor calls and the Ultravisor
            • Hypercalls needed by the ultravisor
              • H_TPM_COMM (0xef10)
          • XIVE for sPAPR (pseries machines)
            • CAS Negotiation
            • KVM negotiation
              • XIVE support in KVM
              • No XIVE support in KVM
            • XIVE Device tree properties
            • IRQ number space
            • Monitoring XIVE
      • Switching between the KVM-PR and KVM-HV kernel module
        • KVM-PR
        • KVM-HV
      • Modules support
        • POWER (PAPR) Protected Execution Facility (PEF)
          • Launching
          • Live Migration
      • Maintainer contact information
• OpenRISC System emulator
  • Choosing a board model
  • Board-specific documentation
    • Or1ksim board
      • Supported devices
      • Boot options
        • Linux guest kernel configuration
        • Hardware configuration information
    • ‘virt’ generic virtual platform
      • Supported devices
      • Boot options
        • Linux guest kernel configuration
        • Hardware configuration information
  • Emulated CPU architecture support
    • OpenRISC 1000 CPU architecture support
  • OpenRISC CPU features
    • CPU Features
• RISC-V System emulator
  • Choosing a board model
  • Board-specific documentation
    • Microchip PolarFire SoC Icicle Kit (microchip-icicle-kit)
      • Supported devices
      • Boot options
      • Running HSS
      • Direct Kernel Boot
    • Shakti C Reference Platform (shakti_c)
      • Supported devices
      • Boot options
      • Boot the machine
        • Shakti SDK
        • OpenSBI
    • SiFive HiFive Unleashed (sifive_u)
      • Supported devices
      • Hardware configuration information
      • Boot options
      • Machine-specific options
      • Running Linux kernel
      • Running VxWorks kernel
      • Running U-Boot
    • ‘virt’ Generic Virtual Platform (virt)
      • Supported devices
      • Hardware configuration information
      • Boot options
      • Using flash devices
      • Machine-specific options
      • Running Linux kernel
      • Running U-Boot
      • Enabling TPM
  • RISC-V CPU firmware
• RX System emulator
• s390x System emulator
  • Device support
    • Adjunct Processor (AP) Device
      • Introduction
      • AP Architectural Overview
      • Start Interpretive Execution (SIE) Instruction
        • Example 1: Valid configuration
        • Example 2: Valid configuration
        • Example 3: Invalid configuration
      • AP Matrix Configuration on Linux Host
        • Binding AP devices to device drivers
        • Configuring an AP matrix for a linux guest
        • Starting a Linux Guest Configured with an AP Matrix
        • Hot plug a vfio-ap device into a running guest
        • Hot unplug a vfio-ap device from a running guest
      • Example: Configure AP Matrices for Three Linux Guests
      • Limitations
    • The virtual channel subsystem
      • Examples
    • 3270 devices
      • Example configuration
      • Restrictions
    • Subchannel passthrough via vfio-ccw
      • Example configuration
        • Step 1: configure the host device
        • Step 2: configure QEMU
    • PCI devices on s390x
  • Architectural features
    • Boot devices on s390x
      • Booting with bootindex parameter
      • Booting without bootindex parameter
      • Selecting kernels with the loadparm property
      • Booting from a network device
    • Protected Virtualization on s390x
      • Prerequisites
      • Running a Protected Virtual Machine
      • Boot Process
    • CPU topology on s390x
      • Prerequisites
      • Enabling CPU topology
      • Default topology usage
        • Hot plug
        • Examples
      • Polarization, entitlement and dedication
        • Polarization
        • Entitlement
      • Defining the topology on the command line
• Sparc32 System emulator
• Sparc64 System emulator
• x86 System emulator
  • Board-specific documentation
    • ‘microvm’ virtual platform (microvm)
      • Supported devices
      • Limitations
      • Using the microvm machine type
        • Machine-specific options
        • Boot options
        • Running a microvm-based VM
        • Triggering a guest-initiated shut down
    • i440fx PC (pc-i440fx, pc)
      • Peripherals
      • Machine-specific options
  • Architectural features
    • Recommendations for KVM CPU model configuration on x86 hosts
      • Two ways to configure CPU models with QEMU / KVM
      • ABI compatibility levels for CPU models
      • Preferred CPU models for Intel x86 hosts
      • Important CPU features for Intel x86 hosts
      • Preferred CPU models for AMD x86 hosts
      • Important CPU features for AMD x86 hosts
      • Default x86 CPU models
      • Other non-recommended x86 CPUs
    • Syntax for configuring CPU models
      • QEMU command line
      • Libvirt guest XML
    • Hyper-V Enlightenments
      • Description
      • Setup
      • Existing enlightenments
      • Supplementary features
      • Useful links
    • Xen HVM guest support
      • Description
      • Setup
      • Properties
      • Xen paravirtual devices
      • Booting Xen PV guests
      • Host OS requirements
    • Paravirtualized KVM features
      • Description
      • Setup
      • Existing features
      • Supplementary features
      • Useful links
    • Software Guard eXtensions (SGX)
      • Overview
      • Virtual SGX
        • Virtual EPC
        • Migration
        • CPUID
        • Virtualize SGX Launch Control
        • Feature Control
      • Launching a guest
      • References
    • AMD Secure Encrypted Virtualization (SEV)
      • Launching (SEV and SEV-ES)
      • Calculating expected guest launch measurement
      • Launching (SEV-SNP)
      • Debugging
      • Snapshot/Restore
      • Live Migration
      • References
  • OS requirements
• Xtensa System emulator