From e29e0362dfe9249a359667ba339f36284de16f08 Mon Sep 17 00:00:00 2001 From: patacongo Date: Mon, 21 Dec 2009 16:29:49 +0000 Subject: [PATCH] Prep for 5.0 release git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@2405 42af7a65-404d-4744-a932-0658087f49c3 --- ChangeLog | 9 +- Documentation/NuttX.html | 202 +++++++++++++++++++-------------------- ReleaseNotes | 55 +++++++++++ 3 files changed, 164 insertions(+), 102 deletions(-) diff --git a/ChangeLog b/ChangeLog index 226a700c43..fa586028ba 100644 --- a/ChangeLog +++ b/ChangeLog @@ -980,7 +980,7 @@ driver: (1) Need to disconnect after reset received, (2) Status setup to recover from stall on TX endpoint. -5.0 2009-xx-xx Gregory Nutt +5.0 2009-12-21 Gregory Nutt * arch/hc: Adding framework to support m68hc11/12 * configs/demo9s12ne64: Configuration to support Freescale DEMO9S12NE64 @@ -1023,3 +1023,10 @@ as a result, packets were not be ACKed by the recipient and transfers would sometimes stall. This is a very important bug fix (in fact, I don't understand how TCP/IP worked at all without this fix???) + * include/nuttx/arch.h and arch/*/common/up_udelay.c - Change argument + of up_udelay() to type useconds_t to avoid warnings when sizeof(int) + is 16-bits. + * drivers/mmcsd/* - Add casts in contant expressions to avoid warnings + when sizeof(int) is 16-bits. + +5.1 2010-xx-xx Gregory Nutt diff --git a/Documentation/NuttX.html b/Documentation/NuttX.html index 2542e0df07..299963f4ce 100644 --- a/Documentation/NuttX.html +++ b/Documentation/NuttX.html @@ -8,7 +8,7 @@

NuttX RTOS

-

Last Updated: December 19, 2009

+

Last Updated: December 21, 2009

@@ -729,59 +729,76 @@ -

nuttx-4.14. +

nuttx-5.0 Release Notes:

- This 46th release of NuttX was made on December 2, 2009 and is available for download from the + This 47th release of NuttX was made on December 21, 2009 and is available for download from the SourceForge website. The change log associated with the release is available here. Unreleased changes after this release are available in CVS. These unreleased changes are listed here.

- 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 support and adds: + The previous NuttX release was 4.14. + The 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.

- New Generic RTOS Features: + 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:

    -
  • 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
    • +
  • If you include sys/types.h to get the non-standard, fixed width + integer types (uint32, uint16, ubyte, etc.), + that is no longer necessary. +
  • Instead, you will need to include stdint.h where the new fixed width + integer types are defined (uint32_t, uint16_t, uint8_t, etc.). +
  • 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
+
    +
  • In addition, the non-standard type boolean must replaced with the + standard type bool. + The type definition for bool is in stdbool.h.

- New STM32-specific Features: + This change in typing caused small changes to many, many files. + The changes 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. + Two of these are critical bugs:

    -
  • 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.
    • +
  • Fixed an important error in the RX FIFO handling logic of the LM3S6918 + Ethernet driver. +
  • Corrected the handling of TCP sequence numbers in the TCP stack.

- This release also corrects some important bugs in the earlier STM32 releases: -

    -
  • 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.
    • -
+ And other less important bug fixes as detailed in the ChangeLog.

- 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. + 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 M9S12NE64 MCUs. Those ports are very incomplete as of this writing.

@@ -1045,6 +1062,29 @@ + + + + + + + + @@ -1539,74 +1579,13 @@ Other memory:
+ Frescale M68HSC12 +

+

+ MC9S12NE64. + This port uses the Freescale DEMO9S12NE64 Evaluation Board with a GNU arm-elf toolchain* under Linux or Cygwin. +

+
    +

    + STATUS: + This port only fragmentary as of NuttX-5.0. Some initial pieces appear in that + release, but much more is needed. Time permitting, the HCS12 port may be available + int NuttX5.1. +

    +
+
@@ -1525,7 +1565,7 @@ Other memory:
- ChangeLog for Current Releases
+ ChangeLog for the Current Releases
- ChangeLog for Current Release + ChangeLog for the Current Release 
    -nuttx-4.14 2009-12-02 Gregory Nutt <spudmonkey@racsa.co.cr>
-
-	* arch/arm/src/stm32/stm32_gpio.c - Add support for configure an input GPIO
-	  to generate an EXTI interrupt.
-	* config/stm3210e-eval/src/up_buttons.c - Add support for on-board buttons.
-	* include/nuttx/rwbuffer.h -- Add generic support for read-ahead buffering
-	  and write buffering that can be used in any block driver.
-	* include/nuttx/wqueue.h -- Added a generic worker thread that can used to
-	  defer processing from an interrupt to a task.
-	* include/nuttx/sdio.h -- Defines a generic SD/SDIO interface can can be
-	  bound to a MMC/SD driver to provide SDIO-based MMC/SD support.
-	* drivers/mmcsd/mmcsd_sdio.c -- Provides a an SDIO-based MMC/SD driver.
-	* arch/arm/src/stm32/stm32_sdio.c -- Provides an STM32 implementation of
-	  the SDIO interface defined in include/nuttx/sdio.h.
-	* fs/fs_mount.c -- Correct error handling logic.  If the bind() method
-	  fails, then a reserved node is left in the tree.  This causes subsequent
-	  attempts to mount at the location to fail (reporting that the node
-	  already exists).  This is a problem for block drivers for removable
-	  media: The bind method could fail repeatedly until media is inserted.
-	* arch/arm/src/stm32/chip.h & stm32_dma.c -- Fixed several definitions
-	  that can cause compilation errors when DMA2 is enabled.
-	* arch/arm/src/stm32/stm32_dma.c - Integrated and debugged STM32 DMA
-	  functionality that was added in 0.4.12.
-	* configs/stm3210e-eval/usbstorage - Add a configuration to exercise
-	  the STM32 with the USB mass storage device class example
-	  (examples/usbstorage).
-	* configs/mcu123-lpc214x/up_usbstrg - Move LPC-specific code from
-	  examples/usbstorage to configs/mcu123-lpc214x.
-	* configs/stm321e-eval/up_usbstrg - Add STM32-specific logic for the
-	  examples/usbstorage test.
-	* arch/arm/src/stm32/stm32_usbdev.c - Fix bugs in STM32 USB device-side
-	  driver:  (1) Need to disconnect after reset received, (2) Status setup
-	  to recover from stall on TX endpoint.
-
-pascal-0.1.2 2008-02-10 Gregory Nutt <spudmonkey@racsa.co.cr>
-
-	* Add logic to build and link with the ZDS-II toolchain
-	  use with the z16f.
-	* Make sure that POFF header structures are aligned
-	* Standardized POFF file format to big-endian
-	* Break up large switch statements to lower complexity
-	  and eliminate a compiler bug
-	* Changes so that runtime compiles with SDCC.
-
-buildroot-0.1.7 2009-06-26 <spudmonkey@racsa.co.cr>
-
-	* configs/avr-defconfig-4.3.3: Added support for AVR to support a NuttX
-	  port of the ATmega128.
-	* toolchain/nxflat:  Added logic to build NuttX NXFLAT binding support tools
-	* toolchain/genromfs:  Added support for the genromfs tool
-
- - - - - -
- Unreleased Changes -
- -
    -nuttx-5.0 2009-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+nuttx-5.0 2009-12-21 Gregory Nutt <spudmonkey@racsa.co.cr>
 
 	* arch/hc: Adding framework to support m68hc11/12
 	* configs/demo9s12ne64: Configuration to support Freescale DEMO9S12NE64
@@ -1649,14 +1628,19 @@ nuttx-5.0 2009-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
 	  as a result, packets were not be ACKed by the recipient and transfers
 	  would sometimes stall.  This is a very important bug fix (in fact, I
 	  don't understand how TCP/IP worked at all without this fix???)
+	* include/nuttx/arch.h and arch/*/common/up_udelay.c - Change argument
+	  of up_udelay() to type useconds_t to avoid warnings when sizeof(int)
+	  is 16-bits.
+	* drivers/mmcsd/* - Add casts in contant expressions to avoid warnings
+	  when sizeof(int) is 16-bits.
 
-pascal-2.0 2010-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+pascal-2.0 2010-12-21 Gregory Nutt <spudmonkey@racsa.co.cr>
 
 	* Updated to use standard C99 types in stdint.h and
 	  stdbool.h.  This change was necessary for compatibility
-	  with NuttX-5.0.
+	  with NuttX-5.0 (any beyond).
 
-buildroot-1.8 2010-xx-xx 
+buildroot-1.8 2009-12-21 <spudmonkey@racsa.co.cr>
 
 	* configs/cortexm3-defconfig-4.3.3: Added support for NuttX NXFLAT
 	  tools.
@@ -1669,6 +1653,22 @@ buildroot-1.8 2010-xx-xx 
 	* configs/m32c-defconfig-4.3.3: Update to m32c-defconfig-4.2.4
+ + + + +
+ Unreleased Changes +
+ +
    +nuttx-5.1 2010-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+
+pascal-2.1 2010-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+
+buildroot-1.9 2010-xx-xx 
+
+
diff --git a/ReleaseNotes b/ReleaseNotes index dafca940b1..69a5d4d70d 100644 --- a/ReleaseNotes +++ b/ReleaseNotes @@ -1072,4 +1072,59 @@ 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