iwlwifi: mvm: fix some kernel-doc (31a658b2) · Commits · e / devices / android_kernel_xiaomi_nabu

drivers/net/wireless/intel/iwlwifi/iwl-fw-file.h

+2 −2

Original line number	Diff line number	Diff line
		@@ -395,8 +395,8 @@ enum iwl_ucode_tlv_capa {
		#define IWL_UCODE_API(ver) (((ver) & 0x0000FF00) >> 8)
		#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.
		* @flow_trigger: bitmap for which calibrations to perform according to
		* flow triggers.

drivers/net/wireless/intel/iwlwifi/mvm/fw-api-rx.h

+4 −3

Original line number	Diff line number	Diff line
		@@ -147,7 +147,8 @@ enum iwl_csum_rx_assist_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 {
		__le16 byte_count;
		@@ -447,7 +448,7 @@ struct iwl_rxq_sync_notification {
		} __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_NOTIF_DEL_BA: notify RSS queues of delBA
		@@ -491,7 +492,7 @@ enum iwl_mvm_pm_event {
		/**
		* struct iwl_mvm_pm_state_notification - station PM state notification
		* @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 {
		u8 sta_id;

drivers/net/wireless/intel/iwlwifi/mvm/fw-api-scan.h

+16 −16

Original line number	Diff line number	Diff line
		@@ -7,7 +7,7 @@
		*
		* Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
		* 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
		* it under the terms of version 2 of the GNU General Public License as
		@@ -34,6 +34,7 @@
		*
		* Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
		* Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
		* Copyright(c) 2016 - 2017 Intel Deutschland GmbH
		* All rights reserved.
		*
		* Redistribution and use in source and binary forms, with or without
		@@ -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
		* @reported_rssi: AP rssi reported to the host
		* @client_bitmap: clients ignore this entry - enum scan_framework_client
		@@ -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
		* @unicast_cipher: encryption algorithm to match - bitmap
		* @aut_alg: authentication algorithm to match - bitmap
		@@ -154,8 +155,7 @@ struct iwl_scan_offload_profile {
		} __packed;

		/**
		* iwl_scan_offload_profile_cfg - SCAN_OFFLOAD_PROFILES_CFG_API_S_VER_1
		* @blaclist: AP list to filter off from scan results
		* struct iwl_scan_offload_profile_cfg - SCAN_OFFLOAD_PROFILES_CFG_API_S_VER_1
		* @profiles: profiles to search for match
		* @blacklist_len: length of blacklist
		* @num_profiles: num of profiles in the list
		@@ -176,7 +176,7 @@ struct iwl_scan_offload_profile_cfg {
		} __packed;

		/**
		* iwl_scan_schedule_lmac - schedule of scan offload
		* struct iwl_scan_schedule_lmac - schedule of scan offload
		* @delay: delay between iterations, in seconds.
		* @iterations: num of scan iterations
		* @full_scan_mul: number of partial scans before each full scan
		@@ -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_*
		* @rate_n_flags: rate for all Tx attempts, if TX_CMD_FLG_STA_RATE_MSK is
		* cleared. Combination of RATE_MCS_*
		@@ -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
		* other bits &enum iwl_scan_channel_flags_lmac
		* @channel_number: channel number 1-13 etc
		@@ -235,7 +235,7 @@ struct iwl_scan_channel_cfg_lmac {
		} __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
		* @len: length of the segment
		*/
		@@ -263,7 +263,7 @@ enum iwl_scan_channel_flags {
		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
		* @non_ebs_ratio: defines the ratio of number of scan iterations where EBS is
		* involved.
		@@ -276,7 +276,7 @@ struct iwl_scan_channel_opt {
		} __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
		* without filtering.
		* @IWL_MVM_LMAC_SCAN_FLAG_PASSIVE: force passive scan on all channels
		@@ -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
		* @channel_num: num of channels to scan
		* @active-dwell: dwell time for active channels
		@@ -410,7 +410,7 @@ struct iwl_lmac_scan_complete_notif {
		} __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_iteration: last scan iteration executed before scan abort
		* @status: enum iwl_scan_offload_complete_status
		@@ -547,7 +547,7 @@ struct iwl_scan_config {
		} __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
		* can be preempted by other scan requests with higher priority.
		* The low priority scan will be resumed when the higher proirity scan is

drivers/net/wireless/intel/iwlwifi/mvm/fw-api-sta.h

+12 −10

Original line number	Diff line number	Diff line
		@@ -223,7 +223,7 @@ enum iwl_sta_sleep_flag {

		/**
		* 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_ttak: 10-byte unicast TKIP TTAK for Rx
		* @key_offset: key offset in the fw's key table
		@@ -258,12 +258,13 @@ struct iwl_mvm_keyinfo {
		* @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.
		* @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
		* @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave
		* alone. 1 - modify, 0 - don't change.
		* @station_flags: look at %iwl_sta_flags
		* @station_flags_msk: what of %station_flags have changed
		* @station_flags: look at &enum iwl_sta_flags
		* @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)
		* Set %STA_MODIFY_ADD_BA_TID to use this field, and also set
		* add_immediate_ba_ssn.
		@@ -274,7 +275,7 @@ struct iwl_mvm_keyinfo {
		* @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
		* 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
		* mac-addr.
		* @beamform_flags: beam forming controls
		@@ -335,12 +336,13 @@ enum iwl_sta_type {
		* @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.
		* @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
		* @modify_mask: STA_MODIFY_*, selects which parameters to modify vs. leave
		* alone. 1 - modify, 0 - don't change.
		* @station_flags: look at %iwl_sta_flags
		* @station_flags_msk: what of %station_flags have changed
		* @station_flags: look at &enum iwl_sta_flags
		* @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)
		* Set %STA_MODIFY_ADD_BA_TID to use this field, and also set
		* add_immediate_ba_ssn.
		@@ -352,7 +354,7 @@ enum iwl_sta_type {
		* asleep. Used to synchronise PS-poll and u-APSD responses while ucode
		* keeps track of STA sleep state.
		* @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
		* mac-addr.
		* @beamform_flags: beam forming controls
		@@ -401,7 +403,7 @@ struct iwl_mvm_add_sta_cmd {
		* ( REPLY_ADD_STA_KEY = 0x17 )
		* @sta_id: index of station in uCode's station table
		* @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
		* @rx_secur_seq_cnt: RX security sequence counter for the key
		*/

drivers/net/wireless/intel/iwlwifi/mvm/fw-api-tx.h

+11 −6

Original line number	Diff line number	Diff line
		@@ -595,9 +595,10 @@ struct iwl_mvm_tx_resp {
		* struct iwl_mvm_ba_notif - notifies about reception of BA
		* ( BA_NOTIF = 0xc5 )
		* @sta_addr: MAC address
		* @reserved: reserved
		* @sta_id: Index of recipient (BA-sending) station in fw's station table
		* @tid: tid of the session
		* @seq_ctl:
		* @seq_ctl: sequence control field
		* @bitmap: the bitmap of the BA notification as seen in the air
		* @scd_flow: the tx queue this BA relates to
		* @scd_ssn: the index of the last contiguously sent packet
		@@ -606,6 +607,7 @@ struct iwl_mvm_tx_resp {
		* @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
		* for Tx-ing then this value will be set to 0 by FW.
		* @reserved1: reserved
		*/
		struct iwl_mvm_ba_notif {
		u8 sta_addr[ETH_ALEN];
		@@ -628,13 +630,13 @@ struct iwl_mvm_ba_notif {
		* @q_num: TFD queue number
		* @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
		* @reserved: reserved for alignment
		*/
		struct iwl_mvm_compressed_ba_tfd {
		__le16 q_num;
		__le16 tfd_index;
		u8 scd_queue;
		u8 reserved;
		__le16 reserved2;
		u8 reserved[3];
		} __packed; /* COMPRESSED_BA_TFD_API_S_VER_1 */

		/**
		@@ -682,11 +684,12 @@ enum iwl_mvm_ba_resp_flags {
		* @query_frame_cnt: SCD query frame count
		* @txed: number of frames sent in the aggregation (all-TIDs)
		* @done: number of frames that were Acked by the BA (all-TIDs)
		* @reserved: reserved (for alignment)
		* @wireless_time: Wireless-media time
		* @tx_rate: the rate the aggregation was sent at
		* @tfd_cnt: number of TFD-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.
		* @ra_tid: array of RA-TID queue status updates. For debug purposes only. See
		* &iwl_mvm_compressed_ba_ratid for more details.
		@@ -760,6 +763,7 @@ struct iwl_mac_beacon_cmd_v7 {
		* struct iwl_mac_beacon_cmd - beacon template command with offloaded CSA
		* @byte_cnt: byte count of the beacon frame
		* @flags: for future use
		* @reserved: reserved
		* @data: see &iwl_mac_beacon_cmd_data
		*/
		struct iwl_mac_beacon_cmd {
		@@ -819,9 +823,9 @@ enum iwl_scd_cfg_actions {

		/**
		* struct iwl_scd_txq_cfg_cmd - New txq hw scheduler config command
		* @token:
		* @token: unused
		* @sta_id: station id
		* @tid:
		* @tid: TID
		* @scd_queue: scheduler queue to confiug
		* @action: 1 queue enable, 0 queue disable, 2 change txq's tid owner
		* Value is one of %iwl_scd_cfg_actions options
		@@ -829,6 +833,7 @@ enum iwl_scd_cfg_actions {
		* @tx_fifo: %enum iwl_mvm_tx_fifo
		* @window: BA window size
		* @ssn: SSN for the BA agreement
		* @reserved: reserved
		*/
		struct iwl_scd_txq_cfg_cmd {
		u8 token;