aboutsummaryrefslogtreecommitdiffstats
path: root/LUFA/DoxygenPages/KnownIssues.txt
blob: 2e993d7fdce8e8d55ea87b4f1bc5c084b40d7293 (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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
/** \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.
 */

 /** \page Page_KnownIssues Known Issues
  *  The following are known issues present in each official LUFA release. This list should contain all known
  *  issues in the library. Most of these issues should be corrected in the future release - see
  *  \ref Page_FutureChanges for a list of planned changes in future releases.
  *
  *  \section Sec_KnownIssuesXXXXXX Version XXXXXX
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues170418 Version 170418
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues151115 Version 151115
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues140928 Version 140928
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues140302 Version 140302
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues130901 Version 130901
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c *_CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early silicon revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *  - Atmel Studio Integration
  *    - 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".
  *    - 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.
  *
  *  \section Sec_KnownIssues130303 Version 130303
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - No demos, bootloaders or projects have been ported for the XMEGA devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  *
  *  \section Sec_KnownIssues120730 Version 120730
  *  - AVR8 Architecture
  *    - No known issues.
  *  - UC3 Architecture
  *    \warning The UC3 device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only. \n
  *
  *    - No demos, bootloaders or projects have been ported for the UC3 devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - DMA transfers to and from the USB controller are not yet implemented for this release.
  *    - The UC3C, UC3D and UC3L sub-families of UC3 are not currently supported by the library due to their
  *      altered USB controller design.
  *    - The various \c CreateStream() functions for creating standard \c <stdio.h> compatible virtual file
  *      streams are not available on the UC3 architecture, due to a lack of suitable library support.
  *  - XMEGA Architecture
  *    \warning The XMEGA device support is currently <b>experimental</b> (incomplete and/or non-functional), and is included for preview purposes only.
  *
  *    - No demos, bootloaders or projects have been ported for the XMEGA devices in the current release,
  *      although the architecture is supported in the LUFA core library.
  *    - Endpoints of more than 64 bytes are not currently supported in this release.
  *    - Isochronous endpoints are not currently supported in this release. As a result, the audio class
  *      cannot be used on XMEGA devices.
  *    - Multiple-bank endpoints are not currently supported in this release.
  *    - Early revisions of the ATXMEGA128A1U are incompatible with LUFA, due to their various errata
  *      relating to the USB controller.
  *  - Architecture Independent
  *    - The LUFA library is not watchdog aware, and thus timeouts are possible if short periods are used
  *      and a lengthy USB operation is initiated.
  *    - 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).
  *  - Build System
  *    - No known issues.
  */