Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
icn.h
Go to the documentation of this file.
1 /* $Id: icn.h,v 1.30.6.5 2001/09/23 22:24:55 kai Exp $
2  *
3  * ISDN lowlevel-module for the ICN active ISDN-Card.
4  *
5  * Copyright 1994 by Fritz Elfert ([email protected])
6  *
7  * This software may be used and distributed according to the terms
8  * of the GNU General Public License, incorporated herein by reference.
9  *
10  */
11 
12 #ifndef icn_h
13 #define icn_h
14 
15 #define ICN_IOCTL_SETMMIO 0
16 #define ICN_IOCTL_GETMMIO 1
17 #define ICN_IOCTL_SETPORT 2
18 #define ICN_IOCTL_GETPORT 3
19 #define ICN_IOCTL_LOADBOOT 4
20 #define ICN_IOCTL_LOADPROTO 5
21 #define ICN_IOCTL_LEASEDCFG 6
22 #define ICN_IOCTL_GETDOUBLE 7
23 #define ICN_IOCTL_DEBUGVAR 8
24 #define ICN_IOCTL_ADDCARD 9
25 
26 /* Struct for adding new cards */
27 typedef struct icn_cdef {
28  int port;
29  char id1[10];
30  char id2[10];
31 } icn_cdef;
32 
33 #if defined(__KERNEL__) || defined(__DEBUGVAR__)
34 
35 #ifdef __KERNEL__
36 /* Kernel includes */
37 
38 #include <linux/errno.h>
39 #include <linux/fs.h>
40 #include <linux/major.h>
41 #include <asm/io.h>
42 #include <linux/kernel.h>
43 #include <linux/signal.h>
44 #include <linux/slab.h>
45 #include <linux/mm.h>
46 #include <linux/mman.h>
47 #include <linux/ioport.h>
48 #include <linux/timer.h>
49 #include <linux/wait.h>
50 #include <linux/delay.h>
51 #include <linux/isdnif.h>
52 
53 #endif /* __KERNEL__ */
54 
55 /* some useful macros for debugging */
56 #ifdef ICN_DEBUG_PORT
57 #define OUTB_P(v, p) {printk(KERN_DEBUG "icn: outb_p(0x%02x,0x%03x)\n", v, p); outb_p(v, p);}
58 #else
59 #define OUTB_P outb
60 #endif
61 
62 /* Defaults for Port-Address and shared-memory */
63 #define ICN_BASEADDR 0x320
64 #define ICN_PORTLEN (0x04)
65 #define ICN_MEMADDR 0x0d0000
66 
67 #define ICN_FLAGS_B1ACTIVE 1 /* B-Channel-1 is open */
68 #define ICN_FLAGS_B2ACTIVE 2 /* B-Channel-2 is open */
69 #define ICN_FLAGS_RUNNING 4 /* Cards driver activated */
70 #define ICN_FLAGS_RBTIMER 8 /* cyclic scheduling of B-Channel-poll */
71 
72 #define ICN_BOOT_TIMEOUT1 1000 /* Delay for Boot-download (msecs) */
73 
74 #define ICN_TIMER_BCREAD (HZ / 100) /* B-Channel poll-cycle */
75 #define ICN_TIMER_DCREAD (HZ / 2) /* D-Channel poll-cycle */
76 
77 #define ICN_CODE_STAGE1 4096 /* Size of bootcode */
78 #define ICN_CODE_STAGE2 65536 /* Size of protocol-code */
79 
80 #define ICN_MAX_SQUEUE 8000 /* Max. outstanding send-data (2* hw-buf.) */
81 #define ICN_FRAGSIZE (250) /* Max. size of send-fragments */
82 #define ICN_BCH 2 /* Number of supported channels per card */
83 
84 /* type-definitions for accessing the mmap-io-areas */
85 
86 #define SHM_DCTL_OFFSET (0) /* Offset to data-controlstructures in shm */
87 #define SHM_CCTL_OFFSET (0x1d2) /* Offset to comm-controlstructures in shm */
88 #define SHM_CBUF_OFFSET (0x200) /* Offset to comm-buffers in shm */
89 #define SHM_DBUF_OFFSET (0x2000) /* Offset to data-buffers in shm */
90 
91 /*
92  * Layout of card's data buffers
93  */
94 typedef struct {
95  unsigned char length; /* Bytecount of fragment (max 250) */
96  unsigned char endflag; /* 0=last frag., 0xff=frag. continued */
97  unsigned char data[ICN_FRAGSIZE]; /* The data */
98  /* Fill to 256 bytes */
99  char unused[0x100 - ICN_FRAGSIZE - 2];
100 } frag_buf;
101 
102 /*
103  * Layout of card's shared memory
104  */
105 typedef union {
106  struct {
107  unsigned char scns; /* Index to free SendFrag. */
108  unsigned char scnr; /* Index to active SendFrag READONLY */
109  unsigned char ecns; /* Index to free RcvFrag. READONLY */
110  unsigned char ecnr; /* Index to valid RcvFrag */
111  char unused[6];
112  unsigned short fuell1; /* Internal Buf Bytecount */
113  } data_control;
114  struct {
115  char unused[SHM_CCTL_OFFSET];
116  unsigned char iopc_i; /* Read-Ptr Status-Queue READONLY */
117  unsigned char iopc_o; /* Write-Ptr Status-Queue */
118  unsigned char pcio_i; /* Write-Ptr Command-Queue */
119  unsigned char pcio_o; /* Read-Ptr Command Queue READONLY */
120  } comm_control;
121  struct {
122  char unused[SHM_CBUF_OFFSET];
123  unsigned char pcio_buf[0x100]; /* Ring-Buffer Command-Queue */
124  unsigned char iopc_buf[0x100]; /* Ring-Buffer Status-Queue */
125  } comm_buffers;
126  struct {
127  char unused[SHM_DBUF_OFFSET];
128  frag_buf receive_buf[0x10];
129  frag_buf send_buf[0x10];
130  } data_buffers;
131 } icn_shmem;
132 
133 /*
134  * Per card driver data
135  */
136 typedef struct icn_card {
137  struct icn_card *next; /* Pointer to next device struct */
138  struct icn_card *other; /* Pointer to other card for ICN4B */
139  unsigned short port; /* Base-port-address */
140  int myid; /* Driver-Nr. assigned by linklevel */
141  int rvalid; /* IO-portregion has been requested */
142  int leased; /* Flag: This Adapter is connected */
143  /* to a leased line */
144  unsigned short flags; /* Statusflags */
145  int doubleS0; /* Flag: ICN4B */
146  int secondhalf; /* Flag: Second half of a doubleS0 */
147  int fw_rev; /* Firmware revision loaded */
148  int ptype; /* Protocol type (1TR6 or Euro) */
149  struct timer_list st_timer; /* Timer for Status-Polls */
150  struct timer_list rb_timer; /* Timer for B-Channel-Polls */
151  u_char rcvbuf[ICN_BCH][4096]; /* B-Channel-Receive-Buffers */
152  int rcvidx[ICN_BCH]; /* Index for above buffers */
153  int l2_proto[ICN_BCH]; /* Current layer-2-protocol */
154  isdn_if interface; /* Interface to upper layer */
155  int iptr; /* Index to imsg-buffer */
156  char imsg[60]; /* Internal buf for status-parsing */
157  char msg_buf[2048]; /* Buffer for status-messages */
158  char *msg_buf_write; /* Writepointer for statusbuffer */
159  char *msg_buf_read; /* Readpointer for statusbuffer */
160  char *msg_buf_end; /* Pointer to end of statusbuffer */
161  int sndcount[ICN_BCH]; /* Byte-counters for B-Ch.-send */
162  int xlen[ICN_BCH]; /* Byte-counters/Flags for sent-ACK */
163  struct sk_buff *xskb[ICN_BCH]; /* Current transmitted skb */
164  struct sk_buff_head spqueue[ICN_BCH]; /* Sendqueue */
165  char regname[35]; /* Name used for request_region */
166  u_char xmit_lock[ICN_BCH]; /* Semaphore for pollbchan_send()*/
167  spinlock_t lock; /* protect critical operations */
168 } icn_card;
169 
170 /*
171  * Main driver data
172  */
173 typedef struct icn_dev {
174  spinlock_t devlock; /* spinlock to protect this struct */
175  unsigned long memaddr; /* Address of memory mapped buffers */
176  icn_shmem __iomem *shmem; /* Pointer to memory-mapped-buffers */
177  int mvalid; /* IO-shmem has been requested */
178  int channel; /* Currently mapped channel */
179  struct icn_card *mcard; /* Currently mapped card */
180  int chanlock; /* Semaphore for channel-mapping */
181  int firstload; /* Flag: firmware never loaded */
182 } icn_dev;
183 
184 typedef icn_dev *icn_devptr;
185 
186 #ifdef __KERNEL__
187 
188 static icn_card *cards = (icn_card *) 0;
189 static u_char chan2bank[] =
190 {0, 4, 8, 12}; /* for icn_map_channel() */
191 
192 static icn_dev dev;
193 
194 #endif /* __KERNEL__ */
195 
196 /* Utility-Macros */
197 
198 /* Macros for accessing ports */
199 #define ICN_CFG (card->port)
200 #define ICN_MAPRAM (card->port + 1)
201 #define ICN_RUN (card->port + 2)
202 #define ICN_BANK (card->port + 3)
203 
204 /* Return true, if there is a free transmit-buffer */
205 #define sbfree (((readb(&dev.shmem->data_control.scns) + 1) & 0xf) != \
206  readb(&dev.shmem->data_control.scnr))
207 
208 /* Switch to next transmit-buffer */
209 #define sbnext (writeb((readb(&dev.shmem->data_control.scns) + 1) & 0xf, \
210  &dev.shmem->data_control.scns))
211 
212 /* Shortcuts for transmit-buffer-access */
213 #define sbuf_n dev.shmem->data_control.scns
214 #define sbuf_d dev.shmem->data_buffers.send_buf[readb(&sbuf_n)].data
215 #define sbuf_l dev.shmem->data_buffers.send_buf[readb(&sbuf_n)].length
216 #define sbuf_f dev.shmem->data_buffers.send_buf[readb(&sbuf_n)].endflag
217 
218 /* Return true, if there is receive-data is available */
219 #define rbavl (readb(&dev.shmem->data_control.ecnr) != \
220  readb(&dev.shmem->data_control.ecns))
221 
222 /* Switch to next receive-buffer */
223 #define rbnext (writeb((readb(&dev.shmem->data_control.ecnr) + 1) & 0xf, \
224  &dev.shmem->data_control.ecnr))
225 
226 /* Shortcuts for receive-buffer-access */
227 #define rbuf_n dev.shmem->data_control.ecnr
228 #define rbuf_d dev.shmem->data_buffers.receive_buf[readb(&rbuf_n)].data
229 #define rbuf_l dev.shmem->data_buffers.receive_buf[readb(&rbuf_n)].length
230 #define rbuf_f dev.shmem->data_buffers.receive_buf[readb(&rbuf_n)].endflag
231 
232 /* Shortcuts for command-buffer-access */
233 #define cmd_o (dev.shmem->comm_control.pcio_o)
234 #define cmd_i (dev.shmem->comm_control.pcio_i)
235 
236 /* Return free space in command-buffer */
237 #define cmd_free ((readb(&cmd_i) >= readb(&cmd_o)) ? \
238  0x100 - readb(&cmd_i) + readb(&cmd_o) : \
239  readb(&cmd_o) - readb(&cmd_i))
240 
241 /* Shortcuts for message-buffer-access */
242 #define msg_o (dev.shmem->comm_control.iopc_o)
243 #define msg_i (dev.shmem->comm_control.iopc_i)
244 
245 /* Return length of Message, if avail. */
246 #define msg_avail ((readb(&msg_o) > readb(&msg_i)) ? \
247  0x100 - readb(&msg_o) + readb(&msg_i) : \
248  readb(&msg_i) - readb(&msg_o))
249 
250 #define CID (card->interface.id)
251 
252 #endif /* defined(__KERNEL__) || defined(__DEBUGVAR__) */
253 #endif /* icn_h */