visus
/
teensy-core-4.1
보기 1
좋아요 0
포크 0
코드 이슈 0 풀 리퀘스트 0 릴리즈 0 위키 Activity
Teensy 4.1 core updated for C++20
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
364 커밋
2 브랜치
트리: 4199a5dee7
브랜치 태그
${ item.name }
Create branch ${ searchTerm }
from '4199a5dee7'
${ noResults }
teensy-core-4.1/teensy3/usb_desc.c

1275 lines
60KB
Raw Blame 히스토리 

  1. /* Teensyduino Core Library

  2.  * http://www.pjrc.com/teensy/

  3.  * Copyright (c) 2013 PJRC.COM, LLC.

  4.  *

  5.  * Permission is hereby granted, free of charge, to any person obtaining

  6.  * a copy of this software and associated documentation files (the

  7.  * "Software"), to deal in the Software without restriction, including

  8.  * without limitation the rights to use, copy, modify, merge, publish,

  9.  * distribute, sublicense, and/or sell copies of the Software, and to

  10.  * permit persons to whom the Software is furnished to do so, subject to

  11.  * the following conditions:

  12.  *

  13.  * 1. The above copyright notice and this permission notice shall be

  14.  * included in all copies or substantial portions of the Software.

  15.  *

  16.  * 2. If the Software is incorporated into a build system that allows

  17.  * selection among a list of target devices, then similar target

  18.  * devices manufactured by PJRC.COM must be included in the list of

  19.  * target devices and selectable in the same manner.

  20.  *

  21.  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

  22.  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

  23.  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

  24.  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS

  25.  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

  26.  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN

  27.  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

  28.  * SOFTWARE.

  29.  */

  30. 

  31. #if F_CPU >= 20000000

  32. 

  33. #define USB_DESC_LIST_DEFINE

  34. #include "usb_desc.h"

  35. #ifdef NUM_ENDPOINTS

  36. #include "usb_names.h"

  37. #include "kinetis.h"

  38. #include "avr_functions.h"

  39. 

  40. // USB Descriptors are binary data which the USB host reads to

  41. // automatically detect a USB device's capabilities.  The format

  42. // and meaning of every field is documented in numerous USB

  43. // standards.  When working with USB descriptors, despite the

  44. // complexity of the standards and poor writing quality in many

  45. // of those documents, remember descriptors are nothing more

  46. // than constant binary data that tells the USB host what the

  47. // device can do.  Computers will load drivers based on this data.

  48. // Those drivers then communicate on the endpoints specified by

  49. // the descriptors.

  50. 

  51. // To configure a new combination of interfaces or make minor

  52. // changes to existing configuration (eg, change the name or ID

  53. // numbers), usually you would edit "usb_desc.h".  This file

  54. // is meant to be configured by the header, so generally it is

  55. // only edited to add completely new USB interfaces or features.

  56. 

  57. 

  58. 

  59. // **************************************************************

  60. //   USB Device

  61. // **************************************************************

  62. 

  63. #define LSB(n) ((n) & 255)

  64. #define MSB(n) (((n) >> 8) & 255)

  65. 

  66. // USB Device Descriptor.  The USB host reads this first, to learn

  67. // what type of device is connected.

  68. static uint8_t device_descriptor[] = {

  69.         18,                                     // bLength

  70.         1,                                      // bDescriptorType

  71.         0x00, 0x02,                             // bcdUSB

  72. #ifdef DEVICE_CLASS

  73.         DEVICE_CLASS,                           // bDeviceClass

  74. #else

  75. 	0,

  76. #endif

  77. #ifdef DEVICE_SUBCLASS

  78.         DEVICE_SUBCLASS,                        // bDeviceSubClass

  79. #else

  80. 	0,

  81. #endif

  82. #ifdef DEVICE_PROTOCOL

  83.         DEVICE_PROTOCOL,                        // bDeviceProtocol

  84. #else

  85. 	0,

  86. #endif

  87.         EP0_SIZE,                               // bMaxPacketSize0

  88.         LSB(VENDOR_ID), MSB(VENDOR_ID),         // idVendor

  89.         LSB(PRODUCT_ID), MSB(PRODUCT_ID),       // idProduct

  90.         0x00, 0x02,                             // bcdDevice

  91.         1,                                      // iManufacturer

  92.         2,                                      // iProduct

  93.         3,                                      // iSerialNumber

  94.         1                                       // bNumConfigurations

  95. };

  96. 

  97. // These descriptors must NOT be "const", because the USB DMA

  98. // has trouble accessing flash memory with enough bandwidth

  99. // while the processor is executing from flash.

  100. 

  101. 

  102. 

  103. // **************************************************************

  104. //   HID Report Descriptors

  105. // **************************************************************

  106. 

  107. // Each HID interface needs a special report descriptor that tells

  108. // the meaning and format of the data.

  109. 

  110. #ifdef KEYBOARD_INTERFACE

  111. // Keyboard Protocol 1, HID 1.11 spec, Appendix B, page 59-60

  112. static uint8_t keyboard_report_desc[] = {

  113.         0x05, 0x01,             //  Usage Page (Generic Desktop),

  114.         0x09, 0x06,             //  Usage (Keyboard),

  115.         0xA1, 0x01,             //  Collection (Application),

  116.         0x75, 0x01,             //  Report Size (1),

  117.         0x95, 0x08,             //  Report Count (8),

  118.         0x05, 0x07,             //  Usage Page (Key Codes),

  119.         0x19, 0xE0,             //  Usage Minimum (224),

  120.         0x29, 0xE7,             //  Usage Maximum (231),

  121.         0x15, 0x00,             //  Logical Minimum (0),

  122.         0x25, 0x01,             //  Logical Maximum (1),

  123.         0x81, 0x02,             //  Input (Data, Variable, Absolute), ;Modifier keys

  124.         0x95, 0x01,             //   Report Count (1),

  125.         0x75, 0x08,             //   Report Size (8),

  126.         0x81, 0x03,             //   Input (Constant),                 ;Reserved byte

  127.         0x95, 0x05,             //  Report Count (5),

  128.         0x75, 0x01,             //  Report Size (1),

  129.         0x05, 0x08,             //  Usage Page (LEDs),

  130.         0x19, 0x01,             //  Usage Minimum (1),

  131.         0x29, 0x05,             //  Usage Maximum (5),

  132.         0x91, 0x02,             //  Output (Data, Variable, Absolute), ;LED report

  133.         0x95, 0x01,             //  Report Count (1),

  134.         0x75, 0x03,             //  Report Size (3),

  135.         0x91, 0x03,             //  Output (Constant),                 ;LED report padding

  136.         0x95, 0x06,             //  Report Count (6),

  137.         0x75, 0x08,             //  Report Size (8),

  138.         0x15, 0x00,             //  Logical Minimum (0),

  139.         0x25, 0x7F,             //  Logical Maximum(104),

  140.         0x05, 0x07,             //  Usage Page (Key Codes),

  141.         0x19, 0x00,             //  Usage Minimum (0),

  142.         0x29, 0x7F,             //  Usage Maximum (104),

  143.         0x81, 0x00,             //  Input (Data, Array),                ;Normal keys

  144.         0xC0                    //  End Collection

  145. };

  146. #endif

  147. 

  148. #ifdef KEYMEDIA_INTERFACE

  149. static uint8_t keymedia_report_desc[] = {

  150.         0x05, 0x0C,             //  Usage Page (Consumer)

  151.         0x09, 0x01,             //  Usage (Consumer Controls)

  152.         0xA1, 0x01,             //  Collection (Application)

  153.         0x75, 0x0A,             //  Report Size (10)

  154.         0x95, 0x04,             //  Report Count (4)

  155.         0x19, 0x00,             //  Usage Minimum (0)

  156.         0x2A, 0x9C, 0x02,       //  Usage Maximum (0x29C)

  157.         0x15, 0x00,             //  Logical Minimum (0)

  158.         0x26, 0x9C, 0x02,       //  Logical Maximum (0x29C)

  159.         0x81, 0x00,             //  Input (Data, Array)

  160.         0x05, 0x01,             //  Usage Page (Generic Desktop)

  161.         0x75, 0x08,             //  Report Size (8)

  162.         0x95, 0x03,             //  Report Count (3)

  163.         0x19, 0x00,             //  Usage Minimum (0)

  164.         0x29, 0xB7,             //  Usage Maximum (0xB7)

  165.         0x15, 0x00,             //  Logical Minimum (0)

  166.         0x26, 0xB7, 0x00,       //  Logical Maximum (0xB7)

  167.         0x81, 0x00,             //  Input (Data, Array)

  168.         0xC0                    //  End Collection

  169. };

  170. #endif

  171. 

  172. #ifdef MOUSE_INTERFACE

  173. // Mouse Protocol 1, HID 1.11 spec, Appendix B, page 59-60, with wheel extension

  174. static uint8_t mouse_report_desc[] = {

  175.         0x05, 0x01,                     // Usage Page (Generic Desktop)

  176.         0x09, 0x02,                     // Usage (Mouse)

  177.         0xA1, 0x01,                     // Collection (Application)

  178.         0x85, 0x01,                     //   REPORT_ID (1)

  179.         0x05, 0x09,                     //   Usage Page (Button)

  180.         0x19, 0x01,                     //   Usage Minimum (Button #1)

  181.         0x29, 0x08,                     //   Usage Maximum (Button #8)

  182.         0x15, 0x00,                     //   Logical Minimum (0)

  183.         0x25, 0x01,                     //   Logical Maximum (1)

  184.         0x95, 0x08,                     //   Report Count (8)

  185.         0x75, 0x01,                     //   Report Size (1)

  186.         0x81, 0x02,                     //   Input (Data, Variable, Absolute)

  187.         0x05, 0x01,                     //   Usage Page (Generic Desktop)

  188.         0x09, 0x30,                     //   Usage (X)

  189.         0x09, 0x31,                     //   Usage (Y)

  190.         0x09, 0x38,                     //   Usage (Wheel)

  191.         0x15, 0x81,                     //   Logical Minimum (-127)

  192.         0x25, 0x7F,                     //   Logical Maximum (127)

  193.         0x75, 0x08,                     //   Report Size (8),

  194.         0x95, 0x03,                     //   Report Count (3),

  195.         0x81, 0x06,                     //   Input (Data, Variable, Relative)

  196.         0xC0,                           // End Collection

  197.         0x05, 0x01,                     // Usage Page (Generic Desktop)

  198.         0x09, 0x02,                     // Usage (Mouse)

  199.         0xA1, 0x01,                     // Collection (Application)

  200.         0x85, 0x02,                     //   REPORT_ID (2)

  201.         0x05, 0x01,                     //   Usage Page (Generic Desktop)

  202.         0x09, 0x30,                     //   Usage (X)

  203.         0x09, 0x31,                     //   Usage (Y)

  204.         0x15, 0x00,                     //   Logical Minimum (0)

  205.         0x26, 0xFF, 0x7F,               //   Logical Maximum (32767)

  206.         0x75, 0x10,                     //   Report Size (16),

  207.         0x95, 0x02,                     //   Report Count (2),

  208.         0x81, 0x02,                     //   Input (Data, Variable, Absolute)

  209.         0xC0                            // End Collection

  210. };

  211. #endif

  212. 

  213. #ifdef JOYSTICK_INTERFACE

  214. static uint8_t joystick_report_desc[] = {

  215.         0x05, 0x01,                     // Usage Page (Generic Desktop)

  216.         0x09, 0x04,                     // Usage (Joystick)

  217.         0xA1, 0x01,                     // Collection (Application)

  218.         0x15, 0x00,                     // Logical Minimum (0)

  219.         0x25, 0x01,                     // Logical Maximum (1)

  220.         0x75, 0x01,                     // Report Size (1)

  221.         0x95, 0x20,                     // Report Count (32)

  222.         0x05, 0x09,                     // Usage Page (Button)

  223.         0x19, 0x01,                     // Usage Minimum (Button #1)

  224.         0x29, 0x20,                     // Usage Maximum (Button #32)

  225.         0x81, 0x02,                     // Input (variable,absolute)

  226.         0x15, 0x00,                     // Logical Minimum (0)

  227.         0x25, 0x07,                     // Logical Maximum (7)

  228.         0x35, 0x00,                     // Physical Minimum (0)

  229.         0x46, 0x3B, 0x01,               // Physical Maximum (315)

  230.         0x75, 0x04,                     // Report Size (4)

  231.         0x95, 0x01,                     // Report Count (1)

  232.         0x65, 0x14,                     // Unit (20)

  233.         0x05, 0x01,                     // Usage Page (Generic Desktop)

  234.         0x09, 0x39,                     // Usage (Hat switch)

  235.         0x81, 0x42,                     // Input (variable,absolute,null_state)

  236.         0x05, 0x01,                     // Usage Page (Generic Desktop)

  237.         0x09, 0x01,                     // Usage (Pointer)

  238.         0xA1, 0x00,                     // Collection ()

  239.         0x15, 0x00,                     //   Logical Minimum (0)

  240.         0x26, 0xFF, 0x03,               //   Logical Maximum (1023)

  241.         0x75, 0x0A,                     //   Report Size (10)

  242.         0x95, 0x04,                     //   Report Count (4)

  243.         0x09, 0x30,                     //   Usage (X)

  244.         0x09, 0x31,                     //   Usage (Y)

  245.         0x09, 0x32,                     //   Usage (Z)

  246.         0x09, 0x35,                     //   Usage (Rz)

  247.         0x81, 0x02,                     //   Input (variable,absolute)

  248.         0xC0,                           // End Collection

  249.         0x15, 0x00,                     // Logical Minimum (0)

  250.         0x26, 0xFF, 0x03,               // Logical Maximum (1023)

  251.         0x75, 0x0A,                     // Report Size (10)

  252.         0x95, 0x02,                     // Report Count (2)

  253.         0x09, 0x36,                     // Usage (Slider)

  254.         0x09, 0x36,                     // Usage (Slider)

  255.         0x81, 0x02,                     // Input (variable,absolute)

  256.         0xC0                            // End Collection

  257. };

  258. #endif

  259. 

  260. #ifdef SEREMU_INTERFACE

  261. static uint8_t seremu_report_desc[] = {

  262.         0x06, 0xC9, 0xFF,                       // Usage Page 0xFFC9 (vendor defined)

  263.         0x09, 0x04,                             // Usage 0x04

  264.         0xA1, 0x5C,                             // Collection 0x5C

  265.         0x75, 0x08,                             // report size = 8 bits (global)

  266.         0x15, 0x00,                             // logical minimum = 0 (global)

  267.         0x26, 0xFF, 0x00,                       // logical maximum = 255 (global)

  268.         0x95, SEREMU_TX_SIZE,                   // report count (global)

  269.         0x09, 0x75,                             // usage (local)

  270.         0x81, 0x02,                             // Input

  271.         0x95, SEREMU_RX_SIZE,                   // report count (global)

  272.         0x09, 0x76,                             // usage (local)

  273.         0x91, 0x02,                             // Output

  274.         0x95, 0x04,                             // report count (global)

  275.         0x09, 0x76,                             // usage (local)

  276.         0xB1, 0x02,                             // Feature

  277.         0xC0                                    // end collection

  278. };

  279. #endif

  280. 

  281. #ifdef RAWHID_INTERFACE

  282. static uint8_t rawhid_report_desc[] = {

  283.         0x06, LSB(RAWHID_USAGE_PAGE), MSB(RAWHID_USAGE_PAGE),

  284.         0x0A, LSB(RAWHID_USAGE), MSB(RAWHID_USAGE),

  285.         0xA1, 0x01,                             // Collection 0x01

  286.         0x75, 0x08,                             // report size = 8 bits

  287.         0x15, 0x00,                             // logical minimum = 0

  288.         0x26, 0xFF, 0x00,                       // logical maximum = 255

  289.         0x95, RAWHID_TX_SIZE,                   // report count

  290.         0x09, 0x01,                             // usage

  291.         0x81, 0x02,                             // Input (array)

  292.         0x95, RAWHID_RX_SIZE,                   // report count

  293.         0x09, 0x02,                             // usage

  294.         0x91, 0x02,                             // Output (array)

  295.         0xC0                                    // end collection

  296. };

  297. #endif

  298. 

  299. #ifdef FLIGHTSIM_INTERFACE

  300. static uint8_t flightsim_report_desc[] = {

  301.         0x06, 0x1C, 0xFF,                       // Usage page = 0xFF1C

  302.         0x0A, 0x39, 0xA7,                       // Usage = 0xA739

  303.         0xA1, 0x01,                             // Collection 0x01

  304.         0x75, 0x08,                             // report size = 8 bits

  305.         0x15, 0x00,                             // logical minimum = 0

  306.         0x26, 0xFF, 0x00,                       // logical maximum = 255

  307.         0x95, FLIGHTSIM_TX_SIZE,                // report count

  308.         0x09, 0x01,                             // usage

  309.         0x81, 0x02,                             // Input (array)

  310.         0x95, FLIGHTSIM_RX_SIZE,                // report count

  311.         0x09, 0x02,                             // usage

  312.         0x91, 0x02,                             // Output (array)

  313.         0xC0                                    // end collection

  314. };

  315. #endif

  316. 

  317. 

  318. // **************************************************************

  319. //   USB Descriptor Sizes

  320. // **************************************************************

  321. 

  322. // pre-compute the size and position of everything in the config descriptor

  323. //

  324. #define CONFIG_HEADER_DESCRIPTOR_SIZE	9

  325. 

  326. #define CDC_IAD_DESCRIPTOR_POS		CONFIG_HEADER_DESCRIPTOR_SIZE

  327. #ifdef  CDC_IAD_DESCRIPTOR

  328. #define CDC_IAD_DESCRIPTOR_SIZE		8

  329. #else

  330. #define CDC_IAD_DESCRIPTOR_SIZE		0

  331. #endif

  332. 

  333. #define CDC_DATA_INTERFACE_DESC_POS	CDC_IAD_DESCRIPTOR_POS+CDC_IAD_DESCRIPTOR_SIZE

  334. #ifdef  CDC_DATA_INTERFACE

  335. #define CDC_DATA_INTERFACE_DESC_SIZE	9+5+5+4+5+7+9+7+7

  336. #else

  337. #define CDC_DATA_INTERFACE_DESC_SIZE	0

  338. #endif

  339. 

  340. #define MIDI_INTERFACE_DESC_POS		CDC_DATA_INTERFACE_DESC_POS+CDC_DATA_INTERFACE_DESC_SIZE

  341. #ifdef  MIDI_INTERFACE

  342. #define MIDI_INTERFACE_DESC_SIZE	9+7+6+6+9+9+9+5+9+5

  343. #else

  344. #define MIDI_INTERFACE_DESC_SIZE	0

  345. #endif

  346. 

  347. #define KEYBOARD_INTERFACE_DESC_POS	MIDI_INTERFACE_DESC_POS+MIDI_INTERFACE_DESC_SIZE

  348. #ifdef  KEYBOARD_INTERFACE

  349. #define KEYBOARD_INTERFACE_DESC_SIZE	9+9+7

  350. #define KEYBOARD_HID_DESC_OFFSET	KEYBOARD_INTERFACE_DESC_POS+9

  351. #else

  352. #define KEYBOARD_INTERFACE_DESC_SIZE	0

  353. #endif

  354. 

  355. #define MOUSE_INTERFACE_DESC_POS	KEYBOARD_INTERFACE_DESC_POS+KEYBOARD_INTERFACE_DESC_SIZE

  356. #ifdef  MOUSE_INTERFACE

  357. #define MOUSE_INTERFACE_DESC_SIZE	9+9+7

  358. #define MOUSE_HID_DESC_OFFSET		MOUSE_INTERFACE_DESC_POS+9

  359. #else

  360. #define MOUSE_INTERFACE_DESC_SIZE	0

  361. #endif

  362. 

  363. #define RAWHID_INTERFACE_DESC_POS	MOUSE_INTERFACE_DESC_POS+MOUSE_INTERFACE_DESC_SIZE

  364. #ifdef  RAWHID_INTERFACE

  365. #define RAWHID_INTERFACE_DESC_SIZE	9+9+7+7

  366. #define RAWHID_HID_DESC_OFFSET		RAWHID_INTERFACE_DESC_POS+9

  367. #else

  368. #define RAWHID_INTERFACE_DESC_SIZE	0

  369. #endif

  370. 

  371. #define FLIGHTSIM_INTERFACE_DESC_POS	RAWHID_INTERFACE_DESC_POS+RAWHID_INTERFACE_DESC_SIZE

  372. #ifdef  FLIGHTSIM_INTERFACE

  373. #define FLIGHTSIM_INTERFACE_DESC_SIZE	9+9+7+7

  374. #define FLIGHTSIM_HID_DESC_OFFSET	FLIGHTSIM_INTERFACE_DESC_POS+9

  375. #else

  376. #define FLIGHTSIM_INTERFACE_DESC_SIZE	0

  377. #endif

  378. 

  379. #define SEREMU_INTERFACE_DESC_POS	FLIGHTSIM_INTERFACE_DESC_POS+FLIGHTSIM_INTERFACE_DESC_SIZE

  380. #ifdef  SEREMU_INTERFACE

  381. #define SEREMU_INTERFACE_DESC_SIZE	9+9+7+7

  382. #define SEREMU_HID_DESC_OFFSET		SEREMU_INTERFACE_DESC_POS+9

  383. #else

  384. #define SEREMU_INTERFACE_DESC_SIZE	0

  385. #endif

  386. 

  387. #define JOYSTICK_INTERFACE_DESC_POS	SEREMU_INTERFACE_DESC_POS+SEREMU_INTERFACE_DESC_SIZE

  388. #ifdef  JOYSTICK_INTERFACE

  389. #define JOYSTICK_INTERFACE_DESC_SIZE	9+9+7

  390. #define JOYSTICK_HID_DESC_OFFSET	JOYSTICK_INTERFACE_DESC_POS+9

  391. #else

  392. #define JOYSTICK_INTERFACE_DESC_SIZE	0

  393. #endif

  394. 

  395. #define MTP_INTERFACE_DESC_POS		JOYSTICK_INTERFACE_DESC_POS+JOYSTICK_INTERFACE_DESC_SIZE

  396. #ifdef  MTP_INTERFACE

  397. #define MTP_INTERFACE_DESC_SIZE		9+7+7+7

  398. #else

  399. #define MTP_INTERFACE_DESC_SIZE	0

  400. #endif

  401. 

  402. #define KEYMEDIA_INTERFACE_DESC_POS	MTP_INTERFACE_DESC_POS+MTP_INTERFACE_DESC_SIZE

  403. #ifdef  KEYMEDIA_INTERFACE

  404. #define KEYMEDIA_INTERFACE_DESC_SIZE	9+9+7

  405. #define KEYMEDIA_HID_DESC_OFFSET	KEYMEDIA_INTERFACE_DESC_POS+9

  406. #else

  407. #define KEYMEDIA_INTERFACE_DESC_SIZE	0

  408. #endif

  409. 

  410. #define AUDIO_INTERFACE_DESC_POS	KEYMEDIA_INTERFACE_DESC_POS+KEYMEDIA_INTERFACE_DESC_SIZE

  411. #ifdef  AUDIO_INTERFACE

  412. #define AUDIO_INTERFACE_DESC_SIZE	9+10+12+9+12+9 + 9+9+7+11+9+7 + 9+9+7+11+9+7+9

  413. #else

  414. #define AUDIO_INTERFACE_DESC_SIZE	0

  415. #endif

  416. 

  417. #define CONFIG_DESC_SIZE		AUDIO_INTERFACE_DESC_POS+AUDIO_INTERFACE_DESC_SIZE

  418. 

  419. 

  420. 

  421. // **************************************************************

  422. //   USB Configuration

  423. // **************************************************************

  424. 

  425. // USB Configuration Descriptor.  This huge descriptor tells all

  426. // of the devices capbilities.

  427. static uint8_t config_descriptor[CONFIG_DESC_SIZE] = {

  428.         // configuration descriptor, USB spec 9.6.3, page 264-266, Table 9-10

  429.         9,                                      // bLength;

  430.         2,                                      // bDescriptorType;

  431.         LSB(CONFIG_DESC_SIZE),                 // wTotalLength

  432.         MSB(CONFIG_DESC_SIZE),

  433.         NUM_INTERFACE,                          // bNumInterfaces

  434.         1,                                      // bConfigurationValue

  435.         0,                                      // iConfiguration

  436.         0xC0,                                   // bmAttributes

  437.         50,                                     // bMaxPower

  438. 

  439. #ifdef CDC_IAD_DESCRIPTOR

  440.         // interface association descriptor, USB ECN, Table 9-Z

  441.         8,                                      // bLength

  442.         11,                                     // bDescriptorType

  443.         CDC_STATUS_INTERFACE,                   // bFirstInterface

  444.         2,                                      // bInterfaceCount

  445.         0x02,                                   // bFunctionClass

  446.         0x02,                                   // bFunctionSubClass

  447.         0x01,                                   // bFunctionProtocol

  448.         4,                                      // iFunction

  449. #endif

  450. 

  451. #ifdef CDC_DATA_INTERFACE

  452.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  453.         9,                                      // bLength

  454.         4,                                      // bDescriptorType

  455.         CDC_STATUS_INTERFACE,			// bInterfaceNumber

  456.         0,                                      // bAlternateSetting

  457.         1,                                      // bNumEndpoints

  458.         0x02,                                   // bInterfaceClass

  459.         0x02,                                   // bInterfaceSubClass

  460.         0x01,                                   // bInterfaceProtocol

  461.         0,                                      // iInterface

  462.         // CDC Header Functional Descriptor, CDC Spec 5.2.3.1, Table 26

  463.         5,                                      // bFunctionLength

  464.         0x24,                                   // bDescriptorType

  465.         0x00,                                   // bDescriptorSubtype

  466.         0x10, 0x01,                             // bcdCDC

  467.         // Call Management Functional Descriptor, CDC Spec 5.2.3.2, Table 27

  468.         5,                                      // bFunctionLength

  469.         0x24,                                   // bDescriptorType

  470.         0x01,                                   // bDescriptorSubtype

  471.         0x01,                                   // bmCapabilities

  472.         1,                                      // bDataInterface

  473.         // Abstract Control Management Functional Descriptor, CDC Spec 5.2.3.3, Table 28

  474.         4,                                      // bFunctionLength

  475.         0x24,                                   // bDescriptorType

  476.         0x02,                                   // bDescriptorSubtype

  477.         0x06,                                   // bmCapabilities

  478.         // Union Functional Descriptor, CDC Spec 5.2.3.8, Table 33

  479.         5,                                      // bFunctionLength

  480.         0x24,                                   // bDescriptorType

  481.         0x06,                                   // bDescriptorSubtype

  482.         CDC_STATUS_INTERFACE,                   // bMasterInterface

  483.         CDC_DATA_INTERFACE,                     // bSlaveInterface0

  484.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  485.         7,                                      // bLength

  486.         5,                                      // bDescriptorType

  487.         CDC_ACM_ENDPOINT | 0x80,                // bEndpointAddress

  488.         0x03,                                   // bmAttributes (0x03=intr)

  489.         CDC_ACM_SIZE, 0,                        // wMaxPacketSize

  490.         64,                                     // bInterval

  491.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  492.         9,                                      // bLength

  493.         4,                                      // bDescriptorType

  494.         CDC_DATA_INTERFACE,                     // bInterfaceNumber

  495.         0,                                      // bAlternateSetting

  496.         2,                                      // bNumEndpoints

  497.         0x0A,                                   // bInterfaceClass

  498.         0x00,                                   // bInterfaceSubClass

  499.         0x00,                                   // bInterfaceProtocol

  500.         0,                                      // iInterface

  501.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  502.         7,                                      // bLength

  503.         5,                                      // bDescriptorType

  504.         CDC_RX_ENDPOINT,                        // bEndpointAddress

  505.         0x02,                                   // bmAttributes (0x02=bulk)

  506.         CDC_RX_SIZE, 0,                         // wMaxPacketSize

  507.         0,                                      // bInterval

  508.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  509.         7,                                      // bLength

  510.         5,                                      // bDescriptorType

  511.         CDC_TX_ENDPOINT | 0x80,                 // bEndpointAddress

  512.         0x02,                                   // bmAttributes (0x02=bulk)

  513.         CDC_TX_SIZE, 0,                         // wMaxPacketSize

  514.         0,                                      // bInterval

  515. #endif // CDC_DATA_INTERFACE

  516. 

  517. #ifdef MIDI_INTERFACE

  518.         // Standard MS Interface Descriptor,

  519.         9,                                      // bLength

  520.         4,                                      // bDescriptorType

  521.         MIDI_INTERFACE,                         // bInterfaceNumber

  522.         0,                                      // bAlternateSetting

  523.         2,                                      // bNumEndpoints

  524.         0x01,                                   // bInterfaceClass (0x01 = Audio)

  525.         0x03,                                   // bInterfaceSubClass (0x03 = MIDI)

  526.         0x00,                                   // bInterfaceProtocol (unused for MIDI)

  527.         0,                                      // iInterface

  528.         // MIDI MS Interface Header, USB MIDI 6.1.2.1, page 21, Table 6-2

  529.         7,                                      // bLength

  530.         0x24,                                   // bDescriptorType = CS_INTERFACE

  531.         0x01,                                   // bDescriptorSubtype = MS_HEADER

  532.         0x00, 0x01,                             // bcdMSC = revision 01.00

  533.         0x41, 0x00,                             // wTotalLength

  534.         // MIDI IN Jack Descriptor, B.4.3, Table B-7 (embedded), page 40

  535.         6,                                      // bLength

  536.         0x24,                                   // bDescriptorType = CS_INTERFACE

  537.         0x02,                                   // bDescriptorSubtype = MIDI_IN_JACK

  538.         0x01,                                   // bJackType = EMBEDDED

  539.         1,                                      // bJackID, ID = 1

  540.         0,                                      // iJack

  541.         // MIDI IN Jack Descriptor, B.4.3, Table B-8 (external), page 40

  542.         6,                                      // bLength

  543.         0x24,                                   // bDescriptorType = CS_INTERFACE

  544.         0x02,                                   // bDescriptorSubtype = MIDI_IN_JACK

  545.         0x02,                                   // bJackType = EXTERNAL

  546.         2,                                      // bJackID, ID = 2

  547.         0,                                      // iJack

  548.         // MIDI OUT Jack Descriptor, B.4.4, Table B-9, page 41

  549.         9,

  550.         0x24,                                   // bDescriptorType = CS_INTERFACE

  551.         0x03,                                   // bDescriptorSubtype = MIDI_OUT_JACK

  552.         0x01,                                   // bJackType = EMBEDDED

  553.         3,                                      // bJackID, ID = 3

  554.         1,                                      // bNrInputPins = 1 pin

  555.         2,                                      // BaSourceID(1) = 2

  556.         1,                                      // BaSourcePin(1) = first pin

  557.         0,                                      // iJack

  558.         // MIDI OUT Jack Descriptor, B.4.4, Table B-10, page 41

  559.         9,

  560.         0x24,                                   // bDescriptorType = CS_INTERFACE

  561.         0x03,                                   // bDescriptorSubtype = MIDI_OUT_JACK

  562.         0x02,                                   // bJackType = EXTERNAL

  563.         4,                                      // bJackID, ID = 4

  564.         1,                                      // bNrInputPins = 1 pin

  565.         1,                                      // BaSourceID(1) = 1

  566.         1,                                      // BaSourcePin(1) = first pin

  567.         0,                                      // iJack

  568.         // Standard Bulk OUT Endpoint Descriptor, B.5.1, Table B-11, pae 42

  569.         9,                                      // bLength

  570.         5,                                      // bDescriptorType = ENDPOINT

  571.         MIDI_RX_ENDPOINT,                       // bEndpointAddress

  572.         0x02,                                   // bmAttributes (0x02=bulk)

  573.         MIDI_RX_SIZE, 0,                        // wMaxPacketSize

  574.         0,                                      // bInterval

  575.         0,                                      // bRefresh

  576.         0,                                      // bSynchAddress

  577.         // Class-specific MS Bulk OUT Endpoint Descriptor, B.5.2, Table B-12, page 42

  578.         5,                                      // bLength

  579.         0x25,                                   // bDescriptorSubtype = CS_ENDPOINT

  580.         0x01,                                   // bJackType = MS_GENERAL

  581.         1,                                      // bNumEmbMIDIJack = 1 jack

  582.         1,                                      // BaAssocJackID(1) = jack ID #1

  583.         // Standard Bulk IN Endpoint Descriptor, B.5.1, Table B-11, pae 42

  584.         9,                                      // bLength

  585.         5,                                      // bDescriptorType = ENDPOINT

  586.         MIDI_TX_ENDPOINT | 0x80,                // bEndpointAddress

  587.         0x02,                                   // bmAttributes (0x02=bulk)

  588.         MIDI_TX_SIZE, 0,                        // wMaxPacketSize

  589.         0,                                      // bInterval

  590.         0,                                      // bRefresh

  591.         0,                                      // bSynchAddress

  592.         // Class-specific MS Bulk IN Endpoint Descriptor, B.5.2, Table B-12, page 42

  593.         5,                                      // bLength

  594.         0x25,                                   // bDescriptorSubtype = CS_ENDPOINT

  595.         0x01,                                   // bJackType = MS_GENERAL

  596.         1,                                      // bNumEmbMIDIJack = 1 jack

  597.         3,                                      // BaAssocJackID(1) = jack ID #3

  598. #endif // MIDI_INTERFACE

  599. 

  600. #ifdef KEYBOARD_INTERFACE

  601.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  602.         9,                                      // bLength

  603.         4,                                      // bDescriptorType

  604.         KEYBOARD_INTERFACE,                     // bInterfaceNumber

  605.         0,                                      // bAlternateSetting

  606.         1,                                      // bNumEndpoints

  607.         0x03,                                   // bInterfaceClass (0x03 = HID)

  608.         0x01,                                   // bInterfaceSubClass (0x01 = Boot)

  609.         0x01,                                   // bInterfaceProtocol (0x01 = Keyboard)

  610.         0,                                      // iInterface

  611.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  612.         9,                                      // bLength

  613.         0x21,                                   // bDescriptorType

  614.         0x11, 0x01,                             // bcdHID

  615.         0,                                      // bCountryCode

  616.         1,                                      // bNumDescriptors

  617.         0x22,                                   // bDescriptorType

  618.         LSB(sizeof(keyboard_report_desc)),      // wDescriptorLength

  619.         MSB(sizeof(keyboard_report_desc)),

  620.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  621.         7,                                      // bLength

  622.         5,                                      // bDescriptorType

  623.         KEYBOARD_ENDPOINT | 0x80,               // bEndpointAddress

  624.         0x03,                                   // bmAttributes (0x03=intr)

  625.         KEYBOARD_SIZE, 0,                       // wMaxPacketSize

  626.         KEYBOARD_INTERVAL,                      // bInterval

  627. #endif // KEYBOARD_INTERFACE

  628. 

  629. #ifdef MOUSE_INTERFACE

  630.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  631.         9,                                      // bLength

  632.         4,                                      // bDescriptorType

  633.         MOUSE_INTERFACE,                        // bInterfaceNumber

  634.         0,                                      // bAlternateSetting

  635.         1,                                      // bNumEndpoints

  636.         0x03,                                   // bInterfaceClass (0x03 = HID)

  637.         0x00,                                   // bInterfaceSubClass (0x01 = Boot)

  638.         0x00,                                   // bInterfaceProtocol (0x02 = Mouse)

  639.         0,                                      // iInterface

  640.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  641.         9,                                      // bLength

  642.         0x21,                                   // bDescriptorType

  643.         0x11, 0x01,                             // bcdHID

  644.         0,                                      // bCountryCode

  645.         1,                                      // bNumDescriptors

  646.         0x22,                                   // bDescriptorType

  647.         LSB(sizeof(mouse_report_desc)),         // wDescriptorLength

  648.         MSB(sizeof(mouse_report_desc)),

  649.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  650.         7,                                      // bLength

  651.         5,                                      // bDescriptorType

  652.         MOUSE_ENDPOINT | 0x80,                  // bEndpointAddress

  653.         0x03,                                   // bmAttributes (0x03=intr)

  654.         MOUSE_SIZE, 0,                          // wMaxPacketSize

  655.         MOUSE_INTERVAL,                         // bInterval

  656. #endif // MOUSE_INTERFACE

  657. 

  658. #ifdef RAWHID_INTERFACE

  659.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  660.         9,                                      // bLength

  661.         4,                                      // bDescriptorType

  662.         RAWHID_INTERFACE,                       // bInterfaceNumber

  663.         0,                                      // bAlternateSetting

  664.         2,                                      // bNumEndpoints

  665.         0x03,                                   // bInterfaceClass (0x03 = HID)

  666.         0x00,                                   // bInterfaceSubClass

  667.         0x00,                                   // bInterfaceProtocol

  668.         0,                                      // iInterface

  669.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  670.         9,                                      // bLength

  671.         0x21,                                   // bDescriptorType

  672.         0x11, 0x01,                             // bcdHID

  673.         0,                                      // bCountryCode

  674.         1,                                      // bNumDescriptors

  675.         0x22,                                   // bDescriptorType

  676.         LSB(sizeof(rawhid_report_desc)),        // wDescriptorLength

  677.         MSB(sizeof(rawhid_report_desc)),

  678.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  679.         7,                                      // bLength

  680.         5,                                      // bDescriptorType

  681.         RAWHID_TX_ENDPOINT | 0x80,              // bEndpointAddress

  682.         0x03,                                   // bmAttributes (0x03=intr)

  683.         RAWHID_TX_SIZE, 0,                      // wMaxPacketSize

  684.         RAWHID_TX_INTERVAL,                     // bInterval

  685.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  686.         7,                                      // bLength

  687.         5,                                      // bDescriptorType

  688.         RAWHID_RX_ENDPOINT,                     // bEndpointAddress

  689.         0x03,                                   // bmAttributes (0x03=intr)

  690.         RAWHID_RX_SIZE, 0,                      // wMaxPacketSize

  691.         RAWHID_RX_INTERVAL,			// bInterval

  692. #endif // RAWHID_INTERFACE

  693. 

  694. #ifdef FLIGHTSIM_INTERFACE

  695.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  696.         9,                                      // bLength

  697.         4,                                      // bDescriptorType

  698.         FLIGHTSIM_INTERFACE,                    // bInterfaceNumber

  699.         0,                                      // bAlternateSetting

  700.         2,                                      // bNumEndpoints

  701.         0x03,                                   // bInterfaceClass (0x03 = HID)

  702.         0x00,                                   // bInterfaceSubClass

  703.         0x00,                                   // bInterfaceProtocol

  704.         0,                                      // iInterface

  705.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  706.         9,                                      // bLength

  707.         0x21,                                   // bDescriptorType

  708.         0x11, 0x01,                             // bcdHID

  709.         0,                                      // bCountryCode

  710.         1,                                      // bNumDescriptors

  711.         0x22,                                   // bDescriptorType

  712.         LSB(sizeof(flightsim_report_desc)),     // wDescriptorLength

  713.         MSB(sizeof(flightsim_report_desc)),

  714.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  715.         7,                                      // bLength

  716.         5,                                      // bDescriptorType

  717.         FLIGHTSIM_TX_ENDPOINT | 0x80,           // bEndpointAddress

  718.         0x03,                                   // bmAttributes (0x03=intr)

  719.         FLIGHTSIM_TX_SIZE, 0,                   // wMaxPacketSize

  720.         FLIGHTSIM_TX_INTERVAL,                  // bInterval

  721.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  722.         7,                                      // bLength

  723.         5,                                      // bDescriptorType

  724.         FLIGHTSIM_RX_ENDPOINT,                  // bEndpointAddress

  725.         0x03,                                   // bmAttributes (0x03=intr)

  726.         FLIGHTSIM_RX_SIZE, 0,                   // wMaxPacketSize

  727.         FLIGHTSIM_RX_INTERVAL,			// bInterval

  728. #endif // FLIGHTSIM_INTERFACE

  729. 

  730. #ifdef SEREMU_INTERFACE

  731.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  732.         9,                                      // bLength

  733.         4,                                      // bDescriptorType

  734.         SEREMU_INTERFACE,                       // bInterfaceNumber

  735.         0,                                      // bAlternateSetting

  736.         2,                                      // bNumEndpoints

  737.         0x03,                                   // bInterfaceClass (0x03 = HID)

  738.         0x00,                                   // bInterfaceSubClass

  739.         0x00,                                   // bInterfaceProtocol

  740.         0,                                      // iInterface

  741.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  742.         9,                                      // bLength

  743.         0x21,                                   // bDescriptorType

  744.         0x11, 0x01,                             // bcdHID

  745.         0,                                      // bCountryCode

  746.         1,                                      // bNumDescriptors

  747.         0x22,                                   // bDescriptorType

  748.         LSB(sizeof(seremu_report_desc)),        // wDescriptorLength

  749.         MSB(sizeof(seremu_report_desc)),

  750.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  751.         7,                                      // bLength

  752.         5,                                      // bDescriptorType

  753.         SEREMU_TX_ENDPOINT | 0x80,              // bEndpointAddress

  754.         0x03,                                   // bmAttributes (0x03=intr)

  755.         SEREMU_TX_SIZE, 0,                      // wMaxPacketSize

  756.         SEREMU_TX_INTERVAL,                     // bInterval

  757.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  758.         7,                                      // bLength

  759.         5,                                      // bDescriptorType

  760.         SEREMU_RX_ENDPOINT,                     // bEndpointAddress

  761.         0x03,                                   // bmAttributes (0x03=intr)

  762.         SEREMU_RX_SIZE, 0,                      // wMaxPacketSize

  763.         SEREMU_RX_INTERVAL,			// bInterval

  764. #endif // SEREMU_INTERFACE

  765. 

  766. #ifdef JOYSTICK_INTERFACE

  767.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  768.         9,                                      // bLength

  769.         4,                                      // bDescriptorType

  770.         JOYSTICK_INTERFACE,                     // bInterfaceNumber

  771.         0,                                      // bAlternateSetting

  772.         1,                                      // bNumEndpoints

  773.         0x03,                                   // bInterfaceClass (0x03 = HID)

  774.         0x00,                                   // bInterfaceSubClass

  775.         0x00,                                   // bInterfaceProtocol

  776.         0,                                      // iInterface

  777.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  778.         9,                                      // bLength

  779.         0x21,                                   // bDescriptorType

  780.         0x11, 0x01,                             // bcdHID

  781.         0,                                      // bCountryCode

  782.         1,                                      // bNumDescriptors

  783.         0x22,                                   // bDescriptorType

  784.         LSB(sizeof(joystick_report_desc)),      // wDescriptorLength

  785.         MSB(sizeof(joystick_report_desc)),

  786.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  787.         7,                                      // bLength

  788.         5,                                      // bDescriptorType

  789.         JOYSTICK_ENDPOINT | 0x80,               // bEndpointAddress

  790.         0x03,                                   // bmAttributes (0x03=intr)

  791.         JOYSTICK_SIZE, 0,                       // wMaxPacketSize

  792.         JOYSTICK_INTERVAL,                      // bInterval

  793. #endif // JOYSTICK_INTERFACE

  794. 

  795. #ifdef MTP_INTERFACE

  796.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  797.         9,                                      // bLength

  798.         4,                                      // bDescriptorType

  799.         MTP_INTERFACE,                          // bInterfaceNumber

  800.         0,                                      // bAlternateSetting

  801.         3,                                      // bNumEndpoints

  802.         0x06,                                   // bInterfaceClass (0x06 = still image)

  803.         0x01,                                   // bInterfaceSubClass

  804.         0x01,                                   // bInterfaceProtocol

  805.         0,                                      // iInterface

  806.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  807.         7,                                      // bLength

  808.         5,                                      // bDescriptorType

  809.         MTP_TX_ENDPOINT | 0x80,                 // bEndpointAddress

  810.         0x02,                                   // bmAttributes (0x02=bulk)

  811.         MTP_TX_SIZE, 0,                         // wMaxPacketSize

  812.         0,                                      // bInterval

  813.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  814.         7,                                      // bLength

  815.         5,                                      // bDescriptorType

  816.         MTP_RX_ENDPOINT,                        // bEndpointAddress

  817.         0x02,                                   // bmAttributes (0x02=bulk)

  818.         MTP_RX_SIZE, 0,                         // wMaxPacketSize

  819.         0,                                      // bInterval

  820.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  821.         7,                                      // bLength

  822.         5,                                      // bDescriptorType

  823.         MTP_EVENT_ENDPOINT | 0x80,              // bEndpointAddress

  824.         0x03,                                   // bmAttributes (0x03=intr)

  825.         MTP_EVENT_SIZE, 0,                      // wMaxPacketSize

  826.         MTP_EVENT_INTERVAL,                     // bInterval

  827. #endif // MTP_INTERFACE

  828. 

  829. #ifdef KEYMEDIA_INTERFACE

  830.         // interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12

  831.         9,                                      // bLength

  832.         4,                                      // bDescriptorType

  833.         KEYMEDIA_INTERFACE,                     // bInterfaceNumber

  834.         0,                                      // bAlternateSetting

  835.         1,                                      // bNumEndpoints

  836.         0x03,                                   // bInterfaceClass (0x03 = HID)

  837.         0x00,                                   // bInterfaceSubClass

  838.         0x00,                                   // bInterfaceProtocol

  839.         0,                                      // iInterface

  840.         // HID interface descriptor, HID 1.11 spec, section 6.2.1

  841.         9,                                      // bLength

  842.         0x21,                                   // bDescriptorType

  843.         0x11, 0x01,                             // bcdHID

  844.         0,                                      // bCountryCode

  845.         1,                                      // bNumDescriptors

  846.         0x22,                                   // bDescriptorType

  847.         LSB(sizeof(keymedia_report_desc)),      // wDescriptorLength

  848.         MSB(sizeof(keymedia_report_desc)),

  849.         // endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13

  850.         7,                                      // bLength

  851.         5,                                      // bDescriptorType

  852.         KEYMEDIA_ENDPOINT | 0x80,               // bEndpointAddress

  853.         0x03,                                   // bmAttributes (0x03=intr)

  854.         KEYMEDIA_SIZE, 0,                       // wMaxPacketSize

  855.         KEYMEDIA_INTERVAL,                      // bInterval

  856. #endif // KEYMEDIA_INTERFACE

  857. 

  858. #ifdef AUDIO_INTERFACE

  859. 	// Standard AudioControl (AC) Interface Descriptor

  860. 	// USB DCD for Audio Devices 1.0, Table 4-1, page 36

  861. 	9,					// bLength

  862. 	4,					// bDescriptorType, 4 = INTERFACE

  863. 	AUDIO_INTERFACE,			// bInterfaceNumber

  864. 	0,					// bAlternateSetting

  865. 	0,					// bNumEndpoints

  866. 	1,					// bInterfaceClass, 1 = AUDIO

  867. 	1,					// bInterfaceSubclass, 1 = AUDIO_CONTROL

  868. 	0,					// bInterfaceProtocol

  869. 	0,					// iInterface

  870. 	// Class-specific AC Interface Header Descriptor

  871. 	// USB DCD for Audio Devices 1.0, Table 4-2, page 37-38

  872. 	10,					// bLength

  873. 	0x24,					// bDescriptorType, 0x24 = CS_INTERFACE

  874. 	0x01,					// bDescriptorSubtype, 1 = HEADER

  875. 	0x00, 0x01,				// bcdADC (version 1.0)

  876. 	LSB(52), MSB(52),			// wTotalLength

  877. 	2,					// bInCollection

  878. 	AUDIO_INTERFACE+1,			// baInterfaceNr(1) - Transmit to PC

  879. 	AUDIO_INTERFACE+2,			// baInterfaceNr(2) - Receive from PC

  880. 	// Input Terminal Descriptor

  881. 	// USB DCD for Audio Devices 1.0, Table 4-3, page 39

  882. 	12,					// bLength

  883. 	0x24,					// bDescriptorType, 0x24 = CS_INTERFACE

  884. 	0x02,					// bDescriptorSubType, 2 = INPUT_TERMINAL

  885. 	1,					// bTerminalID

  886. 	//0x01, 0x02,				// wTerminalType, 0x0201 = MICROPHONE

  887. 	//0x03, 0x06,				// wTerminalType, 0x0603 = Line Connector

  888. 	0x02, 0x06,				// wTerminalType, 0x0602 = Digital Audio

  889. 	0,					// bAssocTerminal, 0 = unidirectional

  890. 	2,					// bNrChannels

  891. 	0x00, 0x03,				// wChannelConfig, 0x0003 = Left & Right Front

  892. 	0,					// iChannelNames

  893. 	0, 					// iTerminal

  894. 	// Output Terminal Descriptor

  895. 	// USB DCD for Audio Devices 1.0, Table 4-4, page 40

  896. 	9,					// bLength

  897. 	0x24,					// bDescriptorType, 0x24 = CS_INTERFACE

  898. 	3,					// bDescriptorSubtype, 3 = OUTPUT_TERMINAL

  899. 	2,					// bTerminalID

  900. 	0x01, 0x01,				// wTerminalType, 0x0101 = USB_STREAMING

  901. 	0,					// bAssocTerminal, 0 = unidirectional

  902. 	1,					// bCSourceID, connected to input terminal, ID=1

  903. 	0,					// iTerminal

  904. 	// Input Terminal Descriptor

  905. 	// USB DCD for Audio Devices 1.0, Table 4-3, page 39

  906. 	12,					// bLength

  907. 	0x24,					// bDescriptorType, 0x24 = CS_INTERFACE

  908. 	2,					// bDescriptorSubType, 2 = INPUT_TERMINAL

  909. 	3,					// bTerminalID

  910. 	0x01, 0x01,				// wTerminalType, 0x0101 = USB_STREAMING

  911. 	0,					// bAssocTerminal, 0 = unidirectional

  912. 	2,					// bNrChannels

  913. 	0x00, 0x03,				// wChannelConfig, 0x0003 = Left & Right Front

  914. 	0,					// iChannelNames

  915. 	0, 					// iTerminal

  916. 	// Output Terminal Descriptor

  917. 	// USB DCD for Audio Devices 1.0, Table 4-4, page 40

  918. 	9,					// bLength

  919. 	0x24,					// bDescriptorType, 0x24 = CS_INTERFACE

  920. 	3,					// bDescriptorSubtype, 3 = OUTPUT_TERMINAL

  921. 	4,					// bTerminalID

  922. 	//0x02, 0x03,				// wTerminalType, 0x0302 = Headphones

  923. 	0x02, 0x06,				// wTerminalType, 0x0602 = Digital Audio

  924. 	0,					// bAssocTerminal, 0 = unidirectional

  925. 	3,					// bCSourceID, connected to input terminal, ID=3

  926. 	0,					// iTerminal

  927. 	// Standard AS Interface Descriptor

  928. 	// USB DCD for Audio Devices 1.0, Section 4.5.1, Table 4-18, page 59

  929. 	// Alternate 0: default setting, disabled zero bandwidth

  930. 	9,					// bLenght

  931. 	4,					// bDescriptorType = INTERFACE

  932. 	AUDIO_INTERFACE+1,			// bInterfaceNumber

  933. 	0,					// bAlternateSetting

  934. 	0,					// bNumEndpoints

  935. 	1,					// bInterfaceClass, 1 = AUDIO

  936. 	2,					// bInterfaceSubclass, 2 = AUDIO_STREAMING

  937. 	0,					// bInterfaceProtocol

  938. 	0,					// iInterface

  939. 	// Alternate 1: streaming data

  940. 	9,					// bLenght

  941. 	4,					// bDescriptorType = INTERFACE

  942. 	AUDIO_INTERFACE+1,			// bInterfaceNumber

  943. 	1,					// bAlternateSetting

  944. 	1,					// bNumEndpoints

  945. 	1,					// bInterfaceClass, 1 = AUDIO

  946. 	2,					// bInterfaceSubclass, 2 = AUDIO_STREAMING

  947. 	0,					// bInterfaceProtocol

  948. 	0,					// iInterface

  949. 	// Class-Specific AS Interface Descriptor

  950. 	// USB DCD for Audio Devices 1.0, Section 4.5.2, Table 4-19, page 60

  951. 	7, 					// bLength

  952. 	0x24,					// bDescriptorType = CS_INTERFACE

  953. 	1,					// bDescriptorSubtype, 1 = AS_GENERAL

  954. 	2,					// bTerminalLink: Terminal ID = 2

  955. 	3,					// bDelay (approx 3ms delay, audio lib updates)

  956. 	0x01, 0x00,				// wFormatTag, 0x0001 = PCM

  957. 	// Type I Format Descriptor

  958. 	// USB DCD for Audio Data Formats 1.0, Section 2.2.5, Table 2-1, page 10

  959. 	11,					// bLength

  960. 	0x24,					// bDescriptorType = CS_INTERFACE

  961. 	2,					// bDescriptorSubtype = FORMAT_TYPE

  962. 	1,					// bFormatType = FORMAT_TYPE_I

  963. 	2,					// bNrChannels = 2

  964. 	2,					// bSubFrameSize = 2 byte

  965. 	16,					// bBitResolution = 16 bits

  966. 	1,					// bSamFreqType = 1 frequency

  967. 	LSB(44100), MSB(44100), 0,		// tSamFreq

  968. 	// Standard AS Isochronous Audio Data Endpoint Descriptor

  969. 	// USB DCD for Audio Devices 1.0, Section 4.6.1.1, Table 4-20, page 61-62

  970. 	9, 					// bLength

  971. 	5, 					// bDescriptorType, 5 = ENDPOINT_DESCRIPTOR

  972. 	AUDIO_TX_ENDPOINT | 0x80,		// bEndpointAddress

  973. 	0x05, 					// bmAttributes = isochronous, asynchronous

  974. 	LSB(AUDIO_TX_SIZE), MSB(AUDIO_TX_SIZE),	// wMaxPacketSize

  975. 	1,			 		// bInterval, 1 = every frame

  976. 	0,					// bRefresh

  977. 	0,					// bSynchAddress

  978. 	// Class-Specific AS Isochronous Audio Data Endpoint Descriptor

  979. 	// USB DCD for Audio Devices 1.0, Section 4.6.1.2, Table 4-21, page 62-63

  980. 	7,  					// bLength

  981. 	0x25,  					// bDescriptorType, 0x25 = CS_ENDPOINT

  982. 	1,  					// bDescriptorSubtype, 1 = EP_GENERAL

  983. 	0x01,  					// bmAttributes = Sampling Frequency

  984. 	1,  					// bLockDelayUnits, 1 = ms

  985. 	0x30, 0x00,  				// wLockDelay

  986. 	// Standard AS Interface Descriptor

  987. 	// USB DCD for Audio Devices 1.0, Section 4.5.1, Table 4-18, page 59

  988. 	// Alternate 0: default setting, disabled zero bandwidth

  989. 	9,					// bLenght

  990. 	4,					// bDescriptorType = INTERFACE

  991. 	AUDIO_INTERFACE+2,			// bInterfaceNumber

  992. 	0,					// bAlternateSetting

  993. 	0,					// bNumEndpoints

  994. 	1,					// bInterfaceClass, 1 = AUDIO

  995. 	2,					// bInterfaceSubclass, 2 = AUDIO_STREAMING

  996. 	0,					// bInterfaceProtocol

  997. 	0,					// iInterface

  998. 	// Alternate 1: streaming data

  999. 	9,					// bLenght

  1000. 	4,					// bDescriptorType = INTERFACE

  1001. 	AUDIO_INTERFACE+2,			// bInterfaceNumber

  1002. 	1,					// bAlternateSetting

  1003. 	2,					// bNumEndpoints

  1004. 	1,					// bInterfaceClass, 1 = AUDIO

  1005. 	2,					// bInterfaceSubclass, 2 = AUDIO_STREAMING

  1006. 	0,					// bInterfaceProtocol

  1007. 	0,					// iInterface

  1008. 	// Class-Specific AS Interface Descriptor

  1009. 	// USB DCD for Audio Devices 1.0, Section 4.5.2, Table 4-19, page 60

  1010. 	7, 					// bLength

  1011. 	0x24,					// bDescriptorType = CS_INTERFACE

  1012. 	1,					// bDescriptorSubtype, 1 = AS_GENERAL

  1013. 	3,					// bTerminalLink: Terminal ID = 3

  1014. 	3,					// bDelay (approx 3ms delay, audio lib updates)

  1015. 	0x01, 0x00,				// wFormatTag, 0x0001 = PCM

  1016. 	// Type I Format Descriptor

  1017. 	// USB DCD for Audio Data Formats 1.0, Section 2.2.5, Table 2-1, page 10

  1018. 	11,					// bLength

  1019. 	0x24,					// bDescriptorType = CS_INTERFACE

  1020. 	2,					// bDescriptorSubtype = FORMAT_TYPE

  1021. 	1,					// bFormatType = FORMAT_TYPE_I

  1022. 	2,					// bNrChannels = 2

  1023. 	2,					// bSubFrameSize = 2 byte

  1024. 	16,					// bBitResolution = 16 bits

  1025. 	1,					// bSamFreqType = 1 frequency

  1026. 	LSB(44100), MSB(44100), 0,		// tSamFreq

  1027. 	// Standard AS Isochronous Audio Data Endpoint Descriptor

  1028. 	// USB DCD for Audio Devices 1.0, Section 4.6.1.1, Table 4-20, page 61-62

  1029. 	9, 					// bLength

  1030. 	5, 					// bDescriptorType, 5 = ENDPOINT_DESCRIPTOR

  1031. 	AUDIO_RX_ENDPOINT,			// bEndpointAddress

  1032. 	0x05, 					// bmAttributes = isochronous, asynchronous

  1033. 	LSB(AUDIO_RX_SIZE), MSB(AUDIO_RX_SIZE),	// wMaxPacketSize

  1034. 	1,			 		// bInterval, 1 = every frame

  1035. 	0,					// bRefresh

  1036. 	AUDIO_SYNC_ENDPOINT | 0x80,		// bSynchAddress

  1037. 	// Class-Specific AS Isochronous Audio Data Endpoint Descriptor

  1038. 	// USB DCD for Audio Devices 1.0, Section 4.6.1.2, Table 4-21, page 62-63

  1039. 	7,  					// bLength

  1040. 	0x25,  					// bDescriptorType, 0x25 = CS_ENDPOINT

  1041. 	1,  					// bDescriptorSubtype, 1 = EP_GENERAL

  1042. 	0x01,  					// bmAttributes = Sampling Frequency

  1043. 	1,  					// bLockDelayUnits, 1 = ms

  1044. 	0x30, 0x00,  				// wLockDelay

  1045. 	// Standard AS Isochronous Audio Synch Endpoint Descriptor

  1046. 	// USB DCD for Audio Devices 1.0, Section 4.6.2.1, Table 4-22, page 63-64

  1047. 	9, 					// bLength

  1048. 	5, 					// bDescriptorType, 5 = ENDPOINT_DESCRIPTOR

  1049. 	AUDIO_SYNC_ENDPOINT | 0x80,		// bEndpointAddress

  1050. 	0x01, 					// bmAttributes = isochronous

  1051. 	3, 0,					// wMaxPacketSize, 3 bytes

  1052. 	1,			 		// bInterval, 1 = every frame

  1053. 	1,					// bRefresh, 1=2ms, 2=8ms

  1054. 	0,					// bSynchAddress

  1055. #endif

  1056. };

  1057. 

  1058. 

  1059. // **************************************************************

  1060. //   String Descriptors

  1061. // **************************************************************

  1062. 

  1063. // The descriptors above can provide human readable strings,

  1064. // referenced by index numbers.  These descriptors are the

  1065. // actual string data

  1066. 

  1067. /* defined in usb_names.h

  1068. struct usb_string_descriptor_struct {

  1069.         uint8_t bLength;

  1070.         uint8_t bDescriptorType;

  1071.         uint16_t wString[];

  1072. };

  1073. */

  1074. 

  1075. extern struct usb_string_descriptor_struct usb_string_manufacturer_name

  1076.         __attribute__ ((weak, alias("usb_string_manufacturer_name_default")));

  1077. extern struct usb_string_descriptor_struct usb_string_product_name

  1078.         __attribute__ ((weak, alias("usb_string_product_name_default")));

  1079. extern struct usb_string_descriptor_struct usb_string_serial_number

  1080.         __attribute__ ((weak, alias("usb_string_serial_number_default")));

  1081. 

  1082. struct usb_string_descriptor_struct string0 = {

  1083.         4,

  1084.         3,

  1085.         {0x0409}

  1086. };

  1087. 

  1088. struct usb_string_descriptor_struct usb_string_manufacturer_name_default = {

  1089.         2 + MANUFACTURER_NAME_LEN * 2,

  1090.         3,

  1091.         MANUFACTURER_NAME

  1092. };

  1093. struct usb_string_descriptor_struct usb_string_product_name_default = {

  1094. 	2 + PRODUCT_NAME_LEN * 2,

  1095.         3,

  1096.         PRODUCT_NAME

  1097. };

  1098. struct usb_string_descriptor_struct usb_string_serial_number_default = {

  1099.         12,

  1100.         3,

  1101.         {0,0,0,0,0,0,0,0,0,0}

  1102. };

  1103. 

  1104. void usb_init_serialnumber(void)

  1105. {

  1106. 	char buf[11];

  1107. 	uint32_t i, num;

  1108. 

  1109. 	__disable_irq();

  1110. 	FTFL_FSTAT = FTFL_FSTAT_RDCOLERR | FTFL_FSTAT_ACCERR | FTFL_FSTAT_FPVIOL;

  1111. 	FTFL_FCCOB0 = 0x41;

  1112. 	FTFL_FCCOB1 = 15;

  1113. 	FTFL_FSTAT = FTFL_FSTAT_CCIF;

  1114. 	while (!(FTFL_FSTAT & FTFL_FSTAT_CCIF)) ; // wait

  1115. 	num = *(uint32_t *)&FTFL_FCCOB7;

  1116. 	__enable_irq();

  1117. 	// add extra zero to work around OS-X CDC-ACM driver bug

  1118. 	if (num < 10000000) num = num * 10;

  1119. 	ultoa(num, buf, 10);

  1120. 	for (i=0; i<10; i++) {

  1121. 		char c = buf[i];

  1122. 		if (!c) break;

  1123. 		usb_string_serial_number_default.wString[i] = c;

  1124. 	}

  1125. 	usb_string_serial_number_default.bLength = i * 2 + 2;

  1126. }

  1127. 

  1128. 

  1129. // **************************************************************

  1130. //   Descriptors List

  1131. // **************************************************************

  1132. 

  1133. // This table provides access to all the descriptor data above.

  1134. 

  1135. const usb_descriptor_list_t usb_descriptor_list[] = {

  1136. 	//wValue, wIndex, address,          length

  1137. 	{0x0100, 0x0000, device_descriptor, sizeof(device_descriptor)},

  1138. 	{0x0200, 0x0000, config_descriptor, sizeof(config_descriptor)},

  1139. #ifdef SEREMU_INTERFACE

  1140. 	{0x2200, SEREMU_INTERFACE, seremu_report_desc, sizeof(seremu_report_desc)},

  1141. 	{0x2100, SEREMU_INTERFACE, config_descriptor+SEREMU_HID_DESC_OFFSET, 9},

  1142. #endif

  1143. #ifdef KEYBOARD_INTERFACE

  1144.         {0x2200, KEYBOARD_INTERFACE, keyboard_report_desc, sizeof(keyboard_report_desc)},

  1145.         {0x2100, KEYBOARD_INTERFACE, config_descriptor+KEYBOARD_HID_DESC_OFFSET, 9},

  1146. #endif

  1147. #ifdef MOUSE_INTERFACE

  1148.         {0x2200, MOUSE_INTERFACE, mouse_report_desc, sizeof(mouse_report_desc)},

  1149.         {0x2100, MOUSE_INTERFACE, config_descriptor+MOUSE_HID_DESC_OFFSET, 9},

  1150. #endif

  1151. #ifdef JOYSTICK_INTERFACE

  1152.         {0x2200, JOYSTICK_INTERFACE, joystick_report_desc, sizeof(joystick_report_desc)},

  1153.         {0x2100, JOYSTICK_INTERFACE, config_descriptor+JOYSTICK_HID_DESC_OFFSET, 9},

  1154. #endif

  1155. #ifdef RAWHID_INTERFACE

  1156. 	{0x2200, RAWHID_INTERFACE, rawhid_report_desc, sizeof(rawhid_report_desc)},

  1157. 	{0x2100, RAWHID_INTERFACE, config_descriptor+RAWHID_HID_DESC_OFFSET, 9},

  1158. #endif

  1159. #ifdef FLIGHTSIM_INTERFACE

  1160. 	{0x2200, FLIGHTSIM_INTERFACE, flightsim_report_desc, sizeof(flightsim_report_desc)},

  1161. 	{0x2100, FLIGHTSIM_INTERFACE, config_descriptor+FLIGHTSIM_HID_DESC_OFFSET, 9},

  1162. #endif

  1163. #ifdef KEYMEDIA_INTERFACE

  1164.         {0x2200, KEYMEDIA_INTERFACE, keymedia_report_desc, sizeof(keymedia_report_desc)},

  1165.         {0x2100, KEYMEDIA_INTERFACE, config_descriptor+KEYMEDIA_HID_DESC_OFFSET, 9},

  1166. #endif

  1167.         {0x0300, 0x0000, (const uint8_t *)&string0, 0},

  1168.         {0x0301, 0x0409, (const uint8_t *)&usb_string_manufacturer_name, 0},

  1169.         {0x0302, 0x0409, (const uint8_t *)&usb_string_product_name, 0},

  1170.         {0x0303, 0x0409, (const uint8_t *)&usb_string_serial_number, 0},

  1171. 	{0, 0, NULL, 0}

  1172. };

  1173. 

  1174. 

  1175. // **************************************************************

  1176. //   Endpoint Configuration

  1177. // **************************************************************

  1178. 

  1179. #if 0

  1180. // 0x00 = not used

  1181. // 0x19 = Recieve only

  1182. // 0x15 = Transmit only

  1183. // 0x1D = Transmit & Recieve

  1184. //

  1185. const uint8_t usb_endpoint_config_table[NUM_ENDPOINTS] =

  1186. {

  1187. 	0x00, 0x15, 0x19, 0x15, 0x00, 0x00, 0x00, 0x00,

  1188. 	0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,

  1189. };

  1190. #endif

  1191. 

  1192. 

  1193. const uint8_t usb_endpoint_config_table[NUM_ENDPOINTS] =

  1194. {

  1195. #if (defined(ENDPOINT1_CONFIG) && NUM_ENDPOINTS >= 1)

  1196. 	ENDPOINT1_CONFIG,

  1197. #elif (NUM_ENDPOINTS >= 1)

  1198. 	ENDPOINT_UNUSED,

  1199. #endif

  1200. #if (defined(ENDPOINT2_CONFIG) && NUM_ENDPOINTS >= 2)

  1201. 	ENDPOINT2_CONFIG,

  1202. #elif (NUM_ENDPOINTS >= 2)

  1203. 	ENDPOINT_UNUSED,

  1204. #endif

  1205. #if (defined(ENDPOINT3_CONFIG) && NUM_ENDPOINTS >= 3)

  1206. 	ENDPOINT3_CONFIG,

  1207. #elif (NUM_ENDPOINTS >= 3)

  1208. 	ENDPOINT_UNUSED,

  1209. #endif

  1210. #if (defined(ENDPOINT4_CONFIG) && NUM_ENDPOINTS >= 4)

  1211. 	ENDPOINT4_CONFIG,

  1212. #elif (NUM_ENDPOINTS >= 4)

  1213. 	ENDPOINT_UNUSED,

  1214. #endif

  1215. #if (defined(ENDPOINT5_CONFIG) && NUM_ENDPOINTS >= 5)

  1216. 	ENDPOINT5_CONFIG,

  1217. #elif (NUM_ENDPOINTS >= 5)

  1218. 	ENDPOINT_UNUSED,

  1219. #endif

  1220. #if (defined(ENDPOINT6_CONFIG) && NUM_ENDPOINTS >= 6)

  1221. 	ENDPOINT6_CONFIG,

  1222. #elif (NUM_ENDPOINTS >= 6)

  1223. 	ENDPOINT_UNUSED,

  1224. #endif

  1225. #if (defined(ENDPOINT7_CONFIG) && NUM_ENDPOINTS >= 7)

  1226. 	ENDPOINT7_CONFIG,

  1227. #elif (NUM_ENDPOINTS >= 7)

  1228. 	ENDPOINT_UNUSED,

  1229. #endif

  1230. #if (defined(ENDPOINT8_CONFIG) && NUM_ENDPOINTS >= 8)

  1231. 	ENDPOINT8_CONFIG,

  1232. #elif (NUM_ENDPOINTS >= 8)

  1233. 	ENDPOINT_UNUSED,

  1234. #endif

  1235. #if (defined(ENDPOINT9_CONFIG) && NUM_ENDPOINTS >= 9)

  1236. 	ENDPOINT9_CONFIG,

  1237. #elif (NUM_ENDPOINTS >= 9)

  1238. 	ENDPOINT_UNUSED,

  1239. #endif

  1240. #if (defined(ENDPOINT10_CONFIG) && NUM_ENDPOINTS >= 10)

  1241. 	ENDPOINT10_CONFIG,

  1242. #elif (NUM_ENDPOINTS >= 10)

  1243. 	ENDPOINT_UNUSED,

  1244. #endif

  1245. #if (defined(ENDPOINT11_CONFIG) && NUM_ENDPOINTS >= 11)

  1246. 	ENDPOINT11_CONFIG,

  1247. #elif (NUM_ENDPOINTS >= 11)

  1248. 	ENDPOINT_UNUSED,

  1249. #endif

  1250. #if (defined(ENDPOINT12_CONFIG) && NUM_ENDPOINTS >= 12)

  1251. 	ENDPOINT12_CONFIG,

  1252. #elif (NUM_ENDPOINTS >= 12)

  1253. 	ENDPOINT_UNUSED,

  1254. #endif

  1255. #if (defined(ENDPOINT13_CONFIG) && NUM_ENDPOINTS >= 13)

  1256. 	ENDPOINT13_CONFIG,

  1257. #elif (NUM_ENDPOINTS >= 13)

  1258. 	ENDPOINT_UNUSED,

  1259. #endif

  1260. #if (defined(ENDPOINT14_CONFIG) && NUM_ENDPOINTS >= 14)

  1261. 	ENDPOINT14_CONFIG,

  1262. #elif (NUM_ENDPOINTS >= 14)

  1263. 	ENDPOINT_UNUSED,

  1264. #endif

  1265. #if (defined(ENDPOINT15_CONFIG) && NUM_ENDPOINTS >= 15)

  1266. 	ENDPOINT15_CONFIG,

  1267. #elif (NUM_ENDPOINTS >= 15)

  1268. 	ENDPOINT_UNUSED,

  1269. #endif

  1270. };

  1271. 

  1272. 

  1273. #endif // NUM_ENDPOINTS

  1274. #endif // F_CPU >= 20 MHz