Prep for 0.3.17 releasenuttx-3.17

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@1098 42af7a65-404d-4744-a932-0658087f49c3

3 files changed, 88 insertions, 90 deletions

diff --git a/nuttx/ChangeLog b/nuttx/ChangeLog
index accf731ee..31c6a09f3 100644
--- a/nuttx/ChangeLog
+++ b/nuttx/ChangeLog
@@ -498,7 +498,7 @@
 	* Fixed an error in read(); it was not setting the errno on errors returned
 	  from the driver.
 
-0.3.17 2008-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+0.3.17 2008-10-28 Gregory Nutt <spudmonkey@racsa.co.cr>
 	* Incorporate patch "[2164503] nuttx-0.3.16 does not build for ARM with USB disabled"
 	* Reduced the amount of memory reserved for USB serial control requests.  It
 	  was unnecessarily large.
@@ -520,6 +520,11 @@
 	  the request queue (M320 driver also fixed, untested)
 	* Correct another error in the NXP LPC214x USB device driver that caused read failures
 	  when the request buffer size was larger than maxpacket.
+	* Numerous corrections/extensions to the USB tracing logic included in 0.3.16 (but
+	  not integrated until 0.3.17)
+	* Fixed another bug in the NXP LPC214x USB device driver:  After a stalled endpoint
+	  is resumed (view CLEAR FEATURE), we must restart the IN (outgoing) queue.
 
+0.3.18 2008-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
 
 
diff --git a/nuttx/Documentation/NuttX.html b/nuttx/Documentation/NuttX.html
index a93e24cff..94c694091 100644
--- a/nuttx/Documentation/NuttX.html
+++ b/nuttx/Documentation/NuttX.html
@@ -8,7 +8,7 @@
   <tr align="center" bgcolor="#e4e4e4">
     <td>
       <h1><big><font color="#3c34ec"><i>NuttX RTOS</i></font></big></h1>
-      <p>Last Updated: October 27, 2008</p>
+      <p>Last Updated: October 28, 2008</p>
     </td>
   </tr>
 </table>
@@ -385,6 +385,13 @@
   <td><br></td>
   <td>
     <p>
+      <li>Generic driver for SPI-based MMC/SD cards.</li>
+    </p>
+</tr>
+<tr>
+  <td><br></td>
+  <td>
+    <p>
       <li>ROMFS filesystem support.</li>
     </p>
 </tr>
@@ -462,7 +469,7 @@
   <td><br></td>
   <td>
     <p>
-      <li>Device-dependent USB class drivers available for USB serial.</li>
+      <li>Device-dependent USB class drivers available for USB serial and for USB mass storage.</li>
     </p>
 </tr>
 <tr>
@@ -523,66 +530,36 @@
   </tr>
 </table>
 
-<p><b>nuttx-0.3.16</b>.
-  The 28th release of NuttX (nuttx-0.3.16) is available for download
+<p><b>nuttx-0.3.17</b>.
+  The 29th release of NuttX (nuttx-0.3.16) is available for download
   from the <a href="http://sourceforge.net/project/showfiles.php?group_id=189573">SourceForge</a>
   website.
   The change log associated with the release is available <a href="#currentrelease">here</a>.
   Unreleased changes after this release are available in CVS.
   These unreleased changes are listed <a href="#pendingchanges">here</a>.
 </p>
-<p><b>USB Support</b>.
-  The nuttx-0.3.16 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.
-</p>
-<p>
-  At present USB device controller drivers are included for:
+<p><b>MMC/SD and USB Mass Storage Support</b>.
+  The nuttx-0.3.17 release includes  additional support for USB in NuttX.
+  The following new features were added:
   <ul>
-    <li>
-      The NXP LPC214x.  This driver has been verified and is an early alpha stage in quality.
-    </li>
-    <li>
-      TI DM320.  Coding for this driver is complete but it is completely untested as of this release.
-    </li>
+    <li>Added support for SPI-based MMC/SD cards (with an SPI driver for the NXP LPC214x).</li>
+    <li>Added USB storage class device side driver (BBB)</li>
+    <li>Added an example that demonstrates the USB storage class by exporting the SPI based MMC/SD card on the NXP LPC214x.</li>
   </ul>
 </p>
 <p>
-  A controller-independent class driver is also included for:
-  <ul>
-    <li>
-      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.
-    </li>
-  </ul>
+  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).
 </p>
-<p><b>Other New Features</b>.
-  Other new features include:
-  <ul>
-    <li>
-      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).
-    </li>
-  </ul>
-</p>
-<p><b>Bugs Fixed</b>.
-  A few bugs were also fixed:
-  <ul>
-    <li>
-      Fixed the frequency of system timer interrupts in the NXP LPC214x port
-      (off by 20x in nuttx-0.3.15)
-    </li>
-    <li>
-      Fixed serial driver bugs related to (1) open counts and (2) recognizing
-      O_NONBLOCK on read.
-    <li>
-      Fixed an error in read(); it was not setting the <code>errno</code> on errors returned
-      from the driver.
-    </li>
-  </ul>
+<p><b>Bugs Fixed</b>
+  Several important bugs were also fixed in the FAT file system, USB serial driver and
+  NXP LPC214x USB controller driver (see the current <a href="#currentrelease">ChangeLog</a> for details).
 </p>
 <p>
