2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2003, 2004 Marcel Moolenaar
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 #ifndef _DEV_UART_CPU_H_
32 #define _DEV_UART_CPU_H_
36 #include <sys/mutex.h>
41 * Low-level operations for use by console and/or debug port support.
44 int (*probe)(struct uart_bas *);
45 void (*init)(struct uart_bas *, int, int, int, int);
46 void (*term)(struct uart_bas *);
47 void (*putc)(struct uart_bas *, int);
48 int (*rxready)(struct uart_bas *);
49 int (*getc)(struct uart_bas *, struct mtx *);
52 extern bus_space_tag_t uart_bus_space_io;
53 extern bus_space_tag_t uart_bus_space_mem;
56 * Console and debug port device info.
59 SLIST_ENTRY(uart_devinfo) next;
67 #define UART_DEV_CONSOLE 0
68 #define UART_DEV_DBGPORT 1
69 #define UART_DEV_KEYBOARD 2
70 int (*attach)(struct uart_softc*);
71 int (*detach)(struct uart_softc*);
72 void *cookie; /* Type dependent use. */
74 struct uart_softc *sc; /* valid only from start of attach */
77 int uart_cpu_eqres(struct uart_bas *, struct uart_bas *);
78 int uart_cpu_getdev(int, struct uart_devinfo *);
80 int uart_getenv(int, struct uart_devinfo *, struct uart_class *);
81 const char *uart_getname(struct uart_class *);
82 struct uart_ops *uart_getops(struct uart_class *);
83 int uart_getrange(struct uart_class *);
84 u_int uart_getregshift(struct uart_class *);
85 u_int uart_getregiowidth(struct uart_class *);
87 void uart_add_sysdev(struct uart_devinfo *);
90 * Operations for low-level access to the UART. Primarily for use
91 * by console and debug port logic.
95 uart_lock(struct mtx *hwmtx)
97 if (!kdb_active && hwmtx != NULL)
102 uart_unlock(struct mtx *hwmtx)
104 if (!kdb_active && hwmtx != NULL)
105 mtx_unlock_spin(hwmtx);
109 uart_probe(struct uart_devinfo *di)
113 uart_lock(di->hwmtx);
114 res = di->ops->probe(&di->bas);
115 uart_unlock(di->hwmtx);
120 uart_init(struct uart_devinfo *di)
122 uart_lock(di->hwmtx);
123 di->ops->init(&di->bas, di->baudrate, di->databits, di->stopbits,
125 uart_unlock(di->hwmtx);
129 uart_term(struct uart_devinfo *di)
131 uart_lock(di->hwmtx);
132 di->ops->term(&di->bas);
133 uart_unlock(di->hwmtx);
137 uart_putc(struct uart_devinfo *di, int c)
139 uart_lock(di->hwmtx);
140 di->ops->putc(&di->bas, c);
141 uart_unlock(di->hwmtx);
145 uart_rxready(struct uart_devinfo *di)
149 uart_lock(di->hwmtx);
150 res = di->ops->rxready(&di->bas);
151 uart_unlock(di->hwmtx);
156 uart_poll(struct uart_devinfo *di)
160 uart_lock(di->hwmtx);
161 if (di->ops->rxready(&di->bas))
162 res = di->ops->getc(&di->bas, NULL);
165 uart_unlock(di->hwmtx);
170 uart_getc(struct uart_devinfo *di)
173 return (di->ops->getc(&di->bas, di->hwmtx));
176 void uart_grab(struct uart_devinfo *di);
177 void uart_ungrab(struct uart_devinfo *di);
179 #endif /* _DEV_UART_CPU_H_ */