xref: /linux/drivers/tty/serial/serial_base.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * Serial core related functions, serial port device drivers do not need this.
4  *
5  * Copyright (C) 2023 Texas Instruments Incorporated - https://www.ti.com/
6  * Author: Tony Lindgren <tony@atomide.com>
7  */
8 
9 #define to_serial_base_ctrl_device(d) container_of((d), struct serial_ctrl_device, dev)
10 #define to_serial_base_port_device(d) container_of((d), struct serial_port_device, dev)
11 
12 struct uart_driver;
13 struct uart_port;
14 struct device_driver;
15 struct device;
16 
17 struct serial_ctrl_device {
18 	struct device dev;
19 	struct ida port_ida;
20 };
21 
22 struct serial_port_device {
23 	struct device dev;
24 	struct uart_port *port;
25 	unsigned int tx_enabled:1;
26 };
27 
28 int serial_base_ctrl_init(void);
29 void serial_base_ctrl_exit(void);
30 
31 int serial_base_port_init(void);
32 void serial_base_port_exit(void);
33 
34 void serial_base_port_startup(struct uart_port *port);
35 void serial_base_port_shutdown(struct uart_port *port);
36 
37 int serial_base_driver_register(struct device_driver *driver);
38 void serial_base_driver_unregister(struct device_driver *driver);
39 
40 struct serial_ctrl_device *serial_base_ctrl_add(struct uart_port *port,
41 						struct device *parent);
42 struct serial_port_device *serial_base_port_add(struct uart_port *port,
43 						struct serial_ctrl_device *parent);
44 void serial_base_ctrl_device_remove(struct serial_ctrl_device *ctrl_dev);
45 void serial_base_port_device_remove(struct serial_port_device *port_dev);
46 
47 int serial_ctrl_register_port(struct uart_driver *drv, struct uart_port *port);
48 void serial_ctrl_unregister_port(struct uart_driver *drv, struct uart_port *port);
49 
50 int serial_core_register_port(struct uart_driver *drv, struct uart_port *port);
51 void serial_core_unregister_port(struct uart_driver *drv, struct uart_port *port);
52 
53 #ifdef CONFIG_SERIAL_CORE_CONSOLE
54 
55 int serial_base_match_and_update_preferred_console(struct uart_driver *drv,
56 						   struct uart_port *port);
57 
58 #else
59 
60 static inline
61 int serial_base_match_and_update_preferred_console(struct uart_driver *drv,
62 						   struct uart_port *port)
63 {
64 	return 0;
65 }
66 
67 #endif
68