Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
USB device descriptors for a single interface

The following structures provide the USB device descriptors required for USB Device with a single interface CDC.

It is ready to use and do not require more definition.

Data Structures

struct  udc_desc_t
 Structure for USB Device Configuration Descriptor. More...
 

Macros

#define USB_DEVICE_EP_CTRL_SIZE   64
 Control endpoint size (Endpoint 0) More...
 
#define USB_DEVICE_NB_INTERFACE   (2*UDI_CDC_PORT_NB)
 Two interfaces for a CDC device. More...
 
#define USB_VERSION   USB_V2_1
 

Variables

COMPILER_WORD_ALIGNED
UDC_DESC_STORAGE udc_desc_t 
udc_desc_fs
 USB Device Configuration Descriptor filled for full and high speed. More...
 
COMPILER_WORD_ALIGNED
UDC_DESC_STORAGE
usb_dev_desc_t 
udc_device_desc
 USB Device Descriptor. More...
 
COMPILER_WORD_ALIGNED
UDC_DESC_STORAGE
usb_dev_lpm_desc_t 
udc_device_lpm
 USB Device Qualifier Descriptor. More...
 

UDC structures which content all USB Device definitions

UDC_DESC_STORAGE udi_api_tudi_apis [USB_DEVICE_NB_INTERFACE]
 Associate an UDI for each USB interface. More...
 
UDC_DESC_STORAGE udc_config_speed_t udc_config_fs [1]
 Add UDI with USB Descriptors FS & HS. More...
 
UDC_DESC_STORAGE udc_config_t udc_config
 Add all information about USB Device in global structure for UDC. More...
 

Default endpoint configuration

The USBB, UDP, UDPHS and UOTGHS interfaces can support up to 2 CDC interfaces.

#define UDI_CDC_DATA_EP_IN_0   (1 | USB_EP_DIR_IN)
 
#define UDI_CDC_DATA_EP_OUT_0   (2 | USB_EP_DIR_OUT)
 
#define UDI_CDC_COMM_EP_0   (3 | USB_EP_DIR_IN)
 
#define UDI_CDC_DATA_EP_IN_1   (4 | USB_EP_DIR_IN)
 
#define UDI_CDC_DATA_EP_OUT_1   (5 | USB_EP_DIR_OUT)
 
#define UDI_CDC_COMM_EP_1   (6 | USB_EP_DIR_IN)
 
#define USB_DEVICE_MAX_EP   (3*UDI_CDC_PORT_NB)
 3 endpoints used per CDC interface More...
 

Default Interface numbers

#define UDI_CDC_COMM_IFACE_NUMBER_0   0
 
#define UDI_CDC_DATA_IFACE_NUMBER_0   1
 
#define UDI_CDC_COMM_IFACE_NUMBER_1   2
 
#define UDI_CDC_DATA_IFACE_NUMBER_1   3
 
#define UDI_CDC_COMM_IFACE_NUMBER_2   4
 
#define UDI_CDC_DATA_IFACE_NUMBER_2   5
 
#define UDI_CDC_COMM_IFACE_NUMBER_3   6
 
#define UDI_CDC_DATA_IFACE_NUMBER_3   7
 
#define UDI_CDC_COMM_IFACE_NUMBER_4   8
 
#define UDI_CDC_DATA_IFACE_NUMBER_4   9
 
#define UDI_CDC_COMM_IFACE_NUMBER_5   10
 
#define UDI_CDC_DATA_IFACE_NUMBER_5   11
 
#define UDI_CDC_COMM_IFACE_NUMBER_6   12
 
#define UDI_CDC_DATA_IFACE_NUMBER_6   13
 

#define UDI_CDC_COMM_EP_0   (3 | USB_EP_DIR_IN)
#define UDI_CDC_COMM_EP_1   (6 | USB_EP_DIR_IN)
#define UDI_CDC_COMM_IFACE_NUMBER_0   0
#define UDI_CDC_COMM_IFACE_NUMBER_1   2
#define UDI_CDC_COMM_IFACE_NUMBER_2   4
#define UDI_CDC_COMM_IFACE_NUMBER_3   6
#define UDI_CDC_COMM_IFACE_NUMBER_4   8
#define UDI_CDC_COMM_IFACE_NUMBER_5   10
#define UDI_CDC_COMM_IFACE_NUMBER_6   12
#define UDI_CDC_DATA_EP_IN_0   (1 | USB_EP_DIR_IN)
#define UDI_CDC_DATA_EP_IN_1   (4 | USB_EP_DIR_IN)
#define UDI_CDC_DATA_EP_OUT_0   (2 | USB_EP_DIR_OUT)
#define UDI_CDC_DATA_EP_OUT_1   (5 | USB_EP_DIR_OUT)
#define UDI_CDC_DATA_IFACE_NUMBER_0   1
#define UDI_CDC_DATA_IFACE_NUMBER_1   3
#define UDI_CDC_DATA_IFACE_NUMBER_2   5
#define UDI_CDC_DATA_IFACE_NUMBER_3   7
#define UDI_CDC_DATA_IFACE_NUMBER_4   9
#define UDI_CDC_DATA_IFACE_NUMBER_5   11
#define UDI_CDC_DATA_IFACE_NUMBER_6   13
#define USB_DEVICE_EP_CTRL_SIZE   64

