88 lines
2.5 KiB
ReStructuredText
88 lines
2.5 KiB
ReStructuredText
.. _basic_atom:
|
|
|
|
Platform Configuration: basic_atom
|
|
##################################
|
|
|
|
Overview
|
|
********
|
|
|
|
The basic_atom platform configuration is used by Zephyr applications
|
|
that run on QEMU emulating the Atom N28xx platform. This platform
|
|
configuration provides support for an x86 Atom 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 an actual Atom N28xx hardware system, or any other hardware system.
|
|
|
|
Supported Boards
|
|
****************
|
|
|
|
The basic_atom platform configuration has been tested on QEMU 2.1.
|
|
|
|
Supported Features
|
|
******************
|
|
|
|
The basic_atom 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_atom platform configuration does not support PCI.
|
|
|
|
HPET System Clock Support
|
|
=========================
|
|
|
|
The basic_atom platform configuration uses a system
|
|
clock frequency of 25 MHz.
|
|
|
|
.. note::
|
|
The LOAPIC timer may be used instead of the HPET; however
|
|
SYS_CLOCK_HW_CYCLES_PER_SEC would need to be set to a custom
|
|
value---one that is tied to the speed of the host system.
|
|
|
|
Serial Port
|
|
===========
|
|
|
|
The basic_atom platform configuration uses a single serial
|
|
communication channel with a NS16550 serial driver
|
|
that operates in polling mode. For an interrupt-driven driver,
|
|
enable the UART_INTERRUPT_DRIVEN kernel configuration 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)
|