sergiotarxz/nuttx
sergiotarxz/nuttx
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Documentation: add missing platforms to platforms/ and remove introduction/platforms

Browse Source
This commit is contained in:
raiden00pl 2023-10-21 17:08:13 +02:00 committed by Xiang Xiao
parent 52ec2326b3
commit 88b7ce80a0
75 changed files with 1981 additions and 3545 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3234
Documentation/introduction/detailed_support.rst
View File

File diff suppressed because it is too large Load Diff

2
Documentation/introduction/index.rst
View File

@ -7,8 +7,6 @@ In the following sections you will find basic information introducing main NuttX
:maxdepth: 1
about.rst
supported_platforms.rst
detailed_support.rst
development_environments.rst
licensing.rst
trademarks.rst

297
Documentation/introduction/supported_platforms.rst
View File

@ -1,297 +0,0 @@
.. include:: /substitutions.rst
===================
Supported Platforms
===================
**Supported Platforms by CPU core**. The number of ports to this
CPU follow in parentheses. The state of the various ports vary
from board-to-board. Follow the links for the details:
.. list-table::
:class: valign-top
* -
- :ref:`introduction/detailed_support:Linux User Mode Simulation` (1)
- ARM
- :ref:`introduction/detailed_support:ARM7TDMI` (4)
- :ref:`introduction/detailed_support:ARM920T` (1)
- :ref:`introduction/detailed_support:ARM926EJS` (4)
- :ref:`introduction/detailed_support:Other ARMv4` (1)
- :ref:`introduction/detailed_support:ARM1176JZ` (1)
- :ref:`introduction/detailed_support:ARM Cortex-A5` (3)
- :ref:`introduction/detailed_support:ARM Cortex-A8` (2)
- :ref:`introduction/detailed_support:ARM Cortex-A9` (1)
- :ref:`introduction/detailed_support:ARM Cortex-A53` (1)
- :ref:`introduction/detailed_support:ARM Cortex-R4` (2)
- :ref:`introduction/detailed_support:ARM Cortex-M0/M0+` (13)
- :ref:`introduction/detailed_support:ARM Cortex-M3` (39)
- :ref:`introduction/detailed_support:ARM Cortex-M4` (59)
- :ref:`introduction/detailed_support:ARM Cortex-M7` (15)
- Atmel AVR
- :ref:`introduction/detailed_support:Microchip AVR` (8-bit) (5)
- :ref:`introduction/detailed_support:Microchip AVR32` (1)
- Freescale
- :ref:`introduction/detailed_support:Freescale M68HCS12` (2)
-
- Intel
- :ref:`introduction/detailed_support:Intel 80x86` (2)
- Microchip
- :ref:`introduction/detailed_support:Microchip PIC32MX` (MIPS M4K) (4)
- :ref:`introduction/detailed_support:Microchip PIC32MZEF` (MIPS M5150) (1)
- Misoc
- :ref:`introduction/detailed_support:Misoc` (1)
- OpenRISC
- :ref:`introduction/detailed_support:OpenRISC mor1kx` (1)
- Renesas/Hitachi:
- :ref:`introduction/detailed_support:Renesas/Hitachi SuperH` (1/2)
- :ref:`introduction/detailed_support:Renesas M16C/26` (1/2)
- :ref:`introduction/detailed_support:Renesas RX65N` (2)
-
- :ref:`introduction/detailed_support:RISC-V` (2)
- :ref:`introduction/detailed_support:LiteX on Arty A7` (1)
- :ref:`introduction/detailed_support:ESP32-C3` (1)
- :ref:`introduction/detailed_support:ESP32-C6` (1)
- Xtensa LX6:
- :ref:`introduction/detailed_support:ESP32 (Dual Xtensa LX6)` (1)
- Xtensa LX7:
- :ref:`introduction/detailed_support:ESP32-S2 (Single Xtensa LX7)` (1)
- :ref:`introduction/detailed_support:ESP32-S3 (Dual Xtensa LX7)` (1)
- ZiLOG
- :ref:`introduction/detailed_support:ZiLOG ZNEO Z16F` (2)
- :ref:`introduction/detailed_support:ZiLOG eZ80 Acclaim!` (4)
- :ref:`introduction/detailed_support:ZiLOG Z8Encore!` (2)
- :ref:`introduction/detailed_support:ZiLOG Z180` (1)
- :ref:`introduction/detailed_support:ZiLOG Z80` (2)
**Supported Platforms by Manufacturer/MCU Family**. CPU core type
follows in parentheses. The state of the various ports vary from MCU to
MCU. Follow the links for the details:
.. list-table::
:class: valign-top
* -
- :ref:`introduction/detailed_support:Linux User Mode Simulation` (1)
- Allwinner
- :ref:`introduction/detailed_support:Allwinner A10` (Cortex-A8)
- :ref:`introduction/detailed_support:Allwinner A64` (Cortex-A53)
- Broadcom
- :ref:`introduction/detailed_support:Broadcom BCM2708` (ARM1176JZ)
- Espressif
- :ref:`introduction/detailed_support:Xtensa LX6 ESP32` (Dual Xtensa LX6)
- :ref:`introduction/detailed_support:Xtensa LX7 ESP32-S2` (Single Xtensa LX7)
- :ref:`introduction/detailed_support:Xtensa LX7 ESP32-S3` (Dual Xtensa LX7)
- :ref:`introduction/detailed_support:ESP32-C3` (RISC-V)
- Host PC based simulations
- :ref:`introduction/detailed_support:Linux User Mode Simulation`
- Infineon
- :ref:`introduction/detailed_support:Infineon XMC45xx`
- Intel
- :ref:`introduction/detailed_support:Intel 80x86`
- Maxim Integrated
- :ref:`introduction/detailed_support:Maxim Integrated MAX32660` (ARM Cortex-M3)
- Microchip
- :ref:`introduction/detailed_support:Microchip PIC32MX2xx` (MIPS32 M4K)
- :ref:`introduction/detailed_support:Microchip PIC32MX4xx` (MIPS32 M4K)
- :ref:`introduction/detailed_support:Microchip PIC32MX7xx` (MIPS32 M4K)
- :ref:`introduction/detailed_support:Microchip PIC32MZEC` (MIPS32 microAptiv)
- :ref:`introduction/detailed_support:Microchip PIC32MZEF` (MIPS32 M5150)
- Microchip (Formerly Atmel)
- :ref:`introduction/detailed_support:AVR ATMega128` (8-bit AVR)
- :ref:`introduction/detailed_support:AVR ATMega1284p` (8-bit AVR)
- :ref:`introduction/detailed_support:AVR ATMega2560` (8-bit AVR)
- :ref:`introduction/detailed_support:AVR AT90USB64x and AT90USB6128x` (8-bit AVR)
- :ref:`introduction/detailed_support:Microchip AVR32` (AT32UC3BXXX, 32-bit AVR32)
- :ref:`introduction/detailed_support:Microchip SAMD20` (ARM Cortex-M0+)
- :ref:`introduction/detailed_support:Microchip SAMD21` (ARM Cortex-M0+)
- :ref:`introduction/detailed_support:Microchip SAML21` (ARM Cortex-M0+)
- :ref:`introduction/detailed_support:Microchip SAM3U` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:Microchip SAM3X` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:Microchip SAM4CM` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:Microchip SAM4E` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:Microchip SAM4L` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:Microchip SAM4S` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:Microchip SAMD5x/E5x` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:Microchip SAME70` (ARM Cortex-M7)
- :ref:`introduction/detailed_support:Microchip SAMV71` (ARM Cortex-M7)
- :ref:`introduction/detailed_support:Microchip SAMA5D2` (ARM Cortex-A5)
- :ref:`introduction/detailed_support:Microchip SAMA5D3` (ARM Cortex-A5)
- :ref:`introduction/detailed_support:Microchip SAMA5D4` (ARM Cortex-A5)
- Moxa
- :ref:`introduction/detailed_support:Moxa NP51x0` (ARMv4)
- nuvoTon
- :ref:`introduction/detailed_support:nuvoTon NUC120` (ARM Cortex-M0)
- Nordic Semiconductor
- :ref:`introduction/detailed_support:Nordic Semiconductor NRF52xxx` (ARM Cortex-M4)
- NXP/Freescale
- :ref:`introduction/detailed_support:Freescale M68HCS12`
- :ref:`introduction/detailed_support:NXP/Freescale i.MX1` (ARM920-T)
- :ref:`introduction/detailed_support:NXP/Freescale i.MX6` (ARM Cortex-A9)
- :ref:`introduction/detailed_support:NXP/Freescale i.MX RT` (ARM Cortex-M7)
- :ref:`introduction/detailed_support:NXP/FreeScale KL25Z` (ARM Cortex-M0+)
- :ref:`introduction/detailed_support:NXP/FreeScale KL26Z` (ARM Cortex-M0+)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K20` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K28F` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K40` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K60` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K64` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP/FreeScale Kinetis K66` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP LPC11xx` (Cortex-M0)
- :ref:`introduction/detailed_support:NXP LPC214x` (ARM7TDMI)
- :ref:`introduction/detailed_support:NXP LPC2378` (ARM7TDMI)
- :ref:`introduction/detailed_support:NXP LPC3131` (ARM9E6JS)
- :ref:`introduction/detailed_support:NXP LPC315x` (ARM9E6JS)
- :ref:`introduction/detailed_support:NXP LPC176x` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:NXP LPC178x` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:NXP LPC40xx` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP LPC43xx` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP LPC54xx` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:NXP S32K11x` (Cortex-M0+)
- :ref:`introduction/detailed_support:NXP S32K14x` (Cortex-M4F)
-
- ON Semiconductor:
- :ref:`introduction/detailed_support:On Semiconductor LC823450` (Dual core ARM Cortex-M3)
- Renesas/Hitachi:
- :ref:`introduction/detailed_support:Renesas/Hitachi SuperH`
- :ref:`introduction/detailed_support:Renesas M16C/26`
- :ref:`introduction/detailed_support:Renesas RX65N`
- Silicon Laboratories, Inc.
- :ref:`introduction/detailed_support:SiLabs EFM32 Gecko` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:SiLabs EFM32 Giant Gecko` (ARM Cortex-M3)
- Sony.
- :ref:`introduction/detailed_support:Sony CXD56xx` (6 x ARM Cortex-M4)
- STMicroelectronics
- :ref:`introduction/detailed_support:STMicro STR71x` (ARM7TDMI)
- :ref:`introduction/detailed_support:STMicro STM32 F0xx` (STM32 F0, ARM Cortex-M0)
- :ref:`introduction/detailed_support:STMicro STM32 L0xx` (STM32 L0, ARM Cortex-M0)
- :ref:`introduction/detailed_support:STMicro STM32 G0xx` (STM32 G0, ARM Cortex-M0+)
- :ref:`introduction/detailed_support:STMicro STM32 L152` (STM32 L1 "EnergyLite" Line, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 L15x/16x` (STM32 L1 "EnergyLite" Medium+ Density, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F100x` (STM32 F1 "Value Line" Family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F102x` (STM32 F1 family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F103C4/C8` (STM32 F1 "Low- and Medium-Density Line" Family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F103x` (STM32 F1 family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F105x` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F107x` (STM32 F1 family, "Connectivity Line" ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F205x` (STM32 F2 family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F207x` (STM32 F2 family, ARM Cortex-M3)
- :ref:`introduction/detailed_support:STMicro STM32 F302x` (STM32 F3 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F303x` (STM32 F3 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F334` (STM32 F3 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F372/F373` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F4x1` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F405x/407x` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F427/F437` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F429` (STM32 FB family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F433` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F446` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F46xx` (STM32 F4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 G474x` (STM32 G4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 G431x` (STM32 G4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 L4x2` (STM32 L4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 L475` (STM32 L4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 L476` (STM32 L4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 L496` (STM32 L4 family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 L4Rx` (STM32 LB family, ARM Cortex-M4)
- :ref:`introduction/detailed_support:STMicro STM32 F72x/F73x` (STM32 F7 family, ARM Cortex-M7)
- :ref:`introduction/detailed_support:STMicro STM32 F745/F746` (STM32 F7 family, ARM Cortex-M7)
- :ref:`introduction/detailed_support:STMicro STM32 F756` (STM32 F7 family, ARM Cortex-M7)
- :ref:`introduction/detailed_support:STMicro STM32 F76xx/F77xx` (STM32 F7 family, ARM Cortex-M7)
- :ref:`introduction/detailed_support:STMicro STM32 H7x3` (STM32 H7 family, ARM Cortex-M7)
-
- Texas Instruments (some formerly Luminary)
- :ref:`introduction/detailed_support:TI TMS320-C5471` (ARM7TDMI)
- :ref:`introduction/detailed_support:TI TMS320-DM320` (ARM9E6JS)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S6432` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S6432S2E` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S6918` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S6965` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S8962` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S9B92` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM3S9B96` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/SimpleLink CC13x0` (ARM Cortex-M3)
- :ref:`introduction/detailed_support:TI/Stellaris LM4F120x` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/Tiva TM4C123G` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/Tiva TM4C1294` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/Tiva TM4C129E` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/Tiva TM4C129X` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/SimpleLink CC13x2` (ARM Cortex-M4)
- :ref:`introduction/detailed_support:TI/Hercules TMS570LS04xx` (ARM Cortex-R4)
- :ref:`introduction/detailed_support:TI/Hercules TMS570LS31xx` (ARM Cortex-R4)
- :ref:`introduction/detailed_support:TI/Sitara AM335x` (Cortex-A8)
- ZiLOG
- :ref:`introduction/detailed_support:ZiLOG ZNEO Z16F`
- :ref:`introduction/detailed_support:ZiLOG eZ80 Acclaim!`
- :ref:`introduction/detailed_support:ZiLOG Z8Encore!`
- :ref:`introduction/detailed_support:ZiLOG Z180`
- :ref:`introduction/detailed_support:ZiLOG Z80`

23
Documentation/platforms/arm/a1x/index.rst Normal file
View File

@ -0,0 +1,23 @@
=============
Allwinner A10
=============
These following boards are based on the Allwinner A10
have are supported by NuttX:
- **pcDuino v1**. A port of NuttX to the pcDuino v1 board was first
released in NuttX-6.33. See http://www.pcduino.com/ for information
about pcDuino Lite, v1, and v2 boards. These boards are based around
the Allwinner A10 Cortex-A8 CPU. This port was developed on the v1
board, but the others may be compatible:
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/a1x/pcduino-a10/README.txt>`__
file for further information.
**STATUS**. This port was an experiment was was not completely
developed. This configuration builds and runs an NuttShell (NSH), but
only if a patch to work around some issues is applied. While not
ready for "prime time", the pcDuino port is functional and could the
basis for a more extensive development. There is, at present, no work
in progress to extend this port, however.

24
Documentation/platforms/arm/am335x/index.rst Normal file
View File

@ -0,0 +1,24 @@
================
TI/Sitara AM335x
================
These following boards are based on the TI/Sitara
AM335x are supported by NuttX:
- **Beaglebone Black**. A port of NuttX to the Beaglebone Black board
was first released in NuttX-7.28. This port was contributed by Petro
Karashchenko. This board is based on the TI/Sitara AM3358 Cortex-A8
CPU running 1GHz.
- **NuttX-7.28**. This initial port in NuttX-7.28 is very sparse.
While not ready for prodcution use, the Beaglebone Black port is
functional and will be the basis for a more extensive development.
Additional work in progress to extend this port and more capable
is anticipated in NuttX-7.29.
- **NuttX-9.0** CAN support was added. Clock Configuration was
added.
- **NuttX-7.31**. An LCD driver was added in NuttX-7.31.
Refer to the Beaglebone Black board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/am335x/beaglebone-black/README.txt>`__
file for further, up-to-date information.

3
Documentation/platforms/arm/at32/index.rst Normal file
View File

@ -0,0 +1,3 @@
===========
Artery AT32
===========

17
Documentation/platforms/arm/bcm2708/index.rst Normal file
View File

@ -0,0 +1,17 @@
==========================
Broadcom BCM2708 (removed)
==========================
Very basic support for the Broadcom BCM2708 was released with NuttX-7.23.
Raspberry Pi Zero. This support was provided for the Raspberry Pi Zero
which is based on the BCM2835. Basic logic is in place but the port is
incomplete and completely untested as of the NuttX-7.23 released. Refer
to the NuttX board
`README <https://bitbucket.org/patacongo/obsoleted/src/master/nuttx/boards/pizero/README.txt>`__
file for further information.
**Obsoleted:**: Support for the Raspberry Pi Zero was never completed.
The incomplete port along with all support for the BCM2708 was removed
from the repository with the NuttX-7.28 release but can still be be
found in the *Obsoleted* repository.

9
Documentation/platforms/arm/c5471/index.rst Normal file
View File

@ -0,0 +1,9 @@
===============
TI TMS320-C5471
===============
(also called **C5471** or **TMS320DA180** or **DA180**)
NuttX operates on the ARM7 of this dual core processor. This port uses
the `Spectrum Digital <http://www.spectrumdigital.com/>`__ evaluation
board with a GNU arm-nuttx-elf toolchain\* under Linux or Cygwin.

48
Documentation/platforms/arm/cxd56xx/index.rst Normal file
View File

@ -0,0 +1,48 @@
============
Sony CXD56xx
============
(6 x ARM Cortex-M4)
Support for the CXD56\ *xx* was
introduced by Nobuto Kobayashi in NuttX-7.30.
**Sony Spresence**. Spresense is a compact development board based on
Sony’s power-efficient multicore microcontroller CXD5602. Basic support
for the Sony Spresense board was included in the contribution of Nobuto
Kobayashi in NuttX-7.30. *NOTE*: That was an initial, bare bones basic
Spresense port sufficient for running a NuttShell (NSH) and should not
be confused with the full Spresence SDK offered from Sony. Since then
there has been much development of the NuttX CXD56xx port.
**Features:**
- Integrated GPS: Embedded GNSS with support for GPS, QZSS.
- Hi-res audio output and multi mic inputs" Advanced 192kHz/24 bit
audio codec and amplifier for audio output, and support for up to 8
mic input channels.
- Multicore microcontroller: Spresense is powered by Sony's CXD5602
microcontroller (ARM® Cortex®-M4F × 6 cores), with a clock speed of
156 MHz.
**Driver Status:**
**NuttX-3.31**. In this release, many new architectural features,
peripheral drivers, and board configurations were contributed primarily
through the work of Alin Jerpelea. These new architectural features
include: Inter-core communications, power management, and clock
management. New drivers include: GPIO, PMIC, USB, SDHC, SPI, I2C, DMA,
RTC, PWM, Timers, Watchdog Timer, UID, SCU, ADC, eMMC, Camera CISIF,
GNSS, and others.
**NuttX-8.1**. Alin Jerpelea brought in ten (external) sensor drivers
that integrate through the CXD56xx's SCU.
**NuttX-8.2**. Masayuki Ishikawa implemented SMP operation of the
CX56Dxx parts. Alin Jerpelea: Added support for the Altair LTE modem
support, enabled support for accelerated format converter, rotation and
so on using the CXD5602 image processing accelerator, added ISX012
camera support, added audio and board audio control implementation,
added an audio_tone_generator, added optional initialization of GNSS and
GEOFENCE at boot if the drivers are enabled, added an lcd examples
configuration.

10
Documentation/platforms/arm/dm320/index.rst Normal file
View File

@ -0,0 +1,10 @@
===============
TI TMS320-DM320
===============
(also called **DM320**)
NuttX operates on the ARM9 of
this dual core processor. This port uses the Neuros OSD
with a GNU arm-nuttx-elf toolchain\* under Linux or Cygwin. The port was
performed using the OSD v1.0, development board.

93
Documentation/platforms/arm/efm32/index.rst Normal file
View File

@ -0,0 +1,93 @@
============
SiLabs EFM32
============
SiLabs EFM32 Gecko
------------------
This is a port for the Silicon Laboratories' EFM32
*Gecko* family. Board support is available for the following:
#. **SiLabs EFM32 Gecko Starter Kit (EFM32-G8XX-STK)**. The Gecko
Starter Kit features:
- EFM32G890F128 MCU with 128 kB flash and 16 kB RAM
- 32.768 kHz crystal (LXFO) and 32 MHz crystal (HXFO)
- Advanced Energy Monitoring
- Touch slider
- 4x40 LCD
- 4 User LEDs
- 2 pushbutton switches
- Reset button and a switch to disconnect the battery.
- On-board SEGGER J-Link USB emulator
- ARM 20 pin JTAG/SWD standard Debug in/out connector
**STATUS**. The basic port is verified and available now. This
includes on-board LED and button support and a serial console
available on LEUART0. A single configuration is available using the
NuttShell NSH and the LEUART0 serial console. DMA and USART-based SPI
supported are included, but not fully tested.
Refer to the EFM32 Gecko Starter Kit
`README.txt <https://github.com/apache/nuttx/blob/master/boards/arm/efm32/efm32-g8xx-stk/README.txt>`__
file for further information.
#. **Olimex EFM32G880F120-STK**. This board features:
- EFM32G880F128 with 128 kB flash and 16 kB RAM
- 32.768 kHz crystal (LXFO) and 32 MHz crystal (HXFO)
- LCD custom display
- DEBUG connector with ARM 2x10 pin layout for programming/debugging
with ARM-JTAG-EW
- UEXT connector
- EXT extension connector
- RS232 connector and driver
- Four user buttons
- Buzzer
**STATUS**. The board support is complete but untested because of
tool-related issues. An OpenOCD compatible, SWD debugger would be
required to make further progress in testing.
Refer to the Olimex EFM32G880F120-STK
`README.txt <https://github.com/apache/nuttx/blob/master/boards/arm/efm32/olimex-efm32g880f128-stk/README.txt>`__
for further information.
SiLabs EFM32 Giant Gecko
------------------------
This is a port for the Silicon Laboratories'
EFM32 *Giant Gecko* family. This board features the EFM32GG990F1024 MCU
with 1 MB flash and 128 kB RAM.
Board support is available for the following:
- **SiLabs EFM32 Giant Gecko Starter Kit t (EFM32GG-STK3700)**. The
Gecko Starter Kit features:
- EFM32GG990F1024 MCU with 1 MB flash and 128 kB RAM
- 32.768 kHz crystal (LXFO) and 48 MHz crystal (HXFO)
- 32 MB NAND flash
- Advanced Energy Monitoring
- Touch slider
- 8x20 LCD
- 2 user LEDs
- 2 user buttons
- USB interface for Host/Device/OTG
- Ambient light sensor and inductive-capacitive metal sensor
- EFM32 OPAMP footprint
- 20 pin expansion header
- Breakout pads for easy access to I/O pins
- Power sources (USB and CR2032 battery)
- Backup Capacitor for RTC mode
- Integrated Segger J-Link USB debugger/emulator
**STATUS**.
- The basic board support for the *Giant Gecko* was introduced int
the NuttX source tree in NuttX-7.6. A verified configuration was
available for the basic NuttShell (NSH) using LEUART0 for the
serial console.
- Development of USB support is in started, but never completed.
- Reset Management Unit (RMU) was added Pierre-noel Bouteville in
NuttX-7.7.

2
Documentation/platforms/arm/fvp-v8r-aarch32/index.rst Normal file
View File

@ -0,0 +1,2 @@
FVP ARMv8-R Virt Chip
=====================

7
Documentation/platforms/arm/imx1/index.rst Normal file
View File

@ -0,0 +1,7 @@
===================
NXP/Freescale i.MX1
===================
Or MC9328MX1 – This port uses the Freescale MX1ADS
development board with a GNU arm-nuttx-elf toolchain\* under either
Linux or Cygwin.

22
Documentation/platforms/arm/imx6/index.rst Normal file
View File

@ -0,0 +1,22 @@
===================
NXP/Freescale i.MX6
===================
The basic port has been completed for the following i.MX6 board:
- **Sabre-6Quad**. This is a port to the NXP/Freescale Sabre-6Quad
board. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/imx6/sabre-6quad/README.txt>`__
file for further information.
**STATUS:** The basic, minimal port is code complete and introduced
in NuttX-7.15, but had not yet been tested at that time due to the
inavailability of hardware. This basic port was verified in the
NuttX-7.16 release, however. The port is still minimal and more
device drivers are needed to make the port usable.
Basic support of NuttX running in SMP mode on the i.MX6Q was also
accomplished in NuttX-7.16. However, there are still known issues
with SMP support on this platform as described in the
`README <https://github.com/apache/nuttx/blob/master/boards/arm/imx6/sabre-6quad/README.txt>`__
file for the board.

104
Documentation/platforms/arm/kinetis/index.rst Normal file
View File

@ -0,0 +1,104 @@
=====================
NXP/FreeScale Kinetis
=====================
NXP/FreeScale Kinetis K20
-------------------------
Used by Teensy-3.x. Architecture support (only) was
added in NuttX-7.10. This support was taken from PX4 and is the work of
Jakob Odersky. Support was added for the PJRC Teensy-3.1 board in
NuttX-7.11. Backward compatible support for the Teensy-3.0 is included.
NXP/FreeScale Kinetis K28F
--------------------------
Use by Freedom-K28F. Architecture support for the
Kinetis K28F along with board support for the Freedom-K28F was added in
NuttX-7.15. The Freedom-K28F board is based on the Kinetis
MK28FN2M0VMI15 MCU (ARM Cortex-M4 at150 MHz, 1 MB SRAM, 2 MB flash, HS
and FS USB, 169 MAPBGA package). More information is available from the
`NXP
website <https://www.nxp.com/support/developer-resources/hardware-development-tools/freedom-development-boards/mcu-boards/nxp-freedom-development-board-for-kinetis-k27-and-k28-mcus:FRDM-K28F>`__.
NXP/FreeScale Kinetis K40
-------------------------
This port uses the Freescale Kinetis KwikStik
K40. Refer to the `Freescale web
site <http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=KWIKSTIK-K40>`__
for further information about this board. The Kwikstik is used with the
FreeScale Tower System (mostly just to provide a simple UART connection)
NXP/FreeScale Kinetis K60
-------------------------
This port uses the **Freescale Kinetis
TWR-K60N512** tower system. Refer to the `Freescale web
site <http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=TWR-K60N512-KIT>`__
for further information about this board. The TWR-K60N51 includes with
the FreeScale Tower System which provides (among other things) a DBP
UART connection.
**MK60N512VLL100**. Architecture support for the MK60N512VLL100 was
contributed by Andrew Webster in NuttX-7.14.
NXP/FreeScale Kinetis K64
-------------------------
Support for the Kinetis K64 family and
specifically for the **NXP/Freescale Freedom K64F** board was added in
NuttX 7.17. Initial release includes two NSH configurations with support
for on-board LEDs, buttons, and Ethernet with the on-board KSZ8081 PHY.
SDHC supported has been integrated, but not verified. Refer to the NuttX
board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/kinetis/freedom-k64f/README.txt>`__
file for further information.
**MK64FN1M0VMD12**. Architecture support for the \_MK64FN1M0VMD12 was
contributed by Maciej Skrzypek in NuttX-7.20.
**NXP/Freescale Kinetis TWR-K64F120M**. Support for the Freescale
Kinetis TWR-K64F120M was contributed in NuttX-7.20 by Maciej Skrzypek.
Refer to the `Freescale web
site <http://www.nxp.com/products/sensors/accelerometers/3-axis-accelerometers/kinetis-k64-mcu-tower-system-module:TWR-K64F120M>`__
for further information about this board. The board may be complemented
by
`TWR-SER <http://www.nxp.com/pages/serial-usb-ethernet-can-rs232-485-tower-system-module:TWR-SER>`__
which includes (among other things), an RS232 and Ethernet connections.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/kinetis/twr-k64f120m/README.txt>`__
file for further information.
**Driver Status**.
- **NuttX-6.8**. Ethernet and SD card (SDHC) drivers also exist: The
SDHC driver is partially integrated in to the NSH configuration but
has some outstanding issues. Additional work remaining includes: (1)
integrate th SDHC drivers, and (2) develop support for USB host and
device. NOTE: Most of these remaining tasks are the same as the
pending K40 tasks described above.
- **NuttX-7.14**. The Ethernet driver became stable in NuttX-7.14
thanks to the efforts of Andrew Webster.
- **NuttX-7.17**. Ethernet support was extended and verified on the
Freedom K64F. A Kinetis USB device controller driver and PWM support
was contributed by kfazz.
NXP/FreeScale Kinetis K66
-------------------------
Support for the Kinetis K64 family and
specifically for the **NXP/Freescale Freedom K66F** board was
contributed by David Sidrane in NuttX 7.20. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/kinetis/freedom-k66f/README.txt>`__
file for further information.
**Driver Status**.
- Most K6x drivers are compatible with the K66.
- **NuttX-7.20**. David Sidrane also contributed support for a serial
driver on the K66's LPUART.
- **NuttX-7.22**. David Sidrane contributed improvements to the USB and
I2C device drivers, RTC alarm functionality, and new SPI driver.
- **NuttX-7.26**. David Sidrane contributed DMA support to the Kinetis
K6x family.

30
Documentation/platforms/arm/kl/index.rst Normal file
View File

@ -0,0 +1,30 @@
==================
NXP/FreeScale KLxx
==================
NXP/FreeScale KL25Z
-------------------
There are two board ports for the KL25Z parts:
**Freedom KL25Z**. This is a port of NuttX to the Freedom KL25Z board
that features the MKL25Z128 Cortex-M0+ MCU, 128KB of FLASH and 16KB of
SRAM. See the
`Freescale <http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=FRDM-KL25Z&tid=vanFRDM-KL25Z>`__
website for further information about this board.
**PJRC Teensy-LC**. This is a port of NuttX to the PJRC Teensy-LC board
that features the MKL25Z64 Cortex-M0+ MCU, 64KB of FLASH and 8KB of
SRAM. The Teensy LC is a DIP style breakout board for the MKL25Z64 and
comes with a USB based bootloader. See the
`Freescale <http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=FRDM-KL25Z&tid=vanFRDM-KL25Z>`__
website for further information about this board.
NXP/FreeScale KL26Z
-------------------
This is a port of NuttX to the Freedom KL25Z
board that features the MK26Z128VLH4 Cortex-M0+ MCU, 128KB of FLASH and
16KB of SRAM. See the
`Freescale <http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=FRDM-KL26Z&tid=vanFRDM-KL26Z>`__
website for further information about this board.

40
Documentation/platforms/arm/lc823450/index.rst Normal file
View File

@ -0,0 +1,40 @@
=========================
ON Semiconductor LC823450
=========================
(Dual core ARM Cortex-M3). In NuttX-7.22,
Masayuki Ishikawa contributed support for both the LC823450 architecture
and for ON Semiconductor's **LC823450XGEVK board**:
The LC823450XGEVK is an audio processing system Evaluation Board Kit
used to demonstrate the LC823450. This part can record and playback,
and offers High-Resolution 32-bit & 192 kHz audio processing
capability. It is possible to cover most of the functions necessary
for a portable audio with only this LSI as follows. It has Dual CPU
and DSP with High processing capability, and internal 1656K-Byte
SRAM, which make it possible to implement large scale program. And it
has integrated analog functions (low-power Class D HP amplifier, PLL,
ADC etc.) so that PCB space and cost is reduced, and it has various
interface (USB, SD, SPI, UART, etc.) to make extensibility high. Also
it is provided with various function including SBC/AAC codec by DSP
and UART and ASRC (Asynchronous Sample Rate Converter) for Bluetooth®
audio. It is very small chip size in spite of the multi-funciton as
described above and it realizes the low power consumption. Therefore,
it is applicable to portable audio markets such as Wireless headsets
and will show high performance.
Further information about the LC823450XGEVK is available on from the the
`ON
Semiconductor <http://www.onsemi.com/PowerSolutions/evalBoard.do?id=LC823450XGEVK>`__
website as are LC823450 `related technical
documents <http://www.onsemi.com/PowerSolutions/supportDoc.do?type=AppNotes&rpn=LC823450>`__.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lc823450/lc823450-xgevk/README.txt>`__
file for details of the NuttX port.
This port is intended to test LC823450 features including SMP. Supported
peripherals include UART, TIMER, RTC, GPIO, DMA, I2C, SPI, LCD, eMMC,
and USB device. ADC, Watchdog, IPC2, and I2S support was added by
Masayuki Ishikawa in NuttX-7.23. Bluetooth, SPI, and *PROTECTED* build
support were added by Masayuki Ishikawa in NuttX-7.26. Support for for
SPI flash boot was added in NuttX-7.28.

169
Documentation/platforms/arm/lpc17xx/index.rst Normal file
View File

@ -0,0 +1,169 @@
===========
NXP LPC17xx
===========
NXP LPC176x
-----------
NXP LPC1766, LPC1768, and LPC1769. Drivers are available for CAN, DAC,
Ethernet, GPIO, GPIO interrupts, I2C, UARTs, SPI, SSP, USB host, and USB
device. Additional drivers for the RTC, ADC, DAC, Timers, PWM and MCPWM
were contributed by Max (himax) in NuttX-7.3. Verified LPC17xx
configurations are available for these boards:
- The Nucleus 2G board from `2G Engineering <http://www.2g-eng.com/>`__
(LPC1768),
- The mbed board from `mbed.org <http://mbed.org>`__ (LPC1768,
Contributed by Dave Marples), and
- The LPC1766-STK board from `Olimex <http://www.olimex.com/>`__
(LPC1766).
- The Embedded Artists base board with NXP LPCXpresso LPC1768.
- Zilogic's ZKIT-ARM-1769 board.
- The `Micromint <http://micromint.com/>`__ Lincoln60 board with an NXP
LPC1769.
- A version of the LPCXPresso LPC1768 board with special support for
the U-Blox model evaluation board.
- Support for the Keil MCB1700 was contributed by Alan Carvalho de
Assis in NuttX-7.23.
- Support for the NXP Semiconductors' PN5180 NFC Frontend Development
Kit was contributed by Michael Jung in NuttX-7.1. This board is based
on the NXP LPC1769 MCU.
The Nucleus 2G board, the mbed board, the LPCXpresso, and the MCB1700
all feature the NXP LPC1768 MCU; the Olimex LPC1766-STK board features
an LPC1766. All use a GNU arm-nuttx-elf or arm-eabi toolchain\* under
either Linux or Cygwin (with native Windows GNU tools or Cygwin-based
GNU tools).
**STATUS:** The following summarizes the features that has been
developed and verified on individual LPC17xx-based boards. These
features should, however, be common and available for all LPC17xx-based
boards.
#. **Nucleus2G LPC1768**
- Some initial files for the LPC17xx family were released in NuttX
5.6, but
- The first functional release for the NXP LPC1768/Nucleus2G
occurred with NuttX 5.7 with Some additional enhancements through
NuttX-5.9. Refer to the NuttX board
`README <https://bitbucket.org/patacongo/obsoleted/src/master/configs/nucleus2g/README.txt>`__
file for further information.
That initial, 5.6, basic release included *timer* interrupts and a
*serial console* and was verified using the NuttX OS test
(``apps/examples/ostest``). Configurations available include include
a verified NuttShell (NSH) configuration (see :ref:`NSH <nsh>`). The
NSH configuration supports the Nucleus2G's microSD slot and
additional configurations are available to exercise the USB serial
and USB mass storage devices. However, due to some technical reasons,
neither the SPI nor the USB device drivers are fully verified.
(Although they have since been verified on other platforms; this
needs to be revisited on the Nucleus2G).
**Obsoleted**. Support for the Nucleus2G board was terminated on
2016-04-12. There has not been any activity with the commercial board
in a few years and it no longer appears to be available from the
2g-eng.com website. Since the board is commercial and no longer
publicly available, it no longer qualifies for inclusion in the open
source repositories. A snapshot of the code is still available in the
`Obsoleted
repository <https://bitbucket.org/patacongo/obsoleted/src/master/boards/nucleus2g>`__
and can easily be *reconstitued* if needed.
#. **mbed LPC1768**
- Support for the mbed board was contributed by Dave Marples and
released in NuttX-5.11. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/mbed/README.txt>`__
file for further information.
#. **Olimex LPC1766-STK**
- Support for that Olimex-LPC1766-STK board was added to NuttX 5.13.
- The NuttX-5.14 release extended that support with an *Ethernet
driver*.
- The NuttX-5.15 release further extended the support with a
functional *USB device driver* and *SPI-based micro-SD*.
- The NuttX-5.16 release added a functional *USB host controller
driver* and *USB host mass storage class driver*.
- The NuttX-5.17 released added support for low-speed USB devices,
interrupt endpoints, and a *USB host HID keyboard class driver*.
- Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/olimex-lpc1766stk/README.txt>`__
file for further information.
Verified configurations are now available for the NuttShell with
networking and microSD support(NSH, see :ref:`NSH <nsh>`), for
the NuttX network test, for the
`THTTPD <http://acme.com/software/thttpd>`__ webserver, for USB
serial deive and USB storage devices examples, and for the USB host
HID keyboard driver. Support for the USB host mass storage device can
optionally be configured for the NSH example. A driver for the *Nokia
6100 LCD* and an NX graphics configuration for the Olimex LPC1766-STK
have been added. However, neither the LCD driver nor the NX
configuration have been verified as of the NuttX-5.17 release.
#. **Embedded Artists base board with NXP LPCXpresso LPC1768**
An fully verified board configuration is included in NuttX-6.2. The
Code Red toolchain is supported under either Linux or Windows.
Verified configurations include DHCPD, the NuttShell (NSH), NuttX
graphis (NX), THTTPD, and USB mass storage device. Refer to the NuttX
board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/lpcxpresso-lpc1768/README.txt>`__
file for further information.
#. **Zilogic's ZKIT-ARM-1769 board**
Zilogic System's ARM development Kit, ZKIT-ARM-1769. This board is
based on the NXP LPC1769. The initial release was included
NuttX-6.26. The NuttX Buildroot toolchain is used by default. Verifed
configurations include the "Hello, World!" example application and a
THTTPD demonstration. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/zkit-arm-1769/README.txt>`__
file for further information.
#. **Micromint Lincoln60 board with an NXP LPC1769**
This board configuration was contributed and made available in
NuttX-6.20. As contributed board support, I am unsure of what all has
been verfied and what has not. See the Microment website
and the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/lincoln60/README.txt>`__
file for further information about the Lincoln board.
#. **U-Blox Modem Evaluation (LPCXpresso LPC1768)**
This board configuration was contributed by Vladimir Komendantskiy
and made available in NuttX-7.15. This is a variant of the LPCXpresso
LPC1768 board support with special provisions for the U-Blox Model
Evaluation board. See the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc17xx_40xx/u-blox-c027/README.txt>`__
file for further information about this port.
#. **Keil MCB1700 (LPC1768)**
This board configuration was contributed by Alan Carvalho de Assis in
NuttX-7.23.
#. **PN5180 NFC Frontend Development Kit**
This board configuration was contributed by Michael Jung in
NuttX-7.31.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain (CodeSourcery devkitARM or Code Red), or 4) Native
Windows. A DIY toolchain for Linux or Cygwin is provided by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package.
NXP LPC178x
-----------
The port of NuttX to the WaveShare Open1788 is a
collaborative effort between Rommel Marcelo and myself (with Rommel
being the leading contributor and I claiming only a support role). You
can get more information at the Open1788 board from the WaveShare
website.

9
Documentation/platforms/arm/lpc214x/index.rst Normal file
View File

@ -0,0 +1,9 @@
===========
NXP LPC214x
===========
Support is provided for the NXP LPC214x family of
processors. In particular, support is provided for (1) the mcu123.com
lpc214x evaluation board (LPC2148) and (1) the The0.net ZPA213X/4XPA
development board (with the The0.net UG-2864AMBAG01 OLED) This port also
used the GNU arm-nuttx-elf toolchain\* under Linux or Cygwin.

9
Documentation/platforms/arm/lpc2378/index.rst Normal file
View File

@ -0,0 +1,9 @@
===========
NXP LPC2378
===========
Support is provided for the NXP LPC2378 MCU. In particular,
support is provided for the Olimex-LPC2378 development board. This port
was contributed by Rommel Marcelo is was first released in NuttX-5.3.
This port also used the GNU arm-nuttx-elf toolchain\* under Linux or
Cygwin.

14
Documentation/platforms/arm/lpc40xx/index.rst Normal file
View File

@ -0,0 +1,14 @@
===========
NXP LPC40xx
===========
The LPC40xx family is very similar to the LPC17xx family
except that it features a Cortex-M4F versus the LPC17xx's Cortex-M3.
Architectural support for the LPC40xx family was built on top of the
existing LPC17xx by jjlange in NuttX-7.31. With that architectural
support came support for two boards also contributed by jjlange:
**LX CPU**. Pavel Pisa add support for the PiKRON LX CPU board. This
board may be configured to use either the LPC4088 or the LPC1788.
**Driver Status.**

106
Documentation/platforms/arm/lpc43xx/index.rst Normal file
View File

@ -0,0 +1,106 @@
===========
NXP LPC43xx
===========
Several board ports are available for this higher end, NXP
Cortex-M4F part:
**NXG Technologies LPC4330-Xplorer**. This NuttX port is for the
LPC4330-Xplorer board from NGX Technologies featuring the NXP
LPC4330FET100 MCU. See the `NXG
website <http://shop.ngxtechnologies.com/product_info.php?cPath=21_37&products_id=104>`__
for further information about this board.
- **STATUS:** Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc43xx/lpc4330-xplorer/README.txt>`__
file for more detailed information about this port.
- **NuttX-6.20** The basic LPC4330-Xplorer port is complete. The basic
NuttShell (NSH) configuration is present and fully verified. This
includes verified support for: SYSTICK system time, pin and GPIO
configuration, and a serial console.
**NXP/Embest LPC4357-EVB**. This NuttX port is for the LPC4357-EVB from
NXP/Embest featuring the NXP LPC4357FET256 MCU. The LPC4357 differs from
the LPC4330 primarily in that it includes 1024KiB of on-chip NOR FLASH.
See the `NXP
website <http://www.nxp.com/news/news-archive/2013/nxp-development-kit-based-on-the-dual-core-lpc4357-microcontroller.html>`__
for more detailed information about the LPC4357 and the LPC4357-EVB.
- **STATUS:** Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc43xx/lpc4357-evb/README.txt>`__
file for more detailed information about this port.
- **NuttX-7.6**. The basic port is was contributed by Toby Duckworth.
This port leverages from the LPC4330-Xplorer port (and, as of this
writing, still requires some clean up of the technical discussion in
some files). The basic NuttShell (NSH) configuration is present and
has been verified. Support is generally the same as for the
LPC4330-Xplorer as discussed above.
**NXP LPC4370-Link2**. This is the NuttX port to the NXP LPC4370-Link2
development board featuring the NXP LPC4370FET100 MCU.
- **STATUS:** Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc43xx/lpc4370-link2/README.txt>`__
file for more detailed information about this port.
- **NuttX-7.12** The NXP LPC4370-Link2 port is was contributed by Lok
Tep and first released in NuttX-7.12.
**WaveShare LPC4337-WS**. This is the NuttX port to the WaveShare
LPC4337-WS development board featuring the NXP LPC4337JBD144 MCU.
- **STATUS:** Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc43xx/lpc4337-ws/README.txt>`__
file for more detailed information about this port.
- **NuttX-7.14** The NXP WaveShare LPC4337-WS port is was contributed
by Lok Tep and first released in NuttX-7.14.
- **NuttX-7.16** Support for the LPC4337JET100 chip was contribed by
Alexander Vasiljev. Alexander also contributed an LPC43xx AES driver
available in NuttX-7.16.
**Driver Status**.
- **NuttX-6.20** Several drivers have been copied from the related
GPDMA, I2C, SPI, and SSP. The registers for these blocks are the same
in both the LPC43xx and the LPC17xx and they should integrate into
the LPC43xx very easily by simply adapting the clocking and pin
configuration logic.
Other LPC17xx drivers were not brought into the LPC43xx port because
these peripherals have been completely redesigned: CAN, Ethernet, USB
device, and USB host.
So then there is no support for the following LPC43xx peripherals:
SD/MMC, EMC, USB0,USB1, Ethernet, LCD, SCT, Timers 0-3, MCPWM, QEI,
Alarm timer, WWDT, RTC, Event monitor, and CAN.
Some of these can be leveraged from other MCUs that appear to support
the same peripheral IP:
- The LPC43xx USB0 peripheral appears to be the same as the USB OTG
peripheral for the LPC31xx. The LPC31xx USB0 device-side driver
has been copied from the LPC31xx port but also integration into
the LPC43xx (clocking and pin configuration). It should be
possible to complete porting of this LPC31xx driver with a small
porting effort.
- The Ethernet block looks to be based on the same IP as the STM32
Ethernet and, as a result, it should be possible to leverage the
NuttX STM32 Ethernet driver with a little more effort.
- **NuttX-6.21** Added support for a SPIFI block driver and for RS-485
option to the serial driver.
- **NuttX-7.17** EMC support was extended to include support SDRAM by
Vytautas Lukenska.
- **NuttX-7.23** A CAN driver was contributed by Alexander Vasiljev in
NuttX-7.23.
- **NuttX-7.24** RTC and Windowed Watchdog Timer (WWDT) drivers were
leveraged from the LPC17 and contributed by Gintaras Drukteinis.
Leveraged the LPC54xx SD/MMC to the LPC43xx. There are still
remaining issues with the SD/MMC driver and it is not yet functional.

27
Documentation/platforms/arm/lpc54xx/index.rst Normal file
View File

@ -0,0 +1,27 @@
===========
NXP LPC54xx
===========
A port to the
`LPCXpresso-LPC54628 <https://www.nxp.com/support/developer-resources/hardware-development-tools/lpcxpresso-boards/lpcxpresso54628-development-board:OM13098>`__
was added in NuttX-7.24. Initial configurations include: A basic NSH
configuration (nsh), a networking configuration (netnsh), and three
graphics configurations (nxwm, fb, and lvgl).
**LPC4508**. The port was verified on an LPC5408 by a NuttX user with
relevant changes incorporated in NuttX-7.26.
**Driver Status**.
- **NuttX-7.24** The initial release for the LPC54xx in NuttX included
the following drivers: UARTs, SysTick, SD/MMC, DMA, GPIO, GPIO
interrupts, LEDs and buttons, LCD, WWDT, RTC, RNG, Ethernet, and SPI.
The SPI driver is untested and there are known issues with the SD/MMC
driver, however.
- **NuttX-7.29** Configurations were added to verify the "Per-Window
Framebuffer" feature also added in NuttX-7.29.
Refer to the LPCXpresso-LPC54628 board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/lpc54xx/lpcxpresso-lpc54628/README.txt>`__
file for more detailed information about this port.

12
Documentation/platforms/arm/max326xx/index.rst Normal file
View File

@ -0,0 +1,12 @@
=========================
Maxim Integrated MAX32660
=========================
Architectural upport for the MAX32660 was added (along with partial
support for other members of the MAX326xx family) in NuttX 7.28.
**MAX32660-EVSYS**. Basic support for the Maxim Integrated MAC3X660
EVSYS was included in the NuttX-7.28 release. A basic NSH configuration
is available and is fully functional. Includes unverified support for an
SPI0-based SD card.

8
Documentation/platforms/arm/moxart/index.rst Normal file
View File

@ -0,0 +1,8 @@
===========
Moxa NP51x0
===========
A port to the Moxa NP51x0 series of 2-port advanced
RS-232/422/485 serial device servers was contributed by Anton D.
Kachalov in NuttX-7.11. This port includes :ref:`NSH <nsh>`
configuration with support for the Faraday FTMAC100 Ethernet MAC Driver.

40
Documentation/platforms/arm/nuc1xx/index.rst Normal file
View File

@ -0,0 +1,40 @@
==============
nuvoTon NUC120
==============
This is a port of NuttX to the nuvoTon NuTiny-SDK-NUC120
that features the NUC120LE3AN MCU.
**STATUS**. Initial support for the NUC120 was released in NuttX-6.26.
This initial support is very minimal: There is a NuttShell
(:ref:`NSH <nsh>`) configuration that might be the basis for an
application development. As of this writing, more device drivers are
needed to make this a more complete port. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/nuc1xx/nutiny-nuc120/README.txt>`__
file for further information.
**Memory Usage**. For a full-featured RTOS such as NuttX, providing
support in a usable and meaningful way within the tiny memories of the
NUC120 demonstrates the scalability of NuttX. The NUC120LE2AN comes in a
48-pin package and has 128KB FLASH and 16KB of SRAM. When running the
NSH configuration (itself a full up application), there is still more
than 90KB of FLASH and 10KB or SRAM available for further application
development).
Static memory usage can be shown with ``size`` command:
NuttX, the NSH application, and GCC libraries use 34.2KB of FLASH
leaving 93.8KB of FLASH (72%) free from additional application
development. Static SRAM usage is about 1.2KB (<4%) and leaves 14.8KB
(86%) available for heap at runtime. SRAM usage at run-time can be shown
with the NSH ``free`` command:
You can see that 10.0KB (62%) is available for further application
development.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain, or 4) Native Windows. A DIY toolchain for Linux or
Cygwin is provided by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package.

143
Documentation/platforms/arm/sam34/index.rst Normal file
View File

@ -0,0 +1,143 @@
===============
Microchip SAM34
===============
Microchip SAM3U
---------------
This port uses the `Microchip <http://www.atmel.com/>`__
SAM3U-EK development board that features the SAM3U4E MCU. This port uses
a GNU arm-nuttx-elf or arm-nuttx-eabi toolchain\* under either Linux or
Cygwin (with native Windows GNU tools or Cygwin-based GNU tools).
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain (CodeSourcery or devkitARM), or 4) Native Windows. A
DIY toolchain for inux or Cygwin is provided by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package.
Microchip SAM3X
---------------
There are two SAM3X boards supported:
#. The `Arduino <http://arduino.cc//>`__ Due development board that
features the ATSAM3X8E MCU running at 84MHz. See the `Arduino
Due <http://arduino.cc/en/Main/arduinoBoardDue>`__ page for more
information.
#. The Mikroelektronika `Flip&Click
SAM3X <https://www.mikroe.com/flip-n-click-sam3x>`__ development
board. This board is an Arduino Due *work-alike* with additional
support for 4 mikroBUS Click boards.
**Development Environments:** See the Microchip SAM3U discussion
`above. <#at91sam3u>`__
Microchip SAM4L
---------------
This port uses the Microchip SAM4L Xplained Pro development
board. This board features the ATSAM4LC4C MCU running at 48MHz with
256KB of FLASH and 32KB of internal SRAM.
**STATUS:** As of this writing, the basic port is code complete and a
fully verified configuration exists for the NuttShell
:ref:`NSH <nsh>`). The first
fully functional SAM4L Xplained Pro port was released in NuttX-6.28.
Support for the SAM4L Xplained modules was added in NuttX-6.29:
- Support for the SPI-based SD card on the I/O1 module.
- Driver for the LED1 segment LCD module.
- Support for the UG-2832HSWEG04 OLED on the SAM4L Xplained Pro's OLED1
module
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/sam34/sam4l-xplained/README.txt>`__
file for further information.
**Memory Usage**. The ATSAM4LC4C comes in a 100-pin package and has
256KB FLASH and 32KB of SRAM. Below is the current memory usage for the
NSH configuration (June 9, 2013). This is *not* a minimal
implementation, but a full-featured NSH configuration.
Static memory usage can be shown with ``size`` command:
NuttX, the NSH application, and GCC libraries use 42.6KB of FLASH
leaving 213.4B of FLASH (83.4%) free from additional application
development. Static SRAM usage is about 2.3KB (<7%) and leaves 29.7KB
(92.7%) available for heap at runtime.
SRAM usage at run-time can be shown with the NSH ``free`` command. This
runtime memory usage includes the static memory usage *plus* all dynamic
memory allocation for things like stacks and I/O buffers:
You can see that 22.8KB (71.1%) of the SRAM heap is still available for
further application development while NSH is running.
Microchip SAM4CM
----------------
General architectural support was provided for SAM4CM
family in NuttX 7.3 This was *architecture-only* support, meaning that
support for the boards with these chips is available, but no support for
any publicly available boards was included. The SAM4CM port should be
compatible with most of the SAM3/4 drivers (like HSMCI, DMAC, etc.) but
those have not be verified on hardware as of this writing. This support
was contributed in part by Max Neklyudov.
**Microchip SAM4CMP-DB**. Support for the SAM4CMP-DB board was contributed
to NuttX by Masayuki Ishikawa in NuttX-7.19. The SAM4CM is a dual-CPU
part and SMP was included for the ARMv7-M and SAM3/4 families. The
SAM4CMP-DB board support includes an NSH configuration that operates in
an SMP configuration. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/sam34/sam4cmp-db/README.txt>`__
file for further information.
Microchip SAM4E
---------------
General architectural support was provided for the SAM4E
family in NuttX 6.32. This was *architecture-only* support, meaning that
support for the boards with these chips is available, but no support for
any publicly available boards was included. This support was contributed
in part by Mitko.
**Microchip SAM4E-EK**. Board support was added for the SAM4E-EK development
board in NuttX 7.1. A fully functional NuttShell (NSH) configuration is
available (see :ref:`NSH <nsh>`). That NSH
configuration includes networking support and support for an AT25 Serial
FLASH file system.
Microchip SAM4S
---------------
There are ports to two Microchip SAM4S board:
- There is a port the Microchip SAM4S Xplained development board. This
board features the ATSAM4S16 MCU running at 120MHz with 1MB of FLASH
and 128KB of internal SRAM.
- There is also a port to the Microchip SAM4S Xplained *Pro* development
board. This board features the ATSAM4S32C MCU running at 120MHz with
2MB of FLASH and 160KB of internal SRAM.
Microchip SAM4E. General architectural support was provided for the SAM4E
family in NuttX 6.32. This was *architecture-only* support, meaning that
support for the boards with these chips is available, but no support for
any publicly available boards was included. This support was contributed
in part by Mitko.
**Microchip SAM4E-EK**. Board support was added for the SAM4E-EK development
board in NuttX 7.1. A fully functional NuttShell (NSH) configuration is
available (see :ref:`NSH <nsh>`). That NSH
configuration includes networking support and support for an AT25 Serial
FLASH file system.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU Cortex-M3 or 4 toolchain, 3) Cygwin/MSYS
with Windows native GNU Cortex-M3 or M4 toolchain (CodeSourcery or
devkitARM), or 4) Native Windows. A DIY toolchain for Linux or Cygwin is
provided by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package.

160
Documentation/platforms/arm/sama5/index.rst Normal file
View File

@ -0,0 +1,160 @@
===============
Microchip SAMA5
===============
Microchip SAMA5D2
-----------------
- **Microchip SAMA5D2 Xplained Ultra development board**. This is the port
of NuttX to the Microchip SAMA5D2 Xplained Ultra development board. This
board features the Microchip SAMA5D27 microprocessor.
See https://www.microchip.com/Developmenttools/ProductDetails/ATSAMA5D2C-XULT
- **Groboards Giant Board**. This is the port of NuttX to the Groboards
Giant Board board. This board features the Microchip SAMA5D27C-D1G.
See http://groboards.com/giant-board.
Microchip SAMA5D3
-----------------
There are ports to two Microchip SAMA5D3 boards:
- **Microchip SAMA5D3\ x-EK development boards**. This is the port of NuttX
to the Microchip SAMA5D3\ *x*-EK development boards (where *x*\ =1,3,4,
or 5). These boards feature the Microchip SAMA5D3\ *x* microprocessors.
Four different SAMA5D3\ *x*-EK kits are available
- SAMA5D31-EK with the
`ATSAMA5D31 <http://www.atmel.com/devices/sama5d31.aspx>`__
- SAMA5D33-EK with the
`ATSAMA5D33 <http://www.atmel.com/devices/sama5d33.aspx>`__
- SAMA5D34-EK with the
`ATSAMA5D34 <http://www.atmel.com/devices/sama5d34.aspx>`__
- SAMA5D35-EK with the
`ATSAMA5D35 <http://www.atmel.com/devices/sama5d35.aspx>`__
The each kit consist of an identical base board with different
plug-in modules for each CPU. All four boards are supported by NuttX
with a simple reconfiguration of the processor type.
**STATUS**. Initial support for the SAMA5D3x-EK was released in
NuttX-6.29. That initial support was minimal: There are simple test
configurations that run out of internal SRAM and extended
configurations that run out of the on-board NOR FLASH:
- A barebones NuttShell (:ref:`NSH <nsh>`) configuration
that can be used as the basis for further application development.
- A full-loaded NuttShell (:ref:`NSH <nsh>`) configuration
that demonstrates all of the SAMA5D3x features.
The following support was added in NuttX 6.30:
- DMA support, and
- PIO interrupts,
And drivers for
- SPI (with DMA support),
- AT25 Serial Flash,
- Two Wire Interface (TWI), and
- HSMCI memory cards.
NuttX-6.30 also introduces full USB support:
- High speed device controller driver,
- OHCI (low- and full-speed) and
- EHCI (high-speed) host controller driver support.
With NuttX-6.31, these additional drivers were added:
- A 10/100Base-T Ethernet (EMAC) driver,
- A 1000Base-T Ethernet (GMAC) driver,
- A Real Time Clock (RTC) driver and integrated with the NuttX
system time logic
- ``/dev/random`` using the SAMA5D3x True Random Number Generator
(TRNG),
- A Watchdog Timer (WDT) driver,
- A Timer/Counter (TC) library with interface that make be used by
other drivers that need timer support,
- An ADC driver that can collect multiple samples using the
sequencer, can be trigger by a timer/counter, and supports DMA
data transfers,
- A touchscreen driver based on the special features of the SAMA5D3
ADC peripheral, An LCD controller (LCDC) frame buffer driver, and
- A CAN driver (Testing of the CAN has been delayed because of
cabling issues).
Additional board configurations were added to test and demonstrate
these new drivers including new graphics and NxWM configurations.
These drivers were added in NuttX-6.32:
- A PWM driver with DMA support
- An SSC-based I2S driver
- Support for Programmable clock outputs
- NAND support including support for the PMECC hardware ECC and for
DMA transfers.
DBGU support was added in NuttX-7.2 (primarily for the SAMA5D3
Xplained board).
NuttX-7.4 added support for the on-board WM8904 CODEC chip and for
*Tickless* operation.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/sama5/sama5d3x-ek/README.txt>`__
file for further information.
**Microchip SAMA5D3 Xplained development board** This is the port of NuttX
to the Microchip SAMA5D3 Xplained development board. The board features the
Microchip SAMA5D36 microprocessor. See the `Microchip
Website <http://www.atmel.com/devices/sama5d36.aspx>`__ for additional
information about this board.
**STATUS**. This port is complete as of this writing and ready for
general use. The basic port is expected to be simple because of the
similarity to the SAMAD3\ *x*-EK boards and is available in the NuttX
7.2 release.
Most of the drivers and capabilities of the SAMA5D3x-EK boards can be
used with the SAMA5D3 Xplained board. The primary difference between the
ports is that the SAMA5D3x-EK supports NOR FLASH and NuttX can be
configured to boot directly from NOR FLASH. The SAMA5D3 Xplained board
does not have NOR FLASH and, as a consequence NuttX must boot into SDRAM
with the help of U-Boot.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/sama5/sama5d3-xplained/README.txt>`__
file for further information.
Microchip SAMA5D4
-----------------
There is a port in progress on one Microchip SAMA5D4 board:
- **Microchip SAMA5D4-EK/MB development boards** This is the port of NuttX
to the Microchip SAMA5D4-MB Rev C. development board (which should be
compatible with the SAMA5D4-EK). These boards feature the Microchip
SAMA5D44 microprocessors with compatibility with most of the SAMA5D3
peripherals.
**STATUS**. At the time of the release of NuttX-7.3, the basic port
for the SAMA5D4-MB was complete. The board had basic functionality.
But full functionality was not available until NuttX-7.4. In
NuttX-7.4 support was added for the L2 cache, many security features,
XDMAC, HSMCI and Ethernet integrated with XDMAC, the LCDC, TWI, SSC,
and most of the existing SAMA5 drivers. Timers were added to support
*Tickless* operation. The TM7000 LCDC with the maXTouch multi-touch
controller are also fully support in a special NxWM configuration for
that larger display. Support for a graphics media player is included
(although there were issues with the WM8904 audio CODEC on my board).
An SRAM bootloader was also included. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/sama5/sama5d4-ek/README.txt>`__
file for current status.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain, or 4) Native Windows. All testing has been performed
with the CodeSourcery toolchain (GCC version 4.7.3) in the Cygwin
environment under Windows.

28
Documentation/platforms/arm/samd2l2/index.rst Normal file
View File

@ -0,0 +1,28 @@
================
Microchip SAMD2x
================
Microchip SAMD20
----------------
The port of NuttX to the Microchip SAMD20-Xplained Pro
development board. This board features the ATSAMD20J18A MCU (Cortex-M0+
with 256KB of FLASH and 32KB of SRAM).
Microchip SAMD21
----------------
There two boards supported for the SAMD21:
#. The port of NuttX to the Microchip SAMD21-Xplained Pro development board
added in NuttX-7.11, and
#. The port of NuttX to the Arduino-M0 contributed by Alan Carvalho de
Assis in NuttX-8.2. The initial release included *nsh* and *usbnsh*
configurations.
Microchip SAML21
----------------
The port of NuttX to the Microchip SAML21-Xplained Pro
development board. This board features the ATSAML21J18A MCU (Cortex-M0+
with 256KB of FLASH and 32KB of SRAM).

6
Documentation/platforms/arm/samv7/index.rst
View File

@ -1,6 +1,6 @@
======
SAM V7
======
================
Microchip SAM V7
================
This page contains information regarding MCUs series SAM E70, SAM S70, SAM V70 and SAMV71 made
by Microchip. The series is based around and ARM Cortex-M7 core running up to 300 MHz.

8
Documentation/platforms/arm/str71x/index.rst Normal file
View File

@ -0,0 +1,8 @@
========
ST STR71
========
Support is provided for the STMicro STR71x family of
processors. In particular, support is provided for the Olimex STR-P711
evaluation board. This port also used the GNU arm-nuttx-elf toolchain\*
under Linux or Cygwin.

190
Documentation/platforms/arm/tiva/index.rst Normal file
View File

@ -0,0 +1,190 @@
=================
TI/Stellaris Tiva
=================
TI/Stellaris LM3S6432
---------------------
This is a port of NuttX to the Stellaris RDK-S2E
Reference Design Kit and the MDL-S2E Ethernet to Serial module
(contributed by Mike Smith).
TI/Stellaris LM3S6432S2E
------------------------
This port uses Serial-to-Ethernet Reference
Design Kit and has
similar support as for the other Stellaris family members. A
configuration is available for the NuttShell (NSH) (see :ref:`NSH <nsh>`). The NSH
configuration including networking support with a Telnet NSH console.
This port was contributed by Mike Smith.
TI/Stellaris LM3S6918
---------------------
This port uses the
`Micromint <http://www.micromint.com/>`__ Eagle-100 development board
with a GNU arm-nuttx-elf toolchain\* under either Linux or Cygwin.
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain (CodeSourcery or devkitARM), or 4) Native Windows. A
DIY toolchain for Linux or Cygwin is provided by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package.
TI/Stellaris LM3S6965
---------------------
This port uses the Stellaris LM3S6965 Ethernet
Evaluation Kit with a GNU arm-nuttx-elf toolchain\* under either Linux
or Cygwin.
**Development Environments:** See the Eagle-100 LM3S6918 above.
TI/Stellaris LM3S8962
---------------------
This port uses the Stellaris EKC-LM3S8962
Ethernet+CAN Evaluation Kit with a GNU arm-nuttx-elf toolchain\* under
either Linux or Cygwin. Contributed by Larry Arnold.
TI/Stellaris LM3S9B92
---------------------
Architectural support for the LM3S9B92 was
contributed by Lwazi Dube in NuttX 7.28. No board support for boards
using the LM3S9B92 are currently available.
TI/Stellaris LM3S9B96
---------------------
Header file support was contributed by Tiago
Maluta for this part. Jose Pablo Rojas V. is used those header file
changes to port NuttX to the TI/Stellaris EKK-LM3S9B96. That port was
available in the NuttX-6.20 release. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/tiva/ekk-lm3s9b96/README.txt>`__
file for further information.
TI/SimpleLink CC13x0
--------------------
Basic, unverified architectural support for the
CC13x0 was added in NuttX-7.28. This is a work in progress and, with any
luck, a fully verified port will be available in NuttX-7.29.
TI/Tiva TM4C123G
----------------
This port uses the Tiva C Series TM4C123G LaunchPad
Evaluation Kit
`(EK-TM4C123GXL) <http://www.ti.com/tool/ek-tm4c123gxl>`__.
**TI Tiva TM4C123H**. Architectural support for the Tiva TM4C123AH6PM
was contributed in NuttX-8.1 by Nathan Hartman.
**STATUS:**
- **NuttX-7.1**. Initial architectural support for the EK-TM4C123GXL
was implemented and was released in NuttX 7.1. Basic board support
the EK-TM4C123GXL was also included in that release but was not fully
tested. This basic board support included a configuration for the
NuttShell
:ref:`NSH <nsh>`).
- **NuttX-7.2**. The fully verified port to the EK-TM4C123GXL was
provided in NuttX-7.2.
- **NuttX-7.7**. An I2C driver was added in NuttX-7.7.
- **NuttX-8.1**. Along with TM4C123AH6PM support, Nathan Hartman also
reinstated and extended the Tiva Quadrature Encoder driver.
TI/Tiva TM4C1294
----------------
This port uses the TI Tiva C Series TM4C1294 Connected
LaunchPad `(EK-TM4C1294XL) <http://www.ti.com/tool/ek-tm4c1294xl>`__.
**STATUS:**
- Support for the EK-TM4C1294XL was contributed by Frank Sautter and
was released in NuttX 7.9. This basic board support included a
configuration for the NuttShell
:ref:`NSH <nsh>`) and a
configuration for testing IPv6. See drivers for the `TI Tiva
TM4C129X <#titm4c129x>`__.
- FLASH and EEPROM drivers from Shirshak Sengupta were included in
NuttX-7.25.
Refer to the EK-TM4C1294XL board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/tiva/tm4c1294-launchpad/README.txt>`__
file for more detailed information about this port.
TI/Tiva TM4C129E
----------------
This port uses the TI Tiva C Series TM4C129E Crypto Connected
LaunchPad `(EK-TM4C129EXL) <https://www.ti.com/tool/EK-TM4C129EXL>`__.
**STATUS:**
- Support for the EK-TM4C129EXL is based on support for the similar
EK-TM4C1294XL. This basic board support includes a configuration
for the NuttShell :ref:`NSH <nsh>`), a configuration for testing
IPv6, and a configuration for testing the RTOS using the ostest
example in the NuttX apps repository.
Refer to the EK-TM4C129EXL board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/tiva/tm4c129e-launchpad/README.txt>`__
file for more detailed information about this port.
TI/Tiva TM4C129X
----------------
This port uses the TI Tiva C Series TM4C129X Connected
Development Kit `(DK-TM4C129X) <http://www.ti.com/tool/dk-tm4c129x>`__.
**STATUS:**
- A mature port to the DK-TM4C129X was implemented and was released in
NuttX 7.7.
- At the initial release, verified drivers were available for Ethernet
interface, I2C, and timers as well as board LEDs and push buttons.
Other Tiva/Stellaris drivers should port to the TM4C129X without
major difficulty.
- This board supports included two configurations for the NuttShell
(:ref:`NSH <nsh>`). Both
are networked enabled: One configured to support IPv4 and one
configured to supported IPv6. Instructions are included in the board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/tiva/dk-tm4c129x/README.txt>`__
file for configuring both IPv4 and IPv6 simultaneously.
- Tiva PWM and Quadrature Encoder drivers were contributed to NuttX in
7.18 by Young.
Refer to the DK-TM4C129X board
`README <https://github.com/apache/nuttx/blob/master/boards/arm/tiva/dk-tm4c129x/README.txt>`__
file for more detailed information about this port.
TI/SimpleLink CC13x2
--------------------
Basic, unverified architectural support for the
CC13x2 was added in NuttX-7.28. Fragmentary support for very similar
CC26x2 family is included. This is a work in progress and, with any
luck, a fully verified port will be available in NuttX-7.29. It is
currently code complete (minus some ROM *DriverLib* hooks) but untested.
**TI LaunchXL-CC1312R1**. Basic board support for the TI
LaunchXL-CC1312R1 board is in place. Board bring-up, however, cannot be
done until the the basic CC13x2 architecture support is complete,
hopefully in NuttX-7.29.
TI/Stellaris LM4F120x
---------------------
This port uses the TI Stellaris LM4F120 LaunchPad.
Jose Pablo Carballo and I are doing this port.
- TI/Tiva TM4C123G
- TI/Tiva TM4C1294
- TI/Tiva TM4C129E
- TI/Tiva TM4C129X
- TI/SimpleLink CC13x2

