drivers/net/irda/sir-dev.h

   1 /*********************************************************************
   2  *
   3  *      sir.h:  include file for irda-sir device abstraction layer
   4  *
   5  *      Copyright (c) 2002 Martin Diehl
   6  *
   7  *      This program is free software; you can redistribute it and/or
   8  *      modify it under the terms of the GNU General Public License as
   9  *      published by the Free Software Foundation; either version 2 of
  10  *      the License, or (at your option) any later version.
  11  *
  12  ********************************************************************/
  13
  14 #ifndef IRDA_SIR_H
  15 #define IRDA_SIR_H
  16
  17 #include <linux/netdevice.h>
  18 #include <linux/workqueue.h>
  19
  20 #include <net/irda/irda.h>
  21 #include <net/irda/irda_device.h>               // iobuff_t
  22
  23 struct sir_fsm {
  24         struct semaphore        sem;
  25         struct delayed_work     work;
  26         unsigned                state, substate;
  27         int                     param;
  28         int                     result;
  29 };
  30
  31 #define SIRDEV_STATE_WAIT_TX_COMPLETE   0x0100
  32
  33 /* substates for wait_tx_complete */
  34 #define SIRDEV_STATE_WAIT_XMIT          0x0101
  35 #define SIRDEV_STATE_WAIT_UNTIL_SENT    0x0102
  36 #define SIRDEV_STATE_TX_DONE            0x0103
  37
  38 #define SIRDEV_STATE_DONGLE_OPEN                0x0300
  39
  40 /* 0x0301-0x03ff reserved for individual dongle substates */
  41
  42 #define SIRDEV_STATE_DONGLE_CLOSE       0x0400
  43
  44 /* 0x0401-0x04ff reserved for individual dongle substates */
  45
  46 #define SIRDEV_STATE_SET_DTR_RTS                0x0500
  47
  48 #define SIRDEV_STATE_SET_SPEED          0x0700
  49 #define SIRDEV_STATE_DONGLE_CHECK       0x0800
  50 #define SIRDEV_STATE_DONGLE_RESET       0x0900
  51
  52 /* 0x0901-0x09ff reserved for individual dongle substates */
  53
  54 #define SIRDEV_STATE_DONGLE_SPEED       0x0a00
  55 /* 0x0a01-0x0aff reserved for individual dongle substates */
  56
  57 #define SIRDEV_STATE_PORT_SPEED         0x0b00
  58 #define SIRDEV_STATE_DONE               0x0c00
  59 #define SIRDEV_STATE_ERROR              0x0d00
  60 #define SIRDEV_STATE_COMPLETE           0x0e00
  61
  62 #define SIRDEV_STATE_DEAD               0xffff
  63
  64
  65 struct sir_dev;
  66
  67 struct dongle_driver {
  68
  69         struct module *owner;
  70
  71         const char *driver_name;
  72
  73         IRDA_DONGLE type;
  74
  75         int     (*open)(struct sir_dev *dev);
  76         int     (*close)(struct sir_dev *dev);
  77         int     (*reset)(struct sir_dev *dev);
  78         int     (*set_speed)(struct sir_dev *dev, unsigned speed);
  79
  80         struct list_head dongle_list;
  81 };
  82
  83 struct sir_driver {
  84
  85         struct module *owner;
  86
  87         const char *driver_name;
  88
  89         int qos_mtt_bits;
  90
  91         int (*chars_in_buffer)(struct sir_dev *dev);
  92         void (*wait_until_sent)(struct sir_dev *dev);
  93         int (*set_speed)(struct sir_dev *dev, unsigned speed);
  94         int (*set_dtr_rts)(struct sir_dev *dev, int dtr, int rts);
  95
  96         int (*do_write)(struct sir_dev *dev, const unsigned char *ptr, size_t len);
  97
  98         int (*start_dev)(struct sir_dev *dev);
  99         int (*stop_dev)(struct sir_dev *dev);
 100 };
 101
 102
 103 /* exported */
 104
 105 extern int irda_register_dongle(struct dongle_driver *new);
 106 extern int irda_unregister_dongle(struct dongle_driver *drv);
 107
 108 extern struct sir_dev * sirdev_get_instance(const struct sir_driver *drv, const char *name);
 109 extern int sirdev_put_instance(struct sir_dev *self);
 110
 111 extern int sirdev_set_dongle(struct sir_dev *dev, IRDA_DONGLE type);
 112 extern void sirdev_write_complete(struct sir_dev *dev);
 113 extern int sirdev_receive(struct sir_dev *dev, const unsigned char *cp, size_t count);
 114
 115 /* low level helpers for SIR device/dongle setup */
 116 extern int sirdev_raw_write(struct sir_dev *dev, const char *buf, int len);
 117 extern int sirdev_raw_read(struct sir_dev *dev, char *buf, int len);
 118 extern int sirdev_set_dtr_rts(struct sir_dev *dev, int dtr, int rts);
 119
 120 /* not exported */
 121
 122 extern int sirdev_get_dongle(struct sir_dev *self, IRDA_DONGLE type);
 123 extern int sirdev_put_dongle(struct sir_dev *self);
 124
 125 extern void sirdev_enable_rx(struct sir_dev *dev);
 126 extern int sirdev_schedule_request(struct sir_dev *dev, int state, unsigned param);
 127
 128 /* inline helpers */
 129
 130 static inline int sirdev_schedule_speed(struct sir_dev *dev, unsigned speed)
 131 {
 132         return sirdev_schedule_request(dev, SIRDEV_STATE_SET_SPEED, speed);
 133 }
 134
 135 static inline int sirdev_schedule_dongle_open(struct sir_dev *dev, int dongle_id)
 136 {
 137         return sirdev_schedule_request(dev, SIRDEV_STATE_DONGLE_OPEN, dongle_id);
 138 }
 139
 140 static inline int sirdev_schedule_dongle_close(struct sir_dev *dev)
 141 {
 142         return sirdev_schedule_request(dev, SIRDEV_STATE_DONGLE_CLOSE, 0);
 143 }
 144
 145 static inline int sirdev_schedule_dtr_rts(struct sir_dev *dev, int dtr, int rts)
 146 {
 147         int     dtrrts;
 148
 149         dtrrts = ((dtr) ? 0x02 : 0x00) | ((rts) ? 0x01 : 0x00);
 150         return sirdev_schedule_request(dev, SIRDEV_STATE_SET_DTR_RTS, dtrrts);
 151 }
 152
 153 #if 0
 154 static inline int sirdev_schedule_mode(struct sir_dev *dev, int mode)
 155 {
 156         return sirdev_schedule_request(dev, SIRDEV_STATE_SET_MODE, mode);
 157 }
 158 #endif
 159
 160
 161 struct sir_dev {
 162         struct net_device *netdev;
 163
 164         struct irlap_cb    *irlap;
 165
 166         struct qos_info qos;
 167
 168         char hwname[32];
 169
 170         struct sir_fsm fsm;
 171         atomic_t enable_rx;
 172         int raw_tx;
 173         spinlock_t tx_lock;
 174
 175         u32 new_speed;
 176         u32 flags;
 177
 178         unsigned        speed;
 179
 180         iobuff_t tx_buff;          /* Transmit buffer */
 181         iobuff_t rx_buff;          /* Receive buffer */
 182         struct sk_buff *tx_skb;
 183
 184         const struct dongle_driver * dongle_drv;
 185         const struct sir_driver * drv;
 186         void *priv;
 187
 188 };
 189
 190 #endif  /* IRDA_SIR_H */