2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 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.
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
32 #include <sys/param.h>
33 #include <sys/systm.h>
36 #include <machine/bus.h>
37 #include <machine/vmparam.h>
39 #include <dev/uart/uart.h>
40 #include <dev/uart/uart_cpu.h>
53 static struct uart_class *uart_classes[] = {
63 uart_parse_addr(const char **p)
65 return (strtoul(*p, (char**)(uintptr_t)p, 0));
68 static struct uart_class *
69 uart_parse_class(struct uart_class *class, const char **p)
71 struct uart_class *uc;
76 for (i = 0; i < nitems(uart_classes); i++) {
78 nm = uart_getname(uc);
79 if (nm == NULL || *nm == '\0')
82 if (strncmp(nm, *p, len) == 0) {
91 uart_parse_long(const char **p)
93 return (strtol(*p, (char**)(uintptr_t)p, 0));
97 uart_parse_parity(const char **p)
99 if (!strncmp(*p, "even", 4)) {
101 return UART_PARITY_EVEN;
103 if (!strncmp(*p, "mark", 4)) {
105 return UART_PARITY_MARK;
107 if (!strncmp(*p, "none", 4)) {
109 return UART_PARITY_NONE;
111 if (!strncmp(*p, "odd", 3)) {
113 return UART_PARITY_ODD;
115 if (!strncmp(*p, "space", 5)) {
117 return UART_PARITY_SPACE;
123 uart_parse_tag(const char **p)
127 if ((*p)[0] == 'b' && (*p)[1] == 'r') {
131 if ((*p)[0] == 'c' && (*p)[1] == 'h') {
135 if ((*p)[0] == 'd' && (*p)[1] == 'b') {
139 if ((*p)[0] == 'd' && (*p)[1] == 't') {
143 if ((*p)[0] == 'i' && (*p)[1] == 'o') {
147 if ((*p)[0] == 'm' && (*p)[1] == 'm') {
151 if ((*p)[0] == 'p' && (*p)[1] == 'a') {
155 if ((*p)[0] == 'r' && (*p)[1] == 's') {
159 if ((*p)[0] == 's' && (*p)[1] == 'b') {
163 if ((*p)[0] == 'x' && (*p)[1] == 'o') {
178 * Parse a device specification. The specification is a list of attributes
179 * separated by commas. Each attribute is a tag-value pair with the tag and
180 * value separated by a colon. Supported tags are:
186 * io = I/O port address
187 * mm = Memory mapped I/O address
189 * rs = Register shift
191 * xo = Device clock (xtal oscillator)
193 * The io and mm tags are mutually exclusive.
197 uart_getenv(int devtype, struct uart_devinfo *di, struct uart_class *class)
201 bus_addr_t addr = ~0U;
205 * All uart_class references are weak. Make sure the default
206 * device class has been compiled-in.
212 * Check the environment variables "hw.uart.console" and
213 * "hw.uart.dbgport". These variables, when present, specify
214 * which UART port is to be used as serial console or debug
218 case UART_DEV_CONSOLE:
219 cp = kern_getenv("hw.uart.console");
221 case UART_DEV_DBGPORT:
222 cp = kern_getenv("hw.uart.dbgport");
239 di->parity = UART_PARITY_NONE;
241 /* Parse the attributes. */
244 switch (uart_parse_tag(&spec)) {
246 di->baudrate = uart_parse_long(&spec);
249 di->bas.chan = uart_parse_long(&spec);
252 di->databits = uart_parse_long(&spec);
255 class = uart_parse_class(class, &spec);
258 di->bas.bst = uart_bus_space_io;
259 addr = uart_parse_addr(&spec);
262 di->bas.bst = uart_bus_space_mem;
263 addr = uart_parse_addr(&spec);
266 di->parity = uart_parse_parity(&spec);
269 di->bas.regshft = uart_parse_long(&spec);
272 di->stopbits = uart_parse_long(&spec);
275 di->bas.rclk = uart_parse_long(&spec);
292 * If we still have an invalid address, the specification must be
293 * missing an I/O port or memory address. We don't like that.
299 * Accept only the well-known baudrates. Any invalid baudrate
300 * is silently replaced with a 0-valued baudrate. The 0 baudrate
301 * has special meaning. It means that we're not supposed to
302 * program the baudrate and simply communicate with whatever
303 * speed the hardware is currently programmed for.
305 if (di->baudrate >= 19200) {
306 if (di->baudrate % 19200)
308 } else if (di->baudrate >= 1200) {
309 if (di->baudrate % 1200)
311 } else if (di->baudrate > 0) {
312 if (di->baudrate % 75)
317 /* Set the ops and create a bus space handle. */
318 di->ops = uart_getops(class);
319 error = bus_space_map(di->bas.bst, addr, uart_getrange(class), 0,