nuttx/ReleaseNotes

nuttx-0.1.0
^^^^^^^^^^^

This is the initial.  This initial includes the complete NuttX RTOS
with support for the Linux user mode simulation and the TI TMS320C5471
(Arm7) processor.  Partial support for the 87C52 is included.

This release has been verified on both the Linux user-mode and C5471
platforms using the test program under examples/ostest.  Test results
for the C5471 can be found in arch/c5471/doc/test-results.txt.

This tarball contains a complete CVS snapshot from March 9,2007.

nuttx-0.1.1
^^^^^^^^^^^

This is the second release of NuttX.  This release includes the following.
See the ChangeLog for more detailed description of the changes.

(1) General OS bugfixes (see the ChangeLog for details),
(2) bugfixes for the TI TMS320C5471 (Arm7) platform (see
    the ChangeLog)
(3) Complete support for the 87C52. (However, the 87C52
    release is not stable enough for general usage).
(4) Added the beginning of a shell call NuttShell (nsh)

This release has been verified on the Linux user-mode platform, the
Spectrum Digital TMS320C5471 EVM, and the PJRC 87C52 development board
using the test program under examples/ostest.

STATUS: The development status remains as ALPHA until further testing
is performed.

This tarball contains a complete CVS snapshot from March 14, 2007.

nuttx-0.1.2
^^^^^^^^^^^

This is the third release of NuttX.  This release is
primarily a bugfix release with minimal new features.  See
the ChangeLog for a more detailed description of the 
changes.

(1) Several important OS and ARM7 bugfixes,
(2) opendir(), closedir(), readdir(), etc. added
(3) Added C5471 watchdog timer.
(4) Created a shareable, serial driver.
(5) Added 'ls' command to NuttShell (nsh)
(6) Added a test of the round robin scheduler

This release has been verified on the Linux user-mode 
platform, the  Spectrum Digital TMS320C5471 EVM using the
test program under examples/ostest.

This tarball contains a CVS snapshot from March 19, 2007.

nuttx-0.2.1
^^^^^^^^^^^

This is the fourth relese of NuttX.  This release adds adds
support for a new platform, restructures many header files,
and adds a few new features:

(1) Support for Neuros OSD / DM320
(2) Restructuring of header files for better POSIX compliance
(3) Added kill()
(4) Added POSIX timers
(5) bugfixes and documentation updates

This release has been verified on the Linux user-mode 
platform, the  Spectrum Digital TMS320C5471 EVM, and the 
Neuros OSD  using the test program under examples/ostest.  Because
of the stability of these tests, the project status
has been upgraded to 'beta.'

This tarball contains a complete CVS snapshot from March 22, 2007.

nuttx-0.2.2
^^^^^^^^^^^^

This is the fifth release of NuttX.  There is no major new
functionality in this release.  This release adds support
for new pthread barrier APIs, changes the directory
structure, to better handle different board configurations
using the same processor architecture, and corrects a few
defects.

See the ChangeLog for a complete list of changes.

This release has been verified on the Linux user-mode
platform and the Neuros OSD using the test program under
examples/ostest.  There are no known, critical defects but
the project development status remains at 'beta' status
pending further test and evaluation.

This tarball contains a complete CVS snapshot from
March 26, 2007.

nuttx-0.2.3
^^^^^^^^^^^^

This is the sixth release of NuttX.  This release is
primarily a bugfix release.  Numerous problems were fixed
as detailedin the change log.  New functionality includes
support for timed message queues.

See the ChangeLog for a complete list of changes.

This release has been verified on the Linux user-mode 
platform and the Neuros OSD using the test program under
examples/ostest. The results of the testing is available in
the source tree under configs/ntosd-dm320/doc/test-results.
There are no known, critical defects but the project
development status remains at 'beta' status pending further
test and evaluation.

This tarball contains a complete CVS snapshot from March 29,
2007.

nuttx-0.2.4
^^^^^^^^^^^^