+  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.
   As usual, any feedback about bugs or suggestions for improvement would be greatly appreciated.
 </p>
 
@@ -1085,24 +1062,32 @@ Other memory:
 </table>
 
 <pre><ul>
-nuttx-0.3.16 2008-10-10 Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
-	* Added header files defining a common USB device controller architecture
-	* Added USB device side driver for the LPC214x
-	* Correct the frequency of system timer interrupts in the NXP LPC214x port
-	  (off by 20x in nuttx-0.3.15)
-	* 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).
-	* Added USB serial class device side driver (emulates Prolific PL2303
-	  serial-to-USB adaptor)
-	* Add LPC214x USB serial configuration; Add examples/usbserial test
-	* Added USB device side driver for the DM320 (untested at initial release)
-	* Fixed an error in a previous (post 0.3.15) check-in that broke the LPC214x
-	  system timer.
-	* 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.
+nuttx-0.3.17 2008-10-28 Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
+	* Incorporate patch "[2164503] nuttx-0.3.16 does not build for ARM with USB disabled"
+	* Reduced the amount of memory reserved for USB serial control requests.  It
+	  was unnecessarily large.
+	* Added LPC214x SPI1 driver to interface with MMC on mcu123.com board.
+	* Added a simple SPI-based MMC/SD block driver
+	* NSH: Add LPC214x-specific support to NSH; NSH now mounts any SD cards in the slot.
+	* FAT: Fix access to unaligned 32-bit values in partion table (start sector &amp; size)
+	* Fixed a problem with a un-initialized variable in the USB serial driver.
+	* Added USB storage NXP LPC214x configuration
+	* Added a test for USB storage under examples/usbstorage
+	* Fixed a bug in the LPC214x USB driver: It was not properly clearing a HALTed
+	  endpoints (other than EP) on receipt of CLEAR FEATURES request.
+	* Added USB storage class device side driver (BBB)
+	* Fixed a bug in the LPC214x USB driver: It was not properly handling request buffers
+	  larger then the endpoint's max packet (DM320 driver also fixed, untested)
+	* Added logic to the USB device interface:  A bit is needed to force the driver to
+	  to terminate an IN transfer with a short packet (zero-length if necessary).
+	* Fix an error in the NXP LPC214x USB device driver that was causing corruption of
+	  the request queue (M320 driver also fixed, untested)
+	* Correct another error in the NXP LPC214x USB device driver that caused read failures
+	  when the request buffer size was larger than maxpacket.
+	* Numerous corrections/extensions to the USB tracing logic included in 0.3.16 (but
+	  not integrated until 0.3.17)
+	* Fixed another bug in the NXP LPC214x USB device driver:  After a stalled endpoint
+	  is resumed (view CLEAR FEATURE), we must restart the IN (outgoing) queue.
 
 pascal-0.1.2 2008-02-10 Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
 
@@ -1128,28 +1113,7 @@ buildroot-0.1.0 2007-03-09 &lt;spudmonkey@racsa.co.cr&gt
 </table>
 
 <pre><ul>
-nuttx-0.3.17 2008-xx-xx Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
-	* Incorporate patch "[2164503] nuttx-0.3.16 does not build for ARM with USB disabled"
-	* Reduced the amount of memory reserved for USB serial control requests.  It
-	  was unnecessarily large.
-	* Added LPC214x SPI1 driver to interface with MMC on mcu123.com board.
-	* Added a simple SPI-based MMC/SD block driver
-	* NSH: Add LPC214x-specific support to NSH; NSH now mounts any SD cards in the slot.
-	* FAT: Fix access to unaligned 32-bit values in partion table (start sector &amp; size)
-	* Fixed a problem with a un-initialized variable in the USB serial driver.
-	* Added USB storage NXP LPC214x configuration
-	* Added a test for USB storage under examples/usbstorage
-	* Fixed a bug in the LPC214x USB driver: It was not properly clearing a HALTed
-	  endpoints (other than EP) on receipt of CLEAR FEATURES request.
-	* Added USB storage class device side driver (BBB)
-	* Fixed a bug in the LPC214x USB driver: It was not properly handling request buffers
-	  larger then the endpoint's max packet (DM320 driver also fixed, untested)
-	* Added logic to the USB device interface:  A bit is needed to force the driver to
-	  to terminate an IN transfer with a short packet (zero-length if necessary).
-	* Fix an error in the NXP LPC214x USB device driver that was causing corruption of
-	  the request queue (M320 driver also fixed, untested)
-	* Correct another error in the NXP LPC214x USB device driver that caused read failures
-	  when the request buffer size was larger than maxpacket.
+nuttx-0.3.18 2008-xx-xx Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
 
 pascal-0.1.3 2008-xx-xx Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
 
diff --git a/nuttx/ReleaseNotes b/nuttx/ReleaseNotes
index afb62b837..73de15289 100644
--- a/nuttx/ReleaseNotes
+++ b/nuttx/ReleaseNotes
@@ -650,4 +650,33 @@ diff -u -r1.13 up_internal.h
 
  #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.
+
+
+