221 lines
9.8 KiB
C
221 lines
9.8 KiB
C
/* Teensyduino Core Library
|
|
* http://www.pjrc.com/teensy/
|
|
* Copyright (c) 2013 PJRC.COM, LLC.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* 1. The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* 2. If the Software is incorporated into a build system that allows
|
|
* selection among a list of target devices, then similar target
|
|
* devices manufactured by PJRC.COM must be included in the list of
|
|
* target devices and selectable in the same manner.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*/
|
|
|
|
#include <usb-desc.h>
|
|
#include <usb-cdc.h>
|
|
|
|
// USB Descriptors are binary data which the USB host reads to
|
|
// automatically detect a USB device's capabilities. The format
|
|
// and meaning of every field is documented in numerous USB
|
|
// standards. When working with USB descriptors, despite the
|
|
// complexity of the standards and poor writing quality in many
|
|
// of those documents, remember descriptors are nothing more
|
|
// than constant binary data that tells the USB host what the
|
|
// device can do. Computers will load drivers based on this data.
|
|
// Those drivers then communicate on the endpoints specified by
|
|
// the descriptors.
|
|
|
|
// To configure a new combination of interfaces or make minor
|
|
// changes to existing configuration (eg, change the name or ID
|
|
// numbers), usually you would edit "usb_desc.h". This file
|
|
// is meant to be configured by the header, so generally it is
|
|
// only edited to add completely new USB interfaces or features.
|
|
|
|
// **************************************************************
|
|
// USB Device
|
|
// **************************************************************
|
|
|
|
#define LSB(n) ((n) & 255)
|
|
#define MSB(n) (((n) >> 8) & 255)
|
|
|
|
// USB Device Descriptor. The USB host reads this first, to learn
|
|
// what type of device is connected.
|
|
static const uint8_t device_descriptor[] = {
|
|
18, // bLength
|
|
1, // bDescriptorType
|
|
0x01, 0x02, // bcdUSB
|
|
USB_CLASS_CDC, // bDeviceClass
|
|
0x00, // bDeviceSubClass
|
|
0x00, // bDeviceProtocol
|
|
EP0_SIZE, // bMaxPacketSize0
|
|
LSB(VENDOR_ID), MSB(VENDOR_ID), // idVendor
|
|
LSB(PRODUCT_ID), MSB(PRODUCT_ID), // idProduct
|
|
LSB(DEVICE_VER), MSB(DEVICE_VER), // bcdDevice
|
|
1, // iManufacturer
|
|
2, // iProduct
|
|
0, // iSerialNumber
|
|
1 // bNumConfigurations
|
|
};
|
|
|
|
// These descriptors must NOT be "const", because the USB DMA
|
|
// has trouble accessing flash memory with enough bandwidth
|
|
// while the processor is executing from flash.
|
|
|
|
|
|
// **************************************************************
|
|
// USB Configuration
|
|
// **************************************************************
|
|
|
|
// USB Configuration Descriptor. This huge descriptor tells all
|
|
// of the devices capbilities.
|
|
static const uint8_t config_descriptor[CONFIG_DESC_SIZE] = {
|
|
// configuration descriptor, USB spec 9.6.3, page 264-266, Table 9-10
|
|
9, // bLength;
|
|
2, // bDescriptorType;
|
|
LSB(CONFIG_DESC_SIZE), // wTotalLength
|
|
MSB(CONFIG_DESC_SIZE),
|
|
NUM_INTERFACE, // bNumInterfaces
|
|
1, // bConfigurationValue
|
|
1, // iConfiguration
|
|
0x80, // bmAttributes
|
|
50, // bMaxPower
|
|
|
|
|
|
// interface descriptor, CDC
|
|
USB_DT_INTERFACE_SIZE, // bLength
|
|
USB_DT_INTERFACE, // bDescriptorType
|
|
0, // bInterfaceNumber
|
|
0, // bAlternateSetting
|
|
1, // bNumEndpoints
|
|
USB_CLASS_CDC, // bInterfaceClass
|
|
USB_CDC_SUBCLASS_ACM, // bInterfaceSubClass
|
|
USB_CDC_PROTOCOL_AT, // bInterfaceProtocol
|
|
0, // iInterface
|
|
|
|
// Header Functional Descriptor
|
|
0x05, // bLength: Endpoint Descriptor size
|
|
CS_INTERFACE, // bDescriptorType: CS_INTERFACE
|
|
USB_CDC_TYPE_HEADER, // bDescriptorSubtype: Header Func Desc
|
|
0x10, // bcdCDC: spec release number
|
|
0x01,
|
|
|
|
// Call Managment Functional Descriptor
|
|
0x05, // bFunctionLength
|
|
CS_INTERFACE, // bDescriptorType: CS_INTERFACE
|
|
USB_CDC_TYPE_CALL_MANAGEMENT, // bDescriptorSubtype: Call Management Func Desc
|
|
0, // bmCapabilities: D0+D1
|
|
1, // bDataInterface: 1
|
|
|
|
// ACM Functional Descriptor
|
|
0x04, // bFunctionLength
|
|
CS_INTERFACE, // bDescriptorType: CS_INTERFACE
|
|
USB_CDC_TYPE_ACM, // bDescriptorSubtype: Abstract Control Management desc
|
|
6, // bmCapabilities
|
|
|
|
// Union Functional Descriptor
|
|
0x05, // bFunctionLength
|
|
CS_INTERFACE, // bDescriptorType: CS_INTERFACE
|
|
USB_CDC_TYPE_UNION, // bDescriptorSubtype: Union func desc
|
|
0, // bMasterInterface: Communication class interface
|
|
1, // bSlaveInterface0: Data Class Interface
|
|
|
|
// Endpoint descriptor
|
|
USB_DT_ENDPOINT_SIZE, // bLength
|
|
USB_DT_ENDPOINT, // bDescriptorType
|
|
0x81, // bEndpointAddress
|
|
USB_ENDPOINT_ATTR_INTERRUPT, // bmAttributes
|
|
LSB(16), // wMaxPacketSize
|
|
MSB(16), // wMaxPacketSize
|
|
255, // bInterval
|
|
|
|
// interface descriptor, CDC
|
|
USB_DT_INTERFACE_SIZE, // bLength
|
|
USB_DT_INTERFACE, // bDescriptorType
|
|
1, // bInterfaceNumber
|
|
0, // bAlternateSetting
|
|
2, // bNumEndpoints
|
|
USB_CLASS_DATA, // bInterfaceClass
|
|
0, // bInterfaceSubClass
|
|
0, // bInterfaceProtocol
|
|
0, // iInterface
|
|
|
|
// Endpoint descriptor
|
|
USB_DT_ENDPOINT_SIZE, // bLength
|
|
USB_DT_ENDPOINT, // bDescriptorType
|
|
0x82, // bEndpointAddress
|
|
USB_ENDPOINT_ATTR_BULK, // bmAttributes
|
|
LSB(64), // wMaxPacketSize
|
|
MSB(64), // wMaxPacketSize
|
|
1, // bInterval
|
|
|
|
// Endpoint descriptor
|
|
USB_DT_ENDPOINT_SIZE, // bLength
|
|
USB_DT_ENDPOINT, // bDescriptorType
|
|
0x02, // bEndpointAddress
|
|
USB_ENDPOINT_ATTR_BULK, // bmAttributes
|
|
LSB(64), // wMaxPacketSize
|
|
MSB(64), // wMaxPacketSize
|
|
1, // bInterval
|
|
};
|
|
|
|
|
|
// **************************************************************
|
|
// String Descriptors
|
|
// **************************************************************
|
|
|
|
// The descriptors above can provide human readable strings,
|
|
// referenced by index numbers. These descriptors are the
|
|
// actual string data
|
|
|
|
static const struct usb_string_descriptor_struct string0 = {
|
|
4,
|
|
3,
|
|
{0x0409}
|
|
};
|
|
|
|
__attribute__((aligned(4)))
|
|
static const struct usb_string_descriptor_struct usb_string_manufacturer_name = {
|
|
2 + MANUFACTURER_NAME_LEN,
|
|
3,
|
|
MANUFACTURER_NAME
|
|
};
|
|
|
|
__attribute__((aligned(4)))
|
|
static const struct usb_string_descriptor_struct usb_string_product_name = {
|
|
2 + PRODUCT_NAME_LEN,
|
|
3,
|
|
PRODUCT_NAME
|
|
};
|
|
|
|
// **************************************************************
|
|
// Descriptors List
|
|
// **************************************************************
|
|
|
|
// This table provides access to all the descriptor data above.
|
|
|
|
const usb_descriptor_list_t usb_descriptor_list[] = {
|
|
{0x0100, sizeof(device_descriptor), device_descriptor},
|
|
{0x0200, sizeof(config_descriptor), config_descriptor},
|
|
{0x0300, 0, (const uint8_t *)&string0},
|
|
{0x0301, 0, (const uint8_t *)&usb_string_manufacturer_name},
|
|
{0x0302, 0, (const uint8_t *)&usb_string_product_name},
|
|
{0, 0, NULL}
|
|
};
|