tmk_core/protocol/lufa/descriptor.h

   1 /*
   2  * Copyright 2012,2013 Jun Wako <wakojun@gmail.com>
   3  * This file is based on:
   4  *     LUFA-120219/Demos/Device/Lowlevel/KeyboardMouse
   5  *     LUFA-120219/Demos/Device/Lowlevel/GenericHID
   6  */
   7
   8 /*
   9              LUFA Library
  10      Copyright (C) Dean Camera, 2012.
  11
  12   dean [at] fourwalledcubicle [dot] com
  13            www.lufa-lib.org
  14 */
  15
  16 /*
  17   Copyright 2012  Dean Camera (dean [at] fourwalledcubicle [dot] com)
  18   Copyright 2010  Denver Gingerich (denver [at] ossguy [dot] com)
  19
  20   Permission to use, copy, modify, distribute, and sell this
  21   software and its documentation for any purpose is hereby granted
  22   without fee, provided that the above copyright notice appear in
  23   all copies and that both that the copyright notice and this
  24   permission notice and warranty disclaimer appear in supporting
  25   documentation, and that the name of the author not be used in
  26   advertising or publicity pertaining to distribution of the
  27   software without specific, written prior permission.
  28
  29   The author disclaim all warranties with regard to this
  30   software, including all implied warranties of merchantability
  31   and fitness.  In no event shall the author be liable for any
  32   special, indirect or consequential damages or any damages
  33   whatsoever resulting from loss of use, data or profits, whether
  34   in an action of contract, negligence or other tortious action,
  35   arising out of or in connection with the use or performance of
  36   this software.
  37 */
  38
  39 /** \file
  40  *
  41  *  Header file for Descriptors.c.
  42  */
  43
  44 #ifndef _DESCRIPTORS_H_
  45 #define _DESCRIPTORS_H_
  46
  47 #include <LUFA/Drivers/USB/USB.h>
  48 #include <avr/pgmspace.h>
  49
  50
  51 typedef struct
  52 {
  53     USB_Descriptor_Configuration_Header_t Config;
  54
  55     // Keyboard HID Interface
  56     USB_Descriptor_Interface_t            Keyboard_Interface;
  57     USB_HID_Descriptor_HID_t              Keyboard_HID;
  58     USB_Descriptor_Endpoint_t             Keyboard_INEndpoint;
  59
  60 #ifdef MOUSE_ENABLE
  61     // Mouse HID Interface
  62     USB_Descriptor_Interface_t            Mouse_Interface;
  63     USB_HID_Descriptor_HID_t              Mouse_HID;
  64     USB_Descriptor_Endpoint_t             Mouse_INEndpoint;
  65 #endif
  66
  67 #ifdef EXTRAKEY_ENABLE
  68     // Extrakey HID Interface
  69     USB_Descriptor_Interface_t            Extrakey_Interface;
  70     USB_HID_Descriptor_HID_t              Extrakey_HID;
  71     USB_Descriptor_Endpoint_t             Extrakey_INEndpoint;
  72 #endif
  73
  74 #ifdef RAW_ENABLE
  75     // Raw HID Interface
  76     USB_Descriptor_Interface_t            Raw_Interface;
  77     USB_HID_Descriptor_HID_t              Raw_HID;
  78     USB_Descriptor_Endpoint_t             Raw_INEndpoint;
  79     USB_Descriptor_Endpoint_t             Raw_OUTEndpoint;
  80 #endif
  81
  82 #ifdef CONSOLE_ENABLE
  83     // Console HID Interface
  84     USB_Descriptor_Interface_t            Console_Interface;
  85     USB_HID_Descriptor_HID_t              Console_HID;
  86     USB_Descriptor_Endpoint_t             Console_INEndpoint;
  87     USB_Descriptor_Endpoint_t             Console_OUTEndpoint;
  88 #endif
  89
  90 #ifdef NKRO_ENABLE
  91     // NKRO HID Interface
  92     USB_Descriptor_Interface_t            NKRO_Interface;
  93     USB_HID_Descriptor_HID_t              NKRO_HID;
  94     USB_Descriptor_Endpoint_t             NKRO_INEndpoint;
  95 #endif
  96
  97 #ifdef MIDI_ENABLE
  98       // MIDI Audio Control Interface
  99       USB_Descriptor_Interface_t                Audio_ControlInterface;
 100       USB_Audio_Descriptor_Interface_AC_t       Audio_ControlInterface_SPC;
 101
 102       // MIDI Audio Streaming Interface
 103       USB_Descriptor_Interface_t                Audio_StreamInterface;
 104       USB_MIDI_Descriptor_AudioInterface_AS_t   Audio_StreamInterface_SPC;
 105       USB_MIDI_Descriptor_InputJack_t           MIDI_In_Jack_Emb;
 106       USB_MIDI_Descriptor_InputJack_t           MIDI_In_Jack_Ext;
 107       USB_MIDI_Descriptor_OutputJack_t          MIDI_Out_Jack_Emb;
 108       USB_MIDI_Descriptor_OutputJack_t          MIDI_Out_Jack_Ext;
 109       USB_Audio_Descriptor_StreamEndpoint_Std_t MIDI_In_Jack_Endpoint;
 110       USB_MIDI_Descriptor_Jack_Endpoint_t       MIDI_In_Jack_Endpoint_SPC;
 111       USB_Audio_Descriptor_StreamEndpoint_Std_t MIDI_Out_Jack_Endpoint;
 112       USB_MIDI_Descriptor_Jack_Endpoint_t       MIDI_Out_Jack_Endpoint_SPC;
 113 #endif
 114
 115 #ifdef VIRTSER_ENABLE
 116         USB_Descriptor_Interface_Association_t   CDC_Interface_Association;
 117
 118         // CDC Control Interface
 119         USB_Descriptor_Interface_t               CDC_CCI_Interface;
 120         USB_CDC_Descriptor_FunctionalHeader_t    CDC_Functional_Header;
 121         USB_CDC_Descriptor_FunctionalACM_t       CDC_Functional_ACM;
 122         USB_CDC_Descriptor_FunctionalUnion_t     CDC_Functional_Union;
 123         USB_Descriptor_Endpoint_t                CDC_NotificationEndpoint;
 124
 125         // CDC Data Interface
 126         USB_Descriptor_Interface_t               CDC_DCI_Interface;
 127         USB_Descriptor_Endpoint_t                CDC_DataOutEndpoint;
 128         USB_Descriptor_Endpoint_t                CDC_DataInEndpoint;
 129 #endif
 130 } USB_Descriptor_Configuration_t;
 131
 132
 133 /* index of interface */
 134 #define KEYBOARD_INTERFACE          0
 135
 136 #ifdef MOUSE_ENABLE
 137 #   define MOUSE_INTERFACE          (KEYBOARD_INTERFACE + 1)
 138 #else
 139 #   define MOUSE_INTERFACE          KEYBOARD_INTERFACE
 140 #endif
 141
 142 #ifdef EXTRAKEY_ENABLE
 143 #   define EXTRAKEY_INTERFACE       (MOUSE_INTERFACE + 1)
 144 #else
 145 #   define EXTRAKEY_INTERFACE       MOUSE_INTERFACE
 146 #endif
 147
 148 #ifdef RAW_ENABLE
 149 #   define RAW_INTERFACE                (EXTRAKEY_INTERFACE + 1)
 150 #else
 151 #   define RAW_INTERFACE                EXTRAKEY_INTERFACE
 152 #endif
 153
 154 #ifdef CONSOLE_ENABLE
 155 #   define CONSOLE_INTERFACE        (RAW_INTERFACE + 1)
 156 #else
 157 #   define CONSOLE_INTERFACE        RAW_INTERFACE
 158 #endif
 159
 160 #ifdef NKRO_ENABLE
 161 #   define NKRO_INTERFACE           (CONSOLE_INTERFACE + 1)
 162 #else
 163 #   define NKRO_INTERFACE           CONSOLE_INTERFACE
 164 #endif
 165
 166 #ifdef MIDI_ENABLE
 167 #   define AC_INTERFACE           (NKRO_INTERFACE + 1)
 168 #   define AS_INTERFACE           (NKRO_INTERFACE + 2)
 169 #else
 170 #   define AS_INTERFACE           NKRO_INTERFACE
 171 #endif
 172
 173 #ifdef VIRTSER_ENABLE
 174 #   define CCI_INTERFACE         (AS_INTERFACE + 1)
 175 #   define CDI_INTERFACE         (AS_INTERFACE + 2)
 176 #else
 177 #   define CDI_INTERFACE         AS_INTERFACE
 178 #endif
 179
 180 /* nubmer of interfaces */
 181 #define TOTAL_INTERFACES            (CDI_INTERFACE + 1)
 182
 183
 184 // Endopoint number and size
 185 #define KEYBOARD_IN_EPNUM           1
 186
 187 #ifdef MOUSE_ENABLE
 188 #   define MOUSE_IN_EPNUM           (KEYBOARD_IN_EPNUM + 1)
 189 #else
 190 #   define MOUSE_IN_EPNUM           KEYBOARD_IN_EPNUM
 191 #endif
 192
 193 #ifdef EXTRAKEY_ENABLE
 194 #   define EXTRAKEY_IN_EPNUM        (MOUSE_IN_EPNUM + 1)
 195 #else
 196 #   define EXTRAKEY_IN_EPNUM        MOUSE_IN_EPNUM
 197 #endif
 198
 199 #ifdef RAW_ENABLE
 200 #   define RAW_IN_EPNUM         (EXTRAKEY_IN_EPNUM + 1)
 201 #   define RAW_OUT_EPNUM        (EXTRAKEY_IN_EPNUM + 2)
 202 #else
 203 #   define RAW_OUT_EPNUM        EXTRAKEY_IN_EPNUM
 204 #endif
 205
 206 #ifdef CONSOLE_ENABLE
 207 #   define CONSOLE_IN_EPNUM         (RAW_OUT_EPNUM + 1)
 208 //#   define CONSOLE_OUT_EPNUM        (RAW_OUT_EPNUM + 2)
 209 #   define CONSOLE_OUT_EPNUM        (RAW_OUT_EPNUM + 1)
 210 #else
 211 #   define CONSOLE_OUT_EPNUM        RAW_OUT_EPNUM
 212 #endif
 213
 214 #ifdef NKRO_ENABLE
 215 #   define NKRO_IN_EPNUM            (CONSOLE_OUT_EPNUM + 1)
 216 #else
 217 #   define NKRO_IN_EPNUM            CONSOLE_OUT_EPNUM
 218 #endif
 219
 220 #ifdef MIDI_ENABLE
 221 #   define MIDI_STREAM_IN_EPNUM     (NKRO_IN_EPNUM + 1)
 222 // #   define MIDI_STREAM_OUT_EPNUM    (NKRO_IN_EPNUM + 1)
 223 #   define MIDI_STREAM_OUT_EPNUM    (NKRO_IN_EPNUM + 2)
 224 #   define MIDI_STREAM_IN_EPADDR    (ENDPOINT_DIR_IN | MIDI_STREAM_IN_EPNUM)
 225 #   define MIDI_STREAM_OUT_EPADDR   (ENDPOINT_DIR_OUT | MIDI_STREAM_OUT_EPNUM)
 226 #else
 227 #   define MIDI_STREAM_OUT_EPNUM     NKRO_IN_EPNUM
 228 #endif
 229
 230 #ifdef VIRTSER_ENABLE
 231 #   define CDC_NOTIFICATION_EPNUM   (MIDI_STREAM_OUT_EPNUM + 1)
 232 #   define CDC_IN_EPNUM             (MIDI_STREAM_OUT_EPNUM + 2)
 233 #   define CDC_OUT_EPNUM                    (MIDI_STREAM_OUT_EPNUM + 3)
 234 #   define CDC_NOTIFICATION_EPADDR        (ENDPOINT_DIR_IN | CDC_NOTIFICATION_EPNUM)
 235 #   define CDC_IN_EPADDR                  (ENDPOINT_DIR_IN | CDC_IN_EPNUM)
 236 #   define CDC_OUT_EPADDR                  (ENDPOINT_DIR_OUT | CDC_OUT_EPNUM)
 237 #else
 238 #   define CDC_OUT_EPNUM        MIDI_STREAM_OUT_EPNUM
 239 #endif
 240
 241 #if defined(__AVR_ATmega32U2__) && CDC_OUT_EPNUM > 4
 242 # error "Endpoints are not available enough to support all functions. Remove some in Makefile.(MOUSEKEY, EXTRAKEY, CONSOLE, NKRO, MIDI, SERIAL)"
 243 #endif
 244
 245 #define KEYBOARD_EPSIZE             8
 246 #define MOUSE_EPSIZE                8
 247 #define EXTRAKEY_EPSIZE             8
 248 #define RAW_EPSIZE                      32
 249 #define CONSOLE_EPSIZE              32
 250 #define NKRO_EPSIZE                 32
 251 #define MIDI_STREAM_EPSIZE          64
 252 #define CDC_NOTIFICATION_EPSIZE     8
 253 #define CDC_EPSIZE                  16
 254
 255
 256 uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue,
 257                                     const uint8_t wIndex,
 258                                     const void** const DescriptorAddress)
 259                                     ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3);
 260
 261
 262 /* new API */
 263 #if LUFA_VERSION_INTEGER < 0x140302
 264     #undef VERSION_BCD
 265     #define VERSION_BCD(Major, Minor, Revision) \
 266                                               CPU_TO_LE16( ((Major & 0xFF) << 8) | \
 267                                                            ((Minor & 0x0F) << 4) | \
 268                                                            (Revision & 0x0F) )
 269 #endif
 270
 271 #endif