1/************************************************************************
2 * Copyright 2003 Digi International (www.digi.com)
3 *
4 * Copyright (C) 2004 IBM Corporation. All rights reserved.
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2, or (at your option)
9 * any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED; without even the
13 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
14 * PURPOSE.  See the GNU General Public License for more details.
15 *
16 * Contact Information:
17 * Scott H Kilau <Scott_Kilau@digi.com>
18 * Wendy Xiong   <wendyx@us.ibm.com>
19 *
20 ***********************************************************************/
21
22#ifndef __JSM_DRIVER_H
23#define __JSM_DRIVER_H
24
25#include <linux/kernel.h>
26#include <linux/types.h>	/* To pick up the varions Linux types */
27#include <linux/tty.h>
28#include <linux/serial_core.h>
29#include <linux/device.h>
30
31/*
32 * Debugging levels can be set using debug insmod variable
33 * They can also be compiled out completely.
34 */
35enum {
36	DBG_INIT	= 0x01,
37	DBG_BASIC	= 0x02,
38	DBG_CORE	= 0x04,
39	DBG_OPEN	= 0x08,
40	DBG_CLOSE	= 0x10,
41	DBG_READ	= 0x20,
42	DBG_WRITE	= 0x40,
43	DBG_IOCTL	= 0x80,
44	DBG_PROC	= 0x100,
45	DBG_PARAM	= 0x200,
46	DBG_PSCAN	= 0x400,
47	DBG_EVENT	= 0x800,
48	DBG_DRAIN	= 0x1000,
49	DBG_MSIGS	= 0x2000,
50	DBG_MGMT	= 0x4000,
51	DBG_INTR	= 0x8000,
52	DBG_CARR	= 0x10000,
53};
54
55#define jsm_dbg(nlevel, pdev, fmt, ...)				\
56do {								\
57	if (DBG_##nlevel & jsm_debug)				\
58		dev_dbg(pdev->dev, fmt, ##__VA_ARGS__);		\
59} while (0)
60
61#define	MAXLINES	256
62#define MAXPORTS	8
63#define MAX_STOPS_SENT	5
64
65/* Board ids */
66#define PCI_DEVICE_ID_CLASSIC_4		0x0028
67#define PCI_DEVICE_ID_CLASSIC_8		0x0029
68#define PCI_DEVICE_ID_CLASSIC_4_422	0x00D0
69#define PCI_DEVICE_ID_CLASSIC_8_422	0x00D1
70#define PCI_DEVICE_ID_NEO_4             0x00B0
71#define PCI_DEVICE_ID_NEO_1_422         0x00CC
72#define PCI_DEVICE_ID_NEO_1_422_485     0x00CD
73#define PCI_DEVICE_ID_NEO_2_422_485     0x00CE
74#define PCIE_DEVICE_ID_NEO_8            0x00F0
75#define PCIE_DEVICE_ID_NEO_4            0x00F1
76#define PCIE_DEVICE_ID_NEO_4RJ45        0x00F2
77#define PCIE_DEVICE_ID_NEO_8RJ45        0x00F3
78
79/* Board type definitions */
80
81#define T_NEO		0000
82#define T_CLASSIC	0001
83#define T_PCIBUS	0400
84
85/* Board State Definitions */
86
87#define BD_RUNNING	0x0
88#define BD_REASON	0x7f
89#define BD_NOTFOUND	0x1
90#define BD_NOIOPORT	0x2
91#define BD_NOMEM	0x3
92#define BD_NOBIOS	0x4
93#define BD_NOFEP	0x5
94#define BD_FAILED	0x6
95#define BD_ALLOCATED	0x7
96#define BD_TRIBOOT	0x8
97#define BD_BADKME	0x80
98
99
100/* 4 extra for alignment play space */
101#define WRITEBUFLEN	((4096) + 4)
102
103#define JSM_VERSION	"jsm: 1.2-1-INKERNEL"
104#define JSM_PARTNUM	"40002438_A-INKERNEL"
105
106struct jsm_board;
107struct jsm_channel;
108
109/************************************************************************
110 * Per board operations structure					*
111 ************************************************************************/
112struct board_ops {
113	irq_handler_t intr;
114	void (*uart_init)(struct jsm_channel *ch);
115	void (*uart_off)(struct jsm_channel *ch);
116	void (*param)(struct jsm_channel *ch);
117	void (*assert_modem_signals)(struct jsm_channel *ch);
118	void (*flush_uart_write)(struct jsm_channel *ch);
119	void (*flush_uart_read)(struct jsm_channel *ch);
120	void (*disable_receiver)(struct jsm_channel *ch);
121	void (*enable_receiver)(struct jsm_channel *ch);
122	void (*send_break)(struct jsm_channel *ch);
123	void (*clear_break)(struct jsm_channel *ch);
124	void (*send_start_character)(struct jsm_channel *ch);
125	void (*send_stop_character)(struct jsm_channel *ch);
126	void (*copy_data_from_queue_to_uart)(struct jsm_channel *ch);
127	u32 (*get_uart_bytes_left)(struct jsm_channel *ch);
128	void (*send_immediate_char)(struct jsm_channel *ch, unsigned char);
129};
130
131
132/*
133 *	Per-board information
134 */
135struct jsm_board
136{
137	int		boardnum;	/* Board number: 0-32 */
138
139	int		type;		/* Type of board */
140	u8		rev;		/* PCI revision ID */
141	struct pci_dev	*pci_dev;
142	u32		maxports;	/* MAX ports this board can handle */
143
144	spinlock_t	bd_intr_lock;	/* Used to protect the poller tasklet and
145					 * the interrupt routine from each other.
146					 */
147
148	u32		nasync;		/* Number of ports on card */
149
150	u32		irq;		/* Interrupt request number */
151
152	u64		membase;	/* Start of base memory of the card */
153	u64		membase_end;	/* End of base memory of the card */
154
155	u8	__iomem *re_map_membase;/* Remapped memory of the card */
156
157	u64		iobase;		/* Start of io base of the card */
158	u64		iobase_end;	/* End of io base of the card */
159
160	u32		bd_uart_offset;	/* Space between each UART */
161
162	struct jsm_channel *channels[MAXPORTS]; /* array of pointers to our channels. */
163
164	u32		bd_dividend;	/* Board/UARTs specific dividend */
165
166	struct board_ops *bd_ops;
167
168	struct list_head jsm_board_entry;
169};
170
171/************************************************************************
172 * Device flag definitions for ch_flags.
173 ************************************************************************/
174#define CH_PRON		0x0001		/* Printer on string		*/
175#define CH_STOP		0x0002		/* Output is stopped		*/
176#define CH_STOPI	0x0004		/* Input is stopped		*/
177#define CH_CD		0x0008		/* Carrier is present		*/
178#define CH_FCAR		0x0010		/* Carrier forced on		*/
179#define CH_HANGUP	0x0020		/* Hangup received		*/
180
181#define CH_RECEIVER_OFF	0x0040		/* Receiver is off		*/
182#define CH_OPENING	0x0080		/* Port in fragile open state	*/
183#define CH_CLOSING	0x0100		/* Port in fragile close state	*/
184#define CH_FIFO_ENABLED 0x0200		/* Port has FIFOs enabled	*/
185#define CH_TX_FIFO_EMPTY 0x0400		/* TX Fifo is completely empty	*/
186#define CH_TX_FIFO_LWM	0x0800		/* TX Fifo is below Low Water	*/
187#define CH_BREAK_SENDING 0x1000		/* Break is being sent		*/
188#define CH_LOOPBACK 0x2000		/* Channel is in lookback mode	*/
189#define CH_BAUD0	0x08000		/* Used for checking B0 transitions */
190
191/* Our Read/Error queue sizes */
192#define RQUEUEMASK	0x1FFF		/* 8 K - 1 */
193#define EQUEUEMASK	0x1FFF		/* 8 K - 1 */
194#define RQUEUESIZE	(RQUEUEMASK + 1)
195#define EQUEUESIZE	RQUEUESIZE
196
197
198/************************************************************************
199 * Channel information structure.
200 ************************************************************************/
201struct jsm_channel {
202	struct uart_port uart_port;
203	struct jsm_board	*ch_bd;		/* Board structure pointer	*/
204
205	spinlock_t	ch_lock;	/* provide for serialization */
206	wait_queue_head_t ch_flags_wait;
207
208	u32		ch_portnum;	/* Port number, 0 offset.	*/
209	u32		ch_open_count;	/* open count			*/
210	u32		ch_flags;	/* Channel flags		*/
211
212	u64		ch_close_delay;	/* How long we should drop RTS/DTR for */
213
214	tcflag_t	ch_c_iflag;	/* channel iflags		*/
215	tcflag_t	ch_c_cflag;	/* channel cflags		*/
216	tcflag_t	ch_c_oflag;	/* channel oflags		*/
217	tcflag_t	ch_c_lflag;	/* channel lflags		*/
218	u8		ch_stopc;	/* Stop character		*/
219	u8		ch_startc;	/* Start character		*/
220
221	u8		ch_mostat;	/* FEP output modem status	*/
222	u8		ch_mistat;	/* FEP input modem status	*/
223
224	/* Pointers to the "mapped" UART structs */
225	struct neo_uart_struct __iomem *ch_neo_uart; /* NEO card */
226	struct cls_uart_struct __iomem *ch_cls_uart; /* Classic card */
227
228	u8		ch_cached_lsr;	/* Cached value of the LSR register */
229
230	u8		*ch_rqueue;	/* Our read queue buffer - malloc'ed */
231	u16		ch_r_head;	/* Head location of the read queue */
232	u16		ch_r_tail;	/* Tail location of the read queue */
233
234	u8		*ch_equeue;	/* Our error queue buffer - malloc'ed */
235	u16		ch_e_head;	/* Head location of the error queue */
236	u16		ch_e_tail;	/* Tail location of the error queue */
237
238	u64		ch_rxcount;	/* total of data received so far */
239	u64		ch_txcount;	/* total of data transmitted so far */
240
241	u8		ch_r_tlevel;	/* Receive Trigger level */
242	u8		ch_t_tlevel;	/* Transmit Trigger level */
243
244	u8		ch_r_watermark;	/* Receive Watermark */
245
246
247	u32		ch_stops_sent;	/* How many times I have sent a stop character
248					 * to try to stop the other guy sending.
249					 */
250	u64		ch_err_parity;	/* Count of parity errors on channel */
251	u64		ch_err_frame;	/* Count of framing errors on channel */
252	u64		ch_err_break;	/* Count of breaks on channel */
253	u64		ch_err_overrun; /* Count of overruns on channel */
254
255	u64		ch_xon_sends;	/* Count of xons transmitted */
256	u64		ch_xoff_sends;	/* Count of xoffs transmitted */
257};
258
259/************************************************************************
260 * Per channel/port Classic UART structures				*
261 ************************************************************************
262 *		Base Structure Entries Usage Meanings to Host		*
263 *									*
264 *	W = read write		R = read only				*
265 *			U = Unused.					*
266 ************************************************************************/
267
268struct cls_uart_struct {
269	u8 txrx;	/* WR  RHR/THR - Holding Reg */
270	u8 ier;		/* WR  IER - Interrupt Enable Reg */
271	u8 isr_fcr;	/* WR  ISR/FCR - Interrupt Status Reg/Fifo Control Reg*/
272	u8 lcr;		/* WR  LCR - Line Control Reg */
273	u8 mcr;		/* WR  MCR - Modem Control Reg */
274	u8 lsr;		/* WR  LSR - Line Status Reg */
275	u8 msr;		/* WR  MSR - Modem Status Reg */
276	u8 spr;		/* WR  SPR - Scratch Pad Reg */
277};
278
279/* Where to read the interrupt register (8bits) */
280#define UART_CLASSIC_POLL_ADDR_OFFSET	0x40
281
282#define UART_EXAR654_ENHANCED_REGISTER_SET 0xBF
283
284#define UART_16654_FCR_TXTRIGGER_8	0x0
285#define UART_16654_FCR_TXTRIGGER_16	0x10
286#define UART_16654_FCR_TXTRIGGER_32	0x20
287#define UART_16654_FCR_TXTRIGGER_56	0x30
288
289#define UART_16654_FCR_RXTRIGGER_8	0x0
290#define UART_16654_FCR_RXTRIGGER_16	0x40
291#define UART_16654_FCR_RXTRIGGER_56	0x80
292#define UART_16654_FCR_RXTRIGGER_60	0xC0
293
294#define UART_IIR_CTSRTS			0x20	/* Received CTS/RTS change of state */
295#define UART_IIR_RDI_TIMEOUT		0x0C    /* Receiver data TIMEOUT */
296
297/*
298 * These are the EXTENDED definitions for the Exar 654's Interrupt
299 * Enable Register.
300 */
301#define UART_EXAR654_EFR_ECB      0x10    /* Enhanced control bit */
302#define UART_EXAR654_EFR_IXON     0x2     /* Receiver compares Xon1/Xoff1 */
303#define UART_EXAR654_EFR_IXOFF    0x8     /* Transmit Xon1/Xoff1 */
304#define UART_EXAR654_EFR_RTSDTR   0x40    /* Auto RTS/DTR Flow Control Enable */
305#define UART_EXAR654_EFR_CTSDSR   0x80    /* Auto CTS/DSR Flow COntrol Enable */
306
307#define UART_EXAR654_XOFF_DETECT  0x1     /* Indicates whether chip saw an incoming XOFF char  */
308#define UART_EXAR654_XON_DETECT   0x2     /* Indicates whether chip saw an incoming XON char */
309
310#define UART_EXAR654_IER_XOFF     0x20    /* Xoff Interrupt Enable */
311#define UART_EXAR654_IER_RTSDTR   0x40    /* Output Interrupt Enable */
312#define UART_EXAR654_IER_CTSDSR   0x80    /* Input Interrupt Enable */
313
314/************************************************************************
315 * Per channel/port NEO UART structure					*
316 ************************************************************************
317 *		Base Structure Entries Usage Meanings to Host		*
318 *									*
319 *	W = read write		R = read only				*
320 *			U = Unused.					*
321 ************************************************************************/
322
323struct neo_uart_struct {
324	 u8 txrx;		/* WR	RHR/THR - Holding Reg */
325	 u8 ier;		/* WR	IER - Interrupt Enable Reg */
326	 u8 isr_fcr;		/* WR	ISR/FCR - Interrupt Status Reg/Fifo Control Reg */
327	 u8 lcr;		/* WR	LCR - Line Control Reg */
328	 u8 mcr;		/* WR	MCR - Modem Control Reg */
329	 u8 lsr;		/* WR	LSR - Line Status Reg */
330	 u8 msr;		/* WR	MSR - Modem Status Reg */
331	 u8 spr;		/* WR	SPR - Scratch Pad Reg */
332	 u8 fctr;		/* WR	FCTR - Feature Control Reg */
333	 u8 efr;		/* WR	EFR - Enhanced Function Reg */
334	 u8 tfifo;		/* WR	TXCNT/TXTRG - Transmit FIFO Reg */
335	 u8 rfifo;		/* WR	RXCNT/RXTRG - Receive FIFO Reg */
336	 u8 xoffchar1;	/* WR	XOFF 1 - XOff Character 1 Reg */
337	 u8 xoffchar2;	/* WR	XOFF 2 - XOff Character 2 Reg */
338	 u8 xonchar1;	/* WR	XON 1 - Xon Character 1 Reg */
339	 u8 xonchar2;	/* WR	XON 2 - XOn Character 2 Reg */
340
341	 u8 reserved1[0x2ff - 0x200]; /* U	Reserved by Exar */
342	 u8 txrxburst[64];	/* RW	64 bytes of RX/TX FIFO Data */
343	 u8 reserved2[0x37f - 0x340]; /* U	Reserved by Exar */
344	 u8 rxburst_with_errors[64];	/* R	64 bytes of RX FIFO Data + LSR */
345};
346
347/* Where to read the extended interrupt register (32bits instead of 8bits) */
348#define	UART_17158_POLL_ADDR_OFFSET	0x80
349
350/*
351 * These are the redefinitions for the FCTR on the XR17C158, since
352 * Exar made them different than their earlier design. (XR16C854)
353 */
354
355/* These are only applicable when table D is selected */
356#define UART_17158_FCTR_RTS_NODELAY	0x00
357#define UART_17158_FCTR_RTS_4DELAY	0x01
358#define UART_17158_FCTR_RTS_6DELAY	0x02
359#define UART_17158_FCTR_RTS_8DELAY	0x03
360#define UART_17158_FCTR_RTS_12DELAY	0x12
361#define UART_17158_FCTR_RTS_16DELAY	0x05
362#define UART_17158_FCTR_RTS_20DELAY	0x13
363#define UART_17158_FCTR_RTS_24DELAY	0x06
364#define UART_17158_FCTR_RTS_28DELAY	0x14
365#define UART_17158_FCTR_RTS_32DELAY	0x07
366#define UART_17158_FCTR_RTS_36DELAY	0x16
367#define UART_17158_FCTR_RTS_40DELAY	0x08
368#define UART_17158_FCTR_RTS_44DELAY	0x09
369#define UART_17158_FCTR_RTS_48DELAY	0x10
370#define UART_17158_FCTR_RTS_52DELAY	0x11
371
372#define UART_17158_FCTR_RTS_IRDA	0x10
373#define UART_17158_FCTR_RS485		0x20
374#define UART_17158_FCTR_TRGA		0x00
375#define UART_17158_FCTR_TRGB		0x40
376#define UART_17158_FCTR_TRGC		0x80
377#define UART_17158_FCTR_TRGD		0xC0
378
379/* 17158 trigger table selects.. */
380#define UART_17158_FCTR_BIT6		0x40
381#define UART_17158_FCTR_BIT7		0x80
382
383/* 17158 TX/RX memmapped buffer offsets */
384#define UART_17158_RX_FIFOSIZE		64
385#define UART_17158_TX_FIFOSIZE		64
386
387/* 17158 Extended IIR's */
388#define UART_17158_IIR_RDI_TIMEOUT	0x0C	/* Receiver data TIMEOUT */
389#define UART_17158_IIR_XONXOFF		0x10	/* Received an XON/XOFF char */
390#define UART_17158_IIR_HWFLOW_STATE_CHANGE 0x20	/* CTS/DSR or RTS/DTR state change */
391#define UART_17158_IIR_FIFO_ENABLED	0xC0	/* 16550 FIFOs are Enabled */
392
393/*
394 * These are the extended interrupts that get sent
395 * back to us from the UART's 32bit interrupt register
396 */
397#define UART_17158_RX_LINE_STATUS	0x1	/* RX Ready */
398#define UART_17158_RXRDY_TIMEOUT	0x2	/* RX Ready Timeout */
399#define UART_17158_TXRDY		0x3	/* TX Ready */
400#define UART_17158_MSR			0x4	/* Modem State Change */
401#define UART_17158_TX_AND_FIFO_CLR	0x40	/* Transmitter Holding Reg Empty */
402#define UART_17158_RX_FIFO_DATA_ERROR	0x80	/* UART detected an RX FIFO Data error */
403
404/*
405 * These are the EXTENDED definitions for the 17C158's Interrupt
406 * Enable Register.
407 */
408#define UART_17158_EFR_ECB	0x10	/* Enhanced control bit */
409#define UART_17158_EFR_IXON	0x2	/* Receiver compares Xon1/Xoff1 */
410#define UART_17158_EFR_IXOFF	0x8	/* Transmit Xon1/Xoff1 */
411#define UART_17158_EFR_RTSDTR	0x40	/* Auto RTS/DTR Flow Control Enable */
412#define UART_17158_EFR_CTSDSR	0x80	/* Auto CTS/DSR Flow COntrol Enable */
413
414#define UART_17158_XOFF_DETECT	0x1	/* Indicates whether chip saw an incoming XOFF char */
415#define UART_17158_XON_DETECT	0x2	/* Indicates whether chip saw an incoming XON char */
416
417#define UART_17158_IER_RSVD1	0x10	/* Reserved by Exar */
418#define UART_17158_IER_XOFF	0x20	/* Xoff Interrupt Enable */
419#define UART_17158_IER_RTSDTR	0x40	/* Output Interrupt Enable */
420#define UART_17158_IER_CTSDSR	0x80	/* Input Interrupt Enable */
421
422#define PCI_DEVICE_NEO_2DB9_PCI_NAME		"Neo 2 - DB9 Universal PCI"
423#define PCI_DEVICE_NEO_2DB9PRI_PCI_NAME		"Neo 2 - DB9 Universal PCI - Powered Ring Indicator"
424#define PCI_DEVICE_NEO_2RJ45_PCI_NAME		"Neo 2 - RJ45 Universal PCI"
425#define PCI_DEVICE_NEO_2RJ45PRI_PCI_NAME	"Neo 2 - RJ45 Universal PCI - Powered Ring Indicator"
426#define PCIE_DEVICE_NEO_IBM_PCI_NAME		"Neo 4 - PCI Express - IBM"
427
428/*
429 * Our Global Variables.
430 */
431extern struct	uart_driver jsm_uart_driver;
432extern struct	board_ops jsm_neo_ops;
433extern struct	board_ops jsm_cls_ops;
434extern int	jsm_debug;
435
436/*************************************************************************
437 *
438 * Prototypes for non-static functions used in more than one module
439 *
440 *************************************************************************/
441int jsm_tty_init(struct jsm_board *);
442int jsm_uart_port_init(struct jsm_board *);
443int jsm_remove_uart_port(struct jsm_board *);
444void jsm_input(struct jsm_channel *ch);
445void jsm_check_queue_flow_control(struct jsm_channel *ch);
446
447#endif
448