zephyr/doc/platform/basic_minuteia.rst
Peter Mitsis 3efb572a3f doc: Provide basic_minuteia platform documentation
Change-Id: Ib1a17e2cc0f54b900fc285202fd6850d360fa6a2
Signed-off-by: Peter Mitsis <peter.mitsis@windriver.com>
2016-02-05 20:15:33 -05:00

86 lines
2.3 KiB
ReStructuredText

.. _basic_minuteia:
Platform Configuration: basic_minuteia
######################################
Overview
********
The basic_minuteia platform configuration is used by Zephyr applications
to emulate the galileo platform (or something similar) running on QEMU.
It provides support for an x86 Minute IA CPU and the following devices:
* HPET
* Advanced Programmed Interrupt Controller (APIC)
* NS16550 UART
.. note::
This platform configuration makes no claims about its suitability for use
with actual galileo hardware, or any other hardware.
Supported Boards
****************
The basic_minuteia platform configuration has been tested on QEMU 2.1.
Supported Features
******************
The basic_minuteia platform 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 | | |
+--------------+------------+-----------------------+
Other hardware features are not currently supported by Zephyr applications.
Interrupt Controller
====================
.. _galileo's platform documention: galileo.html
Refer to the `galileo's platform documention`_.
.. note::
The basic_minuteia platform configuration does not support PCI.
HPET System Clock Support
=========================
The basic_minuteia platform configuration uses an HPET clock frequency
of 25 MHz.
Serial Port
===========
The basic_minuteia platform configuration uses a single serial
communication channel that uses the NS16550 serial driver
that operates in polling mode. However, this can be overridden
to be interrupt driven by enabling the UART_INTERRUPT_DRIVEN
Kconfig option.
Known Problems or Limitations
*****************************
There is no support for the following:
* 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)
* PCI