1 | /* SPDX-License-Identifier: GPL-2.0 */ |
2 | /* |
3 | * |
4 | * Includes for cdc-acm.c |
5 | * |
6 | * Mainly take from usbnet's cdc-ether part |
7 | * |
8 | */ |
9 | |
10 | /* |
11 | * Major and minor numbers. |
12 | */ |
13 | |
14 | #define ACM_TTY_MAJOR 166 |
15 | #define ACM_TTY_MINORS 256 |
16 | |
17 | #define ACM_MINOR_INVALID ACM_TTY_MINORS |
18 | |
19 | /* |
20 | * Requests. |
21 | */ |
22 | |
23 | #define USB_RT_ACM (USB_TYPE_CLASS | USB_RECIP_INTERFACE) |
24 | |
25 | /* |
26 | * Internal driver structures. |
27 | */ |
28 | |
29 | /* |
30 | * The only reason to have several buffers is to accommodate assumptions |
31 | * in line disciplines. They ask for empty space amount, receive our URB size, |
32 | * and proceed to issue several 1-character writes, assuming they will fit. |
33 | * The very first write takes a complete URB. Fortunately, this only happens |
34 | * when processing onlcr, so we only need 2 buffers. These values must be |
35 | * powers of 2. |
36 | */ |
37 | #define ACM_NW 16 |
38 | #define ACM_NR 16 |
39 | |
40 | struct acm_wb { |
41 | u8 *buf; |
42 | dma_addr_t dmah; |
43 | unsigned int len; |
44 | struct urb *urb; |
45 | struct acm *instance; |
46 | bool use; |
47 | }; |
48 | |
49 | struct acm_rb { |
50 | int size; |
51 | unsigned char *base; |
52 | dma_addr_t dma; |
53 | int index; |
54 | struct acm *instance; |
55 | }; |
56 | |
57 | struct acm { |
58 | struct usb_device *dev; /* the corresponding usb device */ |
59 | struct usb_interface *control; /* control interface */ |
60 | struct usb_interface *data; /* data interface */ |
61 | unsigned in, out; /* i/o pipes */ |
62 | struct tty_port port; /* our tty port data */ |
63 | struct urb *ctrlurb; /* urbs */ |
64 | u8 *ctrl_buffer; /* buffers of urbs */ |
65 | dma_addr_t ctrl_dma; /* dma handles of buffers */ |
66 | u8 *country_codes; /* country codes from device */ |
67 | unsigned int country_code_size; /* size of this buffer */ |
68 | unsigned int country_rel_date; /* release date of version */ |
69 | struct acm_wb wb[ACM_NW]; |
70 | unsigned long read_urbs_free; |
71 | struct urb *read_urbs[ACM_NR]; |
72 | struct acm_rb read_buffers[ACM_NR]; |
73 | int rx_buflimit; |
74 | spinlock_t read_lock; |
75 | u8 *notification_buffer; /* to reassemble fragmented notifications */ |
76 | unsigned int nb_index; |
77 | unsigned int nb_size; |
78 | int transmitting; |
79 | spinlock_t write_lock; |
80 | struct mutex mutex; |
81 | bool disconnected; |
82 | unsigned long flags; |
83 | # define EVENT_TTY_WAKEUP 0 |
84 | # define EVENT_RX_STALL 1 |
85 | # define ACM_THROTTLED 2 |
86 | # define ACM_ERROR_DELAY 3 |
87 | unsigned long urbs_in_error_delay; /* these need to be restarted after a delay */ |
88 | struct usb_cdc_line_coding line; /* bits, stop, parity */ |
89 | struct delayed_work dwork; /* work queue entry for various purposes */ |
90 | unsigned int ctrlin; /* input control lines (DCD, DSR, RI, break, overruns) */ |
91 | unsigned int ctrlout; /* output control lines (DTR, RTS) */ |
92 | struct async_icount iocount; /* counters for control line changes */ |
93 | struct async_icount oldcount; /* for comparison of counter */ |
94 | wait_queue_head_t wioctl; /* for ioctl */ |
95 | unsigned int writesize; /* max packet size for the output bulk endpoint */ |
96 | unsigned int readsize,ctrlsize; /* buffer sizes for freeing */ |
97 | unsigned int minor; /* acm minor number */ |
98 | unsigned char clocal; /* termios CLOCAL */ |
99 | unsigned int ctrl_caps; /* control capabilities from the class specific header */ |
100 | unsigned int susp_count; /* number of suspended interfaces */ |
101 | unsigned int combined_interfaces:1; /* control and data collapsed */ |
102 | u8 bInterval; |
103 | struct usb_anchor delayed; /* writes queued for a device about to be woken */ |
104 | unsigned long quirks; |
105 | }; |
106 | |
107 | /* constants describing various quirks and errors */ |
108 | #define NO_UNION_NORMAL BIT(0) |
109 | #define SINGLE_RX_URB BIT(1) |
110 | #define NO_CAP_LINE BIT(2) |
111 | #define IGNORE_DEVICE BIT(3) |
112 | #define QUIRK_CONTROL_LINE_STATE BIT(4) |
113 | #define CLEAR_HALT_CONDITIONS BIT(5) |
114 | #define SEND_ZERO_PACKET BIT(6) |
115 | #define DISABLE_ECHO BIT(7) |
116 | |