xref: /linux/drivers/net/wireless/intel/iwlwifi/fw/api/stats.h (revision 6fdcba32711044c35c0e1b094cbd8f3f0b4472c9)
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__ */
470