Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
tx.h
Go to the documentation of this file.
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 <[email protected]>
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_MGMT_PKT_LIFETIME_TU 2000
29 #define TX_HW_AP_MODE_PKT_LIFETIME_TU 8000
30 
31 #define TX_HW_ATTR_SAVE_RETRIES BIT(0)
32 #define TX_HW_ATTR_HEADER_PAD BIT(1)
33 #define TX_HW_ATTR_SESSION_COUNTER (BIT(2) | BIT(3) | BIT(4))
34 #define TX_HW_ATTR_RATE_POLICY (BIT(5) | BIT(6) | BIT(7) | \
35  BIT(8) | BIT(9))
36 #define TX_HW_ATTR_LAST_WORD_PAD (BIT(10) | BIT(11))
37 #define TX_HW_ATTR_TX_CMPLT_REQ BIT(12)
38 #define TX_HW_ATTR_TX_DUMMY_REQ BIT(13)
39 #define TX_HW_ATTR_HOST_ENCRYPT BIT(14)
40 
41 #define TX_HW_ATTR_OFST_SAVE_RETRIES 0
42 #define TX_HW_ATTR_OFST_HEADER_PAD 1
43 #define TX_HW_ATTR_OFST_SESSION_COUNTER 2
44 #define TX_HW_ATTR_OFST_RATE_POLICY 5
45 #define TX_HW_ATTR_OFST_LAST_WORD_PAD 10
46 #define TX_HW_ATTR_OFST_TX_CMPLT_REQ 12
47 
48 #define TX_HW_RESULT_QUEUE_LEN 16
49 #define TX_HW_RESULT_QUEUE_LEN_MASK 0xf
50 
51 #define WL1271_TX_ALIGN_TO 4
52 #define WL1271_EXTRA_SPACE_TKIP 4
53 #define WL1271_EXTRA_SPACE_AES 8
54 #define WL1271_EXTRA_SPACE_MAX 8
55 
56 /* Used for management frames and dummy packets */
57 #define WL1271_TID_MGMT 7
58 
59 struct wl127x_tx_mem {
60  /*
61  * Number of extra memory blocks to allocate for this packet
62  * in addition to the number of blocks derived from the packet
63  * length.
64  */
66  /*
67  * Total number of memory blocks allocated by the host for
68  * this packet. Must be equal or greater than the actual
69  * blocks number allocated by HW.
70  */
72 } __packed;
73 
74 struct wl128x_tx_mem {
75  /*
76  * Total number of memory blocks allocated by the host for
77  * this packet.
78  */
80  /*
81  * Number of extra bytes, at the end of the frame. the host
82  * uses this padding to complete each frame to integer number
83  * of SDIO blocks.
84  */
86 } __packed;
87 
88 struct wl18xx_tx_mem {
89  /*
90  * Total number of memory blocks allocated by the host for
91  * this packet.
92  */
94 
95  /*
96  * control bits
97  */
99 } __packed;
100 
101 /*
102  * On wl128x based devices, when TX packets are aggregated, each packet
103  * size must be aligned to the SDIO block size. The maximum block size
104  * is bounded by the type of the padded bytes field that is sent to the
105  * FW. Currently the type is u8, so the maximum block size is 256 bytes.
106  */
107 #define WL12XX_BUS_BLOCK_SIZE min(512u, \
108  (1u << (8 * sizeof(((struct wl128x_tx_mem *) 0)->extra_bytes))))
109 
111  /* Length of packet in words, including descriptor+header+data */
113  union {
117  } __packed;
118  /* Device time (in us) when the packet arrived to the driver */
120  /*
121  * Max delay in TUs until transmission. The last device time the
122  * packet can be transmitted is: start_time + (1024 * life_time)
123  */
125  /* Bitwise fields - see TX_ATTR... definitions above. */
127  /* Packet identifier used also in the Tx-Result. */
129  /* The packet TID value (as User-Priority) */
131  /* host link ID (HLID) */
133 
134  union {
136 
137  /*
138  * bit 0 -> 0 = udp, 1 = tcp
139  * bit 1:7 -> IP header offset
140  */
142  } __packed;
143 } __packed;
144 
155 };
156 
158  /* Packet Identifier - same value used in the Tx descriptor.*/
160  /* The status of the transmission, indicating success or one of
161  several possible reasons for failure. */
163  /* Total air access duration including all retrys and overheads.*/
165  /* The time passed from host xfer to Tx-complete.*/
167  /* Total media delay
168  (from 1st EDCA AIFS counter until TX Complete). */
170  /* LS-byte of last TKIP seq-num (saved per AC for recovery). */
172  /* Retry count - number of transmissions without successful ACK.*/
174  /* The rate that succeeded getting ACK
175  (Valid only if status=SUCCESS). */
177  /* for 4-byte alignment. */
179 } __packed;
180 
185 } __packed;
186 
192 };
193 
194 static inline int wl1271_tx_get_queue(int queue)
195 {
196  switch (queue) {
197  case 0:
198  return CONF_TX_AC_VO;
199  case 1:
200  return CONF_TX_AC_VI;
201  case 2:
202  return CONF_TX_AC_BE;
203  case 3:
204  return CONF_TX_AC_BK;
205  default:
206  return CONF_TX_AC_BE;
207  }
208 }
209 
210 static inline int wl1271_tx_get_mac80211_queue(int queue)
211 {
212  switch (queue) {
213  case CONF_TX_AC_VO:
214  return 0;
215  case CONF_TX_AC_VI:
216  return 1;
217  case CONF_TX_AC_BE:
218  return 2;
219  case CONF_TX_AC_BK:
220  return 3;
221  default:
222  return 2;
223  }
224 }
225 
226 static inline int wl1271_tx_total_queue_count(struct wl1271 *wl)
227 {
228  int i, count = 0;
229 
230  for (i = 0; i < NUM_TX_QUEUES; i++)
231  count += wl->tx_queue_count[i];
232 
233  return count;
234 }
235 
236 void wl1271_tx_work(struct work_struct *work);
237 int wlcore_tx_work_locked(struct wl1271 *wl);
238 int wlcore_tx_complete(struct wl1271 *wl);
239 void wl12xx_tx_reset_wlvif(struct wl1271 *wl, struct wl12xx_vif *wlvif);
240 void wl12xx_tx_reset(struct wl1271 *wl);
241 void wl1271_tx_flush(struct wl1271 *wl);
242 u8 wlcore_rate_to_idx(struct wl1271 *wl, u8 rate, enum ieee80211_band band);
243 u32 wl1271_tx_enabled_rates_get(struct wl1271 *wl, u32 rate_set,
244  enum ieee80211_band rate_band);
245 u32 wl1271_tx_min_rate_get(struct wl1271 *wl, u32 rate_set);
246 u8 wl12xx_tx_get_hlid(struct wl1271 *wl, struct wl12xx_vif *wlvif,
247  struct sk_buff *skb, struct ieee80211_sta *sta);
248 void wl1271_tx_reset_link_queues(struct wl1271 *wl, u8 hlid);
249 void wl1271_handle_tx_low_watermark(struct wl1271 *wl);
250 bool wl12xx_is_dummy_packet(struct wl1271 *wl, struct sk_buff *skb);
251 void wl12xx_rearm_rx_streaming(struct wl1271 *wl, unsigned long *active_hlids);
252 unsigned int wlcore_calc_packet_alignment(struct wl1271 *wl,
253  unsigned int packet_length);
254 void wl1271_free_tx_id(struct wl1271 *wl, int id);
255 void wlcore_stop_queue_locked(struct wl1271 *wl, u8 queue,
257 void wlcore_stop_queue(struct wl1271 *wl, u8 queue,
259 void wlcore_wake_queue(struct wl1271 *wl, u8 queue,
261 void wlcore_stop_queues(struct wl1271 *wl,
263 void wlcore_wake_queues(struct wl1271 *wl,
265 void wlcore_reset_stopped_queues(struct wl1271 *wl);
266 bool wlcore_is_queue_stopped_by_reason(struct wl1271 *wl, u8 queue,
268 bool wlcore_is_queue_stopped(struct wl1271 *wl, u8 queue);
269 
270 /* from main.c */
271 void wl1271_free_sta(struct wl1271 *wl, struct wl12xx_vif *wlvif, u8 hlid);
272 void wl12xx_rearm_tx_watchdog_locked(struct wl1271 *wl);
273 
274 #endif