Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 1 | /****************************************************************************** |
| 2 | * |
| 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. |
| 5 | * |
| 6 | * GPL LICENSE SUMMARY |
| 7 | * |
Emmanuel Grumbach | 51368bf | 2013-12-30 13:15:54 +0200 | [diff] [blame] | 8 | * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 9 | * |
| 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. |
| 13 | * |
| 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. |
| 18 | * |
| 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 |
| 23 | * |
| 24 | * The full GNU General Public License is included in this distribution |
Emmanuel Grumbach | 410dc5a | 2013-02-18 09:22:28 +0200 | [diff] [blame] | 25 | * in the file called COPYING. |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 26 | * |
| 27 | * Contact Information: |
| 28 | * Intel Linux Wireless <ilw@linux.intel.com> |
| 29 | * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 |
| 30 | * |
| 31 | * BSD LICENSE |
| 32 | * |
Emmanuel Grumbach | 51368bf | 2013-12-30 13:15:54 +0200 | [diff] [blame] | 33 | * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 34 | * All rights reserved. |
| 35 | * |
| 36 | * Redistribution and use in source and binary forms, with or without |
| 37 | * modification, are permitted provided that the following conditions |
| 38 | * are met: |
| 39 | * |
| 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. |
| 49 | * |
| 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 | * |
| 62 | *****************************************************************************/ |
| 63 | |
| 64 | #ifndef __fw_api_scan_h__ |
| 65 | #define __fw_api_scan_h__ |
| 66 | |
| 67 | #include "fw-api.h" |
| 68 | |
| 69 | /* Scan Commands, Responses, Notifications */ |
| 70 | |
| 71 | /* Masks for iwl_scan_channel.type flags */ |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 72 | #define SCAN_CHANNEL_TYPE_ACTIVE BIT(0) |
| 73 | #define SCAN_CHANNEL_NARROW_BAND BIT(22) |
| 74 | |
| 75 | /* Max number of IEs for direct SSID scans in a command */ |
| 76 | #define PROBE_OPTION_MAX 20 |
| 77 | |
| 78 | /** |
| 79 | * struct iwl_scan_channel - entry in REPLY_SCAN_CMD channel table |
| 80 | * @channel: band is selected by iwl_scan_cmd "flags" field |
| 81 | * @tx_gain: gain for analog radio |
| 82 | * @dsp_atten: gain for DSP |
| 83 | * @active_dwell: dwell time for active scan in TU, typically 5-50 |
| 84 | * @passive_dwell: dwell time for passive scan in TU, typically 20-500 |
| 85 | * @type: type is broken down to these bits: |
| 86 | * bit 0: 0 = passive, 1 = active |
| 87 | * bits 1-20: SSID direct bit map. If any of these bits is set then |
| 88 | * the corresponding SSID IE is transmitted in probe request |
| 89 | * (bit i adds IE in position i to the probe request) |
| 90 | * bit 22: channel width, 0 = regular, 1 = TGj narrow channel |
| 91 | * |
| 92 | * @iteration_count: |
| 93 | * @iteration_interval: |
| 94 | * This struct is used once for each channel in the scan list. |
| 95 | * Each channel can independently select: |
| 96 | * 1) SSID for directed active scans |
| 97 | * 2) Txpower setting (for rate specified within Tx command) |
| 98 | * 3) How long to stay on-channel (behavior may be modified by quiet_time, |
| 99 | * quiet_plcp_th, good_CRC_th) |
| 100 | * |
| 101 | * To avoid uCode errors, make sure the following are true (see comments |
| 102 | * under struct iwl_scan_cmd about max_out_time and quiet_time): |
| 103 | * 1) If using passive_dwell (i.e. passive_dwell != 0): |
| 104 | * active_dwell <= passive_dwell (< max_out_time if max_out_time != 0) |
| 105 | * 2) quiet_time <= active_dwell |
| 106 | * 3) If restricting off-channel time (i.e. max_out_time !=0): |
| 107 | * passive_dwell < max_out_time |
| 108 | * active_dwell < max_out_time |
| 109 | */ |
| 110 | struct iwl_scan_channel { |
| 111 | __le32 type; |
| 112 | __le16 channel; |
| 113 | __le16 iteration_count; |
| 114 | __le32 iteration_interval; |
| 115 | __le16 active_dwell; |
| 116 | __le16 passive_dwell; |
| 117 | } __packed; /* SCAN_CHANNEL_CONTROL_API_S_VER_1 */ |
| 118 | |
| 119 | /** |
| 120 | * struct iwl_ssid_ie - directed scan network information element |
| 121 | * |
| 122 | * Up to 20 of these may appear in REPLY_SCAN_CMD, |
| 123 | * selected by "type" bit field in struct iwl_scan_channel; |
| 124 | * each channel may select different ssids from among the 20 entries. |
| 125 | * SSID IEs get transmitted in reverse order of entry. |
| 126 | */ |
| 127 | struct iwl_ssid_ie { |
| 128 | u8 id; |
| 129 | u8 len; |
| 130 | u8 ssid[IEEE80211_MAX_SSID_LEN]; |
| 131 | } __packed; /* SCAN_DIRECT_SSID_IE_API_S_VER_1 */ |
| 132 | |
| 133 | /** |
| 134 | * iwl_scan_flags - masks for scan command flags |
| 135 | *@SCAN_FLAGS_PERIODIC_SCAN: |
| 136 | *@SCAN_FLAGS_P2P_PUBLIC_ACTION_FRAME_TX: |
| 137 | *@SCAN_FLAGS_DELAYED_SCAN_LOWBAND: |
| 138 | *@SCAN_FLAGS_DELAYED_SCAN_HIGHBAND: |
| 139 | *@SCAN_FLAGS_FRAGMENTED_SCAN: |
David Spinadel | 26e05cc | 2013-07-08 13:12:29 +0300 | [diff] [blame] | 140 | *@SCAN_FLAGS_PASSIVE2ACTIVE: use active scan on channels that was active |
| 141 | * in the past hour, even if they are marked as passive. |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 142 | */ |
| 143 | enum iwl_scan_flags { |
| 144 | SCAN_FLAGS_PERIODIC_SCAN = BIT(0), |
| 145 | SCAN_FLAGS_P2P_PUBLIC_ACTION_FRAME_TX = BIT(1), |
| 146 | SCAN_FLAGS_DELAYED_SCAN_LOWBAND = BIT(2), |
| 147 | SCAN_FLAGS_DELAYED_SCAN_HIGHBAND = BIT(3), |
| 148 | SCAN_FLAGS_FRAGMENTED_SCAN = BIT(4), |
David Spinadel | 26e05cc | 2013-07-08 13:12:29 +0300 | [diff] [blame] | 149 | SCAN_FLAGS_PASSIVE2ACTIVE = BIT(5), |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 150 | }; |
| 151 | |
| 152 | /** |
| 153 | * enum iwl_scan_type - Scan types for scan command |
| 154 | * @SCAN_TYPE_FORCED: |
| 155 | * @SCAN_TYPE_BACKGROUND: |
| 156 | * @SCAN_TYPE_OS: |
| 157 | * @SCAN_TYPE_ROAMING: |
| 158 | * @SCAN_TYPE_ACTION: |
| 159 | * @SCAN_TYPE_DISCOVERY: |
| 160 | * @SCAN_TYPE_DISCOVERY_FORCED: |
| 161 | */ |
| 162 | enum iwl_scan_type { |
| 163 | SCAN_TYPE_FORCED = 0, |
| 164 | SCAN_TYPE_BACKGROUND = 1, |
| 165 | SCAN_TYPE_OS = 2, |
| 166 | SCAN_TYPE_ROAMING = 3, |
| 167 | SCAN_TYPE_ACTION = 4, |
| 168 | SCAN_TYPE_DISCOVERY = 5, |
| 169 | SCAN_TYPE_DISCOVERY_FORCED = 6, |
| 170 | }; /* SCAN_ACTIVITY_TYPE_E_VER_1 */ |
| 171 | |
| 172 | /* Maximal number of channels to scan */ |
| 173 | #define MAX_NUM_SCAN_CHANNELS 0x24 |
| 174 | |
| 175 | /** |
| 176 | * struct iwl_scan_cmd - scan request command |
| 177 | * ( SCAN_REQUEST_CMD = 0x80 ) |
| 178 | * @len: command length in bytes |
| 179 | * @scan_flags: scan flags from SCAN_FLAGS_* |
| 180 | * @channel_count: num of channels in channel list (1 - MAX_NUM_SCAN_CHANNELS) |
| 181 | * @quiet_time: in msecs, dwell this time for active scan on quiet channels |
| 182 | * @quiet_plcp_th: quiet PLCP threshold (channel is quiet if less than |
| 183 | * this number of packets were received (typically 1) |
David Spinadel | 26e05cc | 2013-07-08 13:12:29 +0300 | [diff] [blame] | 184 | * @passive2active: is auto switching from passive to active during scan allowed |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 185 | * @rxchain_sel_flags: RXON_RX_CHAIN_* |
| 186 | * @max_out_time: in usecs, max out of serving channel time |
| 187 | * @suspend_time: how long to pause scan when returning to service channel: |
| 188 | * bits 0-19: beacon interal in usecs (suspend before executing) |
| 189 | * bits 20-23: reserved |
| 190 | * bits 24-31: number of beacons (suspend between channels) |
| 191 | * @rxon_flags: RXON_FLG_* |
| 192 | * @filter_flags: RXON_FILTER_* |
| 193 | * @tx_cmd: for active scans (zero for passive), w/o payload, |
| 194 | * no RS so specify TX rate |
| 195 | * @direct_scan: direct scan SSIDs |
| 196 | * @type: one of SCAN_TYPE_* |
| 197 | * @repeats: how many time to repeat the scan |
| 198 | */ |
| 199 | struct iwl_scan_cmd { |
| 200 | __le16 len; |
| 201 | u8 scan_flags; |
| 202 | u8 channel_count; |
| 203 | __le16 quiet_time; |
| 204 | __le16 quiet_plcp_th; |
| 205 | __le16 passive2active; |
| 206 | __le16 rxchain_sel_flags; |
| 207 | __le32 max_out_time; |
| 208 | __le32 suspend_time; |
| 209 | /* RX_ON_FLAGS_API_S_VER_1 */ |
| 210 | __le32 rxon_flags; |
| 211 | __le32 filter_flags; |
| 212 | struct iwl_tx_cmd tx_cmd; |
| 213 | struct iwl_ssid_ie direct_scan[PROBE_OPTION_MAX]; |
| 214 | __le32 type; |
| 215 | __le32 repeats; |
| 216 | |
| 217 | /* |
| 218 | * Probe request frame, followed by channel list. |
| 219 | * |
| 220 | * Size of probe request frame is specified by byte count in tx_cmd. |
| 221 | * Channel list follows immediately after probe request frame. |
| 222 | * Number of channels in list is specified by channel_count. |
| 223 | * Each channel in list is of type: |
| 224 | * |
| 225 | * struct iwl_scan_channel channels[0]; |
| 226 | * |
| 227 | * NOTE: Only one band of channels can be scanned per pass. You |
| 228 | * must not mix 2.4GHz channels and 5.2GHz channels, and you must wait |
| 229 | * for one scan to complete (i.e. receive SCAN_COMPLETE_NOTIFICATION) |
| 230 | * before requesting another scan. |
| 231 | */ |
| 232 | u8 data[0]; |
| 233 | } __packed; /* SCAN_REQUEST_FIXED_PART_API_S_VER_5 */ |
| 234 | |
| 235 | /* Response to scan request contains only status with one of these values */ |
| 236 | #define SCAN_RESPONSE_OK 0x1 |
| 237 | #define SCAN_RESPONSE_ERROR 0x2 |
| 238 | |
| 239 | /* |
| 240 | * SCAN_ABORT_CMD = 0x81 |
| 241 | * When scan abort is requested, the command has no fields except the common |
| 242 | * header. The response contains only a status with one of these values. |
| 243 | */ |
| 244 | #define SCAN_ABORT_POSSIBLE 0x1 |
| 245 | #define SCAN_ABORT_IGNORED 0x2 /* no pending scans */ |
| 246 | |
| 247 | /* TODO: complete documentation */ |
| 248 | #define SCAN_OWNER_STATUS 0x1 |
| 249 | #define MEASURE_OWNER_STATUS 0x2 |
| 250 | |
| 251 | /** |
| 252 | * struct iwl_scan_start_notif - notifies start of scan in the device |
| 253 | * ( SCAN_START_NOTIFICATION = 0x82 ) |
| 254 | * @tsf_low: TSF timer (lower half) in usecs |
| 255 | * @tsf_high: TSF timer (higher half) in usecs |
| 256 | * @beacon_timer: structured as follows: |
| 257 | * bits 0:19 - beacon interval in usecs |
| 258 | * bits 20:23 - reserved (0) |
| 259 | * bits 24:31 - number of beacons |
| 260 | * @channel: which channel is scanned |
| 261 | * @band: 0 for 5.2 GHz, 1 for 2.4 GHz |
| 262 | * @status: one of *_OWNER_STATUS |
| 263 | */ |
| 264 | struct iwl_scan_start_notif { |
| 265 | __le32 tsf_low; |
| 266 | __le32 tsf_high; |
| 267 | __le32 beacon_timer; |
| 268 | u8 channel; |
| 269 | u8 band; |
| 270 | u8 reserved[2]; |
| 271 | __le32 status; |
| 272 | } __packed; /* SCAN_START_NTF_API_S_VER_1 */ |
| 273 | |
| 274 | /* scan results probe_status first bit indicates success */ |
| 275 | #define SCAN_PROBE_STATUS_OK 0 |
| 276 | #define SCAN_PROBE_STATUS_TX_FAILED BIT(0) |
| 277 | /* error statuses combined with TX_FAILED */ |
| 278 | #define SCAN_PROBE_STATUS_FAIL_TTL BIT(1) |
| 279 | #define SCAN_PROBE_STATUS_FAIL_BT BIT(2) |
| 280 | |
| 281 | /* How many statistics are gathered for each channel */ |
| 282 | #define SCAN_RESULTS_STATISTICS 1 |
| 283 | |
| 284 | /** |
| 285 | * enum iwl_scan_complete_status - status codes for scan complete notifications |
| 286 | * @SCAN_COMP_STATUS_OK: scan completed successfully |
| 287 | * @SCAN_COMP_STATUS_ABORT: scan was aborted by user |
| 288 | * @SCAN_COMP_STATUS_ERR_SLEEP: sending null sleep packet failed |
| 289 | * @SCAN_COMP_STATUS_ERR_CHAN_TIMEOUT: timeout before channel is ready |
| 290 | * @SCAN_COMP_STATUS_ERR_PROBE: sending probe request failed |
| 291 | * @SCAN_COMP_STATUS_ERR_WAKEUP: sending null wakeup packet failed |
| 292 | * @SCAN_COMP_STATUS_ERR_ANTENNAS: invalid antennas chosen at scan command |
| 293 | * @SCAN_COMP_STATUS_ERR_INTERNAL: internal error caused scan abort |
| 294 | * @SCAN_COMP_STATUS_ERR_COEX: medium was lost ot WiMax |
| 295 | * @SCAN_COMP_STATUS_P2P_ACTION_OK: P2P public action frame TX was successful |
| 296 | * (not an error!) |
| 297 | * @SCAN_COMP_STATUS_ITERATION_END: indicates end of one repeatition the driver |
| 298 | * asked for |
| 299 | * @SCAN_COMP_STATUS_ERR_ALLOC_TE: scan could not allocate time events |
| 300 | */ |
| 301 | enum iwl_scan_complete_status { |
| 302 | SCAN_COMP_STATUS_OK = 0x1, |
| 303 | SCAN_COMP_STATUS_ABORT = 0x2, |
| 304 | SCAN_COMP_STATUS_ERR_SLEEP = 0x3, |
| 305 | SCAN_COMP_STATUS_ERR_CHAN_TIMEOUT = 0x4, |
| 306 | SCAN_COMP_STATUS_ERR_PROBE = 0x5, |
| 307 | SCAN_COMP_STATUS_ERR_WAKEUP = 0x6, |
| 308 | SCAN_COMP_STATUS_ERR_ANTENNAS = 0x7, |
| 309 | SCAN_COMP_STATUS_ERR_INTERNAL = 0x8, |
| 310 | SCAN_COMP_STATUS_ERR_COEX = 0x9, |
| 311 | SCAN_COMP_STATUS_P2P_ACTION_OK = 0xA, |
| 312 | SCAN_COMP_STATUS_ITERATION_END = 0x0B, |
| 313 | SCAN_COMP_STATUS_ERR_ALLOC_TE = 0x0C, |
| 314 | }; |
| 315 | |
| 316 | /** |
| 317 | * struct iwl_scan_results_notif - scan results for one channel |
| 318 | * ( SCAN_RESULTS_NOTIFICATION = 0x83 ) |
| 319 | * @channel: which channel the results are from |
| 320 | * @band: 0 for 5.2 GHz, 1 for 2.4 GHz |
| 321 | * @probe_status: SCAN_PROBE_STATUS_*, indicates success of probe request |
| 322 | * @num_probe_not_sent: # of request that weren't sent due to not enough time |
| 323 | * @duration: duration spent in channel, in usecs |
| 324 | * @statistics: statistics gathered for this channel |
| 325 | */ |
| 326 | struct iwl_scan_results_notif { |
| 327 | u8 channel; |
| 328 | u8 band; |
| 329 | u8 probe_status; |
| 330 | u8 num_probe_not_sent; |
| 331 | __le32 duration; |
| 332 | __le32 statistics[SCAN_RESULTS_STATISTICS]; |
| 333 | } __packed; /* SCAN_RESULT_NTF_API_S_VER_2 */ |
| 334 | |
| 335 | /** |
| 336 | * struct iwl_scan_complete_notif - notifies end of scanning (all channels) |
| 337 | * ( SCAN_COMPLETE_NOTIFICATION = 0x84 ) |
| 338 | * @scanned_channels: number of channels scanned (and number of valid results) |
| 339 | * @status: one of SCAN_COMP_STATUS_* |
| 340 | * @bt_status: BT on/off status |
| 341 | * @last_channel: last channel that was scanned |
| 342 | * @tsf_low: TSF timer (lower half) in usecs |
| 343 | * @tsf_high: TSF timer (higher half) in usecs |
| 344 | * @results: all scan results, only "scanned_channels" of them are valid |
| 345 | */ |
| 346 | struct iwl_scan_complete_notif { |
| 347 | u8 scanned_channels; |
| 348 | u8 status; |
| 349 | u8 bt_status; |
| 350 | u8 last_channel; |
| 351 | __le32 tsf_low; |
| 352 | __le32 tsf_high; |
| 353 | struct iwl_scan_results_notif results[MAX_NUM_SCAN_CHANNELS]; |
| 354 | } __packed; /* SCAN_COMPLETE_NTF_API_S_VER_2 */ |
| 355 | |
| 356 | /* scan offload */ |
| 357 | #define IWL_MAX_SCAN_CHANNELS 40 |
| 358 | #define IWL_SCAN_MAX_BLACKLIST_LEN 64 |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 359 | #define IWL_SCAN_SHORT_BLACKLIST_LEN 16 |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 360 | #define IWL_SCAN_MAX_PROFILES 11 |
| 361 | #define SCAN_OFFLOAD_PROBE_REQ_SIZE 512 |
| 362 | |
| 363 | /* Default watchdog (in MS) for scheduled scan iteration */ |
| 364 | #define IWL_SCHED_SCAN_WATCHDOG cpu_to_le16(15000) |
| 365 | |
| 366 | #define IWL_GOOD_CRC_TH_DEFAULT cpu_to_le16(1) |
| 367 | #define CAN_ABORT_STATUS 1 |
| 368 | |
| 369 | #define IWL_FULL_SCAN_MULTIPLIER 5 |
| 370 | #define IWL_FAST_SCHED_SCAN_ITERATIONS 3 |
| 371 | |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 372 | enum scan_framework_client { |
| 373 | SCAN_CLIENT_SCHED_SCAN = BIT(0), |
| 374 | SCAN_CLIENT_NETDETECT = BIT(1), |
| 375 | SCAN_CLIENT_ASSET_TRACKING = BIT(2), |
| 376 | }; |
| 377 | |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 378 | /** |
| 379 | * struct iwl_scan_offload_cmd - SCAN_REQUEST_FIXED_PART_API_S_VER_6 |
| 380 | * @scan_flags: see enum iwl_scan_flags |
| 381 | * @channel_count: channels in channel list |
| 382 | * @quiet_time: dwell time, in milisiconds, on quiet channel |
| 383 | * @quiet_plcp_th: quiet channel num of packets threshold |
| 384 | * @good_CRC_th: passive to active promotion threshold |
| 385 | * @rx_chain: RXON rx chain. |
| 386 | * @max_out_time: max uSec to be out of assoceated channel |
| 387 | * @suspend_time: pause scan this long when returning to service channel |
| 388 | * @flags: RXON flags |
| 389 | * @filter_flags: RXONfilter |
| 390 | * @tx_cmd: tx command for active scan; for 2GHz and for 5GHz. |
| 391 | * @direct_scan: list of SSIDs for directed active scan |
| 392 | * @scan_type: see enum iwl_scan_type. |
| 393 | * @rep_count: repetition count for each scheduled scan iteration. |
| 394 | */ |
| 395 | struct iwl_scan_offload_cmd { |
| 396 | __le16 len; |
| 397 | u8 scan_flags; |
| 398 | u8 channel_count; |
| 399 | __le16 quiet_time; |
| 400 | __le16 quiet_plcp_th; |
| 401 | __le16 good_CRC_th; |
| 402 | __le16 rx_chain; |
| 403 | __le32 max_out_time; |
| 404 | __le32 suspend_time; |
| 405 | /* RX_ON_FLAGS_API_S_VER_1 */ |
| 406 | __le32 flags; |
| 407 | __le32 filter_flags; |
| 408 | struct iwl_tx_cmd tx_cmd[2]; |
| 409 | /* SCAN_DIRECT_SSID_IE_API_S_VER_1 */ |
| 410 | struct iwl_ssid_ie direct_scan[PROBE_OPTION_MAX]; |
| 411 | __le32 scan_type; |
| 412 | __le32 rep_count; |
| 413 | } __packed; |
| 414 | |
| 415 | enum iwl_scan_offload_channel_flags { |
| 416 | IWL_SCAN_OFFLOAD_CHANNEL_ACTIVE = BIT(0), |
| 417 | IWL_SCAN_OFFLOAD_CHANNEL_NARROW = BIT(22), |
| 418 | IWL_SCAN_OFFLOAD_CHANNEL_FULL = BIT(24), |
| 419 | IWL_SCAN_OFFLOAD_CHANNEL_PARTIAL = BIT(25), |
| 420 | }; |
| 421 | |
| 422 | /** |
| 423 | * iwl_scan_channel_cfg - SCAN_CHANNEL_CFG_S |
| 424 | * @type: bitmap - see enum iwl_scan_offload_channel_flags. |
| 425 | * 0: passive (0) or active (1) scan. |
| 426 | * 1-20: directed scan to i'th ssid. |
| 427 | * 22: channel width configuation - 1 for narrow. |
| 428 | * 24: full scan. |
| 429 | * 25: partial scan. |
| 430 | * @channel_number: channel number 1-13 etc. |
| 431 | * @iter_count: repetition count for the channel. |
| 432 | * @iter_interval: interval between two innteration on one channel. |
| 433 | * @dwell_time: entry 0 - active scan, entry 1 - passive scan. |
| 434 | */ |
| 435 | struct iwl_scan_channel_cfg { |
| 436 | __le32 type[IWL_MAX_SCAN_CHANNELS]; |
| 437 | __le16 channel_number[IWL_MAX_SCAN_CHANNELS]; |
| 438 | __le16 iter_count[IWL_MAX_SCAN_CHANNELS]; |
| 439 | __le32 iter_interval[IWL_MAX_SCAN_CHANNELS]; |
| 440 | u8 dwell_time[IWL_MAX_SCAN_CHANNELS][2]; |
| 441 | } __packed; |
| 442 | |
| 443 | /** |
| 444 | * iwl_scan_offload_cfg - SCAN_OFFLOAD_CONFIG_API_S |
| 445 | * @scan_cmd: scan command fixed part |
| 446 | * @channel_cfg: scan channel configuration |
| 447 | * @data: probe request frames (one per band) |
| 448 | */ |
| 449 | struct iwl_scan_offload_cfg { |
| 450 | struct iwl_scan_offload_cmd scan_cmd; |
| 451 | struct iwl_scan_channel_cfg channel_cfg; |
| 452 | u8 data[0]; |
| 453 | } __packed; |
| 454 | |
| 455 | /** |
| 456 | * iwl_scan_offload_blacklist - SCAN_OFFLOAD_BLACKLIST_S |
| 457 | * @ssid: MAC address to filter out |
| 458 | * @reported_rssi: AP rssi reported to the host |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 459 | * @client_bitmap: clients ignore this entry - enum scan_framework_client |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 460 | */ |
| 461 | struct iwl_scan_offload_blacklist { |
| 462 | u8 ssid[ETH_ALEN]; |
| 463 | u8 reported_rssi; |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 464 | u8 client_bitmap; |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 465 | } __packed; |
| 466 | |
| 467 | enum iwl_scan_offload_network_type { |
| 468 | IWL_NETWORK_TYPE_BSS = 1, |
| 469 | IWL_NETWORK_TYPE_IBSS = 2, |
| 470 | IWL_NETWORK_TYPE_ANY = 3, |
| 471 | }; |
| 472 | |
| 473 | enum iwl_scan_offload_band_selection { |
| 474 | IWL_SCAN_OFFLOAD_SELECT_2_4 = 0x4, |
| 475 | IWL_SCAN_OFFLOAD_SELECT_5_2 = 0x8, |
| 476 | IWL_SCAN_OFFLOAD_SELECT_ANY = 0xc, |
| 477 | }; |
| 478 | |
| 479 | /** |
| 480 | * iwl_scan_offload_profile - SCAN_OFFLOAD_PROFILE_S |
| 481 | * @ssid_index: index to ssid list in fixed part |
| 482 | * @unicast_cipher: encryption olgorithm to match - bitmap |
| 483 | * @aut_alg: authentication olgorithm to match - bitmap |
| 484 | * @network_type: enum iwl_scan_offload_network_type |
| 485 | * @band_selection: enum iwl_scan_offload_band_selection |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 486 | * @client_bitmap: clients waiting for match - enum scan_framework_client |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 487 | */ |
| 488 | struct iwl_scan_offload_profile { |
| 489 | u8 ssid_index; |
| 490 | u8 unicast_cipher; |
| 491 | u8 auth_alg; |
| 492 | u8 network_type; |
| 493 | u8 band_selection; |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 494 | u8 client_bitmap; |
| 495 | u8 reserved[2]; |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 496 | } __packed; |
| 497 | |
| 498 | /** |
| 499 | * iwl_scan_offload_profile_cfg - SCAN_OFFLOAD_PROFILES_CFG_API_S_VER_1 |
| 500 | * @blaclist: AP list to filter off from scan results |
| 501 | * @profiles: profiles to search for match |
| 502 | * @blacklist_len: length of blacklist |
| 503 | * @num_profiles: num of profiles in the list |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 504 | * @match_notify: clients waiting for match found notification |
| 505 | * @pass_match: clients waiting for the results |
| 506 | * @active_clients: active clients bitmap - enum scan_framework_client |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 507 | */ |
| 508 | struct iwl_scan_offload_profile_cfg { |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 509 | struct iwl_scan_offload_profile profiles[IWL_SCAN_MAX_PROFILES]; |
| 510 | u8 blacklist_len; |
| 511 | u8 num_profiles; |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 512 | u8 match_notify; |
| 513 | u8 pass_match; |
| 514 | u8 active_clients; |
| 515 | u8 reserved[3]; |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 516 | } __packed; |
| 517 | |
| 518 | /** |
| 519 | * iwl_scan_offload_schedule - schedule of scan offload |
| 520 | * @delay: delay between iterations, in seconds. |
| 521 | * @iterations: num of scan iterations |
| 522 | * @full_scan_mul: number of partial scans before each full scan |
| 523 | */ |
| 524 | struct iwl_scan_offload_schedule { |
| 525 | u16 delay; |
| 526 | u8 iterations; |
| 527 | u8 full_scan_mul; |
| 528 | } __packed; |
| 529 | |
| 530 | /* |
| 531 | * iwl_scan_offload_flags |
| 532 | * |
Eliad Peller | de33fb5 | 2013-11-10 12:59:46 +0200 | [diff] [blame] | 533 | * IWL_SCAN_OFFLOAD_FLAG_PASS_ALL: pass all results - no filtering. |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 534 | * IWL_SCAN_OFFLOAD_FLAG_CACHED_CHANNEL: add cached channels to partial scan. |
| 535 | * IWL_SCAN_OFFLOAD_FLAG_ENERGY_SCAN: use energy based scan before partial scan |
| 536 | * on A band. |
| 537 | */ |
| 538 | enum iwl_scan_offload_flags { |
Eliad Peller | de33fb5 | 2013-11-10 12:59:46 +0200 | [diff] [blame] | 539 | IWL_SCAN_OFFLOAD_FLAG_PASS_ALL = BIT(0), |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 540 | IWL_SCAN_OFFLOAD_FLAG_CACHED_CHANNEL = BIT(2), |
| 541 | IWL_SCAN_OFFLOAD_FLAG_ENERGY_SCAN = BIT(3), |
| 542 | }; |
| 543 | |
| 544 | /** |
| 545 | * iwl_scan_offload_req - scan offload request command |
| 546 | * @flags: bitmap - enum iwl_scan_offload_flags. |
| 547 | * @watchdog: maximum scan duration in TU. |
| 548 | * @delay: delay in seconds before first iteration. |
| 549 | * @schedule_line: scan offload schedule, for fast and regular scan. |
| 550 | */ |
| 551 | struct iwl_scan_offload_req { |
| 552 | __le16 flags; |
| 553 | __le16 watchdog; |
| 554 | __le16 delay; |
| 555 | __le16 reserved; |
| 556 | struct iwl_scan_offload_schedule schedule_line[2]; |
| 557 | } __packed; |
| 558 | |
| 559 | enum iwl_scan_offload_compleate_status { |
| 560 | IWL_SCAN_OFFLOAD_COMPLETED = 1, |
| 561 | IWL_SCAN_OFFLOAD_ABORTED = 2, |
| 562 | }; |
| 563 | |
| 564 | /** |
| 565 | * iwl_scan_offload_complete - SCAN_OFFLOAD_COMPLETE_NTF_API_S_VER_1 |
| 566 | * @last_schedule_line: last schedule line executed (fast or regular) |
| 567 | * @last_schedule_iteration: last scan iteration executed before scan abort |
| 568 | * @status: enum iwl_scan_offload_compleate_status |
| 569 | */ |
| 570 | struct iwl_scan_offload_complete { |
| 571 | u8 last_schedule_line; |
| 572 | u8 last_schedule_iteration; |
| 573 | u8 status; |
| 574 | u8 reserved; |
| 575 | } __packed; |
| 576 | |
David Spinadel | 35a000b | 2013-08-28 09:29:43 +0300 | [diff] [blame] | 577 | /** |
| 578 | * iwl_sched_scan_results - SCAN_OFFLOAD_MATCH_FOUND_NTF_API_S_VER_1 |
| 579 | * @ssid_bitmap: SSIDs indexes found in this iteration |
| 580 | * @client_bitmap: clients that are active and wait for this notification |
| 581 | */ |
| 582 | struct iwl_sched_scan_results { |
| 583 | __le16 ssid_bitmap; |
| 584 | u8 client_bitmap; |
| 585 | u8 reserved; |
| 586 | }; |
| 587 | |
Johannes Berg | 8ca151b | 2013-01-24 14:25:36 +0100 | [diff] [blame] | 588 | #endif |