This is the 7th release of NuttX.  This release is only to roll out
build changes to better support different SoC's that use the same
processor architecture.  In particular, the two existing ARM architectures,
c5471 and DM320 were combined into a single ARM directory.  This was done
in preparation for an LPC2148 port that is currently in progress.  There
is NO new functionality or significant bufixes in this release.

See the ChangeLog for a complete list of changes.

This release has been verified on the Linux user-mode platform
and the Neuros OSD using the test program under examples/ostest.
The results of the testing is available in the source tree under
configs/ntosd-dm320/doc/test-results and under configs/sim/doc/test-results.
There are no known, critical defects but the project development status
remains at 'beta' status pending further test and evaluation.

This tarball contains a complete CVS snapshot from April 28, 2007.

nuttx-0.2.5
^^^^^^^^^^^^

This is the 8th release of NuttX.  This release includes:

(1) Several bug fixes
(2) Initial support for FAT filesystems.  Testing has not
    been exhaustive and some functionality is missing
   (mkdir, stat, unlink chmod, and rename functionality is 
    not yet implemented).
(3) Support for the NXP lpc2148 processor is included but
    is untested as of this writing.  The current 
    implementation includes only support for serial console
    and timer interrupt.

See the ChangeLog for a complete list of changes.

This release has been verified only on the Linux user-mode
platform.

This tarball contains a complete CVS snapshot from May 19,
2007.

nuttx-0.2.6
^^^^^^^^^^^

This is the 9th release of NuttX.  This is primarily a
bugfix release to correct a number of problems introduced
with the 0.2.5 release. This release does include some FAT
filesystem extensions including unlink(), mkdir(), rmdir(),
rename(), opendir(), closedir(), readdir(), seekdir(),
telldir(), rewindir().  There are some pending FAT changes
that did not make it into this release including stat(),
truncate(), and long file names.

See the ChangeLog for a complete list of changes.

This release has been verified only on the Linux user-mode
platform.

This tarball contains a complete CVS snapshot from May 26,
2007.

nuttx-0.2.7
^^^^^^^^^^^

This is the 10th release of NuttX.  This is primarily a bugfix releaseto correct a
number of problems reported to me (thanks Didier!). This release does include the
final changes complete the FAT filesystem logic including stat(), tatfs(), and non-
standard APIs to manage FAT
attributes.  At present,FAT long file names and file trunction() are still not
supported.

See the ChangeLog for a complete list of changes.

This release has been verified only on the Linux user-mode platform.

This tarball contains a complete CVS snapshot from June 9, 2007.

nuttx-0.2.8
^^^^^^^^^^^

This is the 11th release of NuttX.  This release (1) corrects important bugs
in opendir and realloc, (2) adds support for environment variables, (3) adds
several new C library interfaces, and (4) extends several example programs.

See the ChangeLog for a complete list of changes.

This release has been verified only on the Linux user-mode platform.

This tarball contains a complete CVS snapshot from July 2, 2007.

nuttx-0.3.0
^^^^^^^^^^^

