Board-Specific Configurations ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This directory contains the board support for logic for all boards supported by NuttX. This directory is retained in a separate repository and is a Sub- Module of NuttX and will appear as nuttx/boards when the NuttX repository is cloned. The nuttx/boards directory is a part of the internal OS. It should contain only OS bring-up logic and driver initialization logic. THERE SHOULD BE NO APPLICATION CALLABLE LOGIC IN THIS DIRECTORY. If you have board-specific, application callable logic, that logic should not go here. Please consider using a sub-directory under apps/platform instead. Table of Contents ^^^^^^^^^^^^^^^^^ o Board-Specific Configurations o Summary of Files o Configuration Variables o Supported Boards o Configuring NuttX o Building Symbol Tables Board-Specific Configurations ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The NuttX configuration consists of: o Processor architecture specific files. These are the files contained in the arch// directory. o Chip/SoC specific files. Each processor architecture is embedded in a chip or System-on-a-Chip (SoC) architecture. The full chip architecture includes the processor architecture plus chip-specific interrupt logic, general purpose I/O (GIO) logic, and specialized, internal peripherals (such as UARTs, USB, etc.). These chip-specific files are contained within chip-specific sub-directories in the arch// directory and are selected via the CONFIG_ARCH_name selection o Board specific files. In order to be usable, the chip must be contained in a board environment. The board configuration defines additional properties of the board including such things as peripheral LEDs, external peripherals (such as network, USB, etc.). These board-specific configuration files can be found in the boards//// sub-directories and are discussed in this README. Additional configuration information may be available in board-specific README files at boards////README.txt files. The boards/ subdirectory contains configuration data for each board. These board-specific configurations plus the architecture-specific configurations in the arch/ subdirectory completely define a customized port of NuttX. Directory Structure ^^^^^^^^^^^^^^^^^^^ The boards/ directory contains board specific configuration logic. Each board must provide a subdirectory under boards/ with the following characteristics: |-- README.txt |-- include/ | `-- (board-specific header files) |-- src/ | |-- Makefile | `-- (board-specific source files) |-- | |-- Make.defs | `-- defconfig |-- | |-- Make.defs | `-- defconfig ... Summary of Files ^^^^^^^^^^^^^^^^ README.txt -- This text file provides additional information unique to each board configuration sub-directory. include/ -- This directory contains board specific header files. This directory will be linked as include/arch/board at configuration time and can be included via '#include '. These header file can only be included by files in arch/include/ and arch//src src/ -- This directory contains board specific drivers. This directory will be linked as arch//src/board at configuration time and will be integrated into the build system. src/Makefile -- This makefile will be invoked to build the board specific drivers. It must support the following targets: libext$(LIBEXT), clean, and distclean. A board may have various different configurations using these common source files. Each board configuration is described by two files: Make.defs and defconfig. Typically, each set of configuration files is retained in a separate configuration sub-directory (, , .. in the above diagram). Make.defs -- This makefile fragment provides architecture and tool-specific build options. It will be included by all other makefiles in the build (once it is installed). This make fragment should define: Tools: CC, LD, AR, NM, OBJCOPY, OBJDUMP Tool options: CFLAGS, LDFLAGS When this makefile fragment runs, it will be passed TOPDIR which is the path to the root directory of the build. This makefile fragment should include: $(TOPDIR)/.config : Nuttx configuration $(TOPDIR)/tools/Config.mk : Common definitions Definitions in the Make.defs file probably depend on some of the settings in the .config file. For example, the CFLAGS will most likely be different if CONFIG_DEBUG_FEATURES=y. The included tools/Config.mk file contains additional definitions that may be overridden in the architecture-specific Make.defs file as necessary: COMPILE, ASSEMBLE, ARCHIVE, CLEAN, and MKDEP macros defconfig -- This is a configuration file similar to the Linux configuration file. In contains variable/value pairs like: CONFIG_VARIABLE=value This configuration file will be used at build time: (1) as a makefile fragment included in other makefiles, and (2) to generate include/nuttx/config.h which is included by most C files in the system. Configuration Variables ^^^^^^^^^^^^^^^^^^^^^^^ At one time, this section provided a list of all NuttX configuration variables. However, NuttX has since converted to use the kconfig-frontends tools (See http://ymorin.is-a-geek.org/projects/kconfig-frontends). Now, the NuttX configuration is determined by a self-documenting set of Kconfig files. The current NuttX configuration variables are also documented in separate, auto-generated configuration variable document. That configuration variable document is generated using the kconfig2html tool that can be found in the nuttx/tools directory. That tool analyzes the NuttX Kconfig files and generates an excruciatingly boring HTML document. The latest boring configuration variable documentation can be regenerated at any time using that tool or, more appropriately, the wrapper script at nuttx/tools/mkconfigvars.sh. That script will generate the file nuttx/Documentation/NuttXConfigVariables.html. The version of NuttXConfigVariables.html for the last released version of NuttX can also be found online at: http://nuttx.org/Documentation/NuttXConfigVariables.html. Supported Boards ^^^^^^^^^^^^^^^^ boards/avr/atmeta/amber This is placeholder for the SoC Robotics Amber Web Server that is based on the Atmel AVR ATMega128 MCU. There is not much there yet and what is there is untested due to tool-related issues. boards/arm/sam34/arduino-due This sub-directory holds board support for the Arduino DUE board featuring the Atmel ATSAM3X8E MCU running at 84 MHz. boards/avr/at32uc3/avr32dev1 This is a port of NuttX to the Atmel AVR32DEV1 board. That board is based on the Atmel AT32UC3B0256 MCU and uses a specially patched version of the GNU toolchain: The patches provide support for the AVR32 family. That patched GNU toolchain is available only from the Atmel website. STATUS: This port is functional but very basic. There are configurations for NSH and the OS test. boards/arm/stm32/axoloti Support for the Axoloti synthesizer board based on the STMicro STM32F427IGH6 MCU. See: http://www.axoloti.com/ boards/arm/stm32f0l0g0/b-l072z-lrwan1 STMicro STM32L0 Discovery kit with LoRa/SigFox based on STM32L072CZ MCU. boards/arm/lpc43xx/bambino-200e Micromint Bambino board. This board is based on the LPC4330FBD144. boards/arm/c5471/c5471evm This is a port to the Spectrum Digital C5471 evaluation board. The TMS320C5471 is a dual core processor from TI with an ARM7TDMI general purpose processor and a c54 DSP. It is also known as TMS320DA180 or just DA180. NuttX runs on the ARM core and is built with a GNU arm-nuttx-elf toolchain*. This port is complete and verified. boards/arm/tiva/launchxl_cc1310 Port to the TI SimpleLink CC1310 LaunchPad Evaluation Kit (LAUNCHXL-CC1310) featuring the SimpleLinkCC1310 chip. This board features the CC1310F128 part with 128Kb of FLASH and 20Kb of SRAM. boards/arm/tiva/launchxl_cc1312r1 Port to the TI SimpleLink CC1312R1 LaunchPad Evaluation Kit (LAUNCHXL-CC1312R1) featuring the SimpleLinkCC1312R1 chip. boards/arm/stm32/clicker2-stm32 Mikroe Clicker2 STM32 board based on the STMicro STM32F407VGT6 MCU. boards/arm/stm32/cloudctrl Darcy's CloudController board. This is a small network relay development board. Based on the Shenzhou IV development board design. It is based on the STM32F107VC MCU. boards/hc/mcs92s12ne64/demo9s12ne64 NXP/FreeScale DMO9S12NE64 board based on the MC9S12NE64 hcs12 cpu. This port uses the m9s12x GCC toolchain. STATUS: (Still) under development; it is code complete but has not yet been verified. boards/arm/tiva/dk-tm4c129x This is the port of NuttX to the Tiva® DK-TM4C129x Connected Development Kit. The Tiva® DK-TM4C129x features the TM4C129XNCZAD MCU. boards/arm/lpc31xx/ea3131 Embedded Artists EA3131 Development board. This board is based on the an NXP LPC3131 MCU. This OS is built with the arm-nuttx-elf toolchain*. STATUS: This port is complete and mature. boards/arm/lpc31xx/ea3152 Embedded Artists EA3152 Development board. This board is based on the an NXP LPC3152 MCU. This OS is built with the arm-nuttx-elf toolchain*. STATUS: This port is has not be exercised well, but since it is a simple derivative of the ea3131, it should be fully functional. boards/arm/tiva/eagle100 Micromint Eagle-100 Development board. This board is based on the an ARM Cortex-M3 MCU, the Luminary LM3S6918. This OS is built with the arm-nuttx-elf toolchain*. STATUS: This port is complete and mature. boards/arm/efm32/efm32-g8xx-stk The port of NuttX to the EFM32 Gecko Starter Kit (EFM32-G8XX-STK). boards/arm/efm32/efm32gg-stk3700 The port of NuttX to the EFM32 Giant Gecko Starter Kit (EFM32GG-STK3700). boards/arm/tiva/ekk-lm3s9b96 TI/Stellaris EKK-LM3S9B96 board. This board is based on the an EKK-LM3S9B96 which is a Cortex-M3. boards/xtensa/esp32/esp-core The ESP32 is a dual-core system from Expressif with two Harvard architecture Xtensa LX6 CPUs. All embedded memory, external memory and nd peripherals are located on the data bus and/or the instruction bus of bus of these CPUs. With some minor exceptions, the address mapping of two CPUs is symmetric, meaning they use the same addresses to access the same memory. boards/z80/ez80/ez80f0910200kitg ez80Acclaim! Microcontroller. This port use the Zilog ez80f0910200kitg development kit, eZ80F091 part, and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under WinXP. boards/z80/ez80/ez80f0910200zco ez80Acclaim! Microcontroller. This port use the Zilog ez80f0910200zco development kit, eZ80F091 part, and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under WinXP. boards/arm/stm32/fire-stm32v2 A configuration for the M3 Wildfire STM32 board. This board is based on the STM32F103VET6 chip. See http://firestm32.taobao.com . Version 2 and 3 of the boards are supported but only version 2 has been tested. boards/mips/pic32mz/flipnclick-pic32mz Board support for the Mikroe Flip&Click PIC32MZ board. This board is an chipKit Arduino-compatible board (but can also be used with the Mikroe bootloader). It has with four Mikroe Click bus interfaces in addition to standard Arduino connectors. This board features the Microchip PIC32MZ2048EFH100 MCU running at 200 MHz (252Mhz capable). boards/arm/sam34/flipnclick-sam3x Board support for the Mikroe Flip&Click STM32X board. This board is an Arduino-Due work-alike with four Mikroe Click bus interfaces. Like the Arduino DUE, this board features the Atmel ATSAM3X8E MCU running at 84 MHz. boards/arm/kinetis/freedom-k28f This port uses the NXP/FreeScale FREEDOM-K28F development board. This board uses the Kinetis K28F MK28FN2M0VMI15 Cortex-M4 MCU. boards/arm/kinetis/freedom-k64f This port uses the NXP/FreeScale FREEDOM-K64F development board. This board uses the Kinetis K64 MK64FN1M0VLL12 Cortex-M4 MCU. boards/arm/kl/freedom-kl25z boards/arm/kl/freedom-kl26z These configurations are for the NXP/FreeScale Freedom KL25Z and very similar KL26Z board. The Freedom-KL25Z features the K25Z120LE3AN chip; the Freedom-KL26Z has the K26Z128VLH4 chip. These are separate configurations because of minor differences in the on-board logic. Both include a built-in SDA debugger. boards/arm/stm32/hymini-stm32v A configuration for the HY-Mini STM32v board. This board is based on the STM32F103VCT chip. boards/arm/kinetis/kwikstik-k40. Kinetis K40 Cortex-M4 MCU. This port uses the NXP/FreeScale KwikStik-K40 development board. boards/arm/tms570/launchxl-tms57004 TI Hercules TMS570LS04x/03x LaunchPad Evaluation Kit (LAUNCHXL-TMS57004) featuring the Hercules TMS570LS0432PZ chip. boards/arm/lpc17xx_40xx/lincoln60 NuttX port to the Micromint Lincoln 60 board. boards/arm/tiva/lm3s6432-s2e Stellaris RDK-S2E Reference Design Kit and the MDL-S2E Ethernet to Serial module. boards/arm/tiva/lm3s6965-ek Stellaris LM3S6965 Evaluation Kit. This board is based on the an ARM Cortex-M3 MCU, the Luminary/TI LM3S6965. This OS is built with the arm-nuttx-elf toolchain*. STATUS: This port is complete and mature. boards/arm/tiva/lm3s8962-ek Stellaris LMS38962 Evaluation Kit. boards/arm/tiva/lm4f120-launchpad This is the port of NuttX to the Stellaris LM4F120 LaunchPad. The Stellaris® LM4F120 LaunchPad Evaluation Board is a low-cost evaluation platform for ARM® Cortex™-M4F-based microcontrollers from Texas Instruments. boards/arm/lpc17xx_40xx/lpcxpresso-lpc1768 Embedded Artists base board with NXP LPCExpresso LPC1768. This board is based on the NXP LPC1768. The Code Red toolchain is used by default. STATUS: Under development. boards/arm/lpc54xx/lpcxpresso-lpc54628 NXP LPCExpresso LPC54628. This board is based on the NXP LPC54628. boards/arm/lpc43xx/lpc4330-xplorer NuttX port to the LPC4330-Xplorer board from NGX Technologies featuring the NXP LPC4330FET100 MCU boards/arm/lpc43xx/lpc4337-ws NuttX port to the WaveShare LPC4337-ws board featuring the NXP LPC4337JBD144 MCU. boards/arm/lpc43xx/lpc4357-evb NuttX port to the LPC4357-EVB board from Embest featuring the NXP LPC4357FET256 MCU. Based on the LPC4300 Xplorer port and provided by Toby Duckworth. boards/arm/lpc43xx/lpc4370-link2 NuttX port to the NXP LPC4370-Link2 development board featuring the NXP LPC4370FET100 MCU. Based on the LPC4300 Xplorer port and provided by Lok Tep. boards/z80/ez80/makerlisp This port use the MakerLips machine based on an eZ80F091 ez80Acclaim! Microcontroller, and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under Windows. A Windows native development environment is available but has not been verified. boards/arm/stm32/maple NuttX support for the LeafLab's Maple and Maple Mini boards. These boards are based on the STM32F103RBT6 chip for the standard version and on the STM32F103CBT6 for the mini version (See http://leaflabs.com/docs/hardware/maple.html) boards/arm/max326xx/max32660-evsys The configurations in this directory support the Maxim Integrated MAX32660-EVSYS board. boards/arm/lpc17xx_40xx/mbed The configurations in this directory support the mbed board (http://mbed.org) that features the NXP LPC1768 microcontroller. This OS is also built with the arm-nuttx-elf toolchain*. STATUS: Contributed. boards/arm/lpc17xx_40xx/mcb1700 Board support for the Keil MCB1700 boards/arm/samd5e5/metro-m4 Th configurations in this directory are part of the port of NuttX to the Adafruit Metro M4. The Metro M4 uses a Arduino form factor and and pinout. It's powered with an ATSAMD51J19 boards/arm/stm32/mikroe-stm32f4 This is the port of NuttX to the MikroElektronika Mikromedia for STM32F4 development board. Contributed by Ken Petit. boards/misoc/lm32/misoc This directory holds the port to NuttX running on a Qemu LM32 system. You can find the Qemu setup at https://bitbucket.org/key2/qemu boards/arm/lpc214x/mcu123-lpc214x This port is for the NXP LPC2148 as provided on the mcu123.com lpc214x development board. This OS is also built with the arm-nuttx-elf toolchain*. The port supports serial, timer0, spi, and usb. boards/avr/at90usb/micropendous3 This is a port to the Opendous Micropendous 3 board. This board may be populated with either an AVR AT90USB646, 647, 1286, or 1287 MCU. Support is configured for the AT90USB647. boards/mips/pic32mx/mirtoo This is the port to the DTX1-4000L "Mirtoo" module. This module uses MicroChip PIC32MX250F128D. See http://www.dimitech.com/ for further information. boards/avr/atmega/moteino-mega This is placeholder for the LowPowerLab MoteinoMEGA that is based on the Atmel AVR ATMega1284P MCU. There is not much there yet and what is there is untested due to tool-related issues. boards/arm/moxart/moxa Moxa NP51x0 series of 2-port advanced RS-232/422/485 serial device servers. boards/hc/mcs92s12ne6/ne64badge Future Electronics Group NE64 /PoE Badge board based on the MC9S12NE64 hcs12 cpu. This port uses the m9s12x GCC toolchain. STATUS: Under development. The port is code-complete but has not yet been fully tested. boards/arm/nrf52/nrf52-generic NuttX port to the a generic NRF52. Support is in place for the NRF PCA10040 board from Nordic Semiconductor or for the Adafruit NRF52 feather, both featuring the NRF52832 MCU. boards/arm/dm320/ntosd-dm320 This port uses the Neuros OSD v1.0 Dev Board with a GNU arm-nuttx-elf toolchain*: see http://wiki.neurostechnology.com/index.php/OSD_1.0_Developer_Home There are some differences between the Dev Board and the currently available commercial v1.0 Boards. See http://wiki.neurostechnology.com/index.php/OSD_Developer_Board_v1 NuttX operates on the ARM9EJS of this dual core processor. STATUS: This port is code complete, verified, and included in the NuttX 0.2.1 release. boards/arm/stm32f7/nucleo-144 STMicro Nucleo-144 development board family. Included support for (1) the Nucleo-F767ZG board featuring the STM32F746ZGT6U MCU. The STM32F746ZGT6U is a 216MHz Cortex-M7 operation with 1024Kb Flash memory and 320Kb SRAM. And (2) the Nucleo-F746ZG board featuring the STM32F767ZIT6 MCU. The STM32F767ZIT6 is a 216MHz Cortex-M7 operation with 2048Kb Flash memory and 512Kb SRAM. boards/arm/stm32f0l0g0/nucleo-f072rb STMicro Nucleo F072RB board based on the STMicro STM32F072RBT6 MCU. boards/arm/stm32/nucleo-f4x1re STMicro ST Nucleo F401RE and F411RE boards. See http://mbed.org/platforms/ST-Nucleo-F401RE and http://developer.mbed.org/platforms/ST-Nucleo-F411RE for more information about these boards. boards/arm/stm32/nucleo-f410rb NuttX configuration for the STMicro NucleoF410RB board from ST Micro. This board features the STM32F410RB 100MHz Cortex-M4 with 128 KB Flash and 32 KB SRAM. boards/arm/stm32/nucleo-f303re STMicro ST Nucleo F303RE board. Contributed by Paul Alexander Patience. boards/arm/stm32f0l0g0/nucleo-l073rz STMicro STM32L0 Discovery kit with LoRa/SigFox based on STM32L072CZ MCU. boards/arm/nuc1xx/nutiny-nuc120 This is the port of NuttX to the NuvoTon NuTiny-SDK-NUC120 board. This board has the NUC120LE3AN chip with a built-in NuLink debugger. boards/arm/efm32/olimex-efm32g880f128-stk This is the port of NuttX to the Olimex EFM32G880F128-STK development board. boards/arm/lpc17xx_40xx/olimex-lpc1766stk This port uses the Olimex LPC1766-STK board and a GNU GCC toolchain* under Linux or Cygwin. STATUS: Complete and mature. boards/arm/lpc2378/olimex-lpc2378 This port uses the Olimex-lpc2378 board and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. STATUS: ostest and NSH configurations available. This port for the NXP LPC2378 was contributed by Rommel Marcelo. boards/arm/stm32/olimex-stm32-h405 This port uses the Olimex STM32 H405 board and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. See the http://www.olimex.com for further information. This board features the STMicro STM32F405RGT6 MCU. Contributed by Martin Lederhilger. boards/arm/stm32/olimex-stm32-h407 This port uses the Olimex STM32 H407 board and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. See the http://www.olimex.com for further information. This board features the STMicro STM32F407ZGT6 (144 pins). Contributed by Neil Hancock. boards/arm/stm32/olimex-stm32-e407 Olimex STM32 E407 board based on the STMicro STM32F407ZGT6 (144pins). Contributed by Mateusz Szafoni. boards/arm/stm32/olimex-stm32-p107 This port uses the Olimex STM32-P107 board (STM32F107VC) and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. See the https://www.olimex.com/dev/stm32-p107.html for further information. Contributed by Max Holtzberg. boards/arm/stm32/olimex-stm32-p207 This port uses the Olimex STM32-P207 board (STM32F207ZE) and a GNU arm-nuttx-elf toolchain under Linux or Cygwin. See the https://www.olimex.com/dev/stm32-p207.html for further information. Contributed by Martin Lederhilger. boards/arm/stm32/olimex-stm32-p407 This port uses the Olimex STM32-P407 board (STM32F407ZG) and a GNU arm-nuttx-elf toolchain under Linux or Cygwin. See the https://www.olimex.com/dev/stm32-p407.html for further information. boards/arm/stm32/olimexino-stm32 This port uses the Olimexino STM32 board (STM32F103RBT6) and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. See the http://www.olimex.com for further\ information. Contributed by David Sidrane. boards/arm/str71x/olimex-strp711 This port uses the Olimex STR-P711 board and a GNU arm-nuttx-elf toolchain* under Linux or Cygwin. See the http://www.olimex.com/dev/str-p711.html" for further information. STATUS: Configurations for the basic OS test and NSH are complete and verified. boards/arm/stm32/omnibusf4 Flight controllers compatible with the OMINBUSF4 Betaflight target boards/or1k/mor1kx/or1k Generic OpenRISC board. boards/arm/a1x/pcduino-a10 This directory contains the port of NuttX to the pcDuino v1 board See http://www.pcduino.com/ for information about pcDuino Lite, v1, and v2. These boards are based around the Allwinner A10 Cortex-A8 CPU. I have not compared these boards in detail, but I believe that the differences are cosmetic. This port was developed on the v1 board, but the others may be compatible. boards/z80/z180/p112 The P112 is notable because it was the first of the hobbyist single board computers to reach the production stage. The P112 hobbyist computers were relatively widespread and inspired other hobbyist centered home brew computing projects such as N8VEM home brew computing project. The P112 project still maintains many devoted enthusiasts and has an online repository of software and other information. The P112 computer originated as a commercial product of "D-X Designs Pty Ltd" of Australia. They describe the computer as "The P112 is a stand-alone 8-bit CPU board. Typically running CP/M (tm) or a similar operating system, it provides a Z80182 (Z-80 upgrade) CPU with up to 1MB of memory, serial, parallel and diskette IO, and realtime clock, in a 3.5-inch drive form factor. Powered solely from 5V, it draws 150mA (nominal: not including disk drives) with a 16MHz CPU clock. Clock speeds up to 24.576MHz are possible." The P112 board was last available new in 1996 by Dave Brooks. In late 2004 on the Usenet Newsgroup comp.os.cpm, talk about making another run of P112 boards was discussed. David Griffith decided to produce additional P112 kits with Dave Brooks blessing and the assistance of others. In addition Terry Gulczynski makes additional P112 derivative hobbyist home brew computers. Hal Bower was very active in the mid 1990's on the P112 project and ported the "Banked/Portable BIOS". Dave Brooks was successfully funded through Kickstarter for and another run of P112 boards in November of 2012. boards/arm/stm32/photon A configuration for the Photon Wifi board from Particle Devices (https://www.particle.io). This board features the STM32F205RGY6 MCU from STMicro. boards/mips/pic32mx/pic32mx-starterkit This directory contains the port of NuttX to the Microchip PIC32 Ethernet Starter Kit (DM320004) with the Multimedia Expansion Board (MEB, DM320005). See www.microchip.com for further information. boards/mips/pic32mx/pic32mx7mmb This directory will (eventually) contain the port of NuttX to the Mikroelektronika PIC32MX7 Multimedia Board (MMB). See http://www.mikroe.com/ for further information. boards/mips/pic32mz/pic32mz-starterkit This directory contains the port of NuttX to the Microchip PIC32MZ Embedded Connectivity (EC) Starter Kit. There are two configurations of the starter kit: 1) The PIC32MZ Embedded Connectivity Starter Kit based on the PIC32MZ2048ECH144-I/PH chip (DM320006), and 2) The PIC32MZ Embedded Connectivity Starter Kit based on the PIC32MZ2048ECM144-I/PH w/Crypto Engine (DM320006-C) See www.microchip.com for further information. boards/arm/lpc17xx_40xx/pnev5180b NXP Semiconductors' PN5180 NFC Frontend Development Kit. This board is based on the NXP LPC1769 MCU. boards/x86/qemu/qemu-i486 Port of NuttX to QEMU in i486 mode. This port will also run on real i486 hardwared (Google the Bifferboard). boards/risc-v/nr5m100/nr5m100-nexys4 Port of NuttX to RISC-V platform on IQ-Analog NR5M100 RISC-V FPGA platform. boards/arm/s32k1xx/s32k118evb This directory holds the port of NuttX to the NXP S32K118EVB board featuring the S32K118 Cortex-M0+. boards/arm/s32k1xx/s32k146evb This directory holds the port of NuttX to the NXP S32K146EVB board featuring the S32K146 Cortex-M4F. boards/arm/s32k1xx/s32k148evb This directory holds the port of NuttX to the NXP S32K148EVB board featuring the S32K148 Cortex-M4F. boards/arm/imx6/sabre-6quad This directory holds a port of NuttX to the NXP/Freescale Sabre board featuring the iMX 6Quad CPU. boards/arm/sama5/sama5d2-xult This is the port of NuttX to the Atmel SAMA5D2-Xplained Ultra development board. This board features the Atmel SAMA5D27. See http://www.atmel.com. boards/arm/sama5/sama5d3x-ek This is the port of NuttX to the Atmel SAMA5D3x-EK development boards (where x=1,3,4, or 5). These boards feature the Atmel SAMA5D3 microprocessors. Four different SAMA5D3x-EK kits are available - SAMA5D31-EK with the ATSAMA5D1 (http://www.atmel.com/devices/sama5d31.aspx) - SAMA5D33-EK with the ATSAMA5D3 (http://www.atmel.com/devices/sama5d33.aspx) - SAMA5D34-EK with the ATSAMA5D4 (http://www.atmel.com/devices/sama5d34.aspx) - SAMA5D35-EK with the ATSAMA5D5 (http://www.atmel.com/devices/sama5d35.aspx) The each consist of an identical base board with different plug-in modules for each CPU. An option 7 inch LCD is also available. All four boards are supported by NuttX with a simple reconfiguration of the processor type. boards/arm/sama5/sama5d3-xplained This is the port of NuttX to the Atmel SAMA5D3x-Xplained development board. This board features the Atmel SAMA5D36. See http://www.atmel.com/devices/sama5d36.aspx. boards/arm/sama5/sama5d4-ek This is the port of NuttX to the Atmel SAMA5D4-EK development board. This board features the Atmel SAMA5D44. See http://www.atmel.com. boards/arm/samd2l2/samd20-xplained The port of NuttX to the Atmel SAMD20-Xplained Pro development board. This board features the ATSAMD20J18A MCU (Cortex-M0+ with 256KB of FLASH and 32KB of SRAM). boards/arm/samd2l2/samd21-xplained The port of NuttX to the Atmel SAMD21-Xplained Pro development board. This board features the ATSAMD21J18A MCU (Cortex-M0+ with 256KB of FLASH and 32KB of SRAM). boards/arm/sam34/sam3u-ek The port of NuttX to the Atmel SAM3U-EK development board. boards/arm/sam34/sam4cmp-db The port of NuttX to the Atmel SAM4CMP-DB development board. boards/arm/sam34/sam4e-ek The port of NuttX to the Atmel SAM4E-EK development board. This board features the SAM4E16 MCU running at up to 120MHz. boards/arm/sam34/sam4l-xplained The port of NuttX to the Atmel SAM4L-Xplained development board. boards/arm/sam34/sam4s-xplained The port of NuttX to the Atmel SAM4S-Xplained development board. boards/arm/sam34/sam4s-xplained-pro The port of NuttX to the Atmel SAM4S-Xplained Pro development board. boards/arm/samv7/same70-xplained The port of NuttX to the Atmel SAME70 Xplained evaluation board. boards/arm/samv7/samv71-xult The port of NuttX to the Atmel SAMV71 Xplained Ultra evaluation board. boards/sim/sim/sim A user-mode port of NuttX to the x86 Linux platform is available. The purpose of this port is primarily to support OS feature development. This port does not support interrupts or a real timer (and hence no round robin scheduler) Otherwise, it is complete. boards/arm/stm32/shenzhou This is the port of NuttX to the Shenzhou development board from www.armjishu.com. This board features the STMicro STM32F107VCT MCU. boards/renesas/m32262f8/skp16c26 Renesas M16C processor on the Renesas SKP16C26 StarterKit. This port uses the GNU m32c toolchain. STATUS: The port is complete but untested due to issues with compiler internal errors. boards/arm/stm32/stm3210e-eval STMicro STM3210E-EVAL development board based on the STMicro STM32F103ZET6 microcontroller (ARM Cortex-M3). This port uses the GNU Cortex-M3 toolchain. boards/arm/stm32/stm3220g-eval STMicro STM3220G-EVAL development board based on the STMicro STM32F407IG microcontroller (ARM Cortex-M3). boards/arm/stm32/stm3240g-eval STMicro STM3240G-EVAL development board based on the STMicro STM32F103ZET6 microcontroller (ARM Cortex-M4 with FPU). This port uses a GNU Cortex-M4 toolchain (such as CodeSourcery). boards/arm/stm32/stm32butterfly2 Kamami stm32butterfly2 development board with optional ETH phy. See https://kamami.pl/zestawy-uruchomieniowe-stm32/178507-stm32butterfly2.html boards/arm/stm32/stm32f051-discovery STMicro STM32F051-Discovery board based on the STMicro ARCH_CHIP_STM32F051R8 MCU. boards/arm/stm32/stm32f072-discovery STMicro STM32F072-Discovery board based on the STMicro ARCH_CHIP_STM32F072RB MCU. boards/arm/stm32/stm32f103-minimum Generic STM32F103C8T6 Minimum ARM Development Board. boards/arm/stm32/stm32f4discovery STMicro STM32F4-Discovery board based on the STMIcro STM32F407VGT6 MCU. boards/arm/stm32/stm32f411e-disco This is a minimal configuration that supports low-level test of the STMicro STM32F411E-Discovery Board. boards/arm/stm32/stm32f429i-disco STMicro STM32F429I-Discovery board based on the STMicro STM32F429ZIT6 MCU. boards/arm/stm32f7/stm32f746g-disco STMicro STM32F746G-DISCO development board featuring the STM32F746NGH6 MCU. The STM32F746NGH6 is a 216MHz Cortex-M7 operation with 1024Kb Flash memory and 300Kb SRAM. boards/arm/stm32f7/stm32f746g-ws Waveshare STM32F746 development board featuring the STM32F746IG MCU. boards/arm/stm32l4/stm32l476-mdk Motorola Mods Development Board (MDK) features STM32L476ME MCU. The STM32L476ME is a Cortex-M4 optimised for low-power operation at up to 80MHz operation with 1024Kb Flash memory and 96+32Kb SRAM. boards/arm/stm32f7/stm32f769i-disco NuttX configurations for the STMicro STM32F769I-DISCO development board featuring the STM32F769NIH6 MCU. The STM32F769NIH6 is a 216MHz Cortex-M7 operating with 2048K Flash memory and 512Kb SRAM. boards/arm/stm32l4/stm32l476vg-disco STMicro STM32L476VG_DISCO development board featuring the STM32L476VG MCU. The STM32L476VG is a Cortex-M4 optimised for low-power operation at up to 80MHz operation with 1024Kb Flash memory and 96+32Kb SRAM. boards/arm/stm32/stm32ldiscovery STMicro STM32L-Discovery board based on the STMicro STM32L152RB MCU. boards/arm/stm32/stm32vldiscovery STMicro STM32VL-Discovery board based on the STMicro STM32F100RB MCU. boards/mips/pic32mx/sure-pic32mx The "Advanced USB Storage Demo Board," Model DB-DP11215, from Sure Electronics (http://www.sureelectronics.net/). This board features the MicroChip PIC32MX440F512H. See also http://www.sureelectronics.net/goods.php?id=1168 for further information about the Sure DB-DP11215 board. boards/avr/at90usb/teensy-2.0 This is the port of NuttX to the PJRC Teensy++ 2.0 board. This board is developed by http://pjrc.com/teensy/. The Teensy++ 2.0 is based on an Atmel AT90USB1286 MCU. boards/arm/kinetis/teensy-3.x This is the port of NuttX to the Teensy-3.1 from PJRC (https://www.pjrc.com/). The Teensy-3.1 features the Freescale MK30DX256VLH7 chip (now NXP). The MK30DX256VLH7 is a 64-pin Cortex-M4 running at 72MHz. It has 256KiB of program FLASH memory and 64KiB of SRAM. For more information about the Teensy 3.1, see https://www.pjrc.com/teensy/teensy31.html https://www.pjrc.com/store/teensy31.html This board configuration can also be used with the older Teensy-3.0. The Teensy-3.0 has the same schematic (although some pins are not used on the Teensy-3.0). the primary difference is that the Teensy 3.0 has a MK30DX128VLH5 with slightly less capability. boards/arm/kl/teensy-lc This is the port of nuttx for the Teensy LC board. The Teensy LC is a DIP style breakout board for the MKL25Z64 and comes with a USB based bootloader. boards/arm/tiva/tm4c123g-launchpad This is the port of NuttX to the Tiva® TM4C123G LaunchPad. The Tiva® TM4C123G LaunchPad Evaluation Board is a low-cost evaluation platform for ARM® Cortex™-M4F-based microcontrollers from Texas Instruments. boards/arm/tiva/tm4c1294-launchpad This is the port of NuttX to the Tiva® TM4C1294 LaunchPad. The Tiva® TM4C123G LaunchPad Evaluation Board is a low-cost evaluation platform for ARM® Cortex™-M4F-based microcontrollers from Texas Instruments. boards/arm/tmx570/tms570ls31x-usb-kit TI Hercules TMS570LS31xx Evaluation Kit (TMDS570ls31xx USB Kit) featuring the Hercules TMS570LS3137ZWT chip. boards/arm/kinetis/twr-k60n512 Kinetis K60 Cortex-M4 MCU. This port uses the FreeScale TWR-K60N512 development board. boards/arm/kinetis/twr-k64f120m Kinetis K64 Cortex-M4 MCU. This port uses the FreeScale TWR-K64F120M development board. boards/mips/pic32mx/ubw32 This is the port to the Sparkfun UBW32 board. This port uses the original v2.4 board which is based on the MicroChip PIC32MX460F512L. See http://www.sparkfun.com/products/8971. This older version has been replaced with this board http://www.sparkfun.com/products/9713. See also http://www.schmalzhaus.com/UBW32/. boards/renesas/sh7032/us7032evb1 This is a port of the Hitachi SH-1 on the Hitachi SH-1/US7032EVB1 board. STATUS: Work has just began on this port. boards/arm/stm32/viewtool-stm32f107 NuttX configurations for the ViewTool STM32F103/F107 V1.2 board. This board may be fitted with either: (1) STM32F107VCT6 or (2) STM32F103VCT6. See http://www.viewtool.com/ for further information. config/xmc4500-relax Infineon XMC4000 Relax Lite v1 boards/z16/z16f2811/z16f2800100zcog z16f Microcontroller. This port use the Zilog z16f2800100zcog development kit and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under WinXP. boards/z80/z80/z80sim z80 Microcontroller. This port uses a Z80 instruction set simulator called z80sim. This port also uses the SDCC toolchain (http://sdcc.sourceforge.net/") (verified with version 2.6.0). boards/z80/z8/z8encore000zco z8Encore! Microcontroller. This port use the Zilog z8encore000zco development kit, Z8F6403 part, and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under WinXP. boards/z80/z8/z8f64200100kit z8Encore! Microcontroller. This port use the Zilog z8f64200100kit development kit, Z8F6423 part, and the Zilog ZDS-II Windows command line tools. The development environment is Cygwin under WinXP. boards/arm/lpc214x/zp214xpa This port is for the NXP LPC2148 as provided on the The0.net ZPA213X/4XPA development board. Includes support for the UG-2864AMBAG01 OLED also from The0.net boards/arm/lpc17xx_40xx/zkit-arm-1769 Zilogic System's ARM development Kit, ZKIT-ARM-1769. This board is based on the NXP LPC1769. The Nuttx Buildroot toolchain is used by default. Configuring NuttX ^^^^^^^^^^^^^^^^^ Configuring NuttX requires only copying boards/////Make.def to ${TOPDIR}/Make.defs boards/////defconfig to ${TOPDIR}/.config tools/configure.sh There is a script that automates these steps. The following steps will accomplish the same configuration: tools/configure.sh : There is an alternative Windows batch file that can be used in the windows native enironment like: tools\configure.bat : See tools/README.txt for more information about these scripts. And if your application directory is not in the standard loction (../apps or ../apps-), then you should also specify the location of the application directory on the command line like: cd tools ./configure.sh -a : Building Symbol Tables ^^^^^^^^^^^^^^^^^^^^^^ Symbol tables are needed at several of the binfmt interfaces in order to bind a module to the base code. These symbol tables can be tricky to create and will probably have to be tailored for any specific application, balancing the number of symbols and the size of the symbol table against the symbols required by the applications. The top-level System.map file is one good source of symbol information (which, or course, was just generated from the top-level nuttx file using the GNU 'nm' tool). There are also common-separated value (CSV) values in the source try that provide information about symbols. In particular: nuttx/syscall/syscall.csv - Describes the NuttX RTOS interface, and nuttx/lib/libc.csv - Describes the NuttX C library interface. There is a tool at nuttx/tools/mksymtab that will use these CSV files as input to generate a generic symbol table. See nuttx/tools/README.txt for more information about using the mksymtab tool.