ReleaseNotes

development board's display and MicroSD support.  An SPI driver and a DMA support was included
in this 0.4.12 release, but is not yet tested.

This tarball contains a complete CVS snapshot from October 17, 2009

nuttx-0.4.13
^^^^^^^^^^^^

This is the 45th release of NuttX.  The release extends the support for the STMicro
STM32 microcontroller.  Minimal support for the STM3210E-EVAL development board based
around the STM32F103ZET6 MCU was released in NuttX-0.4.12.  This release adds:

	* A simple interface definition to support some FLASH, EEPROM, NVRAM, etc. devices.
	* Verified SPI operation using driver for SPI based FLASH parts M25P64 and M25P128.
	* Improved Cortex-M3 context switching.  This should improve context switching
	  performance be 2x in certain cases.
	* Added a USB device-side driver for the STM32.  This is an early release of a
	  very complex driver; some bugs are expected.  
	* The USB driver has been verified against the USB serial device class driver.
	  There is at least one known outstanding issue (see the full bug description in
	  the TODO list).

This release also corrects some important bugs in the early STM32 release:

	* Fixed several errors the prevented operation of NuttX on an STM32 development
	  board using USART2 as the serial console.
	* Fixed and optimization-dependent race condition in the clock initialization.
	* Fixed a critical bug in the interrupt control logic that could cause interrupt
	  operations to failed used for interrupts in a certain range.

This tarball contains a complete CVS snapshot from November 4, 2009

nuttx-4.14
^^^^^^^^^^

This is the 46th release of NuttX.  The release extends the support for the STMicro
STM32 microcontroller.  Minimal support for the STM3210E-EVAL development board based
around the STM32F103ZET6 MCU was released in NuttX-0.4.12 and extended in Nuttx-0.4.13
to include initial USB support.  This completes the STM32F103ZET6 and adds:

New Generic RTOS Features:

	* Added generic support that can be included in any block driver to provide
	  read-ahead buffering and write buffering for improved driver performance.
	* Added a generic worker thread that can used to defer processing from an
	  interrupt to a task.
	* Defined a generic SD/SDIO interface can can be bound to a MMC/SD or SDIO
	  driver to orovide SDIO support.
	* Implemented a an SDIO-based MMC/SD driver using this new SDIO interface

New STM32 Features:

	* Add support to configure an STM32 input GPIO to generate an EXTI interrupt.
	* Added support for buttons on the STM3210E-EVAL board.
	* Implemented an STM32 version of the common the SDIO interface.
	* Added a configuration to exercise the STM32 with the USB mass storage
	  device class example.

This release also corrects some important bugs in the early STM32 release:

	* Correct error handling in the mount() logic.
	* Fixed several STM32 DMA-related issues. Integrated and debugged STM32 DMA
	  functionality that was added in 0.4.12.
	* Fixed several bugs in the STM32 USB device-side driver.

NOTE:  This version, 4.14, is equivalent to what would have been called 0.4.14
to follow 0.4.13.  The zero has been eliminated from the front of the version
number to avoid confusion about the state of development:  Some have interpreted
the leading zero to mean that the code is in some way unstable.  That was not
the intent.  Beginning in January 2010, I will switch to the 2010.nn versioning
as many others have done to avoid such confusion.

This tarball contains a complete CVS snapshot from December 2, 2009

nuttx-5.0
^^^^^^^^^

This is 47th release of NuttX and the successor to nuttx-4.14.  This
major revision number has been incremented to indicate that an
incompatibility with previous nuttx releases has been introduced.  This
version adopts standard fixed width integer names as specified by the
ANSII C99 standard.  The core logic of NuttX is older than that
standard and did not conform to it.

If you have applications running on nuttx-4.14, those applications
should continue to build and execute without problem on nuttx-5.0.
However, if you have device drivers or other OS-internal logic, you
will probably have to make some minor changes to your code to use
this version.  Below is a summary of those changes:

o If you include sys/types.h to get the non-standard, fixed width
  integer types (uint32, uint16, ubyte, etc.), that is no longer
  necessary.
o Instead, you will need to include stdint.h where the new fixed width
  integer types are defined (uint32_t, uint16_t, uint8_t, etc.).
