drivers/net/wireless/wl12xx/tx.h

   1 /*
   2  * This file is part of wl1271
   3  *
   4  * Copyright (C) 1998-2009 Texas Instruments. All rights reserved.
   5  * Copyright (C) 2009 Nokia Corporation
   6  *
   7  * Contact: Luciano Coelho <luciano.coelho@nokia.com>
   8  *
   9  * This program is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU General Public License
  11  * version 2 as published by the Free Software Foundation.
  12  *
  13  * This program is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  21  * 02110-1301 USA
  22  *
  23  */
  24
  25 #ifndef __TX_H__
  26 #define __TX_H__
  27
  28 #define TX_HW_BLOCK_SPARE                2
  29 #define TX_HW_BLOCK_SIZE                 252
  30
  31 #define TX_HW_MGMT_PKT_LIFETIME_TU       2000
  32 #define TX_HW_AP_MODE_PKT_LIFETIME_TU    8000
  33 /* The chipset reference driver states, that the "aid" value 1
  34  * is for infra-BSS, but is still always used */
  35 #define TX_HW_DEFAULT_AID                1
  36
  37 #define TX_HW_ATTR_SAVE_RETRIES          BIT(0)
  38 #define TX_HW_ATTR_HEADER_PAD            BIT(1)
  39 #define TX_HW_ATTR_SESSION_COUNTER       (BIT(2) | BIT(3) | BIT(4))
  40 #define TX_HW_ATTR_RATE_POLICY           (BIT(5) | BIT(6) | BIT(7) | \
  41                                           BIT(8) | BIT(9))
  42 #define TX_HW_ATTR_LAST_WORD_PAD         (BIT(10) | BIT(11))
  43 #define TX_HW_ATTR_TX_CMPLT_REQ          BIT(12)
  44
  45 #define TX_HW_ATTR_OFST_SAVE_RETRIES     0
  46 #define TX_HW_ATTR_OFST_HEADER_PAD       1
  47 #define TX_HW_ATTR_OFST_SESSION_COUNTER  2
  48 #define TX_HW_ATTR_OFST_RATE_POLICY      5
  49 #define TX_HW_ATTR_OFST_LAST_WORD_PAD    10
  50 #define TX_HW_ATTR_OFST_TX_CMPLT_REQ     12
  51
  52 #define TX_HW_RESULT_QUEUE_LEN           16
  53 #define TX_HW_RESULT_QUEUE_LEN_MASK      0xf
  54
  55 #define WL1271_TX_ALIGN_TO 4
  56 #define WL1271_TKIP_IV_SPACE 4
  57
  58 struct wl1271_tx_hw_descr {
  59         /* Length of packet in words, including descriptor+header+data */
  60         __le16 length;
  61         /* Number of extra memory blocks to allocate for this packet in
  62            addition to the number of blocks derived from the packet length */
  63         u8 extra_mem_blocks;
  64         /* Total number of memory blocks allocated by the host for this packet.
  65            Must be equal or greater than the actual blocks number allocated by
  66            HW!! */
  67         u8 total_mem_blocks;
  68         /* Device time (in us) when the packet arrived to the driver */
  69         __le32 start_time;
  70         /* Max delay in TUs until transmission. The last device time the
  71            packet can be transmitted is: startTime+(1024*LifeTime) */
  72         __le16 life_time;
  73         /* Bitwise fields - see TX_ATTR... definitions above. */
  74         __le16 tx_attr;
  75         /* Packet identifier used also in the Tx-Result. */
  76         u8 id;
  77         /* The packet TID value (as User-Priority) */
  78         u8 tid;
  79         union {
  80                 /* STA - Identifier of the remote STA in IBSS, 1 in infra-BSS */
  81                 u8 aid;
  82                 /* AP - host link ID (HLID) */
  83                 u8 hlid;
  84         } __packed;
  85         u8 reserved;
  86 } __packed;
  87
  88 enum wl1271_tx_hw_res_status {
  89         TX_SUCCESS          = 0,
  90         TX_HW_ERROR         = 1,
  91         TX_DISABLED         = 2,
  92         TX_RETRY_EXCEEDED   = 3,
  93         TX_TIMEOUT          = 4,
  94         TX_KEY_NOT_FOUND    = 5,
  95         TX_PEER_NOT_FOUND   = 6,
  96         TX_SESSION_MISMATCH = 7
  97 };
  98
  99 struct wl1271_tx_hw_res_descr {
 100         /* Packet Identifier - same value used in the Tx descriptor.*/
 101         u8 id;
 102         /* The status of the transmission, indicating success or one of
 103            several possible reasons for failure. */
 104         u8 status;
 105         /* Total air access duration including all retrys and overheads.*/
 106         __le16 medium_usage;
 107         /* The time passed from host xfer to Tx-complete.*/
 108         __le32 fw_handling_time;
 109         /* Total media delay
 110            (from 1st EDCA AIFS counter until TX Complete). */
 111         __le32 medium_delay;
 112         /* LS-byte of last TKIP seq-num (saved per AC for recovery). */
 113         u8 lsb_security_sequence_number;
 114         /* Retry count - number of transmissions without successful ACK.*/
 115         u8 ack_failures;
 116         /* The rate that succeeded getting ACK
 117            (Valid only if status=SUCCESS). */
 118         u8 rate_class_index;
 119         /* for 4-byte alignment. */
 120         u8 spare;
 121 } __packed;
 122
 123 struct wl1271_tx_hw_res_if {
 124         __le32 tx_result_fw_counter;
 125         __le32 tx_result_host_counter;
 126         struct wl1271_tx_hw_res_descr tx_results_queue[TX_HW_RESULT_QUEUE_LEN];
 127 } __packed;
 128
 129 static inline int wl1271_tx_get_queue(int queue)
 130 {
 131         switch (queue) {
 132         case 0:
 133                 return CONF_TX_AC_VO;
 134         case 1:
 135                 return CONF_TX_AC_VI;
 136         case 2:
 137                 return CONF_TX_AC_BE;
 138         case 3:
 139                 return CONF_TX_AC_BK;
 140         default:
 141                 return CONF_TX_AC_BE;
 142         }
 143 }
 144
 145 void wl1271_tx_work(struct work_struct *work);
 146 void wl1271_tx_work_locked(struct wl1271 *wl);
 147 void wl1271_tx_complete(struct wl1271 *wl);
 148 void wl1271_tx_reset(struct wl1271 *wl);
 149 void wl1271_tx_flush(struct wl1271 *wl);
 150 u8 wl1271_rate_to_idx(int rate, enum ieee80211_band band);
 151 u32 wl1271_tx_enabled_rates_get(struct wl1271 *wl, u32 rate_set);
 152 u32 wl1271_tx_min_rate_get(struct wl1271 *wl);
 153 u8 wl1271_tx_get_hlid(struct sk_buff *skb);
 154 void wl1271_tx_reset_link_queues(struct wl1271 *wl, u8 hlid);
 155 void wl1271_handle_tx_low_watermark(struct wl1271 *wl);
 156
 157 #endif