cdc.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2018 Dylan Laduranty <dylan.laduranty@mesotic.com>
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser General
5  * Public License v2.1. See the file LICENSE in the top level directory for
6  * more details.
7  */
8 
23 #ifndef USB_CDC_H
24 #define USB_CDC_H
25 
26 #include <stdint.h>
27 
28 #include "usb.h"
29 #include "usb/descriptor.h"
30 
31 #ifdef __cplusplus
32 extern "C" {
33 #endif
34 
35 #define USB_TYPE_DESCRIPTOR_CDC 0x24
36 #define USB_CDC_VERSION_BCD 0x0120
43 #define USB_CDC_SUBCLASS_NONE 0x00
44 #define USB_CDC_SUBCLASS_DLCM 0x01
45 #define USB_CDC_SUBCLASS_ACM 0x02
46 #define USB_CDC_SUBCLASS_TCM 0x03
47 #define USB_CDC_SUBCLASS_MCCM 0x04
48 #define USB_CDC_SUBCLASS_CCM 0x05
49 #define USB_CDC_SUBCLASS_ENCM 0x06
50 #define USB_CDC_SUBCLASS_ANCM 0x07
51 #define USB_CDC_SUBCLASS_WHCM 0x08
52 #define USB_CDC_SUBCLASS_DM 0x09
53 #define USB_CDC_SUBCLASS_MDLM 0x0A
54 #define USB_CDC_SUBCLASS_OBEX 0x0B
55 #define USB_CDC_SUBCLASS_EEM 0x0C
56 #define USB_CDC_SUBCLASS_NCM 0x0D
63 #define USB_CDC_PROTOCOL_NONE 0x00
64 #define USB_CDC_PROTOCOL_ITU 0x01
65 #define USB_CDC_PROTOCOL_PCCA 0x02
66 #define USB_CDC_PROTOCOL_PCCA_A 0x03
67 #define USB_CDC_PROTOCOL_GSM 0x04
68 #define USB_CDC_PROTOCOL_3GPP 0x05
69 #define USB_CDC_PROTOCOL_CS 0x06
70 #define USB_CDC_PROTOCOL_EEM 0x07
71 #define USB_CDC_PROTOCOL_EXT 0xFE
72 #define USB_CDC_PROTOCOL_VENDOR 0xFF
79 #define USB_CDC_DESCR_SUBTYPE_FUNCTIONAL 0x00
81 #define USB_CDC_DESCR_SUBTYPE_CALL_MGMT 0x01
83 #define USB_CDC_DESCR_SUBTYPE_ACM 0x02
85 #define USB_CDC_DESCR_SUBTYPE_UNION 0x06
86 #define USB_CDC_DESCR_SUBTYPE_ETH_NET 0x0f
97 #define USB_CDC_MGNT_REQUEST_SET_LINE_CODING (0x20)
98 
102 #define USB_CDC_MGNT_REQUEST_GET_LINE_CODING (0x21)
103 
107 #define USB_CDC_MGNT_REQUEST_SET_CONTROL_LINE_STATE (0x22)
108 
112 #define USB_CDC_MGNT_REQUEST_SET_ETH_MULTICAST_FILTER 0x40
113 
117 #define USB_CDC_MGNT_REQUEST_SET_ETH_PM_PATTERN_FILTER 0x41
118 
122 #define USB_CDC_MGNT_REQUEST_GET_ETH_PM_PATTERN_FILTER 0x42
123 
127 #define USB_CDC_MGNT_REQUEST_SET_ETH_PACKET_FILTER 0x43
128 
132 #define USB_CDC_MGNT_REQUEST_GET_ETH_STATISTICS 0x44
143 #define USB_CDC_ACM_CONTROL_LINE_DTE (0x01)
144 
148 #define USB_CDC_ACM_CONTROL_LINE_CARRIER (0x02)
159 #define USB_CDC_MGNT_NOTIF_NETWORK_CONNECTION 0x00
160 
164 #define USB_CDC_MGNT_NOTIF_RESPONSE_AVAILABLE 0x01
165 
169 #define USB_CDC_MGNT_NOTIF_AUX_JACK_HOOK_STATE 0x08
170 
174 #define USB_CDC_MGNT_NOTIF_RING_DETECT 0x09
175 
179 #define USB_CDC_MGNT_NOTIF_SERIAL_STATE 0x20
180 
184 #define USB_CDC_MGNT_NOTIF_CALL_STATE_CHANGE 0x28
185 
189 #define USB_CDC_MGNT_NOTIF_LINE_STATE_CHANGE 0x29
190 
194 #define USB_CDC_MGNT_NOTIF_CONN_SPEED_CHANGE 0x2A
195 
203 typedef struct __attribute__((packed)) {
204  uint8_t length;
205  uint8_t type;
206  uint8_t subtype;
207  uint8_t macaddress;
209  uint16_t maxsegmentsize;
210  uint16_t numbermcfilters;
213 
219 typedef struct __attribute__((packed)) {
220  uint8_t length;
221  uint8_t type;
222  uint8_t subtype;
223  uint8_t capabilities;
225 
231 typedef struct __attribute__((packed)) {
232  uint8_t length;
233  uint8_t type;
234  uint8_t subtype;
235  uint16_t bcd_cdc;
237 
241 typedef struct __attribute__((packed)) {
242  uint8_t length;
243  uint8_t type;
244  uint8_t subtype;
245  uint8_t master_if;
246  uint8_t slave_if;
248 
254 typedef struct __attribute__((packed)) {
255  uint8_t length;
256  uint8_t type;
257  uint8_t subtype;
258  uint8_t capabilities;
259  uint8_t data_if;
261 
267 typedef struct __attribute__((packed)) {
269  uint32_t down;
270  uint32_t up;
272 
282 typedef struct __attribute__((packed)) {
283  uint32_t baud;
284  uint8_t format;
285  uint8_t parity;
286  uint8_t databits;
288 
289 #define USB_CDC_ACM_CODING_STOP_BITS_1 0
290 #define USB_CDC_ACM_CODING_STOP_BITS_1_5 1
291 #define USB_CDC_ACM_CODING_STOP_BITS_2 2
293 #define USB_CDC_ACM_CODING_PARITY_NONE 0
294 #define USB_CDC_ACM_CODING_PARITY_ODD 1
295 #define USB_CDC_ACM_CODING_PARITY_EVEN 2
296 #define USB_CDC_ACM_CODING_PARITY_MARK 3
297 #define USB_CDC_ACM_CODING_PARITY_SPACE 4
300 #ifdef __cplusplus
301 }
302 #endif
303 
304 #endif /* USB_CDC_H */
Definitions for USB protocol messages.
USB CDC ACM descriptor.
Definition: cdc.h:219
uint8_t subtype
Descriptor subtype (USB_CDC_DESCR_SUBTYPE_ACM)
Definition: cdc.h:222
uint8_t type
Descriptor type (USB_TYPE_DESCRIPTOR_CDC)
Definition: cdc.h:221
uint8_t length
Size of this descriptor.
Definition: cdc.h:220
uint8_t capabilities
Bitmap indicating the capabilities.
Definition: cdc.h:223
USB CDC call management functional descriptor.
Definition: cdc.h:254
uint8_t length
Size of this descriptor.
Definition: cdc.h:255
uint8_t capabilities
Supported capabilities.
Definition: cdc.h:258
uint8_t type
Descriptor type (USB_TYPE_DESCRIPTOR_CDC)
Definition: cdc.h:256
uint8_t data_if
Interface number used for the call management.
Definition: cdc.h:259
uint8_t subtype
Descriptor subtype (USB_CDC_DESCR_SUBTYPE_CALL_MGMT)
Definition: cdc.h:257
Generic USB CDC descriptor.
Definition: cdc.h:231
uint8_t subtype
Descriptor subtype (usb_cdc_subtype)
Definition: cdc.h:234
uint8_t length
Size of this descriptor.
Definition: cdc.h:232
uint8_t type
Descriptor type (USB_TYPE_DESCRIPTOR_CDC)
Definition: cdc.h:233
uint16_t bcd_cdc
CDC release number in bcd (USB_CDC_VERSION_BCD)
Definition: cdc.h:235
USB CDC ECM connection speed change notification.
Definition: cdc.h:267
uint32_t down
Downlink bit rate.
Definition: cdc.h:269
uint32_t up
Uplink bit rate.
Definition: cdc.h:270
usb_setup_t setup
Setup request header for the notification.
Definition: cdc.h:268
USB CDC ECM descriptor.
Definition: cdc.h:203
uint16_t maxsegmentsize
Maximum segment size of the interface.
Definition: cdc.h:209
uint8_t macaddress
Index of the string containing the ethernet MAC address.
Definition: cdc.h:207
uint8_t length
Size of this descriptor.
Definition: cdc.h:204
uint8_t subtype
Descriptor subtype (USB_CDC_DESCR_SUBTYPE_ETH_NET)
Definition: cdc.h:206
uint16_t numbermcfilters
Number of configurable multicast filters.
Definition: cdc.h:210
uint8_t numberpowerfilters
Number of pattern filters for host wake-up.
Definition: cdc.h:211
uint8_t type
Descriptor type (USB_TYPE_DESCRIPTOR_CDC)
Definition: cdc.h:205
uint32_t ethernetstatistics
Bitmap indicating the statistics caps.
Definition: cdc.h:208
USB union descriptor.
Definition: cdc.h:241
uint8_t master_if
Master/controlling interface number.
Definition: cdc.h:245
uint8_t length
Size of this descriptor.
Definition: cdc.h:242
uint8_t slave_if
Slave/subordinate interface number.
Definition: cdc.h:246
uint8_t subtype
Descriptor subtype (USB_CDC_DESCR_SUBTYPE_UNION)
Definition: cdc.h:244
uint8_t type
Descriptor type (USB_TYPE_DESCRIPTOR_CDC)
Definition: cdc.h:243
USB CDC ACM line coding setup content.
Definition: cdc.h:282
uint8_t parity
Parity settings
Definition: cdc.h:285
uint8_t format
Stop bits settings
Definition: cdc.h:284
uint8_t databits
Number of data bits (5, 6, 7, 8 or 16)
Definition: cdc.h:286
uint32_t baud
Requested baud rate
Definition: cdc.h:283
USB setup packet (USB 2.0 spec table 9-2)
Definition: descriptor.h:207
Definition of global compile time configuration options.