17
Documentation/platforms/arm/tms570/index.rst Normal file
View File

@ -0,0 +1,17 @@
=====================
TI/Hercules TMS570xxx
=====================
TI/Hercules TMS570LS04xx
------------------------
A port is available for the Texas Instruments
Hercules TMS570LS04x/03x LaunchPad Evaluation Kit (*LAUNCHXL-TMS57004*)
featuring the Hercules TMS570LS0432PZ chip.
TI/Hercules TMS570LS31xx
------------------------
Architecture support for the TMS570LS3137ZWT
part was added in NuttX 7.25 by Ivan Ucherdzhiev. Ivan also added
support for the TI Hercules TMS570LS31x USB Kit.

33
Documentation/platforms/avr/at32uc3/index.rst Normal file
View File

@ -0,0 +1,33 @@
=================
Microchip AT32UC3
=================
AV32DEV1. This port uses the www.mcuzone.com AVRDEV1 board based on the
Microchip AT32UC3B0256 MCU. This port requires a special GNU avr32 toolchain
available from atmel.com website. This is a windows native toolchain and
so can be used only under Cygwin on Windows.
**STATUS:** This port is has completed all basic development, but there
is more that needs to be done. All code is complete for the basic NuttX
port including header files for all AT32UC3\* peripherals. The untested
AVR32 code was present in the 5.12 release of NuttX. Since then, the
basic RTOS port has solidified:
- The port successfully passes the NuttX OS test
(apps/examples/ostest).
- A NuttShell (NSH) configuration is in place (see :ref:`NSH <nsh>`).
Testing of that configuration has been postponed (because it got
bumped by the Olimex LPC1766-STK port). Current Status: I think I
have a hardware problem with my serial port setup. There is a good
chance that the NSH port is complete and functional, but I am not yet
able to demonstrate that. At present, I get nothing coming in the
serial RXD line (probably because the pins are configured wrong or I
have the MAX232 connected wrong).
The basic, port was be released in NuttX-5.13. A complete port will
include drivers for additional AVR32 UC3 devices -- like SPI and USB ---
and will be available in a later release, time permitting. Refer to the
NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/avr/at32uc3/avr32dev1/README.txt>`__
file for further information.

46
Documentation/platforms/avr/at90usb/index.rst Normal file
View File

@ -0,0 +1,46 @@
===========
AVR AT90USB
===========
AVR AT90USB64x and AT90USB6128x
-------------------------------
**Micropendous 3 AT90USB64x** and **AT90USB6128x**. This port of NuttX
to the Opendous Micropendous 3 board. The Micropendous3 is may be
populated with an AT90USB646, 647, 1286, or 1287. I have only the
AT90USB647 version for testing. This version have very limited memory
resources: 64K of FLASH and 4K of SRAM.
**PJRC Teensy++ 2.0 AT90USB1286**. This is a port of NuttX to the PJRC
Teensy++ 2.0 board. This board was developed by
`PJRC <http://pjrc.com/teensy/>`__. The Teensy++ 2.0 is based on an
Microchip AT90USB1286 MCU.
**AVR-Specific Issues**. The basic AVR port is solid. The biggest issue
for using AVR is its tiny SRAM memory and its Harvard architecture.
Because of the Harvard architecture, constant data that resides to flash
is inaccessible using "normal" memory reads and writes (only SRAM data
can be accessed "normally"). Special AVR instructions are available for
accessing data in FLASH, but these have not been integrated into the
normal, general purpose OS.
Most NuttX test applications are console-oriented with lots of strings
used for ``printf()`` and debug output. These strings are all stored in
SRAM now due to these data accessing issues and even the smallest
console-oriented applications can quickly fill a 4-8K memory. So, in
order for the AVR port to be useful, one of two things would need to be
done:
#. Don't use console applications that required lots of strings. The
basic AVR port is solid and your typical deeply embedded application
should work fine. Or,
#. Create a special version of printf that knows how to access strings
that reside in FLASH (or EEPROM).
**Development Environments:** 1) Linux with native Linux GNU toolchain,
2) Cygwin/MSYS with Cygwin GNU toolchain, 3) Cygwin/MSYS with Windows
native toolchain, or 4) Native Windows. All testing, however, has been
performed using the NuttX DIY toolchain for Linux or Cygwin is provided
by the NuttX
`buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
package. As a result, that toolchain is recommended.

22
Documentation/platforms/avr/atmega/index.rst
View File

@ -1,6 +1,16 @@
===========
======
Atmega
======
ATMega128
---------
This port of NuttX to the Amber Web Server from
`SoC Robotics <http://www.soc-robotics.com/index.htm>`__ is partially
completed. The Amber Web Server is based on an Microchip ATMega128.
Atmega1284P
===========
-----------
The Atmega1284P is a chip from Microchip ("inherited" from Atmel) with the
following features:
@ -20,6 +30,14 @@ following features:
- Real Time Clock
- JTAG/OCD Interface
AVR ATMega2560
--------------
Extension of the AVR architecture to support the
ATMega2560 and specifi support for the Arduion MEGA2560 board were
contributed by Dimitry Kloper and first released in NuttX-7.14.
Clock Configuration
===================

