2 Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
3 <http://rt2x00.serialmonkey.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the
17 Free Software Foundation, Inc.,
18 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 Abstract: rt2x00 queue specific routines.
26 #include <linux/kernel.h>
27 #include <linux/module.h>
30 #include "rt2x00lib.h"
32 void rt2x00queue_create_tx_descriptor(struct queue_entry *entry,
33 struct txentry_desc *txdesc,
34 struct ieee80211_tx_control *control)
36 struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)entry->skb->data;
37 struct ieee80211_rate *rate = control->tx_rate;
38 const struct rt2x00_rate *hwrate;
39 unsigned int data_length;
40 unsigned int duration;
41 unsigned int residual;
44 memset(txdesc, 0, sizeof(*txdesc));
47 * Initialize information from queue
49 txdesc->queue = entry->queue->qid;
50 txdesc->cw_min = entry->queue->cw_min;
51 txdesc->cw_max = entry->queue->cw_max;
52 txdesc->aifs = entry->queue->aifs;
54 /* Data length should be extended with 4 bytes for CRC */
55 data_length = entry->skb->len + 4;
58 * Read required fields from ieee80211 header.
60 frame_control = le16_to_cpu(hdr->frame_control);
63 * Check whether this frame is to be acked.
65 if (!(control->flags & IEEE80211_TXCTL_NO_ACK))
66 __set_bit(ENTRY_TXD_ACK, &txdesc->flags);
69 * Check if this is a RTS/CTS frame
71 if (is_rts_frame(frame_control) || is_cts_frame(frame_control)) {
72 __set_bit(ENTRY_TXD_BURST, &txdesc->flags);
73 if (is_rts_frame(frame_control)) {
74 __set_bit(ENTRY_TXD_RTS_FRAME, &txdesc->flags);
75 __set_bit(ENTRY_TXD_ACK, &txdesc->flags);
77 __set_bit(ENTRY_TXD_CTS_FRAME, &txdesc->flags);
78 __clear_bit(ENTRY_TXD_ACK, &txdesc->flags);
80 if (control->rts_cts_rate)
81 rate = control->rts_cts_rate;
85 * Determine retry information.
87 txdesc->retry_limit = control->retry_limit;
88 if (control->flags & IEEE80211_TXCTL_LONG_RETRY_LIMIT)
89 __set_bit(ENTRY_TXD_RETRY_MODE, &txdesc->flags);
92 * Check if more fragments are pending
94 if (ieee80211_get_morefrag(hdr)) {
95 __set_bit(ENTRY_TXD_BURST, &txdesc->flags);
96 __set_bit(ENTRY_TXD_MORE_FRAG, &txdesc->flags);
100 * Beacons and probe responses require the tsf timestamp
101 * to be inserted into the frame.
103 if (txdesc->queue == QID_BEACON || is_probe_resp(frame_control))
104 __set_bit(ENTRY_TXD_REQ_TIMESTAMP, &txdesc->flags);
107 * Determine with what IFS priority this frame should be send.
108 * Set ifs to IFS_SIFS when the this is not the first fragment,
109 * or this fragment came after RTS/CTS.
111 if (test_bit(ENTRY_TXD_RTS_FRAME, &txdesc->flags)) {
112 txdesc->ifs = IFS_SIFS;
113 } else if (control->flags & IEEE80211_TXCTL_FIRST_FRAGMENT) {
114 __set_bit(ENTRY_TXD_FIRST_FRAGMENT, &txdesc->flags);
115 txdesc->ifs = IFS_BACKOFF;
117 txdesc->ifs = IFS_SIFS;
122 * Length calculation depends on OFDM/CCK rate.
124 hwrate = rt2x00_get_rate(rate->hw_value);
125 txdesc->signal = hwrate->plcp;
126 txdesc->service = 0x04;
128 if (hwrate->flags & DEV_RATE_OFDM) {
129 __set_bit(ENTRY_TXD_OFDM_RATE, &txdesc->flags);
131 txdesc->length_high = (data_length >> 6) & 0x3f;
132 txdesc->length_low = data_length & 0x3f;
135 * Convert length to microseconds.
137 residual = get_duration_res(data_length, hwrate->bitrate);
138 duration = get_duration(data_length, hwrate->bitrate);
144 * Check if we need to set the Length Extension
146 if (hwrate->bitrate == 110 && residual <= 30)
147 txdesc->service |= 0x80;
150 txdesc->length_high = (duration >> 8) & 0xff;
151 txdesc->length_low = duration & 0xff;
154 * When preamble is enabled we should set the
155 * preamble bit for the signal.
157 if (rt2x00_get_rate_preamble(rate->hw_value))
158 txdesc->signal |= 0x08;
161 EXPORT_SYMBOL_GPL(rt2x00queue_create_tx_descriptor);
163 void rt2x00queue_write_tx_descriptor(struct queue_entry *entry,
164 struct txentry_desc *txdesc)
166 struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
167 struct skb_frame_desc *skbdesc = get_skb_frame_desc(entry->skb);
169 rt2x00dev->ops->lib->write_tx_desc(rt2x00dev, entry->skb, txdesc);
172 * All processing on the frame has been completed, this means
173 * it is now ready to be dumped to userspace through debugfs.
175 rt2x00debug_dump_frame(rt2x00dev, DUMP_FRAME_TX, entry->skb);
178 * We are done writing the frame to the queue entry,
179 * if this entry is a RTS of CTS-to-self frame we are done,
180 * otherwise we need to kick the queue.
182 if (rt2x00dev->ops->lib->kick_tx_queue &&
183 !(skbdesc->flags & FRAME_DESC_DRIVER_GENERATED))
184 rt2x00dev->ops->lib->kick_tx_queue(rt2x00dev,
187 EXPORT_SYMBOL_GPL(rt2x00queue_write_tx_descriptor);
189 struct data_queue *rt2x00queue_get_queue(struct rt2x00_dev *rt2x00dev,
190 const enum data_queue_qid queue)
192 int atim = test_bit(DRIVER_REQUIRE_ATIM_QUEUE, &rt2x00dev->flags);
194 if (queue < rt2x00dev->ops->tx_queues && rt2x00dev->tx)
195 return &rt2x00dev->tx[queue];
200 if (queue == QID_BEACON)
201 return &rt2x00dev->bcn[0];
202 else if (queue == QID_ATIM && atim)
203 return &rt2x00dev->bcn[1];
207 EXPORT_SYMBOL_GPL(rt2x00queue_get_queue);
209 struct queue_entry *rt2x00queue_get_entry(struct data_queue *queue,
210 enum queue_index index)
212 struct queue_entry *entry;
213 unsigned long irqflags;
215 if (unlikely(index >= Q_INDEX_MAX)) {
216 ERROR(queue->rt2x00dev,
217 "Entry requested from invalid index type (%d)\n", index);
221 spin_lock_irqsave(&queue->lock, irqflags);
223 entry = &queue->entries[queue->index[index]];
225 spin_unlock_irqrestore(&queue->lock, irqflags);
229 EXPORT_SYMBOL_GPL(rt2x00queue_get_entry);
231 void rt2x00queue_index_inc(struct data_queue *queue, enum queue_index index)
233 unsigned long irqflags;
235 if (unlikely(index >= Q_INDEX_MAX)) {
236 ERROR(queue->rt2x00dev,
237 "Index change on invalid index type (%d)\n", index);
241 spin_lock_irqsave(&queue->lock, irqflags);
243 queue->index[index]++;
244 if (queue->index[index] >= queue->limit)
245 queue->index[index] = 0;
247 if (index == Q_INDEX) {
249 } else if (index == Q_INDEX_DONE) {
254 spin_unlock_irqrestore(&queue->lock, irqflags);
256 EXPORT_SYMBOL_GPL(rt2x00queue_index_inc);
258 static void rt2x00queue_reset(struct data_queue *queue)
260 unsigned long irqflags;
262 spin_lock_irqsave(&queue->lock, irqflags);
266 memset(queue->index, 0, sizeof(queue->index));
268 spin_unlock_irqrestore(&queue->lock, irqflags);
271 void rt2x00queue_init_rx(struct rt2x00_dev *rt2x00dev)
273 struct data_queue *queue = rt2x00dev->rx;
276 rt2x00queue_reset(queue);
278 if (!rt2x00dev->ops->lib->init_rxentry)
281 for (i = 0; i < queue->limit; i++)
282 rt2x00dev->ops->lib->init_rxentry(rt2x00dev,
286 void rt2x00queue_init_tx(struct rt2x00_dev *rt2x00dev)
288 struct data_queue *queue;
291 txall_queue_for_each(rt2x00dev, queue) {
292 rt2x00queue_reset(queue);
294 if (!rt2x00dev->ops->lib->init_txentry)
297 for (i = 0; i < queue->limit; i++)
298 rt2x00dev->ops->lib->init_txentry(rt2x00dev,
303 static int rt2x00queue_alloc_entries(struct data_queue *queue,
304 const struct data_queue_desc *qdesc)
306 struct queue_entry *entries;
307 unsigned int entry_size;
310 rt2x00queue_reset(queue);
312 queue->limit = qdesc->entry_num;
313 queue->data_size = qdesc->data_size;
314 queue->desc_size = qdesc->desc_size;
317 * Allocate all queue entries.
319 entry_size = sizeof(*entries) + qdesc->priv_size;
320 entries = kzalloc(queue->limit * entry_size, GFP_KERNEL);
324 #define QUEUE_ENTRY_PRIV_OFFSET(__base, __index, __limit, __esize, __psize) \
325 ( ((char *)(__base)) + ((__limit) * (__esize)) + \
326 ((__index) * (__psize)) )
328 for (i = 0; i < queue->limit; i++) {
329 entries[i].flags = 0;
330 entries[i].queue = queue;
331 entries[i].skb = NULL;
332 entries[i].entry_idx = i;
333 entries[i].priv_data =
334 QUEUE_ENTRY_PRIV_OFFSET(entries, i, queue->limit,
335 sizeof(*entries), qdesc->priv_size);
338 #undef QUEUE_ENTRY_PRIV_OFFSET
340 queue->entries = entries;
345 int rt2x00queue_initialize(struct rt2x00_dev *rt2x00dev)
347 struct data_queue *queue;
351 status = rt2x00queue_alloc_entries(rt2x00dev->rx, rt2x00dev->ops->rx);
355 tx_queue_for_each(rt2x00dev, queue) {
356 status = rt2x00queue_alloc_entries(queue, rt2x00dev->ops->tx);
361 status = rt2x00queue_alloc_entries(rt2x00dev->bcn, rt2x00dev->ops->bcn);
365 if (!test_bit(DRIVER_REQUIRE_ATIM_QUEUE, &rt2x00dev->flags))
368 status = rt2x00queue_alloc_entries(&rt2x00dev->bcn[1],
369 rt2x00dev->ops->atim);
376 ERROR(rt2x00dev, "Queue entries allocation failed.\n");
378 rt2x00queue_uninitialize(rt2x00dev);
383 void rt2x00queue_uninitialize(struct rt2x00_dev *rt2x00dev)
385 struct data_queue *queue;
387 queue_for_each(rt2x00dev, queue) {
388 kfree(queue->entries);
389 queue->entries = NULL;
393 static void rt2x00queue_init(struct rt2x00_dev *rt2x00dev,
394 struct data_queue *queue, enum data_queue_qid qid)
396 spin_lock_init(&queue->lock);
398 queue->rt2x00dev = rt2x00dev;
405 int rt2x00queue_allocate(struct rt2x00_dev *rt2x00dev)
407 struct data_queue *queue;
408 enum data_queue_qid qid;
409 unsigned int req_atim =
410 !!test_bit(DRIVER_REQUIRE_ATIM_QUEUE, &rt2x00dev->flags);
413 * We need the following queues:
417 * Atim: 1 (if required)
419 rt2x00dev->data_queues = 2 + rt2x00dev->ops->tx_queues + req_atim;
421 queue = kzalloc(rt2x00dev->data_queues * sizeof(*queue), GFP_KERNEL);
423 ERROR(rt2x00dev, "Queue allocation failed.\n");
428 * Initialize pointers
430 rt2x00dev->rx = queue;
431 rt2x00dev->tx = &queue[1];
432 rt2x00dev->bcn = &queue[1 + rt2x00dev->ops->tx_queues];
435 * Initialize queue parameters.
437 * TX: qid = QID_AC_BE + index
438 * TX: cw_min: 2^5 = 32.
439 * TX: cw_max: 2^10 = 1024.
440 * BCN & Atim: qid = QID_MGMT
442 rt2x00queue_init(rt2x00dev, rt2x00dev->rx, QID_RX);
445 tx_queue_for_each(rt2x00dev, queue)
446 rt2x00queue_init(rt2x00dev, queue, qid++);
448 rt2x00queue_init(rt2x00dev, &rt2x00dev->bcn[0], QID_MGMT);
450 rt2x00queue_init(rt2x00dev, &rt2x00dev->bcn[1], QID_MGMT);
455 void rt2x00queue_free(struct rt2x00_dev *rt2x00dev)
457 kfree(rt2x00dev->rx);
458 rt2x00dev->rx = NULL;
459 rt2x00dev->tx = NULL;
460 rt2x00dev->bcn = NULL;