Control endpoint size (Endpoint 0)

#define USB_DEVICE_MAX_EP   (3*UDI_CDC_PORT_NB)

3 endpoints used per CDC interface

#define USB_DEVICE_NB_INTERFACE   (2*UDI_CDC_PORT_NB)

Two interfaces for a CDC device.

#define USB_VERSION   USB_V2_1

Initial value:
= {
.confdev_lsfs = &udc_device_desc,
.conf_lsfs = udc_config_fs,
.conf_bos = &udc_device_lpm.bos,
}
UDC_DESC_STORAGE udc_config_speed_t udc_config_fs[1]
Add UDI with USB Descriptors FS & HS.
Definition: udi_cdc_desc.c:216
COMPILER_WORD_ALIGNED UDC_DESC_STORAGE usb_dev_lpm_desc_t udc_device_lpm
USB Device Qualifier Descriptor.
Definition: udi_cdc_desc.c:122
UDC_DESC_STORAGE usb_dev_desc_t udc_device_desc
USB Device Descriptor.
Definition: udi_msc_desc.c:58
usb_dev_bos_desc_t bos
Definition: usb_protocol.h:388

Add all information about USB Device in global structure for UDC.

Global variables of USB Device Descriptor and UDI links.

Initial value:
= { {
}}
UDC_DESC_STORAGE udi_api_t * udi_apis[USB_DEVICE_NB_INTERFACE]
Associate an UDI for each USB interface.
Definition: udi_msc_desc.c:149
Standard USB configuration descriptor structure.
Definition: usb_protocol.h:410
UDC_DESC_STORAGE udc_desc_t udc_desc_fs
USB Device Configuration Descriptor filled for FS.
Definition: udi_msc_desc.c:114
#define UDC_DESC_STORAGE
Defines the memory's location of USB descriptors.
Definition: udc_desc.h:70

Add UDI with USB Descriptors FS & HS.

Initial value:
= {
.conf.bLength = sizeof(usb_conf_desc_t),
.conf.bDescriptorType = USB_DT_CONFIGURATION,
.conf.wTotalLength = LE16(sizeof(udc_desc_t)),
.conf.bNumInterfaces = USB_DEVICE_NB_INTERFACE,
.conf.bConfigurationValue = 1,
.conf.iConfiguration = 0,
.conf.bmAttributes = USB_CONFIG_ATTR_MUST_SET | USB_DEVICE_ATTR,
.udi_cdc_comm_0 = UDI_CDC_COMM_DESC_0,
.udi_cdc_data_0 = UDI_CDC_DATA_DESC_0_FS,
}
Definition: usb_protocol.h:191
#define USB_CONFIG_ATTR_MUST_SET
Must always be set.
Definition: usb_protocol.h:422
#define USB_DEVICE_NB_INTERFACE
Two interfaces for a CDC device.
Definition: udi_cdc_desc.c:55
Standard USB configuration descriptor structure.
Definition: usb_protocol.h:410
#define UDI_CDC_COMM_DESC_0
Definition: udi_cdc.h:138
#define UDI_CDC_DATA_DESC_0_FS
Definition: udi_cdc.h:139
#define USB_DEVICE_ATTR
Definition: hid/device/mouse/unit_tests/conf_usb.h:53
#define USB_CONFIG_MAX_POWER(ma)
Max power in mA.
Definition: usb_protocol.h:427
#define LE16(x)
Definition: compiler.h:773
#define USB_DEVICE_POWER
Definition: hid/device/mouse/unit_tests/conf_usb.h:52
Structure for USB Device Configuration Descriptor.
Definition: udi_msc_desc.c:106

USB Device Configuration Descriptor filled for full and high speed.

USB Device Configuration Descriptor filled for FS.

USB Device Descriptor.

Pointer on the selected speed device configuration.

Initial value:
= {
.bos.bLength = sizeof(usb_dev_bos_desc_t),
.bos.bDescriptorType = USB_DT_BOS,
.bos.wTotalLength = LE16(sizeof(usb_dev_bos_desc_t) + sizeof(usb_dev_capa_ext_desc_t)),
.bos.bNumDeviceCaps = 1,
.capa_ext.bLength = sizeof(usb_dev_capa_ext_desc_t),
.capa_ext.bDescriptorType = USB_DT_DEVICE_CAPABILITY,
.capa_ext.bDevCapabilityType = USB_DC_USB20_EXTENSION,
.capa_ext.bmAttributes = USB_DC_EXT_LPM,
}
Definition: usb_protocol.h:200
Definition: usb_protocol.h:201
USB Device Capabilities - USB 2.0 Extension Descriptor structure.
Definition: usb_protocol.h:375
Definition: usb_protocol.h:208
#define LE16(x)
Definition: compiler.h:773
USB Device BOS descriptor structure.
Definition: usb_protocol.h:362
Definition: usb_protocol.h:216

USB Device Qualifier Descriptor.

Initial value:
= {
#define UDI_CDC_API(index, unused)
}

Associate an UDI for each USB interface.