8
Documentation/platforms/avr/index.rst
View File

@ -1,8 +1,8 @@
====
AVR8
====
=============
Microchip AVR
=============
The following AVR8 chips are supported:
The following AVR chips are supported:
.. toctree::
:maxdepth: 1

11
Documentation/platforms/ceva/index.rst Normal file
View File

@ -0,0 +1,11 @@
====
CEVA
====
The following CEVA DSP are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

3
Documentation/platforms/ceva/xc5/index.rst Normal file
View File

@ -0,0 +1,3 @@
========
CEVA xc5
========

3
Documentation/platforms/ceva/xm6/index.rst Normal file
View File

@ -0,0 +1,3 @@
========
CEVA xm6
========

11
Documentation/platforms/hc/index.rst Normal file
View File

@ -0,0 +1,11 @@
===
HC
===
The following HC SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

17
Documentation/platforms/hc/m9s12/index.rst Normal file
View File

@ -0,0 +1,17 @@
===============
Freescale M9S12
===============
Freescale M68HCS12
------------------
**MC9S12NE64**. Support for the MC9S12NE64 MCU and two boards are
included:
- The Freescale DEMO9S12NE64 Evaluation Board, and
- The Future Electronics Group NE64 /PoE Badge board.
Both use a GNU arm-nuttx-elf toolchain\* under Linux or Cygwin. The
NuttX `buildroot <https://bitbucket.org/nuttx/buildroot/downloads/>`__
provides a properly patched GCC 3.4.4 toolchain that is highly optimized
for the m9s12x family.

