1/* $FreeBSD$ */
2/*-
3 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 *
5 * Copyright (c) 2010 Lev Serebryakov <lev@FreeBSD.org>.
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
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.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
28 */
29#ifndef _UMCS7840_H_
30#define	_UMCS7840_H_
31
32#define	UMCS7840_MAX_PORTS	4
33
34#define	UMCS7840_READ_LENGTH	1	/* bytes */
35#define	UMCS7840_CTRL_TIMEOUT	500	/* ms */
36
37/* Read/Wrtire registers vendor commands */
38#define	MCS7840_RDREQ		0x0d
39#define	MCS7840_WRREQ		0x0e
40
41/* Read/Wrtie EEPROM values */
42#define	MCS7840_EEPROM_RW_WVALUE	0x0900
43
44/*
45 *   All these registers are documented only in full datasheet,
46 * which can be requested from MosChip tech support.
47 */
48#define	MCS7840_DEV_REG_SP1		0x00	/* Options for for UART 1, R/W */
49#define	MCS7840_DEV_REG_CONTROL1	0x01	/* Control bits for UART 1,
50						 * R/W */
51#define	MCS7840_DEV_REG_PINPONGHIGH	0x02	/* High bits of ping-pong
52						 * register, R/W */
53#define	MCS7840_DEV_REG_PINPONGLOW	0x03	/* Low bits of ping-pong
54						 * register, R/W */
55/* DCRx_1 Registers goes here (see below, they are documented) */
56#define	MCS7840_DEV_REG_GPIO		0x07	/* GPIO_0 and GPIO_1 bits,
57						 * undocumented, see notes
58						 * below R/W */
59#define	MCS7840_DEV_REG_SP2		0x08	/* Options for for UART 2, R/W */
60#define	MCS7840_DEV_REG_CONTROL2	0x09	/* Control bits for UART 2,
61						 * R/W */
62#define	MCS7840_DEV_REG_SP3		0x0a	/* Options for for UART 3, R/W */
63#define	MCS7840_DEV_REG_CONTROL3	0x0b	/* Control bits for UART 3,
64						 * R/W */
65#define	MCS7840_DEV_REG_SP4		0x0c	/* Options for for UART 4, R/W */
66#define	MCS7840_DEV_REG_CONTROL4	0x0d	/* Control bits for UART 4,
67						 * R/W */
68#define	MCS7840_DEV_REG_PLL_DIV_M	0x0e	/* Pre-diviedr for PLL, R/W */
69#define	MCS7840_DEV_REG_UNKNOWN1	0x0f	/* NOT MENTIONED AND NOT USED */
70#define	MCS7840_DEV_REG_PLL_DIV_N	0x10	/* Loop divider for PLL, R/W */
71#define	MCS7840_DEV_REG_CLOCK_MUX	0x12	/* PLL input clock & Interrupt
72						 * endpoint control, R/W */
73#define	MCS7840_DEV_REG_UNKNOWN2	0x11	/* NOT MENTIONED AND NOT USED */
74#define	MCS7840_DEV_REG_CLOCK_SELECT12	0x13	/* Clock source for ports 1 &
75						 * 2, R/W */
76#define	MCS7840_DEV_REG_CLOCK_SELECT34	0x14	/* Clock source for ports 3 &
77						 * 4, R/W */
78#define	MCS7840_DEV_REG_UNKNOWN3	0x15	/* NOT MENTIONED AND NOT USED */
79/* DCRx_2-DCRx_4 Registers goes here (see below, they are documented) */
80#define	MCS7840_DEV_REG_UNKNOWN4	0x1f	/* NOT MENTIONED AND NOT USED */
81#define	MCS7840_DEV_REG_UNKNOWN5	0x20	/* NOT MENTIONED AND NOT USED */
82#define	MCS7840_DEV_REG_UNKNOWN6	0x21	/* NOT MENTIONED AND NOT USED */
83#define	MCS7840_DEV_REG_UNKNOWN7	0x22	/* NOT MENTIONED AND NOT USED */
84#define	MCS7840_DEV_REG_UNKNOWN8	0x23	/* NOT MENTIONED AND NOT USED */
85#define	MCS7840_DEV_REG_UNKNOWN9	0x24	/* NOT MENTIONED AND NOT USED */
86#define	MCS7840_DEV_REG_UNKNOWNA	0x25	/* NOT MENTIONED AND NOT USED */
87#define	MCS7840_DEV_REG_UNKNOWNB	0x26	/* NOT MENTIONED AND NOT USED */
88#define	MCS7840_DEV_REG_UNKNOWNC	0x27	/* NOT MENTIONED AND NOT USED */
89#define	MCS7840_DEV_REG_UNKNOWND	0x28	/* NOT MENTIONED AND NOT USED */
90#define	MCS7840_DEV_REG_UNKNOWNE	0x29	/* NOT MENTIONED AND NOT USED */
91#define	MCS7840_DEV_REG_UNKNOWNF	0x2a	/* NOT MENTIONED AND NOT USED */
92#define	MCS7840_DEV_REG_MODE		0x2b	/* Hardware configuration,
93						 * R/Only */
94#define	MCS7840_DEV_REG_SP1_ICG		0x2c	/* Inter character gap
95						 * configuration for Port 1,
96						 * R/W */
97#define	MCS7840_DEV_REG_SP2_ICG		0x2d	/* Inter character gap
98						 * configuration for Port 2,
99						 * R/W */
100#define	MCS7840_DEV_REG_SP3_ICG		0x2e	/* Inter character gap
101						 * configuration for Port 3,
102						 * R/W */
103#define	MCS7840_DEV_REG_SP4_ICG		0x2f	/* Inter character gap
104						 * configuration for Port 4,
105						 * R/W */
106#define	MCS7840_DEV_REG_RX_SAMPLING12	0x30	/* RX sampling for ports 1 &
107						 * 2, R/W */
108#define	MCS7840_DEV_REG_RX_SAMPLING34	0x31	/* RX sampling for ports 3 &
109						 * 4, R/W */
110#define	MCS7840_DEV_REG_BI_FIFO_STAT1	0x32	/* Bulk-In FIFO Stat for Port
111						 * 1, contains number of
112						 * available bytes, R/Only */
113#define	MCS7840_DEV_REG_BO_FIFO_STAT1	0x33	/* Bulk-out FIFO Stat for Port
114						 * 1, contains number of
115						 * available bytes, R/Only */
116#define	MCS7840_DEV_REG_BI_FIFO_STAT2	0x34	/* Bulk-In FIFO Stat for Port
117						 * 2, contains number of
118						 * available bytes, R/Only */
119#define	MCS7840_DEV_REG_BO_FIFO_STAT2	0x35	/* Bulk-out FIFO Stat for Port
120						 * 2, contains number of
121						 * available bytes, R/Only */
122#define	MCS7840_DEV_REG_BI_FIFO_STAT3	0x36	/* Bulk-In FIFO Stat for Port
123						 * 3, contains number of
124						 * available bytes, R/Only */
125#define	MCS7840_DEV_REG_BO_FIFO_STAT3	0x37	/* Bulk-out FIFO Stat for Port
126						 * 3, contains number of
127						 * available bytes, R/Only */
128#define	MCS7840_DEV_REG_BI_FIFO_STAT4	0x38	/* Bulk-In FIFO Stat for Port
129						 * 4, contains number of
130						 * available bytes, R/Only */
131#define	MCS7840_DEV_REG_BO_FIFO_STAT4	0x39	/* Bulk-out FIFO Stat for Port
132						 * 4, contains number of
133						 * available bytes, R/Only */
134#define	MCS7840_DEV_REG_ZERO_PERIOD1	0x3a	/* Period between zero out
135						 * frames for Port 1, R/W */
136#define	MCS7840_DEV_REG_ZERO_PERIOD2	0x3b	/* Period between zero out
137						 * frames for Port 1, R/W */
138#define	MCS7840_DEV_REG_ZERO_PERIOD3	0x3c	/* Period between zero out
139						 * frames for Port 1, R/W */
140#define	MCS7840_DEV_REG_ZERO_PERIOD4	0x3d	/* Period between zero out
141						 * frames for Port 1, R/W */
142#define	MCS7840_DEV_REG_ZERO_ENABLE	0x3e	/* Enable/disable of zero out
143						 * frames, R/W */
144#define	MCS7840_DEV_REG_THR_VAL_LOW1	0x3f	/* Low 8 bits of threshold
145						 * value for Bulk-Out for Port
146						 * 1, R/W */
147#define	MCS7840_DEV_REG_THR_VAL_HIGH1	0x40	/* High 1 bit of threshold
148						 * value for Bulk-Out and
149						 * enable flag for Port 1, R/W */
150#define	MCS7840_DEV_REG_THR_VAL_LOW2	0x41	/* Low 8 bits of threshold
151						 * value for Bulk-Out for Port
152						 * 2, R/W */
153#define	MCS7840_DEV_REG_THR_VAL_HIGH2	0x42	/* High 1 bit of threshold
154						 * value for Bulk-Out and
155						 * enable flag for Port 2, R/W */
156#define	MCS7840_DEV_REG_THR_VAL_LOW3	0x43	/* Low 8 bits of threshold
157						 * value for Bulk-Out for Port
158						 * 3, R/W */
159#define	MCS7840_DEV_REG_THR_VAL_HIGH3	0x44	/* High 1 bit of threshold
160						 * value for Bulk-Out and
161						 * enable flag for Port 3, R/W */
162#define	MCS7840_DEV_REG_THR_VAL_LOW4	0x45	/* Low 8 bits of threshold
163						 * value for Bulk-Out for Port
164						 * 4, R/W */
165#define	MCS7840_DEV_REG_THR_VAL_HIGH4	0x46	/* High 1 bit of threshold
166						 * value for Bulk-Out and
167						 * enable flag for Port 4, R/W */
168
169/* Bits for SPx registers */
170#define	MCS7840_DEV_SPx_LOOP_PIPES	0x01	/* Loop Bulk-Out FIFO to the
171						 * Bulk-In FIFO, default = 0 */
172#define	MCS7840_DEV_SPx_SKIP_ERR_DATA	0x02	/* Drop data bytes from UART,
173						 * which were recevied with
174						 * errors, default = 0 */
175#define	MCS7840_DEV_SPx_RESET_OUT_FIFO	0x04	/* Reset Bulk-Out FIFO */
176#define	MCS7840_DEV_SPx_RESET_IN_FIFO	0x08	/* Reset Bulk-In FIFO */
177#define	MCS7840_DEV_SPx_CLOCK_MASK	0x70	/* Mask to extract Baud CLK
178						 * source */
179#define	MCS7840_DEV_SPx_CLOCK_X1	0x00	/* CLK =  1.8432Mhz, max speed
180						 * = 115200 bps, default */
181#define	MCS7840_DEV_SPx_CLOCK_X2	0x10	/* CLK =  3.6864Mhz, max speed
182						 * = 230400 bps */
183#define	MCS7840_DEV_SPx_CLOCK_X35	0x20	/* CLK =  6.4512Mhz, max speed
184						 * = 403200 bps */
185#define	MCS7840_DEV_SPx_CLOCK_X4	0x30	/* CLK =  7.3728Mhz, max speed
186						 * = 460800 bps */
187#define	MCS7840_DEV_SPx_CLOCK_X7	0x40	/* CLK = 12.9024Mhz, max speed
188						 * = 806400 bps */
189#define	MCS7840_DEV_SPx_CLOCK_X8	0x50	/* CLK = 14.7456Mhz, max speed
190						 * = 921600 bps */
191#define	MCS7840_DEV_SPx_CLOCK_24MHZ	0x60	/* CLK = 24.0000Mhz, max speed
192						 * = 1.5 Mbps */
193#define	MCS7840_DEV_SPx_CLOCK_48MHZ	0x70	/* CLK = 48.0000Mhz, max speed
194						 * = 3.0 Mbps */
195#define	MCS7840_DEV_SPx_CLOCK_SHIFT	4	/* Value 0..7 can be shifted
196						 * to get clock value */
197#define	MCS7840_DEV_SPx_UART_RESET	0x80	/* Reset UART */
198
199/* Bits for CONTROLx registers */
200#define	MCS7840_DEV_CONTROLx_HWFC		0x01	/* Enable hardware flow
201							 * control (when power
202							 * down? It is unclear
203							 * in documents),
204							 * default = 0 */
205#define	MCS7840_DEV_CONTROLx_UNUNSED1		0x02	/* Reserved */
206#define	MCS7840_DEV_CONTROLx_CTS_ENABLE		0x04	/* CTS changes are
207							 * translated to MSR,
208							 * default = 0 */
209#define	MCS7840_DEV_CONTROLx_UNUSED2		0x08	/* Reserved for ports
210							 * 2,3,4 */
211#define	MCS7840_DEV_CONTROL1_DRIVER_DONE	0x08	/* USB enumerating is
212							 * finished, USB
213							 * enumeration memory
214							 * can be used as FIFOs */
215#define	MCS7840_DEV_CONTROLx_RX_NEGATE		0x10	/* Negate RX input,
216							 * works for IrDA mode
217							 * only, default = 0 */
218#define	MCS7840_DEV_CONTROLx_RX_DISABLE		0x20	/* Disable RX logic,
219							 * works only for
220							 * RS-232/RS-485 mode,
221							 * default = 0 */
222#define	MCS7840_DEV_CONTROLx_FSM_CONTROL	0x40	/* Disable RX FSM when
223							 * TX is in progress,
224							 * works for IrDA mode
225							 * only, default = 0 */
226#define	MCS7840_DEV_CONTROLx_UNUSED3		0x80	/* Reserved */
227
228/*
229 * Bits for PINPONGx registers
230 * These registers control how often two input buffers
231 * for Bulk-In FIFOs are swapped. One of buffers is used
232 * for USB trnasfer, other for receiving data from UART.
233 * Exact meaning of 15 bit value in these registers is unknown
234 */
235#define	MCS7840_DEV_PINPONGHIGH_MULT	128	/* Only 7 bits in PINPONGLOW
236						 * register */
237#define	MCS7840_DEV_PINPONGLOW_BITS	7	/* Only 7 bits in PINPONGLOW
238						 * register */
239
240/*
241 *  THIS ONE IS UNDOCUMENTED IN FULL DATASHEET, but e-mail from tech support
242 * confirms, that it is register for GPIO_0 and GPIO_1 data input/output.
243 *  Chips has 2 GPIO, but first one (lower bit) MUST be used by device
244 * authors as "number of port" indicator, grounded (0) for two-port
245 * devices and pulled-up to 1 for 4-port devices.
246 */
247#define	MCS7840_DEV_GPIO_4PORTS		0x01	/* Device has 4 ports
248						 * configured */
249#define	MCS7840_DEV_GPIO_GPIO_0		0x01	/* The same as above */
250#define	MCS7840_DEV_GPIO_GPIO_1		0x02	/* GPIO_1 data */
251
252/*
253 * Constants for PLL dividers
254 * Ouptut frequency of PLL is:
255 *   Fout = (N/M) * Fin.
256 * Default PLL input frequency Fin is 12Mhz (on-chip).
257 */
258#define	MCS7840_DEV_PLL_DIV_M_BITS	6	/* Number of useful bits for M
259						 * divider */
260#define	MCS7840_DEV_PLL_DIV_M_MASK	0x3f	/* Mask for M divider */
261#define	MCS7840_DEV_PLL_DIV_M_MIN	1	/* Minimum value for M, 0 is
262						 * forbidden */
263#define	MCS7840_DEV_PLL_DIV_M_DEF	1	/* Default value for M */
264#define	MCS7840_DEV_PLL_DIV_M_MAX	63	/* Maximum value for M */
265#define	MCS7840_DEV_PLL_DIV_N_BITS	6	/* Number of useful bits for N
266						 * divider */
267#define	MCS7840_DEV_PLL_DIV_N_MASK	0x3f	/* Mask for N divider */
268#define	MCS7840_DEV_PLL_DIV_N_MIN	1	/* Minimum value for N, 0 is
269						 * forbidden */
270#define	MCS7840_DEV_PLL_DIV_N_DEF	8	/* Default value for N */
271#define	MCS7840_DEV_PLL_DIV_N_MAX	63	/* Maximum value for N */
272
273/* Bits for CLOCK_MUX register */
274#define	MCS7840_DEV_CLOCK_MUX_INPUTMASK	0x03	/* Mask to extract PLL clock
275						 * input */
276#define	MCS7840_DEV_CLOCK_MUX_IN12MHZ	0x00	/* 12Mhz PLL input, default */
277#define	MCS7840_DEV_CLOCK_MUX_INEXTRN	0x01	/* External (device-depended)
278						 * PLL input */
279#define	MCS7840_DEV_CLOCK_MUX_INRSV1	0x02	/* Reserved */
280#define	MCS7840_DEV_CLOCK_MUX_INRSV2	0x03	/* Reserved */
281#define	MCS7840_DEV_CLOCK_MUX_PLLHIGH	0x04	/* 0 = PLL Output is
282						 * 20MHz-100MHz (default), 1 =
283						 * 100MHz-300MHz range */
284#define	MCS7840_DEV_CLOCK_MUX_INTRFIFOS	0x08	/* Enable additional 8 bytes
285						 * fro Interrupt USB pipe with
286						 * USB FIFOs statuses, default
287						 * = 0 */
288#define	MCS7840_DEV_CLOCK_MUX_RESERVED1	0x10	/* Unused */
289#define	MCS7840_DEV_CLOCK_MUX_RESERVED2	0x20	/* Unused */
290#define	MCS7840_DEV_CLOCK_MUX_RESERVED3	0x40	/* Unused */
291#define	MCS7840_DEV_CLOCK_MUX_RESERVED4	0x80	/* Unused */
292
293/* Bits for CLOCK_SELECTxx registers	*/
294#define	MCS7840_DEV_CLOCK_SELECT1_MASK	0x07	/* Bits for port 1 in
295						 * CLOCK_SELECT12 */
296#define	MCS7840_DEV_CLOCK_SELECT1_SHIFT	0	/* Shift for port 1in
297						 * CLOCK_SELECT12 */
298#define	MCS7840_DEV_CLOCK_SELECT2_MASK	0x38	/* Bits for port 2 in
299						 * CLOCK_SELECT12 */
300#define	MCS7840_DEV_CLOCK_SELECT2_SHIFT	3	/* Shift for port 2 in
301						 * CLOCK_SELECT12 */
302#define	MCS7840_DEV_CLOCK_SELECT3_MASK	0x07	/* Bits for port 3 in
303						 * CLOCK_SELECT23 */
304#define	MCS7840_DEV_CLOCK_SELECT3_SHIFT	0	/* Shift for port 3 in
305						 * CLOCK_SELECT23 */
306#define	MCS7840_DEV_CLOCK_SELECT4_MASK	0x38	/* Bits for port 4 in
307						 * CLOCK_SELECT23 */
308#define	MCS7840_DEV_CLOCK_SELECT4_SHIFT	3	/* Shift for port 4 in
309						 * CLOCK_SELECT23 */
310#define	MCS7840_DEV_CLOCK_SELECT_STD	0x00	/* STANDARD baudrate derived
311						 * from 96Mhz, default for all
312						 * ports */
313#define	MCS7840_DEV_CLOCK_SELECT_30MHZ	0x01	/* 30Mhz */
314#define	MCS7840_DEV_CLOCK_SELECT_96MHZ	0x02	/* 96Mhz direct */
315#define	MCS7840_DEV_CLOCK_SELECT_120MHZ	0x03	/* 120Mhz */
316#define	MCS7840_DEV_CLOCK_SELECT_PLL	0x04	/* PLL output (see for M and N
317						 * dividers) */
318#define	MCS7840_DEV_CLOCK_SELECT_EXT	0x05	/* External clock input
319						 * (device-dependend) */
320#define	MCS7840_DEV_CLOCK_SELECT_RES1	0x06	/* Unused */
321#define	MCS7840_DEV_CLOCK_SELECT_RES2	0x07	/* Unused */
322
323/* Bits for MODE register */
324#define	MCS7840_DEV_MODE_RESERVED1	0x01	/* Unused */
325#define	MCS7840_DEV_MODE_RESET		0x02	/* 0: RESET = Active High
326						 * (default), 1: Reserved (?) */
327#define	MCS7840_DEV_MODE_SER_PRSNT	0x04	/* 0: Reserved, 1: Do not use
328						 * hardocded values (default)
329						 * (?) */
330#define	MCS7840_DEV_MODE_PLLBYPASS	0x08	/* 1: PLL output is bypassed,
331						 * default = 0 */
332#define	MCS7840_DEV_MODE_PORBYPASS	0x10	/* 1: Power-On Reset is
333						 * bypassed, default = 0 */
334#define	MCS7840_DEV_MODE_SELECT24S	0x20	/* 0: 4 Serial Ports / IrDA
335						 * active, 1: 2 Serial Ports /
336						 * IrDA active */
337#define	MCS7840_DEV_MODE_EEPROMWR	0x40	/* EEPROM write is enabled,
338						 * default */
339#define	MCS7840_DEV_MODE_IRDA		0x80	/* IrDA mode is activated
340						 * (could be turned on),
341						 * default */
342
343/* Bits for SPx ICG */
344#define	MCS7840_DEV_SPx_ICG_DEF		0x24	/* All 8 bits is used as
345						 * number of BAUD clocks of
346						 * pause */
347
348/*
349 * Bits for RX_SAMPLINGxx registers
350 * These registers control when bit value will be sampled within
351 * the baud period.
352 * 0 is very beginning of period, 15 is very end, 7 is the middle.
353 */
354#define	MCS7840_DEV_RX_SAMPLING1_MASK	0x0f	/* Bits for port 1 in
355						 * RX_SAMPLING12 */
356#define	MCS7840_DEV_RX_SAMPLING1_SHIFT	0	/* Shift for port 1in
357						 * RX_SAMPLING12 */
358#define	MCS7840_DEV_RX_SAMPLING2_MASK	0xf0	/* Bits for port 2 in
359						 * RX_SAMPLING12 */
360#define	MCS7840_DEV_RX_SAMPLING2_SHIFT	4	/* Shift for port 2 in
361						 * RX_SAMPLING12 */
362#define	MCS7840_DEV_RX_SAMPLING3_MASK	0x0f	/* Bits for port 3 in
363						 * RX_SAMPLING23 */
364#define	MCS7840_DEV_RX_SAMPLING3_SHIFT	0	/* Shift for port 3 in
365						 * RX_SAMPLING23 */
366#define	MCS7840_DEV_RX_SAMPLING4_MASK	0xf0	/* Bits for port 4 in
367						 * RX_SAMPLING23 */
368#define	MCS7840_DEV_RX_SAMPLING4_SHIFT	4	/* Shift for port 4 in
369						 * RX_SAMPLING23 */
370#define	MCS7840_DEV_RX_SAMPLINGx_MIN	0	/* Max for any RX Sampling */
371#define	MCS7840_DEV_RX_SAMPLINGx_DEF	7	/* Default for any RX
372						 * Sampling, center of period */
373#define	MCS7840_DEV_RX_SAMPLINGx_MAX	15	/* Min for any RX Sampling */
374
375/* Bits for ZERO_PERIODx */
376#define	MCS7840_DEV_ZERO_PERIODx_DEF	20	/* Number of Bulk-in requests
377						 * befor sending zero-sized
378						 * reply */
379
380/* Bits for ZERO_ENABLE */
381#define	MCS7840_DEV_ZERO_ENABLE_PORT1	0x01	/* Enable of sending
382						 * zero-sized replies for port
383						 * 1, default */
384#define	MCS7840_DEV_ZERO_ENABLE_PORT2	0x02	/* Enable of sending
385						 * zero-sized replies for port
386						 * 2, default */
387#define	MCS7840_DEV_ZERO_ENABLE_PORT3	0x04	/* Enable of sending
388						 * zero-sized replies for port
389						 * 3, default */
390#define	MCS7840_DEV_ZERO_ENABLE_PORT4	0x08	/* Enable of sending
391						 * zero-sized replies for port
392						 * 4, default */
393
394/* Bits for THR_VAL_HIGHx */
395#define	MCS7840_DEV_THR_VAL_HIGH_MASK	0x01	/* Only one bit is used */
396#define	MCS7840_DEV_THR_VAL_HIGH_MUL	256	/* This one bit is means "256" */
397#define	MCS7840_DEV_THR_VAL_HIGH_SHIFT	8	/* This one bit is means "256" */
398#define	MCS7840_DEV_THR_VAL_HIGH_ENABLE	0x80	/* Enable threshold */
399
400/* These are documented in "public" datasheet */
401#define	MCS7840_DEV_REG_DCR0_1	0x04	/* Device contol register 0 for Port
402					 * 1, R/W */
403#define	MCS7840_DEV_REG_DCR1_1	0x05	/* Device contol register 1 for Port
404					 * 1, R/W */
405#define	MCS7840_DEV_REG_DCR2_1	0x06	/* Device contol register 2 for Port
406					 * 1, R/W */
407#define	MCS7840_DEV_REG_DCR0_2	0x16	/* Device contol register 0 for Port
408					 * 2, R/W */
409#define	MCS7840_DEV_REG_DCR1_2	0x17	/* Device contol register 1 for Port
410					 * 2, R/W */
411#define	MCS7840_DEV_REG_DCR2_2	0x18	/* Device contol register 2 for Port
412					 * 2, R/W */
413#define	MCS7840_DEV_REG_DCR0_3	0x19	/* Device contol register 0 for Port
414					 * 3, R/W */
415#define	MCS7840_DEV_REG_DCR1_3	0x1a	/* Device contol register 1 for Port
416					 * 3, R/W */
417#define	MCS7840_DEV_REG_DCR2_3	0x1b	/* Device contol register 2 for Port
418					 * 3, R/W */
419#define	MCS7840_DEV_REG_DCR0_4	0x1c	/* Device contol register 0 for Port
420					 * 4, R/W */
421#define	MCS7840_DEV_REG_DCR1_4	0x1d	/* Device contol register 1 for Port
422					 * 4, R/W */
423#define	MCS7840_DEV_REG_DCR2_4	0x1e	/* Device contol register 2 for Port
424					 * 4, R/W */
425
426/* Bits of DCR0 registers, documented in datasheet */
427#define	MCS7840_DEV_DCR0_PWRSAVE		0x01	/* Shutdown transiver
428							 * when USB Suspend is
429							 * engaged, default = 1 */
430#define	MCS7840_DEV_DCR0_RESERVED1		0x02	/* Unused */
431#define	MCS7840_DEV_DCR0_GPIO_MODE_MASK		0x0c	/* GPIO Mode bits, WORKS
432							 * ONLY FOR PORT 1 */
433#define	MCS7840_DEV_DCR0_GPIO_MODE_IN		0x00	/* GPIO Mode - Input
434							 * (0b00), WORKS ONLY
435							 * FOR PORT 1 */
436#define	MCS7840_DEV_DCR0_GPIO_MODE_OUT		0x08	/* GPIO Mode - Input
437							 * (0b10), WORKS ONLY
438							 * FOR PORT 1 */
439#define	MCS7840_DEV_DCR0_RTS_ACTIVE_HIGH	0x10	/* RTS Active is HIGH,
440							 * default = 0 (low) */
441#define	MCS7840_DEV_DCR0_RTS_AUTO		0x20	/* RTS is controlled by
442							 * state of TX buffer,
443							 * default = 0
444							 * (controlled by MCR) */
445#define	MCS7840_DEV_DCR0_IRDA			0x40	/* IrDA mode */
446#define	MCS7840_DEV_DCR0_RESERVED2		0x80	/* Unused */
447
448/* Bits of DCR1 registers, documented in datasheet */
449#define	MCS7840_DEV_DCR1_GPIO_CURRENT_MASK	0x03	/* Mask to extract GPIO
450							 * current value, WORKS
451							 * ONLY FOR PORT 1 */
452#define	MCS7840_DEV_DCR1_GPIO_CURRENT_6MA	0x00	/* GPIO output current
453							 * 6mA, WORKS ONLY FOR
454							 * PORT 1 */
455#define	MCS7840_DEV_DCR1_GPIO_CURRENT_8MA	0x01	/* GPIO output current
456							 * 8mA, defauilt, WORKS
457							 * ONLY FOR PORT 1 */
458#define	MCS7840_DEV_DCR1_GPIO_CURRENT_10MA	0x02	/* GPIO output current
459							 * 10mA, WORKS ONLY FOR
460							 * PORT 1 */
461#define	MCS7840_DEV_DCR1_GPIO_CURRENT_12MA	0x03	/* GPIO output current
462							 * 12mA, WORKS ONLY FOR
463							 * PORT 1 */
464#define	MCS7840_DEV_DCR1_UART_CURRENT_MASK	0x0c	/* Mask to extract UART
465							 * signals current value */
466#define	MCS7840_DEV_DCR1_UART_CURRENT_6MA	0x00	/* UART output current
467							 * 6mA */
468#define	MCS7840_DEV_DCR1_UART_CURRENT_8MA	0x04	/* UART output current
469							 * 8mA, defauilt */
470#define	MCS7840_DEV_DCR1_UART_CURRENT_10MA	0x08	/* UART output current
471							 * 10mA */
472#define	MCS7840_DEV_DCR1_UART_CURRENT_12MA	0x0c	/* UART output current
473							 * 12mA */
474#define	MCS7840_DEV_DCR1_WAKEUP_DISABLE		0x10	/* Disable Remote USB
475							 * Wakeup */
476#define	MCS7840_DEV_DCR1_PLLPWRDOWN_DISABLE	0x20	/* Disable PLL power
477							 * down when not needed,
478							 * WORKS ONLY FOR PORT 1 */
479#define	MCS7840_DEV_DCR1_LONG_INTERRUPT		0x40	/* Enable 13 bytes of
480							 * interrupt data, with
481							 * FIFO statistics,
482							 * WORKS ONLY FOR PORT 1 */
483#define	MCS7840_DEV_DCR1_RESERVED1		0x80	/* Unused */
484
485/*
486 * Bits of DCR2 registers, documented in datasheet
487 * Wakeup will work only if DCR0_IRDA = 0 (RS-xxx mode) and
488 * DCR1_WAKEUP_DISABLE = 0 (wakeup enabled).
489 */
490#define	MCS7840_DEV_DCR2_WAKEUP_CTS	0x01	/* Wakeup on CTS change,
491						 * default = 0 */
492#define	MCS7840_DEV_DCR2_WAKEUP_DCD	0x02	/* Wakeup on DCD change,
493						 * default = 0 */
494#define	MCS7840_DEV_DCR2_WAKEUP_RI	0x04	/* Wakeup on RI change,
495						 * default = 1 */
496#define	MCS7840_DEV_DCR2_WAKEUP_DSR	0x08	/* Wakeup on DSR change,
497						 * default = 0 */
498#define	MCS7840_DEV_DCR2_WAKEUP_RXD	0x10	/* Wakeup on RX Data change,
499						 * default = 0 */
500#define	MCS7840_DEV_DCR2_WAKEUP_RESUME	0x20	/* Wakeup issues RESUME
501						 * signal, DISCONNECT
502						 * otherwise, default = 1 */
503#define	MCS7840_DEV_DCR2_RESERVED1	0x40	/* Unused */
504#define	MCS7840_DEV_DCR2_SHDN_POLARITY	0x80	/* 0: Pin 12 Active Low, 1:
505						 * Pin 12 Active High, default
506						 * = 0 */
507
508/* Interrupt endpoint bytes & bits */
509#define	MCS7840_IEP_FIFO_STATUS_INDEX	5
510/*
511 * Thesse can be calculated as "1 << portnumber" for Bulk-out and
512 * "1 << (portnumber+1)" for Bulk-in
513 */
514#define	MCS7840_IEP_BO_PORT1_HASDATA	0x01
515#define	MCS7840_IEP_BI_PORT1_HASDATA	0x02
516#define	MCS7840_IEP_BO_PORT2_HASDATA	0x04
517#define	MCS7840_IEP_BI_PORT2_HASDATA	0x08
518#define	MCS7840_IEP_BO_PORT3_HASDATA	0x10
519#define	MCS7840_IEP_BI_PORT3_HASDATA	0x20
520#define	MCS7840_IEP_BO_PORT4_HASDATA	0x40
521#define	MCS7840_IEP_BI_PORT4_HASDATA	0x80
522
523/* Documented UART registers (fully compatible with 16550 UART) */
524#define	MCS7840_UART_REG_THR		0x00	/* Transmitter Holding
525						 * Register W/Only */
526#define	MCS7840_UART_REG_RHR		0x00	/* Receiver Holding Register
527						 * R/Only */
528#define	MCS7840_UART_REG_IER		0x01	/* Interrupt enable register -
529						 * R/W */
530#define	MCS7840_UART_REG_FCR		0x02	/* FIFO Control register -
531						 * W/Only */
532#define	MCS7840_UART_REG_ISR		0x02	/* Interrupt Status Registter
533						 * R/Only */
534#define	MCS7840_UART_REG_LCR		0x03	/* Line control register R/W */
535#define	MCS7840_UART_REG_MCR		0x04	/* Modem control register R/W */
536#define	MCS7840_UART_REG_LSR		0x05	/* Line status register R/Only */
537#define	MCS7840_UART_REG_MSR		0x06	/* Modem status register
538						 * R/Only */
539#define	MCS7840_UART_REG_SCRATCHPAD	0x07	/* Scratch pad register */
540
541#define	MCS7840_UART_REG_DLL		0x00	/* Low bits of BAUD divider */
542#define	MCS7840_UART_REG_DLM		0x01	/* High bits of BAUD divider */
543
544/* IER bits */
545#define	MCS7840_UART_IER_RXREADY	0x01	/* RX Ready interrumpt mask */
546#define	MCS7840_UART_IER_TXREADY	0x02	/* TX Ready interrumpt mask */
547#define	MCS7840_UART_IER_RXSTAT		0x04	/* RX Status interrumpt mask */
548#define	MCS7840_UART_IER_MODEM		0x08	/* Modem status change
549						 * interrumpt mask */
550#define	MCS7840_UART_IER_SLEEP		0x10	/* SLEEP enable */
551
552/* FCR bits */
553#define	MCS7840_UART_FCR_ENABLE		0x01	/* Enable FIFO */
554#define	MCS7840_UART_FCR_FLUSHRHR	0x02	/* Flush RHR and FIFO */
555#define	MCS7840_UART_FCR_FLUSHTHR	0x04	/* Flush THR and FIFO */
556#define	MCS7840_UART_FCR_RTLMASK	0xa0	/* Mask to select RHR
557						 * Interrupt Trigger level */
558#define	MCS7840_UART_FCR_RTL_1_1	0x00	/* L1 = 1, L2 = 1 */
559#define	MCS7840_UART_FCR_RTL_1_4	0x40	/* L1 = 1, L2 = 4 */
560#define	MCS7840_UART_FCR_RTL_1_8	0x80	/* L1 = 1, L2 = 8 */
561#define	MCS7840_UART_FCR_RTL_1_14	0xa0	/* L1 = 1, L2 = 14 */
562
563/* ISR bits */
564#define	MCS7840_UART_ISR_NOPENDING	0x01	/* No interrupt pending */
565#define	MCS7840_UART_ISR_INTMASK	0x3f	/* Mask to select interrupt
566						 * source */
567#define	MCS7840_UART_ISR_RXERR		0x06	/* Recevir error */
568#define	MCS7840_UART_ISR_RXHASDATA	0x04	/* Recevier has data */
569#define	MCS7840_UART_ISR_RXTIMEOUT	0x0c	/* Recevier timeout */
570#define	MCS7840_UART_ISR_TXEMPTY	0x02	/* Transmitter empty */
571#define	MCS7840_UART_ISR_MSCHANGE	0x00	/* Modem status change */
572
573/* LCR bits */
574#define	MCS7840_UART_LCR_DATALENMASK	0x03	/* Mask for data length */
575#define	MCS7840_UART_LCR_DATALEN5	0x00	/* 5 data bits */
576#define	MCS7840_UART_LCR_DATALEN6	0x01	/* 6 data bits */
577#define	MCS7840_UART_LCR_DATALEN7	0x02	/* 7 data bits */
578#define	MCS7840_UART_LCR_DATALEN8	0x03	/* 8 data bits */
579
580#define	MCS7840_UART_LCR_STOPBMASK	0x04	/* Mask for stop bits */
581#define	MCS7840_UART_LCR_STOPB1		0x00	/* 1 stop bit in any case */
582#define	MCS7840_UART_LCR_STOPB2		0x04	/* 1.5-2 stop bits depends on
583						 * data length */
584
585#define	MCS7840_UART_LCR_PARITYMASK	0x38	/* Mask for all parity data */
586#define	MCS7840_UART_LCR_PARITYON	0x08	/* Parity ON/OFF - ON */
587#define	MCS7840_UART_LCR_PARITYODD	0x00	/* Parity Odd */
588#define	MCS7840_UART_LCR_PARITYEVEN	0x10	/* Parity Even */
589#define	MCS7840_UART_LCR_PARITYODD	0x00	/* Parity Odd */
590#define	MCS7840_UART_LCR_PARITYFORCE	0x20	/* Force parity odd/even */
591
592#define	MCS7840_UART_LCR_BREAK		0x40	/* Send BREAK */
593#define	MCS7840_UART_LCR_DIVISORS	0x80	/* Map DLL/DLM instead of
594						 * xHR/IER */
595
596/* LSR bits */
597#define	MCS7840_UART_LSR_RHRAVAIL	0x01	/* Data available for read */
598#define	MCS7840_UART_LSR_RHROVERRUN	0x02	/* Data FIFO/register overflow */
599#define	MCS7840_UART_LSR_PARITYERR	0x04	/* Parity error */
600#define	MCS7840_UART_LSR_FRAMEERR	0x10	/* Framing error */
601#define	MCS7840_UART_LSR_BREAKERR	0x20	/* BREAK signal received */
602#define	MCS7840_UART_LSR_THREMPTY	0x40	/* THR register is empty,
603						 * ready for transmit */
604#define	MCS7840_UART_LSR_HASERR		0x80	/* Has error in receiver FIFO */
605
606/* MCR bits */
607#define	MCS7840_UART_MCR_DTR		0x01	/* Force DTR to be active
608						 * (low) */
609#define	MCS7840_UART_MCR_RTS		0x02	/* Force RTS to be active
610						 * (low) */
611#define	MCS7840_UART_MCR_IE		0x04	/* Enable interrupts (from
612						 * code, not documented) */
613#define	MCS7840_UART_MCR_LOOPBACK	0x10	/* Enable local loopback test
614						 * mode */
615#define	MCS7840_UART_MCR_CTSRTS		0x20	/* Enable CTS/RTS flow control
616						 * in 550 (FIFO) mode */
617#define	MCS7840_UART_MCR_DTRDSR		0x40	/* Enable DTR/DSR flow control
618						 * in 550 (FIFO) mode */
619#define	MCS7840_UART_MCR_DCD		0x80	/* Enable DCD flow control in
620						 * 550 (FIFO) mode */
621
622/* MSR bits */
623#define	MCS7840_UART_MSR_DELTACTS	0x01	/* CTS was changed since last
624						 * read */
625#define	MCS7840_UART_MSR_DELTADSR	0x02	/* DSR was changed since last
626						 * read */
627#define	MCS7840_UART_MSR_DELTARI	0x04	/* RI was changed from low to
628						 * high since last read */
629#define	MCS7840_UART_MSR_DELTADCD	0x08	/* DCD was changed since last
630						 * read */
631#define	MCS7840_UART_MSR_NEGCTS		0x10	/* Negated CTS signal */
632#define	MCS7840_UART_MSR_NEGDSR		0x20	/* Negated DSR signal */
633#define	MCS7840_UART_MSR_NEGRI		0x40	/* Negated RI signal */
634#define	MCS7840_UART_MSR_NEGDCD		0x80	/* Negated DCD signal */
635
636/* SCRATCHPAD bits */
637#define	MCS7840_UART_SCRATCHPAD_RS232		0x00	/* RS-485 disabled */
638#define	MCS7840_UART_SCRATCHPAD_RS485_DTRRX	0x80	/* RS-485 mode, DTR High
639							 * = RX */
640#define	MCS7840_UART_SCRATCHPAD_RS485_DTRTX	0xc0	/* RS-485 mode, DTR High
641							 * = TX */
642
643#define	MCS7840_CONFIG_INDEX	0
644#define	MCS7840_IFACE_INDEX	0
645
646#endif
647