zephyr/subsys/usb/class/cdc_acm.h

130 lines
4.2 KiB
C
Raw Normal View History

/***************************************************************************
*
* Copyright(c) 2015,2016 Intel Corporation.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * 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.
* * Neither the name of Intel Corporation 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
* OWNER 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.
*
***************************************************************************/
/**
* @file
* @brief CDC ACM device class driver header file
*
* Header file for USB CDC ACM device class driver
*/
#ifndef __CDC_ACM_H__
#define __CDC_ACM_H__
/* Data structure for GET_LINE_CODING / SET_LINE_CODING class requests */
struct cdc_acm_line_coding {
uint32_t dwDTERate;
uint8_t bCharFormat;
uint8_t bParityType;
uint8_t bDataBits;
} __packed;
struct cdc_acm_notification {
uint8_t bmRequestType;
uint8_t bNotificationType;
uint16_t wValue;
uint16_t wIndex;
uint16_t wLength;
uint16_t data;
} __packed;
/* Intel vendor ID */
#define CDC_VENDOR_ID 0x8086
/* Product Id, random value */
#define CDC_PRODUCT_ID 0xF8A1
/* Max packet size for Bulk endpoints */
#define CDC_BULK_EP_MPS 64
/* Max packet size for Interrupt endpoints */
#define CDC_INTERRUPT_EP_MPS 16
/* Max CDC ACM class request max data size */
#define CDC_CLASS_REQ_MAX_DATA_SIZE 8
/* Number of configurations for the USB Device */
#define CDC_NUM_CONF 0x01
/* Number of interfaces in the configuration */
#define CDC_NUM_ITF 0x02
/* Number of Endpoints in the first interface */
#define CDC1_NUM_EP 0x01
/* Number of Endpoints in the second interface */
#define CDC2_NUM_EP 0x02
#define CDC_ENDP_INT 0x81
#define CDC_ENDP_OUT 0x03
#define CDC_ENDP_IN 0x84
/* Decriptor size in bytes */
#define USB_HFUNC_DESC_SIZE 5 /* Header Functional Descriptor */
#define USB_CMFUNC_DESC_SIZE 5 /* Call Management Functional Descriptor */
#define USB_ACMFUNC_DESC_SIZE 4 /* ACM Functional Descriptor */
#define USB_UFUNC_DESC_SIZE 5 /* Union Functional Descriptor */
/* Descriptor type */
#define CS_INTERFACE 0x24
#define CS_ENDPOINT 0x25
/* Descriptor subtype */
#define USB_HFUNC_SUBDESC 0x00
#define USB_CMFUNC_SUBDESC 0x01
#define USB_ACMFUNC_SUBDESC 0x02
#define USB_UFUNC_SUBDESC 0x06
/* Class specific request */
#define CDC_SET_LINE_CODING 0x20
#define CDC_GET_LINE_CODING 0x21
#define CDC_SET_CONTROL_LINE_STATE 0x22
/* Control line state signal bitmap */
#define CDC_CONTROL_LINE_STATE_DTR 0x1
#define CDC_CONTROL_LINE_STATE_RTS 0x2
/* Serial state notification bitmap*/
#define CDC_CONTROL_SERIAL_STATE_DCD 0x1
#define CDC_CONTROL_SERIAL_STATE_DSR 0x2
/* Serial state notification timeout */
#define CDC_CONTROL_SERIAL_STATE_TIMEOUT_US 100000
/* Size in bytes of the configuration sent to
* the Host on GetConfiguration() request
* For Communication Device: CONF + (2 x ITF) +
* (3 x EP) + HF + CMF + ACMF + UF -> 67 bytes
*/
#define CDC_CONF_SIZE (USB_CONFIGURATION_DESC_SIZE + \
(2 * USB_INTERFACE_DESC_SIZE) + (3 * USB_ENDPOINT_DESC_SIZE) + 19)
#endif /* __CDC_ACM_H__ */