11
Documentation/platforms/mips/index.rst Normal file
View File

@ -0,0 +1,11 @@
====
MIPS
====
The following MIPS SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

59
Documentation/platforms/mips/pic32mx/index.rst Normal file
View File

@ -0,0 +1,59 @@
=================
Microchip pic32mx
=================
(MIPS M4K architecture)
Microchip PIC32MX2xx
--------------------
A port is in progress from the DTX1-4000L "Mirtoo"
module from `Dimitech <http://www.dimitech.com/>`__. This module uses
Microchip PIC32MX250F128D and the Dimitech DTX1-4000L EV-kit1 V2. See
the `Dimitech <http://www.dimitech.com/>`__ website for further
information.
Microchip PIC32MX4xx
--------------------
**PIC32MX440F512H**. This port uses the "Advanced USB Storage Demo
Board," Model DB-DP11215, from `Sure
Electronics <http://www.sureelectronics.net>`__. This board features the
Microchip PIC32MX440F512H.
**PIC32MX460F512L**. There one two board ports using this chip:
- **PIC32MX Board from PCB Logic Design Co**. This port is for the
PIC32MX board from PCB Logic Design Co. and used the PIC32MX460F512L.
The board is a very simple -- little more than a carrier for the
PIC32 MCU plus voltage regulation, debug interface, and an OTG
connector.
- **UBW32 Board from Sparkfun** This is the port to the Sparkfun UBW32
board. This port uses the `original
v2.5 <http://www.sparkfun.com/products/8971>`__ board which is based
on the Microchip PIC32MX460F512L. This older version has been
replaced with this `newer
board <http://www.sparkfun.com/products/9713>`__. See also the
`UBW32 <http://www.schmalzhaus.com/UBW32/>`__ web site.
Microchip PIC32MX7xx
--------------------
PIC32MX795F512L. There one two board ports using this chip:
- **Microchip PIC32 Ethernet Starter Kit**. This port uses the
Microchip PIC32 Ethernet Starter Kit (DM320004) with the Expansion
I/O board. See the `Microchip website <http://www.microchip.com>`__
for further information.
- **Mikroelektronika PIC32MX7 Mulitmedia Board (MMB)**. A port has been
completed for the Mikroelektronika PIC32MX7 Multimedia Board (MMB).
See http://www.mikroe.com/ for further information about this board.
**Development Environment:** These ports uses either:
#. The *LITE* version of the PIC32MX toolchain available for download
from the `Microchip <http://www.microchip.com>`__ website, or
#. The Pinguino MIPS ELF toolchain available from the Pinguino
`website <https://code.google.com/archive/p/pinguino32/>`__.
#. The MIPS SDE toolchain available from the `Mentor
Graphics <http://www.mentor.com>`__ website.

