2 * Copyright 2003 Digi International (www.digi.com)
3 * Scott H Kilau <Scott_Kilau at digi dot com>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2, or (at your option)
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED; without even the
12 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
13 * PURPOSE. See the GNU General Public License for more details.
15 *************************************************************************
19 *************************************************************************/
21 #ifndef __DGNC_DRIVER_H
22 #define __DGNC_DRIVER_H
24 #include <linux/types.h>
25 #include <linux/tty.h>
26 #include <linux/interrupt.h>
28 #include "digi.h" /* Digi specific ioctl header */
29 #include "dgnc_sysfs.h" /* Support for SYSFS */
31 /*************************************************************************
35 *************************************************************************/
37 /* Driver identification and error statments */
38 #define PROCSTR "dgnc" /* /proc entries */
39 #define DEVSTR "/dev/dg/dgnc" /* /dev entries */
40 #define DRVSTR "dgnc" /* Driver name string */
41 #define DG_PART "40002369_F" /* RPM part number */
43 #define TRC_TO_CONSOLE 1
45 /* Number of boards we support at once. */
48 #define MAXTTYNAMELEN 200
50 /* Our 3 magic numbers for our board, channel and unit structs */
51 #define DGNC_BOARD_MAGIC 0x5c6df104
52 #define DGNC_CHANNEL_MAGIC 0x6c6df104
53 #define DGNC_UNIT_MAGIC 0x7c6df104
55 /* Serial port types */
59 #define SERIAL_TYPE_NORMAL 1
61 #define PORT_NUM(dev) ((dev) & 0x7f)
62 #define IS_PRINT(dev) (((dev) & 0xff) >= 0x80)
64 /* MAX number of stop characters we will send
65 * when our read queue is getting full
67 #define MAX_STOPS_SENT 5
69 /* 4 extra for alignment play space */
70 #define WRITEBUFLEN ((4096) + 4)
72 #define dgnc_jiffies_from_ms(a) (((a) * HZ) / 1000)
75 * Define a local default termios struct. All ports will be created
76 * with this termios initially. This is the same structure that is defined
77 * as the default in tty_io.c with the same settings overridden as in serial.c
79 * In short, this should match the internal serial ports' defaults.
81 #define DEFAULT_IFLAGS (ICRNL | IXON)
82 #define DEFAULT_OFLAGS (OPOST | ONLCR)
83 #define DEFAULT_CFLAGS (B9600 | CS8 | CREAD | HUPCL | CLOCAL)
84 #define DEFAULT_LFLAGS (ISIG | ICANON | ECHO | ECHOE | ECHOK | \
85 ECHOCTL | ECHOKE | IEXTEN)
87 #ifndef _POSIX_VDISABLE
88 #define _POSIX_VDISABLE '\0'
92 * All the possible states the driver can be while being loaded.
95 DRIVER_INITIALIZED = 0,
100 * All the possible states the board can be while booting up.
108 /*************************************************************************
110 * Structures and closely related defines.
112 *************************************************************************/
117 /************************************************************************
118 * Per board operations structure *
119 ************************************************************************/
121 void (*tasklet)(unsigned long data);
122 irqreturn_t (*intr)(int irq, void *voidbrd);
123 void (*uart_init)(struct channel_t *ch);
124 void (*uart_off)(struct channel_t *ch);
125 int (*drain)(struct tty_struct *tty, uint seconds);
126 void (*param)(struct tty_struct *tty);
127 void (*vpd)(struct dgnc_board *brd);
128 void (*assert_modem_signals)(struct channel_t *ch);
129 void (*flush_uart_write)(struct channel_t *ch);
130 void (*flush_uart_read)(struct channel_t *ch);
131 void (*disable_receiver)(struct channel_t *ch);
132 void (*enable_receiver)(struct channel_t *ch);
133 void (*send_break)(struct channel_t *ch, int);
134 void (*send_start_character)(struct channel_t *ch);
135 void (*send_stop_character)(struct channel_t *ch);
136 void (*copy_data_from_queue_to_uart)(struct channel_t *ch);
137 uint (*get_uart_bytes_left)(struct channel_t *ch);
138 void (*send_immediate_char)(struct channel_t *ch, unsigned char);
141 /************************************************************************
142 * Device flag definitions for bd_flags.
143 ************************************************************************/
144 #define BD_IS_PCI_EXPRESS 0x0001 /* Is a PCI Express board */
147 * Per-board information
150 int magic; /* Board Magic number. */
151 int boardnum; /* Board number: 0-32 */
153 int type; /* Type of board */
154 char *name; /* Product Name */
155 struct pci_dev *pdev; /* Pointer to the pci_dev struct */
156 unsigned long bd_flags; /* Board flags */
157 u16 vendor; /* PCI vendor ID */
158 u16 device; /* PCI device ID */
159 u16 subvendor; /* PCI subsystem vendor ID */
160 u16 subdevice; /* PCI subsystem device ID */
161 unsigned char rev; /* PCI revision ID */
162 uint pci_bus; /* PCI bus value */
163 uint pci_slot; /* PCI slot value */
164 uint maxports; /* MAX ports this board can handle */
165 unsigned char dvid; /* Board specific device id */
166 unsigned char vpd[128]; /* VPD of board, if found */
167 unsigned char serial_num[20]; /* Serial number of board,
171 spinlock_t bd_lock; /* Used to protect board */
173 spinlock_t bd_intr_lock; /* Used to protect the poller tasklet
174 * and the interrupt routine from each
178 uint state; /* State of card. */
179 wait_queue_head_t state_wait; /* Place to sleep on for state change */
181 struct tasklet_struct helper_tasklet; /* Poll helper tasklet */
183 uint nasync; /* Number of ports on card */
185 uint irq; /* Interrupt request number */
186 ulong intr_count; /* Count of interrupts */
187 ulong intr_modem; /* Count of interrupts */
188 ulong intr_tx; /* Count of interrupts */
189 ulong intr_rx; /* Count of interrupts */
191 ulong membase; /* Start of base memory of the card */
192 ulong membase_end; /* End of base memory of the card */
194 u8 __iomem *re_map_membase; /* Remapped memory of the card */
196 ulong iobase; /* Start of io base of the card */
197 ulong iobase_end; /* End of io base of the card */
199 uint bd_uart_offset; /* Space between each UART */
201 struct channel_t *channels[MAXPORTS]; /* array of pointers
205 struct tty_driver *serial_driver;
206 char serial_name[200];
207 struct tty_driver *print_driver;
208 char print_name[200];
210 bool dgnc_major_serial_registered;
211 bool dgnc_major_transparent_print_registered;
213 u16 dpatype; /* The board "type",
216 u16 dpastatus; /* The board "status",
226 uint bd_dividend; /* Board/UARTs specific dividend */
228 struct board_ops *bd_ops;
230 /* /proc/<board> entries */
231 struct proc_dir_entry *proc_entry_pointer;
232 struct dgnc_proc_entry *dgnc_board_table;
236 /************************************************************************
237 * Unit flag definitions for un_flags.
238 ************************************************************************/
239 #define UN_ISOPEN 0x0001 /* Device is open */
240 #define UN_CLOSING 0x0002 /* Line is being closed */
241 #define UN_IMM 0x0004 /* Service immediately */
242 #define UN_BUSY 0x0008 /* Some work this channel */
243 #define UN_BREAKI 0x0010 /* Input break received */
244 #define UN_PWAIT 0x0020 /* Printer waiting for terminal */
245 #define UN_TIME 0x0040 /* Waiting on time */
246 #define UN_EMPTY 0x0080 /* Waiting output queue empty */
247 #define UN_LOW 0x0100 /* Waiting output low water mark*/
248 #define UN_EXCL_OPEN 0x0200 /* Open for exclusive use */
249 #define UN_WOPEN 0x0400 /* Device waiting for open */
250 #define UN_WIOCTL 0x0800 /* Device waiting for open */
251 #define UN_HANGUP 0x8000 /* Carrier lost */
255 /************************************************************************
256 * Structure for terminal or printer unit.
257 ************************************************************************/
259 int magic; /* Unit Magic Number. */
260 struct channel_t *un_ch;
263 uint un_open_count; /* Counter of opens to port */
264 struct tty_struct *un_tty;/* Pointer to unit tty structure */
265 uint un_flags; /* Unit flags */
266 wait_queue_head_t un_flags_wait; /* Place to sleep to wait on unit */
267 uint un_dev; /* Minor device number */
268 struct device *un_sysfs;
271 /************************************************************************
272 * Device flag definitions for ch_flags.
273 ************************************************************************/
274 #define CH_PRON 0x0001 /* Printer on string */
275 #define CH_STOP 0x0002 /* Output is stopped */
276 #define CH_STOPI 0x0004 /* Input is stopped */
277 #define CH_CD 0x0008 /* Carrier is present */
278 #define CH_FCAR 0x0010 /* Carrier forced on */
279 #define CH_HANGUP 0x0020 /* Hangup received */
281 #define CH_RECEIVER_OFF 0x0040 /* Receiver is off */
282 #define CH_OPENING 0x0080 /* Port in fragile open state */
283 #define CH_CLOSING 0x0100 /* Port in fragile close state */
284 #define CH_FIFO_ENABLED 0x0200 /* Port has FIFOs enabled */
285 #define CH_TX_FIFO_EMPTY 0x0400 /* TX Fifo is completely empty */
286 #define CH_TX_FIFO_LWM 0x0800 /* TX Fifo is below Low Water */
287 #define CH_BREAK_SENDING 0x1000 /* Break is being sent */
288 #define CH_LOOPBACK 0x2000 /* Channel is in lookback mode */
289 #define CH_BAUD0 0x08000 /* Used for checking B0 transitions */
290 #define CH_FORCED_STOP 0x20000 /* Output is forcibly stopped */
291 #define CH_FORCED_STOPI 0x40000 /* Input is forcibly stopped */
293 /* Our Read/Error/Write queue sizes */
294 #define RQUEUEMASK 0x1FFF /* 8 K - 1 */
295 #define EQUEUEMASK 0x1FFF /* 8 K - 1 */
296 #define WQUEUEMASK 0x0FFF /* 4 K - 1 */
297 #define RQUEUESIZE (RQUEUEMASK + 1)
298 #define EQUEUESIZE RQUEUESIZE
299 #define WQUEUESIZE (WQUEUEMASK + 1)
301 /************************************************************************
302 * Channel information structure.
303 ************************************************************************/
305 int magic; /* Channel Magic Number */
306 struct dgnc_board *ch_bd; /* Board structure pointer */
307 struct digi_t ch_digi; /* Transparent Print structure */
308 struct un_t ch_tun; /* Terminal unit info */
309 struct un_t ch_pun; /* Printer unit info */
311 spinlock_t ch_lock; /* provide for serialization */
312 wait_queue_head_t ch_flags_wait;
314 uint ch_portnum; /* Port number, 0 offset. */
315 uint ch_open_count; /* open count */
316 uint ch_flags; /* Channel flags */
318 ulong ch_close_delay; /* How long we should
322 ulong ch_cpstime; /* Time for CPS calculations */
324 tcflag_t ch_c_iflag; /* channel iflags */
325 tcflag_t ch_c_cflag; /* channel cflags */
326 tcflag_t ch_c_oflag; /* channel oflags */
327 tcflag_t ch_c_lflag; /* channel lflags */
328 unsigned char ch_stopc; /* Stop character */
329 unsigned char ch_startc; /* Start character */
331 uint ch_old_baud; /* Cache of the current baud */
332 uint ch_custom_speed;/* Custom baud, if set */
334 uint ch_wopen; /* Waiting for open process cnt */
336 unsigned char ch_mostat; /* FEP output modem status */
337 unsigned char ch_mistat; /* FEP input modem status */
339 struct neo_uart_struct __iomem *ch_neo_uart; /* Pointer to the
340 * "mapped" UART struct
342 struct cls_uart_struct __iomem *ch_cls_uart; /* Pointer to the
343 * "mapped" UART struct
346 unsigned char ch_cached_lsr; /* Cached value of the LSR register */
348 unsigned char *ch_rqueue; /* Our read queue buffer - malloc'ed */
349 ushort ch_r_head; /* Head location of the read queue */
350 ushort ch_r_tail; /* Tail location of the read queue */
352 unsigned char *ch_equeue; /* Our error queue buffer - malloc'ed */
353 ushort ch_e_head; /* Head location of the error queue */
354 ushort ch_e_tail; /* Tail location of the error queue */
356 unsigned char *ch_wqueue; /* Our write queue buffer - malloc'ed */
357 ushort ch_w_head; /* Head location of the write queue */
358 ushort ch_w_tail; /* Tail location of the write queue */
360 ulong ch_rxcount; /* total of data received so far */
361 ulong ch_txcount; /* total of data transmitted so far */
363 unsigned char ch_r_tlevel; /* Receive Trigger level */
364 unsigned char ch_t_tlevel; /* Transmit Trigger level */
366 unsigned char ch_r_watermark; /* Receive Watermark */
368 ulong ch_stop_sending_break; /* Time we should STOP
372 uint ch_stops_sent; /* How many times I have sent a stop
373 * character to try to stop the other
376 ulong ch_err_parity; /* Count of parity errors on channel */
377 ulong ch_err_frame; /* Count of framing errors on channel */
378 ulong ch_err_break; /* Count of breaks on channel */
379 ulong ch_err_overrun; /* Count of overruns on channel */
381 ulong ch_xon_sends; /* Count of xons transmitted */
382 ulong ch_xoff_sends; /* Count of xoffs transmitted */
384 ulong ch_intr_modem; /* Count of interrupts */
385 ulong ch_intr_tx; /* Count of interrupts */
386 ulong ch_intr_rx; /* Count of interrupts */
388 /* /proc/<board>/<channel> entries */
389 struct proc_dir_entry *proc_entry_pointer;
390 struct dgnc_proc_entry *dgnc_channel_table;
395 * Our Global Variables.
397 extern uint dgnc_major; /* Our driver/mgmt major */
398 extern int dgnc_poll_tick; /* Poll interval - 20 ms */
399 extern spinlock_t dgnc_global_lock; /* Driver global spinlock */
400 extern spinlock_t dgnc_poll_lock; /* Poll scheduling lock */
401 extern uint dgnc_num_boards; /* Total number of boards */
402 extern struct dgnc_board *dgnc_board[MAXBOARDS]; /* Array of board