o You will have to change all occurrences of the following types:

  uint32 -> uint32_t
  uint16 -> uint16_t
  ubyte  -> uint8_t
  uint8  -> uint8_t
  sint32 -> int32_t
  sint16 -> int16_t
  sint8  -> int8_t

o In addition, the non-standard type 'boolean' must replaced with the
  standard type 'bool'.  The type definition for 'bool' is in stdbool.h

This change in typing caused small changes to many, many files.  It was
verified that all configurations in the release still build correctly
(other than the SDCC-based configurations).  Regression testing was
performed on a few configurations, but it is possible that minor build
issues still exist (if you encounter any, please let me know and I will
help you to fix them).

In the course of the regression testing, several important bugs unrelated
to the type changes were found and corrected.

o Fixed an important error in the RX FIFO handling logic of the LM3S6918
  Ethernet driver.
o Corrected the handling of TCP sequence numbers in the TCP stack.
o And other less important bugs as detailed in the ChangeLog.

The primary focus of this release was standards compatibility, but a
few new features were added including a (1) Flash Translation Layer (FTL)
that will support filesystems on a FLASH device and (2) partial ports
for the STM32F107VC and HCS12 C9S12NE64 MCUs.  Those ports are very
incomplete as of this writing.

This tarball contains a complete CVS snapshot from December 21, 2009

nuttx-5.1
^^^^^^^^^

This is the 48th release of NuttX.  This release adds support for two new
MCU architectures in various states of development:

o AT91SAM3U (http://www.atmel.com/products/at91/sam3landing.asp?family_id=605)

  This release adds support for the SAM3U-EK development board with the
  AT91SAM3U4E MCU (http://www.atmel.com/dyn/products/product_card_mcu.asp?part_id=4562).
  As with most NuttX architecutre releases, the release will be rolled out in
  two parts:  A basic port and an extended port.

  NuttX-5.1 includes the basic port for the SAM3U-EK board.  This release
  passes the NuttX OS test and is proven to have a valid OS implementation.
  It supports the basic boot-up, serial console and timer interrupts.  A
  configuration to support the NuttShell is also included.

  The extended port will also include support for SDIO-based SD cards and
  USB device (and possible LCD support).  These extensions may or may not
  happen by the Nuttx 5.2 release as my plate is kind of full now.

o LPC3131 (http://ics.nxp.com/products/lpc3000/lpc313x.lpc314x.lpc315x/)

  This release also adds the complete implementation of the basic port for
  the NXP LPC3131 MCU on the Embedded Artists EA3131 board
  (http://www.embeddedartists.com/products/kits/lpc3131_kit.php).  That port,
  unfortunately has stalled due to tools issues.  Those tool issues have
  been resolved and I am confident that the verified basic port will be
  available in NuttX-5.2.

  The extended release will follow and should include SDIO-based SD card
  support and device USB.

A few additional features and bugfixes of a minor nature were also incorporated
as detailed in the ChangeLog.

nuttx-5.2
^^^^^^^^^

This is the 49th release of NuttX.  This release completes the verification of
the basic port for the NXP LPC3131 MCU on the Embedded Artists EA3131 board
(http://www.embeddedartists.com/products/kits/lpc3131_kit.php).  This basic
port includes basic boot-up, serial console, and timer interrupts.  This port
has been verified on the using the NuttX OS test and includes a working
implementation of the NuttShell (NSH).

An extended release will follow and should include SDIO-based SD card
support and device USB.

nuttx-5.3
^^^^^^^^^

This is the 50th release of NuttX.  This release suport for one new achitecture:

  * A basic port for the NXP LPC2378 MCU on the Olimex-LPC2378 development board
    was contributed by Rommel Marcelo.

And extensions to two existing architures:

  * David Hewson contributed a dual-speed (full/high) USB device-side driver
    for the NXP LPC3131 on the Embedded Artists EA3131 development board.
  * A DMA driver and a high speed MCI driver for the Atmel AT91SAM3U are
    included (but not fully tested in this release).

Two important bugfix was also included:

  * An important fix to the USB mass storage driver was contributed by
    David Hewson.
  * A serious error in the AT91SAM3U PIO handling was fixed.