This is the 12th release of NuttX.  This release includes the initial
integration of a network subsystem and the uIP TCP/IP stack into NuttX
(see http://www.sics.se/~adam/uip/index.php/Main_Page).  Also included
is a device driver for the Davicom DM90x0 ethernet controller.

This integration is very preliminary.  Only a small portion of the
network functionality has been integrated and there are a number of
open issues (see the TODO file).  The network subsystem is pre-alpha
at this point in time.  I expect that it will stabilize and mature
over the next few releases.

The baseline functionality of NuttX continues to mature and remains at
post-beta (as long as the network is not used).

See the ChangeLog for a complete list of changes.

This release has been verified only on the Neuros OSD (DM320 ARM9)
platform using the DM90x0 driver.

This tarball contains a complete CVS snapshot from November 6, 2007.

nuttx-0.3.1
^^^^^^^^^^^

This is the 13th release of NuttX and the second release containing
the integration of a network subsystem and the uIP TCP/IP, UDP, and
ICMP stacks into NuttX (see http://www.sics.se/~adam/uip/index.php/Main_Page).

Many network-related problems have been fixed and the implementation
has matured significantly.  However, the level of network reliability
is probably still at the pre-alpha or early level.  It is sufficiently
complete that you may begin to perform some network integration and
is exepcted to achieve beta level of reliability over the next few
releases.

The baseline functionality of NuttX continues to mature and remains at
post-beta (as long as the network is not used).

See the ChangeLog for a complete list of changes.

This release has been verified only on the Neuros OSD (DM320 ARM9)
platform using the DM90x0 driver.

This tarball contains a complete CVS snapshot from November 19, 2007.

nuttx-0.3.2
^^^^^^^^^^^

This is the 14th release of NuttX and the 3rd release containing
the integration of a network subsystem and the uIP TCP/IP, UDP, and
ICMP stacks into NuttX (see http://www.sics.se/~adam/uip/index.php/Main_Page).

Many network-related problems have been fixed and the implementation
has matured significantly.  This release consists of:

o TCP-related bug-fixes
o TCP performance improvements
o Initial UDP integration
o Initial uIP micro webserver integration

See the ChangeLog for a complete list of changes.

The level of network reliability is at alpha level is expected to
achieve beta level of reliability over the next few releases.

The baseline functionality of NuttX continues to mature and remains at
post-beta.

This release has been verified only on the Neuros OSD (DM320 ARM9)
platform using the DM90x0 driver.

This tarball contains a complete CVS snapshot from November 23, 2007.

nuttx-0.3.3
^^^^^^^^^^^

This is the 15th release of NuttX and the 4th release containing
the integration of a network subsystem and the uIP TCP/IP, UDP, and
ICMP stacks into NuttX (see http://www.sics.se/~adam/uip/index.php/Main_Page).

Many network-related problems have been fixed and the implementation
has matured significantly.  This release consists of:

o TCP-related bug-fixes for disconnecting sockets
o Correction of some TCP read-ahead logic
o TCP performance improvements
o Misc. additions and cleanup (See the ChangeLog for a complete list of
  changes).

The level of network reliability is at an early beta release level.  The
baseline functionality of NuttX continues to mature and remains at
post-beta. Open network-related issues include only:

o Some minor unimplemented BSD socket functionality,
o Thread safety issues: the same socket cannot be used concurrently on
  different threads.
o Pending design changes necessary to support multiple network interfaces.
o IPv6 support is incomplete.

This release has been verified only on the Neuros OSD (DM320 ARM9)
platform using the DM90x0 driver. Any feedback for improving the network
reliability/performance would be greatly appreciated.

This tarball contains a complete CVS snapshot from November 28, 2007.

nuttx-0.3.4
^^^^^^^^^^^

This is the 16th release of NuttX and the 5th release containing
the integration of a network subsystem and the uIP TCP/IP, UDP, and
ICMP stacks into NuttX (see http://www.sics.se/~adam/uip/index.php/Main_Page).

This release is primarily a bug-fix release.  New features include
only:

o TELNET front-end to NSH,
o DHCPC server functionality, and
o C5471 Ethernet driver.

Numerous network related problems were fixed related to DHCPC, UDP
input processing, UDP broadcast, send timeouts, and bad compilation when
uIP is compiled at high levels of optimization.

The level of network reliability is at a strong beta release level.  The
baseline functionality of NuttX continues to mature and remains at
post-beta or production level.

Parts of this release were verified only on the Neuros OSD (DM320 ARM9)
platform using the DM90x0 Ethernet driver and other parts on the Spectrum
Digital C5471 EVM using the C5471 Ethernet driver. Any feedback about bugs
or suggestions for improving the network reliability/performance would be
greatly appreciated.

This tarball contains a complete CVS snapshot from December 10, 2007.

nuttx-0.3.5
^^^^^^^^^^^

This is the 17th release of NuttX this release is primarily a bug-fix
release and intended to synchronize with the current CVS contents.  See
the ChangeLog for a detailed list of changes and fixes.

This release were verified only on the Spectrum Digital C5471 EVM using
the C5471 Ethernet driver. Any feedback about bugs or suggestions for
improvement would be greatly appreciated.

This tarball contains a complete CVS snapshot from December 18, 2007.

nuttx-0.3.6
^^^^^^^^^^^

This is the 18th release of NuttX.  This release contains on a few
changes.  The primary purpose of this release is to synchronize with
the release of the pascal-0.1.0 add-on package.

This release of NuttX includes the following changes:

* Fixes for use with SDCC compiler
* Added a simulated z80 target (arch/z80)
* Fix deadlock errors when using stdio but with no buffering
* Add support for the add-on Pascal P-Code interpreter (pcode/)
  (see the pascal-0.1.0 package)

This release were verified only on the simulated Z80 and and host
simulation targets.  As usual, any feedback about bugs or suggestions
for improvement would be greatly appreciated.

This tarball contains a complete CVS snapshot from January 6, 2007.

====

There was an error in the initial 0.3.6 release that prevented
a successful build unless the Pascal add-on was present.  The
tarball was patched to include the fix.  Make sure that you download
the nuttx-0.3.6.1.tar.gz version to avoid this problem.

nuttx-0.3.7
^^^^^^^^^^^

This is the 19th release of NuttX.  This release includes the
preliminary port of NuttX to the ZiLOG z16f 16-bit microcontroller.
This port was verified using the ZiLOG z16f2800100zcog Development
and the ZiLOG ZDS-II toolchain. See http://www.zilog.com for
further information.

I emphasize that this is a preliminary release of the z16f port and
is only alpha or, perhaps, pre-alpha quality as of this writing.
There are a list of known issues in the TODO file in the root of
the NuttX directory.  The overall quality of NuttX (excluding the
z16f port) continues to improve beyond the late beta level.

The z16f port required numerous changes to NuttX to handle:

* NEAR and FAR addressing, and
* Use of a Windows native toolchain in a Cygwin build environment.

In addition to the z16f port, at least one very critical bug was
found and corrected in NuttX:  The thread-specific errno value of one
task was being randomly trashed when a different thread exitted.

This release were verified on the ZiLOG z16f2800100zcog, Neuros OSD
(ARM9), and the simulation platforms.  As usual, any feedback about bugs
or suggestions for improvement would be greatly appreciated.

This tarball contains a complete CVS snapshot from January 31, 2008.

nuttx-0.3.8
^^^^^^^^^^^

This is the 20th release of NuttX.  This is a minor bugfix release.
It corrects a few minor problems, adds a few minor features, and
continues the integration of the ZiLOG Z18F and of the Pascal P-Code
add-on.  This release is synchronized with the release of Pascal-0.1.2.

This tarball contains a complete CVS snapshot from February 10, 2008.

nuttx-0.3.9
^^^^^^^^^^^

This is the 21st release of NuttX.  This is a minor future enhancement
release.  This release includes support for the ZiLOG Z8Encore! micro-
controller.  Also included is the initial framework for support for
the Z80, XTRS platform (http://www.tim-mann.org/xtrs.html).

This released has been verified only on the ZiLOG ZDS-II Z8Encore!
chip simulation.

This tarball contains a complete CVS snapshot from March 9, 2008.

nuttx-0.3.10
^^^^^^^^^^^^

This is the 22nd release of NuttX.  This is an important bug fix release.
This release incorporates fixes to correct critical list handling errors
in task shutdown logic: One in timer deletion logic (timer_delete.c) and one
in stream logic (lib_init.c).  This release also includes support to ZiLOG EZ80Acclaim
microcontrooler (EZ80F91 chip) and configurations fot the ZiLOG z8f64200100kit (Z8F6423)
and ez80f0910200kitg (EZ80F091) development kit.

nuttx-0.3.11
^^^^^^^^^^^^

This is the 23rd release of NuttX.  This is another important bugfix release.
This releases fixes several bugs:

* Two POSIX timer bugs: a memory leak as well a fatal sequencing error.
* Several FAT filesystem errors.
* A deadlock that can occur in opendir()

A few new features were also added:

* Support for recursive mutexes
* Added a RAM disk block driver
* The host simulator no longer uses direct Linux system calls and now also works on Cygwin.
* The OS test was strengthen and now runs as an endurance test

These changes were verified only on the Host simulator under Cygwin.  Please report
any errors to me.

This tarball contains a complete CVS snapshot from June 1, 2008.

nuttx-0.3.12
^^^^^^^^^^^^

This is the 24th release of NuttX.  This release includes some minor bugfixes as well
as a few new features.  Bugs fixed include:

* Corrected an error in recursive mutex implementation.
* task_create() was only dup'in the first three file descriptors.
* Fixed driver open reference counting errors in dup(), dup2(), and exit().
* Fixed error handling logic in fflush().

New features were also added:

* Pipes and pipe() API
* FIFOs and mkfifo() API
* mkfatfs() API can be used to format FAT file systems.

These changes were verified only on the Host simulator under Cygwin.  Please report
any errors to me.

This tarball contains a complete CVS snapshot from August 10, 2008.

nuttx-0.3.13
^^^^^^^^^^^^

This is the 25th release of NuttX.  This release includes some important bugfixes as well
as a few new features.  Bugs fixed include:

* Fixed problems with Cygwin-based console input.  NSH now works with the Cygwin simulator.
* sched_get_priority_max/min returned error on SCHED_RR
* Corrected detection of End-of-File in fgets()
* Fixed an error in opendir() that could cause an assertion to fail inappropriately.
* Corrected an error in the FAT that caused files opened for writing with O_APPEND to fail.
* Fix error in getopt() when called with argc==1
* Fix error in stat() when used on the root directory
* Fixed a critical bug that effects the way that environment variables are shared amongst
  pthreads.
* uIP port now supports multi-threaded, concurrent socket access.  So, for example, one
  thread can be reading from a socket while another is writing to the socket.

New features were also added:

* New OS APIs: chdir() and getcwd()
* The Nuttx shell (NSH) has been extended in many ways.
  - New commands: mkfatfs, mkfifo, sleep, usleep, nice, sh, cd, and pwd commands
  - New memory inspection commands and heap usage commands
  - New capabilities: Execution of commands in background, execution of simple scripts,
    redirection of command output, last command status ($?)
  - Now supports if-then[-else]-fi construct
  - and other features as noted in the ChangeLog.

These changes were verified only on the Host simulator under Cygwin and under Linux and
also on the Neuros OSD (ARM9).  Please report any errors to me.

This tarball contains a complete CVS snapshot from September 1, 2008.

nutt-0.3.14
^^^^^^^^^^^

This is the 26th release of NuttX.  This release includes some important bugfixes as well
as a few new features.  Critical bugs fixed include:

  FAT FS:
  * Fixed several critical bugs with regard to fat reading and writing and FAT12
    accesses.  Basically the FAT FS only worked with my tiny test files and test
    cases.  A lot of stronger FAT tested is still needed!!
  * Fixed another FAT bug in implementation of FAT lseek; this prohibit correct
    random access to large files.

  Network:
  * Corrected a critical bug that may prevent recvfrom from receiving packets from
    most remote UDP port numbers.
  * Corrected an error in multi-threaded socket handling in send() and sendto().
    Outgoing data could overwrite incoming data.
  * Corrected IP checksum calculation in ICMP and UDP message send logic.
  * Corrected an error in send() timeout logic.

New features were also added:

  Network:
  * Added support for application access to ICMP protocol stacks; Added
    ping request logic (net/uip).
  * Added basic TFTP client logic (netutils/tftpc).

  NuttShell (NSH):
  * New commands: 'test', '[', 'ping', 'mkrd', 'xd', andTFTP 'get' and 'put'
    commands (See the new NuttShell User Guide for additional information).

Other less critical bugs were also fixed and other less important features were
were added (See the ChangeLog for details).

These changes were verified only on the Neuros OSD (ARM9).  Please report any errors to me.

This tarball contains a complete CVS snapshot from September 8, 2008.

nutt-0.3.15
^^^^^^^^^^^

This is the 27th release of NuttX.  This release includes some new features:

  * Adds support for the ROMFS filesystem
  * ROMFS supports mmap() to provide eXecute In Place (XIP) capability
  * NuttShell (NSH) can be configured to use ROMFS to provide a tiny read-only
    filesystem with a startup script in /etc.
  * Completed the basic port of the NXP LPC2148 on the mcu123.com board.
    The basic port includes successful booting, timer interrupts, serial console,
    succesfully passing the examples/ostest, and a NuttShell (NSH) configuration.

These changes were verified only on the mcu123.com NXP LPC2148 board.  Please report
any errors to me.

This tarball contains a complete CVS snapshot from September 20, 2008.

nutt-0.3.16
^^^^^^^^^^^

This is the 28th release of NuttX.  This release includes the first support for
USB in NuttX.  A set of USB APIs were added to support USB device controller
drivers and bindings to USB device class drivers.  The form of the interface
was inspired by the Linux Gadget APIs.

At present USB device controller drivers are included for:

  * The NXP LPC214x.  This driver has been verified and is an early alpha
    stage in quality.
  * TI DM320.  Coding for this driver is complete but it is completely untested
    as of this release.

A controller-independent class driver is also included for:

  * USB serial class device driver (emulates the Prolific PL2303 serial-to-USB
    adaptor).  This drver has only been verified with the Linux host PL2303
    driver.

Other new features include:

  * Add an option to set aside a separate stack for interrupt handling (ARM only).
    This is useful when memory is constrained, there are multiple tasks, and
    the interrupt stack requirement is high (as when USB is enabled).

A few bugs were also fixed:

  * Fixed the frequency of system timer interrupts in the NXP LPC214x port
    (off by 20x in nuttx-0.3.15)
  * Fixed serial driver bugs related to (1) open counts and (2) recognizing
    O_NONBLOCK on read.
  * Fixed an error in read(); it was not setting the errno on errors returned
    from the driver.

These changes were verified only on the mcu123.com NXP LPC2148 board using with
a Linux host.  Please report any errors to me.

This tarball contains a complete CVS snapshot from Octobor 10, 2008.

UPDATE
^^^^^^
This release does not build for the ARM target when USB is disabled.  Here is the fix:

Index: arch/arm/src/common/up_internal.h
===================================================================
RCS file: /cvsroot/nuttx/nuttx/arch/arm/src/common/up_internal.h,v
retrieving revision 1.13
diff -u -r1.13 up_internal.h
--- arch/arm/src/common/up_internal.h   6 Oct 2008 16:20:52 -0000       1.13
+++ arch/arm/src/common/up_internal.h   13 Oct 2008 20:48:21 -0000
@@ -200,7 +200,8 @@
 extern void up_usbinitialize(void);
 extern void up_usbuninitialize(void);
 #else
-# define up_netinitialize()
+# define up_usbinitialize()
+# define up_usbuninitialize()
 #endif

 #endif /* __ASSEMBLY__ */

nuttx-0.3.17
^^^^^^^^^^^^

This is the 29th release of NuttX.  This release includes the additional support for
USB in NuttX.  The following new features were added:

  * Added support for SPI-based MMC/SD cards (with an SPI driver for the NXP LPC214x).
  * Added USB storage class device side driver (BBB)
  * Added an example that demonstrates the USB storage class by exporting the SPI
    based MMC/SD card on the NXP LPC214x.

This is an early alpha release of these drivers.  At present they only work with
debug features enabled so there are probably some race conditions that occur only
with debug features disabled (anyone out there with a USB analyzer?  I would love
to know what is happening).

At present USB device controller drivers are included for:

Several important bugs were also fixed in the FAT file system, USB serial driver and
NXP LPC214x USB controller driver (see the ChangeLog for details).

These changes were verified only on the mcu123.com NXP LPC2148 board using a Linux
development environment.  USB testing was performed using both a Linux host and a WinXP
host.  Please report any errors to me.

This tarball contains a complete CVS snapshot from Octobor 28, 2008.