Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  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                 unsigned 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                 unsigned 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         int ptt_keyed;
245 
246         /* queued skb for transmission */
247         struct sk_buff *skb;
248 };
249 
250 
251 /* -------------------------------------------------------------------- */
252 
253 static inline int hdlcdrv_hbuf_full(struct hdlcdrv_hdlcbuffer *hb) 
254 {
255         unsigned long flags;
256         int ret;
257         
258         spin_lock_irqsave(&hb->lock, flags);
259         ret = !((HDLCDRV_HDLCBUFFER - 1 + hb->rd - hb->wr) % HDLCDRV_HDLCBUFFER);
260         spin_unlock_irqrestore(&hb->lock, flags);
261         return ret;
262 }
263 
264 /* -------------------------------------------------------------------- */
265 
266 static inline int hdlcdrv_hbuf_empty(struct hdlcdrv_hdlcbuffer *hb)
267 {
268         unsigned long flags;
269         int ret;
270         
271         spin_lock_irqsave(&hb->lock, flags);
272         ret = (hb->rd == hb->wr);
273         spin_unlock_irqrestore(&hb->lock, flags);
274         return ret;
275 }
276 
277 /* -------------------------------------------------------------------- */
278 
279 static inline unsigned short hdlcdrv_hbuf_get(struct hdlcdrv_hdlcbuffer *hb)
280 {
281         unsigned long flags;
282         unsigned short val;
283         unsigned newr;
284 
285         spin_lock_irqsave(&hb->lock, flags);
286         if (hb->rd == hb->wr)
287                 val = 0;
288         else {
289                 newr = (hb->rd+1) % HDLCDRV_HDLCBUFFER;
290                 val = hb->buf[hb->rd];
291                 hb->rd = newr;
292         }
293         spin_unlock_irqrestore(&hb->lock, flags);
294         return val;
295 }
296 
297 /* -------------------------------------------------------------------- */
298 
299 static inline void hdlcdrv_hbuf_put(struct hdlcdrv_hdlcbuffer *hb, 
300                                     unsigned short val)
301 {
302         unsigned newp;
303         unsigned long flags;
304         
305         spin_lock_irqsave(&hb->lock, flags);
306         newp = (hb->wr+1) % HDLCDRV_HDLCBUFFER;
307         if (newp != hb->rd) { 
308                 hb->buf[hb->wr] = val & 0xffff;
309                 hb->wr = newp;
310         }
311         spin_unlock_irqrestore(&hb->lock, flags);
312 }
313 
314 /* -------------------------------------------------------------------- */
315 
316 static inline void hdlcdrv_putbits(struct hdlcdrv_state *s, unsigned int bits)
317 {
318         hdlcdrv_hbuf_put(&s->hdlcrx.hbuf, bits);
319 }
320 
321 static inline unsigned int hdlcdrv_getbits(struct hdlcdrv_state *s)
322 {
323         unsigned int ret;
324 
325         if (hdlcdrv_hbuf_empty(&s->hdlctx.hbuf)) {
326                 if (s->hdlctx.calibrate > 0)
327                         s->hdlctx.calibrate--;
328                 else
329                         s->hdlctx.ptt = 0;
330                 ret = 0;
331         } else 
332                 ret = hdlcdrv_hbuf_get(&s->hdlctx.hbuf);
333 #ifdef HDLCDRV_LOOPBACK
334         hdlcdrv_hbuf_put(&s->hdlcrx.hbuf, ret);
335 #endif /* HDLCDRV_LOOPBACK */
336         return ret;
337 }
338 
339 static inline void hdlcdrv_channelbit(struct hdlcdrv_state *s, unsigned int bit)
340 {
341 #ifdef HDLCDRV_DEBUG
342         hdlcdrv_add_bitbuffer(&s->bitbuf_channel, bit);
343 #endif /* HDLCDRV_DEBUG */
344 }
345 
346 static inline void hdlcdrv_setdcd(struct hdlcdrv_state *s, int dcd)
347 {
348         s->hdlcrx.dcd = !!dcd;
349 }
350 
351 static inline int hdlcdrv_ptt(struct hdlcdrv_state *s)
352 {
353         return s->hdlctx.ptt || (s->hdlctx.calibrate > 0);
354 }
355 
356 /* -------------------------------------------------------------------- */
357 
358 void hdlcdrv_receiver(struct net_device *, struct hdlcdrv_state *);
359 void hdlcdrv_transmitter(struct net_device *, struct hdlcdrv_state *);
360 void hdlcdrv_arbitrate(struct net_device *, struct hdlcdrv_state *);
361 struct net_device *hdlcdrv_register(const struct hdlcdrv_ops *ops,
362                                     unsigned int privsize, const char *ifname,
363                                     unsigned int baseaddr, unsigned int irq, 
364                                     unsigned int dma);
365 void hdlcdrv_unregister(struct net_device *dev);
366 
367 /* -------------------------------------------------------------------- */
368 
369 
370 
371 #endif /* __KERNEL__ */
372 
373 /* -------------------------------------------------------------------- */
374 
375 #endif /* _HDLCDRV_H */
376 
377 /* -------------------------------------------------------------------- */
378 
  This page was automatically generated by the LXR engine.