zephyr/doc/board/qemu_x86.rst

68 lines
2.0 KiB
ReStructuredText

.. _qemu_x86:
X86 Emulation (QEMU)
####################
Overview
********
The Zephyr Kernel uses the qemu_x86 board configuration to emulate pentium-class
systems running on QEMU.
It provides support for an x86 Minute IA CPU and the following devices:
* HPET
* Advanced Programmable Interrupt Controller (APIC)
* NS16550 UART
.. note::
This board configuration makes no claims about its suitability for use
with actual galileo hardware, or any other hardware.
The qemu_x86 board configuration has been tested on QEMU 2.1.
Supported Features
******************
The qemu_x86 board configuration supports the following hardware features:
+--------------+------------+-----------------------+
| Interface | Controller | Driver/Component |
+==============+============+=======================+
| HPET | on-chip | system clock |
+--------------+------------+-----------------------+
| APIC | on-chip | interrupt controller |
+--------------+------------+-----------------------+
| NS16550 | on-chip | serial port |
| UART | | |
+--------------+------------+-----------------------+
The kernel currently does not support other hardware features on this platform.
HPET System Clock Support
=========================
The qemu_x86 board configuration uses an HPET clock frequency of 25 MHz.
Serial Port
===========
The qemu_x86 board configuration uses a single serial communication channel that
uses the NS16550 serial driver operating in polling mode. To override, enable
the UART_INTERRUPT_DRIVEN Kconfig option, which allows the system to be
interrupt-driven.
Known Problems or Limitations
*****************************
The following platform features are unsupported:
* Isolated Memory Regions
* Serial port in Direct Memory Access (DMA) mode
* Serial Peripheral Interface (SPI) flash
* General-Purpose Input/Output (GPIO)
* Inter-Integrated Circuit (I2C)
* Ethernet
* Supervisor Mode Execution Protection (SMEP)