drivers/net/wireless/p54/p54.h

   1 /*
   2  * Shared defines for all mac80211 Prism54 code
   3  *
   4  * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
   5  *
   6  * Based on the islsm (softmac prism54) driver, which is:
   7  * Copyright 2004-2006 Jean-Baptiste Note <jbnote@gmail.com>, et al.
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License version 2 as
  11  * published by the Free Software Foundation.
  12  */
  13
  14 #ifndef P54_H
  15 #define P54_H
  16
  17 #ifdef CONFIG_P54_LEDS
  18 #include <linux/leds.h>
  19 #endif /* CONFIG_P54_LEDS */
  20
  21 #define ISL38XX_DEV_FIRMWARE_ADDR 0x20000
  22
  23 #define BR_CODE_MIN                     0x80000000
  24 #define BR_CODE_COMPONENT_ID            0x80000001
  25 #define BR_CODE_COMPONENT_VERSION       0x80000002
  26 #define BR_CODE_DEPENDENT_IF            0x80000003
  27 #define BR_CODE_EXPOSED_IF              0x80000004
  28 #define BR_CODE_DESCR                   0x80000101
  29 #define BR_CODE_MAX                     0x8FFFFFFF
  30 #define BR_CODE_END_OF_BRA              0xFF0000FF
  31 #define LEGACY_BR_CODE_END_OF_BRA       0xFFFFFFFF
  32
  33 struct bootrec {
  34         __le32 code;
  35         __le32 len;
  36         u32 data[10];
  37 } __packed;
  38
  39 /* Interface role definitions */
  40 #define BR_INTERFACE_ROLE_SERVER        0x0000
  41 #define BR_INTERFACE_ROLE_CLIENT        0x8000
  42
  43 #define BR_DESC_PRIV_CAP_WEP            BIT(0)
  44 #define BR_DESC_PRIV_CAP_TKIP           BIT(1)
  45 #define BR_DESC_PRIV_CAP_MICHAEL        BIT(2)
  46 #define BR_DESC_PRIV_CAP_CCX_CP         BIT(3)
  47 #define BR_DESC_PRIV_CAP_CCX_MIC        BIT(4)
  48 #define BR_DESC_PRIV_CAP_AESCCMP        BIT(5)
  49
  50 struct bootrec_desc {
  51         __le16 modes;
  52         __le16 flags;
  53         __le32 rx_start;
  54         __le32 rx_end;
  55         u8 headroom;
  56         u8 tailroom;
  57         u8 tx_queues;
  58         u8 tx_depth;
  59         u8 privacy_caps;
  60         u8 rx_keycache_size;
  61         u8 time_size;
  62         u8 padding;
  63         u8 rates[16];
  64         u8 padding2[4];
  65         __le16 rx_mtu;
  66 } __packed;
  67
  68 #define FW_FMAC 0x464d4143
  69 #define FW_LM86 0x4c4d3836
  70 #define FW_LM87 0x4c4d3837
  71 #define FW_LM20 0x4c4d3230
  72
  73 struct bootrec_comp_id {
  74         __le32 fw_variant;
  75 } __packed;
  76
  77 struct bootrec_comp_ver {
  78         char fw_version[24];
  79 } __packed;
  80
  81 struct bootrec_end {
  82         __le16 crc;
  83         u8 padding[2];
  84         u8 md5[16];
  85 } __packed;
  86
  87 /* provide 16 bytes for the transport back-end */
  88 #define P54_TX_INFO_DATA_SIZE           16
  89
  90 /* stored in ieee80211_tx_info's rate_driver_data */
  91 struct p54_tx_info {
  92         u32 start_addr;
  93         u32 end_addr;
  94         union {
  95                 void *data[P54_TX_INFO_DATA_SIZE / sizeof(void *)];
  96                 struct {
  97                         u32 extra_len;
  98                 };
  99         };
 100 };
 101
 102 #define P54_MAX_CTRL_FRAME_LEN          0x1000
 103
 104 #define P54_SET_QUEUE(queue, ai_fs, cw_min, cw_max, _txop)      \
 105 do {                                                            \
 106         queue.aifs = cpu_to_le16(ai_fs);                        \
 107         queue.cwmin = cpu_to_le16(cw_min);                      \
 108         queue.cwmax = cpu_to_le16(cw_max);                      \
 109         queue.txop = cpu_to_le16(_txop);                        \
 110 } while (0)
 111
 112 struct p54_edcf_queue_param {
 113         __le16 aifs;
 114         __le16 cwmin;
 115         __le16 cwmax;
 116         __le16 txop;
 117 } __packed;
 118
 119 struct p54_rssi_db_entry {
 120         u16 freq;
 121         s16 mul;
 122         s16 add;
 123         s16 longbow_unkn;
 124         s16 longbow_unk2;
 125 };
 126
 127 struct p54_cal_database {
 128         size_t entries;
 129         size_t entry_size;
 130         size_t offset;
 131         size_t len;
 132         u8 data[0];
 133 };
 134
 135 #define EEPROM_READBACK_LEN 0x3fc
 136
 137 enum fw_state {
 138         FW_STATE_OFF,
 139         FW_STATE_BOOTING,
 140         FW_STATE_READY,
 141         FW_STATE_RESET,
 142         FW_STATE_RESETTING,
 143 };
 144
 145 #ifdef CONFIG_P54_LEDS
 146
 147 #define P54_LED_MAX_NAME_LEN 31
 148
 149 struct p54_led_dev {
 150         struct ieee80211_hw *hw_dev;
 151         struct led_classdev led_dev;
 152         char name[P54_LED_MAX_NAME_LEN + 1];
 153
 154         unsigned int toggled;
 155         unsigned int index;
 156         unsigned int registered;
 157 };
 158
 159 #endif /* CONFIG_P54_LEDS */
 160
 161 struct p54_tx_queue_stats {
 162         unsigned int len;
 163         unsigned int limit;
 164         unsigned int count;
 165 };
 166
 167 struct p54_common {
 168         struct ieee80211_hw *hw;
 169         struct ieee80211_vif *vif;
 170         void (*tx)(struct ieee80211_hw *dev, struct sk_buff *skb);
 171         int (*open)(struct ieee80211_hw *dev);
 172         void (*stop)(struct ieee80211_hw *dev);
 173         struct sk_buff_head tx_pending;
 174         struct sk_buff_head tx_queue;
 175         struct mutex conf_mutex;
 176
 177         /* memory management (as seen by the firmware) */
 178         u32 rx_start;
 179         u32 rx_end;
 180         u16 rx_mtu;
 181         u8 headroom;
 182         u8 tailroom;
 183
 184         /* firmware/hardware info */
 185         unsigned int tx_hdr_len;
 186         unsigned int fw_var;
 187         unsigned int fw_interface;
 188         u8 version;
 189
 190         /* (e)DCF / QOS state */
 191         bool use_short_slot;
 192         spinlock_t tx_stats_lock;
 193         struct p54_tx_queue_stats tx_stats[8];
 194         struct p54_edcf_queue_param qos_params[8];
 195
 196         /* Radio data */
 197         u16 rxhw;
 198         u8 rx_diversity_mask;
 199         u8 tx_diversity_mask;
 200         unsigned int output_power;
 201         struct p54_rssi_db_entry *cur_rssi;
 202         int noise;
 203         /* calibration, output power limit and rssi<->dBm conversation data */
 204         struct pda_iq_autocal_entry *iq_autocal;
 205         unsigned int iq_autocal_len;
 206         struct p54_cal_database *curve_data;
 207         struct p54_cal_database *output_limit;
 208         struct p54_cal_database *rssi_db;
 209         struct ieee80211_supported_band *band_table[IEEE80211_NUM_BANDS];
 210
 211         /* BBP/MAC state */
 212         u8 mac_addr[ETH_ALEN];
 213         u8 bssid[ETH_ALEN];
 214         u16 wakeup_timer;
 215         unsigned int filter_flags;
 216         int mode;
 217         u32 tsf_low32, tsf_high32;
 218         u32 basic_rate_mask;
 219         u16 aid;
 220         u8 coverage_class;
 221         bool powersave_override;
 222         __le32 beacon_req_id;
 223         struct completion beacon_comp;
 224
 225         /* cryptographic engine information */
 226         u8 privacy_caps;
 227         u8 rx_keycache_size;
 228         unsigned long *used_rxkeys;
 229
 230         /* LED management */
 231 #ifdef CONFIG_P54_LEDS
 232         struct p54_led_dev leds[4];
 233         struct delayed_work led_work;
 234 #endif /* CONFIG_P54_LEDS */
 235         u16 softled_state;              /* bit field of glowing LEDs */
 236
 237         /* statistics */
 238         struct ieee80211_low_level_stats stats;
 239         struct delayed_work work;
 240
 241         /* eeprom handling */
 242         void *eeprom;
 243         struct completion eeprom_comp;
 244         struct mutex eeprom_mutex;
 245 };
 246
 247 /* interfaces for the drivers */
 248 int p54_rx(struct ieee80211_hw *dev, struct sk_buff *skb);
 249 void p54_free_skb(struct ieee80211_hw *dev, struct sk_buff *skb);
 250 int p54_parse_firmware(struct ieee80211_hw *dev, const struct firmware *fw);
 251 int p54_parse_eeprom(struct ieee80211_hw *dev, void *eeprom, int len);
 252 int p54_read_eeprom(struct ieee80211_hw *dev);
 253
 254 struct ieee80211_hw *p54_init_common(size_t priv_data_len);
 255 int p54_register_common(struct ieee80211_hw *dev, struct device *pdev);
 256 void p54_free_common(struct ieee80211_hw *dev);
 257
 258 void p54_unregister_common(struct ieee80211_hw *dev);
 259
 260 #endif /* P54_H */