diff options
author | Dean Camera <dean@fourwalledcubicle.com> | 2013-03-22 23:24:02 +0000 |
---|---|---|
committer | Dean Camera <dean@fourwalledcubicle.com> | 2013-03-22 23:24:02 +0000 |
commit | 141f24b4a13144a49fe21f7352b0e9d34962e2dd (patch) | |
tree | 7ad429383efa95158ea145dc414deb3b4d9ddf40 /Bootloaders/CDC/BootloaderCDC.txt | |
parent | 54e46d7818ad14f4a00a9df905f26f135a462e6d (diff) | |
download | lufa-141f24b4a13144a49fe21f7352b0e9d34962e2dd.tar.gz lufa-141f24b4a13144a49fe21f7352b0e9d34962e2dd.tar.bz2 lufa-141f24b4a13144a49fe21f7352b0e9d34962e2dd.zip |
Add known-issues documentation section to the various LUFA bootloaders.
Diffstat (limited to 'Bootloaders/CDC/BootloaderCDC.txt')
-rw-r--r-- | Bootloaders/CDC/BootloaderCDC.txt | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/Bootloaders/CDC/BootloaderCDC.txt b/Bootloaders/CDC/BootloaderCDC.txt index b087bd575..379988f9e 100644 --- a/Bootloaders/CDC/BootloaderCDC.txt +++ b/Bootloaders/CDC/BootloaderCDC.txt @@ -161,6 +161,26 @@ * +----------------------------+ FLASHEND * \endverbatim * + * \section Sec_KnownIssues Known Issues: + * + * \par On Linux machines, the CDC bootloader is unstable or inaccessible. + * A change to the \c ModemManager module in many Linux distributions causes + * this module to try to take control over inserted CDC devices, corrupting the + * datastream. A UDEV rule is required to prevent this. + * See <a href=https://groups.google.com/d/msg/lufa-support/CP9cy2bc8yo/kBqsOu-RBeMJ>here</a> for resolution steps. + * + * \par On Linux machines, the CDC bootloader is inaccessible. + * On many Linux systems, non-root users do not have automatic access to newly + * inserted CDC devices. Root privileges or a UDEV rule is required to gain + * access. + * See <a href=https://groups.google.com/d/msg/lufa-support/CP9cy2bc8yo/kBqsOu-RBeMJ>here</a> for resolution steps. + * + * \par After loading an application, it is not run automatically on startup. + * Some USB AVR boards ship with the BOOTRST fuse set, causing the bootloader + * to run automatically when the device is reset. In most cases, the BOOTRST + * fuse should be disabled and the HWBE fuse used instead to run the bootloader + * when needed. + * * \section Sec_Options Project Options * * The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value. |