xref: /linux/drivers/tty/serial/8250/8250_dwlib.c (revision 607ca0f742b7d990b6efb3c3e7a52830f7e96419)
1 // SPDX-License-Identifier: GPL-2.0+
2 /* Synopsys DesignWare 8250 library. */
3 
4 #include <linux/bitops.h>
5 #include <linux/bitfield.h>
6 #include <linux/delay.h>
7 #include <linux/device.h>
8 #include <linux/kernel.h>
9 #include <linux/math.h>
10 #include <linux/property.h>
11 #include <linux/serial_8250.h>
12 #include <linux/serial_core.h>
13 
14 #include "8250_dwlib.h"
15 
16 /* Offsets for the DesignWare specific registers */
17 #define DW_UART_TCR	0xac /* Transceiver Control Register (RS485) */
18 #define DW_UART_DE_EN	0xb0 /* Driver Output Enable Register */
19 #define DW_UART_RE_EN	0xb4 /* Receiver Output Enable Register */
20 #define DW_UART_DLF	0xc0 /* Divisor Latch Fraction Register */
21 #define DW_UART_RAR	0xc4 /* Receive Address Register */
22 #define DW_UART_TAR	0xc8 /* Transmit Address Register */
23 #define DW_UART_LCR_EXT	0xcc /* Line Extended Control Register */
24 #define DW_UART_CPR	0xf4 /* Component Parameter Register */
25 #define DW_UART_UCV	0xf8 /* UART Component Version */
26 
27 /* Receive / Transmit Address Register bits */
28 #define DW_UART_ADDR_MASK		GENMASK(7, 0)
29 
30 /* Line Status Register bits */
31 #define DW_UART_LSR_ADDR_RCVD		BIT(8)
32 
33 /* Transceiver Control Register bits */
34 #define DW_UART_TCR_RS485_EN		BIT(0)
35 #define DW_UART_TCR_RE_POL		BIT(1)
36 #define DW_UART_TCR_DE_POL		BIT(2)
37 #define DW_UART_TCR_XFER_MODE		GENMASK(4, 3)
38 #define DW_UART_TCR_XFER_MODE_DE_DURING_RE	FIELD_PREP(DW_UART_TCR_XFER_MODE, 0)
39 #define DW_UART_TCR_XFER_MODE_SW_DE_OR_RE	FIELD_PREP(DW_UART_TCR_XFER_MODE, 1)
40 #define DW_UART_TCR_XFER_MODE_DE_OR_RE		FIELD_PREP(DW_UART_TCR_XFER_MODE, 2)
41 
42 /* Line Extended Control Register bits */
43 #define DW_UART_LCR_EXT_DLS_E		BIT(0)
44 #define DW_UART_LCR_EXT_ADDR_MATCH	BIT(1)
45 #define DW_UART_LCR_EXT_SEND_ADDR	BIT(2)
46 #define DW_UART_LCR_EXT_TRANSMIT_MODE	BIT(3)
47 
48 /* Component Parameter Register bits */
49 #define DW_UART_CPR_ABP_DATA_WIDTH	GENMASK(1, 0)
50 #define DW_UART_CPR_AFCE_MODE		BIT(4)
51 #define DW_UART_CPR_THRE_MODE		BIT(5)
52 #define DW_UART_CPR_SIR_MODE		BIT(6)
53 #define DW_UART_CPR_SIR_LP_MODE		BIT(7)
54 #define DW_UART_CPR_ADDITIONAL_FEATURES	BIT(8)
55 #define DW_UART_CPR_FIFO_ACCESS		BIT(9)
56 #define DW_UART_CPR_FIFO_STAT		BIT(10)
57 #define DW_UART_CPR_SHADOW		BIT(11)
58 #define DW_UART_CPR_ENCODED_PARMS	BIT(12)
59 #define DW_UART_CPR_DMA_EXTRA		BIT(13)
60 #define DW_UART_CPR_FIFO_MODE		GENMASK(23, 16)
61 
62 /* Helper for FIFO size calculation */
63 #define DW_UART_CPR_FIFO_SIZE(a)	(FIELD_GET(DW_UART_CPR_FIFO_MODE, (a)) * 16)
64 
65 /*
66  * divisor = div(I) + div(F)
67  * "I" means integer, "F" means fractional
68  * quot = div(I) = clk / (16 * baud)
69  * frac = div(F) * 2^dlf_size
70  *
71  * let rem = clk % (16 * baud)
72  * we have: div(F) * (16 * baud) = rem
73  * so frac = 2^dlf_size * rem / (16 * baud) = (rem << dlf_size) / (16 * baud)
74  */
75 static unsigned int dw8250_get_divisor(struct uart_port *p, unsigned int baud,
76 				       unsigned int *frac)
77 {
78 	unsigned int quot, rem, base_baud = baud * 16;
79 	struct dw8250_port_data *d = p->private_data;
80 
81 	quot = p->uartclk / base_baud;
82 	rem = p->uartclk % base_baud;
83 	*frac = DIV_ROUND_CLOSEST(rem << d->dlf_size, base_baud);
84 
85 	return quot;
86 }
87 
88 static void dw8250_set_divisor(struct uart_port *p, unsigned int baud,
89 			       unsigned int quot, unsigned int quot_frac)
90 {
91 	dw8250_writel_ext(p, DW_UART_DLF, quot_frac);
92 	serial8250_do_set_divisor(p, baud, quot, quot_frac);
93 }
94 
95 void dw8250_do_set_termios(struct uart_port *p, struct ktermios *termios, struct ktermios *old)
96 {
97 	p->status &= ~UPSTAT_AUTOCTS;
98 	if (termios->c_cflag & CRTSCTS)
99 		p->status |= UPSTAT_AUTOCTS;
100 
101 	serial8250_do_set_termios(p, termios, old);
102 
103 	/* Filter addresses which have 9th bit set */
104 	p->ignore_status_mask |= DW_UART_LSR_ADDR_RCVD;
105 	p->read_status_mask |= DW_UART_LSR_ADDR_RCVD;
106 }
107 EXPORT_SYMBOL_GPL(dw8250_do_set_termios);
108 
109 /*
110  * Wait until re is de-asserted for sure. An ongoing receive will keep
111  * re asserted until end of frame. Without BUSY indication available,
112  * only available course of action is to wait for the time it takes to
113  * receive one frame (there might nothing to receive but w/o BUSY the
114  * driver cannot know).
115  */
116 static void dw8250_wait_re_deassert(struct uart_port *p)
117 {
118 	ndelay(p->frame_time);
119 }
120 
121 static void dw8250_update_rar(struct uart_port *p, u32 addr)
122 {
123 	u32 re_en = dw8250_readl_ext(p, DW_UART_RE_EN);
124 
125 	/*
126 	 * RAR shouldn't be changed while receiving. Thus, de-assert RE_EN
127 	 * if asserted and wait.
128 	 */
129 	if (re_en)
130 		dw8250_writel_ext(p, DW_UART_RE_EN, 0);
131 	dw8250_wait_re_deassert(p);
132 	dw8250_writel_ext(p, DW_UART_RAR, addr);
133 	if (re_en)
134 		dw8250_writel_ext(p, DW_UART_RE_EN, re_en);
135 }
136 
137 static void dw8250_rs485_set_addr(struct uart_port *p, struct serial_rs485 *rs485,
138 				  struct ktermios *termios)
139 {
140 	u32 lcr = dw8250_readl_ext(p, DW_UART_LCR_EXT);
141 
142 	if (rs485->flags & SER_RS485_ADDRB) {
143 		lcr |= DW_UART_LCR_EXT_DLS_E;
144 		if (termios)
145 			termios->c_cflag |= ADDRB;
146 
147 		if (rs485->flags & SER_RS485_ADDR_RECV) {
148 			u32 delta = p->rs485.flags ^ rs485->flags;
149 
150 			/*
151 			 * rs485 (param) is equal to uart_port's rs485 only during init
152 			 * (during init, delta is not yet applicable).
153 			 */
154 			if (unlikely(&p->rs485 == rs485))
155 				delta = rs485->flags;
156 
157 			if ((delta & SER_RS485_ADDR_RECV) ||
158 			    (p->rs485.addr_recv != rs485->addr_recv))
159 				dw8250_update_rar(p, rs485->addr_recv);
160 			lcr |= DW_UART_LCR_EXT_ADDR_MATCH;
161 		} else {
162 			lcr &= ~DW_UART_LCR_EXT_ADDR_MATCH;
163 		}
164 		if (rs485->flags & SER_RS485_ADDR_DEST) {
165 			/*
166 			 * Don't skip writes here as another endpoint could
167 			 * have changed communication line's destination
168 			 * address in between.
169 			 */
170 			dw8250_writel_ext(p, DW_UART_TAR, rs485->addr_dest);
171 			lcr |= DW_UART_LCR_EXT_SEND_ADDR;
172 		}
173 	} else {
174 		lcr = 0;
175 	}
176 	dw8250_writel_ext(p, DW_UART_LCR_EXT, lcr);
177 }
178 
179 static int dw8250_rs485_config(struct uart_port *p, struct ktermios *termios,
180 			       struct serial_rs485 *rs485)
181 {
182 	u32 tcr;
183 
184 	tcr = dw8250_readl_ext(p, DW_UART_TCR);
185 	tcr &= ~DW_UART_TCR_XFER_MODE;
186 
187 	if (rs485->flags & SER_RS485_ENABLED) {
188 		tcr |= DW_UART_TCR_RS485_EN;
189 
190 		if (rs485->flags & SER_RS485_RX_DURING_TX)
191 			tcr |= DW_UART_TCR_XFER_MODE_DE_DURING_RE;
192 		else
193 			tcr |= DW_UART_TCR_XFER_MODE_DE_OR_RE;
194 		dw8250_writel_ext(p, DW_UART_DE_EN, 1);
195 		dw8250_writel_ext(p, DW_UART_RE_EN, 1);
196 	} else {
197 		if (termios)
198 			termios->c_cflag &= ~ADDRB;
199 
200 		tcr &= ~DW_UART_TCR_RS485_EN;
201 	}
202 
203 	/* Reset to default polarity */
204 	tcr |= DW_UART_TCR_DE_POL;
205 	tcr &= ~DW_UART_TCR_RE_POL;
206 
207 	if (!(rs485->flags & SER_RS485_RTS_ON_SEND))
208 		tcr &= ~DW_UART_TCR_DE_POL;
209 	if (device_property_read_bool(p->dev, "rs485-rx-active-high"))
210 		tcr |= DW_UART_TCR_RE_POL;
211 
212 	dw8250_writel_ext(p, DW_UART_TCR, tcr);
213 
214 	/* Addressing mode can only be set up after TCR */
215 	if (rs485->flags & SER_RS485_ENABLED)
216 		dw8250_rs485_set_addr(p, rs485, termios);
217 
218 	return 0;
219 }
220 
221 /*
222  * Tests if RE_EN register can have non-zero value to see if RS-485 HW support
223  * is present.
224  */
225 static bool dw8250_detect_rs485_hw(struct uart_port *p)
226 {
227 	u32 reg;
228 
229 	dw8250_writel_ext(p, DW_UART_RE_EN, 1);
230 	reg = dw8250_readl_ext(p, DW_UART_RE_EN);
231 	dw8250_writel_ext(p, DW_UART_RE_EN, 0);
232 	return reg;
233 }
234 
235 static const struct serial_rs485 dw8250_rs485_supported = {
236 	.flags = SER_RS485_ENABLED | SER_RS485_RX_DURING_TX | SER_RS485_RTS_ON_SEND |
237 		 SER_RS485_RTS_AFTER_SEND | SER_RS485_ADDRB | SER_RS485_ADDR_RECV |
238 		 SER_RS485_ADDR_DEST,
239 };
240 
241 void dw8250_setup_port(struct uart_port *p)
242 {
243 	struct dw8250_port_data *pd = p->private_data;
244 	struct dw8250_data *data = to_dw8250_data(pd);
245 	struct uart_8250_port *up = up_to_u8250p(p);
246 	u32 reg;
247 
248 	pd->hw_rs485_support = dw8250_detect_rs485_hw(p);
249 	if (pd->hw_rs485_support) {
250 		p->rs485_config = dw8250_rs485_config;
251 		up->lsr_save_mask = LSR_SAVE_FLAGS | DW_UART_LSR_ADDR_RCVD;
252 		p->rs485_supported = dw8250_rs485_supported;
253 	} else {
254 		p->rs485_config = serial8250_em485_config;
255 		p->rs485_supported = serial8250_em485_supported;
256 		up->rs485_start_tx = serial8250_em485_start_tx;
257 		up->rs485_stop_tx = serial8250_em485_stop_tx;
258 	}
259 	up->capabilities |= UART_CAP_NOTEMT;
260 
261 	/*
262 	 * If the Component Version Register returns zero, we know that
263 	 * ADDITIONAL_FEATURES are not enabled. No need to go any further.
264 	 */
265 	reg = dw8250_readl_ext(p, DW_UART_UCV);
266 	if (!reg)
267 		return;
268 
269 	dev_dbg(p->dev, "Designware UART version %c.%c%c\n",
270 		(reg >> 24) & 0xff, (reg >> 16) & 0xff, (reg >> 8) & 0xff);
271 
272 	dw8250_writel_ext(p, DW_UART_DLF, ~0U);
273 	reg = dw8250_readl_ext(p, DW_UART_DLF);
274 	dw8250_writel_ext(p, DW_UART_DLF, 0);
275 
276 	if (reg) {
277 		pd->dlf_size = fls(reg);
278 		p->get_divisor = dw8250_get_divisor;
279 		p->set_divisor = dw8250_set_divisor;
280 	}
281 
282 	reg = dw8250_readl_ext(p, DW_UART_CPR);
283 	if (!reg) {
284 		reg = data->pdata->cpr_val;
285 		dev_dbg(p->dev, "CPR is not available, using 0x%08x instead\n", reg);
286 	}
287 	if (!reg)
288 		return;
289 
290 	/* Select the type based on FIFO */
291 	if (reg & DW_UART_CPR_FIFO_MODE) {
292 		p->type = PORT_16550A;
293 		p->flags |= UPF_FIXED_TYPE;
294 		p->fifosize = DW_UART_CPR_FIFO_SIZE(reg);
295 		up->capabilities = UART_CAP_FIFO | UART_CAP_NOTEMT;
296 	}
297 
298 	if (reg & DW_UART_CPR_AFCE_MODE)
299 		up->capabilities |= UART_CAP_AFE;
300 
301 	if (reg & DW_UART_CPR_SIR_MODE)
302 		up->capabilities |= UART_CAP_IRDA;
303 }
304 EXPORT_SYMBOL_GPL(dw8250_setup_port);
305