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.

nuttx-5.4
^^^^^^^^^

This is the 51st release of NuttX.  This release includes one new, important
extension to th NX graphics system (See http://www.nuttx.org/NXGraphicsSubsystem.html).

NX was develop a couple years back on hardware that supported only framebuffer
devices, that is, video hardware with video memory directly converts the memroy
content to video.  However, most MCUs that NuttX focuses on do not support such
video memory; rather, that typically only support LCDs via parallel or serial
interfaces.

This release of NuttX extends NX so that now renders directly to the LCD device
via its serial or parallel interface.  No in-memory copy of the screen memory
need be maintained so this solution should also work in MCUs with very limited
SRAM.

This initial release of this feature includes the verified NX extensions plus
a driver for the HX8347, 16-bit parallel LCD.  This LCD supports 16-bit RGB
(5:6:5).

nuttx-5.5
^^^^^^^^^

This is the 52nd release of NuttX.  This release includes one new port, some
new drivers and some important bugfixes:

  * NuttX was ported to the Luminary/TI LM3S6965 Ethernet Evaluation Kit.
    At present, that port includes an OS test configuration and a NuttShell
    (NSH) configuration with telnet support.

    MMC/SD and Networking support are provided but not thoroughly verified
    in this release: Current development efforts are focused on porting the
    NuttX window system (NX) to work with the Evaluation Kits OLED display.

  * A NuttX Ethernet driver for the Microchip ENC28J60 SPI Ethernet chip is
    available in the source tree (but has not yet been fully verified because
    I haven't properly connected it to hardware yet).

  * The Olimex STR-P711 NuttX port was extended to support the ENC28J60 and
    some new networking configurations were added.  The ENC28J60 has not
    been tested on the STR-P711, however, because of hardware issues (I don't
    think the USB powered board provides enough power for the ENC28J60 and
    I don't have the right wall wart yet).

    Along the way, external interrupt support (XTI) was added to the STMicro
    STR-P711 port and some important bugs were fixed in the STR-P711 SPI
    driver.

  * Added (optional) floating point support for printf() (contributed by
    Yolande Cates).

  * Corrected an important UDP reference counting error.  It was not a serious
    error, but it trigger an assertion was IS a serious error.

nuttx-5.6
^^^^^^^^^

This is the 53rd release of NuttX.  This release includes one several new drivers
for existing NuttX ports:

  * This port adds support for the RiT displays P14201 4-bpp, greyscale OLED.
    4-bpp greyscale support was integrated into the NX graphics sub-system and
    verified using the TI/Luminary LP3S6965 Ethernet Evaluation Kit.

  * The MP25Px driver was extended for the M24P1 FLASH part (see NOTE).

  * An I2C driver and (basic) SPI driver were added for the NXP LPC313x port.
    The I2C interface definition was extended to efficiently handle multiple I2C
    transfers (See NOTE).

    NOTE: Contributed by David Hewson.

As well as a few, important USB-related bugfixes (See the ChangeLog for details).

This release also includes the beginnings of a port for the NXP LPC1768 MCU.  However,
it is too early for that port to be useful (stay tuned for a future announce of the
availability of the LPC1768 port).

nuttx-5.7
^^^^^^^^^

This is the 54th release of NuttX.  This release adds basic support for one new
ARM Cortex-M3 architecture:

  * Added support for NXP LPC1768 MCU as provided on the Nucleus 2G board from
    2G Engineering (http://www.2g-eng.com).
  * Some initial files for the LPC17xx family were released in NuttX 5.6, but the
    first functional release for the NXP LPC1768/Nucleus2G occured with NuttX 5.7.
  * That initial basic release included timer interrupts and a serial console and was
    verified using the NuttX OS test.
  * That release includes a verified NuttShell (NSH) configuration
    (see the http://www.nuttx.org/NuttShell.html).
  * Also included are unverified SPI and USB device drivers.

Further efforts include: (1) development of a DMA support library, (2) SPI-based MMC/SD
support, and (3) verification of the USB driver.  Watch for announcement of the completed
LPC1768 port expected in NuttX-5.8.

nuttx-5.8
^^^^^^^^^

This is the 55th release of NuttX.  This includes several important bugfixes:

  * Corrects some interrupt vectoring for the TI/Stellarix LM3S port
  * Correct initialization logic for NXP LPC17xxx NuttX ports:  Power was
    not being provided to the GPIO module!
  * Corrected (but did not verify) implementation of the optional interrupt
    stack feature (all Cortex M3 architectures).
  * Correct a HardFault in the LPC17xx SSP driver.

Additional minor fixes are also included as detailed in the ChangeLog.

Several new features have been fully developed and included in this release, but
full verification of most of these new features has been blocked for a variety
of issues:

  * Added microSD support for the NuttShell (NSH) configuration in the
    Nucleus2G LPC1768 port.  For reasons that have not yet been determined,
    I have not successfully accessed the microSD card as of this writing.
  * Two USB configurations were also added for the Nucleus2G board:  One to
    support the USB serial device and one for the USB mass storage device.
    Some testing of the USB driver was performed, but full verification is
    stalled for an OTG style USB cable.
  * LEDs now work correctly on the Nucleus2G LPC1768 board.
  * The NuttX/uIP networking subsystem now supports IGMPv2 client.  IGMP
    (Internet Group Multicast Protocol) network "appliances" to join into
    multicast groups.  Outbound traffic to enter and leave multicast groups
    has been verified, but full verification will require a switch capable of
    multicast.  Issues associated with the receipt of multicast packets are likely.