louis/kiibohd-controller: Bootloader/usb.h annotate

annotate Bootloader/usb.h @ 308:ab4515606277

Fix whitespace Use a consistent standard - Tabs in front for indenting, spaces after for anything else. This way everything stays nice and lined up while also letting users change there prefered indent level. Most of the new files from Haata where already in this format.

author	Rowan Decker <Smasher816@gmail.com>
date	Sun, 08 Mar 2015 18:40:01 -0700
parents	b091bb09c55f
children	66eccdd9ced5

rev	line source
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	1 /* Copyright (c) 2011,2012 Simon Schubert <2@0x2c.org>.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	2 * Modifications by Jacob Alexander 2014 <haata@kiibohd.com>
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	3 *
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	4 * This program is free software: you can redistribute it and/or modify
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	5 * it under the terms of the GNU General Public License as published by
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	6 * the Free Software Foundation, either version 3 of the License, or
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	7 * (at your option) any later version.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	8 *
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	9 * This program is distributed in the hope that it will be useful,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	12 * GNU General Public License for more details.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	13 *
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	14 * You should have received a copy of the GNU General Public License
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	16 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	17
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	18 #ifndef __USB_H
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	19 #define __USB_H
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	20
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	21 // ----- Compiler Includes -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	22
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	23 #include <sys/types.h>
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	24
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	25
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	26
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	27 // ----- Local Includes -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	28
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	29 #include "mchck.h"
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	30 #include "usb-common.h"
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	31
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	32
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	33
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	34 // ----- Defines -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	35
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	36 #define USB_CTRL_REQ_DIR_SHIFT 0
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	37 #define USB_CTRL_REQ_TYPE_SHIFT 1
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	38 #define USB_CTRL_REQ_RECP_SHIFT 3
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	39 #define USB_CTRL_REQ_CODE_SHIFT 8
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	40 #define USB_CTRL_REQ(req_inout, req_type, req_code) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	41 (uint16_t) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	42 ((USB_CTRL_REQ_##req_inout << USB_CTRL_REQ_DIR_SHIFT) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	43 \|(USB_CTRL_REQ_##req_type << USB_CTRL_REQ_TYPE_SHIFT) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	44 \|(USB_CTRL_REQ_##req_code << USB_CTRL_REQ_CODE_SHIFT))
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	45
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	46
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	47
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	48 // ----- Macros -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	49
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	50 #define USB_DESC_STRING(s) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	51 (const void *)&(const struct { \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	52 struct usb_desc_string_t dsc; \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	53 char16_t str[sizeof(s) / 2 - 1]; \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	54 }) {{ \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	55 .bLength = sizeof(struct usb_desc_string_t) + \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	56 sizeof(s) - 2, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	57 .bDescriptorType = USB_DESC_STRING, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	58 }, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	59 s \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	60 }
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	61 #define USB_DESC_STRING_LANG_ENUS USB_DESC_STRING(u"\x0409")
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	62 #define USB_DESC_STRING_SERIALNO ((const void *)1)
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	63
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	64 #define USB_FUNCTION_IFACE(iface, iface_off, tx_ep_off, rx_ep_off) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	65 ((iface_off) + (iface))
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	66 #define USB_FUNCTION_TX_EP(ep, iface_off, tx_ep_off, rx_ep_off) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	67 ((tx_ep_off) + (ep))
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	68 #define USB_FUNCTION_RX_EP(ep, iface_off, tx_ep_off, rx_ep_off) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	69 ((rx_ep_off) + (ep))
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	70
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	71
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	72 #define USB__INCREMENT(i, _0) (i + 1)
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	73 #define USB__COUNT_IFACE_EP(i, e) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	74 __DEFER(USB__COUNT_IFACE_EP_)(__EXPAND i, e)
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	75 #define USB__COUNT_IFACE_EP_(iface, tx_ep, rx_ep, func) \
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	76 (iface + USB_FUNCTION_ ## func ## _IFACE_COUNT, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	77 tx_ep + USB_FUNCTION_ ## func ## _TX_EP_COUNT, \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	78 rx_ep + USB_FUNCTION_ ## func ## _RX_EP_COUNT)
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	79 #define USB__GET_FUNCTION_IFACE_COUNT(iter, func) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	80 USB_FUNCTION_ ## func ## _IFACE_COUNT +
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	81
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	82 #define USB__DEFINE_FUNCTION_DESC(iter, func) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	83 USB_FUNCTION_DESC_ ## func ## _DECL __CAT(__usb_func_desc, __COUNTER__);
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	84 #define USB__INIT_FUNCTION_DESC(iter, func) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	85 USB_FUNCTION_DESC_ ## func iter,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	86
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	87 #define USB__DEFINE_CONFIG_DESC(confignum, name, ...) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	88 &((const struct name { \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	89 struct usb_desc_config_t config; \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	90 __REPEAT_INNER(, __EAT, USB__DEFINE_FUNCTION_DESC, __VA_ARGS__) \
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	91 }){ \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	92 .config = { \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	93 .bLength = sizeof(struct usb_desc_config_t), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	94 .bDescriptorType = USB_DESC_CONFIG, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	95 .wTotalLength = sizeof(struct name), \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	96 .bNumInterfaces = __REPEAT_INNER(, __EAT, USB__GET_FUNCTION_IFACE_COUNT, __VA_ARGS__) 0, \
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	97 .bConfigurationValue = confignum, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	98 .iConfiguration = 0, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	99 .one = 1, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	100 .bMaxPower = 50 \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	101 }, \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	102 __REPEAT_INNER((0, 0, 0), USB__COUNT_IFACE_EP, USB__INIT_FUNCTION_DESC, __VA_ARGS__) \
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	103 }).config
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	104
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	105
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	106 #define USB__DEFINE_CONFIG(iter, args) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	107 __DEFER(USB__DEFINE_CONFIG_)(iter, __EXPAND args)
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	108
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	109 #define USB__DEFINE_CONFIG_(confignum, initfun, ...) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	110 &(const struct usbd_config){ \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	111 .init = initfun, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	112 .desc = USB__DEFINE_CONFIG_DESC( \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	113 confignum, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	114 __CAT(__usb_desc, __COUNTER__), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	115 __VA_ARGS__) \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	116 },
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	117
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	118 #define USB_INIT_DEVICE(vid, pid, manuf, product, ...) \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	119 { \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	120 .dev_desc = &(const struct usb_desc_dev_t){ \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	121 .bLength = sizeof(struct usb_desc_dev_t), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	122 .bDescriptorType = USB_DESC_DEV, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	123 .bcdUSB = { .maj = 2 }, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	124 .bDeviceClass = USB_DEV_CLASS_SEE_IFACE, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	125 .bDeviceSubClass = USB_DEV_SUBCLASS_SEE_IFACE, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	126 .bDeviceProtocol = USB_DEV_PROTO_SEE_IFACE, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	127 .bMaxPacketSize0 = EP0_BUFSIZE, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	128 .idVendor = vid, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	129 .idProduct = pid, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	130 .bcdDevice = { .raw = 0 }, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	131 .iManufacturer = 1, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	132 .iProduct = 2, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	133 .iSerialNumber = 3, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	134 .bNumConfigurations = __PP_NARG(__VA_ARGS__), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	135 }, \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	136 .string_descs = (const struct usb_desc_string_t * const []){ \
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	137 USB_DESC_STRING_LANG_ENUS, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	138 USB_DESC_STRING(manuf), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	139 USB_DESC_STRING(product), \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	140 USB_DESC_STRING_SERIALNO, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	141 NULL \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	142 }, \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	143 .configs = { \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	144 __REPEAT(1, USB__INCREMENT, USB__DEFINE_CONFIG, __VA_ARGS__) \
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	145 NULL \
ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	146 } \
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	147 }
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	148
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	149
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	150
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	151 // ----- Structs & Enumerations -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	152
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	153 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	154 * Note: bitfields ahead.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	155 * GCC fills the fields lsb-to-msb on little endian.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	156 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	157
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	158 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	159 * USB descriptors
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	160 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	161
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	162 enum usb_desc_type {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	163 USB_DESC_DEV = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	164 USB_DESC_CONFIG = 2,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	165 USB_DESC_STRING = 3,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	166 USB_DESC_IFACE = 4,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	167 USB_DESC_EP = 5,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	168 USB_DESC_DEVQUAL = 6,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	169 USB_DESC_OTHERSPEED = 7,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	170 USB_DESC_POWER = 8
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	171 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	172
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	173 struct usb_desc_type_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	174 UNION_STRUCT_START(8);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	175 enum usb_desc_type id : 5;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	176 enum usb_desc_type_type {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	177 USB_DESC_TYPE_STD = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	178 USB_DESC_TYPE_CLASS = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	179 USB_DESC_TYPE_VENDOR = 2
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	180 } type_type : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	181 uint8_t _rsvd0 : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	182 UNION_STRUCT_END;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	183 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	184 CTASSERT_SIZE_BYTE(struct usb_desc_type_t, 1);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	185
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	186 enum usb_dev_class {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	187 USB_DEV_CLASS_SEE_IFACE = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	188 USB_DEV_CLASS_APP = 0xfe,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	189 USB_DEV_CLASS_VENDOR = 0xff
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	190 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	191
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	192 enum usb_dev_subclass {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	193 USB_DEV_SUBCLASS_SEE_IFACE = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	194 USB_DEV_SUBCLASS_VENDOR = 0xff
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	195 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	196
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	197 enum usb_dev_proto {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	198 USB_DEV_PROTO_SEE_IFACE = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	199 USB_DEV_PROTO_VENDOR = 0xff
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	200 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	201
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	202 struct usb_bcd_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	203 UNION_STRUCT_START(16);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	204 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	205 uint8_t sub : 4;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	206 uint8_t min : 4;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	207 uint16_t maj : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	208 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	209 UNION_STRUCT_END;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	210 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	211 CTASSERT_SIZE_BYTE(struct usb_bcd_t, 2);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	212
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	213 struct usb_desc_generic_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	214 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	215 struct usb_desc_type_t bDescriptorType;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	216 uint8_t data[];
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	217 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	218 CTASSERT_SIZE_BYTE(struct usb_desc_generic_t, 2);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	219
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	220 struct usb_desc_dev_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	221 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	222 enum usb_desc_type bDescriptorType : 8; /* = USB_DESC_DEV */
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	223 struct usb_bcd_t bcdUSB; /* = 0x0200 */
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	224 enum usb_dev_class bDeviceClass : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	225 enum usb_dev_subclass bDeviceSubClass : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	226 enum usb_dev_proto bDeviceProtocol : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	227 uint8_t bMaxPacketSize0;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	228 uint16_t idVendor;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	229 uint16_t idProduct;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	230 struct usb_bcd_t bcdDevice;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	231 uint8_t iManufacturer;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	232 uint8_t iProduct;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	233 uint8_t iSerialNumber;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	234 uint8_t bNumConfigurations;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	235 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	236 CTASSERT_SIZE_BYTE(struct usb_desc_dev_t, 18);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	237
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	238 struct usb_desc_ep_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	239 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	240 enum usb_desc_type bDescriptorType : 8; /* = USB_DESC_EP */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	241 union {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	242 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	243 uint8_t ep_num : 4;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	244 uint8_t _rsvd0 : 3;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	245 uint8_t in : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	246 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	247 uint8_t bEndpointAddress;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	248 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	249 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	250 enum usb_ep_type {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	251 USB_EP_CONTROL = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	252 USB_EP_ISO = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	253 USB_EP_BULK = 2,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	254 USB_EP_INTR = 3
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	255 } type : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	256 enum usb_ep_iso_synctype {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	257 USB_EP_ISO_NOSYNC = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	258 USB_EP_ISO_ASYNC = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	259 USB_EP_ISO_ADAPTIVE = 2,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	260 USB_EP_ISO_SYNC = 3
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	261 } sync_type : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	262 enum usb_ep_iso_usagetype {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	263 USB_EP_ISO_DATA = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	264 USB_EP_ISO_FEEDBACK = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	265 USB_EP_ISO_IMPLICIT = 2
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	266 } usage_type : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	267 uint8_t _rsvd1 : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	268 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	269 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	270 uint16_t wMaxPacketSize : 11;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	271 uint16_t _rsvd2 : 5;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	272 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	273 uint8_t bInterval;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	274 } __packed;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	275 CTASSERT_SIZE_BYTE(struct usb_desc_ep_t, 7);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	276
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	277 struct usb_desc_iface_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	278 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	279 enum usb_desc_type bDescriptorType : 8; /* = USB_DESC_IFACE */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	280 uint8_t bInterfaceNumber;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	281 uint8_t bAlternateSetting;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	282 uint8_t bNumEndpoints;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	283 enum usb_dev_class bInterfaceClass : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	284 enum usb_dev_subclass bInterfaceSubClass: 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	285 enum usb_dev_proto bInterfaceProtocol : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	286 uint8_t iInterface;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	287 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	288 CTASSERT_SIZE_BYTE(struct usb_desc_iface_t, 9);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	289
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	290 struct usb_desc_config_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	291 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	292 enum usb_desc_type bDescriptorType : 8; /* = USB_DESC_CONFIG */
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	293 uint16_t wTotalLength; /* size of config, iface, ep */
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	294 uint8_t bNumInterfaces;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	295 uint8_t bConfigurationValue;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	296 uint8_t iConfiguration;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	297 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	298 uint8_t _rsvd0 : 5;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	299 uint8_t remote_wakeup : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	300 uint8_t self_powered : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	301 uint8_t one : 1; /* = 1 for historical reasons */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	302 };
308 ab4515606277 Fix whitespace Rowan Decker <Smasher816@gmail.com> parents: 193 diff changeset	303 uint8_t bMaxPower; /* units of 2mA */
193 b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	304 } __packed;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	305 CTASSERT_SIZE_BYTE(struct usb_desc_config_t, 9);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	306
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	307 struct usb_desc_string_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	308 uint8_t bLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	309 enum usb_desc_type bDescriptorType : 8; /* = USB_DESC_STRING */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	310 const char16_t bString[];
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	311 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	312 CTASSERT_SIZE_BYTE(struct usb_desc_string_t, 2);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	313
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	314 struct usb_ctrl_req_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	315 union /* reqtype and request & u16 */ {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	316 struct /* reqtype and request */ {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	317 union /* reqtype in bitfield & u8 */ {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	318 struct /* reqtype */ {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	319 enum usb_ctrl_req_recp {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	320 USB_CTRL_REQ_DEV = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	321 USB_CTRL_REQ_IFACE = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	322 USB_CTRL_REQ_EP = 2,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	323 USB_CTRL_REQ_OTHER = 3
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	324 } recp : 5;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	325 enum usb_ctrl_req_type {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	326 USB_CTRL_REQ_STD = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	327 USB_CTRL_REQ_CLASS = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	328 USB_CTRL_REQ_VENDOR = 2
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	329 } type : 2;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	330 enum usb_ctrl_req_dir {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	331 USB_CTRL_REQ_OUT = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	332 USB_CTRL_REQ_IN = 1
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	333 } in : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	334 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	335 uint8_t bmRequestType;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	336 }; /* union */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	337 enum usb_ctrl_req_code {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	338 USB_CTRL_REQ_GET_STATUS = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	339 USB_CTRL_REQ_CLEAR_FEATURE = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	340 USB_CTRL_REQ_SET_FEATURE = 3,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	341 USB_CTRL_REQ_SET_ADDRESS = 5,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	342 USB_CTRL_REQ_GET_DESCRIPTOR = 6,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	343 USB_CTRL_REQ_SET_DESCRIPTOR = 7,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	344 USB_CTRL_REQ_GET_CONFIGURATION = 8,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	345 USB_CTRL_REQ_SET_CONFIGURATION = 9,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	346 USB_CTRL_REQ_GET_INTERFACE = 10,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	347 USB_CTRL_REQ_SET_INTERFACE = 11,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	348 USB_CTRL_REQ_SYNC_FRAME = 12
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	349 } bRequest : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	350 }; /* struct */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	351 uint16_t type_and_req;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	352 }; /* union */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	353 union {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	354 uint16_t wValue;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	355 struct {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	356 uint8_t wValueLow;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	357 uint8_t wValueHigh;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	358 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	359 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	360 uint16_t wIndex;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	361 uint16_t wLength;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	362 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	363 CTASSERT_SIZE_BYTE(struct usb_ctrl_req_t, 8);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	364
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	365 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	366 * status replies for GET_STATUS.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	367 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	368
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	369 struct usb_ctrl_req_status_dev_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	370 uint16_t self_powered : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	371 uint16_t remote_wakeup : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	372 uint16_t _rsvd : 14;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	373 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	374 CTASSERT_SIZE_BIT(struct usb_ctrl_req_status_dev_t, 16);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	375
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	376 struct usb_ctrl_req_status_iface_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	377 uint16_t _rsvd;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	378 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	379 CTASSERT_SIZE_BIT(struct usb_ctrl_req_status_iface_t, 16);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	380
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	381 struct usb_ctrl_req_status_ep_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	382 uint16_t halt : 1;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	383 uint16_t _rsvd : 15;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	384 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	385 CTASSERT_SIZE_BIT(struct usb_ctrl_req_status_ep_t, 16);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	386
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	387 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	388 * Descriptor type (in req->value) for GET_DESCRIPTOR.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	389 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	390 struct usb_ctrl_req_desc_t {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	391 uint8_t idx;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	392 enum usb_desc_type type : 8;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	393 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	394 CTASSERT_SIZE_BIT(struct usb_ctrl_req_desc_t, 16);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	395
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	396 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	397 * Feature selector (in req->value) for CLEAR_FEATURE.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	398 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	399 enum usb_ctrl_req_feature {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	400 USB_CTRL_REQ_FEAT_EP_HALT = 0,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	401 USB_CTRL_REQ_FEAT_DEV_REMOTE_WKUP = 1,
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	402 USB_CTRL_REQ_FEAT_TEST_MODE = 2
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	403 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	404
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	405
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	406 struct usb_xfer_info;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	407 typedef void (ep_callback_t)(void buf, ssize_t len, void *data);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	408
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	409 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	410 * (Artificial) function. Aggregates one or more interfaces.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	411 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	412 struct usbd_function {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	413 int (configure)(int orig_iface, int iface, int altsetting, void data);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	414 int (control)(struct usb_ctrl_req_t , void *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	415 int interface_count;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	416 int ep_rx_count;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	417 int ep_tx_count;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	418 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	419
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	420 struct usbd_function_ctx_header {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	421 struct usbd_function_ctx_header *next;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	422 const struct usbd_function *function;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	423 int interface_offset;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	424 int ep_rx_offset;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	425 int ep_tx_offset;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	426 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	427
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	428
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	429 typedef void (usbd_init_fun_t)(int);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	430 typedef void (usbd_suspend_resume_fun_t)(void);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	431
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	432 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	433 * Configuration. Contains one or more functions which all will be
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	434 * active concurrently.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	435 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	436 struct usbd_config {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	437 usbd_init_fun_t *init;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	438 usbd_suspend_resume_fun_t *suspend;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	439 usbd_suspend_resume_fun_t *resume;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	440 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	441 * We will not set a config for now, because there is not much to
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	442 * configure, except for power
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	443 *
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	444 * const struct usb_desc_config_t *config_desc;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	445 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	446 const struct usb_desc_config_t *desc;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	447 const struct usbd_function *function[];
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	448 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	449
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	450
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	451 /**
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	452 * Device. Contains one or more configurations, out of which only one
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	453 * is active at a time.
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	454 */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	455 struct usbd_device {
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	456 const struct usb_desc_dev_t *dev_desc;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	457 const struct usb_desc_string_t * const *string_descs;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	458 const struct usbd_config *configs[];
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	459 };
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	460
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	461
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	462
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	463 /* Provided by MD code */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	464 struct usbd_ep_pipe_state_t;
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	465
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	466
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	467
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	468 // ----- Functions -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	469
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	470 void usb_get_xfer_data(struct usb_xfer_info );
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	471 enum usb_tok_pid usb_get_xfer_pid(struct usb_xfer_info *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	472 int usb_get_xfer_ep(struct usb_xfer_info *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	473 enum usb_ep_dir usb_get_xfer_dir(struct usb_xfer_info *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	474 void usb_enable_xfers(void);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	475 void usb_set_addr(int);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	476 void usb_ep_stall(int);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	477 size_t usb_ep_get_transfer_size(struct usbd_ep_pipe_state_t *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	478 void usb_queue_next(struct usbd_ep_pipe_state_t , void , size_t);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	479 void usb_pipe_stall(struct usbd_ep_pipe_state_t *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	480 void usb_pipe_unstall(struct usbd_ep_pipe_state_t *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	481 void usb_pipe_enable(struct usbd_ep_pipe_state_t *s);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	482 void usb_pipe_disable(struct usbd_ep_pipe_state_t *s);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	483 #ifdef VUSB
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	484 void vusb_main_loop(void);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	485 #else
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	486 void usb_poll(void);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	487 #endif
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	488 int usb_tx_serialno(size_t reqlen);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	489
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	490 /* Provided by MI code */
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	491 void usb_init(const struct usbd_device *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	492 void usb_attach_function(const struct usbd_function function, struct usbd_function_ctx_header ctx);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	493 void usb_handle_transaction(struct usb_xfer_info *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	494 void usb_setup_control(void);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	495 void usb_handle_control_status_cb(ep_callback_t cb);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	496 void usb_handle_control_status(int);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	497 struct usbd_ep_pipe_state_t usb_init_ep(struct usbd_function_ctx_header ctx, int ep, enum usb_ep_dir dir, size_t size);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	498 int usb_rx(struct usbd_ep_pipe_state_t , void , size_t, ep_callback_t, void *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	499 int usb_tx(struct usbd_ep_pipe_state_t , const void , size_t, size_t, ep_callback_t, void *);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	500
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	501 int usb_ep0_rx(void , size_t, ep_callback_t, void );
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	502 void *usb_ep0_tx_inplace_prepare(size_t len);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	503 int usb_ep0_tx(void buf, size_t len, size_t reqlen, ep_callback_t cb, void cb_data);
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	504 int usb_ep0_tx_cp(const void , size_t, size_t, ep_callback_t, void );
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	505
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	506
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	507
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	508 // ----- DFU USB Additional Includes -----
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	509
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	510 #include "dfu.h"
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	511
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	512 #endif
b091bb09c55f Adding McHCK DFU Bootloader Jacob Alexander <haata@kiibohd.com> parents: diff changeset	513

Mercurial > louis > kiibohd-controller

annotate Bootloader/usb.h @ 308:ab4515606277