Microchip® Advanced Software Framework

composite/device/example4/conf_usb.h File Reference

USB configuration file.

Copyright (c) 2011-2018 Microchip Technology Inc. and its subsidiaries.

#include "compiler.h"
#include "udi_cdc.h"
#include "udi_msc.h"
#include "uart.h"
#include "main.h"
#include "ui.h"

Macros

#define USB_DEVICE_VENDOR_ID   USB_VID_ATMEL
 USB Device Configuration. More...
 
#define USB_DEVICE_PRODUCT_ID   USB_PID_ATMEL_ASF_MSC_CDC
 
#define USB_DEVICE_MAJOR_VERSION   1
 
#define USB_DEVICE_MINOR_VERSION   0
 
#define USB_DEVICE_POWER   100
 
#define USB_DEVICE_ATTR   (USB_CONFIG_ATTR_SELF_POWERED)
 
#define USB_DEVICE_MANUFACTURE_NAME   "ATMEL ASF"
 USB Device string definitions (Optional) More...
 
#define USB_DEVICE_PRODUCT_NAME   "CDC and MSC"
 
#define USB_DEVICE_SERIAL_NAME   "123123123123"
 
#define UDC_VBUS_EVENT(b_vbus_high)
 Device speeds support Low speed not supported by CDC and MSC. More...
 
#define UDC_SOF_EVENT()   main_sof_action()
 
#define UDC_SUSPEND_EVENT()   main_suspend_action()
 
#define UDC_RESUME_EVENT()   main_resume_action()
 
#define UDC_GET_EXTRA_STRING()   main_extra_string()
 Mandatory when USB_DEVICE_ATTR authorizes remote wakeup feature. More...
 
#define USB_DEVICE_EP_CTRL_SIZE   64
 USB Device low level configuration When only one interface is used, these configurations are defined by the class module. More...
 
#define USB_DEVICE_NB_INTERFACE   3
 Two interfaces for this device (CDC COM + CDC DATA + MSC) More...
 
#define USB_DEVICE_MAX_EP   5
 5 endpoints used by CDC and MSC interfaces More...
 
#define UDI_CDC_PORT_NB   1
 USB Interface Configuration. More...
 
#define UDI_CDC_ENABLE_EXT(port)   main_cdc_enable(port)
 Interface callback definition. More...
 
#define UDI_CDC_DISABLE_EXT(port)   main_cdc_disable(port)
 
#define UDI_CDC_RX_NOTIFY(port)   uart_rx_notify(port)
 
#define UDI_CDC_TX_EMPTY_NOTIFY(port)
 
#define UDI_CDC_SET_CODING_EXT(port, cfg)   uart_config(port,cfg)
 
#define UDI_CDC_SET_DTR_EXT(port, set)   main_cdc_set_dtr(port,set)
 
#define UDI_CDC_SET_RTS_EXT(port, set)
 
#define UDI_CDC_DEFAULT_RATE   115200
 Define it when the transfer CDC Device to Host is a low rate (<512000 bauds) to reduce CDC buffers size. More...
 
#define UDI_CDC_DEFAULT_STOPBITS   CDC_STOP_BITS_1
 
#define UDI_CDC_DEFAULT_PARITY   CDC_PAR_NONE
 
#define UDI_CDC_DEFAULT_DATABITS   8
 
#define UDI_CDC_IAD_STRING_ID   4
 Enable id string of interface to add an extra USB string. More...
 
#define UDI_CDC_COMM_EP_0   (3 | USB_EP_DIR_IN)
 USB CDC low level configuration In standalone these configurations are defined by the CDC module. More...
 
#define UDI_CDC_DATA_EP_IN_0   (4 | USB_EP_DIR_IN)
 
#define UDI_CDC_DATA_EP_OUT_0   (5 | USB_EP_DIR_OUT)
 
#define UDI_CDC_COMM_IFACE_NUMBER_0   0
 Interface numbers. More...
 
#define UDI_CDC_DATA_IFACE_NUMBER_0   1
 
#define UDI_MSC_GLOBAL_VENDOR_ID   'A', 'T', 'M', 'E', 'L', ' ', ' ', ' '
 Configuration of MSC interface. More...
 
