diff --git a/ChangeLog b/ChangeLog index a00a7e9f21..43007c753d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1418,7 +1418,7 @@ * drivers/usbhost -- Add a USB host class driver for the (Bulk-Only) USB Mass Storage Class. -5.17 2011-xx-xx Gregory Nutt +5.17 2011-01-19 Gregory Nutt * include/nuttx/usb -- rename usb_storage.h to storage.h. * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Add support for low-speed devices. @@ -1436,4 +1436,6 @@ * configs/olimex-lpc1766stk/hidkbd - Added a configuration to build the USB host HID keyboard class driver test for the LPC17xx. * Ran the tool CppCheck (http://sourceforge.net/apps/mediawiki/cppcheck) and - fixed several errors in the code identified by the tool. \ No newline at end of file + fixed several errors in the code identified by the tool. + +5.18 2011-xx-xx Gregory Nutt diff --git a/Documentation/NuttX.html b/Documentation/NuttX.html index 692752ae84..c7ad3a5ec0 100644 --- a/Documentation/NuttX.html +++ b/Documentation/NuttX.html @@ -800,153 +800,31 @@ -

nuttx-5.16 Release Notes: - +

nuttx-5.17 Release Notes:

- The 63rd release of NuttX, Version 5.16, was made on January 10, 2010 and is available for download from the + The 64th release of NuttX, Version 5.17, was made on January 19, 2010 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.

- This release includes initial support for USB host in NuttX. - The USB host infrstruture is new to NuttX. - This initial USB host release is probably only beta quality; - it is expected the some bugs remain in the logic and that the functionality requires extension. -

+ This release follows close on the heels of the 5.16 release and extends the USB host capabilities first introduced in that version.

- Below is a summary of the NuttX USB host implementation as extracted from the - NuttX Porting Guide: -

    -

    6.3.9 USB Host-Side Drivers

    - -
      -
    • -

      - include/nuttx/usb/usbhost.h. - All structures and APIs needed to work with USB host-side drivers are provided in this header file. -

      -
      • -
    • -

      - struct usbhost_driver_s. - Each USB host controller driver must implement an instance of struct usbhost_driver_s. - This structure is defined in include/nuttx/usb/usbhost.h. -

      -

      - Examples: - arch/arm/src/lpc17xx/lpc17_usbhost.c. -

      -
      • -
    • -

      - struct usbhost_class_s. - Each USB host class driver must implement an instance of struct usbhost_class_s. - This structure is also defined in include/nuttx/usb/usbhost.h. -

      -

      - Examples: - drivers/usbhost/usbhost_storage.c -

      -
      • -
    • -

      - USB Host Class Driver Registry. - The NuttX USB host infrastructure includes a registry. - During its initialization, each USB host class driver must call the interface, usbhost_registerclass() - in order add its interface to the registery. - Later, when a USB device is connected, the USB host controller will look up the USB host class driver that is needed to support the connected device in this registry. -

      -

      - Examples: - drivers/usbhost/usbhost_registry.c, drivers/usbhost/usbhost_registerclass.c, and drivers/usbhost/usbhost_findclass.c, -

      -
      • -
    • -

      - Detection and Enumeration of Connected Devices. - Each USB host device controller supports two methods that are used to detect and enumeration newly connected devices - (and also detect disconnected devices): -

      -

      -

        -
      • -

        - int (*wait)(FAR struct usbhost_driver_s *drvr, bool connected); -

        -

        - Wait for a device to be connected or disconnected. -

        -
        • -
      • -

        - int (*enumerate)(FAR struct usbhost_driver_s *drvr); -

        -

        - Enumerate the connected device. - As part of this enumeration process, the driver will - (1) get the device's configuration descriptor, - (2) extract the class ID info from the configuration descriptor, - (3) call usbhost_findclass() to find the class that supports this device, - (4) call the create() method on the struct usbhost_registry_s interface to get a class instance, and - finally (5) call the connect() method of the struct usbhost_class_s interface. - After that, the class is in charge of the sequence of operations. -

        -
      -

      -
      • -
    • -

      - Binding USB Host-Side Drivers. - USB host-side controller drivers are not normally directly accessed by user code, - but are usually bound to another, higher level USB host class driver. - The class driver exports the standard NuttX device interface so that the connected USB device can be accessed just as with other, similar, on-board devices. - For example, the USB host mass storage class driver (drivers/usbhost/usbhost_storage.c) will register a standard, NuttX block driver interface (like /dev/sda) - that can be used to mount a file system just as with any other other block driver instance. - In general, the binding sequence is: -

      -

      -

        -
      1. -

        - Each USB host class driver includes an intialization entry point that is called from the - application at initialization time. - This driver calls usbhost_registerclass() during this initialization in order to makes itself available in the event the the device that it supports is connected. -

        -

        - Examples: - The function usbhost_storageinit() in the file drivers/usbhost/usbhost_storage.c -

        -
        2. -
      2. -

        - Each application must include a waiter thread thread that (1) calls the USB host controller driver's wait() to detect the connection of a device, and then - (2) call the USB host controller driver's enumerate method to bind the registered USB host class driver to the USB host controller driver. -

        -

        - Examples: - The function nsh_waiter() in the file configs/nucleus2g/src/up_nsh.c and - the function nsh_waiter() in the file configs/olimex-lpc1766stk/src/up_nsh.c. -

        -
        3. -
      3. -

        - As part of its operation during the binding operation, the USB host class driver will register an instances of a standard NuttX driver under the /dev directory. - To repeat the above example, the USB host mass storage class driver (drivers/usbhost/usbhost_storage.c) will register a standard, NuttX block driver interface (like /dev/sda) - that can be used to mount a file system just as with any other other block driver instance. -

        -

        - Examples: - See the call to register_blockdriver() in the function usbhost_initvolume() in the file drivers/usbhost/usbhost_storage.c. -

        -
        4. -
      -

      -
      • -
    +
  • + The LPC17xx USB host controller driver was extended to (1) add support for low-speed devices, + (2) handle multiple concurrent transfers on different endpoints (still only one TD per endpoint), and + (3) handle periodic interrupt endpoint types. +
    • +
  • + Add a USB host HID keyboard class driver. + Now you can connect a standard USB keyboard to NuttX and receive keyboard input for an application. +
+

+ And other changes as detailed in the ChangeLog. +

@@ -1394,9 +1272,17 @@

Nucleus2G LPC1768. - 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 with some - additional enhancements through NuttX-5.9. +

    +
  • + 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 with + Some additional enhancements through NuttX-5.9. +
    • +
+

+

That initial, 5.6, basic release included timer interrupts and a serial console and was verified using the NuttX OS test (examples/ostest). Configurations available include include a verified NuttShell (NSH) configuration @@ -1408,21 +1294,43 @@

mbed LPC1768. - Support for the mbed board was contributed by Dave Marples and released in NuttX-5.11. +

    +
  • + Support for the mbed board was contributed by Dave Marples and released in NuttX-5.11. +
    • +
+

+

This port includes a NuttX OS test configuration (see examples/ostest).

Olimex LPC1766-STK. - Support for that Olimex-LPC1766-STK board was added to NuttX 5.13. - The NuttX-5.14 release extended that support with an Ethernet driver. - The NuttX-5.15 release further extended the support with a functional USB device driver and SPI-based micro-SD. - And the NuttX-5.16 release added a functional USB host driver. +

    +
  • + Support for that Olimex-LPC1766-STK board was added to NuttX 5.13. +
    • +
  • + The NuttX-5.14 release extended that support with an Ethernet driver. +
    • +
  • + The NuttX-5.15 release further extended the support with a functional USB device driver and SPI-based micro-SD. +
    • +
  • + The NuttX-5.16 release added a functional USB host controller driver and USB host mass storage class driver. +
    • +
  • + The NuttX-5.17 released added support for low-speed USB devicers, interrupt endpoints, and a USB host HID keyboard class driver. +
    • +
+

+

Verified configurations are now available for the NuttX OS test, for the NuttShell with networking and microSD support(NSH, see the NSH User Guide), for the NuttX network test, for the THTTPD webserver, - and for USB serial and USB storage examples. + for USB serial deive and USB storage devices examples, and for the USB host HID keyboard driver. + Support for the USB host mass storage device can optionally be configured for the NSH example. A driver for the Nokia 6100 LCD and an NX graphics configuration for the Olimex LPC1766-STK have been added. - However, neither the LCD driver nor the NX configuration have been verified as of the the NuttX-5.15 release. + However, neither the LCD driver nor the NX configuration have been verified as of the the NuttX-5.17 release.

Development Environments: @@ -2058,18 +1966,25 @@ Other memory: 

    -nuttx-5.16 2011-01-10 Gregory Nutt <spudmonkey@racsa.co.cr>
+nuttx-5.17 2011-01-19 Gregory Nutt <spudmonkey@racsa.co.cr>
 
-    * include/nuttx/usb -- Created new directory.  Moved all usb-related header
-      files to this new directory.  Created a skeleton for a new USB host header
-      file
-    * drivers/usbhost -- Add USB host "registry" where connect devices can be
-      matched with the correct USB class driver.
-    * arc/arc/src/lpc17xx/lpc17_usbhost.c -- Add a simple USB host driver for
-      the NXP lpc17xx.
-    * drivers/usbhost -- Add generic USB device enumeration logic.
-    * drivers/usbhost -- Add a USB host class driver for the (Bulk-Only) USB
-      Mass Storage Class.
+    * include/nuttx/usb -- rename usb_storage.h to storage.h.
+    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Add support for low-speed devices.
+    * drivers/usbhost/usbhost_skeleton.c -- Template for new class drivers
+    * include/nuttx/usb/hid.h and drivers/usbhost/usbhost_hidkbd.c -- New
+      files for HID keyboard support.
+    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Will now handle multiple
+      concurrent transfers on different endpoints (still only one TD per
+      endpoint).  All methods are protected from re-entrancy; lots of re-
+      structuring in preparation for interrupt endpoint support.
+    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Add support for periodic
+      interrupt transfers.
+    * examples/hidkbd - Added a simple test for the USB host HID keyboard
+      class driver.
+    * configs/olimex-lpc1766stk/hidkbd - Added a configuration to build the
+      USB host HID keyboard class driver test for the LPC17xx.
+    * Ran the tool CppCheck (http://sourceforge.net/apps/mediawiki/cppcheck) and
+      fixed several errors in the code identified by the tool.
 
 pascal-2.0 2009-12-21 Gregory Nutt <spudmonkey@racsa.co.cr>
 
@@ -2099,25 +2014,7 @@ buildroot-1.8 2009-12-21 <spudmonkey@racsa.co.cr>
 
 
 
      -nuttx-5.17 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
-
-    * include/nuttx/usb -- rename usb_storage.h to storage.h.
-    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Add support for low-speed devices.
-    * drivers/usbhost/usbhost_skeleton.c -- Template for new class drivers
-    * include/nuttx/usb/hid.h and drivers/usbhost/usbhost_hidkbd.c -- New
-      files for HID keyboard support.
-    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Will now handle multiple
-      concurrent transfers on different endpoints (still only one TD per
-      endpoint).  All methods are protected from re-entrancy; lots of re-
-      structuring in preparation for interrupt endpoint support.
-    * arch/arm/src/lpc17xx/lpc17_usbhost.c -- Add support for periodic
-      interrupt transfers.
-    * examples/hidkbd - Added a simple test for the USB host HID keyboard
-      class driver.
-    * configs/olimex-lpc1766stk/hidkbd - Added a configuration to build the
-      USB host HID keyboard class driver test for the LPC17xx.
-    * Ran the tool CppCheck (http://sourceforge.net/apps/mediawiki/cppcheck) and
-      fixed several errors in the code identified by the tool.
+nuttx-5.18 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
 
 pascal-2.1 2010-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
 
diff --git a/ReleaseNotes b/ReleaseNotes
index 712617611a..c2e38d6923 100644
--- a/ReleaseNotes
+++ b/ReleaseNotes
@@ -1654,3 +1654,21 @@ the NuttX Porting Guide:
        block driver instance.
        Examples: See the call to register_blockdriver() in the function
        usbhost_initvolume() in the file drivers/usbhost/usbhost_storage.c.
+
+nuttx-5.17
+^^^^^^^^^^
+
+The 64th release of NuttX, Version 5.17, was made on January 19, 2010 and is
+available for download from the SourceForge website. This release follows
+close on the heels of the 5.16 release and extends the USB host capabilities
+first introduced in that version.
+
+    1. The LPC17xx USB host controller driver was extended to (1) add support
+       for low-speed devices, (2) handle multiple concurrent transfers on 
+       different endpoints (still only one TD per endpoint), and (3) handle
+       periodic interrupt endpoint types.
+    2. Add a USB host HID keyboard class driver.  Now you can connect a
+       standard USB keyboard to NuttX and receive keyboard input for an
+       application.
+
+And other changes as detailed in the ChangeLog.