Commit 31a658b2 authored by Johannes Berg's avatar Johannes Berg Committed by Luca Coelho

iwlwifi: mvm: fix some kernel-doc

This mostly fixes missing tags/struct names, but also some other
things. Lots of issues remain though.
Signed-off-by: default avatarJohannes Berg <johannes.berg@intel.com>
Signed-off-by: default avatarLuca Coelho <luciano.coelho@intel.com>
parent 0b90964a
...@@ -395,8 +395,8 @@ enum iwl_ucode_tlv_capa { ...@@ -395,8 +395,8 @@ enum iwl_ucode_tlv_capa {
#define IWL_UCODE_API(ver) (((ver) & 0x0000FF00) >> 8) #define IWL_UCODE_API(ver) (((ver) & 0x0000FF00) >> 8)
#define IWL_UCODE_SERIAL(ver) ((ver) & 0x000000FF) #define IWL_UCODE_SERIAL(ver) ((ver) & 0x000000FF)
/* /**
* Calibration control struct. * struct iwl_tlv_calib_ctrl - Calibration control struct.
* Sent as part of the phy configuration command. * Sent as part of the phy configuration command.
* @flow_trigger: bitmap for which calibrations to perform according to * @flow_trigger: bitmap for which calibrations to perform according to
* flow triggers. * flow triggers.
......
...@@ -411,7 +411,7 @@ struct iwl_geo_tx_power_profiles_cmd { ...@@ -411,7 +411,7 @@ struct iwl_geo_tx_power_profiles_cmd {
* Threshold. Typical energy threshold is -72dBm. * Threshold. Typical energy threshold is -72dBm.
* @bf_temp_threshold: This threshold determines the type of temperature * @bf_temp_threshold: This threshold determines the type of temperature
* filtering (Slow or Fast) that is selected (Units are in Celsuis): * filtering (Slow or Fast) that is selected (Units are in Celsuis):
* If the current temperature is above this threshold - Fast filter * If the current temperature is above this threshold - Fast filter
* will be used, If the current temperature is below this threshold - * will be used, If the current temperature is below this threshold -
* Slow filter will be used. * Slow filter will be used.
* @bf_temp_fast_filter: Send Beacon to driver if delta in temperature values * @bf_temp_fast_filter: Send Beacon to driver if delta in temperature values
......
...@@ -147,7 +147,8 @@ enum iwl_csum_rx_assist_info { ...@@ -147,7 +147,8 @@ enum iwl_csum_rx_assist_info {
/** /**
* struct iwl_rx_mpdu_res_start - phy info * struct iwl_rx_mpdu_res_start - phy info
* @assist: see CSUM_RX_ASSIST_ above * @byte_count: byte count of the frame
* @assist: see &enum iwl_csum_rx_assist_info
*/ */
struct iwl_rx_mpdu_res_start { struct iwl_rx_mpdu_res_start {
__le16 byte_count; __le16 byte_count;
...@@ -447,7 +448,7 @@ struct iwl_rxq_sync_notification { ...@@ -447,7 +448,7 @@ struct iwl_rxq_sync_notification {
} __packed; /* MULTI_QUEUE_DRV_SYNC_HDR_CMD_API_S_VER_1 */ } __packed; /* MULTI_QUEUE_DRV_SYNC_HDR_CMD_API_S_VER_1 */
/** /**
* Internal message identifier * enum iwl_mvm_rxq_notif_type - Internal message identifier
* *
* @IWL_MVM_RXQ_EMPTY: empty sync notification * @IWL_MVM_RXQ_EMPTY: empty sync notification
* @IWL_MVM_RXQ_NOTIF_DEL_BA: notify RSS queues of delBA * @IWL_MVM_RXQ_NOTIF_DEL_BA: notify RSS queues of delBA
...@@ -491,7 +492,7 @@ enum iwl_mvm_pm_event { ...@@ -491,7 +492,7 @@ enum iwl_mvm_pm_event {
/** /**
* struct iwl_mvm_pm_state_notification - station PM state notification * struct iwl_mvm_pm_state_notification - station PM state notification
* @sta_id: station ID of the station changing state * @sta_id: station ID of the station changing state
* @type: the new powersave state, see IWL_MVM_PM_EVENT_ above * @type: the new powersave state, see &enum iwl_mvm_pm_event
*/ */
struct iwl_mvm_pm_state_notification { struct iwl_mvm_pm_state_notification {
u8 sta_id; u8 sta_id;
......
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
* *
* Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
* Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
* Copyright(c) 2016 Intel Deutschland GmbH * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
* *
* This program is free software; you can redistribute it and/or modify * This program is free software; you can redistribute it and/or modify
* it under the terms of version 2 of the GNU General Public License as * it under the terms of version 2 of the GNU General Public License as
...@@ -34,6 +34,7 @@ ...@@ -34,6 +34,7 @@
* *
* Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
* Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
* Copyright(c) 2016 - 2017 Intel Deutschland GmbH
* All rights reserved. * All rights reserved.
* *
* Redistribution and use in source and binary forms, with or without * Redistribution and use in source and binary forms, with or without
...@@ -111,7 +112,7 @@ enum scan_framework_client { ...@@ -111,7 +112,7 @@ enum scan_framework_client {
}; };
/** /**
* iwl_scan_offload_blacklist - SCAN_OFFLOAD_BLACKLIST_S * struct iwl_scan_offload_blacklist - SCAN_OFFLOAD_BLACKLIST_S
* @ssid: MAC address to filter out * @ssid: MAC address to filter out
* @reported_rssi: AP rssi reported to the host * @reported_rssi: AP rssi reported to the host
* @client_bitmap: clients ignore this entry - enum scan_framework_client * @client_bitmap: clients ignore this entry - enum scan_framework_client
...@@ -135,7 +136,7 @@ enum iwl_scan_offload_band_selection { ...@@ -135,7 +136,7 @@ enum iwl_scan_offload_band_selection {
}; };
/** /**
* iwl_scan_offload_profile - SCAN_OFFLOAD_PROFILE_S * struct iwl_scan_offload_profile - SCAN_OFFLOAD_PROFILE_S
* @ssid_index: index to ssid list in fixed part * @ssid_index: index to ssid list in fixed part
* @unicast_cipher: encryption algorithm to match - bitmap * @unicast_cipher: encryption algorithm to match - bitmap
* @aut_alg: authentication algorithm to match - bitmap * @aut_alg: authentication algorithm to match - bitmap
...@@ -154,8 +155,7 @@ struct iwl_scan_offload_profile { ...@@ -154,8 +155,7 @@ struct iwl_scan_offload_profile {
} __packed; } __packed;
/** /**
* iwl_scan_offload_profile_cfg - SCAN_OFFLOAD_PROFILES_CFG_API_S_VER_1 * struct iwl_scan_offload_profile_cfg - SCAN_OFFLOAD_PROFILES_CFG_API_S_VER_1
* @blaclist: AP list to filter off from scan results
* @profiles: profiles to search for match * @profiles: profiles to search for match
* @blacklist_len: length of blacklist * @blacklist_len: length of blacklist
* @num_profiles: num of profiles in the list * @num_profiles: num of profiles in the list
...@@ -176,7 +176,7 @@ struct iwl_scan_offload_profile_cfg { ...@@ -176,7 +176,7 @@ struct iwl_scan_offload_profile_cfg {
} __packed; } __packed;
/** /**
* iwl_scan_schedule_lmac - schedule of scan offload * struct iwl_scan_schedule_lmac - schedule of scan offload
* @delay: delay between iterations, in seconds. * @delay: delay between iterations, in seconds.
* @iterations: num of scan iterations * @iterations: num of scan iterations
* @full_scan_mul: number of partial scans before each full scan * @full_scan_mul: number of partial scans before each full scan
...@@ -200,7 +200,7 @@ enum iwl_scan_ebs_status { ...@@ -200,7 +200,7 @@ enum iwl_scan_ebs_status {
}; };
/** /**
* iwl_scan_req_tx_cmd - SCAN_REQ_TX_CMD_API_S * struct iwl_scan_req_tx_cmd - SCAN_REQ_TX_CMD_API_S
* @tx_flags: combination of TX_CMD_FLG_* * @tx_flags: combination of TX_CMD_FLG_*
* @rate_n_flags: rate for *all* Tx attempts, if TX_CMD_FLG_STA_RATE_MSK is * @rate_n_flags: rate for *all* Tx attempts, if TX_CMD_FLG_STA_RATE_MSK is
* cleared. Combination of RATE_MCS_* * cleared. Combination of RATE_MCS_*
...@@ -220,7 +220,7 @@ enum iwl_scan_channel_flags_lmac { ...@@ -220,7 +220,7 @@ enum iwl_scan_channel_flags_lmac {
}; };
/** /**
* iwl_scan_channel_cfg_lmac - SCAN_CHANNEL_CFG_S_VER2 * struct iwl_scan_channel_cfg_lmac - SCAN_CHANNEL_CFG_S_VER2
* @flags: bits 1-20: directed scan to i'th ssid * @flags: bits 1-20: directed scan to i'th ssid
* other bits &enum iwl_scan_channel_flags_lmac * other bits &enum iwl_scan_channel_flags_lmac
* @channel_number: channel number 1-13 etc * @channel_number: channel number 1-13 etc
...@@ -235,7 +235,7 @@ struct iwl_scan_channel_cfg_lmac { ...@@ -235,7 +235,7 @@ struct iwl_scan_channel_cfg_lmac {
} __packed; } __packed;
/* /*
* iwl_scan_probe_segment - PROBE_SEGMENT_API_S_VER_1 * struct iwl_scan_probe_segment - PROBE_SEGMENT_API_S_VER_1
* @offset: offset in the data block * @offset: offset in the data block
* @len: length of the segment * @len: length of the segment
*/ */
...@@ -263,7 +263,7 @@ enum iwl_scan_channel_flags { ...@@ -263,7 +263,7 @@ enum iwl_scan_channel_flags {
IWL_SCAN_CHANNEL_FLAG_CACHE_ADD = BIT(2), IWL_SCAN_CHANNEL_FLAG_CACHE_ADD = BIT(2),
}; };
/* iwl_scan_channel_opt - CHANNEL_OPTIMIZATION_API_S /* struct iwl_scan_channel_opt - CHANNEL_OPTIMIZATION_API_S
* @flags: enum iwl_scan_channel_flags * @flags: enum iwl_scan_channel_flags
* @non_ebs_ratio: defines the ratio of number of scan iterations where EBS is * @non_ebs_ratio: defines the ratio of number of scan iterations where EBS is
* involved. * involved.
...@@ -276,7 +276,7 @@ struct iwl_scan_channel_opt { ...@@ -276,7 +276,7 @@ struct iwl_scan_channel_opt {
} __packed; } __packed;
/** /**
* iwl_mvm_lmac_scan_flags * enum iwl_mvm_lmac_scan_flags - LMAC scan flags
* @IWL_MVM_LMAC_SCAN_FLAG_PASS_ALL: pass all beacons and probe responses * @IWL_MVM_LMAC_SCAN_FLAG_PASS_ALL: pass all beacons and probe responses
* without filtering. * without filtering.
* @IWL_MVM_LMAC_SCAN_FLAG_PASSIVE: force passive scan on all channels * @IWL_MVM_LMAC_SCAN_FLAG_PASSIVE: force passive scan on all channels
...@@ -320,7 +320,7 @@ enum iwl_scan_priority_ext { ...@@ -320,7 +320,7 @@ enum iwl_scan_priority_ext {
}; };
/** /**
* iwl_scan_req_lmac - SCAN_REQUEST_CMD_API_S_VER_1 * struct iwl_scan_req_lmac - SCAN_REQUEST_CMD_API_S_VER_1
* @reserved1: for alignment and future use * @reserved1: for alignment and future use
* @channel_num: num of channels to scan * @channel_num: num of channels to scan
* @active-dwell: dwell time for active channels * @active-dwell: dwell time for active channels
...@@ -410,7 +410,7 @@ struct iwl_lmac_scan_complete_notif { ...@@ -410,7 +410,7 @@ struct iwl_lmac_scan_complete_notif {
} __packed; } __packed;
/** /**
* iwl_scan_offload_complete - PERIODIC_SCAN_COMPLETE_NTF_API_S_VER_2 * struct iwl_scan_offload_complete - PERIODIC_SCAN_COMPLETE_NTF_API_S_VER_2
* @last_schedule_line: last schedule line executed (fast or regular) * @last_schedule_line: last schedule line executed (fast or regular)
* @last_schedule_iteration: last scan iteration executed before scan abort * @last_schedule_iteration: last scan iteration executed before scan abort
* @status: enum iwl_scan_offload_complete_status * @status: enum iwl_scan_offload_complete_status
...@@ -547,12 +547,12 @@ struct iwl_scan_config { ...@@ -547,12 +547,12 @@ struct iwl_scan_config {
} __packed; /* SCAN_CONFIG_DB_CMD_API_S_3 */ } __packed; /* SCAN_CONFIG_DB_CMD_API_S_3 */
/** /**
* iwl_umac_scan_flags * enum iwl_umac_scan_flags - UMAC scan flags
*@IWL_UMAC_SCAN_FLAG_PREEMPTIVE: scan process triggered by this scan request * @IWL_UMAC_SCAN_FLAG_PREEMPTIVE: scan process triggered by this scan request
* can be preempted by other scan requests with higher priority. * can be preempted by other scan requests with higher priority.
* The low priority scan will be resumed when the higher proirity scan is * The low priority scan will be resumed when the higher proirity scan is
* completed. * completed.
*@IWL_UMAC_SCAN_FLAG_START_NOTIF: notification will be sent to the driver * @IWL_UMAC_SCAN_FLAG_START_NOTIF: notification will be sent to the driver
* when scan starts. * when scan starts.
*/ */
enum iwl_umac_scan_flags { enum iwl_umac_scan_flags {
......
...@@ -223,7 +223,7 @@ enum iwl_sta_sleep_flag { ...@@ -223,7 +223,7 @@ enum iwl_sta_sleep_flag {
/** /**
* struct iwl_mvm_keyinfo - key information * struct iwl_mvm_keyinfo - key information
* @key_flags: type %iwl_sta_key_flag * @key_flags: type &enum iwl_sta_key_flag
* @tkip_rx_tsc_byte2: TSC[2] for key mix ph1 detection * @tkip_rx_tsc_byte2: TSC[2] for key mix ph1 detection
* @tkip_rx_ttak: 10-byte unicast TKIP TTAK for Rx * @tkip_rx_ttak: 10-byte unicast TKIP TTAK for Rx
* @key_offset: key offset in the fw's key table * @key_offset: key offset in the fw's key table
...@@ -258,12 +258,13 @@ struct iwl_mvm_keyinfo { ...@@ -258,12 +258,13 @@ struct iwl_mvm_keyinfo {
* @tid_disable_tx: is tid BIT(tid) enabled for Tx. Clear BIT(x) to enable * @tid_disable_tx: is tid BIT(tid) enabled for Tx. Clear BIT(x) to enable
* AMPDU for tid x. Set %STA_MODIFY_TID_DISABLE_TX to change this field. * AMPDU for tid x. Set %STA_MODIFY_TID_DISABLE_TX to change this field.
* @mac_id_n_color: the Mac context this station belongs to * @mac_id_n_color: the Mac context this station belongs to
* @addr[ETH_ALEN]: station's MAC address * @addr: station's MAC address
* @sta_id: index of station in uCode's station table * @sta_id: index of station in uCode's station table
* @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave * @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave
* alone. 1 - modify, 0 - don't change. * alone. 1 - modify, 0 - don't change.
* @station_flags: look at %iwl_sta_flags * @station_flags: look at &enum iwl_sta_flags
* @station_flags_msk: what of %station_flags have changed * @station_flags_msk: what of %station_flags have changed,
* also &enum iwl_sta_flags
* @add_immediate_ba_tid: tid for which to add block-ack support (Rx) * @add_immediate_ba_tid: tid for which to add block-ack support (Rx)
* Set %STA_MODIFY_ADD_BA_TID to use this field, and also set * Set %STA_MODIFY_ADD_BA_TID to use this field, and also set
* add_immediate_ba_ssn. * add_immediate_ba_ssn.
...@@ -274,7 +275,7 @@ struct iwl_mvm_keyinfo { ...@@ -274,7 +275,7 @@ struct iwl_mvm_keyinfo {
* @sleep_tx_count: number of packets to transmit to station even though it is * @sleep_tx_count: number of packets to transmit to station even though it is
* asleep. Used to synchronise PS-poll and u-APSD responses while ucode * asleep. Used to synchronise PS-poll and u-APSD responses while ucode
* keeps track of STA sleep state. * keeps track of STA sleep state.
* @sleep_state_flags: Look at %iwl_sta_sleep_flag. * @sleep_state_flags: Look at &enum iwl_sta_sleep_flag.
* @assoc_id: assoc_id to be sent in VHT PLCP (9-bit), for grp use 0, for AP * @assoc_id: assoc_id to be sent in VHT PLCP (9-bit), for grp use 0, for AP
* mac-addr. * mac-addr.
* @beamform_flags: beam forming controls * @beamform_flags: beam forming controls
...@@ -335,12 +336,13 @@ enum iwl_sta_type { ...@@ -335,12 +336,13 @@ enum iwl_sta_type {
* @tid_disable_tx: is tid BIT(tid) enabled for Tx. Clear BIT(x) to enable * @tid_disable_tx: is tid BIT(tid) enabled for Tx. Clear BIT(x) to enable
* AMPDU for tid x. Set %STA_MODIFY_TID_DISABLE_TX to change this field. * AMPDU for tid x. Set %STA_MODIFY_TID_DISABLE_TX to change this field.
* @mac_id_n_color: the Mac context this station belongs to * @mac_id_n_color: the Mac context this station belongs to
* @addr[ETH_ALEN]: station's MAC address * @addr: station's MAC address
* @sta_id: index of station in uCode's station table * @sta_id: index of station in uCode's station table
* @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave * @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave
* alone. 1 - modify, 0 - don't change. * alone. 1 - modify, 0 - don't change.
* @station_flags: look at %iwl_sta_flags * @station_flags: look at &enum iwl_sta_flags
* @station_flags_msk: what of %station_flags have changed * @station_flags_msk: what of %station_flags have changed,
* also &enum iwl_sta_flags
* @add_immediate_ba_tid: tid for which to add block-ack support (Rx) * @add_immediate_ba_tid: tid for which to add block-ack support (Rx)
* Set %STA_MODIFY_ADD_BA_TID to use this field, and also set * Set %STA_MODIFY_ADD_BA_TID to use this field, and also set
* add_immediate_ba_ssn. * add_immediate_ba_ssn.
...@@ -352,7 +354,7 @@ enum iwl_sta_type { ...@@ -352,7 +354,7 @@ enum iwl_sta_type {
* asleep. Used to synchronise PS-poll and u-APSD responses while ucode * asleep. Used to synchronise PS-poll and u-APSD responses while ucode
* keeps track of STA sleep state. * keeps track of STA sleep state.
* @station_type: type of this station. See &enum iwl_sta_type. * @station_type: type of this station. See &enum iwl_sta_type.
* @sleep_state_flags: Look at %iwl_sta_sleep_flag. * @sleep_state_flags: Look at &enum iwl_sta_sleep_flag.
* @assoc_id: assoc_id to be sent in VHT PLCP (9-bit), for grp use 0, for AP * @assoc_id: assoc_id to be sent in VHT PLCP (9-bit), for grp use 0, for AP
* mac-addr. * mac-addr.
* @beamform_flags: beam forming controls * @beamform_flags: beam forming controls
...@@ -401,7 +403,7 @@ struct iwl_mvm_add_sta_cmd { ...@@ -401,7 +403,7 @@ struct iwl_mvm_add_sta_cmd {
* ( REPLY_ADD_STA_KEY = 0x17 ) * ( REPLY_ADD_STA_KEY = 0x17 )
* @sta_id: index of station in uCode's station table * @sta_id: index of station in uCode's station table
* @key_offset: key offset in key storage * @key_offset: key offset in key storage
* @key_flags: type %iwl_sta_key_flag * @key_flags: type &enum iwl_sta_key_flag
* @key: key material data * @key: key material data
* @rx_secur_seq_cnt: RX security sequence counter for the key * @rx_secur_seq_cnt: RX security sequence counter for the key
*/ */
......
...@@ -595,9 +595,10 @@ struct iwl_mvm_tx_resp { ...@@ -595,9 +595,10 @@ struct iwl_mvm_tx_resp {
* struct iwl_mvm_ba_notif - notifies about reception of BA * struct iwl_mvm_ba_notif - notifies about reception of BA
* ( BA_NOTIF = 0xc5 ) * ( BA_NOTIF = 0xc5 )
* @sta_addr: MAC address * @sta_addr: MAC address
* @reserved: reserved
* @sta_id: Index of recipient (BA-sending) station in fw's station table * @sta_id: Index of recipient (BA-sending) station in fw's station table
* @tid: tid of the session * @tid: tid of the session
* @seq_ctl: * @seq_ctl: sequence control field
* @bitmap: the bitmap of the BA notification as seen in the air * @bitmap: the bitmap of the BA notification as seen in the air
* @scd_flow: the tx queue this BA relates to * @scd_flow: the tx queue this BA relates to
* @scd_ssn: the index of the last contiguously sent packet * @scd_ssn: the index of the last contiguously sent packet
...@@ -606,6 +607,7 @@ struct iwl_mvm_tx_resp { ...@@ -606,6 +607,7 @@ struct iwl_mvm_tx_resp {
* @reduced_txp: power reduced according to TPC. This is the actual value and * @reduced_txp: power reduced according to TPC. This is the actual value and
* not a copy from the LQ command. Thus, if not the first rate was used * not a copy from the LQ command. Thus, if not the first rate was used
* for Tx-ing then this value will be set to 0 by FW. * for Tx-ing then this value will be set to 0 by FW.
* @reserved1: reserved
*/ */
struct iwl_mvm_ba_notif { struct iwl_mvm_ba_notif {
u8 sta_addr[ETH_ALEN]; u8 sta_addr[ETH_ALEN];
...@@ -628,13 +630,13 @@ struct iwl_mvm_ba_notif { ...@@ -628,13 +630,13 @@ struct iwl_mvm_ba_notif {
* @q_num: TFD queue number * @q_num: TFD queue number
* @tfd_index: Index of first un-acked frame in the TFD queue * @tfd_index: Index of first un-acked frame in the TFD queue
* @scd_queue: For debug only - the physical queue the TFD queue is bound to * @scd_queue: For debug only - the physical queue the TFD queue is bound to
* @reserved: reserved for alignment
*/ */
struct iwl_mvm_compressed_ba_tfd { struct iwl_mvm_compressed_ba_tfd {
__le16 q_num; __le16 q_num;
__le16 tfd_index; __le16 tfd_index;
u8 scd_queue; u8 scd_queue;
u8 reserved; u8 reserved[3];
__le16 reserved2;
} __packed; /* COMPRESSED_BA_TFD_API_S_VER_1 */ } __packed; /* COMPRESSED_BA_TFD_API_S_VER_1 */
/** /**
...@@ -682,11 +684,12 @@ enum iwl_mvm_ba_resp_flags { ...@@ -682,11 +684,12 @@ enum iwl_mvm_ba_resp_flags {
* @query_frame_cnt: SCD query frame count * @query_frame_cnt: SCD query frame count
* @txed: number of frames sent in the aggregation (all-TIDs) * @txed: number of frames sent in the aggregation (all-TIDs)
* @done: number of frames that were Acked by the BA (all-TIDs) * @done: number of frames that were Acked by the BA (all-TIDs)
* @reserved: reserved (for alignment)
* @wireless_time: Wireless-media time * @wireless_time: Wireless-media time
* @tx_rate: the rate the aggregation was sent at * @tx_rate: the rate the aggregation was sent at
* @tfd_cnt: number of TFD-Q elements * @tfd_cnt: number of TFD-Q elements
* @ra_tid_cnt: number of RATID-Q elements * @ra_tid_cnt: number of RATID-Q elements
* @ba_tfd: array of TFD queue status updates. See &iwl_mvm_compressed_ba_tfd * @tfd: array of TFD queue status updates. See &iwl_mvm_compressed_ba_tfd
* for details. * for details.
* @ra_tid: array of RA-TID queue status updates. For debug purposes only. See * @ra_tid: array of RA-TID queue status updates. For debug purposes only. See
* &iwl_mvm_compressed_ba_ratid for more details. * &iwl_mvm_compressed_ba_ratid for more details.
...@@ -760,6 +763,7 @@ struct iwl_mac_beacon_cmd_v7 { ...@@ -760,6 +763,7 @@ struct iwl_mac_beacon_cmd_v7 {
* struct iwl_mac_beacon_cmd - beacon template command with offloaded CSA * struct iwl_mac_beacon_cmd - beacon template command with offloaded CSA
* @byte_cnt: byte count of the beacon frame * @byte_cnt: byte count of the beacon frame
* @flags: for future use * @flags: for future use
* @reserved: reserved
* @data: see &iwl_mac_beacon_cmd_data * @data: see &iwl_mac_beacon_cmd_data
*/ */
struct iwl_mac_beacon_cmd { struct iwl_mac_beacon_cmd {
...@@ -819,9 +823,9 @@ enum iwl_scd_cfg_actions { ...@@ -819,9 +823,9 @@ enum iwl_scd_cfg_actions {
/** /**
* struct iwl_scd_txq_cfg_cmd - New txq hw scheduler config command * struct iwl_scd_txq_cfg_cmd - New txq hw scheduler config command
* @token: * @token: unused
* @sta_id: station id * @sta_id: station id
* @tid: * @tid: TID
* @scd_queue: scheduler queue to confiug * @scd_queue: scheduler queue to confiug
* @action: 1 queue enable, 0 queue disable, 2 change txq's tid owner * @action: 1 queue enable, 0 queue disable, 2 change txq's tid owner
* Value is one of %iwl_scd_cfg_actions options * Value is one of %iwl_scd_cfg_actions options
...@@ -829,6 +833,7 @@ enum iwl_scd_cfg_actions { ...@@ -829,6 +833,7 @@ enum iwl_scd_cfg_actions {
* @tx_fifo: %enum iwl_mvm_tx_fifo * @tx_fifo: %enum iwl_mvm_tx_fifo
* @window: BA window size * @window: BA window size
* @ssn: SSN for the BA agreement * @ssn: SSN for the BA agreement
* @reserved: reserved
*/ */
struct iwl_scd_txq_cfg_cmd { struct iwl_scd_txq_cfg_cmd {
u8 token; u8 token;
......
...@@ -412,13 +412,13 @@ struct iwl_tx_ant_cfg_cmd { ...@@ -412,13 +412,13 @@ struct iwl_tx_ant_cfg_cmd {
__le32 valid; __le32 valid;
} __packed; } __packed;
/* /**
* Calibration control struct. * struct iwl_calib_ctrl - Calibration control struct.
* Sent as part of the phy configuration command. * Sent as part of the phy configuration command.
* @flow_trigger: bitmap for which calibrations to perform according to * @flow_trigger: bitmap for which calibrations to perform according to
* flow triggers. * flow triggers, using &enum iwl_calib_cfg
* @event_trigger: bitmap for which calibrations to perform according to * @event_trigger: bitmap for which calibrations to perform according to
* event triggers. * event triggers, using &enum iwl_calib_cfg
*/ */
struct iwl_calib_ctrl { struct iwl_calib_ctrl {
__le32 flow_trigger; __le32 flow_trigger;
...@@ -450,8 +450,10 @@ enum iwl_calib_cfg { ...@@ -450,8 +450,10 @@ enum iwl_calib_cfg {
IWL_CALIB_CFG_AGC_IDX = BIT(18), IWL_CALIB_CFG_AGC_IDX = BIT(18),
}; };
/* /**
* Phy configuration command. * struct iwl_phy_cfg_cmd - Phy configuration command
* @phy_cfg: PHY configuration value, uses &enum iwl_fw_phy_cfg
* @calib_control: calibration control data
*/ */
struct iwl_phy_cfg_cmd { struct iwl_phy_cfg_cmd {
__le32 phy_cfg; __le32 phy_cfg;
...@@ -1576,8 +1578,8 @@ enum iwl_sf_scenario { ...@@ -1576,8 +1578,8 @@ enum iwl_sf_scenario {
#define SF_CFG_DUMMY_NOTIF_OFF BIT(16) #define SF_CFG_DUMMY_NOTIF_OFF BIT(16)
/** /**
* Smart Fifo configuration command. * struct iwl_sf_cfg_cmd - Smart Fifo configuration command.
* @state: smart fifo state, types listed in enum %iwl_sf_sate. * @state: smart fifo state, types listed in &enum iwl_sf_state.
* @watermark: Minimum allowed availabe free space in RXF for transient state. * @watermark: Minimum allowed availabe free space in RXF for transient state.
* @long_delay_timeouts: aging and idle timer values for each scenario * @long_delay_timeouts: aging and idle timer values for each scenario
* in long delay state. * in long delay state.
...@@ -1631,7 +1633,7 @@ struct iwl_mcc_update_cmd { ...@@ -1631,7 +1633,7 @@ struct iwl_mcc_update_cmd {
} __packed; /* LAR_UPDATE_MCC_CMD_API_S_VER_2 */ } __packed; /* LAR_UPDATE_MCC_CMD_API_S_VER_2 */
/** /**
* iwl_mcc_update_resp_v1 - response to MCC_UPDATE_CMD. * struct iwl_mcc_update_resp_v1 - response to MCC_UPDATE_CMD.
* Contains the new channel control profile map, if changed, and the new MCC * Contains the new channel control profile map, if changed, and the new MCC
* (mobile country code). * (mobile country code).
* The new MCC may be different than what was requested in MCC_UPDATE_CMD. * The new MCC may be different than what was requested in MCC_UPDATE_CMD.
...@@ -1654,7 +1656,7 @@ struct iwl_mcc_update_resp_v1 { ...@@ -1654,7 +1656,7 @@ struct iwl_mcc_update_resp_v1 {
} __packed; /* LAR_UPDATE_MCC_CMD_RESP_S_VER_1 */ } __packed; /* LAR_UPDATE_MCC_CMD_RESP_S_VER_1 */
/** /**
* iwl_mcc_update_resp - response to MCC_UPDATE_CMD. * struct iwl_mcc_update_resp - response to MCC_UPDATE_CMD.
* Contains the new channel control profile map, if changed, and the new MCC * Contains the new channel control profile map, if changed, and the new MCC
* (mobile country code). * (mobile country code).
* The new MCC may be different than what was requested in MCC_UPDATE_CMD. * The new MCC may be different than what was requested in MCC_UPDATE_CMD.
...@@ -1736,10 +1738,10 @@ enum iwl_dts_measurement_flags { ...@@ -1736,10 +1738,10 @@ enum iwl_dts_measurement_flags {
}; };
/** /**
* iwl_dts_measurement_cmd - request DTS temperature and/or voltage measurements * struct iwl_dts_measurement_cmd - request DTS temp and/or voltage measurements
* *
* @flags: indicates which measurements we want as specified in &enum * @flags: indicates which measurements we want as specified in
* iwl_dts_measurement_flags * &enum iwl_dts_measurement_flags
*/ */
struct iwl_dts_measurement_cmd { struct iwl_dts_measurement_cmd {
__le32 flags; __le32 flags;
...@@ -1791,7 +1793,7 @@ enum iwl_dts_bit_mode { ...@@ -1791,7 +1793,7 @@ enum iwl_dts_bit_mode {
}; };
/** /**
* iwl_ext_dts_measurement_cmd - request extended DTS temperature measurements * struct iwl_ext_dts_measurement_cmd - request extended DTS temp measurements
* @control_mode: see &enum iwl_dts_control_measurement_mode * @control_mode: see &enum iwl_dts_control_measurement_mode
* @temperature: used when over write DTS mode is selected * @temperature: used when over write DTS mode is selected
* @sensor: set temperature sensor to use. See &enum iwl_dts_used * @sensor: set temperature sensor to use. See &enum iwl_dts_used
...@@ -1871,7 +1873,7 @@ struct iwl_mvm_ctdp_cmd { ...@@ -1871,7 +1873,7 @@ struct iwl_mvm_ctdp_cmd {
#define IWL_MAX_DTS_TRIPS 8 #define IWL_MAX_DTS_TRIPS 8
/** /**
* struct iwl_temp_report_ths_cmd - set temperature thresholds * struct temp_report_ths_cmd - set temperature thresholds
* *
* @num_temps: number of temperature thresholds passed * @num_temps: number of temperature thresholds passed
* @thresholds: array with the thresholds to be configured * @thresholds: array with the thresholds to be configured
...@@ -1893,7 +1895,7 @@ enum iwl_tdls_channel_switch_type { ...@@ -1893,7 +1895,7 @@ enum iwl_tdls_channel_switch_type {
}; /* TDLS_STA_CHANNEL_SWITCH_CMD_TYPE_API_E_VER_1 */ }; /* TDLS_STA_CHANNEL_SWITCH_CMD_TYPE_API_E_VER_1 */
/** /**
* Switch timing sub-element in a TDLS channel-switch command * struct iwl_tdls_channel_switch_timing - Switch timing in TDLS channel-switch
* @frame_timestamp: GP2 timestamp of channel-switch request/response packet * @frame_timestamp: GP2 timestamp of channel-switch request/response packet
* received from peer * received from peer
* @max_offchan_duration: What amount of microseconds out of a DTIM is given * @max_offchan_duration: What amount of microseconds out of a DTIM is given
...@@ -1913,7 +1915,7 @@ struct iwl_tdls_channel_switch_timing { ...@@ -1913,7 +1915,7 @@ struct iwl_tdls_channel_switch_timing {
#define IWL_TDLS_CH_SW_FRAME_MAX_SIZE 200 #define IWL_TDLS_CH_SW_FRAME_MAX_SIZE 200
/** /**
* TDLS channel switch frame template * struct iwl_tdls_channel_switch_frame - TDLS channel switch frame template
* *
* A template representing a TDLS channel-switch request or response frame * A template representing a TDLS channel-switch request or response frame
* *
...@@ -1928,7 +1930,7 @@ struct iwl_tdls_channel_switch_frame { ...@@ -1928,7 +1930,7 @@ struct iwl_tdls_channel_switch_frame {
} __packed; /* TDLS_STA_CHANNEL_SWITCH_FRAME_API_S_VER_1 */ } __packed; /* TDLS_STA_CHANNEL_SWITCH_FRAME_API_S_VER_1 */
/** /**
* TDLS channel switch command * struct iwl_tdls_channel_switch_cmd - TDLS channel switch command
* *
* The command is sent to initiate a channel switch and also in response to * The command is sent to initiate a channel switch and also in response to
* incoming TDLS channel-switch request/response packets from remote peers. * incoming TDLS channel-switch request/response packets from remote peers.
...@@ -1948,7 +1950,7 @@ struct iwl_tdls_channel_switch_cmd { ...@@ -1948,7 +1950,7 @@ struct iwl_tdls_channel_switch_cmd {
} __packed; /* TDLS_STA_CHANNEL_SWITCH_CMD_API_S_VER_1 */ } __packed; /* TDLS_STA_CHANNEL_SWITCH_CMD_API_S_VER_1 */
/** /**
* TDLS channel switch start notification * struct iwl_tdls_channel_switch_notif - TDLS channel switch start notification
* *
* @status: non-zero on success * @status: non-zero on success
* @offchannel_duration: duration given in microseconds * @offchannel_duration: duration given in microseconds
...@@ -1961,7 +1963,7 @@ struct iwl_tdls_channel_switch_notif { ...@@ -1961,7 +1963,7 @@ struct iwl_tdls_channel_switch_notif {
} __packed; /* TDLS_STA_CHANNEL_SWITCH_NTFY_API_S_VER_1 */ } __packed; /* TDLS_STA_CHANNEL_SWITCH_NTFY_API_S_VER_1 */
/** /**
* TDLS station info * struct iwl_tdls_sta_info - TDLS station info
* *
* @sta_id: station id of the TDLS peer * @sta_id: station id of the TDLS peer
* @tx_to_peer_tid: TID reserved vs. the peer for FW based Tx * @tx_to_peer_tid: TID reserved vs. the peer for FW based Tx
...@@ -1976,7 +1978,7 @@ struct iwl_tdls_sta_info { ...@@ -1976,7 +1978,7 @@ struct iwl_tdls_sta_info {
} __packed; /* TDLS_STA_INFO_VER_1 */ } __packed; /* TDLS_STA_INFO_VER_1 */
/** /**
* TDLS basic config command * struct iwl_tdls_config_cmd - TDLS basic config command
* *
* @id_and_color: MAC id and color being configured * @id_and_color: MAC id and color being configured
* @tdls_peer_count: amount of currently connected TDLS peers * @tdls_peer_count: amount of currently connected TDLS peers
...@@ -2000,7 +2002,7 @@ struct iwl_tdls_config_cmd { ...@@ -2000,7 +2002,7 @@ struct iwl_tdls_config_cmd {
} __packed; /* TDLS_CONFIG_CMD_API_S_VER_1 */ } __packed; /* TDLS_CONFIG_CMD_API_S_VER_1 */
/** /**
* TDLS per-station config information from FW * struct iwl_tdls_config_sta_info_res - TDLS per-station config information
* *
* @sta_id: station id of the TDLS peer * @sta_id: station id of the TDLS peer
* @tx_to_peer_last_seq: last sequence number used by FW during FW-based Tx to * @tx_to_peer_last_seq: last sequence number used by FW during FW-based Tx to
...@@ -2012,7 +2014,7 @@ struct iwl_tdls_config_sta_info_res { ...@@ -2012,7 +2014,7 @@ struct iwl_tdls_config_sta_info_res {
} __packed; /* TDLS_STA_INFO_RSP_VER_1 */ } __packed; /* TDLS_STA_INFO_RSP_VER_1 */
/** /**
* TDLS config information from FW * struct iwl_tdls_config_res - TDLS config information from FW
* *
* @tx_to_ap_last_seq: last sequence number used by FW during FW-based Tx to AP * @tx_to_ap_last_seq: last sequence number used by FW during FW-based Tx to AP
* @sta_info: per-station TDLS config information * @sta_info: per-station TDLS config information
...@@ -2028,7 +2030,7 @@ struct iwl_tdls_config_res { ...@@ -2028,7 +2030,7 @@ struct iwl_tdls_config_res {
#define TX_FIFO_INTERNAL_MAX_NUM 6 #define TX_FIFO_INTERNAL_MAX_NUM 6
/** /**
* Shared memory configuration information from the FW * struct iwl_shared_mem_cfg_v1 - Shared memory configuration information
* *
* @shared_mem_addr: shared memory addr (pre 8000 HW set to 0x0 as MARBH is not * @shared_mem_addr: shared memory addr (pre 8000 HW set to 0x0 as MARBH is not
* accessible) * accessible)
...@@ -2082,7 +2084,7 @@ struct iwl_shared_mem_lmac_cfg { ...@@ -2082,7 +2084,7 @@ struct iwl_shared_mem_lmac_cfg {
} __packed; /* SHARED_MEM_ALLOC_LMAC_API_S_VER_1 */ } __packed; /* SHARED_MEM_ALLOC_LMAC_API_S_VER_1 */
/** /**
* Shared memory configuration information from the FW * struct iwl_shared_mem_cfg - Shared memory configuration information
* *
* @shared_mem_addr: shared memory address * @shared_mem_addr: shared memory address
* @shared_mem_size: shared memory size * @shared_mem_size: shared memory size
...@@ -2110,7 +2112,7 @@ struct iwl_shared_mem_cfg { ...@@ -2110,7 +2112,7 @@ struct iwl_shared_mem_cfg {
} __packed; /* SHARED_MEM_ALLOC_API_S_VER_3 */ } __packed; /* SHARED_MEM_ALLOC_API_S_VER_3 */
/** /**
* VHT MU-MIMO group configuration * struct iwl_mu_group_mgmt_cmd - VHT MU-MIMO group configuration
* *
* @membership_status: a bitmap of MU groups * @membership_status: a bitmap of MU groups
* @user_position:the position of station in a group. If the station is in the * @user_position:the position of station in a group. If the station is in the
...@@ -2137,7 +2139,7 @@ struct iwl_mu_group_mgmt_notif { ...@@ -2137,7 +2139,7 @@ struct iwl_mu_group_mgmt_notif {
#define MAX_STORED_BEACON_SIZE 600 #define MAX_STORED_BEACON_SIZE 600
/** /**
* Stored beacon notification * struct iwl_stored_beacon_notif - Stored beacon notification
* *
* @system_time: system time on air rise * @system_time: system time on air rise
* @tsf: TSF on air rise * @tsf: TSF on air rise
...@@ -2172,7 +2174,7 @@ enum iwl_lqm_status { ...@@ -2172,7 +2174,7 @@ enum iwl_lqm_status {
}; };
/** /**
* Link Quality Measurement command * struct iwl_link_qual_msrmnt_cmd - Link Quality Measurement command
* @cmd_operatrion: command operation to be performed (start or stop) * @cmd_operatrion: command operation to be performed (start or stop)
* as defined above. * as defined above.
* @mac_id: MAC ID the measurement applies to. * @mac_id: MAC ID the measurement applies to.
...@@ -2187,7 +2189,7 @@ struct iwl_link_qual_msrmnt_cmd { ...@@ -2187,7 +2189,7 @@ struct iwl_link_qual_msrmnt_cmd {
} __packed /* LQM_CMD_API_S_VER_1 */; } __packed /* LQM_CMD_API_S_VER_1 */;
/** /**
* Link Quality Measurement notification * struct iwl_link_qual_msrmnt_notif - Link Quality Measurement notification
* *
* @frequent_stations_air_time: an array containing the total air time * @frequent_stations_air_time: an array containing the total air time
* (in uSec) used by the most frequently transmitting stations. * (in uSec) used by the most frequently transmitting stations.
...@@ -2215,7 +2217,7 @@ struct iwl_link_qual_msrmnt_notif { ...@@ -2215,7 +2217,7 @@ struct iwl_link_qual_msrmnt_notif {
} __packed; /* LQM_MEASUREMENT_COMPLETE_NTF_API_S_VER1 */ } __packed; /* LQM_MEASUREMENT_COMPLETE_NTF_API_S_VER1 */
/** /**
* Channel switch NOA notification * struct iwl_channel_switch_noa_notif - Channel switch NOA notification
* *
* @id_and_color: ID and color of the MAC * @id_and_color: ID and color of the MAC
*/ */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment