LUFA/DoxygenPages/KnownIssues.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  /** \page Page_KnownIssues Known Issues
   8   *  The following are known issues present in each official LUFA release. This list should contain all known
   9   *  issues in the library. Most of these issues should be corrected in the future release - see
  10   *  \ref Page_FutureChanges for a list of planned changes in future releases.
  11   *
  12   *  \section Sec_KnownIssuesXXXXXX Version XXXXXX
  13   *  - AVR8 Architecture
  14   *    - No known issues.
  15   *  - UC3 Architecture
  16   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  17   *
  18   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  19   *      although the architecture is supported in the LUFA core library.
  20   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  21   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  22   *      altered USB controller design.
  23   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  24   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  25   *  - XMEGA Architecture
  26   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  27   *
  28   *    - Endpoints of more than 64 bytes are not currently supported in this release.
  29   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  30   *      cannot be used on XMEGA devices.
  31   *    - Multiple-bank endpoints are not currently supported in this release.
  32   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  33   *      relating to the USB controller.
  34   *  - Architecture Independent
  35   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  36   *      and a lengthy USB operation is initiated.
  37   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8/10).
  38   *  - Build System
  39   *    - No known issues.
  40   *  - Atmel Studio Integration
  41   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
  42   *    - When switching boards after changing the device selection, a second conflicting \c BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the "Toolchain" tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
  43   *
  44   *  \section Sec_KnownIssues170418 Version 170418
  45   *  - AVR8 Architecture
  46   *    - No known issues.
  47   *  - UC3 Architecture
  48   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  49   *
  50   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  51   *      although the architecture is supported in the LUFA core library.
  52   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  53   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  54   *      altered USB controller design.
  55   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  56   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  57   *  - XMEGA Architecture
  58   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  59   *
  60   *    - Endpoints of more than 64 bytes are not currently supported in this release.
  61   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  62   *      cannot be used on XMEGA devices.
  63   *    - Multiple-bank endpoints are not currently supported in this release.
  64   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  65   *      relating to the USB controller.
  66   *  - Architecture Independent
  67   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  68   *      and a lengthy USB operation is initiated.
  69   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8/10).
  70   *  - Build System
  71   *    - No known issues.
  72   *  - Atmel Studio Integration
  73   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
  74   *    - When switching boards after changing the device selection, a second conflicting \c BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the "Toolchain" tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
  75   *
  76   *  \section Sec_KnownIssues151115 Version 151115
  77   *  - AVR8 Architecture
  78   *    - No known issues.
  79   *  - UC3 Architecture
  80   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  81   *
  82   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  83   *      although the architecture is supported in the LUFA core library.
  84   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  85   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  86   *      altered USB controller design.
  87   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  88   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  89   *  - XMEGA Architecture
  90   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  91   *
  92   *    - Endpoints of more than 64 bytes are not currently supported in this release.
  93   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  94   *      cannot be used on XMEGA devices.
  95   *    - Multiple-bank endpoints are not currently supported in this release.
  96   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  97   *      relating to the USB controller.
  98   *  - Architecture Independent
  99   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 100   *      and a lengthy USB operation is initiated.
 101   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 102   *  - Build System
 103   *    - No known issues.
 104   *  - Atmel Studio Integration
 105   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
 106   *    - When switching boards after changing the device selection, a second conflicting \c BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the "Toolchain" tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
 107   *
 108   *  \section Sec_KnownIssues140928 Version 140928
 109   *  - AVR8 Architecture
 110   *    - No known issues.
 111   *  - UC3 Architecture
 112   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
 113   *
 114   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
 115   *      although the architecture is supported in the LUFA core library.
 116   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
 117   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
 118   *      altered USB controller design.
 119   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
 120   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
 121   *  - XMEGA Architecture
 122   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
 123   *
 124   *    - Endpoints of more than 64 bytes are not currently supported in this release.
 125   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
 126   *      cannot be used on XMEGA devices.
 127   *    - Multiple-bank endpoints are not currently supported in this release.
 128   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
 129   *      relating to the USB controller.
 130   *  - Architecture Independent
 131   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 132   *      and a lengthy USB operation is initiated.
 133   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 134   *  - Build System
 135   *    - No known issues.
 136   *  - Atmel Studio Integration
 137   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
 138   *    - When switching boards after changing the device selection, a second conflicting \c BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the "Toolchain" tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
 139   *
 140   *  \section Sec_KnownIssues140302 Version 140302
 141   *  - AVR8 Architecture
 142   *    - No known issues.
 143   *  - UC3 Architecture
 144   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
 145   *
 146   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
 147   *      although the architecture is supported in the LUFA core library.
 148   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
 149   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
 150   *      altered USB controller design.
 151   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
 152   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
 153   *  - XMEGA Architecture
 154   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
 155   *
 156   *    - Endpoints of more than 64 bytes are not currently supported in this release.
 157   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
 158   *      cannot be used on XMEGA devices.
 159   *    - Multiple-bank endpoints are not currently supported in this release.
 160   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
 161   *      relating to the USB controller.
 162   *  - Architecture Independent
 163   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 164   *      and a lengthy USB operation is initiated.
 165   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 166   *  - Build System
 167   *    - No known issues.
 168   *  - Atmel Studio Integration
 169   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
 170   *    - When switching boards after changing the device selection, a second conflicting BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the Toolchain tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
 171   *
 172   *  \section Sec_KnownIssues130901 Version 130901
 173   *  - AVR8 Architecture
 174   *    - No known issues.
 175   *  - UC3 Architecture
 176   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
 177   *
 178   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
 179   *      although the architecture is supported in the LUFA core library.
 180   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
 181   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
 182   *      altered USB controller design.
 183   *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
 184   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
 185   *  - XMEGA Architecture
 186   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
 187   *
 188   *    - Endpoints of more than 64 bytes are not currently supported in this release.
 189   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
 190   *      cannot be used on XMEGA devices.
 191   *    - Multiple-bank endpoints are not currently supported in this release.
 192   *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
 193   *      relating to the USB controller.
 194   *  - Architecture Independent
 195   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 196   *      and a lengthy USB operation is initiated.
 197   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 198   *  - Build System
 199   *    - No known issues.
 200   *  - Atmel Studio Integration
 201   *    - Not all devices are listed in the "Supported Parts" screen when selecting a device. To select an alternative device, change the "Show Device" drop-down to "All Parts".
 202   *    - When switching boards after changing the device selection, a second conflicting BOARD symbol definition can be created that prevents successful compilation. To fix, open the project properties window (<i>Project->Project {name} Properties...</i> menu item), click the Toolchain tab, click "Symbols" under the "AVR/GNU C Compiler" section and remove the incorrect definition.
 203   *
 204   *  \section Sec_KnownIssues130303 Version 130303
 205   *  - AVR8 Architecture
 206   *    - No known issues.
 207   *  - UC3 Architecture
 208   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
 209   *
 210   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
 211   *      although the architecture is supported in the LUFA core library.
 212   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
 213   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
 214   *      altered USB controller design.
 215   *    - The various \c CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
 216   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
 217   *  - XMEGA Architecture
 218   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
 219   *
 220   *    - No demos, bootloaders or projects have been ported for the XMEGA devices in the current release,
 221   *      although the architecture is supported in the LUFA core library.
 222   *    - Endpoints of more than 64 bytes are not currently supported in this release.
 223   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
 224   *      cannot be used on XMEGA devices.
 225   *    - Multiple-bank endpoints are not currently supported in this release.
 226   *    - Early revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
 227   *      relating to the USB controller.
 228   *  - Architecture Independent
 229   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 230   *      and a lengthy USB operation is initiated.
 231   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 232   *  - Build System
 233   *    - No known issues.
 234   *
 235   *  \section Sec_KnownIssues120730 Version 120730
 236   *  - AVR8 Architecture
 237   *    - No known issues.
 238   *  - UC3 Architecture
 239   *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
 240   *
 241   *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
 242   *      although the architecture is supported in the LUFA core library.
 243   *    - DMA transfers to and from the USB controller are not yet implemented for this release.
 244   *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
 245   *      altered USB controller design.
 246   *    - The various \c CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
 247   *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
 248   *  - XMEGA Architecture
 249   *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
 250   *
 251   *    - No demos, bootloaders or projects have been ported for the XMEGA devices in the current release,
 252   *      although the architecture is supported in the LUFA core library.
 253   *    - Endpoints of more than 64 bytes are not currently supported in this release.
 254   *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
 255   *      cannot be used on XMEGA devices.
 256   *    - Multiple-bank endpoints are not currently supported in this release.
 257   *    - Early revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
 258   *      relating to the USB controller.
 259   *  - Architecture Independent
 260   *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
 261   *      and a lengthy USB operation is initiated.
 262   *    - No LUFA provided driver INF files for Windows are signed, and thus may fail to install on systems where driver signing is enforced (e.g. Windows 8).
 263   *  - Build System
 264   *    - No known issues.
 265   */
 266