61
Documentation/platforms/mips/pic32mz/index.rst Normal file
View File

@ -0,0 +1,61 @@
=================
Microchip pic32mz
=================
Microchip PIC32MZEF
-------------------
(MIPS M5150 architecture).
A port is in available for the MikroElectronika `Flip&Click
PIC32MZ <https://www.mikroe.com/flipclick-pic32mz>`__ development board
based on the PIC32MZ2048EFH100 MCU. This board configuration was added
in NuttX-7.24 and is, for the most part, compatible with the PIC32MZEC
family.
**STATUS:**
**NuttX-7.9**. The first official release was in NuttX-7.9. Many drivers
port simply from the PIC32MX; others require more extensive efforts.
Driver status as of (2015-03-29) is provided below:
- I/O ports include I/O port interrupts
- UART serial driver that provides the NSH console,
- Timer,
- I2C (untested),
- SPI (untested),
- On-board buttons and LEDs,
- Ethernet (code complete, but not yet functional),
**NuttX-7.29**. Abdelatif Guettouche contributed additional timer
support including: Timer lower half driver, free-running, and one-shot
timers.
**NuttX-7.31**. Abdelatif Guettouche contributed DMA support.
**NuttX-9.0**. Cache operations were implemented.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/mips/pic32mz/pic32mz-starterkit/README.txt>`__
file for further information.
**Development Environment:** Same as for the PIC32MZ.
Microchip PIC32MZEC
-------------------
PIC32MZEC Family (MIPS microAptiv). A port is in available for the
PIC32MZ Embedded Connectivity (EC) Starter Kit. There are two
configurations of the Microchip PIC32MZ EC Starter Kit:
#. The PIC32MZ Embedded Connectivity Starter Kit based on the
PIC32MZ2048ECH144-I/PH chip (DM320006), and
#. The PIC32MZ Embedded Connectivity Starter Kit based on the
PIC32MZ2048ECM144-I/PH w/Crypto Engine (DM320006-C).
See the `Microchip <http://www.microchip.com>`__ website for further
information.
This was a collaborative effort between Kristopher Tate, David Sidrane
and myself. The basic port is functional and a NuttShell (NSH)
configuration is available.

