mirror of
https://github.com/qmk/qmk_firmware.git
synced 2025-06-22 09:02:04 +00:00
Open-source keyboard firmware for Atmel AVR and Arm USB families. Mirror of https://github.com/qmk/qmk_firmware
25a02432e7
The documentation contains example code[1] on how to restart into the bootloader. In the process of preparing for the reset, USB is disabled using “USB_Disable()”. For hardware making use of the AVR8's internal 3.3V regulator that call would also disable the regulator, resetting the processor immediately rather than setting the boot key and letting the watchdog reset the processor. This patch adds a new flag to be given to “USB_Init()” or to be defined in “USE_STATIC_OPTIONS” telling “USB_Disable()” to keep the regulator enabled. On November 1st, 2013 this issue was already mentioned on the mailing list[2], but no fix came from that discussion. [1] <http://www.fourwalledcubicle.com/files/LUFA/Doc/130901/ html/_page__software_bootloader_start.html> [2] <https://groups.google.com/d/msg/lufa-support/uwrFpRQpJzU/e9I6UK5jMJQJ> Signed-off-by: Michael Hanselmann <public@hansmi.ch> |
||
|---|---|---|
| Bootloaders | ||
| BuildTests | ||
| Demos | ||
| LUFA | ||
| Maintenance | ||
| Projects | ||
| .gitignore | ||
| makefile | ||
| README.txt | ||
_ _ _ ___ _
| | | | | __/ \
| |_| U | _| o | - The Lightweight USB
|___|___|_||_n_| Framework for AVRs
=========================================
Written by Dean Camera
dean [at] fourwalledcubicle [dot] com
http://www.lufa-lib.org
=========================================
LUFA is donation supported. To support LUFA,
please donate at http://www.lufa-lib.org/donate
Released under a modified MIT license - see
LUFA/License.txt for license details.
For Commercial Licensing information, see
http://www.lufa-lib.org/license
This package contains the complete LUFA library, demos, user-submitted
projects and bootloaders for use with compatible microcontroller models.
LUFA is a simple to use, lightweight framework which sits atop the hardware
USB controller in specific AVR microcontroller models, and allows for the
quick and easy creation of complex USB devices and hosts.
To get started, you will need to install the "Doxygen" documentation
generation tool. If you use Linux, this can be installed via the "doxygen"
package in your chosen package management tool - under Ubuntu, this can be
achieved by running the following command in the terminal:
sudo apt-get install doxygen
Other package managers and distributions will have similar methods to
install Doxygen. In Windows, you can download a prebuilt installer for
Doxygen from its website, www.doxygen.org.
Once installed, you can then use the Doxygen tool to generate the library
documentation from the command line or terminal of your operating system. To
do this, open your terminal or command line to the root directory of the
LUFA package, and type the following command:
make doxygen
Which will recursively generate documentation for all elements in the
library - the core, plus all demos, projects and bootloaders. Generated
documentation will then be available by opening the file "index.html" of the
created Documentation/html/ subdirectories inside each project folder.
The documentation for the library itself (but not the documentation for the
individual demos, projects or bootloaders) is also available as a separate
package from the project webpage for convenience if Doxygen cannot be
installed.