1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * xhci-dbgtty.c - tty glue for xHCI debug capability
4 *
5 * Copyright (C) 2017 Intel Corporation
6 *
7 * Author: Lu Baolu <baolu.lu@linux.intel.com>
8 */
9
10 #include <linux/slab.h>
11 #include <linux/tty.h>
12 #include <linux/tty_flip.h>
13
14 #include "xhci.h"
15 #include "xhci-dbgcap.h"
16
17 static int dbc_tty_init(void);
18 static void dbc_tty_exit(void);
19
20 static struct tty_driver *dbc_tty_driver;
21
dbc_to_port(struct xhci_dbc * dbc)22 static inline struct dbc_port *dbc_to_port(struct xhci_dbc *dbc)
23 {
24 return dbc->priv;
25 }
26
27 static unsigned int
dbc_send_packet(struct dbc_port * port,char * packet,unsigned int size)28 dbc_send_packet(struct dbc_port *port, char *packet, unsigned int size)
29 {
30 unsigned int len;
31
32 len = kfifo_len(&port->write_fifo);
33 if (len < size)
34 size = len;
35 if (size != 0)
36 size = kfifo_out(&port->write_fifo, packet, size);
37 return size;
38 }
39
dbc_start_tx(struct dbc_port * port)40 static int dbc_start_tx(struct dbc_port *port)
41 __releases(&port->port_lock)
42 __acquires(&port->port_lock)
43 {
44 int len;
45 struct dbc_request *req;
46 int status = 0;
47 bool do_tty_wake = false;
48 struct list_head *pool = &port->write_pool;
49
50 while (!list_empty(pool)) {
51 req = list_entry(pool->next, struct dbc_request, list_pool);
52 len = dbc_send_packet(port, req->buf, DBC_MAX_PACKET);
53 if (len == 0)
54 break;
55 do_tty_wake = true;
56
57 req->length = len;
58 list_del(&req->list_pool);
59
60 spin_unlock(&port->port_lock);
61 status = dbc_ep_queue(req);
62 spin_lock(&port->port_lock);
63
64 if (status) {
65 list_add(&req->list_pool, pool);
66 break;
67 }
68 }
69
70 if (do_tty_wake && port->port.tty)
71 tty_wakeup(port->port.tty);
72
73 return status;
74 }
75
dbc_start_rx(struct dbc_port * port)76 static void dbc_start_rx(struct dbc_port *port)
77 __releases(&port->port_lock)
78 __acquires(&port->port_lock)
79 {
80 struct dbc_request *req;
81 int status;
82 struct list_head *pool = &port->read_pool;
83
84 while (!list_empty(pool)) {
85 if (!port->port.tty)
86 break;
87
88 req = list_entry(pool->next, struct dbc_request, list_pool);
89 list_del(&req->list_pool);
90 req->length = DBC_MAX_PACKET;
91
92 spin_unlock(&port->port_lock);
93 status = dbc_ep_queue(req);
94 spin_lock(&port->port_lock);
95
96 if (status) {
97 list_add(&req->list_pool, pool);
98 break;
99 }
100 }
101 }
102
103 static void
dbc_read_complete(struct xhci_dbc * dbc,struct dbc_request * req)104 dbc_read_complete(struct xhci_dbc *dbc, struct dbc_request *req)
105 {
106 unsigned long flags;
107 struct dbc_port *port = dbc_to_port(dbc);
108
109 spin_lock_irqsave(&port->port_lock, flags);
110 list_add_tail(&req->list_pool, &port->read_queue);
111 tasklet_schedule(&port->push);
112 spin_unlock_irqrestore(&port->port_lock, flags);
113 }
114
dbc_write_complete(struct xhci_dbc * dbc,struct dbc_request * req)115 static void dbc_write_complete(struct xhci_dbc *dbc, struct dbc_request *req)
116 {
117 unsigned long flags;
118 struct dbc_port *port = dbc_to_port(dbc);
119
120 spin_lock_irqsave(&port->port_lock, flags);
121 list_add(&req->list_pool, &port->write_pool);
122 switch (req->status) {
123 case 0:
124 dbc_start_tx(port);
125 break;
126 case -ESHUTDOWN:
127 break;
128 default:
129 dev_warn(dbc->dev, "unexpected write complete status %d\n",
130 req->status);
131 break;
132 }
133 spin_unlock_irqrestore(&port->port_lock, flags);
134 }
135
xhci_dbc_free_req(struct dbc_request * req)136 static void xhci_dbc_free_req(struct dbc_request *req)
137 {
138 kfree(req->buf);
139 dbc_free_request(req);
140 }
141
142 static int
xhci_dbc_alloc_requests(struct xhci_dbc * dbc,unsigned int direction,struct list_head * head,void (* fn)(struct xhci_dbc *,struct dbc_request *))143 xhci_dbc_alloc_requests(struct xhci_dbc *dbc, unsigned int direction,
144 struct list_head *head,
145 void (*fn)(struct xhci_dbc *, struct dbc_request *))
146 {
147 int i;
148 struct dbc_request *req;
149
150 for (i = 0; i < DBC_QUEUE_SIZE; i++) {
151 req = dbc_alloc_request(dbc, direction, GFP_KERNEL);
152 if (!req)
153 break;
154
155 req->length = DBC_MAX_PACKET;
156 req->buf = kmalloc(req->length, GFP_KERNEL);
157 if (!req->buf) {
158 dbc_free_request(req);
159 break;
160 }
161
162 req->complete = fn;
163 list_add_tail(&req->list_pool, head);
164 }
165
166 return list_empty(head) ? -ENOMEM : 0;
167 }
168
169 static void
xhci_dbc_free_requests(struct list_head * head)170 xhci_dbc_free_requests(struct list_head *head)
171 {
172 struct dbc_request *req;
173
174 while (!list_empty(head)) {
175 req = list_entry(head->next, struct dbc_request, list_pool);
176 list_del(&req->list_pool);
177 xhci_dbc_free_req(req);
178 }
179 }
180
dbc_tty_install(struct tty_driver * driver,struct tty_struct * tty)181 static int dbc_tty_install(struct tty_driver *driver, struct tty_struct *tty)
182 {
183 struct dbc_port *port = driver->driver_state;
184
185 tty->driver_data = port;
186
187 return tty_port_install(&port->port, driver, tty);
188 }
189
dbc_tty_open(struct tty_struct * tty,struct file * file)190 static int dbc_tty_open(struct tty_struct *tty, struct file *file)
191 {
192 struct dbc_port *port = tty->driver_data;
193
194 return tty_port_open(&port->port, tty, file);
195 }
196
dbc_tty_close(struct tty_struct * tty,struct file * file)197 static void dbc_tty_close(struct tty_struct *tty, struct file *file)
198 {
199 struct dbc_port *port = tty->driver_data;
200
201 tty_port_close(&port->port, tty, file);
202 }
203
dbc_tty_write(struct tty_struct * tty,const unsigned char * buf,int count)204 static int dbc_tty_write(struct tty_struct *tty,
205 const unsigned char *buf,
206 int count)
207 {
208 struct dbc_port *port = tty->driver_data;
209 unsigned long flags;
210
211 spin_lock_irqsave(&port->port_lock, flags);
212 if (count)
213 count = kfifo_in(&port->write_fifo, buf, count);
214 dbc_start_tx(port);
215 spin_unlock_irqrestore(&port->port_lock, flags);
216
217 return count;
218 }
219
dbc_tty_put_char(struct tty_struct * tty,unsigned char ch)220 static int dbc_tty_put_char(struct tty_struct *tty, unsigned char ch)
221 {
222 struct dbc_port *port = tty->driver_data;
223 unsigned long flags;
224 int status;
225
226 spin_lock_irqsave(&port->port_lock, flags);
227 status = kfifo_put(&port->write_fifo, ch);
228 spin_unlock_irqrestore(&port->port_lock, flags);
229
230 return status;
231 }
232
dbc_tty_flush_chars(struct tty_struct * tty)233 static void dbc_tty_flush_chars(struct tty_struct *tty)
234 {
235 struct dbc_port *port = tty->driver_data;
236 unsigned long flags;
237
238 spin_lock_irqsave(&port->port_lock, flags);
239 dbc_start_tx(port);
240 spin_unlock_irqrestore(&port->port_lock, flags);
241 }
242
dbc_tty_write_room(struct tty_struct * tty)243 static int dbc_tty_write_room(struct tty_struct *tty)
244 {
245 struct dbc_port *port = tty->driver_data;
246 unsigned long flags;
247 int room = 0;
248
249 spin_lock_irqsave(&port->port_lock, flags);
250 room = kfifo_avail(&port->write_fifo);
251 spin_unlock_irqrestore(&port->port_lock, flags);
252
253 return room;
254 }
255
dbc_tty_chars_in_buffer(struct tty_struct * tty)256 static int dbc_tty_chars_in_buffer(struct tty_struct *tty)
257 {
258 struct dbc_port *port = tty->driver_data;
259 unsigned long flags;
260 int chars = 0;
261
262 spin_lock_irqsave(&port->port_lock, flags);
263 chars = kfifo_len(&port->write_fifo);
264 spin_unlock_irqrestore(&port->port_lock, flags);
265
266 return chars;
267 }
268
dbc_tty_unthrottle(struct tty_struct * tty)269 static void dbc_tty_unthrottle(struct tty_struct *tty)
270 {
271 struct dbc_port *port = tty->driver_data;
272 unsigned long flags;
273
274 spin_lock_irqsave(&port->port_lock, flags);
275 tasklet_schedule(&port->push);
276 spin_unlock_irqrestore(&port->port_lock, flags);
277 }
278
279 static const struct tty_operations dbc_tty_ops = {
280 .install = dbc_tty_install,
281 .open = dbc_tty_open,
282 .close = dbc_tty_close,
283 .write = dbc_tty_write,
284 .put_char = dbc_tty_put_char,
285 .flush_chars = dbc_tty_flush_chars,
286 .write_room = dbc_tty_write_room,
287 .chars_in_buffer = dbc_tty_chars_in_buffer,
288 .unthrottle = dbc_tty_unthrottle,
289 };
290
dbc_rx_push(struct tasklet_struct * t)291 static void dbc_rx_push(struct tasklet_struct *t)
292 {
293 struct dbc_request *req;
294 struct tty_struct *tty;
295 unsigned long flags;
296 bool do_push = false;
297 bool disconnect = false;
298 struct dbc_port *port = from_tasklet(port, t, push);
299 struct list_head *queue = &port->read_queue;
300
301 spin_lock_irqsave(&port->port_lock, flags);
302 tty = port->port.tty;
303 while (!list_empty(queue)) {
304 req = list_first_entry(queue, struct dbc_request, list_pool);
305
306 if (tty && tty_throttled(tty))
307 break;
308
309 switch (req->status) {
310 case 0:
311 break;
312 case -ESHUTDOWN:
313 disconnect = true;
314 break;
315 default:
316 pr_warn("ttyDBC0: unexpected RX status %d\n",
317 req->status);
318 break;
319 }
320
321 if (req->actual) {
322 char *packet = req->buf;
323 unsigned int n, size = req->actual;
324 int count;
325
326 n = port->n_read;
327 if (n) {
328 packet += n;
329 size -= n;
330 }
331
332 count = tty_insert_flip_string(&port->port, packet,
333 size);
334 if (count)
335 do_push = true;
336 if (count != size) {
337 port->n_read += count;
338 break;
339 }
340 port->n_read = 0;
341 }
342
343 list_move(&req->list_pool, &port->read_pool);
344 }
345
346 if (do_push)
347 tty_flip_buffer_push(&port->port);
348
349 if (!list_empty(queue) && tty) {
350 if (!tty_throttled(tty)) {
351 if (do_push)
352 tasklet_schedule(&port->push);
353 else
354 pr_warn("ttyDBC0: RX not scheduled?\n");
355 }
356 }
357
358 if (!disconnect)
359 dbc_start_rx(port);
360
361 spin_unlock_irqrestore(&port->port_lock, flags);
362 }
363
dbc_port_activate(struct tty_port * _port,struct tty_struct * tty)364 static int dbc_port_activate(struct tty_port *_port, struct tty_struct *tty)
365 {
366 unsigned long flags;
367 struct dbc_port *port = container_of(_port, struct dbc_port, port);
368
369 spin_lock_irqsave(&port->port_lock, flags);
370 dbc_start_rx(port);
371 spin_unlock_irqrestore(&port->port_lock, flags);
372
373 return 0;
374 }
375
376 static const struct tty_port_operations dbc_port_ops = {
377 .activate = dbc_port_activate,
378 };
379
380 static void
xhci_dbc_tty_init_port(struct xhci_dbc * dbc,struct dbc_port * port)381 xhci_dbc_tty_init_port(struct xhci_dbc *dbc, struct dbc_port *port)
382 {
383 tty_port_init(&port->port);
384 spin_lock_init(&port->port_lock);
385 tasklet_setup(&port->push, dbc_rx_push);
386 INIT_LIST_HEAD(&port->read_pool);
387 INIT_LIST_HEAD(&port->read_queue);
388 INIT_LIST_HEAD(&port->write_pool);
389
390 port->port.ops = &dbc_port_ops;
391 port->n_read = 0;
392 }
393
394 static void
xhci_dbc_tty_exit_port(struct dbc_port * port)395 xhci_dbc_tty_exit_port(struct dbc_port *port)
396 {
397 tasklet_kill(&port->push);
398 tty_port_destroy(&port->port);
399 }
400
xhci_dbc_tty_register_device(struct xhci_dbc * dbc)401 static int xhci_dbc_tty_register_device(struct xhci_dbc *dbc)
402 {
403 int ret;
404 struct device *tty_dev;
405 struct dbc_port *port = dbc_to_port(dbc);
406
407 if (port->registered)
408 return -EBUSY;
409
410 xhci_dbc_tty_init_port(dbc, port);
411
412 ret = kfifo_alloc(&port->write_fifo, DBC_WRITE_BUF_SIZE, GFP_KERNEL);
413 if (ret)
414 goto err_exit_port;
415
416 ret = xhci_dbc_alloc_requests(dbc, BULK_IN, &port->read_pool,
417 dbc_read_complete);
418 if (ret)
419 goto err_free_fifo;
420
421 ret = xhci_dbc_alloc_requests(dbc, BULK_OUT, &port->write_pool,
422 dbc_write_complete);
423 if (ret)
424 goto err_free_requests;
425
426 tty_dev = tty_port_register_device(&port->port,
427 dbc_tty_driver, 0, NULL);
428 if (IS_ERR(tty_dev)) {
429 ret = PTR_ERR(tty_dev);
430 goto err_free_requests;
431 }
432
433 port->registered = true;
434
435 return 0;
436
437 err_free_requests:
438 xhci_dbc_free_requests(&port->read_pool);
439 xhci_dbc_free_requests(&port->write_pool);
440 err_free_fifo:
441 kfifo_free(&port->write_fifo);
442 err_exit_port:
443 xhci_dbc_tty_exit_port(port);
444
445 dev_err(dbc->dev, "can't register tty port, err %d\n", ret);
446
447 return ret;
448 }
449
xhci_dbc_tty_unregister_device(struct xhci_dbc * dbc)450 static void xhci_dbc_tty_unregister_device(struct xhci_dbc *dbc)
451 {
452 struct dbc_port *port = dbc_to_port(dbc);
453
454 if (!port->registered)
455 return;
456 tty_unregister_device(dbc_tty_driver, 0);
457 xhci_dbc_tty_exit_port(port);
458 port->registered = false;
459
460 kfifo_free(&port->write_fifo);
461 xhci_dbc_free_requests(&port->read_pool);
462 xhci_dbc_free_requests(&port->read_queue);
463 xhci_dbc_free_requests(&port->write_pool);
464 }
465
466 static const struct dbc_driver dbc_driver = {
467 .configure = xhci_dbc_tty_register_device,
468 .disconnect = xhci_dbc_tty_unregister_device,
469 };
470
xhci_dbc_tty_probe(struct xhci_hcd * xhci)471 int xhci_dbc_tty_probe(struct xhci_hcd *xhci)
472 {
473 struct xhci_dbc *dbc = xhci->dbc;
474 struct dbc_port *port;
475 int status;
476
477 /* dbc_tty_init will be called by module init() in the future */
478 status = dbc_tty_init();
479 if (status)
480 return status;
481
482 port = kzalloc(sizeof(*port), GFP_KERNEL);
483 if (!port) {
484 status = -ENOMEM;
485 goto out;
486 }
487
488 dbc->driver = &dbc_driver;
489 dbc->priv = port;
490
491
492 dbc_tty_driver->driver_state = port;
493
494 return 0;
495 out:
496 /* dbc_tty_exit will be called by module_exit() in the future */
497 dbc_tty_exit();
498 return status;
499 }
500
501 /*
502 * undo what probe did, assume dbc is stopped already.
503 * we also assume tty_unregister_device() is called before this
504 */
xhci_dbc_tty_remove(struct xhci_dbc * dbc)505 void xhci_dbc_tty_remove(struct xhci_dbc *dbc)
506 {
507 struct dbc_port *port = dbc_to_port(dbc);
508
509 dbc->driver = NULL;
510 dbc->priv = NULL;
511 kfree(port);
512
513 /* dbc_tty_exit will be called by module_exit() in the future */
514 dbc_tty_exit();
515 }
516
dbc_tty_init(void)517 static int dbc_tty_init(void)
518 {
519 int ret;
520
521 dbc_tty_driver = tty_alloc_driver(1, TTY_DRIVER_REAL_RAW |
522 TTY_DRIVER_DYNAMIC_DEV);
523 if (IS_ERR(dbc_tty_driver))
524 return PTR_ERR(dbc_tty_driver);
525
526 dbc_tty_driver->driver_name = "dbc_serial";
527 dbc_tty_driver->name = "ttyDBC";
528
529 dbc_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
530 dbc_tty_driver->subtype = SERIAL_TYPE_NORMAL;
531 dbc_tty_driver->init_termios = tty_std_termios;
532 dbc_tty_driver->init_termios.c_cflag =
533 B9600 | CS8 | CREAD | HUPCL | CLOCAL;
534 dbc_tty_driver->init_termios.c_ispeed = 9600;
535 dbc_tty_driver->init_termios.c_ospeed = 9600;
536
537 tty_set_operations(dbc_tty_driver, &dbc_tty_ops);
538
539 ret = tty_register_driver(dbc_tty_driver);
540 if (ret) {
541 pr_err("Can't register dbc tty driver\n");
542 put_tty_driver(dbc_tty_driver);
543 }
544 return ret;
545 }
546
dbc_tty_exit(void)547 static void dbc_tty_exit(void)
548 {
549 if (dbc_tty_driver) {
550 tty_unregister_driver(dbc_tty_driver);
551 put_tty_driver(dbc_tty_driver);
552 dbc_tty_driver = NULL;
553 }
554 }
555