xref: /freebsd/sys/dev/usb/serial/uchcom.c (revision ca48e43ba9ee73a07cdbad8365117793b01273bb)
1 /*	$NetBSD: uchcom.c,v 1.1 2007/09/03 17:57:37 tshiozak Exp $	*/
2 
3 /*-
4  * SPDX-License-Identifier: BSD-2-Clause
5  *
6  * Copyright (c) 2007, Takanori Watanabe
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  */
30 
31 /*
32  * Copyright (c) 2007 The NetBSD Foundation, Inc.
33  * All rights reserved.
34  *
35  * This code is derived from software contributed to The NetBSD Foundation
36  * by Takuya SHIOZAKI (tshiozak@netbsd.org).
37  *
38  * Redistribution and use in source and binary forms, with or without
39  * modification, are permitted provided that the following conditions
40  * are met:
41  * 1. Redistributions of source code must retain the above copyright
42  *    notice, this list of conditions and the following disclaimer.
43  * 2. Redistributions in binary form must reproduce the above copyright
44  *    notice, this list of conditions and the following disclaimer in the
45  *    documentation and/or other materials provided with the distribution.
46  *
47  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
48  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
49  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
50  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
51  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
52  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
53  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
54  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
55  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
56  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
57  * POSSIBILITY OF SUCH DAMAGE.
58  */
59 
60 /*
61  * Driver for WinChipHead CH341/340, the worst USB-serial chip in the
62  * world.
63  */
64 
65 #include <sys/stdint.h>
66 #include <sys/stddef.h>
67 #include <sys/param.h>
68 #include <sys/queue.h>
69 #include <sys/types.h>
70 #include <sys/systm.h>
71 #include <sys/kernel.h>
72 #include <sys/bus.h>
73 #include <sys/module.h>
74 #include <sys/lock.h>
75 #include <sys/mutex.h>
76 #include <sys/condvar.h>
77 #include <sys/sysctl.h>
78 #include <sys/sx.h>
79 #include <sys/unistd.h>
80 #include <sys/callout.h>
81 #include <sys/malloc.h>
82 #include <sys/priv.h>
83 
84 #include <dev/usb/usb.h>
85 #include <dev/usb/usbdi.h>
86 #include <dev/usb/usbdi_util.h>
87 #include "usbdevs.h"
88 
89 #define	USB_DEBUG_VAR uchcom_debug
90 #include <dev/usb/usb_debug.h>
91 #include <dev/usb/usb_process.h>
92 
93 #include <dev/usb/serial/usb_serial.h>
94 
95 #ifdef USB_DEBUG
96 static int uchcom_debug = 0;
97 
98 static SYSCTL_NODE(_hw_usb, OID_AUTO, uchcom, CTLFLAG_RW | CTLFLAG_MPSAFE, 0,
99     "USB uchcom");
100 SYSCTL_INT(_hw_usb_uchcom, OID_AUTO, debug, CTLFLAG_RWTUN,
101     &uchcom_debug, 0, "uchcom debug level");
102 #endif
103 
104 #define	UCHCOM_IFACE_INDEX	0
105 #define	UCHCOM_CONFIG_INDEX	0
106 
107 #define	UCHCOM_REV_CH340	0x0250
108 #define	UCHCOM_INPUT_BUF_SIZE	8
109 
110 #define	UCHCOM_REQ_GET_VERSION	0x5F
111 #define	UCHCOM_REQ_READ_REG	0x95
112 #define	UCHCOM_REQ_WRITE_REG	0x9A
113 #define	UCHCOM_REQ_RESET	0xA1
114 #define	UCHCOM_REQ_SET_DTRRTS	0xA4
115 
116 #define	UCHCOM_REG_STAT1	0x06
117 #define	UCHCOM_REG_STAT2	0x07
118 #define	UCHCOM_REG_BPS_PRE	0x12
119 #define	UCHCOM_REG_BPS_DIV	0x13
120 #define	UCHCOM_REG_BPS_MOD	0x14
121 #define	UCHCOM_REG_BPS_PAD	0x0F
122 #define	UCHCOM_REG_BREAK1	0x05
123 #define	UCHCOM_REG_LCR1		0x18
124 #define	UCHCOM_REG_LCR2		0x25
125 
126 #define	UCHCOM_VER_20		0x20
127 #define	UCHCOM_VER_30		0x30
128 
129 #define	UCHCOM_BASE_UNKNOWN	0
130 #define	UCHCOM_BPS_MOD_BASE	20000000
131 #define	UCHCOM_BPS_MOD_BASE_OFS	1100
132 
133 #define	UCHCOM_DTR_MASK		0x20
134 #define	UCHCOM_RTS_MASK		0x40
135 
136 #define	UCHCOM_BRK_MASK		0x01
137 
138 #define	UCHCOM_LCR1_MASK	0xAF
139 #define	UCHCOM_LCR2_MASK	0x07
140 #define	UCHCOM_LCR1_RX		0x80
141 #define	UCHCOM_LCR1_TX		0x40
142 #define	UCHCOM_LCR1_PARENB	0x08
143 #define	UCHCOM_LCR1_CS8		0x03
144 #define	UCHCOM_LCR2_PAREVEN	0x07
145 #define	UCHCOM_LCR2_PARODD	0x06
146 #define	UCHCOM_LCR2_PARMARK	0x05
147 #define	UCHCOM_LCR2_PARSPACE	0x04
148 
149 #define	UCHCOM_INTR_STAT1	0x02
150 #define	UCHCOM_INTR_STAT2	0x03
151 #define	UCHCOM_INTR_LEAST	4
152 
153 #define	UCHCOM_BULK_BUF_SIZE 1024	/* bytes */
154 
155 enum {
156 	UCHCOM_BULK_DT_WR,
157 	UCHCOM_BULK_DT_RD,
158 	UCHCOM_INTR_DT_RD,
159 	UCHCOM_N_TRANSFER,
160 };
161 
162 struct uchcom_softc {
163 	struct ucom_super_softc sc_super_ucom;
164 	struct ucom_softc sc_ucom;
165 
166 	struct usb_xfer *sc_xfer[UCHCOM_N_TRANSFER];
167 	struct usb_device *sc_udev;
168 	struct mtx sc_mtx;
169 
170 	uint8_t	sc_dtr;			/* local copy */
171 	uint8_t	sc_rts;			/* local copy */
172 	uint8_t	sc_version;
173 	uint8_t	sc_msr;
174 	uint8_t	sc_lsr;			/* local status register */
175 };
176 
177 struct uchcom_divider {
178 	uint8_t	dv_prescaler;
179 	uint8_t	dv_div;
180 	uint8_t	dv_mod;
181 };
182 
183 struct uchcom_divider_record {
184 	uint32_t dvr_high;
185 	uint32_t dvr_low;
186 	uint32_t dvr_base_clock;
187 	struct uchcom_divider dvr_divider;
188 };
189 
190 static const struct uchcom_divider_record dividers[] =
191 {
192 	{307200, 307200, UCHCOM_BASE_UNKNOWN, {7, 0xD9, 0}},
193 	{921600, 921600, UCHCOM_BASE_UNKNOWN, {7, 0xF3, 0}},
194 	{2999999, 23530, 6000000, {3, 0, 0}},
195 	{23529, 2942, 750000, {2, 0, 0}},
196 	{2941, 368, 93750, {1, 0, 0}},
197 	{367, 1, 11719, {0, 0, 0}},
198 };
199 
200 #define	NUM_DIVIDERS	nitems(dividers)
201 
202 static const STRUCT_USB_HOST_ID uchcom_devs[] = {
203 	{USB_VPI(USB_VENDOR_WCH, USB_PRODUCT_WCH_CH341SER, 0)},
204 	{USB_VPI(USB_VENDOR_WCH2, USB_PRODUCT_WCH2_CH341SER, 0)},
205 	{USB_VPI(USB_VENDOR_WCH2, USB_PRODUCT_WCH2_CH341SER_2, 0)},
206 	{USB_VPI(USB_VENDOR_WCH2, USB_PRODUCT_WCH2_CH341SER_3, 0)},
207 };
208 
209 /* protypes */
210 
211 static void	uchcom_free(struct ucom_softc *);
212 static int	uchcom_pre_param(struct ucom_softc *, struct termios *);
213 static void	uchcom_cfg_get_status(struct ucom_softc *, uint8_t *,
214 		    uint8_t *);
215 static void	uchcom_cfg_open(struct ucom_softc *ucom);
216 static void	uchcom_cfg_param(struct ucom_softc *, struct termios *);
217 static void	uchcom_cfg_set_break(struct ucom_softc *, uint8_t);
218 static void	uchcom_cfg_set_dtr(struct ucom_softc *, uint8_t);
219 static void	uchcom_cfg_set_rts(struct ucom_softc *, uint8_t);
220 static void	uchcom_start_read(struct ucom_softc *);
221 static void	uchcom_start_write(struct ucom_softc *);
222 static void	uchcom_stop_read(struct ucom_softc *);
223 static void	uchcom_stop_write(struct ucom_softc *);
224 static void	uchcom_update_version(struct uchcom_softc *);
225 static void	uchcom_convert_status(struct uchcom_softc *, uint8_t);
226 static void	uchcom_update_status(struct uchcom_softc *);
227 static void	uchcom_set_dtr_rts(struct uchcom_softc *);
228 static int	uchcom_calc_divider_settings(struct uchcom_divider *, uint32_t);
229 static void	uchcom_set_baudrate(struct uchcom_softc *, uint32_t);
230 static void	uchcom_poll(struct ucom_softc *ucom);
231 
232 static device_probe_t uchcom_probe;
233 static device_attach_t uchcom_attach;
234 static device_detach_t uchcom_detach;
235 static void uchcom_free_softc(struct uchcom_softc *);
236 
237 static usb_callback_t uchcom_intr_callback;
238 static usb_callback_t uchcom_write_callback;
239 static usb_callback_t uchcom_read_callback;
240 
241 static const struct usb_config uchcom_config_data[UCHCOM_N_TRANSFER] = {
242 	[UCHCOM_BULK_DT_WR] = {
243 		.type = UE_BULK,
244 		.endpoint = UE_ADDR_ANY,
245 		.direction = UE_DIR_OUT,
246 		.bufsize = UCHCOM_BULK_BUF_SIZE,
247 		.flags = {.pipe_bof = 1,.force_short_xfer = 1,},
248 		.callback = &uchcom_write_callback,
249 	},
250 
251 	[UCHCOM_BULK_DT_RD] = {
252 		.type = UE_BULK,
253 		.endpoint = UE_ADDR_ANY,
254 		.direction = UE_DIR_IN,
255 		.bufsize = UCHCOM_BULK_BUF_SIZE,
256 		.flags = {.pipe_bof = 1,.short_xfer_ok = 1,},
257 		.callback = &uchcom_read_callback,
258 	},
259 
260 	[UCHCOM_INTR_DT_RD] = {
261 		.type = UE_INTERRUPT,
262 		.endpoint = UE_ADDR_ANY,
263 		.direction = UE_DIR_IN,
264 		.flags = {.pipe_bof = 1,.short_xfer_ok = 1,},
265 		.bufsize = 0,	/* use wMaxPacketSize */
266 		.callback = &uchcom_intr_callback,
267 	},
268 };
269 
270 static struct ucom_callback uchcom_callback = {
271 	.ucom_cfg_get_status = &uchcom_cfg_get_status,
272 	.ucom_cfg_set_dtr = &uchcom_cfg_set_dtr,
273 	.ucom_cfg_set_rts = &uchcom_cfg_set_rts,
274 	.ucom_cfg_set_break = &uchcom_cfg_set_break,
275 	.ucom_cfg_open = &uchcom_cfg_open,
276 	.ucom_cfg_param = &uchcom_cfg_param,
277 	.ucom_pre_param = &uchcom_pre_param,
278 	.ucom_start_read = &uchcom_start_read,
279 	.ucom_stop_read = &uchcom_stop_read,
280 	.ucom_start_write = &uchcom_start_write,
281 	.ucom_stop_write = &uchcom_stop_write,
282 	.ucom_poll = &uchcom_poll,
283 	.ucom_free = &uchcom_free,
284 };
285 
286 /* ----------------------------------------------------------------------
287  * driver entry points
288  */
289 
290 static int
uchcom_probe(device_t dev)291 uchcom_probe(device_t dev)
292 {
293 	struct usb_attach_arg *uaa = device_get_ivars(dev);
294 
295 	DPRINTFN(11, "\n");
296 
297 	if (uaa->usb_mode != USB_MODE_HOST) {
298 		return (ENXIO);
299 	}
300 	if (uaa->info.bConfigIndex != UCHCOM_CONFIG_INDEX) {
301 		return (ENXIO);
302 	}
303 	if (uaa->info.bIfaceIndex != UCHCOM_IFACE_INDEX) {
304 		return (ENXIO);
305 	}
306 	return (usbd_lookup_id_by_uaa(uchcom_devs, sizeof(uchcom_devs), uaa));
307 }
308 
309 static int
uchcom_attach(device_t dev)310 uchcom_attach(device_t dev)
311 {
312 	struct uchcom_softc *sc = device_get_softc(dev);
313 	struct usb_attach_arg *uaa = device_get_ivars(dev);
314 	int error;
315 	uint8_t iface_index;
316 
317 	DPRINTFN(11, "\n");
318 
319 	device_set_usb_desc(dev);
320 	mtx_init(&sc->sc_mtx, "uchcom", NULL, MTX_DEF);
321 	ucom_ref(&sc->sc_super_ucom);
322 
323 	sc->sc_udev = uaa->device;
324 
325 	switch (uaa->info.idProduct) {
326 	case USB_PRODUCT_WCH2_CH341SER:
327 		device_printf(dev, "CH340 detected\n");
328 		break;
329 	case USB_PRODUCT_WCH2_CH341SER_2:
330 	case USB_PRODUCT_WCH2_CH341SER_3:
331 		device_printf(dev, "CH341 detected\n");
332 		break;
333 	default:
334 		device_printf(dev, "New CH340/CH341 product 0x%04x detected\n",
335 		    uaa->info.idProduct);
336 		break;
337 	}
338 
339 	iface_index = UCHCOM_IFACE_INDEX;
340 	error = usbd_transfer_setup(uaa->device,
341 	    &iface_index, sc->sc_xfer, uchcom_config_data,
342 	    UCHCOM_N_TRANSFER, sc, &sc->sc_mtx);
343 
344 	if (error) {
345 		DPRINTF("one or more missing USB endpoints, "
346 		    "error=%s\n", usbd_errstr(error));
347 		goto detach;
348 	}
349 
350 	/* clear stall at first run */
351 	mtx_lock(&sc->sc_mtx);
352 	usbd_xfer_set_stall(sc->sc_xfer[UCHCOM_BULK_DT_WR]);
353 	usbd_xfer_set_stall(sc->sc_xfer[UCHCOM_BULK_DT_RD]);
354 	mtx_unlock(&sc->sc_mtx);
355 
356 	error = ucom_attach(&sc->sc_super_ucom, &sc->sc_ucom, 1, sc,
357 	    &uchcom_callback, &sc->sc_mtx);
358 	if (error) {
359 		goto detach;
360 	}
361 	ucom_set_pnpinfo_usb(&sc->sc_super_ucom, dev);
362 
363 	return (0);
364 
365 detach:
366 	uchcom_detach(dev);
367 	return (ENXIO);
368 }
369 
370 static int
uchcom_detach(device_t dev)371 uchcom_detach(device_t dev)
372 {
373 	struct uchcom_softc *sc = device_get_softc(dev);
374 
375 	DPRINTFN(11, "\n");
376 
377 	ucom_detach(&sc->sc_super_ucom, &sc->sc_ucom);
378 	usbd_transfer_unsetup(sc->sc_xfer, UCHCOM_N_TRANSFER);
379 
380 	device_claim_softc(dev);
381 
382 	uchcom_free_softc(sc);
383 
384 	return (0);
385 }
386 
387 UCOM_UNLOAD_DRAIN(uchcom);
388 
389 static void
uchcom_free_softc(struct uchcom_softc * sc)390 uchcom_free_softc(struct uchcom_softc *sc)
391 {
392 	if (ucom_unref(&sc->sc_super_ucom)) {
393 		mtx_destroy(&sc->sc_mtx);
394 		device_free_softc(sc);
395 	}
396 }
397 
398 static void
uchcom_free(struct ucom_softc * ucom)399 uchcom_free(struct ucom_softc *ucom)
400 {
401 	uchcom_free_softc(ucom->sc_parent);
402 }
403 
404 /* ----------------------------------------------------------------------
405  * low level i/o
406  */
407 
408 static void
uchcom_ctrl_write(struct uchcom_softc * sc,uint8_t reqno,uint16_t value,uint16_t index)409 uchcom_ctrl_write(struct uchcom_softc *sc, uint8_t reqno,
410     uint16_t value, uint16_t index)
411 {
412 	struct usb_device_request req;
413 
414 	req.bmRequestType = UT_WRITE_VENDOR_DEVICE;
415 	req.bRequest = reqno;
416 	USETW(req.wValue, value);
417 	USETW(req.wIndex, index);
418 	USETW(req.wLength, 0);
419 
420 	DPRINTF("WR REQ 0x%02X VAL 0x%04X IDX 0x%04X\n",
421 	    reqno, value, index);
422 	ucom_cfg_do_request(sc->sc_udev,
423 	    &sc->sc_ucom, &req, NULL, 0, 1000);
424 }
425 
426 static void
uchcom_ctrl_read(struct uchcom_softc * sc,uint8_t reqno,uint16_t value,uint16_t index,void * buf,uint16_t buflen)427 uchcom_ctrl_read(struct uchcom_softc *sc, uint8_t reqno,
428     uint16_t value, uint16_t index, void *buf, uint16_t buflen)
429 {
430 	struct usb_device_request req;
431 
432 	req.bmRequestType = UT_READ_VENDOR_DEVICE;
433 	req.bRequest = reqno;
434 	USETW(req.wValue, value);
435 	USETW(req.wIndex, index);
436 	USETW(req.wLength, buflen);
437 
438 	DPRINTF("RD REQ 0x%02X VAL 0x%04X IDX 0x%04X LEN %d\n",
439 	    reqno, value, index, buflen);
440 	ucom_cfg_do_request(sc->sc_udev,
441 	    &sc->sc_ucom, &req, buf, USB_SHORT_XFER_OK, 1000);
442 }
443 
444 static void
uchcom_write_reg(struct uchcom_softc * sc,uint8_t reg1,uint8_t val1,uint8_t reg2,uint8_t val2)445 uchcom_write_reg(struct uchcom_softc *sc,
446     uint8_t reg1, uint8_t val1, uint8_t reg2, uint8_t val2)
447 {
448 	DPRINTF("0x%02X<-0x%02X, 0x%02X<-0x%02X\n",
449 	    (unsigned)reg1, (unsigned)val1,
450 	    (unsigned)reg2, (unsigned)val2);
451 	uchcom_ctrl_write(
452 	    sc, UCHCOM_REQ_WRITE_REG,
453 	    reg1 | ((uint16_t)reg2 << 8), val1 | ((uint16_t)val2 << 8));
454 }
455 
456 static void
uchcom_read_reg(struct uchcom_softc * sc,uint8_t reg1,uint8_t * rval1,uint8_t reg2,uint8_t * rval2)457 uchcom_read_reg(struct uchcom_softc *sc,
458     uint8_t reg1, uint8_t *rval1, uint8_t reg2, uint8_t *rval2)
459 {
460 	uint8_t buf[UCHCOM_INPUT_BUF_SIZE];
461 
462 	uchcom_ctrl_read(
463 	    sc, UCHCOM_REQ_READ_REG,
464 	    reg1 | ((uint16_t)reg2 << 8), 0, buf, sizeof(buf));
465 
466 	DPRINTF("0x%02X->0x%02X, 0x%02X->0x%02X\n",
467 	    (unsigned)reg1, (unsigned)buf[0],
468 	    (unsigned)reg2, (unsigned)buf[1]);
469 
470 	if (rval1)
471 		*rval1 = buf[0];
472 	if (rval2)
473 		*rval2 = buf[1];
474 }
475 
476 static void
uchcom_get_version(struct uchcom_softc * sc,uint8_t * rver)477 uchcom_get_version(struct uchcom_softc *sc, uint8_t *rver)
478 {
479 	uint8_t buf[UCHCOM_INPUT_BUF_SIZE];
480 
481 	uchcom_ctrl_read(sc, UCHCOM_REQ_GET_VERSION, 0, 0, buf, sizeof(buf));
482 
483 	if (rver)
484 		*rver = buf[0];
485 }
486 
487 static void
uchcom_get_status(struct uchcom_softc * sc,uint8_t * rval)488 uchcom_get_status(struct uchcom_softc *sc, uint8_t *rval)
489 {
490 	uchcom_read_reg(sc, UCHCOM_REG_STAT1, rval, UCHCOM_REG_STAT2, NULL);
491 }
492 
493 static void
uchcom_set_dtr_rts_10(struct uchcom_softc * sc,uint8_t val)494 uchcom_set_dtr_rts_10(struct uchcom_softc *sc, uint8_t val)
495 {
496 	uchcom_write_reg(sc, UCHCOM_REG_STAT1, val, UCHCOM_REG_STAT1, val);
497 }
498 
499 static void
uchcom_set_dtr_rts_20(struct uchcom_softc * sc,uint8_t val)500 uchcom_set_dtr_rts_20(struct uchcom_softc *sc, uint8_t val)
501 {
502 	uchcom_ctrl_write(sc, UCHCOM_REQ_SET_DTRRTS, val, 0);
503 }
504 
505 /* ----------------------------------------------------------------------
506  * middle layer
507  */
508 
509 static void
uchcom_update_version(struct uchcom_softc * sc)510 uchcom_update_version(struct uchcom_softc *sc)
511 {
512 	uchcom_get_version(sc, &sc->sc_version);
513 	DPRINTF("Chip version: 0x%02x\n", sc->sc_version);
514 }
515 
516 static void
uchcom_convert_status(struct uchcom_softc * sc,uint8_t cur)517 uchcom_convert_status(struct uchcom_softc *sc, uint8_t cur)
518 {
519 	sc->sc_dtr = !(cur & UCHCOM_DTR_MASK);
520 	sc->sc_rts = !(cur & UCHCOM_RTS_MASK);
521 
522 	cur = ~cur & 0x0F;
523 	sc->sc_msr = (cur << 4) | ((sc->sc_msr >> 4) ^ cur);
524 }
525 
526 static void
uchcom_update_status(struct uchcom_softc * sc)527 uchcom_update_status(struct uchcom_softc *sc)
528 {
529 	uint8_t cur;
530 
531 	uchcom_get_status(sc, &cur);
532 	uchcom_convert_status(sc, cur);
533 }
534 
535 static void
uchcom_set_dtr_rts(struct uchcom_softc * sc)536 uchcom_set_dtr_rts(struct uchcom_softc *sc)
537 {
538 	uint8_t val = 0;
539 
540 	if (sc->sc_dtr)
541 		val |= UCHCOM_DTR_MASK;
542 	if (sc->sc_rts)
543 		val |= UCHCOM_RTS_MASK;
544 
545 	if (sc->sc_version < UCHCOM_VER_20)
546 		uchcom_set_dtr_rts_10(sc, ~val);
547 	else
548 		uchcom_set_dtr_rts_20(sc, ~val);
549 }
550 
551 static void
uchcom_cfg_set_break(struct ucom_softc * ucom,uint8_t onoff)552 uchcom_cfg_set_break(struct ucom_softc *ucom, uint8_t onoff)
553 {
554 	struct uchcom_softc *sc = ucom->sc_parent;
555 	uint8_t brk1;
556 	uint8_t brk2;
557 
558 	uchcom_read_reg(sc, UCHCOM_REG_BREAK1, &brk1, UCHCOM_REG_LCR1, &brk2);
559 	if (onoff) {
560 		/* on - clear bits */
561 		brk1 &= ~UCHCOM_BRK_MASK;
562 		brk2 &= ~UCHCOM_LCR1_TX;
563 	} else {
564 		/* off - set bits */
565 		brk1 |= UCHCOM_BRK_MASK;
566 		brk2 |= UCHCOM_LCR1_TX;
567 	}
568 	uchcom_write_reg(sc, UCHCOM_REG_BREAK1, brk1, UCHCOM_REG_LCR1, brk2);
569 }
570 
571 static int
uchcom_calc_divider_settings(struct uchcom_divider * dp,uint32_t rate)572 uchcom_calc_divider_settings(struct uchcom_divider *dp, uint32_t rate)
573 {
574 	const struct uchcom_divider_record *rp;
575 	uint32_t div;
576 	uint32_t rem;
577 	uint32_t mod;
578 	uint8_t i;
579 
580 	/* find record */
581 	for (i = 0; i != NUM_DIVIDERS; i++) {
582 		if (dividers[i].dvr_high >= rate &&
583 		    dividers[i].dvr_low <= rate) {
584 			rp = &dividers[i];
585 			goto found;
586 		}
587 	}
588 	return (-1);
589 
590 found:
591 	dp->dv_prescaler = rp->dvr_divider.dv_prescaler;
592 	if (rp->dvr_base_clock == UCHCOM_BASE_UNKNOWN)
593 		dp->dv_div = rp->dvr_divider.dv_div;
594 	else {
595 		div = rp->dvr_base_clock / rate;
596 		rem = rp->dvr_base_clock % rate;
597 		if (div == 0 || div >= 0xFF)
598 			return (-1);
599 		if ((rem << 1) >= rate)
600 			div += 1;
601 		dp->dv_div = (uint8_t)-div;
602 	}
603 
604 	mod = (UCHCOM_BPS_MOD_BASE / rate) + UCHCOM_BPS_MOD_BASE_OFS;
605 	mod = mod + (mod / 2);
606 
607 	dp->dv_mod = (mod + 0xFF) / 0x100;
608 
609 	return (0);
610 }
611 
612 static void
uchcom_set_baudrate(struct uchcom_softc * sc,uint32_t rate)613 uchcom_set_baudrate(struct uchcom_softc *sc, uint32_t rate)
614 {
615 	struct uchcom_divider dv;
616 
617 	if (uchcom_calc_divider_settings(&dv, rate))
618 		return;
619 
620 	/*
621 	 * According to linux code we need to set bit 7 of UCHCOM_REG_BPS_PRE,
622 	 * otherwise the chip will buffer data.
623 	 */
624 	uchcom_write_reg(sc,
625 	    UCHCOM_REG_BPS_PRE, dv.dv_prescaler | 0x80,
626 	    UCHCOM_REG_BPS_DIV, dv.dv_div);
627 	uchcom_write_reg(sc,
628 	    UCHCOM_REG_BPS_MOD, dv.dv_mod,
629 	    UCHCOM_REG_BPS_PAD, 0);
630 }
631 
632 /* ----------------------------------------------------------------------
633  * methods for ucom
634  */
635 static void
uchcom_cfg_get_status(struct ucom_softc * ucom,uint8_t * lsr,uint8_t * msr)636 uchcom_cfg_get_status(struct ucom_softc *ucom, uint8_t *lsr, uint8_t *msr)
637 {
638 	struct uchcom_softc *sc = ucom->sc_parent;
639 
640 	DPRINTF("\n");
641 
642 	/* XXX Note: sc_lsr is always zero */
643 	*lsr = sc->sc_lsr;
644 	*msr = sc->sc_msr;
645 }
646 
647 static void
uchcom_cfg_set_dtr(struct ucom_softc * ucom,uint8_t onoff)648 uchcom_cfg_set_dtr(struct ucom_softc *ucom, uint8_t onoff)
649 {
650 	struct uchcom_softc *sc = ucom->sc_parent;
651 
652 	DPRINTF("onoff = %d\n", onoff);
653 
654 	sc->sc_dtr = onoff;
655 	uchcom_set_dtr_rts(sc);
656 }
657 
658 static void
uchcom_cfg_set_rts(struct ucom_softc * ucom,uint8_t onoff)659 uchcom_cfg_set_rts(struct ucom_softc *ucom, uint8_t onoff)
660 {
661 	struct uchcom_softc *sc = ucom->sc_parent;
662 
663 	DPRINTF("onoff = %d\n", onoff);
664 
665 	sc->sc_rts = onoff;
666 	uchcom_set_dtr_rts(sc);
667 }
668 
669 static void
uchcom_cfg_open(struct ucom_softc * ucom)670 uchcom_cfg_open(struct ucom_softc *ucom)
671 {
672 	struct uchcom_softc *sc = ucom->sc_parent;
673 
674 	DPRINTF("\n");
675 
676 	uchcom_update_version(sc);
677 	uchcom_update_status(sc);
678 }
679 
680 static int
uchcom_pre_param(struct ucom_softc * ucom,struct termios * t)681 uchcom_pre_param(struct ucom_softc *ucom, struct termios *t)
682 {
683 	struct uchcom_divider dv;
684 
685 	switch (t->c_cflag & CSIZE) {
686 	case CS8:
687 		break;
688 	default:
689 		return (EIO);
690 	}
691 	if ((t->c_cflag & CSTOPB) != 0)
692 		return (EIO);
693 	if ((t->c_cflag & PARENB) != 0)
694 		return (EIO);
695 
696 	if (uchcom_calc_divider_settings(&dv, t->c_ospeed)) {
697 		return (EIO);
698 	}
699 	return (0);			/* success */
700 }
701 
702 static void
uchcom_cfg_param(struct ucom_softc * ucom,struct termios * t)703 uchcom_cfg_param(struct ucom_softc *ucom, struct termios *t)
704 {
705 	struct uchcom_softc *sc = ucom->sc_parent;
706 
707 	uchcom_get_version(sc, NULL);
708 	uchcom_ctrl_write(sc, UCHCOM_REQ_RESET, 0, 0);
709 	uchcom_set_baudrate(sc, t->c_ospeed);
710 	if (sc->sc_version < UCHCOM_VER_30) {
711 		uchcom_read_reg(sc, UCHCOM_REG_LCR1, NULL,
712 		    UCHCOM_REG_LCR2, NULL);
713 		uchcom_write_reg(sc, UCHCOM_REG_LCR1, 0x50,
714 		    UCHCOM_REG_LCR2, 0x00);
715 	} else {
716 		/*
717 		 * Set up line control:
718 		 * - enable transmit and receive
719 		 * - set 8n1 mode
720 		 * To do: support other sizes, parity, stop bits.
721 		 */
722 		uchcom_write_reg(sc,
723 		    UCHCOM_REG_LCR1,
724 		    UCHCOM_LCR1_RX | UCHCOM_LCR1_TX | UCHCOM_LCR1_CS8,
725 		    UCHCOM_REG_LCR2, 0x00);
726 	}
727 	uchcom_update_status(sc);
728 	uchcom_ctrl_write(sc, UCHCOM_REQ_RESET, 0x501f, 0xd90a);
729 	uchcom_set_baudrate(sc, t->c_ospeed);
730 	uchcom_set_dtr_rts(sc);
731 	uchcom_update_status(sc);
732 }
733 
734 static void
uchcom_start_read(struct ucom_softc * ucom)735 uchcom_start_read(struct ucom_softc *ucom)
736 {
737 	struct uchcom_softc *sc = ucom->sc_parent;
738 
739 	/* start interrupt endpoint */
740 	usbd_transfer_start(sc->sc_xfer[UCHCOM_INTR_DT_RD]);
741 
742 	/* start read endpoint */
743 	usbd_transfer_start(sc->sc_xfer[UCHCOM_BULK_DT_RD]);
744 }
745 
746 static void
uchcom_stop_read(struct ucom_softc * ucom)747 uchcom_stop_read(struct ucom_softc *ucom)
748 {
749 	struct uchcom_softc *sc = ucom->sc_parent;
750 
751 	/* stop interrupt endpoint */
752 	usbd_transfer_stop(sc->sc_xfer[UCHCOM_INTR_DT_RD]);
753 
754 	/* stop read endpoint */
755 	usbd_transfer_stop(sc->sc_xfer[UCHCOM_BULK_DT_RD]);
756 }
757 
758 static void
uchcom_start_write(struct ucom_softc * ucom)759 uchcom_start_write(struct ucom_softc *ucom)
760 {
761 	struct uchcom_softc *sc = ucom->sc_parent;
762 
763 	usbd_transfer_start(sc->sc_xfer[UCHCOM_BULK_DT_WR]);
764 }
765 
766 static void
uchcom_stop_write(struct ucom_softc * ucom)767 uchcom_stop_write(struct ucom_softc *ucom)
768 {
769 	struct uchcom_softc *sc = ucom->sc_parent;
770 
771 	usbd_transfer_stop(sc->sc_xfer[UCHCOM_BULK_DT_WR]);
772 }
773 
774 /* ----------------------------------------------------------------------
775  * callback when the modem status is changed.
776  */
777 static void
uchcom_intr_callback(struct usb_xfer * xfer,usb_error_t error)778 uchcom_intr_callback(struct usb_xfer *xfer, usb_error_t error)
779 {
780 	struct uchcom_softc *sc = usbd_xfer_softc(xfer);
781 	struct usb_page_cache *pc;
782 	uint8_t buf[UCHCOM_INTR_LEAST];
783 	int actlen;
784 
785 	usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL);
786 
787 	switch (USB_GET_STATE(xfer)) {
788 	case USB_ST_TRANSFERRED:
789 
790 		DPRINTF("actlen = %u\n", actlen);
791 
792 		if (actlen >= UCHCOM_INTR_LEAST) {
793 			pc = usbd_xfer_get_frame(xfer, 0);
794 			usbd_copy_out(pc, 0, buf, UCHCOM_INTR_LEAST);
795 
796 			DPRINTF("data = 0x%02X 0x%02X 0x%02X 0x%02X\n",
797 			    (unsigned)buf[0], (unsigned)buf[1],
798 			    (unsigned)buf[2], (unsigned)buf[3]);
799 
800 			uchcom_convert_status(sc, buf[UCHCOM_INTR_STAT1]);
801 			ucom_status_change(&sc->sc_ucom);
802 		}
803 	case USB_ST_SETUP:
804 tr_setup:
805 		usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
806 		usbd_transfer_submit(xfer);
807 		break;
808 
809 	default:			/* Error */
810 		if (error != USB_ERR_CANCELLED) {
811 			/* try to clear stall first */
812 			usbd_xfer_set_stall(xfer);
813 			goto tr_setup;
814 		}
815 		break;
816 	}
817 }
818 
819 static void
uchcom_write_callback(struct usb_xfer * xfer,usb_error_t error)820 uchcom_write_callback(struct usb_xfer *xfer, usb_error_t error)
821 {
822 	struct uchcom_softc *sc = usbd_xfer_softc(xfer);
823 	struct usb_page_cache *pc;
824 	uint32_t actlen;
825 
826 	switch (USB_GET_STATE(xfer)) {
827 	case USB_ST_SETUP:
828 	case USB_ST_TRANSFERRED:
829 tr_setup:
830 		pc = usbd_xfer_get_frame(xfer, 0);
831 		if (ucom_get_data(&sc->sc_ucom, pc, 0,
832 		    usbd_xfer_max_len(xfer), &actlen)) {
833 			DPRINTF("actlen = %d\n", actlen);
834 
835 			usbd_xfer_set_frame_len(xfer, 0, actlen);
836 			usbd_transfer_submit(xfer);
837 		}
838 		break;
839 
840 	default:			/* Error */
841 		if (error != USB_ERR_CANCELLED) {
842 			/* try to clear stall first */
843 			usbd_xfer_set_stall(xfer);
844 			goto tr_setup;
845 		}
846 		break;
847 	}
848 }
849 
850 static void
uchcom_read_callback(struct usb_xfer * xfer,usb_error_t error)851 uchcom_read_callback(struct usb_xfer *xfer, usb_error_t error)
852 {
853 	struct uchcom_softc *sc = usbd_xfer_softc(xfer);
854 	struct usb_page_cache *pc;
855 	int actlen;
856 
857 	usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL);
858 
859 	switch (USB_GET_STATE(xfer)) {
860 	case USB_ST_TRANSFERRED:
861 
862 		if (actlen > 0) {
863 			pc = usbd_xfer_get_frame(xfer, 0);
864 			ucom_put_data(&sc->sc_ucom, pc, 0, actlen);
865 		}
866 
867 	case USB_ST_SETUP:
868 tr_setup:
869 		usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
870 		usbd_transfer_submit(xfer);
871 		break;
872 
873 	default:			/* Error */
874 		if (error != USB_ERR_CANCELLED) {
875 			/* try to clear stall first */
876 			usbd_xfer_set_stall(xfer);
877 			goto tr_setup;
878 		}
879 		break;
880 	}
881 }
882 
883 static void
uchcom_poll(struct ucom_softc * ucom)884 uchcom_poll(struct ucom_softc *ucom)
885 {
886 	struct uchcom_softc *sc = ucom->sc_parent;
887 	usbd_transfer_poll(sc->sc_xfer, UCHCOM_N_TRANSFER);
888 }
889 
890 static device_method_t uchcom_methods[] = {
891 	/* Device interface */
892 	DEVMETHOD(device_probe, uchcom_probe),
893 	DEVMETHOD(device_attach, uchcom_attach),
894 	DEVMETHOD(device_detach, uchcom_detach),
895 	DEVMETHOD_END
896 };
897 
898 static driver_t uchcom_driver = {
899 	.name = "uchcom",
900 	.methods = uchcom_methods,
901 	.size = sizeof(struct uchcom_softc)
902 };
903 
904 DRIVER_MODULE(uchcom, uhub, uchcom_driver, NULL, NULL);
905 MODULE_DEPEND(uchcom, ucom, 1, 1, 1);
906 MODULE_DEPEND(uchcom, usb, 1, 1, 1);
907 MODULE_VERSION(uchcom, 1);
908 USB_PNP_HOST_INFO(uchcom_devs);
909