LUFA/ManPages/DirectorySummaries.txt

   1 /** \file
   2  *
   3  *  This file contains special DoxyGen information for the generation of the main page and other special
   4  *  documentation pages. It is not a project source file.
   5  */
   6
   7 /** \dir LUFA/Common
   8  *  \brief Common library header files.
   9  *
  10  *  This folder contains header files which are common to all parts of the LUFA library. They may be used freely in
  11  *  user applications.
  12  *
  13  *  \dir LUFA/Drivers
  14  *  \brief Library hardware and software drivers.
  15  *
  16  *  This folder contains all the library hardware and software drivers for each supported board and USB AVR
  17  *  microcontroller model.
  18  *
  19  *  \dir LUFA/Drivers/Misc
  20  *  \brief Miscellaneous driver files.
  21  *
  22  *  This folder contains drivers for aspects other than the USB interface, board hardware or AVR peripherals.
  23  *
  24  *  \dir LUFA/Drivers/Peripheral
  25  *  \brief USB AVR peripheral driver files.
  26  *
  27  *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible with
  28  *  all USB AVR models.
  29  *
  30  *  \dir LUFA/Drivers/Peripheral/AT90USBXXX67
  31  *  \brief AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 AVR model peripheral driver files. Its original name is due to legacy
  32  *  reasons.
  33  *
  34  *  This folder contains drivers for several of the AVR internal peripherals such as the USART, compatible only with
  35  *  the AT90USBXXX6, AT90USBXXX7 and ATMEGAXXU4 USB AVR models, such as the AT90USB1287. Its contents should <b>not</b> be
  36  *  included by the user application - the dispatch header file located in the parent directory should be used
  37  *  instead.
  38  *
  39  *  \dir LUFA/Drivers/USB
  40  *  \brief USB controller peripheral driver files.
  41  *
  42  *  This folder contains the main header files required to implement the USB interface in the USB supporting AVR models.
  43  *  The header files contained directly in this folder should be included in the user application in order to gain USB
  44  *  functionality, and the appropriate C source files in the LowLevel and HighLevel driver folders added to the compile
  45  *  and link stages.
  46  *
  47  *  \dir LUFA/Drivers/USB/LowLevel
  48  *  \brief Low level USB driver files.
  49  *
  50  *  This folder contains low level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.
  51  *
  52  *  \dir LUFA/Drivers/USB/HighLevel
  53  *  \brief High level USB driver files.
  54  *
  55  *  This folder contains high level USB driver source files required to implement USB functionality on the USB AVR microcontrollers.
  56  *
  57  *  \dir LUFA/Drivers/USB/Class
  58  *  \brief USB Class helper driver files.
  59  *
  60  *  This folder contains drivers for implementing functionality of standardized USB classes. These are not used directly by the library,
  61  *  but provide a standard and library-maintained way of implementing functionality from some of the defined USB classes without extensive
  62  *  development effort. Is is recommended that these drivers be used where possible to reduce maintenance of user applications.
  63  *
  64  *  \dir LUFA/Drivers/USB/Class/Device
  65  *  \brief USB Device Class helper driver files.
  66  *
  67  *  Device mode drivers for the standard USB classes.
  68  *
  69  *  \dir LUFA/Drivers/USB/Class/Host
  70  *  \brief USB Host Class helper driver files.
  71  *
  72  *  Host mode drivers for the standard USB classes.
  73  *
  74  *  \dir LUFA/Drivers/Board
  75  *  \brief Board hardware driver files.
  76  *
  77  *  This folder contains drivers for interfacing with the physical hardware on supported commercial boards, primarily from
  78  *  the Atmel corporation. Header files in this folder should be included in user applications requiring the functionality of
  79  *  hardware placed on supported boards.
  80  *
  81  *  \dir LUFA/Drivers/Board/USBKEY
  82  *  \brief USBKEY board hardware driver files.
  83  *
  84  *  This folder contains drivers for hardware on the Atmel USBKEY demonstration board. The header files in this folder should
  85  *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
  86  *  should be included instead.
  87  *
  88  *  \dir LUFA/Drivers/Board/STK526
  89  *  \brief STK526 board hardware driver files.
  90  *
  91  *  This folder contains drivers for hardware on the Atmel STK526 development board. The header files in this folder should
  92  *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
  93  *  should be included instead.
  94  *
  95  *  \dir LUFA/Drivers/Board/STK525
  96  *  \brief STK525 board hardware driver files.
  97  *
  98  *  This folder contains drivers for hardware on the Atmel STK525 development board. The header files in this folder should
  99  *  not be included directly in user applications; the similarly named dispatch header files located in the parent Board directory
 100  *  should be included instead.
 101  *
 102  *  \dir LUFA/Drivers/Board/RZUSBSTICK
 103  *  \brief RZUSBSTICK board hardware driver files.
 104  *
 105  *  This folder contains drivers for hardware on the Atmel RZUSBSTICK board, as used in the Atmel "Raven" wireless kits. The header
 106  *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in
 107  *  the parent Board directory should be included instead.
 108  *
 109  *  \dir LUFA/Drivers/Board/ATAVRUSBRF01
 110  *  \brief ATAVRUSBRF01 board hardware driver files.
 111  *
 112  *  This folder contains drivers for hardware on the Atmel ATAVRUSBRF01 board, as used in several Atmel wireless demo kits. The header
 113  *  files in this folder should not be included directly in user applications; the similarly named dispatch header files located in
 114  *  the parent Board directory should be included instead.
 115  *
 116  *  \dir LUFA/DriverStubs
 117  *  \brief Driver stub header files for custom boards, to allow the LUFA board drivers to operate.
 118  *
 119  *  This contains stub files for the LUFA board drivers. If the LUFA board drivers are used with board hardware other than those
 120  *  directly supported by the library, the BOARD parameter of the application's makefile can be set to "USER", and these stub files
 121  *  copied to the "/Board/" directory of the application's folder. When fleshed out with working driver code for the custom board,
 122  *  the corresponding LUFA board APIs will work correctly with the non-standard board hardware.
 123  */