Added USE_INTERNAL_SERIAL compile time option to automatically read out the internal unique serial number as the device's serial number descriptor on supported AVR models.

3 files changed, 34 insertions, 8 deletions

diff --git a/LUFA/ManPages/ChangeLog.txt b/LUFA/ManPages/ChangeLog.txt
index 464418140..f7ae4c664 100644
--- a/LUFA/ManPages/ChangeLog.txt
+++ b/LUFA/ManPages/ChangeLog.txt
@@ -8,7 +8,7 @@
   *

   *  \section Sec_ChangeLogXXXXXX Version XXXXXX

   *

-  *  - Removed psuedo-scheduler, dynamic memory block allocator from the library (no longer needed and not used respectively)

+  *  - Deprecated psuedo-scheduler and removed dynamic memory allocator from the library (first no longer needed and second unused)

   *  - Added new class drivers and matching demos to the library for rapid application development

   *  - Added incomplete device and host mode demos for later enhancement

   *  - Changed bootloaders to use FLASHEND rather than the existence of RAMPZ to determine if far FLASH pointers are needed

@@ -28,6 +28,7 @@
   *    cleared to prevent endpoint type corruption

   *  - Fix documentation mentioning Pipe_GetCurrentToken() function when real name is Pipe_GetPipeToken()

   *  - Extend USB_GetDeviceConfigDescriptor() routine to require the configuration number within the device to fetch

+  *  - Added new USE_INTERNAL_SERIAL compile time option

   *

   *  \section Sec_ChangeLog090605 Version 090605

   *

diff --git a/LUFA/ManPages/CompileTimeTokens.txt b/LUFA/ManPages/CompileTimeTokens.txt
index d8a7cf74a..e1f248d8f 100644
--- a/LUFA/ManPages/CompileTimeTokens.txt
+++ b/LUFA/ManPages/CompileTimeTokens.txt
@@ -80,6 +80,14 @@
  *  compatibility. If this token is defined, the structure element names are switched to the LUFA-specific but more descriptive

  *  names documented in the StdDescriptors.h source file.

  *

+ *  <b>USE_INTERNAL_SERIAL</b> - ( \ref Group_Descriptors ) \n

+ *  Some AVR models contain a unique 20-digit serial number which can be used as the device serial number, while in device mode. This

+ *  allows the host to uniquely identify the device regardless of if it is moved between USB ports on the same computer, allowing

+ *  allocated resources (such as drivers, COM Port number allocations) to be preserved. To make the library use this value for the

+ *  device's serial number, define this token in the project makefile, set it to a unique string descriptor index (i.e. one not used

+ *  elsewhere in the device for a string descriptor) and set the Device Descriptor's serial number descriptor index entry to the

+ *  USE_INTERNAL_SERIAL value.

+ *

  *  <b>FIXED_CONTROL_ENDPOINT_SIZE</b> - ( \ref Group_EndpointManagement ) \n

  *  By default, the library determines the size of the control endpoint (when in device mode) by reading the device descriptor.

  *  Normally this reduces the amount of configuration required for the library, allows the value to change dynamically (if

diff --git a/LUFA/ManPages/LUFAPoweredProjects.txt b/LUFA/ManPages/LUFAPoweredProjects.txt
index b93604e2f..1f9a317e6 100644
--- a/LUFA/ManPages/LUFAPoweredProjects.txt
+++ b/LUFA/ManPages/LUFAPoweredProjects.txt
@@ -13,20 +13,37 @@
  *  If you have a project that you would like to add to this list, please contact me via the details on the main page of this

  *  documentation.

  *

+ *  \section Sec_BoardsUsingLUFA AVR-USB Development Boards Using LUFA

+ *

+ *  The following is a list of known AVR USB development boards, which recommend using LUFA for the USB stack. Some of these

+ *  are open design, and all are available for purchase as completed development boards suitable for project development.

+ *

+ *  - AVROpendous, an open design/source set of AVR USB development boards: http://avropendous.org/

+ *  - Teensy and Teensy++, two other AVR USB development boards: http://www.pjrc.com/teensy/index.html

+ *  - USBFoo, an AT90USB162 based development board: http://shop.kernelconcepts.de/product_info.php?products_id=102

+ *  - USB10 AKA "The Ferret", a AT90USB162 development board: http://www.soc-machines.com

+ * 

+ *  \section Sec_LUFAProjects Projects Using LUFA (Hobbyist)

+ *

+ *  The following are hobbyist projects using LUFA. Most are open source, and show off interesting ways that the LUFA library

+ *  can be incorporated into many different applications.

  *

- *  - Benito #7, an AVR Programmer: http://www.dorkbotpdx.org/blog/feurig/benito_7_the_next_big_thing

  *  - Stripe Snoop, a Magnetic Card reader: http://www.ossguy.com/ss_usb/

- *  - USB10 AKA "The Ferret", a USB162 development board: http://www.soc-machines.com

+ *  - Benito #7, an AVR Programmer: http://www.dorkbotpdx.org/blog/feurig/benito_7_the_next_big_thing

  *  - Bicycle POV: http://www.code.google.com/p/bicycleledpov/

- *  - Digital Survey Instruments Magnetometer and Pointer: http://www.digitalsurveyinstruments.com/

- *  - ARPS Locator: http://la3t.hamradio.no/lab//?id=tracker_en

- *  - Lightweight CC110x USB dongle for 868MHz Protocols: http://busware.de/tiki-index.php?page=CUL

- *  - AVROpendous, an open design/source AT90USB162 development board: http://avropendous.org/

  *  - USB Interface for Playstation Portable Devices: http://forums.ps2dev.org/viewtopic.php?t=11001

  *  - USB to Serial Bridge, via SPI and I2C: http://www.tty1.net/userial/

- *  - Teensy, another tiny AT90USB162 development board: http://www.pjrc.com/teensy/index.html

  *  - SEGA Megadrive/Genesis Development Cartridge: http://www.spritesmind.net/_GenDev/forum/viewtopic.php?t=464

  *  - CAMTRIG, a remote Camera Trigger device: http://code.astraw.com/projects/motmot/camtrig

  *  - Opendous-JTAG, an open source JTAG device: http://code.google.com/p/opendous-jtag/

  *  - Openkubus, an open source hardware-based authentication dongle: http://code.google.com/p/openkubus/

+ * 

+ *  \section Sec_LUFACommercialProjects Projects Using LUFA (Commercial)

+ *

+ *  The following is a list of known commercial products using LUFA. Some of these are open source, although many are "black-box"

+ *  solutions with no source code given.

+ *

+ *  - ARPS Locator: http://la3t.hamradio.no/lab//?id=tracker_en

+ *  - Digital Survey Instruments Magnetometer and Pointer: http://www.digitalsurveyinstruments.com/

+ *  - Lightweight CC110x USB dongle for 868MHz Protocols: http://busware.de/tiki-index.php?page=CUL

  */
\ No newline at end of file