/*! \file usb_cdc.h \brief the header file of communication device class standard \version 2023-06-30, V2.1.6, firmware for GD32F30x */ /* Copyright (c) 2023, GigaDevice Semiconductor Inc. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef __USB_CDC_H #define __USB_CDC_H #include "usb_ch9_std.h" /* communications device class code */ #define USB_CLASS_CDC 0x02U /* communications interface class control protocol codes */ #define USB_CDC_PROTOCOL_NONE 0x00U #define USB_CDC_PROTOCOL_AT 0x01U #define USB_CDC_PROTOCOL_VENDOR 0xFFU /* data interface class code */ #define USB_CLASS_DATA 0x0AU #define USB_DESCTYPE_CDC_ACM 0x21U #define USB_DESCTYPE_CS_INTERFACE 0x24U #define USB_CDC_ACM_CONFIG_DESC_SIZE 0x43U /* class-specific notification codes for pstn subclasses */ #define USB_CDC_NOTIFY_SERIAL_STATE 0x20U /* class-specific request codes */ #define SEND_ENCAPSULATED_COMMAND 0x00U #define GET_ENCAPSULATED_RESPONSE 0x01U #define SET_COMM_FEATURE 0x02U #define GET_COMM_FEATURE 0x03U #define CLEAR_COMM_FEATURE 0x04U #define SET_AUX_LINE_STATE 0x10U #define SET_HOOK_STATE 0x11U #define PULSE_SETUP 0x12U #define SEND_PULSE 0x13U #define SET_PULSE_TIME 0x14U #define RING_AUX_JACK 0x15U #define SET_LINE_CODING 0x20U #define GET_LINE_CODING 0x21U #define SET_CONTROL_LINE_STATE 0x22U #define SEND_BREAK 0x23U #define NO_CMD 0xFFU #define SET_RINGER_PARMS 0x30U #define GET_RINGER_PARMS 0x31U #define SET_OPERATION_PARMS 0x32U #define GET_OPERATION_PARMS 0x33U #define SET_LINE_PARMS 0x34U #define GET_LINE_PARMS 0x35U #define DIAL_DIGITS 0x36U #define SET_UNIT_PARAMETER 0x37U #define GET_UNIT_PARAMETER 0x38U #define CLEAR_UNIT_PARAMETER 0x39U #define GET_PROFILE 0x3AU #define SET_ETHERNET_MULTICAST_FILTERS 0x40U #define SET_ETHERNET_POWER_MANAGEMENT_PATTERN FILTER 0x41U #define GET_ETHERNET_POWER_MANAGEMENT_PATTERN FILTER 0x42U #define SET_ETHERNET_PACKET_FILTER 0x43U #define GET_ETHERNET_STATISTIC 0x44U #define SET_ATM_DATA_FORMAT 0x50U #define GET_ATM_DEVICE_STATISTICS 0x51U #define SET_ATM_DEFAULT_VC 0x52U #define GET_ATM_VC_STATISTICS 0x53U /* wValue for set control line state */ #define CDC_ACTIVATE_CARRIER_SIGNAL_RTS 0x0002U #define CDC_DEACTIVATE_CARRIER_SIGNAL_RTS 0x0000U #define CDC_ACTIVATE_SIGNAL_DTR 0x0001U #define CDC_DEACTIVATE_SIGNAL_DTR 0x0000U /* CDC subclass code */ enum usb_cdc_subclass { USB_CDC_SUBCLASS_RESERVED = 0U, /*!< reserved */ USB_CDC_SUBCLASS_DLCM, /*!< direct line control mode */ USB_CDC_SUBCLASS_ACM, /*!< abstract control mode */ USB_CDC_SUBCLASS_TCM, /*!< telephone control mode */ USB_CDC_SUBCLASS_MCM, /*!< multichannel control model */ USB_CDC_SUBCLASS_CCM, /*!< CAPI control model */ USB_CDC_SUBCLASS_ENCM, /*!< ethernet networking control model */ USB_CDC_SUBCLASS_ANCM /*!< ATM networking control model */ }; #pragma pack(1) /* cdc acm line coding structure */ typedef struct { uint32_t dwDTERate; /*!< data terminal rate */ uint8_t bCharFormat; /*!< stop bits */ uint8_t bParityType; /*!< parity */ uint8_t bDataBits; /*!< data bits */ } acm_line; /* notification structure */ typedef struct { uint8_t bmRequestType; /*!< type of request */ uint8_t bNotification; /*!< communication interface class notifications */ uint16_t wValue; /*!< value of notification */ uint16_t wIndex; /*!< index of interface */ uint16_t wLength; /*!< length of notification data */ } acm_notification; typedef struct { usb_desc_header header; /*!< descriptor header, including type and size. */ uint8_t bDescriptorSubtype; /*!< bDescriptorSubtype: header function descriptor */ uint16_t bcdCDC; /*!< bcdCDC: low byte of spec release number (CDC1.10) */ } usb_desc_header_func; typedef struct { usb_desc_header header; /*!< descriptor header, including type and size. */ uint8_t bDescriptorSubtype; /*!< bDescriptorSubtype: call management function descriptor */ uint8_t bmCapabilities; /*!< bmCapabilities: D0 is reset, D1 is ignored */ uint8_t bDataInterface; /*!< bDataInterface: 1 interface used for call management */ } usb_desc_call_managment_func; typedef struct { usb_desc_header header; /*!< descriptor header, including type and size. */ uint8_t bDescriptorSubtype; /*!< bDescriptorSubtype: abstract control management descriptor */ uint8_t bmCapabilities; /*!< bmCapabilities: D1 */ } usb_desc_acm_func; typedef struct { usb_desc_header header; /*!< descriptor header, including type and size. */ uint8_t bDescriptorSubtype; /*!< bDescriptorSubtype: union function descriptor */ uint8_t bMasterInterface; /*!< bMasterInterface: communication class interface */ uint8_t bSlaveInterface0; /*!< bSlaveInterface0: data class interface */ } usb_desc_union_func; #pragma pack() typedef struct { usb_desc_config config; usb_desc_itf cmd_itf; usb_desc_header_func cdc_header; usb_desc_call_managment_func cdc_call_managment; usb_desc_acm_func cdc_acm; usb_desc_union_func cdc_union; usb_desc_ep cdc_cmd_endpoint; usb_desc_itf cdc_data_interface; usb_desc_ep cdc_out_endpoint; usb_desc_ep cdc_in_endpoint; } usb_cdc_desc_config_set; #endif /* __USB_CDC_H */