drivers/net: Remove unnecessary returns from void function()s
[linux-2.6/kvm.git] / drivers / net / wireless / iwlwifi / iwl-calib.c
blob7e822777321331cb5f9ae8303e16613247c2c580
1 /******************************************************************************
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
6 * GPL LICENSE SUMMARY
8 * Copyright(c) 2008 - 2010 Intel Corporation. All rights reserved.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of version 2 of the GNU General Public License as
12 * published by the Free Software Foundation.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
22 * USA
24 * The full GNU General Public License is included in this distribution
25 * in the file called LICENSE.GPL.
27 * Contact Information:
28 * Intel Linux Wireless <ilw@linux.intel.com>
29 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
31 * BSD LICENSE
33 * Copyright(c) 2005 - 2010 Intel Corporation. All rights reserved.
34 * All rights reserved.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
40 * * Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * * Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in
44 * the documentation and/or other materials provided with the
45 * distribution.
46 * * Neither the name Intel Corporation nor the names of its
47 * contributors may be used to endorse or promote products derived
48 * from this software without specific prior written permission.
50 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
51 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
52 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
53 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
54 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
56 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
57 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
58 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
59 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
60 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
61 *****************************************************************************/
63 #include <linux/slab.h>
64 #include <net/mac80211.h>
66 #include "iwl-dev.h"
67 #include "iwl-core.h"
68 #include "iwl-calib.h"
70 /*****************************************************************************
71 * INIT calibrations framework
72 *****************************************************************************/
74 struct statistics_general_data {
75 u32 beacon_silence_rssi_a;
76 u32 beacon_silence_rssi_b;
77 u32 beacon_silence_rssi_c;
78 u32 beacon_energy_a;
79 u32 beacon_energy_b;
80 u32 beacon_energy_c;
83 int iwl_send_calib_results(struct iwl_priv *priv)
85 int ret = 0;
86 int i = 0;
88 struct iwl_host_cmd hcmd = {
89 .id = REPLY_PHY_CALIBRATION_CMD,
90 .flags = CMD_SIZE_HUGE,
93 for (i = 0; i < IWL_CALIB_MAX; i++) {
94 if ((BIT(i) & priv->hw_params.calib_init_cfg) &&
95 priv->calib_results[i].buf) {
96 hcmd.len = priv->calib_results[i].buf_len;
97 hcmd.data = priv->calib_results[i].buf;
98 ret = iwl_send_cmd_sync(priv, &hcmd);
99 if (ret)
100 goto err;
104 return 0;
105 err:
106 IWL_ERR(priv, "Error %d iteration %d\n", ret, i);
107 return ret;
109 EXPORT_SYMBOL(iwl_send_calib_results);
111 int iwl_calib_set(struct iwl_calib_result *res, const u8 *buf, int len)
113 if (res->buf_len != len) {
114 kfree(res->buf);
115 res->buf = kzalloc(len, GFP_ATOMIC);
117 if (unlikely(res->buf == NULL))
118 return -ENOMEM;
120 res->buf_len = len;
121 memcpy(res->buf, buf, len);
122 return 0;
124 EXPORT_SYMBOL(iwl_calib_set);
126 void iwl_calib_free_results(struct iwl_priv *priv)
128 int i;
130 for (i = 0; i < IWL_CALIB_MAX; i++) {
131 kfree(priv->calib_results[i].buf);
132 priv->calib_results[i].buf = NULL;
133 priv->calib_results[i].buf_len = 0;
136 EXPORT_SYMBOL(iwl_calib_free_results);
138 /*****************************************************************************
139 * RUNTIME calibrations framework
140 *****************************************************************************/
142 /* "false alarms" are signals that our DSP tries to lock onto,
143 * but then determines that they are either noise, or transmissions
144 * from a distant wireless network (also "noise", really) that get
145 * "stepped on" by stronger transmissions within our own network.
146 * This algorithm attempts to set a sensitivity level that is high
147 * enough to receive all of our own network traffic, but not so
148 * high that our DSP gets too busy trying to lock onto non-network
149 * activity/noise. */
150 static int iwl_sens_energy_cck(struct iwl_priv *priv,
151 u32 norm_fa,
152 u32 rx_enable_time,
153 struct statistics_general_data *rx_info)
155 u32 max_nrg_cck = 0;
156 int i = 0;
157 u8 max_silence_rssi = 0;
158 u32 silence_ref = 0;
159 u8 silence_rssi_a = 0;
160 u8 silence_rssi_b = 0;
161 u8 silence_rssi_c = 0;
162 u32 val;
164 /* "false_alarms" values below are cross-multiplications to assess the
165 * numbers of false alarms within the measured period of actual Rx
166 * (Rx is off when we're txing), vs the min/max expected false alarms
167 * (some should be expected if rx is sensitive enough) in a
168 * hypothetical listening period of 200 time units (TU), 204.8 msec:
170 * MIN_FA/fixed-time < false_alarms/actual-rx-time < MAX_FA/beacon-time
172 * */
173 u32 false_alarms = norm_fa * 200 * 1024;
174 u32 max_false_alarms = MAX_FA_CCK * rx_enable_time;
175 u32 min_false_alarms = MIN_FA_CCK * rx_enable_time;
176 struct iwl_sensitivity_data *data = NULL;
177 const struct iwl_sensitivity_ranges *ranges = priv->hw_params.sens;
179 data = &(priv->sensitivity_data);
181 data->nrg_auto_corr_silence_diff = 0;
183 /* Find max silence rssi among all 3 receivers.
184 * This is background noise, which may include transmissions from other
185 * networks, measured during silence before our network's beacon */
186 silence_rssi_a = (u8)((rx_info->beacon_silence_rssi_a &
187 ALL_BAND_FILTER) >> 8);
188 silence_rssi_b = (u8)((rx_info->beacon_silence_rssi_b &
189 ALL_BAND_FILTER) >> 8);
190 silence_rssi_c = (u8)((rx_info->beacon_silence_rssi_c &
191 ALL_BAND_FILTER) >> 8);
193 val = max(silence_rssi_b, silence_rssi_c);
194 max_silence_rssi = max(silence_rssi_a, (u8) val);
196 /* Store silence rssi in 20-beacon history table */
197 data->nrg_silence_rssi[data->nrg_silence_idx] = max_silence_rssi;
198 data->nrg_silence_idx++;
199 if (data->nrg_silence_idx >= NRG_NUM_PREV_STAT_L)
200 data->nrg_silence_idx = 0;
202 /* Find max silence rssi across 20 beacon history */
203 for (i = 0; i < NRG_NUM_PREV_STAT_L; i++) {
204 val = data->nrg_silence_rssi[i];
205 silence_ref = max(silence_ref, val);
207 IWL_DEBUG_CALIB(priv, "silence a %u, b %u, c %u, 20-bcn max %u\n",
208 silence_rssi_a, silence_rssi_b, silence_rssi_c,
209 silence_ref);
211 /* Find max rx energy (min value!) among all 3 receivers,
212 * measured during beacon frame.
213 * Save it in 10-beacon history table. */
214 i = data->nrg_energy_idx;
215 val = min(rx_info->beacon_energy_b, rx_info->beacon_energy_c);
216 data->nrg_value[i] = min(rx_info->beacon_energy_a, val);
218 data->nrg_energy_idx++;
219 if (data->nrg_energy_idx >= 10)
220 data->nrg_energy_idx = 0;
222 /* Find min rx energy (max value) across 10 beacon history.
223 * This is the minimum signal level that we want to receive well.
224 * Add backoff (margin so we don't miss slightly lower energy frames).
225 * This establishes an upper bound (min value) for energy threshold. */
226 max_nrg_cck = data->nrg_value[0];
227 for (i = 1; i < 10; i++)
228 max_nrg_cck = (u32) max(max_nrg_cck, (data->nrg_value[i]));
229 max_nrg_cck += 6;
231 IWL_DEBUG_CALIB(priv, "rx energy a %u, b %u, c %u, 10-bcn max/min %u\n",
232 rx_info->beacon_energy_a, rx_info->beacon_energy_b,
233 rx_info->beacon_energy_c, max_nrg_cck - 6);
235 /* Count number of consecutive beacons with fewer-than-desired
236 * false alarms. */
237 if (false_alarms < min_false_alarms)
238 data->num_in_cck_no_fa++;
239 else
240 data->num_in_cck_no_fa = 0;
241 IWL_DEBUG_CALIB(priv, "consecutive bcns with few false alarms = %u\n",
242 data->num_in_cck_no_fa);
244 /* If we got too many false alarms this time, reduce sensitivity */
245 if ((false_alarms > max_false_alarms) &&
246 (data->auto_corr_cck > AUTO_CORR_MAX_TH_CCK)) {
247 IWL_DEBUG_CALIB(priv, "norm FA %u > max FA %u\n",
248 false_alarms, max_false_alarms);
249 IWL_DEBUG_CALIB(priv, "... reducing sensitivity\n");
250 data->nrg_curr_state = IWL_FA_TOO_MANY;
251 /* Store for "fewer than desired" on later beacon */
252 data->nrg_silence_ref = silence_ref;
254 /* increase energy threshold (reduce nrg value)
255 * to decrease sensitivity */
256 data->nrg_th_cck = data->nrg_th_cck - NRG_STEP_CCK;
257 /* Else if we got fewer than desired, increase sensitivity */
258 } else if (false_alarms < min_false_alarms) {
259 data->nrg_curr_state = IWL_FA_TOO_FEW;
261 /* Compare silence level with silence level for most recent
262 * healthy number or too many false alarms */
263 data->nrg_auto_corr_silence_diff = (s32)data->nrg_silence_ref -
264 (s32)silence_ref;
266 IWL_DEBUG_CALIB(priv, "norm FA %u < min FA %u, silence diff %d\n",
267 false_alarms, min_false_alarms,
268 data->nrg_auto_corr_silence_diff);
270 /* Increase value to increase sensitivity, but only if:
271 * 1a) previous beacon did *not* have *too many* false alarms
272 * 1b) AND there's a significant difference in Rx levels
273 * from a previous beacon with too many, or healthy # FAs
274 * OR 2) We've seen a lot of beacons (100) with too few
275 * false alarms */
276 if ((data->nrg_prev_state != IWL_FA_TOO_MANY) &&
277 ((data->nrg_auto_corr_silence_diff > NRG_DIFF) ||
278 (data->num_in_cck_no_fa > MAX_NUMBER_CCK_NO_FA))) {
280 IWL_DEBUG_CALIB(priv, "... increasing sensitivity\n");
281 /* Increase nrg value to increase sensitivity */
282 val = data->nrg_th_cck + NRG_STEP_CCK;
283 data->nrg_th_cck = min((u32)ranges->min_nrg_cck, val);
284 } else {
285 IWL_DEBUG_CALIB(priv, "... but not changing sensitivity\n");
288 /* Else we got a healthy number of false alarms, keep status quo */
289 } else {
290 IWL_DEBUG_CALIB(priv, " FA in safe zone\n");
291 data->nrg_curr_state = IWL_FA_GOOD_RANGE;
293 /* Store for use in "fewer than desired" with later beacon */
294 data->nrg_silence_ref = silence_ref;
296 /* If previous beacon had too many false alarms,
297 * give it some extra margin by reducing sensitivity again
298 * (but don't go below measured energy of desired Rx) */
299 if (IWL_FA_TOO_MANY == data->nrg_prev_state) {
300 IWL_DEBUG_CALIB(priv, "... increasing margin\n");
301 if (data->nrg_th_cck > (max_nrg_cck + NRG_MARGIN))
302 data->nrg_th_cck -= NRG_MARGIN;
303 else
304 data->nrg_th_cck = max_nrg_cck;
308 /* Make sure the energy threshold does not go above the measured
309 * energy of the desired Rx signals (reduced by backoff margin),
310 * or else we might start missing Rx frames.
311 * Lower value is higher energy, so we use max()!
313 data->nrg_th_cck = max(max_nrg_cck, data->nrg_th_cck);
314 IWL_DEBUG_CALIB(priv, "new nrg_th_cck %u\n", data->nrg_th_cck);
316 data->nrg_prev_state = data->nrg_curr_state;
318 /* Auto-correlation CCK algorithm */
319 if (false_alarms > min_false_alarms) {
321 /* increase auto_corr values to decrease sensitivity
322 * so the DSP won't be disturbed by the noise
324 if (data->auto_corr_cck < AUTO_CORR_MAX_TH_CCK)
325 data->auto_corr_cck = AUTO_CORR_MAX_TH_CCK + 1;
326 else {
327 val = data->auto_corr_cck + AUTO_CORR_STEP_CCK;
328 data->auto_corr_cck =
329 min((u32)ranges->auto_corr_max_cck, val);
331 val = data->auto_corr_cck_mrc + AUTO_CORR_STEP_CCK;
332 data->auto_corr_cck_mrc =
333 min((u32)ranges->auto_corr_max_cck_mrc, val);
334 } else if ((false_alarms < min_false_alarms) &&
335 ((data->nrg_auto_corr_silence_diff > NRG_DIFF) ||
336 (data->num_in_cck_no_fa > MAX_NUMBER_CCK_NO_FA))) {
338 /* Decrease auto_corr values to increase sensitivity */
339 val = data->auto_corr_cck - AUTO_CORR_STEP_CCK;
340 data->auto_corr_cck =
341 max((u32)ranges->auto_corr_min_cck, val);
342 val = data->auto_corr_cck_mrc - AUTO_CORR_STEP_CCK;
343 data->auto_corr_cck_mrc =
344 max((u32)ranges->auto_corr_min_cck_mrc, val);
347 return 0;
351 static int iwl_sens_auto_corr_ofdm(struct iwl_priv *priv,
352 u32 norm_fa,
353 u32 rx_enable_time)
355 u32 val;
356 u32 false_alarms = norm_fa * 200 * 1024;
357 u32 max_false_alarms = MAX_FA_OFDM * rx_enable_time;
358 u32 min_false_alarms = MIN_FA_OFDM * rx_enable_time;
359 struct iwl_sensitivity_data *data = NULL;
360 const struct iwl_sensitivity_ranges *ranges = priv->hw_params.sens;
362 data = &(priv->sensitivity_data);
364 /* If we got too many false alarms this time, reduce sensitivity */
365 if (false_alarms > max_false_alarms) {
367 IWL_DEBUG_CALIB(priv, "norm FA %u > max FA %u)\n",
368 false_alarms, max_false_alarms);
370 val = data->auto_corr_ofdm + AUTO_CORR_STEP_OFDM;
371 data->auto_corr_ofdm =
372 min((u32)ranges->auto_corr_max_ofdm, val);
374 val = data->auto_corr_ofdm_mrc + AUTO_CORR_STEP_OFDM;
375 data->auto_corr_ofdm_mrc =
376 min((u32)ranges->auto_corr_max_ofdm_mrc, val);
378 val = data->auto_corr_ofdm_x1 + AUTO_CORR_STEP_OFDM;
379 data->auto_corr_ofdm_x1 =
380 min((u32)ranges->auto_corr_max_ofdm_x1, val);
382 val = data->auto_corr_ofdm_mrc_x1 + AUTO_CORR_STEP_OFDM;
383 data->auto_corr_ofdm_mrc_x1 =
384 min((u32)ranges->auto_corr_max_ofdm_mrc_x1, val);
387 /* Else if we got fewer than desired, increase sensitivity */
388 else if (false_alarms < min_false_alarms) {
390 IWL_DEBUG_CALIB(priv, "norm FA %u < min FA %u\n",
391 false_alarms, min_false_alarms);
393 val = data->auto_corr_ofdm - AUTO_CORR_STEP_OFDM;
394 data->auto_corr_ofdm =
395 max((u32)ranges->auto_corr_min_ofdm, val);
397 val = data->auto_corr_ofdm_mrc - AUTO_CORR_STEP_OFDM;
398 data->auto_corr_ofdm_mrc =
399 max((u32)ranges->auto_corr_min_ofdm_mrc, val);
401 val = data->auto_corr_ofdm_x1 - AUTO_CORR_STEP_OFDM;
402 data->auto_corr_ofdm_x1 =
403 max((u32)ranges->auto_corr_min_ofdm_x1, val);
405 val = data->auto_corr_ofdm_mrc_x1 - AUTO_CORR_STEP_OFDM;
406 data->auto_corr_ofdm_mrc_x1 =
407 max((u32)ranges->auto_corr_min_ofdm_mrc_x1, val);
408 } else {
409 IWL_DEBUG_CALIB(priv, "min FA %u < norm FA %u < max FA %u OK\n",
410 min_false_alarms, false_alarms, max_false_alarms);
412 return 0;
415 /* Prepare a SENSITIVITY_CMD, send to uCode if values have changed */
416 static int iwl_sensitivity_write(struct iwl_priv *priv)
418 struct iwl_sensitivity_cmd cmd ;
419 struct iwl_sensitivity_data *data = NULL;
420 struct iwl_host_cmd cmd_out = {
421 .id = SENSITIVITY_CMD,
422 .len = sizeof(struct iwl_sensitivity_cmd),
423 .flags = CMD_ASYNC,
424 .data = &cmd,
427 data = &(priv->sensitivity_data);
429 memset(&cmd, 0, sizeof(cmd));
431 cmd.table[HD_AUTO_CORR32_X4_TH_ADD_MIN_INDEX] =
432 cpu_to_le16((u16)data->auto_corr_ofdm);
433 cmd.table[HD_AUTO_CORR32_X4_TH_ADD_MIN_MRC_INDEX] =
434 cpu_to_le16((u16)data->auto_corr_ofdm_mrc);
435 cmd.table[HD_AUTO_CORR32_X1_TH_ADD_MIN_INDEX] =
436 cpu_to_le16((u16)data->auto_corr_ofdm_x1);
437 cmd.table[HD_AUTO_CORR32_X1_TH_ADD_MIN_MRC_INDEX] =
438 cpu_to_le16((u16)data->auto_corr_ofdm_mrc_x1);
440 cmd.table[HD_AUTO_CORR40_X4_TH_ADD_MIN_INDEX] =
441 cpu_to_le16((u16)data->auto_corr_cck);
442 cmd.table[HD_AUTO_CORR40_X4_TH_ADD_MIN_MRC_INDEX] =
443 cpu_to_le16((u16)data->auto_corr_cck_mrc);
445 cmd.table[HD_MIN_ENERGY_CCK_DET_INDEX] =
446 cpu_to_le16((u16)data->nrg_th_cck);
447 cmd.table[HD_MIN_ENERGY_OFDM_DET_INDEX] =
448 cpu_to_le16((u16)data->nrg_th_ofdm);
450 cmd.table[HD_BARKER_CORR_TH_ADD_MIN_INDEX] =
451 cpu_to_le16(data->barker_corr_th_min);
452 cmd.table[HD_BARKER_CORR_TH_ADD_MIN_MRC_INDEX] =
453 cpu_to_le16(data->barker_corr_th_min_mrc);
454 cmd.table[HD_OFDM_ENERGY_TH_IN_INDEX] =
455 cpu_to_le16(data->nrg_th_cca);
457 IWL_DEBUG_CALIB(priv, "ofdm: ac %u mrc %u x1 %u mrc_x1 %u thresh %u\n",
458 data->auto_corr_ofdm, data->auto_corr_ofdm_mrc,
459 data->auto_corr_ofdm_x1, data->auto_corr_ofdm_mrc_x1,
460 data->nrg_th_ofdm);
462 IWL_DEBUG_CALIB(priv, "cck: ac %u mrc %u thresh %u\n",
463 data->auto_corr_cck, data->auto_corr_cck_mrc,
464 data->nrg_th_cck);
466 /* Update uCode's "work" table, and copy it to DSP */
467 cmd.control = SENSITIVITY_CMD_CONTROL_WORK_TABLE;
469 /* Don't send command to uCode if nothing has changed */
470 if (!memcmp(&cmd.table[0], &(priv->sensitivity_tbl[0]),
471 sizeof(u16)*HD_TABLE_SIZE)) {
472 IWL_DEBUG_CALIB(priv, "No change in SENSITIVITY_CMD\n");
473 return 0;
476 /* Copy table for comparison next time */
477 memcpy(&(priv->sensitivity_tbl[0]), &(cmd.table[0]),
478 sizeof(u16)*HD_TABLE_SIZE);
480 return iwl_send_cmd(priv, &cmd_out);
483 void iwl_init_sensitivity(struct iwl_priv *priv)
485 int ret = 0;
486 int i;
487 struct iwl_sensitivity_data *data = NULL;
488 const struct iwl_sensitivity_ranges *ranges = priv->hw_params.sens;
490 if (priv->disable_sens_cal)
491 return;
493 IWL_DEBUG_CALIB(priv, "Start iwl_init_sensitivity\n");
495 /* Clear driver's sensitivity algo data */
496 data = &(priv->sensitivity_data);
498 if (ranges == NULL)
499 return;
501 memset(data, 0, sizeof(struct iwl_sensitivity_data));
503 data->num_in_cck_no_fa = 0;
504 data->nrg_curr_state = IWL_FA_TOO_MANY;
505 data->nrg_prev_state = IWL_FA_TOO_MANY;
506 data->nrg_silence_ref = 0;
507 data->nrg_silence_idx = 0;
508 data->nrg_energy_idx = 0;
510 for (i = 0; i < 10; i++)
511 data->nrg_value[i] = 0;
513 for (i = 0; i < NRG_NUM_PREV_STAT_L; i++)
514 data->nrg_silence_rssi[i] = 0;
516 data->auto_corr_ofdm = ranges->auto_corr_min_ofdm;
517 data->auto_corr_ofdm_mrc = ranges->auto_corr_min_ofdm_mrc;
518 data->auto_corr_ofdm_x1 = ranges->auto_corr_min_ofdm_x1;
519 data->auto_corr_ofdm_mrc_x1 = ranges->auto_corr_min_ofdm_mrc_x1;
520 data->auto_corr_cck = AUTO_CORR_CCK_MIN_VAL_DEF;
521 data->auto_corr_cck_mrc = ranges->auto_corr_min_cck_mrc;
522 data->nrg_th_cck = ranges->nrg_th_cck;
523 data->nrg_th_ofdm = ranges->nrg_th_ofdm;
524 data->barker_corr_th_min = ranges->barker_corr_th_min;
525 data->barker_corr_th_min_mrc = ranges->barker_corr_th_min_mrc;
526 data->nrg_th_cca = ranges->nrg_th_cca;
528 data->last_bad_plcp_cnt_ofdm = 0;
529 data->last_fa_cnt_ofdm = 0;
530 data->last_bad_plcp_cnt_cck = 0;
531 data->last_fa_cnt_cck = 0;
533 ret |= iwl_sensitivity_write(priv);
534 IWL_DEBUG_CALIB(priv, "<<return 0x%X\n", ret);
536 EXPORT_SYMBOL(iwl_init_sensitivity);
538 void iwl_sensitivity_calibration(struct iwl_priv *priv,
539 struct iwl_notif_statistics *resp)
541 u32 rx_enable_time;
542 u32 fa_cck;
543 u32 fa_ofdm;
544 u32 bad_plcp_cck;
545 u32 bad_plcp_ofdm;
546 u32 norm_fa_ofdm;
547 u32 norm_fa_cck;
548 struct iwl_sensitivity_data *data = NULL;
549 struct statistics_rx_non_phy *rx_info = &(resp->rx.general);
550 struct statistics_rx *statistics = &(resp->rx);
551 unsigned long flags;
552 struct statistics_general_data statis;
554 if (priv->disable_sens_cal)
555 return;
557 data = &(priv->sensitivity_data);
559 if (!iwl_is_associated(priv)) {
560 IWL_DEBUG_CALIB(priv, "<< - not associated\n");
561 return;
564 spin_lock_irqsave(&priv->lock, flags);
565 if (rx_info->interference_data_flag != INTERFERENCE_DATA_AVAILABLE) {
566 IWL_DEBUG_CALIB(priv, "<< invalid data.\n");
567 spin_unlock_irqrestore(&priv->lock, flags);
568 return;
571 /* Extract Statistics: */
572 rx_enable_time = le32_to_cpu(rx_info->channel_load);
573 fa_cck = le32_to_cpu(statistics->cck.false_alarm_cnt);
574 fa_ofdm = le32_to_cpu(statistics->ofdm.false_alarm_cnt);
575 bad_plcp_cck = le32_to_cpu(statistics->cck.plcp_err);
576 bad_plcp_ofdm = le32_to_cpu(statistics->ofdm.plcp_err);
578 statis.beacon_silence_rssi_a =
579 le32_to_cpu(statistics->general.beacon_silence_rssi_a);
580 statis.beacon_silence_rssi_b =
581 le32_to_cpu(statistics->general.beacon_silence_rssi_b);
582 statis.beacon_silence_rssi_c =
583 le32_to_cpu(statistics->general.beacon_silence_rssi_c);
584 statis.beacon_energy_a =
585 le32_to_cpu(statistics->general.beacon_energy_a);
586 statis.beacon_energy_b =
587 le32_to_cpu(statistics->general.beacon_energy_b);
588 statis.beacon_energy_c =
589 le32_to_cpu(statistics->general.beacon_energy_c);
591 spin_unlock_irqrestore(&priv->lock, flags);
593 IWL_DEBUG_CALIB(priv, "rx_enable_time = %u usecs\n", rx_enable_time);
595 if (!rx_enable_time) {
596 IWL_DEBUG_CALIB(priv, "<< RX Enable Time == 0!\n");
597 return;
600 /* These statistics increase monotonically, and do not reset
601 * at each beacon. Calculate difference from last value, or just
602 * use the new statistics value if it has reset or wrapped around. */
603 if (data->last_bad_plcp_cnt_cck > bad_plcp_cck)
604 data->last_bad_plcp_cnt_cck = bad_plcp_cck;
605 else {
606 bad_plcp_cck -= data->last_bad_plcp_cnt_cck;
607 data->last_bad_plcp_cnt_cck += bad_plcp_cck;
610 if (data->last_bad_plcp_cnt_ofdm > bad_plcp_ofdm)
611 data->last_bad_plcp_cnt_ofdm = bad_plcp_ofdm;
612 else {
613 bad_plcp_ofdm -= data->last_bad_plcp_cnt_ofdm;
614 data->last_bad_plcp_cnt_ofdm += bad_plcp_ofdm;
617 if (data->last_fa_cnt_ofdm > fa_ofdm)
618 data->last_fa_cnt_ofdm = fa_ofdm;
619 else {
620 fa_ofdm -= data->last_fa_cnt_ofdm;
621 data->last_fa_cnt_ofdm += fa_ofdm;
624 if (data->last_fa_cnt_cck > fa_cck)
625 data->last_fa_cnt_cck = fa_cck;
626 else {
627 fa_cck -= data->last_fa_cnt_cck;
628 data->last_fa_cnt_cck += fa_cck;
631 /* Total aborted signal locks */
632 norm_fa_ofdm = fa_ofdm + bad_plcp_ofdm;
633 norm_fa_cck = fa_cck + bad_plcp_cck;
635 IWL_DEBUG_CALIB(priv, "cck: fa %u badp %u ofdm: fa %u badp %u\n", fa_cck,
636 bad_plcp_cck, fa_ofdm, bad_plcp_ofdm);
638 iwl_sens_auto_corr_ofdm(priv, norm_fa_ofdm, rx_enable_time);
639 iwl_sens_energy_cck(priv, norm_fa_cck, rx_enable_time, &statis);
640 iwl_sensitivity_write(priv);
642 EXPORT_SYMBOL(iwl_sensitivity_calibration);
644 static inline u8 find_first_chain(u8 mask)
646 if (mask & ANT_A)
647 return CHAIN_A;
648 if (mask & ANT_B)
649 return CHAIN_B;
650 return CHAIN_C;
654 * Accumulate 20 beacons of signal and noise statistics for each of
655 * 3 receivers/antennas/rx-chains, then figure out:
656 * 1) Which antennas are connected.
657 * 2) Differential rx gain settings to balance the 3 receivers.
659 void iwl_chain_noise_calibration(struct iwl_priv *priv,
660 struct iwl_notif_statistics *stat_resp)
662 struct iwl_chain_noise_data *data = NULL;
664 u32 chain_noise_a;
665 u32 chain_noise_b;
666 u32 chain_noise_c;
667 u32 chain_sig_a;
668 u32 chain_sig_b;
669 u32 chain_sig_c;
670 u32 average_sig[NUM_RX_CHAINS] = {INITIALIZATION_VALUE};
671 u32 average_noise[NUM_RX_CHAINS] = {INITIALIZATION_VALUE};
672 u32 max_average_sig;
673 u16 max_average_sig_antenna_i;
674 u32 min_average_noise = MIN_AVERAGE_NOISE_MAX_VALUE;
675 u16 min_average_noise_antenna_i = INITIALIZATION_VALUE;
676 u16 i = 0;
677 u16 rxon_chnum = INITIALIZATION_VALUE;
678 u16 stat_chnum = INITIALIZATION_VALUE;
679 u8 rxon_band24;
680 u8 stat_band24;
681 u32 active_chains = 0;
682 u8 num_tx_chains;
683 unsigned long flags;
684 struct statistics_rx_non_phy *rx_info = &(stat_resp->rx.general);
685 u8 first_chain;
687 if (priv->disable_chain_noise_cal)
688 return;
690 data = &(priv->chain_noise_data);
693 * Accumulate just the first "chain_noise_num_beacons" after
694 * the first association, then we're done forever.
696 if (data->state != IWL_CHAIN_NOISE_ACCUMULATE) {
697 if (data->state == IWL_CHAIN_NOISE_ALIVE)
698 IWL_DEBUG_CALIB(priv, "Wait for noise calib reset\n");
699 return;
702 spin_lock_irqsave(&priv->lock, flags);
703 if (rx_info->interference_data_flag != INTERFERENCE_DATA_AVAILABLE) {
704 IWL_DEBUG_CALIB(priv, " << Interference data unavailable\n");
705 spin_unlock_irqrestore(&priv->lock, flags);
706 return;
709 rxon_band24 = !!(priv->staging_rxon.flags & RXON_FLG_BAND_24G_MSK);
710 rxon_chnum = le16_to_cpu(priv->staging_rxon.channel);
711 stat_band24 = !!(stat_resp->flag & STATISTICS_REPLY_FLG_BAND_24G_MSK);
712 stat_chnum = le32_to_cpu(stat_resp->flag) >> 16;
714 /* Make sure we accumulate data for just the associated channel
715 * (even if scanning). */
716 if ((rxon_chnum != stat_chnum) || (rxon_band24 != stat_band24)) {
717 IWL_DEBUG_CALIB(priv, "Stats not from chan=%d, band24=%d\n",
718 rxon_chnum, rxon_band24);
719 spin_unlock_irqrestore(&priv->lock, flags);
720 return;
724 * Accumulate beacon statistics values across
725 * "chain_noise_num_beacons"
727 chain_noise_a = le32_to_cpu(rx_info->beacon_silence_rssi_a) &
728 IN_BAND_FILTER;
729 chain_noise_b = le32_to_cpu(rx_info->beacon_silence_rssi_b) &
730 IN_BAND_FILTER;
731 chain_noise_c = le32_to_cpu(rx_info->beacon_silence_rssi_c) &
732 IN_BAND_FILTER;
734 chain_sig_a = le32_to_cpu(rx_info->beacon_rssi_a) & IN_BAND_FILTER;
735 chain_sig_b = le32_to_cpu(rx_info->beacon_rssi_b) & IN_BAND_FILTER;
736 chain_sig_c = le32_to_cpu(rx_info->beacon_rssi_c) & IN_BAND_FILTER;
738 spin_unlock_irqrestore(&priv->lock, flags);
740 data->beacon_count++;
742 data->chain_noise_a = (chain_noise_a + data->chain_noise_a);
743 data->chain_noise_b = (chain_noise_b + data->chain_noise_b);
744 data->chain_noise_c = (chain_noise_c + data->chain_noise_c);
746 data->chain_signal_a = (chain_sig_a + data->chain_signal_a);
747 data->chain_signal_b = (chain_sig_b + data->chain_signal_b);
748 data->chain_signal_c = (chain_sig_c + data->chain_signal_c);
750 IWL_DEBUG_CALIB(priv, "chan=%d, band24=%d, beacon=%d\n",
751 rxon_chnum, rxon_band24, data->beacon_count);
752 IWL_DEBUG_CALIB(priv, "chain_sig: a %d b %d c %d\n",
753 chain_sig_a, chain_sig_b, chain_sig_c);
754 IWL_DEBUG_CALIB(priv, "chain_noise: a %d b %d c %d\n",
755 chain_noise_a, chain_noise_b, chain_noise_c);
757 /* If this is the "chain_noise_num_beacons", determine:
758 * 1) Disconnected antennas (using signal strengths)
759 * 2) Differential gain (using silence noise) to balance receivers */
760 if (data->beacon_count != priv->cfg->chain_noise_num_beacons)
761 return;
763 /* Analyze signal for disconnected antenna */
764 average_sig[0] =
765 (data->chain_signal_a) / priv->cfg->chain_noise_num_beacons;
766 average_sig[1] =
767 (data->chain_signal_b) / priv->cfg->chain_noise_num_beacons;
768 average_sig[2] =
769 (data->chain_signal_c) / priv->cfg->chain_noise_num_beacons;
771 if (average_sig[0] >= average_sig[1]) {
772 max_average_sig = average_sig[0];
773 max_average_sig_antenna_i = 0;
774 active_chains = (1 << max_average_sig_antenna_i);
775 } else {
776 max_average_sig = average_sig[1];
777 max_average_sig_antenna_i = 1;
778 active_chains = (1 << max_average_sig_antenna_i);
781 if (average_sig[2] >= max_average_sig) {
782 max_average_sig = average_sig[2];
783 max_average_sig_antenna_i = 2;
784 active_chains = (1 << max_average_sig_antenna_i);
787 IWL_DEBUG_CALIB(priv, "average_sig: a %d b %d c %d\n",
788 average_sig[0], average_sig[1], average_sig[2]);
789 IWL_DEBUG_CALIB(priv, "max_average_sig = %d, antenna %d\n",
790 max_average_sig, max_average_sig_antenna_i);
792 /* Compare signal strengths for all 3 receivers. */
793 for (i = 0; i < NUM_RX_CHAINS; i++) {
794 if (i != max_average_sig_antenna_i) {
795 s32 rssi_delta = (max_average_sig - average_sig[i]);
797 /* If signal is very weak, compared with
798 * strongest, mark it as disconnected. */
799 if (rssi_delta > MAXIMUM_ALLOWED_PATHLOSS)
800 data->disconn_array[i] = 1;
801 else
802 active_chains |= (1 << i);
803 IWL_DEBUG_CALIB(priv, "i = %d rssiDelta = %d "
804 "disconn_array[i] = %d\n",
805 i, rssi_delta, data->disconn_array[i]);
810 * The above algorithm sometimes fails when the ucode
811 * reports 0 for all chains. It's not clear why that
812 * happens to start with, but it is then causing trouble
813 * because this can make us enable more chains than the
814 * hardware really has.
816 * To be safe, simply mask out any chains that we know
817 * are not on the device.
819 active_chains &= priv->hw_params.valid_rx_ant;
821 num_tx_chains = 0;
822 for (i = 0; i < NUM_RX_CHAINS; i++) {
823 /* loops on all the bits of
824 * priv->hw_setting.valid_tx_ant */
825 u8 ant_msk = (1 << i);
826 if (!(priv->hw_params.valid_tx_ant & ant_msk))
827 continue;
829 num_tx_chains++;
830 if (data->disconn_array[i] == 0)
831 /* there is a Tx antenna connected */
832 break;
833 if (num_tx_chains == priv->hw_params.tx_chains_num &&
834 data->disconn_array[i]) {
836 * If all chains are disconnected
837 * connect the first valid tx chain
839 first_chain =
840 find_first_chain(priv->cfg->valid_tx_ant);
841 data->disconn_array[first_chain] = 0;
842 active_chains |= BIT(first_chain);
843 IWL_DEBUG_CALIB(priv, "All Tx chains are disconnected W/A - declare %d as connected\n",
844 first_chain);
845 break;
849 /* Save for use within RXON, TX, SCAN commands, etc. */
850 priv->chain_noise_data.active_chains = active_chains;
851 IWL_DEBUG_CALIB(priv, "active_chains (bitwise) = 0x%x\n",
852 active_chains);
854 /* Analyze noise for rx balance */
855 average_noise[0] =
856 ((data->chain_noise_a) / priv->cfg->chain_noise_num_beacons);
857 average_noise[1] =
858 ((data->chain_noise_b) / priv->cfg->chain_noise_num_beacons);
859 average_noise[2] =
860 ((data->chain_noise_c) / priv->cfg->chain_noise_num_beacons);
862 for (i = 0; i < NUM_RX_CHAINS; i++) {
863 if (!(data->disconn_array[i]) &&
864 (average_noise[i] <= min_average_noise)) {
865 /* This means that chain i is active and has
866 * lower noise values so far: */
867 min_average_noise = average_noise[i];
868 min_average_noise_antenna_i = i;
872 IWL_DEBUG_CALIB(priv, "average_noise: a %d b %d c %d\n",
873 average_noise[0], average_noise[1],
874 average_noise[2]);
876 IWL_DEBUG_CALIB(priv, "min_average_noise = %d, antenna %d\n",
877 min_average_noise, min_average_noise_antenna_i);
879 if (priv->cfg->ops->utils->gain_computation)
880 priv->cfg->ops->utils->gain_computation(priv, average_noise,
881 min_average_noise_antenna_i, min_average_noise,
882 find_first_chain(priv->cfg->valid_rx_ant));
884 /* Some power changes may have been made during the calibration.
885 * Update and commit the RXON
887 if (priv->cfg->ops->lib->update_chain_flags)
888 priv->cfg->ops->lib->update_chain_flags(priv);
890 data->state = IWL_CHAIN_NOISE_DONE;
891 iwl_power_update_mode(priv, false);
893 EXPORT_SYMBOL(iwl_chain_noise_calibration);
896 void iwl_reset_run_time_calib(struct iwl_priv *priv)
898 int i;
899 memset(&(priv->sensitivity_data), 0,
900 sizeof(struct iwl_sensitivity_data));
901 memset(&(priv->chain_noise_data), 0,
902 sizeof(struct iwl_chain_noise_data));
903 for (i = 0; i < NUM_RX_CHAINS; i++)
904 priv->chain_noise_data.delta_gain_code[i] =
905 CHAIN_NOISE_DELTA_GAIN_INIT_VAL;
907 /* Ask for statistics now, the uCode will send notification
908 * periodically after association */
909 iwl_send_statistics_request(priv, CMD_ASYNC, true);
911 EXPORT_SYMBOL(iwl_reset_run_time_calib);