Fix endianness issues in the Service Discovery Protocol service of the incomplete...
[pub/lufa.git] / LUFA / ManPages / DirectorySummaries.txt
index bf20619..25f2db0 100644 (file)
-/** \file\r
- *\r
- *  This file contains special DoxyGen information for the generation of the main page and other special\r
- *  documentation pages. It is not a project source file.\r
- */\r
-\r
-/** \dir LUFA/Common\r
- *  \brief Common library header files.\r
- *  \r
- *  This folder contains header files which are common to all parts of the LUFA library. They may be used freely in\r
- *  user applications.\r
- *\r
- *  \dir LUFA/Drivers\r
- *  \brief Library hardware and software drivers.\r
- *  \r
- *  This folder contains all the library hardware and software drivers for each supported board and USB AVR\r
- *  microcontroller model.\r
- * \r
- *  \dir LUFA/Drivers/Misc\r
- *  \brief Miscellaneous driver files.\r
- *  \r
- *  This folder contains drivers for aspects other than the USB interface, board hardware or AVR peripherals.\r
- * \r
- *  \dir LUFA/Drivers/Peripheral\r
- *  \brief USB AVR peripheral driver files.\r
- *  \r
- *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible with\r
- *  all USB AVR models.\r
- *\r
- *  \dir LUFA/Drivers/Peripheral/AVRU4U6U7\r
- *  \brief AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 AVR model peripheral driver files.\r
- *  \r
- *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible only with\r
- *  the AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 USB AVR models, such as the AT90USB1287. Its contents should <b>not</b> be\r
- *  included by the user application - the dispatch header file located in the parent directory should be used\r
- *  instead.\r
- *\r
- *  \dir LUFA/Drivers/USB\r
- *  \brief USB controller peripheral driver files.\r
- *  \r
- *  This folder contains the main header files required to implement the USB interface in the USB supporting AVR models.\r
- *  The header files contained directly in this folder should be included in the user application in order to gain USB\r
- *  functionality, and the appropriate C source files in the LowLevel and HighLevel driver folders added to the compile\r
- *  and link stages.\r
- *\r
- *  \dir LUFA/Drivers/USB/LowLevel\r
- *  \brief Low level USB driver files.\r
- *  \r
- *  This folder contains low level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.\r
- *\r
- *  \dir LUFA/Drivers/USB/HighLevel\r
- *  \brief High level USB driver files.\r
- *  \r
- *  This folder contains high level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.\r
- *\r
- *  \dir LUFA/Drivers/USB/Class\r
- *  \brief USB Class helper driver files.\r
- *  \r
- *  This folder contains drivers for implementing functionality of standardized USB classes. These are not used directly by the library,\r
- *  but provide a standard and library-maintained way of implementing functionality from some of the defined USB classes without extensive\r
- *  development effort. Is is recommended that these drivers be used where possible to reduce maintenance of user applications.\r
- *\r
- *  \dir LUFA/Drivers/USB/Class/Device\r
- *  \brief USB Device Class helper driver files.\r
- *  \r
- *  Device mode drivers for the standard USB classes.\r
- *\r
- *  \dir LUFA/Drivers/USB/Class/Host\r
- *  \brief USB Host Class helper driver files.\r
- *  \r
- *  Host mode drivers for the standard USB classes.\r
- *\r
- *  \dir LUFA/Drivers/Board\r
- *  \brief Board hardware driver files.\r
- *  \r
- *  This folder contains drivers for interfacing with the physical hardware on supported commercial boards, primarily from\r
- *  the Atmel corporation. Header files in this folder should be included in user applications requiring the functionality of\r
- *  hardware placed on supported boards.\r
- *\r
- *  \dir LUFA/Drivers/Board/USBKEY\r
- *  \brief USBKEY board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel USBKEY demonstration board. The header files in this folder should\r
- *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory\r
- *  should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/STK526\r
- *  \brief STK526 board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel STK526 development board. The header files in this folder should\r
- *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory\r
- *  should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/STK525\r
- *  \brief STK525 board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel STK525 development board. The header files in this folder should\r
- *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory\r
- *  should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/RZUSBSTICK\r
- *  \brief RZUSBSTICK board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel RZUSBSTICK board, as used in the Atmel "Raven" wireless kits. The header\r
- *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in\r
- *  the parent Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/ATAVRUSBRF01\r
- *  \brief ATAVRUSBRF01 board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel ATAVRUSBRF01 board, as used in several Atmel wireless demo kits. The header\r
- *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in\r
- *  the parent Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/BUMBLEB\r
- *  \brief BUMBLEB board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Fletchtronics Bumble-B board (http://fletchtronics.net/bumble-b). The header\r
- *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in\r
- *  the parent Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/XPLAIN\r
- *  \brief XPLAIN board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel XPLAIN board (all hardware revisions). The header files in this folder \r
- *  should not be included directly in user applications; the similarly named dispatch header files located in the parent Board \r
- *  directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/EVK527\r
- *  \brief XPLAIN board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Atmel EVK527 development board. The header files in this folder should\r
- *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory\r
- *  should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/TEENSY\r
- *  \brief TEENSY board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on all revisions of the PJRC Teensy boards (http://www.pjrc.com/teensy/). The header\r
- *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located\r
- *  in the parent Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/USBTINYMKII\r
- *  \brief USBTINY-MKII board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on all revisions of the USBTINY-MKII boards (http://tom-itx.dyndns.org:81/~webpage/).\r
- *  The header files in this folder should not be included directly in user applications; the similarly named dispatch header files\r
- *  located in the parent Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/BENITO\r
- *  \brief BENITO board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the Benito boards (http://dorkbotpdx.org/wiki/benito). The header files in this\r
- *  folder should not be included directly in user applications; the similarly named dispatch header files located in the parent\r
- *  Board directory should be included instead.\r
- *\r
- *  \dir LUFA/Drivers/Board/JMDBU2\r
- *  \briefJM-DB-U2 board hardware driver files.\r
- *  \r
- *  This folder contains drivers for hardware on the JM-DB-U2 boards (http://u2.mattair.net/). The header files in this folder\r
- *  should not be included directly in user applications; the similarly named dispatch header files located in the parent Board\r
- *  directory should be included instead.\r
- *\r
- *  \dir LUFA/DriverStubs\r
- *  \brief Driver stub header files for custom boards, to allow the LUFA board drivers to operate.\r
- *  \r
- *  This contains stub files for the LUFA board drivers. If the LUFA board drivers are used with board hardware other than those\r
- *  directly supported by the library, the BOARD parameter of the application's makefile can be set to "USER", and these stub files\r
- *  copied to the "/Board/" directory of the application's folder. When fleshed out with working driver code for the custom board,\r
- *  the corresponding LUFA board APIs will work correctly with the non-standard board hardware.\r
- */\r
+/** \file
+ *
+ *  This file contains special DoxyGen information for the generation of the main page and other special
+ *  documentation pages. It is not a project source file.
+ */
+
+/** \dir LUFA/Common
+ *  \brief Common library header files.
+ *  
+ *  This folder contains header files which are common to all parts of the LUFA library. They may be used freely in
+ *  user applications.
+ *
+ *  \dir LUFA/Drivers
+ *  \brief Library hardware and software drivers.
+ *  
+ *  This folder contains all the library hardware and software drivers for each supported board and USB AVR
+ *  microcontroller model.
+ * 
+ *  \dir LUFA/Drivers/Misc
+ *  \brief Miscellaneous driver files.
+ *  
+ *  This folder contains drivers for aspects other than the USB interface, board hardware or AVR peripherals.
+ * 
+ *  \dir LUFA/Drivers/Peripheral
+ *  \brief USB AVR peripheral driver files.
+ *  
+ *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible with
+ *  all USB AVR models.
+ *
+ *  \dir LUFA/Drivers/Peripheral/AVRU4U6U7
+ *  \brief AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 AVR model peripheral driver files.
+ *  
+ *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible only with
+ *  the AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 USB AVR models, such as the AT90USB1287. Its contents should <b>not</b> be
+ *  included by the user application - the dispatch header file located in the parent directory should be used
+ *  instead.
+ *
+ *  \dir LUFA/Drivers/USB
+ *  \brief USB controller peripheral driver files.
+ *  
+ *  This folder contains the main header files required to implement the USB interface in the USB supporting AVR models.
+ *  The header files contained directly in this folder should be included in the user application in order to gain USB
+ *  functionality, and the appropriate C source files in the LowLevel and HighLevel driver folders added to the compile
+ *  and link stages.
+ *
+ *  \dir LUFA/Drivers/USB/LowLevel
+ *  \brief Low level USB driver files.
+ *  
+ *  This folder contains low level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.
+ *
+ *  \dir LUFA/Drivers/USB/HighLevel
+ *  \brief High level USB driver files.
+ *  
+ *  This folder contains high level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.
+ *
+ *  \dir LUFA/Drivers/USB/Class
+ *  \brief USB Class helper driver files.
+ *  
+ *  This folder contains drivers for implementing functionality of standardized USB classes. These are not used directly by the library,
+ *  but provide a standard and library-maintained way of implementing functionality from some of the defined USB classes without extensive
+ *  development effort. Is is recommended that these drivers be used where possible to reduce maintenance of user applications.
+ *
+ *  \dir LUFA/Drivers/USB/Class/Device
+ *  \brief USB Device Class helper driver files.
+ *  
+ *  Device mode drivers for the standard USB classes.
+ *
+ *  \dir LUFA/Drivers/USB/Class/Host
+ *  \brief USB Host Class helper driver files.
+ *  
+ *  Host mode drivers for the standard USB classes.
+ *
+ *  \dir LUFA/Drivers/Board
+ *  \brief Board hardware driver files.
+ *  
+ *  This folder contains drivers for interfacing with the physical hardware on supported commercial boards, primarily from
+ *  the Atmel corporation. Header files in this folder should be included in user applications requiring the functionality of
+ *  hardware placed on supported boards.
+ *
+ *  \dir LUFA/Drivers/Board/USBKEY
+ *  \brief USBKEY board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel USBKEY demonstration board. The header files in this folder should
+ *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
+ *  should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/STK526
+ *  \brief STK526 board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel STK526 development board. The header files in this folder should
+ *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
+ *  should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/STK525
+ *  \brief STK525 board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel STK525 development board. The header files in this folder should
+ *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
+ *  should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/RZUSBSTICK
+ *  \brief RZUSBSTICK board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel RZUSBSTICK board, as used in the Atmel "Raven" wireless kits. The header
+ *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in
+ *  the parent Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/ATAVRUSBRF01
+ *  \brief ATAVRUSBRF01 board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel ATAVRUSBRF01 board, as used in several Atmel wireless demo kits. The header
+ *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in
+ *  the parent Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/BUMBLEB
+ *  \brief BUMBLEB board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Fletchtronics Bumble-B board (http://fletchtronics.net/bumble-b). The header
+ *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in
+ *  the parent Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/XPLAIN
+ *  \brief XPLAIN board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel XPLAIN board (all hardware revisions). The header files in this folder 
+ *  should not be included directly in user applications; the similarly named dispatch header files located in the parent Board 
+ *  directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/EVK527
+ *  \brief XPLAIN board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Atmel EVK527 development board. The header files in this folder should
+ *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
+ *  should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/TEENSY
+ *  \brief TEENSY board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on all revisions of the PJRC Teensy boards (http://www.pjrc.com/teensy/). The header
+ *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located
+ *  in the parent Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/USBTINYMKII
+ *  \brief USBTINY-MKII board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on all revisions of the USBTINY-MKII boards (http://tom-itx.dyndns.org:81/~webpage/).
+ *  The header files in this folder should not be included directly in user applications; the similarly named dispatch header files
+ *  located in the parent Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/BENITO
+ *  \brief BENITO board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the Benito boards (http://dorkbotpdx.org/wiki/benito). The header files in this
+ *  folder should not be included directly in user applications; the similarly named dispatch header files located in the parent
+ *  Board directory should be included instead.
+ *
+ *  \dir LUFA/Drivers/Board/JMDBU2
+ *  \brief JM-DB-U2 board hardware driver files.
+ *  
+ *  This folder contains drivers for hardware on the JM-DB-U2 boards (http://u2.mattair.net/). The header files in this folder
+ *  should not be included directly in user applications; the similarly named dispatch header files located in the parent Board
+ *  directory should be included instead.
+ *
+ *  \dir LUFA/DriverStubs
+ *  \brief Driver stub header files for custom boards, to allow the LUFA board drivers to operate.
+ *  
+ *  This contains stub files for the LUFA board drivers. If the LUFA board drivers are used with board hardware other than those
+ *  directly supported by the library, the BOARD parameter of the application's makefile can be set to "USER", and these stub files
+ *  copied to the "/Board/" directory of the application's folder. When fleshed out with working driver code for the custom board,
+ *  the corresponding LUFA board APIs will work correctly with the non-standard board hardware.
+ */