Merge branch 'upstream-linus' of master.kernel.org:/pub/scm/linux/kernel/git/jgarzik...
[linux-2.6] / include / linux / hdlcdrv.h
1 /*
2  * hdlcdrv.h  -- HDLC packet radio network driver.
3  * The Linux soundcard driver for 1200 baud and 9600 baud packet radio
4  * (C) 1996-1998 by Thomas Sailer, HB9JNX/AE4WA
5  */
6
7 #ifndef _HDLCDRV_H
8 #define _HDLCDRV_H
9
10 /* -------------------------------------------------------------------- */
11 /*
12  * structs for the IOCTL commands
13  */
14
15 struct hdlcdrv_params {
16         int iobase;
17         int irq;
18         int dma;
19         int dma2;
20         int seriobase;
21         int pariobase;
22         int midiiobase;
23 };      
24
25 struct hdlcdrv_channel_params {
26         int tx_delay;  /* the transmitter keyup delay in 10ms units */
27         int tx_tail;   /* the transmitter keyoff delay in 10ms units */
28         int slottime;  /* the slottime in 10ms; usually 10 = 100ms */
29         int ppersist;  /* the p-persistence 0..255 */
30         int fulldup;   /* some driver do not support full duplex, setting */
31                        /* this just makes them send even if DCD is on */
32 };      
33
34 struct hdlcdrv_old_channel_state {
35         int ptt;
36         int dcd;
37         int ptt_keyed;
38 };
39
40 struct hdlcdrv_channel_state {
41         int ptt;
42         int dcd;
43         int ptt_keyed;
44         unsigned long tx_packets;
45         unsigned long tx_errors;
46         unsigned long rx_packets;
47         unsigned long rx_errors;
48 };
49
50 struct hdlcdrv_ioctl {
51         int cmd;
52         union {
53                 struct hdlcdrv_params mp;
54                 struct hdlcdrv_channel_params cp;
55                 struct hdlcdrv_channel_state cs;
56                 struct hdlcdrv_old_channel_state ocs;
57                 unsigned int calibrate;
58                 unsigned char bits;
59                 char modename[128];
60                 char drivername[32];
61         } data;
62 };
63
64 /* -------------------------------------------------------------------- */
65
66 /*
67  * ioctl values
68  */
69 #define HDLCDRVCTL_GETMODEMPAR       0
70 #define HDLCDRVCTL_SETMODEMPAR       1
71 #define HDLCDRVCTL_MODEMPARMASK      2  /* not handled by hdlcdrv */
72 #define HDLCDRVCTL_GETCHANNELPAR    10
73 #define HDLCDRVCTL_SETCHANNELPAR    11
74 #define HDLCDRVCTL_OLDGETSTAT       20
75 #define HDLCDRVCTL_CALIBRATE        21
76 #define HDLCDRVCTL_GETSTAT          22
77
78 /*
79  * these are mainly for debugging purposes
80  */
81 #define HDLCDRVCTL_GETSAMPLES       30
82 #define HDLCDRVCTL_GETBITS          31
83
84 /*
85  * not handled by hdlcdrv, but by its depending drivers
86  */
87 #define HDLCDRVCTL_GETMODE          40
88 #define HDLCDRVCTL_SETMODE          41
89 #define HDLCDRVCTL_MODELIST         42
90 #define HDLCDRVCTL_DRIVERNAME       43
91
92 /*
93  * mask of needed modem parameters, returned by HDLCDRVCTL_MODEMPARMASK
94  */
95 #define HDLCDRV_PARMASK_IOBASE      (1<<0)
96 #define HDLCDRV_PARMASK_IRQ         (1<<1)
97 #define HDLCDRV_PARMASK_DMA         (1<<2)
98 #define HDLCDRV_PARMASK_DMA2        (1<<3)
99 #define HDLCDRV_PARMASK_SERIOBASE   (1<<4)
100 #define HDLCDRV_PARMASK_PARIOBASE   (1<<5)
101 #define HDLCDRV_PARMASK_MIDIIOBASE  (1<<6)
102
103 /* -------------------------------------------------------------------- */
104
105 #ifdef __KERNEL__
106
107 #include <linux/netdevice.h>
108 #include <linux/if.h>
109 #include <linux/spinlock.h>
110
111 #define HDLCDRV_MAGIC      0x5ac6e778
112 #define HDLCDRV_HDLCBUFFER  32 /* should be a power of 2 for speed reasons */
113 #define HDLCDRV_BITBUFFER  256 /* should be a power of 2 for speed reasons */
114 #undef HDLCDRV_LOOPBACK  /* define for HDLC debugging purposes */
115 #define HDLCDRV_DEBUG
116
117 /* maximum packet length, excluding CRC */
118 #define HDLCDRV_MAXFLEN             400 
119
120
121 struct hdlcdrv_hdlcbuffer {
122         spinlock_t lock;
123         unsigned rd, wr;
124         unsigned short buf[HDLCDRV_HDLCBUFFER];
125 };
126
127 #ifdef HDLCDRV_DEBUG
128 struct hdlcdrv_bitbuffer {
129         unsigned int rd;
130         unsigned int wr;
131         unsigned int shreg;
132         unsigned char buffer[HDLCDRV_BITBUFFER];
133 };
134
135 static inline void hdlcdrv_add_bitbuffer(struct hdlcdrv_bitbuffer *buf, 
136                                          unsigned int bit)
137 {
138         unsigned char new;
139
140         new = buf->shreg & 1;
141         buf->shreg >>= 1;
142         buf->shreg |= (!!bit) << 7;
143         if (new) {
144                 buf->buffer[buf->wr] = buf->shreg;
145                 buf->wr = (buf->wr+1) % sizeof(buf->buffer);
146                 buf->shreg = 0x80;
147         }
148 }
149
150 static inline void hdlcdrv_add_bitbuffer_word(struct hdlcdrv_bitbuffer *buf, 
151                                               unsigned int bits)
152 {
153         buf->buffer[buf->wr] = bits & 0xff;
154         buf->wr = (buf->wr+1) % sizeof(buf->buffer);
155         buf->buffer[buf->wr] = (bits >> 8) & 0xff;
156         buf->wr = (buf->wr+1) % sizeof(buf->buffer);
157
158 }
159 #endif /* HDLCDRV_DEBUG */
160
161 /* -------------------------------------------------------------------- */
162 /*
163  * Information that need to be kept for each driver. 
164  */
165
166 struct hdlcdrv_ops {
167         /*
168          * first some informations needed by the hdlcdrv routines
169          */
170         const char *drvname;
171         const char *drvinfo;
172         /*
173          * the routines called by the hdlcdrv routines
174          */
175         int (*open)(struct net_device *);
176         int (*close)(struct net_device *);
177         int (*ioctl)(struct net_device *, struct ifreq *, 
178                      struct hdlcdrv_ioctl *, int);
179 };
180
181 struct hdlcdrv_state {
182         int magic;
183         int opened;
184
185         const struct hdlcdrv_ops *ops;
186
187         struct {
188                 int bitrate;
189         } par;
190
191         struct hdlcdrv_pttoutput {
192                 int dma2;
193                 int seriobase;
194                 int pariobase;
195                 int midiiobase;
196                 unsigned int flags;
197         } ptt_out;
198
199         struct hdlcdrv_channel_params ch_params;
200
201         struct hdlcdrv_hdlcrx {
202                 struct hdlcdrv_hdlcbuffer hbuf;
203                 long in_hdlc_rx;
204                 /* 0 = sync hunt, != 0 receiving */
205                 int rx_state;   
206                 unsigned int bitstream;
207                 unsigned int bitbuf;
208                 int numbits;
209                 unsigned char dcd;
210                 
211                 int len;
212                 unsigned char *bp;
213                 unsigned char buffer[HDLCDRV_MAXFLEN+2];
214         } hdlcrx;
215
216         struct hdlcdrv_hdlctx {
217                 struct hdlcdrv_hdlcbuffer hbuf;
218                 long in_hdlc_tx;
219                 /*
220                  * 0 = send flags
221                  * 1 = send txtail (flags)
222                  * 2 = send packet
223                  */
224                 int tx_state;   
225                 int numflags;
226                 unsigned int bitstream;
227                 unsigned char ptt;
228                 int calibrate;
229                 int slotcnt;
230
231                 unsigned int bitbuf;
232                 int numbits;
233                 
234                 int len;
235                 unsigned char *bp;
236                 unsigned char buffer[HDLCDRV_MAXFLEN+2];
237         } hdlctx;
238
239 #ifdef HDLCDRV_DEBUG
240         struct hdlcdrv_bitbuffer bitbuf_channel;
241         struct hdlcdrv_bitbuffer bitbuf_hdlc;
242 #endif /* HDLCDRV_DEBUG */
243
244         struct net_device_stats stats;
245         int ptt_keyed;
246
247         /* queued skb for transmission */
248         struct sk_buff *skb;
249 };
250
251
252 /* -------------------------------------------------------------------- */
253
254 static inline int hdlcdrv_hbuf_full(struct hdlcdrv_hdlcbuffer *hb) 
255 {
256         unsigned long flags;
257         int ret;
258         
259         spin_lock_irqsave(&hb->lock, flags);
260         ret = !((HDLCDRV_HDLCBUFFER - 1 + hb->rd - hb->wr) % HDLCDRV_HDLCBUFFER);
261         spin_unlock_irqrestore(&hb->lock, flags);
262         return ret;
263 }
264
265 /* -------------------------------------------------------------------- */
266
267 static inline int hdlcdrv_hbuf_empty(struct hdlcdrv_hdlcbuffer *hb)
268 {
269         unsigned long flags;
270         int ret;
271         
272         spin_lock_irqsave(&hb->lock, flags);
273         ret = (hb->rd == hb->wr);
274         spin_unlock_irqrestore(&hb->lock, flags);
275         return ret;
276 }
277
278 /* -------------------------------------------------------------------- */
279
280 static inline unsigned short hdlcdrv_hbuf_get(struct hdlcdrv_hdlcbuffer *hb)
281 {
282         unsigned long flags;
283         unsigned short val;
284         unsigned newr;
285
286         spin_lock_irqsave(&hb->lock, flags);
287         if (hb->rd == hb->wr)
288                 val = 0;
289         else {
290                 newr = (hb->rd+1) % HDLCDRV_HDLCBUFFER;
291                 val = hb->buf[hb->rd];
292                 hb->rd = newr;
293         }
294         spin_unlock_irqrestore(&hb->lock, flags);
295         return val;
296 }
297
298 /* -------------------------------------------------------------------- */
299
300 static inline void hdlcdrv_hbuf_put(struct hdlcdrv_hdlcbuffer *hb, 
301                                     unsigned short val)
302 {
303         unsigned newp;
304         unsigned long flags;
305         
306         spin_lock_irqsave(&hb->lock, flags);
307         newp = (hb->wr+1) % HDLCDRV_HDLCBUFFER;
308         if (newp != hb->rd) { 
309                 hb->buf[hb->wr] = val & 0xffff;
310                 hb->wr = newp;
311         }
312         spin_unlock_irqrestore(&hb->lock, flags);
313 }
314
315 /* -------------------------------------------------------------------- */
316
317 static inline void hdlcdrv_putbits(struct hdlcdrv_state *s, unsigned int bits)
318 {
319         hdlcdrv_hbuf_put(&s->hdlcrx.hbuf, bits);
320 }
321
322 static inline unsigned int hdlcdrv_getbits(struct hdlcdrv_state *s)
323 {
324         unsigned int ret;
325
326         if (hdlcdrv_hbuf_empty(&s->hdlctx.hbuf)) {
327                 if (s->hdlctx.calibrate > 0)
328                         s->hdlctx.calibrate--;
329                 else
330                         s->hdlctx.ptt = 0;
331                 ret = 0;
332         } else 
333                 ret = hdlcdrv_hbuf_get(&s->hdlctx.hbuf);
334 #ifdef HDLCDRV_LOOPBACK
335         hdlcdrv_hbuf_put(&s->hdlcrx.hbuf, ret);
336 #endif /* HDLCDRV_LOOPBACK */
337         return ret;
338 }
339
340 static inline void hdlcdrv_channelbit(struct hdlcdrv_state *s, unsigned int bit)
341 {
342 #ifdef HDLCDRV_DEBUG
343         hdlcdrv_add_bitbuffer(&s->bitbuf_channel, bit);
344 #endif /* HDLCDRV_DEBUG */
345 }
346
347 static inline void hdlcdrv_setdcd(struct hdlcdrv_state *s, int dcd)
348 {
349         s->hdlcrx.dcd = !!dcd;
350 }
351
352 static inline int hdlcdrv_ptt(struct hdlcdrv_state *s)
353 {
354         return s->hdlctx.ptt || (s->hdlctx.calibrate > 0);
355 }
356
357 /* -------------------------------------------------------------------- */
358
359 void hdlcdrv_receiver(struct net_device *, struct hdlcdrv_state *);
360 void hdlcdrv_transmitter(struct net_device *, struct hdlcdrv_state *);
361 void hdlcdrv_arbitrate(struct net_device *, struct hdlcdrv_state *);
362 struct net_device *hdlcdrv_register(const struct hdlcdrv_ops *ops,
363                                     unsigned int privsize, const char *ifname,
364                                     unsigned int baseaddr, unsigned int irq, 
365                                     unsigned int dma);
366 void hdlcdrv_unregister(struct net_device *dev);
367
368 /* -------------------------------------------------------------------- */
369
370
371
372 #endif /* __KERNEL__ */
373
374 /* -------------------------------------------------------------------- */
375
376 #endif /* _HDLCDRV_H */
377
378 /* -------------------------------------------------------------------- */