#define UDI_MSC_GLOBAL_PRODUCT_VERSION   '1', '.', '0', '0'
 
#define UDI_MSC_ENABLE_EXT()   main_msc_enable()
 Interface callback definition. More...
 
#define UDI_MSC_DISABLE_EXT()   main_msc_disable()
 
#define UDI_MSC_STRING_ID   5
 Enable id string of interface to add an extra USB string. More...
 
#define UDI_MSC_EP_IN   (1 | USB_EP_DIR_IN)
 USB MSC low level configuration In standalone these configurations are defined by the MSC module. More...
 
#define UDI_MSC_EP_OUT   (2 | USB_EP_DIR_OUT)
 
#define UDI_MSC_IFACE_NUMBER   2
 Interface number. More...
 
#define UDI_COMPOSITE_DESC_T
 Description of Composite Device. More...
 
#define UDI_COMPOSITE_DESC_FS
 USB Interfaces descriptor value for Full Speed. More...
 
#define UDI_COMPOSITE_DESC_HS
 USB Interfaces descriptor value for High Speed. More...
 
#define UDI_COMPOSITE_API
 USB Interface APIs. More...
 

#define UDC_GET_EXTRA_STRING ( )    main_extra_string()

Mandatory when USB_DEVICE_ATTR authorizes remote wakeup feature.

When a extra string descriptor must be supported other than manufacturer, product and serial string

#define UDC_RESUME_EVENT ( )    main_resume_action()
#define UDC_SOF_EVENT ( )    main_sof_action()
#define UDC_SUSPEND_EVENT ( )    main_suspend_action()
#define UDC_VBUS_EVENT (   b_vbus_high)

Device speeds support Low speed not supported by CDC and MSC.

To define a Low speed device To authorize the High speed USB Device Callbacks definitions (Optional)

#define UDI_CDC_COMM_EP_0   (3 | USB_EP_DIR_IN)

USB CDC low level configuration In standalone these configurations are defined by the CDC module.

For composite device, these configuration must be defined hereEndpoint numbers definition

#define UDI_CDC_COMM_IFACE_NUMBER_0   0

Interface numbers.

#define UDI_CDC_DATA_EP_IN_0   (4 | USB_EP_DIR_IN)
#define UDI_CDC_DATA_EP_OUT_0   (5 | USB_EP_DIR_OUT)
#define UDI_CDC_DATA_IFACE_NUMBER_0   1
#define UDI_CDC_DEFAULT_DATABITS   8
#define UDI_CDC_DEFAULT_PARITY   CDC_PAR_NONE
#define UDI_CDC_DEFAULT_RATE   115200

Define it when the transfer CDC Device to Host is a low rate (<512000 bauds) to reduce CDC buffers size.

Default configuration of communication port

#define UDI_CDC_DEFAULT_STOPBITS   CDC_STOP_BITS_1
#define UDI_CDC_DISABLE_EXT (   port)    main_cdc_disable(port)
#define UDI_CDC_ENABLE_EXT (   port)    main_cdc_enable(port)

Interface callback definition.

#define UDI_CDC_IAD_STRING_ID   4

Enable id string of interface to add an extra USB string.

#define UDI_CDC_PORT_NB   1

USB Interface Configuration.

Configuration of CDC interfaceDefine two USB communication ports

#define UDI_CDC_RX_NOTIFY (   port)    uart_rx_notify(port)
#define UDI_CDC_SET_CODING_EXT (   port,
  cfg 
)    uart_config(port,cfg)
#define UDI_CDC_SET_DTR_EXT (   port,
  set 
)    main_cdc_set_dtr(port,set)
#define UDI_CDC_SET_RTS_EXT (   port,
  set 
)
#define UDI_CDC_TX_EMPTY_NOTIFY (   port)
#define UDI_COMPOSITE_API
Value:
UDC_DESC_STORAGE udi_api_t udi_api_cdc_comm
Global structure which contains standard UDI API for UDC.
Definition: udi_cdc.c:83
UDC_DESC_STORAGE udi_api_t udi_api_msc
Global structure which contains standard UDI API for UDC.
Definition: udi_msc.c:66
UDC_DESC_STORAGE udi_api_t udi_api_cdc_data
Definition: udi_cdc.c:89

USB Interface APIs.