10
Documentation/platforms/misco/index.rst Normal file
View File

@ -0,0 +1,10 @@
Misoc
=====
The following Misoc SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

12
Documentation/platforms/misco/lm32/index.rst Normal file
View File

@ -0,0 +1,12 @@
Misoc LM32
==========
Misoc LM32 Architectural Support. Architectural support for the Misoc
LM32 was contributed by Ramtin Amin in NuttX 7.19
Minerva. Architectural support for the Misoc Minoerva was contributed by
Ramtin Amin in NuttX 7.29.
**Drivers**. Driver support is basic in these initial releases: Serial,
Timer, and Ethernet. "Board" support is a available for developing with
Misoc LM32 under Qemu or on your custom FPGA.

9
Documentation/platforms/or1k/index.rst Normal file
View File

@ -0,0 +1,9 @@
========
OpenRISC
========
.. toctree::
:maxdepth: 1
:glob:
*/*

8
Documentation/platforms/or1k/mor1kx/index.rst Normal file
View File

@ -0,0 +1,8 @@
===============
OpenRISC mor1kx
===============
**OpenRISC mor1kx Architectural Support**. Architectural support for the
OpenRISC mor1kx was developed by Matt Thompson Amin and released in
NuttX 7.25. Currently only an mor1kx Qemu simulation is available for
testing.

11
Documentation/platforms/renesas/index.rst Normal file
View File

@ -0,0 +1,11 @@
=======
Renesas
=======
The following Renesas SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

18
Documentation/platforms/renesas/m16c/index.rst Normal file
View File

@ -0,0 +1,18 @@
============
Renesas M16C
============
**Renesas M16C/26 Microcontroller**. This port uses the Renesas SKP16C26
Starter kit and the GNU M32C toolchain. The development environment is
either Linux or Cygwin under WinXP.
**STATUS:** Initial source files released in nuttx-0.4.2. At this point,
the port has not been integrated; the target cannot be built because the
GNU ``m16c-nuttx-elf-ld`` link fails with the following message:
Where the reference line is:
No workaround is known at this time. This is a show stopper for M16C.
Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/renesas/m16c/skp16c26/README.txt>`__
file for further information.

15
Documentation/platforms/renesas/rx65n/index.rst Normal file
View File

@ -0,0 +1,15 @@
=============
Renesas RX65N
=============
Support for the Renesas RX65N family was released in NuttX with a
contribution from Anjana. Two boards are supported in this initial
release:
- **RSK RX65N-2MB**.
- **GR-Rose**.
**STATUS**
- **NuttX-8.2**
- **NuttX-9.0** RTC driver for the RX65N was added.

7
Documentation/platforms/renesas/sh1/index.rst Normal file
View File

@ -0,0 +1,7 @@
============
Renesas SH-1
============
**SH-1 SH7032**. This port uses the Hitachi SH-1 Low-Cost Evaluation
Board (SH1_LCEVB1), US7032EVB, with a GNU ELF toolchain\* under Linux or
Cygwin.

3
Documentation/platforms/risc-v/c906/index.rst Normal file
View File

@ -0,0 +1,3 @@
==========
THEAD C906
==========

3
Documentation/platforms/risc-v/hpm6750/index.rst Normal file
View File

@ -0,0 +1,3 @@
===============
Hpmicro HPM6750
===============

3
Documentation/platforms/risc-v/k210/index.rst Normal file
View File

@ -0,0 +1,3 @@
=============
Kendryte K210
=============

6
Documentation/platforms/risc-v/litex/index.rst
View File

@ -1,6 +1,6 @@
======================================
==========================
Enjoy Digital LiteX FPGA's
======================================
==========================
The LiteX framework provides a convenient and efficient infrastructure to create FPGA Cores/SoCs, to explore various digital design architectures and create full FPGA based systems.
@ -16,7 +16,7 @@ should work with either core, requiring minimal adjustment to the configuration.
Toolchain
==============
=========
Litex projects can be built with a generic RISC-V GCC toolchain. There are currently two options.

3
Documentation/platforms/risc-v/qemu/index.rst Normal file
View File

@ -0,0 +1,3 @@
======================
QEMU Generic RV32/RV64
======================

3
Documentation/platforms/risc-v/rv32m1/index.rst Normal file
View File

@ -0,0 +1,3 @@
==========
NXP RV32M1
==========

3
Documentation/platforms/sim/index.rst
View File

@ -2,6 +2,9 @@
Simulators
==========
A user-mode port of NuttX to the x86 Linux/Cygwin platform is available.
The purpose of this port is primarily to support OS feature development.
The following Simulator/Emulators are supported:
.. toctree::

2
Documentation/platforms/sparc/bm3803/index.rst Normal file
View File

@ -0,0 +1,2 @@
BM3803
======
Side by Side

After

Width:  |  Height:  |  Size: 14 B

2
Documentation/platforms/sparc/bm3823/index.rst Normal file
View File

@ -0,0 +1,2 @@
BM3823
======
Side by Side

After

Width:  |  Height:  |  Size: 14 B

11
Documentation/platforms/sparc/index.rst Normal file
View File

@ -0,0 +1,11 @@
=====
SPARC
=====
The following SPARC SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

2
Documentation/platforms/sparc/s698pm/index.rst Normal file
View File

@ -0,0 +1,2 @@
S698PM
======

9
Documentation/platforms/x86/index.rst Normal file
View File

@ -0,0 +1,9 @@
===========
Intel 80x86
===========
.. toctree::
:maxdepth: 1
:glob:
*/*

