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 *
8 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
9 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
10 * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
11 * Copyright (C) 2018 Intel Corporation
12 *
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of version 2 of the GNU General Public License as
15 * published by the Free Software Foundation.
16 *
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
21 *
22 * The full GNU General Public License is included in this distribution
23 * in the file called COPYING.
24 *
25 * Contact Information:
26 * Intel Linux Wireless <linuxwifi@intel.com>
27 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
28 *
29 * BSD LICENSE
30 *
31 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
32 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
33 * Copyright (C) 2018 Intel Corporation
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 __iwl_fw_api_stats_h__
65 #define __iwl_fw_api_stats_h__
66 #include "mac.h"
67
68 struct mvm_statistics_dbg {
69 __le32 burst_check;
70 __le32 burst_count;
71 __le32 wait_for_silence_timeout_cnt;
72 u8 reserved[12];
73 } __packed; /* STATISTICS_DEBUG_API_S_VER_2 */
74
75 struct mvm_statistics_div {
76 __le32 tx_on_a;
77 __le32 tx_on_b;
78 __le32 exec_time;
79 __le32 probe_time;
80 __le32 rssi_ant;
81 __le32 reserved2;
82 } __packed; /* STATISTICS_SLOW_DIV_API_S_VER_2 */
83
84 /**
85 * struct mvm_statistics_rx_non_phy
86 * @bogus_cts: CTS received when not expecting CTS
87 * @bogus_ack: ACK received when not expecting ACK
88 * @non_channel_beacons: beacons with our bss id but not on our serving channel
89 * @channel_beacons: beacons with our bss id and in our serving channel
90 * @num_missed_bcon: number of missed beacons
91 * @adc_rx_saturation_time: count in 0.8us units the time the ADC was in
92 * saturation
93 * @ina_detection_search_time: total time (in 0.8us) searched for INA
94 * @beacon_silence_rssi_a: RSSI silence after beacon frame
95 * @beacon_silence_rssi_b: RSSI silence after beacon frame
96 * @beacon_silence_rssi_c: RSSI silence after beacon frame
97 * @interference_data_flag: flag for interference data availability. 1 when data
98 * is available.
99 * @channel_load: counts RX Enable time in uSec
100 * @beacon_rssi_a: beacon RSSI on anntena A
101 * @beacon_rssi_b: beacon RSSI on antenna B
102 * @beacon_rssi_c: beacon RSSI on antenna C
103 * @beacon_energy_a: beacon energy on antenna A
104 * @beacon_energy_b: beacon energy on antenna B
105 * @beacon_energy_c: beacon energy on antenna C
106 * @num_bt_kills: number of BT "kills" (frame TX aborts)
107 * @mac_id: mac ID
108 */
109 struct mvm_statistics_rx_non_phy {
110 __le32 bogus_cts;
111 __le32 bogus_ack;
112 __le32 non_channel_beacons;
113 __le32 channel_beacons;
114 __le32 num_missed_bcon;
115 __le32 adc_rx_saturation_time;
116 __le32 ina_detection_search_time;
117 __le32 beacon_silence_rssi_a;
118 __le32 beacon_silence_rssi_b;
119 __le32 beacon_silence_rssi_c;
120 __le32 interference_data_flag;
121 __le32 channel_load;
122 __le32 beacon_rssi_a;
123 __le32 beacon_rssi_b;
124 __le32 beacon_rssi_c;
125 __le32 beacon_energy_a;
126 __le32 beacon_energy_b;
127 __le32 beacon_energy_c;
128 __le32 num_bt_kills;
129 __le32 mac_id;
130 } __packed; /* STATISTICS_RX_NON_PHY_API_S_VER_4 */
131
132 struct mvm_statistics_rx_non_phy_v3 {
133 __le32 bogus_cts; /* CTS received when not expecting CTS */
134 __le32 bogus_ack; /* ACK received when not expecting ACK */
135 __le32 non_bssid_frames; /* number of frames with BSSID that
136 * doesn't belong to the STA BSSID */
137 __le32 filtered_frames; /* count frames that were dumped in the
138 * filtering process */
139 __le32 non_channel_beacons; /* beacons with our bss id but not on
140 * our serving channel */
141 __le32 channel_beacons; /* beacons with our bss id and in our
142 * serving channel */
143 __le32 num_missed_bcon; /* number of missed beacons */
144 __le32 adc_rx_saturation_time; /* count in 0.8us units the time the
145 * ADC was in saturation */
146 __le32 ina_detection_search_time;/* total time (in 0.8us) searched
147 * for INA */
148 __le32 beacon_silence_rssi_a; /* RSSI silence after beacon frame */
149 __le32 beacon_silence_rssi_b; /* RSSI silence after beacon frame */
150 __le32 beacon_silence_rssi_c; /* RSSI silence after beacon frame */
151 __le32 interference_data_flag; /* flag for interference data
152 * availability. 1 when data is
153 * available. */
154 __le32 channel_load; /* counts RX Enable time in uSec */
155 __le32 dsp_false_alarms; /* DSP false alarm (both OFDM
156 * and CCK) counter */
157 __le32 beacon_rssi_a;
158 __le32 beacon_rssi_b;
159 __le32 beacon_rssi_c;
160 __le32 beacon_energy_a;
161 __le32 beacon_energy_b;
162 __le32 beacon_energy_c;
163 __le32 num_bt_kills;
164 __le32 mac_id;
165 __le32 directed_data_mpdu;
166 } __packed; /* STATISTICS_RX_NON_PHY_API_S_VER_3 */
167
168 struct mvm_statistics_rx_phy {
169 __le32 unresponded_rts;
170 __le32 rxe_frame_lmt_overrun;
171 __le32 sent_ba_rsp_cnt;
172 __le32 dsp_self_kill;
173 __le32 reserved;
174 } __packed; /* STATISTICS_RX_PHY_API_S_VER_3 */
175
176 struct mvm_statistics_rx_phy_v2 {
177 __le32 ina_cnt;
178 __le32 fina_cnt;
179 __le32 plcp_err;
180 __le32 crc32_err;
181 __le32 overrun_err;
182 __le32 early_overrun_err;
183 __le32 crc32_good;
184 __le32 false_alarm_cnt;
185 __le32 fina_sync_err_cnt;
186 __le32 sfd_timeout;
187 __le32 fina_timeout;
188 __le32 unresponded_rts;
189 __le32 rxe_frame_lmt_overrun;
190 __le32 sent_ack_cnt;
191 __le32 sent_cts_cnt;
192 __le32 sent_ba_rsp_cnt;
193 __le32 dsp_self_kill;
194 __le32 mh_format_err;
195 __le32 re_acq_main_rssi_sum;
196 __le32 reserved;
197 } __packed; /* STATISTICS_RX_PHY_API_S_VER_2 */
198
199 struct mvm_statistics_rx_ht_phy_v1 {
200 __le32 plcp_err;
201 __le32 overrun_err;
202 __le32 early_overrun_err;
203 __le32 crc32_good;
204 __le32 crc32_err;
205 __le32 mh_format_err;
206 __le32 agg_crc32_good;
207 __le32 agg_mpdu_cnt;
208 __le32 agg_cnt;
209 __le32 unsupport_mcs;
210 } __packed; /* STATISTICS_HT_RX_PHY_API_S_VER_1 */
211
212 struct mvm_statistics_rx_ht_phy {
213 __le32 mh_format_err;
214 __le32 agg_mpdu_cnt;
215 __le32 agg_cnt;
216 __le32 unsupport_mcs;
217 } __packed; /* STATISTICS_HT_RX_PHY_API_S_VER_2 */
218
219 struct mvm_statistics_tx_non_phy_v3 {
220 __le32 preamble_cnt;
221 __le32 rx_detected_cnt;
222 __le32 bt_prio_defer_cnt;
223 __le32 bt_prio_kill_cnt;
224 __le32 few_bytes_cnt;
225 __le32 cts_timeout;
226 __le32 ack_timeout;
227 __le32 expected_ack_cnt;
228 __le32 actual_ack_cnt;
229 __le32 dump_msdu_cnt;
230 __le32 burst_abort_next_frame_mismatch_cnt;
231 __le32 burst_abort_missing_next_frame_cnt;
232 __le32 cts_timeout_collision;
233 __le32 ack_or_ba_timeout_collision;
234 } __packed; /* STATISTICS_TX_NON_PHY_API_S_VER_3 */
235
236 struct mvm_statistics_tx_non_phy {
237 __le32 bt_prio_defer_cnt;
238 __le32 bt_prio_kill_cnt;
239 __le32 few_bytes_cnt;
240 __le32 cts_timeout;
241 __le32 ack_timeout;
242 __le32 dump_msdu_cnt;
243 __le32 burst_abort_next_frame_mismatch_cnt;
244 __le32 burst_abort_missing_next_frame_cnt;
245 __le32 cts_timeout_collision;
246 __le32 ack_or_ba_timeout_collision;
247 } __packed; /* STATISTICS_TX_NON_PHY_API_S_VER_4 */
248
249 #define MAX_CHAINS 3
250
251 struct mvm_statistics_tx_non_phy_agg {
252 __le32 ba_timeout;
253 __le32 ba_reschedule_frames;
254 __le32 scd_query_agg_frame_cnt;
255 __le32 scd_query_no_agg;
256 __le32 scd_query_agg;
257 __le32 scd_query_mismatch;
258 __le32 frame_not_ready;
259 __le32 underrun;
260 __le32 bt_prio_kill;
261 __le32 rx_ba_rsp_cnt;
262 __s8 txpower[MAX_CHAINS];
263 __s8 reserved;
264 __le32 reserved2;
265 } __packed; /* STATISTICS_TX_NON_PHY_AGG_API_S_VER_1 */
266
267 struct mvm_statistics_tx_channel_width {
268 __le32 ext_cca_narrow_ch20[1];
269 __le32 ext_cca_narrow_ch40[2];
270 __le32 ext_cca_narrow_ch80[3];
271 __le32 ext_cca_narrow_ch160[4];
272 __le32 last_tx_ch_width_indx;
273 __le32 rx_detected_per_ch_width[4];
274 __le32 success_per_ch_width[4];
275 __le32 fail_per_ch_width[4];
276 }; /* STATISTICS_TX_CHANNEL_WIDTH_API_S_VER_1 */
277
278 struct mvm_statistics_tx_v4 {
279 struct mvm_statistics_tx_non_phy_v3 general;
280 struct mvm_statistics_tx_non_phy_agg agg;
281 struct mvm_statistics_tx_channel_width channel_width;
282 } __packed; /* STATISTICS_TX_API_S_VER_4 */
283
284 struct mvm_statistics_tx {
285 struct mvm_statistics_tx_non_phy general;
286 struct mvm_statistics_tx_non_phy_agg agg;
287 struct mvm_statistics_tx_channel_width channel_width;
288 } __packed; /* STATISTICS_TX_API_S_VER_5 */
289
290
291 struct mvm_statistics_bt_activity {
292 __le32 hi_priority_tx_req_cnt;
293 __le32 hi_priority_tx_denied_cnt;
294 __le32 lo_priority_tx_req_cnt;
295 __le32 lo_priority_tx_denied_cnt;
296 __le32 hi_priority_rx_req_cnt;
297 __le32 hi_priority_rx_denied_cnt;
298 __le32 lo_priority_rx_req_cnt;
299 __le32 lo_priority_rx_denied_cnt;
300 } __packed; /* STATISTICS_BT_ACTIVITY_API_S_VER_1 */
301
302 struct mvm_statistics_general_common_v19 {
303 __le32 radio_temperature;
304 __le32 radio_voltage;
305 struct mvm_statistics_dbg dbg;
306 __le32 sleep_time;
307 __le32 slots_out;
308 __le32 slots_idle;
309 __le32 ttl_timestamp;
310 struct mvm_statistics_div slow_div;
311 __le32 rx_enable_counter;
312 /*
313 * num_of_sos_states:
314 * count the number of times we have to re-tune
315 * in order to get out of bad PHY status
316 */
317 __le32 num_of_sos_states;
318 __le32 beacon_filtered;
319 __le32 missed_beacons;
320 u8 beacon_filter_average_energy;
321 u8 beacon_filter_reason;
322 u8 beacon_filter_current_energy;
323 u8 beacon_filter_reserved;
324 __le32 beacon_filter_delta_time;
325 struct mvm_statistics_bt_activity bt_activity;
326 __le64 rx_time;
327 __le64 on_time_rf;
328 __le64 on_time_scan;
329 __le64 tx_time;
330 } __packed;
331
332 struct mvm_statistics_general_common {
333 __le32 radio_temperature;
334 struct mvm_statistics_dbg dbg;
335 __le32 sleep_time;
336 __le32 slots_out;
337 __le32 slots_idle;
338 __le32 ttl_timestamp;
339 struct mvm_statistics_div slow_div;
340 __le32 rx_enable_counter;
341 /*
342 * num_of_sos_states:
343 * count the number of times we have to re-tune
344 * in order to get out of bad PHY status
345 */
346 __le32 num_of_sos_states;
347 __le32 beacon_filtered;
348 __le32 missed_beacons;
349 u8 beacon_filter_average_energy;
350 u8 beacon_filter_reason;
351 u8 beacon_filter_current_energy;
352 u8 beacon_filter_reserved;
353 __le32 beacon_filter_delta_time;
354 struct mvm_statistics_bt_activity bt_activity;
355 __le64 rx_time;
356 __le64 on_time_rf;
357 __le64 on_time_scan;
358 __le64 tx_time;
359 } __packed; /* STATISTICS_GENERAL_API_S_VER_10 */
360
361 struct mvm_statistics_general_v8 {
362 struct mvm_statistics_general_common_v19 common;
363 __le32 beacon_counter[NUM_MAC_INDEX];
364 u8 beacon_average_energy[NUM_MAC_INDEX];
365 u8 reserved[4 - (NUM_MAC_INDEX % 4)];
366 } __packed; /* STATISTICS_GENERAL_API_S_VER_8 */
367
368 struct mvm_statistics_general {
369 struct mvm_statistics_general_common common;
370 __le32 beacon_counter[MAC_INDEX_AUX];
371 u8 beacon_average_energy[MAC_INDEX_AUX];
372 u8 reserved[8 - MAC_INDEX_AUX];
373 } __packed; /* STATISTICS_GENERAL_API_S_VER_10 */
374
375 /**
376 * struct mvm_statistics_load - RX statistics for multi-queue devices
377 * @air_time: accumulated air time, per mac
378 * @byte_count: accumulated byte count, per mac
379 * @pkt_count: accumulated packet count, per mac
380 * @avg_energy: average RSSI, per station
381 */
382 struct mvm_statistics_load {
383 __le32 air_time[MAC_INDEX_AUX];
384 __le32 byte_count[MAC_INDEX_AUX];
385 __le32 pkt_count[MAC_INDEX_AUX];
386 u8 avg_energy[IWL_MVM_STATION_COUNT];
387 } __packed; /* STATISTICS_RX_MAC_STATION_S_VER_3 */
388
389 struct mvm_statistics_load_v1 {
390 __le32 air_time[NUM_MAC_INDEX];
391 __le32 byte_count[NUM_MAC_INDEX];
392 __le32 pkt_count[NUM_MAC_INDEX];
393 u8 avg_energy[IWL_MVM_STATION_COUNT];
394 } __packed; /* STATISTICS_RX_MAC_STATION_S_VER_1 */
395
396 struct mvm_statistics_rx {
397 struct mvm_statistics_rx_phy ofdm;
398 struct mvm_statistics_rx_phy cck;
399 struct mvm_statistics_rx_non_phy general;
400 struct mvm_statistics_rx_ht_phy ofdm_ht;
401 } __packed; /* STATISTICS_RX_API_S_VER_4 */
402
403 struct mvm_statistics_rx_v3 {
404 struct mvm_statistics_rx_phy_v2 ofdm;
405 struct mvm_statistics_rx_phy_v2 cck;
406 struct mvm_statistics_rx_non_phy_v3 general;
407 struct mvm_statistics_rx_ht_phy_v1 ofdm_ht;
408 } __packed; /* STATISTICS_RX_API_S_VER_3 */
409
410 /*
411 * STATISTICS_NOTIFICATION = 0x9d (notification only, not a command)
412 *
413 * By default, uCode issues this notification after receiving a beacon
414 * while associated. To disable this behavior, set DISABLE_NOTIF flag in the
415 * STATISTICS_CMD (0x9c), below.
416 */
417
418 struct iwl_notif_statistics_v10 {
419 __le32 flag;
420 struct mvm_statistics_rx_v3 rx;
421 struct mvm_statistics_tx_v4 tx;
422 struct mvm_statistics_general_v8 general;
423 } __packed; /* STATISTICS_NTFY_API_S_VER_10 */
424
425 struct iwl_notif_statistics_v11 {
426 __le32 flag;
427 struct mvm_statistics_rx_v3 rx;
428 struct mvm_statistics_tx_v4 tx;
429 struct mvm_statistics_general_v8 general;
430 struct mvm_statistics_load_v1 load_stats;
431 } __packed; /* STATISTICS_NTFY_API_S_VER_11 */
432
433 struct iwl_notif_statistics {
434 __le32 flag;
435 struct mvm_statistics_rx rx;
436 struct mvm_statistics_tx tx;
437 struct mvm_statistics_general general;
438 struct mvm_statistics_load load_stats;
439 } __packed; /* STATISTICS_NTFY_API_S_VER_13 */
440
441 /**
442 * enum iwl_statistics_notif_flags - flags used in statistics notification
443 * @IWL_STATISTICS_REPLY_FLG_CLEAR: statistics were cleared after this report
444 */
445 enum iwl_statistics_notif_flags {
446 IWL_STATISTICS_REPLY_FLG_CLEAR = 0x1,
447 };
448
449 /**
450 * enum iwl_statistics_cmd_flags - flags used in statistics command
451 * @IWL_STATISTICS_FLG_CLEAR: request to clear statistics after the report
452 * that's sent after this command
453 * @IWL_STATISTICS_FLG_DISABLE_NOTIF: disable unilateral statistics
454 * notifications
455 */
456 enum iwl_statistics_cmd_flags {
457 IWL_STATISTICS_FLG_CLEAR = 0x1,
458 IWL_STATISTICS_FLG_DISABLE_NOTIF = 0x2,
459 };
460
461 /**
462 * struct iwl_statistics_cmd - statistics config command
463 * @flags: flags from &enum iwl_statistics_cmd_flags
464 */
465 struct iwl_statistics_cmd {
466 __le32 flags;
467 } __packed; /* STATISTICS_CMD_API_S_VER_1 */
468
469 #endif /* __iwl_fw_api_stats_h__ */