#define UDI_COMPOSITE_DESC_FS
Value:
.udi_cdc_iad = UDI_CDC_IAD_DESC_0, \
.udi_cdc_comm = UDI_CDC_COMM_DESC_0, \
.udi_cdc_data = UDI_CDC_DATA_DESC_0_FS, \
.udi_msc = UDI_MSC_DESC_FS
#define UDI_MSC_DESC_FS
Content of MSC interface descriptor for full speed only.
Definition: udi_msc.h:108
#define UDI_CDC_COMM_DESC_0
Definition: udi_cdc.h:138
#define UDI_CDC_DATA_DESC_0_FS
Definition: udi_cdc.h:139
#define UDI_CDC_IAD_DESC_0
Definition: udi_cdc.h:137

USB Interfaces descriptor value for Full Speed.

#define UDI_COMPOSITE_DESC_HS
Value:
.udi_cdc_iad = UDI_CDC_IAD_DESC_0, \
.udi_cdc_comm = UDI_CDC_COMM_DESC_0, \
.udi_cdc_data = UDI_CDC_DATA_DESC_0_HS, \
.udi_msc = UDI_MSC_DESC_HS
#define UDI_CDC_COMM_DESC_0
Definition: udi_cdc.h:138
#define UDI_CDC_IAD_DESC_0
Definition: udi_cdc.h:137
#define UDI_CDC_DATA_DESC_0_HS
Definition: udi_cdc.h:140
#define UDI_MSC_DESC_HS
Content of MSC interface descriptor for high speed only.
Definition: udi_msc.h:115

USB Interfaces descriptor value for High Speed.

#define UDI_COMPOSITE_DESC_T
Value:
usb_iad_desc_t udi_cdc_iad; \
udi_cdc_comm_desc_t udi_cdc_comm; \
udi_cdc_data_desc_t udi_cdc_data; \
udi_msc_desc_t udi_msc
Standard USB association descriptor structure.
Definition: usb_protocol.h:432

Description of Composite Device.

USB Interfaces descriptor structure

#define UDI_MSC_DISABLE_EXT ( )    main_msc_disable()
#define UDI_MSC_ENABLE_EXT ( )    main_msc_enable()

Interface callback definition.

#define UDI_MSC_EP_IN   (1 | USB_EP_DIR_IN)

USB MSC low level configuration In standalone these configurations are defined by the MSC module.

For composite device, these configuration must be defined hereEndpoint numbers definition

#define UDI_MSC_EP_OUT   (2 | USB_EP_DIR_OUT)
#define UDI_MSC_GLOBAL_PRODUCT_VERSION   '1', '.', '0', '0'
#define UDI_MSC_GLOBAL_VENDOR_ID   'A', 'T', 'M', 'E', 'L', ' ', ' ', ' '

Configuration of MSC interface.

Vendor name and Product version of MSC interface

#define UDI_MSC_IFACE_NUMBER   2

Interface number.

#define UDI_MSC_STRING_ID   5

Enable id string of interface to add an extra USB string.

#define USB_DEVICE_ATTR   (USB_CONFIG_ATTR_SELF_POWERED)
#define USB_DEVICE_EP_CTRL_SIZE   64

USB Device low level configuration When only one interface is used, these configurations are defined by the class module.

For composite device, these configuration must be defined hereControl endpoint size

#define USB_DEVICE_MAJOR_VERSION   1
#define USB_DEVICE_MANUFACTURE_NAME   "ATMEL ASF"

USB Device string definitions (Optional)

#define USB_DEVICE_MAX_EP   5

5 endpoints used by CDC and MSC interfaces

#define USB_DEVICE_MINOR_VERSION   0
#define USB_DEVICE_NB_INTERFACE   3

Two interfaces for this device (CDC COM + CDC DATA + MSC)

#define USB_DEVICE_POWER   100
#define USB_DEVICE_PRODUCT_ID   USB_PID_ATMEL_ASF_MSC_CDC
#define USB_DEVICE_PRODUCT_NAME   "CDC and MSC"
#define USB_DEVICE_SERIAL_NAME   "123123123123"
#define USB_DEVICE_VENDOR_ID   USB_VID_ATMEL

USB Device Configuration.

Device definition (mandatory)