18
Documentation/platforms/x86/qemu/index.rst Normal file
View File

@ -0,0 +1,18 @@
========
QEMU x86
========
**QEMU/Bifferboard i486**. This port uses the
`QEMU <http://wiki.qemu.org/Main_Page>`__ i486 and the native Linux,
Cygwin, MinGW the GCC toolchain under Linux or Cygwin.
**STATUS:** The basic port was code-complete in NuttX-5.19 and verified
in NuttX-6.0. The port was verified using the OS and NuttShell (NSH)
examples under QEMU. The port is reported to be functional on the
`Bifferboard <http://bifferos.bizhat.com>`__ as well. In NuttX 7.1,
Lizhuoyi contributed additional keyboard and VGA drivers. This is a
great, stable starting point for anyone interested in fleshing out the
x86 port! Refer to the NuttX
`README <https://github.com/apache/nuttx/blob/master/boards/x86/qemu/qemu-i486/README.txt>`__
file for further information.

9
Documentation/platforms/x86_64/index.rst Normal file
View File

@ -0,0 +1,9 @@
==============
Intel 80x86_64
==============
.. toctree::
:maxdepth: 1
:glob:
*/*

17
Documentation/platforms/x86_64/qemu/index.rst Normal file
View File

@ -0,0 +1,17 @@
===========
QEMU x86_64
===========
**QEMU/Intel64** An x86_64 flat address port was ported in NuttX-9.0. It
consists of the following feautres:
- Runs in x86_64 long mode.
- Configurable SSE/AVX support.
- IRQs are managed by LAPIC(X2APIC) and IOAPIC.
- Used TSC_DEADLINE or APIC timer for systick.
- Pages are now maps the kernel at 4GB~, but changeable.
This kernel with ostest have been tested with
- Qemu/KVM on a Xeon 2630v4 machine.
- Bochs with broadwell_ult emulation.

11
Documentation/platforms/z16/index.rst Normal file
View File

@ -0,0 +1,11 @@
===
Z16
===
The following Z16 SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

16
Documentation/platforms/z16/z16f/index.rst Normal file
View File

@ -0,0 +1,16 @@
===============
Zilog ZNEO Z16F
===============
**Zilog z16f2800100zcog development kit**. This port use the Zilog
z16f2800100zcog development kit and the Zilog ZDS-II Windows command
line tools. The development environment is either Windows native or
Cygwin under Windows.
**STATUS:** The initial release of support for the z16f was made
available in NuttX version 0.3.7. A working NuttShell (NSH)
configuration as added in NuttX-6.33 (although a patch is required to
work around an issue with a ZDS-II 5.0.1 tool problem). An ESPI
driver was added in NuttX-7.2. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/z16/z16f/z16f2800100zcog/README.txt>`__
file for further information.

31
Documentation/platforms/z80/ez80/index.rst Normal file
View File

@ -0,0 +1,31 @@
===================
Zilog eZ80 Acclaim!
===================
**Zilog eZ80Acclaim! Microcontroller**. There are four eZ80Acclaim!
ports:
- The ZiLOG ez80f0910200kitg development kit.
- The ZiLOG ez80f0910200zcog-d development kit.
- The MakerLisp CPU board.
- The Z20x DIY computing system.
All three boards are based on the eZ80F091 part and all use the Zilog
ZDS-II Windows command line tools. The development environment is either
Windows native or Cygwin or MSYS2 under Windows.
It is also possible to compile using ``clang`` and the GNU ``binutils``
toolchain. You must have a variant of ``clang`` that supports the eZ80,
and an install of ``binutils`` built with Z80 support.
``clang`` with eZ80 support is available as part of the Texas Instruments
CE 85+ unofficial `toolchain <https://ce-programming.github.io/toolchain/>`
and requires a further `patch <https://github.com/codebje/ez80-toolchain/tree/master/clang>`
to support GNU assembler syntax.
GNU ``binutils`` supports the Z80 family. It will require compilation with
appropriate configuration to enable support.
C intrinsics are also required. Some may be found in the Zilog ZDS-II
distribution, requiring some modification to build with the GNU assembler.
Additional intrinsics for 64-bit support must be supplied.

11
Documentation/platforms/z80/index.rst Normal file
View File

@ -0,0 +1,11 @@
===
Z80
===
The following Z80 SoC are supported:
.. toctree::
:maxdepth: 1
:glob:
*/*

