Linux Audio

Check our new training course

Buildroot integration, development and maintenance

Need a Buildroot system for your embedded project?
Loading...
Note: File does not exist in v5.4.
  1/******************************************************************************
  2 *
  3 * Copyright(c) 2003 - 2011 Intel Corporation. All rights reserved.
  4 *
  5 * Portions of this file are derived from the ipw3945 project, as well
  6 * as portions of the ieee80211 subsystem header files.
  7 *
  8 * This program is free software; you can redistribute it and/or modify it
  9 * under the terms of version 2 of the GNU General Public License as
 10 * published by the Free Software Foundation.
 11 *
 12 * This program is distributed in the hope that it will be useful, but WITHOUT
 13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 14 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 15 * more details.
 16 *
 17 * You should have received a copy of the GNU General Public License along with
 18 * this program; if not, write to the Free Software Foundation, Inc.,
 19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
 20 *
 21 * The full GNU General Public License is included in this distribution in the
 22 * file called LICENSE.
 23 *
 24 * Contact Information:
 25 *  Intel Linux Wireless <ilw@linux.intel.com>
 26 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 27 *
 28 *****************************************************************************/
 29
 30#include <linux/etherdevice.h>
 31#include <linux/slab.h>
 32#include <net/mac80211.h>
 33#include <asm/unaligned.h>
 34#include "iwl-eeprom.h"
 35#include "iwl-dev.h"
 36#include "iwl-core.h"
 37#include "iwl-sta.h"
 38#include "iwl-io.h"
 39#include "iwl-helpers.h"
 40/************************** RX-FUNCTIONS ****************************/
 41/*
 42 * Rx theory of operation
 43 *
 44 * Driver allocates a circular buffer of Receive Buffer Descriptors (RBDs),
 45 * each of which point to Receive Buffers to be filled by the NIC.  These get
 46 * used not only for Rx frames, but for any command response or notification
 47 * from the NIC.  The driver and NIC manage the Rx buffers by means
 48 * of indexes into the circular buffer.
 49 *
 50 * Rx Queue Indexes
 51 * The host/firmware share two index registers for managing the Rx buffers.
 52 *
 53 * The READ index maps to the first position that the firmware may be writing
 54 * to -- the driver can read up to (but not including) this position and get
 55 * good data.
 56 * The READ index is managed by the firmware once the card is enabled.
 57 *
 58 * The WRITE index maps to the last position the driver has read from -- the
 59 * position preceding WRITE is the last slot the firmware can place a packet.
 60 *
 61 * The queue is empty (no good data) if WRITE = READ - 1, and is full if
 62 * WRITE = READ.
 63 *
 64 * During initialization, the host sets up the READ queue position to the first
 65 * INDEX position, and WRITE to the last (READ - 1 wrapped)
 66 *
 67 * When the firmware places a packet in a buffer, it will advance the READ index
 68 * and fire the RX interrupt.  The driver can then query the READ index and
 69 * process as many packets as possible, moving the WRITE index forward as it
 70 * resets the Rx queue buffers with new memory.
 71 *
 72 * The management in the driver is as follows:
 73 * + A list of pre-allocated SKBs is stored in iwl->rxq->rx_free.  When
 74 *   iwl->rxq->free_count drops to or below RX_LOW_WATERMARK, work is scheduled
 75 *   to replenish the iwl->rxq->rx_free.
 76 * + In iwl_rx_replenish (scheduled) if 'processed' != 'read' then the
 77 *   iwl->rxq is replenished and the READ INDEX is updated (updating the
 78 *   'processed' and 'read' driver indexes as well)
 79 * + A received packet is processed and handed to the kernel network stack,
 80 *   detached from the iwl->rxq.  The driver 'processed' index is updated.
 81 * + The Host/Firmware iwl->rxq is replenished at tasklet time from the rx_free
 82 *   list. If there are no allocated buffers in iwl->rxq->rx_free, the READ
 83 *   INDEX is not incremented and iwl->status(RX_STALLED) is set.  If there
 84 *   were enough free buffers and RX_STALLED is set it is cleared.
 85 *
 86 *
 87 * Driver sequence:
 88 *
 89 * iwl_legacy_rx_queue_alloc()   Allocates rx_free
 90 * iwl_rx_replenish()     Replenishes rx_free list from rx_used, and calls
 91 *                            iwl_rx_queue_restock
 92 * iwl_rx_queue_restock() Moves available buffers from rx_free into Rx
 93 *                            queue, updates firmware pointers, and updates
 94 *                            the WRITE index.  If insufficient rx_free buffers
 95 *                            are available, schedules iwl_rx_replenish
 96 *
 97 * -- enable interrupts --
 98 * ISR - iwl_rx()         Detach iwl_rx_mem_buffers from pool up to the
 99 *                            READ INDEX, detaching the SKB from the pool.
100 *                            Moves the packet buffer from queue to rx_used.
101 *                            Calls iwl_rx_queue_restock to refill any empty
102 *                            slots.
103 * ...
104 *
105 */
106
107/**
108 * iwl_legacy_rx_queue_space - Return number of free slots available in queue.
109 */
110int iwl_legacy_rx_queue_space(const struct iwl_rx_queue *q)
111{
112	int s = q->read - q->write;
113	if (s <= 0)
114		s += RX_QUEUE_SIZE;
115	/* keep some buffer to not confuse full and empty queue */
116	s -= 2;
117	if (s < 0)
118		s = 0;
119	return s;
120}
121EXPORT_SYMBOL(iwl_legacy_rx_queue_space);
122
123/**
124 * iwl_legacy_rx_queue_update_write_ptr - Update the write pointer for the RX queue
125 */
126void
127iwl_legacy_rx_queue_update_write_ptr(struct iwl_priv *priv,
128					struct iwl_rx_queue *q)
129{
130	unsigned long flags;
131	u32 rx_wrt_ptr_reg = priv->hw_params.rx_wrt_ptr_reg;
132	u32 reg;
133
134	spin_lock_irqsave(&q->lock, flags);
135
136	if (q->need_update == 0)
137		goto exit_unlock;
138
139	/* If power-saving is in use, make sure device is awake */
140	if (test_bit(STATUS_POWER_PMI, &priv->status)) {
141		reg = iwl_read32(priv, CSR_UCODE_DRV_GP1);
142
143		if (reg & CSR_UCODE_DRV_GP1_BIT_MAC_SLEEP) {
144			IWL_DEBUG_INFO(priv,
145				"Rx queue requesting wakeup,"
146				" GP1 = 0x%x\n", reg);
147			iwl_legacy_set_bit(priv, CSR_GP_CNTRL,
148				CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ);
149			goto exit_unlock;
150		}
151
152		q->write_actual = (q->write & ~0x7);
153		iwl_legacy_write_direct32(priv, rx_wrt_ptr_reg,
154				q->write_actual);
155
156	/* Else device is assumed to be awake */
157	} else {
158		/* Device expects a multiple of 8 */
159		q->write_actual = (q->write & ~0x7);
160		iwl_legacy_write_direct32(priv, rx_wrt_ptr_reg,
161			q->write_actual);
162	}
163
164	q->need_update = 0;
165
166 exit_unlock:
167	spin_unlock_irqrestore(&q->lock, flags);
168}
169EXPORT_SYMBOL(iwl_legacy_rx_queue_update_write_ptr);
170
171int iwl_legacy_rx_queue_alloc(struct iwl_priv *priv)
172{
173	struct iwl_rx_queue *rxq = &priv->rxq;
174	struct device *dev = &priv->pci_dev->dev;
175	int i;
176
177	spin_lock_init(&rxq->lock);
178	INIT_LIST_HEAD(&rxq->rx_free);
179	INIT_LIST_HEAD(&rxq->rx_used);
180
181	/* Alloc the circular buffer of Read Buffer Descriptors (RBDs) */
182	rxq->bd = dma_alloc_coherent(dev, 4 * RX_QUEUE_SIZE, &rxq->bd_dma,
183				     GFP_KERNEL);
184	if (!rxq->bd)
185		goto err_bd;
186
187	rxq->rb_stts = dma_alloc_coherent(dev, sizeof(struct iwl_rb_status),
188					  &rxq->rb_stts_dma, GFP_KERNEL);
189	if (!rxq->rb_stts)
190		goto err_rb;
191
192	/* Fill the rx_used queue with _all_ of the Rx buffers */
193	for (i = 0; i < RX_FREE_BUFFERS + RX_QUEUE_SIZE; i++)
194		list_add_tail(&rxq->pool[i].list, &rxq->rx_used);
195
196	/* Set us so that we have processed and used all buffers, but have
197	 * not restocked the Rx queue with fresh buffers */
198	rxq->read = rxq->write = 0;
199	rxq->write_actual = 0;
200	rxq->free_count = 0;
201	rxq->need_update = 0;
202	return 0;
203
204err_rb:
205	dma_free_coherent(&priv->pci_dev->dev, 4 * RX_QUEUE_SIZE, rxq->bd,
206			  rxq->bd_dma);
207err_bd:
208	return -ENOMEM;
209}
210EXPORT_SYMBOL(iwl_legacy_rx_queue_alloc);
211
212
213void iwl_legacy_rx_spectrum_measure_notif(struct iwl_priv *priv,
214					  struct iwl_rx_mem_buffer *rxb)
215{
216	struct iwl_rx_packet *pkt = rxb_addr(rxb);
217	struct iwl_spectrum_notification *report = &(pkt->u.spectrum_notif);
218
219	if (!report->state) {
220		IWL_DEBUG_11H(priv,
221			"Spectrum Measure Notification: Start\n");
222		return;
223	}
224
225	memcpy(&priv->measure_report, report, sizeof(*report));
226	priv->measurement_status |= MEASUREMENT_READY;
227}
228EXPORT_SYMBOL(iwl_legacy_rx_spectrum_measure_notif);
229
230/*
231 * returns non-zero if packet should be dropped
232 */
233int iwl_legacy_set_decrypted_flag(struct iwl_priv *priv,
234			   struct ieee80211_hdr *hdr,
235			   u32 decrypt_res,
236			   struct ieee80211_rx_status *stats)
237{
238	u16 fc = le16_to_cpu(hdr->frame_control);
239
240	/*
241	 * All contexts have the same setting here due to it being
242	 * a module parameter, so OK to check any context.
243	 */
244	if (priv->contexts[IWL_RXON_CTX_BSS].active.filter_flags &
245						RXON_FILTER_DIS_DECRYPT_MSK)
246		return 0;
247
248	if (!(fc & IEEE80211_FCTL_PROTECTED))
249		return 0;
250
251	IWL_DEBUG_RX(priv, "decrypt_res:0x%x\n", decrypt_res);
252	switch (decrypt_res & RX_RES_STATUS_SEC_TYPE_MSK) {
253	case RX_RES_STATUS_SEC_TYPE_TKIP:
254		/* The uCode has got a bad phase 1 Key, pushes the packet.
255		 * Decryption will be done in SW. */
256		if ((decrypt_res & RX_RES_STATUS_DECRYPT_TYPE_MSK) ==
257		    RX_RES_STATUS_BAD_KEY_TTAK)
258			break;
259
260	case RX_RES_STATUS_SEC_TYPE_WEP:
261		if ((decrypt_res & RX_RES_STATUS_DECRYPT_TYPE_MSK) ==
262		    RX_RES_STATUS_BAD_ICV_MIC) {
263			/* bad ICV, the packet is destroyed since the
264			 * decryption is inplace, drop it */
265			IWL_DEBUG_RX(priv, "Packet destroyed\n");
266			return -1;
267		}
268	case RX_RES_STATUS_SEC_TYPE_CCMP:
269		if ((decrypt_res & RX_RES_STATUS_DECRYPT_TYPE_MSK) ==
270		    RX_RES_STATUS_DECRYPT_OK) {
271			IWL_DEBUG_RX(priv, "hw decrypt successfully!!!\n");
272			stats->flag |= RX_FLAG_DECRYPTED;
273		}
274		break;
275
276	default:
277		break;
278	}
279	return 0;
280}
281EXPORT_SYMBOL(iwl_legacy_set_decrypted_flag);