aboutsummaryrefslogtreecommitdiffstats
path: root/LUFA/ManPages/MainPage.txt
blob: e1fe98341c8bad613e007e02e9a4c7d7933ea96d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
/** \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.
 */

/**
 *  \mainpage
 *
 *  \image html LUFA.png
 *  <div align="center"><small><i>Logo design by <b>Ryo</b> - http://ryophotography.wordpress.com</i></small></div>
 *  \n
 *
 *  <b>LUFA is donationware. For author and donation information, see \ref Page_Donating.</b>
 *
 *  LUFA is an open-source USB library for the USB-enabled AVR microcontrollers, released under the MIT license (see \ref Page_LicenceInfo).
 *  It supports a large number of USB AVR models and boards (see \ref Page_DeviceSupport). It is designed to provide an easy to use,
 *  feature rich framework for the development of USB peripherals and hosts.
 *
 *  LUFA focuses on the microcontroller side of USB development only; it includes no PC host USB driver development facilities - other projects
 *  such as the Windows Driver Development Kit, Windows USB Device Mode Framework and libusb may be of interest for developing custom OS drivers.
 *  While custom USB devices can be made with LUFA using such tools, the included demos all use the inbuilt OS drivers for each USB class for
 *  simplicity.
 *
 *  The library is currently in a stable release, suitable for download and incorporation into user projects for
 *  both host and device modes. For information about the project progression, see the blog link at \ref Page_Resources.
 *
 *  LUFA is written specifically for the free AVR-GCC compiler, and uses several GCC-only extensions to make the
 *  library API more streamlined and robust. You can download AVR-GCC for free in a convenient windows package, 
 *  from the the WinAVR website (see \ref Page_Resources).
 *
 *  The only required AVR peripherals for LUFA is the USB controller itself and interrupts - LUFA does not require the use of the
 *  microcontroller's timers or other hardware, leaving more hardware to the application developer.
 *
 *  Accompanying LUFA in the download package is a set of example demo applications, plus several Bootloaders of different classes
 *  and open source LUFA powered projects.
 *
 *  <b>Subsections:</b>
 *  - \subpage Page_WhyUseLUFA What are the advantages of using LUFA?
 *  - \subpage Page_LUFAvsAtmelStack How does LUFA compare to the Atmel USB AVR stack?
 *  - \subpage Page_AlternativeStacks Alternative USB AVR Stacks
 *  - \subpage Page_LicenceInfo Project source licence and commercial use information
 *  - \subpage Page_Donating Donating to support this project
 *  - \subpage Page_LibraryApps Overview of included Demos, Bootloaders and Projects
 */