20
Documentation/platforms/z80/z180/index.rst Normal file
View File

@ -0,0 +1,20 @@
==========
Zilog Z180
==========
**P112**. The P112 is a hobbyist single board computer based on a 16MHz
Z80182 with up to 1MB of memory, serial, parallel and diskette IO, and
realtime clock, in a 3.5-inch drive form factor. The P112 computer
originated as a commercial product of "D-X Designs Pty Ltd"[ of
Australia.
Dave Brooks was successfully funded through Kickstarter for and another
run of P112 boards in November of 2012. In addition Terry Gulczynski
makes additional P112 derivative hobbyist home brew computers.
**STATUS:** Most of the NuttX is in port for both the Z80182 and for the
P112 board. Boards from Kickstarter project will not be available,
however, until the third quarter of 2013. So it will be some time before
this port is verified on hardware. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/z80/z180/p112/README.txt>`__
file for further information.

19
Documentation/platforms/z80/z8/index.rst Normal file
View File

@ -0,0 +1,19 @@
===============
Zilog Z8Encore!
===============
**Zilog Z8Encore! Microcontroller**. This port uses the either:
- Zilog z8encore000zco development kit, Z8F6403 part, or
- Zilog z8f64200100kit development kit, Z8F6423 part
and the Zilog ZDS-II Windows command line tools. The development
environment is either Windows native or Cygwin under Windows.
**STATUS:** This release has been verified only on the ZiLOG ZDS-II
Z8Encore! chip simulation as of nuttx-0.3.9. Refer to the NuttX board
README files for the
`z8encore000zco <https://github.com/apache/nuttx/blob/master/boards/z80/z8/z8encore000zco/README.txt>`__
and for
the\ `z8f64200100kit <https://github.com/apache/nuttx/blob/master/boards/z80/z8/z8f64200100kit/README.txt>`__
for further information.

38
Documentation/platforms/z80/z80/index.rst Normal file
View File

@ -0,0 +1,38 @@
=========
Zilog Z80
=========
**Z80 Instruction Set Simulator**. This port uses the
`SDCC <http://sdcc.sourceforge.net/>`__ toolchain under Linux or Cygwin
(verified using version 2.6.0). This port has been verified using only a
Z80 instruction simulator called z80sim.
**STATUS:** This port is complete and stable to the extent that it can
be tested using an instruction set simulator. Refer to the NuttX board
`README <https://github.com/apache/nuttx/blob/master/boards/z80/z80/z80sim/README.txt>`__
file for further information.
**XTRS: TRS-80 Model I/III/4/4P Emulator for Unix**. A very similar Z80
port is available for `XTRS <http://www.tim-mann.org/xtrs.html>`__, the
TRS-80 Model I/III/4/4P Emulator for Unix. That port also uses the
`SDCC <http://sdcc.sourceforge.net/>`__ toolchain under Linux or Cygwin
(verified using version 2.6.0).
**STATUS:** Basically the same as for the Z80 instruction set simulator.
This port was contributed by Jacques Pelletier. Refer to the NuttX board
`README <https://bitbucket.org/patacongo/obsoleted/src/master/configs/xtrs/README.txt>`__
file for further information.
**NOTE:** This port was removed from the NuttX source tree on
2017-11-24. It was removed because (1) it is unfinished, unverified, and
unsupported, and (2) the TRS-80 simulation is a sub-optimal platform.i
That platform includes a 16-bit ROM image and only a 48Kb RAM space for
NuttX. The removed board support is still available in the ``Obsoleted``
repository if anyone would ever like to resurrect it.
\* A highly modified `buildroot <http://buildroot.uclibc.org/>`__ is
available that may be used to build a NuttX-compatible ELF toolchain
under Linux or Cygwin. Configurations are available in that buildroot
to support ARM, Cortex-M3, avr, m68k, m68hc11, m68hc12, m9s12,
blackfin, m32c, h8, and SuperH ports.