aboutsummaryrefslogtreecommitdiff
path: root/lib/lufa/Bootloaders/DFU/Descriptors.h
diff options
context:
space:
mode:
authorDrashna Jaelre <drashna@live.com>2019-08-02 14:02:40 -0700
committerskullydazed <skullydazed@users.noreply.github.com>2019-08-30 15:01:52 -0700
commitcf4575b94a3c65e6535a159fc71fc885aebc2620 (patch)
tree2354f2b7a200e02246a564afefedc32357e62b8e /lib/lufa/Bootloaders/DFU/Descriptors.h
parent75ee8df19e0f14ba466f41ab673dde2fe2fdae9c (diff)
downloadqmk_firmware-cf4575b94a3c65e6535a159fc71fc885aebc2620.tar.gz
qmk_firmware-cf4575b94a3c65e6535a159fc71fc885aebc2620.zip
Fix the LUFA lib to use a submodule instead of just files (#6245)
* Remove LUFA files * Update descriptions for newer version of LUFA * Create PR6245.md * Fix CDC(Serial) type errors * Fix missed merge conflict for AUDIO_DTYPE_CSInterface
Diffstat (limited to 'lib/lufa/Bootloaders/DFU/Descriptors.h')
-rw-r--r--lib/lufa/Bootloaders/DFU/Descriptors.h200
1 files changed, 0 insertions, 200 deletions
diff --git a/lib/lufa/Bootloaders/DFU/Descriptors.h b/lib/lufa/Bootloaders/DFU/Descriptors.h
deleted file mode 100644
index 7137d0f11..000000000
--- a/lib/lufa/Bootloaders/DFU/Descriptors.h
+++ /dev/null
@@ -1,200 +0,0 @@
1/*
2 LUFA Library
3 Copyright (C) Dean Camera, 2017.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.lufa-lib.org
7*/
8
9/*
10 Copyright 2017 Dean Camera (dean [at] fourwalledcubicle [dot] com)
11
12 Permission to use, copy, modify, distribute, and sell this
13 software and its documentation for any purpose is hereby granted
14 without fee, provided that the above copyright notice appear in
15 all copies and that both that the copyright notice and this
16 permission notice and warranty disclaimer appear in supporting
17 documentation, and that the name of the author not be used in
18 advertising or publicity pertaining to distribution of the
19 software without specific, written prior permission.
20
21 The author disclaims all warranties with regard to this
22 software, including all implied warranties of merchantability
23 and fitness. In no event shall the author be liable for any
24 special, indirect or consequential damages or any damages
25 whatsoever resulting from loss of use, data or profits, whether
26 in an action of contract, negligence or other tortious action,
27 arising out of or in connection with the use or performance of
28 this software.
29*/
30
31/** \file
32 *
33 * Header file for Descriptors.c.
34 */
35
36#ifndef _DESCRIPTORS_H_
37#define _DESCRIPTORS_H_
38
39 /* Includes: */
40 #include <LUFA/Drivers/USB/USB.h>
41
42 #include "Config/AppConfig.h"
43
44 /* Macros: */
45 /** Descriptor type value for a DFU class functional descriptor. */
46 #define DTYPE_DFUFunctional 0x21
47
48 /** DFU attribute mask, indicating that the DFU device will detach and re-attach when a DFU_DETACH
49 * command is issued, rather than the host issuing a USB Reset.
50 */
51 #define ATTR_WILL_DETATCH (1 << 3)
52
53 /** DFU attribute mask, indicating that the DFU device can communicate during the manifestation phase
54 * (memory programming phase).
55 */
56 #define ATTR_MANEFESTATION_TOLLERANT (1 << 2)
57
58 /** DFU attribute mask, indicating that the DFU device can accept DFU_UPLOAD requests to send data from
59 * the device to the host.
60 */
61 #define ATTR_CAN_UPLOAD (1 << 1)
62
63 /** DFU attribute mask, indicating that the DFU device can accept DFU_DNLOAD requests to send data from
64 * the host to the device.
65 */
66 #define ATTR_CAN_DOWNLOAD (1 << 0)
67
68 #if defined(__AVR_AT90USB1287__)
69 #define PRODUCT_ID_CODE 0x2FFB
70 #define AVR_SIGNATURE_1 0x1E
71 #define AVR_SIGNATURE_2 0x97
72 #define AVR_SIGNATURE_3 0x82
73 #elif defined(__AVR_AT90USB647__)
74 #define PRODUCT_ID_CODE 0x2FF9
75 #define AVR_SIGNATURE_1 0x1E
76 #define AVR_SIGNATURE_2 0x96
77 #define AVR_SIGNATURE_3 0x82
78 #elif defined(__AVR_AT90USB1286__)
79 #define PRODUCT_ID_CODE 0x2FFB
80 #define AVR_SIGNATURE_1 0x1E
81 #define AVR_SIGNATURE_2 0x97
82 #define AVR_SIGNATURE_3 0x82
83 #elif defined(__AVR_AT90USB646__)
84 #define PRODUCT_ID_CODE 0x2FF9
85 #define AVR_SIGNATURE_1 0x1E
86 #define AVR_SIGNATURE_2 0x96
87 #define AVR_SIGNATURE_3 0x82
88 #elif defined(__AVR_ATmega32U4__)
89 #define PRODUCT_ID_CODE 0x2FF4
90 #define AVR_SIGNATURE_1 0x1E
91 #define AVR_SIGNATURE_2 0x95
92 #define AVR_SIGNATURE_3 0x87
93 #elif defined(__AVR_ATmega16U4__)
94 #define PRODUCT_ID_CODE 0x2FF3
95 #define AVR_SIGNATURE_1 0x1E
96 #define AVR_SIGNATURE_2 0x94
97 #define AVR_SIGNATURE_3 0x88
98 #elif defined(__AVR_ATmega32U2__)
99 #define PRODUCT_ID_CODE 0x2FF0
100 #define AVR_SIGNATURE_1 0x1E
101 #define AVR_SIGNATURE_2 0x95
102 #define AVR_SIGNATURE_3 0x8A
103 #elif defined(__AVR_ATmega16U2__)
104 #define PRODUCT_ID_CODE 0x2FEF
105 #define AVR_SIGNATURE_1 0x1E
106 #define AVR_SIGNATURE_2 0x94
107 #define AVR_SIGNATURE_3 0x89
108 #elif defined(__AVR_AT90USB162__)
109 #define PRODUCT_ID_CODE 0x2FFA
110 #define AVR_SIGNATURE_1 0x1E
111 #define AVR_SIGNATURE_2 0x94
112 #define AVR_SIGNATURE_3 0x82
113 #elif defined(__AVR_ATmega8U2__)
114 #define PRODUCT_ID_CODE 0x2FEE
115 #define AVR_SIGNATURE_1 0x1E
116 #define AVR_SIGNATURE_2 0x93
117 #define AVR_SIGNATURE_3 0x89
118 #elif defined(__AVR_AT90USB82__)
119 #define PRODUCT_ID_CODE 0x2FF7
120 #define AVR_SIGNATURE_1 0x1E
121 #define AVR_SIGNATURE_2 0x93
122 #define AVR_SIGNATURE_3 0x82
123 #else
124 #error The selected AVR part is not currently supported by this bootloader.
125 #endif
126
127 #if !defined(PRODUCT_ID_CODE)
128 #error Current AVR model is not supported by this bootloader.
129 #endif
130
131 /* Type Defines: */
132 /** Type define for a DFU class function descriptor. This descriptor gives DFU class information
133 * to the host when read, indicating the DFU device's capabilities.
134 */
135 typedef struct
136 {
137 USB_Descriptor_Header_t Header; /**< Standard descriptor header structure */
138
139 uint8_t Attributes; /**< DFU device attributes, a mask comprising of the
140 * ATTR_* macros listed in this source file
141 */
142 uint16_t DetachTimeout; /**< Timeout in milliseconds between a USB_DETACH
143 * command being issued and the device detaching
144 * from the USB bus
145 */
146 uint16_t TransferSize; /**< Maximum number of bytes the DFU device can accept
147 * from the host in a transaction
148 */
149 uint16_t DFUSpecification; /**< BCD packed DFU specification number this DFU
150 * device complies with
151 */
152 } USB_Descriptor_DFU_Functional_t;
153
154 /** Type define for the device configuration descriptor structure. This must be defined in the
155 * application code, as the configuration descriptor contains several sub-descriptors which
156 * vary between devices, and which describe the device's usage to the host.
157 */
158 typedef struct
159 {
160 USB_Descriptor_Configuration_Header_t Config;
161
162 // DFU Interface
163 USB_Descriptor_Interface_t DFU_Interface;
164 USB_Descriptor_DFU_Functional_t DFU_Functional;
165 } USB_Descriptor_Configuration_t;
166
167 /** Enum for the device interface descriptor IDs within the device. Each interface descriptor
168 * should have a unique ID index associated with it, which can be used to refer to the
169 * interface from other descriptors.
170 */
171 enum InterfaceDescriptors_t
172 {
173 INTERFACE_ID_DFU = 0, /**< DFU interface descriptor ID */
174 };
175
176 /** Enum for the device string descriptor IDs within the device. Each string descriptor should
177 * have a unique ID index associated with it, which can be used to refer to the string from
178 * other descriptors.
179 */
180 enum StringDescriptors_t
181 {
182 STRING_ID_Language = 0, /**< Supported Languages string descriptor ID (must be zero) */
183 STRING_ID_Manufacturer = 1, /**< Manufacturer string ID */
184 STRING_ID_Product = 2, /**< Product string ID */
185 };
186
187 /* Function Prototypes: */
188 uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue,
189 const uint16_t wIndex,
190 const void** const DescriptorAddress)
191 ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3);
192 // convert to L string
193 #define LSTR(s) XLSTR(s)
194 #define XLSTR(s) L ## #s
195 // convert to string
196 #define STR(s) XSTR(s)
197 #define XSTR(s) #s
198
199#endif
200
generated by cgit v1.2.3 (git 2.25.1) at 2025-12-08 09:56:38 +0000