| /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ |
| /* |
| * Copyright (C) 2015-2017 Intel Deutschland GmbH |
| * Copyright (C) 2018-2021 Intel Corporation |
| */ |
| #ifndef __iwl_fw_api_location_h__ |
| #define __iwl_fw_api_location_h__ |
| |
| /** |
| * enum iwl_location_subcmd_ids - location group command IDs |
| */ |
| enum iwl_location_subcmd_ids { |
| /** |
| * @TOF_RANGE_REQ_CMD: TOF ranging request, |
| * uses one of &struct iwl_tof_range_req_cmd_v5, |
| * &struct iwl_tof_range_req_cmd_v7, |
| * &struct iwl_tof_range_req_cmd_v8, |
| * &struct iwl_tof_range_req_cmd_v9, |
| * &struct iwl_tof_range_req_cmd_v11, |
| * &struct iwl_tof_range_req_cmd_v7 |
| */ |
| TOF_RANGE_REQ_CMD = 0x0, |
| /** |
| * @TOF_CONFIG_CMD: TOF configuration, uses &struct iwl_tof_config_cmd |
| */ |
| TOF_CONFIG_CMD = 0x1, |
| /** |
| * @TOF_RANGE_ABORT_CMD: abort ongoing ranging, uses |
| * &struct iwl_tof_range_abort_cmd |
| */ |
| TOF_RANGE_ABORT_CMD = 0x2, |
| /** |
| * @TOF_RANGE_REQ_EXT_CMD: TOF extended ranging config, |
| * uses &struct iwl_tof_range_req_ext_cmd |
| */ |
| TOF_RANGE_REQ_EXT_CMD = 0x3, |
| /** |
| * @TOF_RESPONDER_CONFIG_CMD: FTM responder configuration, |
| * uses &struct iwl_tof_responder_config_cmd |
| */ |
| TOF_RESPONDER_CONFIG_CMD = 0x4, |
| /** |
| * @TOF_RESPONDER_DYN_CONFIG_CMD: FTM dynamic configuration, |
| * uses &struct iwl_tof_responder_dyn_config_cmd |
| */ |
| TOF_RESPONDER_DYN_CONFIG_CMD = 0x5, |
| /** |
| * @CSI_HEADER_NOTIFICATION: CSI header |
| */ |
| CSI_HEADER_NOTIFICATION = 0xFA, |
| /** |
| * @CSI_CHUNKS_NOTIFICATION: CSI chunk, |
| * uses &struct iwl_csi_chunk_notification |
| */ |
| CSI_CHUNKS_NOTIFICATION = 0xFB, |
| /** |
| * @TOF_LC_NOTIF: used for LCI/civic location, contains just |
| * the action frame |
| */ |
| TOF_LC_NOTIF = 0xFC, |
| /** |
| * @TOF_RESPONDER_STATS: FTM responder statistics notification, |
| * uses &struct iwl_ftm_responder_stats |
| */ |
| TOF_RESPONDER_STATS = 0xFD, |
| /** |
| * @TOF_MCSI_DEBUG_NOTIF: MCSI debug notification, uses |
| * &struct iwl_tof_mcsi_notif |
| */ |
| TOF_MCSI_DEBUG_NOTIF = 0xFE, |
| /** |
| * @TOF_RANGE_RESPONSE_NOTIF: ranging response, using |
| * &struct iwl_tof_range_rsp_ntfy |
| */ |
| TOF_RANGE_RESPONSE_NOTIF = 0xFF, |
| }; |
| |
| /** |
| * struct iwl_tof_config_cmd - ToF configuration |
| * @tof_disabled: indicates if ToF is disabled (or not) |
| * @one_sided_disabled: indicates if one-sided is disabled (or not) |
| * @is_debug_mode: indiciates if debug mode is active |
| * @is_buf_required: indicates if channel estimation buffer is required |
| */ |
| struct iwl_tof_config_cmd { |
| u8 tof_disabled; |
| u8 one_sided_disabled; |
| u8 is_debug_mode; |
| u8 is_buf_required; |
| } __packed; |
| |
| /** |
| * enum iwl_tof_bandwidth - values for iwl_tof_range_req_ap_entry.bandwidth |
| * @IWL_TOF_BW_20_LEGACY: 20 MHz non-HT |
| * @IWL_TOF_BW_20_HT: 20 MHz HT |
| * @IWL_TOF_BW_40: 40 MHz |
| * @IWL_TOF_BW_80: 80 MHz |
| * @IWL_TOF_BW_160: 160 MHz |
| * @IWL_TOF_BW_NUM: number of tof bandwidths |
| */ |
| enum iwl_tof_bandwidth { |
| IWL_TOF_BW_20_LEGACY, |
| IWL_TOF_BW_20_HT, |
| IWL_TOF_BW_40, |
| IWL_TOF_BW_80, |
| IWL_TOF_BW_160, |
| IWL_TOF_BW_NUM, |
| }; /* LOCAT_BW_TYPE_E */ |
| |
| /* |
| * enum iwl_tof_algo_type - Algorithym type for range measurement request |
| */ |
| enum iwl_tof_algo_type { |
| IWL_TOF_ALGO_TYPE_MAX_LIKE = 0, |
| IWL_TOF_ALGO_TYPE_LINEAR_REG = 1, |
| IWL_TOF_ALGO_TYPE_FFT = 2, |
| |
| /* Keep last */ |
| IWL_TOF_ALGO_TYPE_INVALID, |
| }; /* ALGO_TYPE_E */ |
| |
| /* |
| * enum iwl_tof_mcsi_ntfy - Enable/Disable MCSI notifications |
| */ |
| enum iwl_tof_mcsi_enable { |
| IWL_TOF_MCSI_DISABLED = 0, |
| IWL_TOF_MCSI_ENABLED = 1, |
| }; /* MCSI_ENABLE_E */ |
| |
| /** |
| * enum iwl_tof_responder_cmd_valid_field - valid fields in the responder cfg |
| * @IWL_TOF_RESPONDER_CMD_VALID_CHAN_INFO: channel info is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_TOA_OFFSET: ToA offset is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_COMMON_CALIB: common calibration mode is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_SPECIFIC_CALIB: spefici calibration mode is |
| * valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_BSSID: BSSID is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_TX_ANT: TX antenna is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_ALGO_TYPE: algorithm type is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_NON_ASAP_SUPPORT: non-ASAP support is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_STATISTICS_REPORT_SUPPORT: statistics report |
| * support is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_MCSI_NOTIF_SUPPORT: MCSI notification support |
| * is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_FAST_ALGO_SUPPORT: fast algorithm support |
| * is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_RETRY_ON_ALGO_FAIL: retry on algorithm failure |
| * is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_STA_ID: station ID is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_NDP_SUPPORT: enable/disable NDP ranging support |
| * is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_NDP_PARAMS: NDP parameters are valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_LMR_FEEDBACK: LMR feedback support is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_SESSION_ID: session id flag is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_BSS_COLOR: the bss_color field is valid |
| * @IWL_TOF_RESPONDER_CMD_VALID_MIN_MAX_TIME_BETWEEN_MSR: the |
| * min_time_between_msr and max_time_between_msr fields are valid |
| */ |
| enum iwl_tof_responder_cmd_valid_field { |
| IWL_TOF_RESPONDER_CMD_VALID_CHAN_INFO = BIT(0), |
| IWL_TOF_RESPONDER_CMD_VALID_TOA_OFFSET = BIT(1), |
| IWL_TOF_RESPONDER_CMD_VALID_COMMON_CALIB = BIT(2), |
| IWL_TOF_RESPONDER_CMD_VALID_SPECIFIC_CALIB = BIT(3), |
| IWL_TOF_RESPONDER_CMD_VALID_BSSID = BIT(4), |
| IWL_TOF_RESPONDER_CMD_VALID_TX_ANT = BIT(5), |
| IWL_TOF_RESPONDER_CMD_VALID_ALGO_TYPE = BIT(6), |
| IWL_TOF_RESPONDER_CMD_VALID_NON_ASAP_SUPPORT = BIT(7), |
| IWL_TOF_RESPONDER_CMD_VALID_STATISTICS_REPORT_SUPPORT = BIT(8), |
| IWL_TOF_RESPONDER_CMD_VALID_MCSI_NOTIF_SUPPORT = BIT(9), |
| IWL_TOF_RESPONDER_CMD_VALID_FAST_ALGO_SUPPORT = BIT(10), |
| IWL_TOF_RESPONDER_CMD_VALID_RETRY_ON_ALGO_FAIL = BIT(11), |
| IWL_TOF_RESPONDER_CMD_VALID_STA_ID = BIT(12), |
| IWL_TOF_RESPONDER_CMD_VALID_NDP_SUPPORT = BIT(22), |
| IWL_TOF_RESPONDER_CMD_VALID_NDP_PARAMS = BIT(23), |
| IWL_TOF_RESPONDER_CMD_VALID_LMR_FEEDBACK = BIT(24), |
| IWL_TOF_RESPONDER_CMD_VALID_SESSION_ID = BIT(25), |
| IWL_TOF_RESPONDER_CMD_VALID_BSS_COLOR = BIT(26), |
| IWL_TOF_RESPONDER_CMD_VALID_MIN_MAX_TIME_BETWEEN_MSR = BIT(27), |
| }; |
| |
| /** |
| * enum iwl_tof_responder_cfg_flags - responder configuration flags |
| * @IWL_TOF_RESPONDER_FLAGS_NON_ASAP_SUPPORT: non-ASAP support |
| * @IWL_TOF_RESPONDER_FLAGS_REPORT_STATISTICS: report statistics |
| * @IWL_TOF_RESPONDER_FLAGS_REPORT_MCSI: report MCSI |
| * @IWL_TOF_RESPONDER_FLAGS_ALGO_TYPE: algorithm type |
| * @IWL_TOF_RESPONDER_FLAGS_TOA_OFFSET_MODE: ToA offset mode |
| * @IWL_TOF_RESPONDER_FLAGS_COMMON_CALIB_MODE: common calibration mode |
| * @IWL_TOF_RESPONDER_FLAGS_SPECIFIC_CALIB_MODE: specific calibration mode |
| * @IWL_TOF_RESPONDER_FLAGS_FAST_ALGO_SUPPORT: fast algorithm support |
| * @IWL_TOF_RESPONDER_FLAGS_RETRY_ON_ALGO_FAIL: retry on algorithm fail |
| * @IWL_TOF_RESPONDER_FLAGS_FTM_TX_ANT: TX antenna mask |
| * @IWL_TOF_RESPONDER_FLAGS_NDP_SUPPORT: support NDP ranging |
| * @IWL_TOF_RESPONDER_FLAGS_LMR_FEEDBACK: request for LMR feedback if the |
| * initiator supports it |
| * @IWL_TOF_RESPONDER_FLAGS_SESSION_ID: send the session id in the initial FTM |
| * frame. |
| */ |
| enum iwl_tof_responder_cfg_flags { |
| IWL_TOF_RESPONDER_FLAGS_NON_ASAP_SUPPORT = BIT(0), |
| IWL_TOF_RESPONDER_FLAGS_REPORT_STATISTICS = BIT(1), |
| IWL_TOF_RESPONDER_FLAGS_REPORT_MCSI = BIT(2), |
| IWL_TOF_RESPONDER_FLAGS_ALGO_TYPE = BIT(3) | BIT(4) | BIT(5), |
| IWL_TOF_RESPONDER_FLAGS_TOA_OFFSET_MODE = BIT(6), |
| IWL_TOF_RESPONDER_FLAGS_COMMON_CALIB_MODE = BIT(7), |
| IWL_TOF_RESPONDER_FLAGS_SPECIFIC_CALIB_MODE = BIT(8), |
| IWL_TOF_RESPONDER_FLAGS_FAST_ALGO_SUPPORT = BIT(9), |
| IWL_TOF_RESPONDER_FLAGS_RETRY_ON_ALGO_FAIL = BIT(10), |
| IWL_TOF_RESPONDER_FLAGS_FTM_TX_ANT = RATE_MCS_ANT_AB_MSK, |
| IWL_TOF_RESPONDER_FLAGS_NDP_SUPPORT = BIT(24), |
| IWL_TOF_RESPONDER_FLAGS_LMR_FEEDBACK = BIT(25), |
| IWL_TOF_RESPONDER_FLAGS_SESSION_ID = BIT(27), |
| }; |
| |
| /** |
| * struct iwl_tof_responder_config_cmd_v6 - ToF AP mode (for debug) |
| * @cmd_valid_fields: &iwl_tof_responder_cmd_valid_field |
| * @responder_cfg_flags: &iwl_tof_responder_cfg_flags |
| * @bandwidth: current AP Bandwidth: &enum iwl_tof_bandwidth |
| * @rate: current AP rate |
| * @channel_num: current AP Channel |
| * @ctrl_ch_position: coding of the control channel position relative to |
| * the center frequency, see iwl_mvm_get_ctrl_pos() |
| * @sta_id: index of the AP STA when in AP mode |
| * @reserved1: reserved |
| * @toa_offset: Artificial addition [pSec] for the ToA - to be used for debug |
| * purposes, simulating station movement by adding various values |
| * to this field |
| * @common_calib: XVT: common calibration value |
| * @specific_calib: XVT: specific calibration value |
| * @bssid: Current AP BSSID |
| * @reserved2: reserved |
| */ |
| struct iwl_tof_responder_config_cmd_v6 { |
| __le32 cmd_valid_fields; |
| __le32 responder_cfg_flags; |
| u8 bandwidth; |
| u8 rate; |
| u8 channel_num; |
| u8 ctrl_ch_position; |
| u8 sta_id; |
| u8 reserved1; |
| __le16 toa_offset; |
| __le16 common_calib; |
| __le16 specific_calib; |
| u8 bssid[ETH_ALEN]; |
| __le16 reserved2; |
| } __packed; /* TOF_RESPONDER_CONFIG_CMD_API_S_VER_6 */ |
| |
| /** |
| * struct iwl_tof_responder_config_cmd_v7 - ToF AP mode (for debug) |
| * @cmd_valid_fields: &iwl_tof_responder_cmd_valid_field |
| * @responder_cfg_flags: &iwl_tof_responder_cfg_flags |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @rate: current AP rate |
| * @channel_num: current AP Channel |
| * @ctrl_ch_position: coding of the control channel position relative to |
| * the center frequency, see iwl_mvm_get_ctrl_pos() |
| * @sta_id: index of the AP STA when in AP mode |
| * @reserved1: reserved |
| * @toa_offset: Artificial addition [pSec] for the ToA - to be used for debug |
| * purposes, simulating station movement by adding various values |
| * to this field |
| * @common_calib: XVT: common calibration value |
| * @specific_calib: XVT: specific calibration value |
| * @bssid: Current AP BSSID |
| * @reserved2: reserved |
| */ |
| struct iwl_tof_responder_config_cmd_v7 { |
| __le32 cmd_valid_fields; |
| __le32 responder_cfg_flags; |
| u8 format_bw; |
| u8 rate; |
| u8 channel_num; |
| u8 ctrl_ch_position; |
| u8 sta_id; |
| u8 reserved1; |
| __le16 toa_offset; |
| __le16 common_calib; |
| __le16 specific_calib; |
| u8 bssid[ETH_ALEN]; |
| __le16 reserved2; |
| } __packed; /* TOF_RESPONDER_CONFIG_CMD_API_S_VER_7 */ |
| |
| #define IWL_RESPONDER_STS_POS 3 |
| #define IWL_RESPONDER_TOTAL_LTF_POS 6 |
| |
| /** |
| * struct iwl_tof_responder_config_cmd_v8 - ToF AP mode (for debug) |
| * @cmd_valid_fields: &iwl_tof_responder_cmd_valid_field |
| * @responder_cfg_flags: &iwl_tof_responder_cfg_flags |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @rate: current AP rate |
| * @channel_num: current AP Channel |
| * @ctrl_ch_position: coding of the control channel position relative to |
| * the center frequency, see iwl_mvm_get_ctrl_pos() |
| * @sta_id: index of the AP STA when in AP mode |
| * @reserved1: reserved |
| * @toa_offset: Artificial addition [pSec] for the ToA - to be used for debug |
| * purposes, simulating station movement by adding various values |
| * to this field |
| * @common_calib: XVT: common calibration value |
| * @specific_calib: XVT: specific calibration value |
| * @bssid: Current AP BSSID |
| * @r2i_ndp_params: parameters for R2I NDP. |
| * bits 0 - 2: max number of LTF repetitions |
| * bits 3 - 5: max number of spatial streams (supported values are < 2) |
| * bits 6 - 7: max number of total LTFs see |
| * &enum ieee80211_range_params_max_total_ltf |
| * @i2r_ndp_params: parameters for I2R NDP. |
| * bits 0 - 2: max number of LTF repetitions |
| * bits 3 - 5: max number of spatial streams |
| * bits 6 - 7: max number of total LTFs see |
| * &enum ieee80211_range_params_max_total_ltf |
| */ |
| struct iwl_tof_responder_config_cmd_v8 { |
| __le32 cmd_valid_fields; |
| __le32 responder_cfg_flags; |
| u8 format_bw; |
| u8 rate; |
| u8 channel_num; |
| u8 ctrl_ch_position; |
| u8 sta_id; |
| u8 reserved1; |
| __le16 toa_offset; |
| __le16 common_calib; |
| __le16 specific_calib; |
| u8 bssid[ETH_ALEN]; |
| u8 r2i_ndp_params; |
| u8 i2r_ndp_params; |
| } __packed; /* TOF_RESPONDER_CONFIG_CMD_API_S_VER_8 */ |
| |
| /** |
| * struct iwl_tof_responder_config_cmd_v9 - ToF AP mode (for debug) |
| * @cmd_valid_fields: &iwl_tof_responder_cmd_valid_field |
| * @responder_cfg_flags: &iwl_tof_responder_cfg_flags |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @bss_color: current AP bss_color |
| * @channel_num: current AP Channel |
| * @ctrl_ch_position: coding of the control channel position relative to |
| * the center frequency, see iwl_mvm_get_ctrl_pos() |
| * @sta_id: index of the AP STA when in AP mode |
| * @reserved1: reserved |
| * @toa_offset: Artificial addition [pSec] for the ToA - to be used for debug |
| * purposes, simulating station movement by adding various values |
| * to this field |
| * @common_calib: XVT: common calibration value |
| * @specific_calib: XVT: specific calibration value |
| * @bssid: Current AP BSSID |
| * @r2i_ndp_params: parameters for R2I NDP. |
| * bits 0 - 2: max number of LTF repetitions |
| * bits 3 - 5: max number of spatial streams (supported values are < 2) |
| * bits 6 - 7: max number of total LTFs see |
| * &enum ieee80211_range_params_max_total_ltf |
| * @i2r_ndp_params: parameters for I2R NDP. |
| * bits 0 - 2: max number of LTF repetitions |
| * bits 3 - 5: max number of spatial streams |
| * bits 6 - 7: max number of total LTFs see |
| * &enum ieee80211_range_params_max_total_ltf |
| * @min_time_between_msr: for non trigger based NDP ranging, minimum time |
| * between measurements in milliseconds. |
| * @max_time_between_msr: for non trigger based NDP ranging, maximum time |
| * between measurements in milliseconds. |
| */ |
| struct iwl_tof_responder_config_cmd_v9 { |
| __le32 cmd_valid_fields; |
| __le32 responder_cfg_flags; |
| u8 format_bw; |
| u8 bss_color; |
| u8 channel_num; |
| u8 ctrl_ch_position; |
| u8 sta_id; |
| u8 reserved1; |
| __le16 toa_offset; |
| __le16 common_calib; |
| __le16 specific_calib; |
| u8 bssid[ETH_ALEN]; |
| u8 r2i_ndp_params; |
| u8 i2r_ndp_params; |
| __le16 min_time_between_msr; |
| __le16 max_time_between_msr; |
| } __packed; /* TOF_RESPONDER_CONFIG_CMD_API_S_VER_8 */ |
| |
| #define IWL_LCI_CIVIC_IE_MAX_SIZE 400 |
| |
| /** |
| * struct iwl_tof_responder_dyn_config_cmd - Dynamic responder settings |
| * @lci_len: The length of the 1st (LCI) part in the @lci_civic buffer |
| * @civic_len: The length of the 2nd (CIVIC) part in the @lci_civic buffer |
| * @lci_civic: The LCI/CIVIC buffer. LCI data (if exists) comes first, then, if |
| * needed, 0-padding such that the next part is dword-aligned, then CIVIC |
| * data (if exists) follows, and then 0-padding again to complete a |
| * 4-multiple long buffer. |
| */ |
| struct iwl_tof_responder_dyn_config_cmd_v2 { |
| __le32 lci_len; |
| __le32 civic_len; |
| u8 lci_civic[]; |
| } __packed; /* TOF_RESPONDER_DYN_CONFIG_CMD_API_S_VER_2 */ |
| |
| #define IWL_LCI_MAX_SIZE 160 |
| #define IWL_CIVIC_MAX_SIZE 160 |
| #define HLTK_11AZ_LEN 32 |
| |
| /** |
| * enum iwl_responder_dyn_cfg_valid_flags - valid flags for dyn_config_cmd |
| * @IWL_RESPONDER_DYN_CFG_VALID_LCI: LCI data is valid |
| * @IWL_RESPONDER_DYN_CFG_VALID_CIVIC: Civic data is valid |
| * @IWL_RESPONDER_DYN_CFG_VALID_PASN_STA: the pasn_addr, HLTK and cipher fields |
| * are valid. |
| */ |
| enum iwl_responder_dyn_cfg_valid_flags { |
| IWL_RESPONDER_DYN_CFG_VALID_LCI = BIT(0), |
| IWL_RESPONDER_DYN_CFG_VALID_CIVIC = BIT(1), |
| IWL_RESPONDER_DYN_CFG_VALID_PASN_STA = BIT(2), |
| }; |
| |
| /** |
| * struct iwl_tof_responder_dyn_config_cmd - Dynamic responder settings |
| * @cipher: The negotiated cipher. see &enum iwl_location_cipher. |
| * @valid_flags: flags indicating which fields in the command are valid. see |
| * &enum iwl_responder_dyn_cfg_valid_flags. |
| * @lci_len: length of the LCI data in bytes |
| * @civic_len: length of the Civic data in bytes |
| * @lci_buf: the LCI buffer |
| * @civic_buf: the Civic buffer |
| * @hltk_buf: HLTK for secure LTF bits generation for the specified station |
| * @addr: mac address of the station for which to use the HLTK |
| * @reserved: for alignment |
| */ |
| struct iwl_tof_responder_dyn_config_cmd { |
| u8 cipher; |
| u8 valid_flags; |
| u8 lci_len; |
| u8 civic_len; |
| u8 lci_buf[IWL_LCI_MAX_SIZE]; |
| u8 civic_buf[IWL_LCI_MAX_SIZE]; |
| u8 hltk_buf[HLTK_11AZ_LEN]; |
| u8 addr[ETH_ALEN]; |
| u8 reserved[2]; |
| } __packed; /* TOF_RESPONDER_DYN_CONFIG_CMD_API_S_VER_3 */ |
| |
| /** |
| * struct iwl_tof_range_req_ext_cmd - extended range req for WLS |
| * @tsf_timer_offset_msec: the recommended time offset (mSec) from the AP's TSF |
| * @reserved: reserved |
| * @min_delta_ftm: Minimal time between two consecutive measurements, |
| * in units of 100us. 0 means no preference by station |
| * @ftm_format_and_bw20M: FTM Channel Spacing/Format for 20MHz: recommended |
| * value be sent to the AP |
| * @ftm_format_and_bw40M: FTM Channel Spacing/Format for 40MHz: recommended |
| * value to be sent to the AP |
| * @ftm_format_and_bw80M: FTM Channel Spacing/Format for 80MHz: recommended |
| * value to be sent to the AP |
| */ |
| struct iwl_tof_range_req_ext_cmd { |
| __le16 tsf_timer_offset_msec; |
| __le16 reserved; |
| u8 min_delta_ftm; |
| u8 ftm_format_and_bw20M; |
| u8 ftm_format_and_bw40M; |
| u8 ftm_format_and_bw80M; |
| } __packed; |
| |
| /** |
| * enum iwl_tof_location_query - values for query bitmap |
| * @IWL_TOF_LOC_LCI: query LCI |
| * @IWL_TOF_LOC_CIVIC: query civic |
| */ |
| enum iwl_tof_location_query { |
| IWL_TOF_LOC_LCI = 0x01, |
| IWL_TOF_LOC_CIVIC = 0x02, |
| }; |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v2 - AP configuration parameters |
| * @channel_num: Current AP Channel |
| * @bandwidth: Current AP Bandwidth. One of iwl_tof_bandwidth. |
| * @tsf_delta_direction: TSF relatively to the subject AP |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @bssid: AP's BSSID |
| * @measure_type: Measurement type: 0 - two sided, 1 - One sided |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of the |
| * number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts = 0 |
| * @samples_per_burst: 2-sided: the number of FTMs pairs in single Burst (1-31); |
| * 1-sided: how many rts/cts pairs should be used per burst. |
| * @retries_per_sample: Max number of retries that the LMAC should send |
| * in case of no replies by the AP. |
| * @tsf_delta: TSF Delta in units of microseconds. |
| * The difference between the AP TSF and the device local clock. |
| * @location_req: Location Request Bit[0] LCI should be sent in the FTMR; |
| * Bit[1] Civic should be sent in the FTMR |
| * @asap_mode: 0 - non asap mode, 1 - asap mode (not relevant for one sided) |
| * @enable_dyn_ack: Enable Dynamic ACK BW. |
| * 0: Initiator interact with regular AP; |
| * 1: Initiator interact with Responder machine: need to send the |
| * Initiator Acks with HT 40MHz / 80MHz, since the Responder should |
| * use it for its ch est measurement (this flag will be set when we |
| * configure the opposite machine to be Responder). |
| * @rssi: Last received value |
| * legal values: -128-0 (0x7f). above 0x0 indicating an invalid value. |
| * @algo_type: &enum iwl_tof_algo_type |
| * @notify_mcsi: &enum iwl_tof_mcsi_ntfy. |
| * @reserved: For alignment and future use |
| */ |
| struct iwl_tof_range_req_ap_entry_v2 { |
| u8 channel_num; |
| u8 bandwidth; |
| u8 tsf_delta_direction; |
| u8 ctrl_ch_position; |
| u8 bssid[ETH_ALEN]; |
| u8 measure_type; |
| u8 num_of_bursts; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 retries_per_sample; |
| __le32 tsf_delta; |
| u8 location_req; |
| u8 asap_mode; |
| u8 enable_dyn_ack; |
| s8 rssi; |
| u8 algo_type; |
| u8 notify_mcsi; |
| __le16 reserved; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_2 */ |
| |
| /** |
| * enum iwl_initiator_ap_flags - per responder FTM configuration flags |
| * @IWL_INITIATOR_AP_FLAGS_ASAP: Request for ASAP measurement. |
| * @IWL_INITIATOR_AP_FLAGS_LCI_REQUEST: Request for LCI information |
| * @IWL_INITIATOR_AP_FLAGS_CIVIC_REQUEST: Request for CIVIC information |
| * @IWL_INITIATOR_AP_FLAGS_DYN_ACK: Send HT/VHT ack for FTM frames. If not set, |
| * 20Mhz dup acks will be sent. |
| * @IWL_INITIATOR_AP_FLAGS_ALGO_LR: Use LR algo type for rtt calculation. |
| * Default algo type is ML. |
| * @IWL_INITIATOR_AP_FLAGS_ALGO_FFT: Use FFT algo type for rtt calculation. |
| * Default algo type is ML. |
| * @IWL_INITIATOR_AP_FLAGS_MCSI_REPORT: Send the MCSI for each FTM frame to the |
| * driver. |
| * @IWL_INITIATOR_AP_FLAGS_NON_TB: Use non trigger based flow |
| * @IWL_INITIATOR_AP_FLAGS_TB: Use trigger based flow |
| * @IWL_INITIATOR_AP_FLAGS_SECURED: request secure LTF measurement |
| * @IWL_INITIATOR_AP_FLAGS_LMR_FEEDBACK: Send LMR feedback |
| * @IWL_INITIATOR_AP_FLAGS_USE_CALIB: Use calibration values from the request |
| * instead of fw internal values. |
| * @IWL_INITIATOR_AP_FLAGS_PMF: request to protect the negotiation and LMR |
| * frames with protected management frames. |
| * @IWL_INITIATOR_AP_FLAGS_TERMINATE_ON_LMR_FEEDBACK: terminate the session if |
| * the responder asked for LMR feedback although the initiator did not set |
| * the LMR feedback bit in the FTM request. If not set, the initiator will |
| * continue with the session and will provide the LMR feedback. |
| */ |
| enum iwl_initiator_ap_flags { |
| IWL_INITIATOR_AP_FLAGS_ASAP = BIT(1), |
| IWL_INITIATOR_AP_FLAGS_LCI_REQUEST = BIT(2), |
| IWL_INITIATOR_AP_FLAGS_CIVIC_REQUEST = BIT(3), |
| IWL_INITIATOR_AP_FLAGS_DYN_ACK = BIT(4), |
| IWL_INITIATOR_AP_FLAGS_ALGO_LR = BIT(5), |
| IWL_INITIATOR_AP_FLAGS_ALGO_FFT = BIT(6), |
| IWL_INITIATOR_AP_FLAGS_MCSI_REPORT = BIT(8), |
| IWL_INITIATOR_AP_FLAGS_NON_TB = BIT(9), |
| IWL_INITIATOR_AP_FLAGS_TB = BIT(10), |
| IWL_INITIATOR_AP_FLAGS_SECURED = BIT(11), |
| IWL_INITIATOR_AP_FLAGS_LMR_FEEDBACK = BIT(12), |
| IWL_INITIATOR_AP_FLAGS_USE_CALIB = BIT(13), |
| IWL_INITIATOR_AP_FLAGS_PMF = BIT(14), |
| IWL_INITIATOR_AP_FLAGS_TERMINATE_ON_LMR_FEEDBACK = BIT(15), |
| }; |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v3 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @bandwidth: AP bandwidth. One of iwl_tof_bandwidth. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts_exp = 0 |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @reserved: For alignment and future use |
| * @tsf_delta: not in use |
| */ |
| struct iwl_tof_range_req_ap_entry_v3 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 bandwidth; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| __le16 reserved; |
| __le32 tsf_delta; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_3 */ |
| |
| /** |
| * enum iwl_location_frame_format - location frame formats |
| * @IWL_LOCATION_FRAME_FORMAT_LEGACY: legacy |
| * @IWL_LOCATION_FRAME_FORMAT_HT: HT |
| * @IWL_LOCATION_FRAME_FORMAT_VHT: VHT |
| * @IWL_LOCATION_FRAME_FORMAT_HE: HE |
| */ |
| enum iwl_location_frame_format { |
| IWL_LOCATION_FRAME_FORMAT_LEGACY, |
| IWL_LOCATION_FRAME_FORMAT_HT, |
| IWL_LOCATION_FRAME_FORMAT_VHT, |
| IWL_LOCATION_FRAME_FORMAT_HE, |
| }; |
| |
| /** |
| * enum iwl_location_bw - location bandwidth selection |
| * @IWL_LOCATION_BW_20MHZ: 20MHz |
| * @IWL_LOCATION_BW_40MHZ: 40MHz |
| * @IWL_LOCATION_BW_80MHZ: 80MHz |
| */ |
| enum iwl_location_bw { |
| IWL_LOCATION_BW_20MHZ, |
| IWL_LOCATION_BW_40MHZ, |
| IWL_LOCATION_BW_80MHZ, |
| IWL_LOCATION_BW_160MHZ, |
| }; |
| |
| #define TK_11AZ_LEN 32 |
| |
| #define LOCATION_BW_POS 4 |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v4 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts_exp = 0 |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @reserved: For alignment and future use |
| * @hltk: HLTK to be used for secured 11az measurement |
| * @tk: TK to be used for secured 11az measurement |
| */ |
| struct iwl_tof_range_req_ap_entry_v4 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 format_bw; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| __le16 reserved; |
| u8 hltk[HLTK_11AZ_LEN]; |
| u8 tk[TK_11AZ_LEN]; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_4 */ |
| |
| /** |
| * enum iwl_location_cipher - location cipher selection |
| * @IWL_LOCATION_CIPHER_CCMP_128: CCMP 128 |
| * @IWL_LOCATION_CIPHER_GCMP_128: GCMP 128 |
| * @IWL_LOCATION_CIPHER_GCMP_256: GCMP 256 |
| * @IWL_LOCATION_CIPHER_INVALID: security is not used. |
| * @IWL_LOCATION_CIPHER_MAX: maximum value for this enum. |
| */ |
| enum iwl_location_cipher { |
| IWL_LOCATION_CIPHER_CCMP_128, |
| IWL_LOCATION_CIPHER_GCMP_128, |
| IWL_LOCATION_CIPHER_GCMP_256, |
| IWL_LOCATION_CIPHER_INVALID, |
| IWL_LOCATION_CIPHER_MAX, |
| }; |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v6 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts_exp = 0 |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @sta_id: the station id of the AP. Only relevant when associated to the AP, |
| * otherwise should be set to &IWL_MVM_INVALID_STA. |
| * @cipher: pairwise cipher suite for secured measurement. |
| * &enum iwl_location_cipher. |
| * @hltk: HLTK to be used for secured 11az measurement |
| * @tk: TK to be used for secured 11az measurement |
| * @calib: An array of calibration values per FTM rx bandwidth. |
| * If &IWL_INITIATOR_AP_FLAGS_USE_CALIB is set, the fw will use the |
| * calibration value that corresponds to the rx bandwidth of the FTM |
| * frame. |
| * @beacon_interval: beacon interval of the AP in TUs. Only required if |
| * &IWL_INITIATOR_AP_FLAGS_TB is set. |
| */ |
| struct iwl_tof_range_req_ap_entry_v6 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 format_bw; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| u8 sta_id; |
| u8 cipher; |
| u8 hltk[HLTK_11AZ_LEN]; |
| u8 tk[TK_11AZ_LEN]; |
| __le16 calib[IWL_TOF_BW_NUM]; |
| __le16 beacon_interval; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_6 */ |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v7 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts_exp = 0 |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @sta_id: the station id of the AP. Only relevant when associated to the AP, |
| * otherwise should be set to &IWL_MVM_INVALID_STA. |
| * @cipher: pairwise cipher suite for secured measurement. |
| * &enum iwl_location_cipher. |
| * @hltk: HLTK to be used for secured 11az measurement |
| * @tk: TK to be used for secured 11az measurement |
| * @calib: An array of calibration values per FTM rx bandwidth. |
| * If &IWL_INITIATOR_AP_FLAGS_USE_CALIB is set, the fw will use the |
| * calibration value that corresponds to the rx bandwidth of the FTM |
| * frame. |
| * @beacon_interval: beacon interval of the AP in TUs. Only required if |
| * &IWL_INITIATOR_AP_FLAGS_TB is set. |
| * @rx_pn: the next expected PN for protected management frames Rx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| * @tx_pn: the next PN to use for protected management frames Tx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| */ |
| struct iwl_tof_range_req_ap_entry_v7 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 format_bw; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| u8 sta_id; |
| u8 cipher; |
| u8 hltk[HLTK_11AZ_LEN]; |
| u8 tk[TK_11AZ_LEN]; |
| __le16 calib[IWL_TOF_BW_NUM]; |
| __le16 beacon_interval; |
| u8 rx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 tx_pn[IEEE80211_CCMP_PN_LEN]; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_7 */ |
| |
| #define IWL_LOCATION_MAX_STS_POS 3 |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v8 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: Recommended value to be sent to the AP. Measurement |
| * periodicity In units of 100ms. ignored if num_of_bursts_exp = 0 |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @sta_id: the station id of the AP. Only relevant when associated to the AP, |
| * otherwise should be set to &IWL_MVM_INVALID_STA. |
| * @cipher: pairwise cipher suite for secured measurement. |
| * &enum iwl_location_cipher. |
| * @hltk: HLTK to be used for secured 11az measurement |
| * @tk: TK to be used for secured 11az measurement |
| * @calib: An array of calibration values per FTM rx bandwidth. |
| * If &IWL_INITIATOR_AP_FLAGS_USE_CALIB is set, the fw will use the |
| * calibration value that corresponds to the rx bandwidth of the FTM |
| * frame. |
| * @beacon_interval: beacon interval of the AP in TUs. Only required if |
| * &IWL_INITIATOR_AP_FLAGS_TB is set. |
| * @rx_pn: the next expected PN for protected management frames Rx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| * @tx_pn: the next PN to use for protected management frames Tx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| * @r2i_ndp_params: parameters for R2I NDP ranging negotiation. |
| * bits 0 - 2: max LTF repetitions |
| * bits 3 - 5: max number of spatial streams |
| * bits 6 - 7: reserved |
| * @i2r_ndp_params: parameters for I2R NDP ranging negotiation. |
| * bits 0 - 2: max LTF repetitions |
| * bits 3 - 5: max number of spatial streams (supported values are < 2) |
| * bits 6 - 7: reserved |
| * @r2i_max_total_ltf: R2I Max Total LTFs for NDP ranging negotiation. |
| * One of &enum ieee80211_range_params_max_total_ltf. |
| * @i2r_max_total_ltf: I2R Max Total LTFs for NDP ranging negotiation. |
| * One of &enum ieee80211_range_params_max_total_ltf. |
| */ |
| struct iwl_tof_range_req_ap_entry_v8 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 format_bw; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| u8 sta_id; |
| u8 cipher; |
| u8 hltk[HLTK_11AZ_LEN]; |
| u8 tk[TK_11AZ_LEN]; |
| __le16 calib[IWL_TOF_BW_NUM]; |
| __le16 beacon_interval; |
| u8 rx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 tx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 r2i_ndp_params; |
| u8 i2r_ndp_params; |
| u8 r2i_max_total_ltf; |
| u8 i2r_max_total_ltf; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_8 */ |
| |
| /** |
| * struct iwl_tof_range_req_ap_entry_v9 - AP configuration parameters |
| * @initiator_ap_flags: see &enum iwl_initiator_ap_flags. |
| * @channel_num: AP Channel number |
| * @format_bw: bits 0 - 3: &enum iwl_location_frame_format. |
| * bits 4 - 7: &enum iwl_location_bw. |
| * @ctrl_ch_position: Coding of the control channel position relative to the |
| * center frequency, see iwl_mvm_get_ctrl_pos(). |
| * @ftmr_max_retries: Max number of retries to send the FTMR in case of no |
| * reply from the AP. |
| * @bssid: AP's BSSID |
| * @burst_period: For EDCA based ranging: Recommended value to be sent to the |
| * AP. Measurement periodicity In units of 100ms. ignored if |
| * num_of_bursts_exp = 0. |
| * For non trigger based NDP ranging, the maximum time between |
| * measurements in units of milliseconds. |
| * @samples_per_burst: the number of FTMs pairs in single Burst (1-31); |
| * @num_of_bursts: Recommended value to be sent to the AP. 2s Exponent of |
| * the number of measurement iterations (min 2^0 = 1, max 2^14) |
| * @sta_id: the station id of the AP. Only relevant when associated to the AP, |
| * otherwise should be set to &IWL_MVM_INVALID_STA. |
| * @cipher: pairwise cipher suite for secured measurement. |
| * &enum iwl_location_cipher. |
| * @hltk: HLTK to be used for secured 11az measurement |
| * @tk: TK to be used for secured 11az measurement |
| * @calib: An array of calibration values per FTM rx bandwidth. |
| * If &IWL_INITIATOR_AP_FLAGS_USE_CALIB is set, the fw will use the |
| * calibration value that corresponds to the rx bandwidth of the FTM |
| * frame. |
| * @beacon_interval: beacon interval of the AP in TUs. Only required if |
| * &IWL_INITIATOR_AP_FLAGS_TB is set. |
| * @bss_color: the BSS color of the responder. Only valid if |
| * &IWL_INITIATOR_AP_FLAGS_TB or &IWL_INITIATOR_AP_FLAGS_NON_TB is set. |
| * @rx_pn: the next expected PN for protected management frames Rx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| * @tx_pn: the next PN to use for protected management frames Tx. LE byte |
| * order. Only valid if &IWL_INITIATOR_AP_FLAGS_SECURED is set and sta_id |
| * is set to &IWL_MVM_INVALID_STA. |
| * @r2i_ndp_params: parameters for R2I NDP ranging negotiation. |
| * bits 0 - 2: max LTF repetitions |
| * bits 3 - 5: max number of spatial streams |
| * bits 6 - 7: reserved |
| * @i2r_ndp_params: parameters for I2R NDP ranging negotiation. |
| * bits 0 - 2: max LTF repetitions |
| * bits 3 - 5: max number of spatial streams (supported values are < 2) |
| * bits 6 - 7: reserved |
| * @r2i_max_total_ltf: R2I Max Total LTFs for NDP ranging negotiation. |
| * One of &enum ieee80211_range_params_max_total_ltf. |
| * @i2r_max_total_ltf: I2R Max Total LTFs for NDP ranging negotiation. |
| * One of &enum ieee80211_range_params_max_total_ltf. |
| * @bss_color: the BSS color of the responder. Only valid if |
| * &IWL_INITIATOR_AP_FLAGS_NON_TB or &IWL_INITIATOR_AP_FLAGS_TB is set. |
| * @band: 0 for 5.2 GHz, 1 for 2.4 GHz, 2 for 6GHz |
| * @min_time_between_msr: For non trigger based NDP ranging, the minimum time |
| * between measurements in units of milliseconds |
| */ |
| struct iwl_tof_range_req_ap_entry_v9 { |
| __le32 initiator_ap_flags; |
| u8 channel_num; |
| u8 format_bw; |
| u8 ctrl_ch_position; |
| u8 ftmr_max_retries; |
| u8 bssid[ETH_ALEN]; |
| __le16 burst_period; |
| u8 samples_per_burst; |
| u8 num_of_bursts; |
| u8 sta_id; |
| u8 cipher; |
| u8 hltk[HLTK_11AZ_LEN]; |
| u8 tk[TK_11AZ_LEN]; |
| __le16 calib[IWL_TOF_BW_NUM]; |
| u16 beacon_interval; |
| u8 rx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 tx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 r2i_ndp_params; |
| u8 i2r_ndp_params; |
| u8 r2i_max_total_ltf; |
| u8 i2r_max_total_ltf; |
| u8 bss_color; |
| u8 band; |
| __le16 min_time_between_msr; |
| } __packed; /* LOCATION_RANGE_REQ_AP_ENTRY_CMD_API_S_VER_9 */ |
| |
| /** |
| * enum iwl_tof_response_mode |
| * @IWL_MVM_TOF_RESPONSE_ASAP: report each AP measurement separately as soon as |
| * possible (not supported for this release) |
| * @IWL_MVM_TOF_RESPONSE_TIMEOUT: report all AP measurements as a batch upon |
| * timeout expiration |
| * @IWL_MVM_TOF_RESPONSE_COMPLETE: report all AP measurements as a batch at the |
| * earlier of: measurements completion / timeout |
| * expiration. |
| */ |
| enum iwl_tof_response_mode { |
| IWL_MVM_TOF_RESPONSE_ASAP, |
| IWL_MVM_TOF_RESPONSE_TIMEOUT, |
| IWL_MVM_TOF_RESPONSE_COMPLETE, |
| }; |
| |
| /** |
| * enum iwl_tof_initiator_flags |
| * |
| * @IWL_TOF_INITIATOR_FLAGS_FAST_ALGO_DISABLED: disable fast algo, meaning run |
| * the algo on ant A+B, instead of only one of them. |
| * @IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_A: open RX antenna A for FTMs RX |
| * @IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_B: open RX antenna B for FTMs RX |
| * @IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_C: open RX antenna C for FTMs RX |
| * @IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_A: use antenna A fo TX ACKs during FTM |
| * @IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_B: use antenna B fo TX ACKs during FTM |
| * @IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_C: use antenna C fo TX ACKs during FTM |
| * @IWL_TOF_INITIATOR_FLAGS_MACADDR_RANDOM: use random mac address for FTM |
| * @IWL_TOF_INITIATOR_FLAGS_SPECIFIC_CALIB: use the specific calib value from |
| * the range request command |
| * @IWL_TOF_INITIATOR_FLAGS_COMMON_CALIB: use the common calib value from the |
| * ragne request command |
| * @IWL_TOF_INITIATOR_FLAGS_NON_ASAP_SUPPORT: support non-asap measurements |
| */ |
| enum iwl_tof_initiator_flags { |
| IWL_TOF_INITIATOR_FLAGS_FAST_ALGO_DISABLED = BIT(0), |
| IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_A = BIT(1), |
| IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_B = BIT(2), |
| IWL_TOF_INITIATOR_FLAGS_RX_CHAIN_SEL_C = BIT(3), |
| IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_A = BIT(4), |
| IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_B = BIT(5), |
| IWL_TOF_INITIATOR_FLAGS_TX_CHAIN_SEL_C = BIT(6), |
| IWL_TOF_INITIATOR_FLAGS_MACADDR_RANDOM = BIT(7), |
| IWL_TOF_INITIATOR_FLAGS_SPECIFIC_CALIB = BIT(15), |
| IWL_TOF_INITIATOR_FLAGS_COMMON_CALIB = BIT(16), |
| IWL_TOF_INITIATOR_FLAGS_NON_ASAP_SUPPORT = BIT(20), |
| }; /* LOCATION_RANGE_REQ_CMD_API_S_VER_5 */ |
| |
| #define IWL_MVM_TOF_MAX_APS 5 |
| #define IWL_MVM_TOF_MAX_TWO_SIDED_APS 5 |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v5 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @initiator: 0- NW initiated, 1 - Client Initiated |
| * @one_sided_los_disable: '0'- run ML-Algo for both ToF/OneSided, |
| * '1' - run ML-Algo for ToF only |
| * @req_timeout: Requested timeout of the response in units of 100ms. |
| * This is equivalent to the session time configured to the |
| * LMAC in Initiator Request |
| * @report_policy: Supported partially for this release: For current release - |
| * the range report will be uploaded as a batch when ready or |
| * when the session is done (successfully / partially). |
| * one of iwl_tof_response_mode. |
| * @reserved0: reserved |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @macaddr_random: '0' Use default source MAC address (i.e. p2_p), |
| * '1' Use MAC Address randomization according to the below |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @ftm_rx_chains: Rx chain to open to receive Responder's FTMs (XVT) |
| * @ftm_tx_chains: Tx chain to send the ack to the Responder FTM (XVT) |
| * @common_calib: The common calib value to inject to this measurement calc |
| * @specific_calib: The specific calib value to inject to this measurement calc |
| * @ap: per-AP request data |
| */ |
| struct iwl_tof_range_req_cmd_v5 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 initiator; |
| u8 one_sided_los_disable; |
| u8 req_timeout; |
| u8 report_policy; |
| u8 reserved0; |
| u8 num_of_ap; |
| u8 macaddr_random; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 ftm_rx_chains; |
| u8 ftm_tx_chains; |
| __le16 common_calib; |
| __le16 specific_calib; |
| struct iwl_tof_range_req_ap_entry_v2 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; |
| /* LOCATION_RANGE_REQ_CMD_API_S_VER_5 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v7 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @common_calib: The common calib value to inject to this measurement calc |
| * @specific_calib: The specific calib value to inject to this measurement calc |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v2. |
| */ |
| struct iwl_tof_range_req_cmd_v7 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| __le16 common_calib; |
| __le16 specific_calib; |
| struct iwl_tof_range_req_ap_entry_v3 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_7 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v8 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @common_calib: The common calib value to inject to this measurement calc |
| * @specific_calib: The specific calib value to inject to this measurement calc |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v2. |
| */ |
| struct iwl_tof_range_req_cmd_v8 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| __le16 common_calib; |
| __le16 specific_calib; |
| struct iwl_tof_range_req_ap_entry_v4 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_8 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v9 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v2. |
| */ |
| struct iwl_tof_range_req_cmd_v9 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| struct iwl_tof_range_req_ap_entry_v6 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_9 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v11 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v2. |
| */ |
| struct iwl_tof_range_req_cmd_v11 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| struct iwl_tof_range_req_ap_entry_v7 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_11 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v12 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v2. |
| */ |
| struct iwl_tof_range_req_cmd_v12 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| struct iwl_tof_range_req_ap_entry_v8 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_12 */ |
| |
| /** |
| * struct iwl_tof_range_req_cmd_v13 - start measurement cmd |
| * @initiator_flags: see flags @ iwl_tof_initiator_flags |
| * @request_id: A Token incremented per request. The same Token will be |
| * sent back in the range response |
| * @num_of_ap: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @range_req_bssid: ranging request BSSID |
| * @macaddr_mask: Bits set to 0 shall be copied from the MAC address template. |
| * Bits set to 1 shall be randomized by the UMAC |
| * @macaddr_template: MAC address template to use for non-randomized bits |
| * @req_timeout_ms: Requested timeout of the response in units of milliseconds. |
| * This is the session time for completing the measurement. |
| * @tsf_mac_id: report the measurement start time for each ap in terms of the |
| * TSF of this mac id. 0xff to disable TSF reporting. |
| * @ap: per-AP request data, see &struct iwl_tof_range_req_ap_entry_v9. |
| */ |
| struct iwl_tof_range_req_cmd_v13 { |
| __le32 initiator_flags; |
| u8 request_id; |
| u8 num_of_ap; |
| u8 range_req_bssid[ETH_ALEN]; |
| u8 macaddr_mask[ETH_ALEN]; |
| u8 macaddr_template[ETH_ALEN]; |
| __le32 req_timeout_ms; |
| __le32 tsf_mac_id; |
| struct iwl_tof_range_req_ap_entry_v9 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_REQ_CMD_API_S_VER_13 */ |
| |
| /* |
| * enum iwl_tof_range_request_status - status of the sent request |
| * @IWL_TOF_RANGE_REQUEST_STATUS_SUCCESSFUL - FW successfully received the |
| * request |
| * @IWL_TOF_RANGE_REQUEST_STATUS_BUSY - FW is busy with a previous request, the |
| * sent request will not be handled |
| */ |
| enum iwl_tof_range_request_status { |
| IWL_TOF_RANGE_REQUEST_STATUS_SUCCESS, |
| IWL_TOF_RANGE_REQUEST_STATUS_BUSY, |
| }; |
| |
| /** |
| * enum iwl_tof_entry_status |
| * |
| * @IWL_TOF_ENTRY_SUCCESS: successful measurement. |
| * @IWL_TOF_ENTRY_GENERAL_FAILURE: General failure. |
| * @IWL_TOF_ENTRY_NO_RESPONSE: Responder didn't reply to the request. |
| * @IWL_TOF_ENTRY_REQUEST_REJECTED: Responder rejected the request. |
| * @IWL_TOF_ENTRY_NOT_SCHEDULED: Time event was scheduled but not called yet. |
| * @IWL_TOF_ENTRY_TIMING_MEASURE_TIMEOUT: Time event triggered but no |
| * measurement was completed. |
| * @IWL_TOF_ENTRY_TARGET_DIFF_CH_CANNOT_CHANGE: No range due inability to switch |
| * from the primary channel. |
| * @IWL_TOF_ENTRY_RANGE_NOT_SUPPORTED: Device doesn't support FTM. |
| * @IWL_TOF_ENTRY_REQUEST_ABORT_UNKNOWN_REASON: Request aborted due to unknown |
| * reason. |
| * @IWL_TOF_ENTRY_LOCATION_INVALID_T1_T4_TIME_STAMP: Failure due to invalid |
| * T1/T4. |
| * @IWL_TOF_ENTRY_11MC_PROTOCOL_FAILURE: Failure due to invalid FTM frame |
| * structure. |
| * @IWL_TOF_ENTRY_REQUEST_CANNOT_SCHED: Request cannot be scheduled. |
| * @IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE: Responder cannot serve the |
| * initiator for some period, period supplied in @refusal_period. |
| * @IWL_TOF_ENTRY_BAD_REQUEST_ARGS: Bad request arguments. |
| * @IWL_TOF_ENTRY_WIFI_NOT_ENABLED: Wifi not enabled. |
| * @IWL_TOF_ENTRY_RESPONDER_OVERRIDE_PARAMS: Responder override the original |
| * parameters within the current session. |
| */ |
| enum iwl_tof_entry_status { |
| IWL_TOF_ENTRY_SUCCESS = 0, |
| IWL_TOF_ENTRY_GENERAL_FAILURE = 1, |
| IWL_TOF_ENTRY_NO_RESPONSE = 2, |
| IWL_TOF_ENTRY_REQUEST_REJECTED = 3, |
| IWL_TOF_ENTRY_NOT_SCHEDULED = 4, |
| IWL_TOF_ENTRY_TIMING_MEASURE_TIMEOUT = 5, |
| IWL_TOF_ENTRY_TARGET_DIFF_CH_CANNOT_CHANGE = 6, |
| IWL_TOF_ENTRY_RANGE_NOT_SUPPORTED = 7, |
| IWL_TOF_ENTRY_REQUEST_ABORT_UNKNOWN_REASON = 8, |
| IWL_TOF_ENTRY_LOCATION_INVALID_T1_T4_TIME_STAMP = 9, |
| IWL_TOF_ENTRY_11MC_PROTOCOL_FAILURE = 10, |
| IWL_TOF_ENTRY_REQUEST_CANNOT_SCHED = 11, |
| IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE = 12, |
| IWL_TOF_ENTRY_BAD_REQUEST_ARGS = 13, |
| IWL_TOF_ENTRY_WIFI_NOT_ENABLED = 14, |
| IWL_TOF_ENTRY_RESPONDER_OVERRIDE_PARAMS = 15, |
| }; /* LOCATION_RANGE_RSP_AP_ENTRY_NTFY_API_S_VER_2 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ap_entry_ntfy_v3 - AP parameters (response) |
| * @bssid: BSSID of the AP |
| * @measure_status: current APs measurement status, one of |
| * &enum iwl_tof_entry_status. |
| * @measure_bw: Current AP Bandwidth: 0 20MHz, 1 40MHz, 2 80MHz |
| * @rtt: The Round Trip Time that took for the last measurement for |
| * current AP [pSec] |
| * @rtt_variance: The Variance of the RTT values measured for current AP |
| * @rtt_spread: The Difference between the maximum and the minimum RTT |
| * values measured for current AP in the current session [pSec] |
| * @rssi: RSSI as uploaded in the Channel Estimation notification |
| * @rssi_spread: The Difference between the maximum and the minimum RSSI values |
| * measured for current AP in the current session |
| * @reserved: reserved |
| * @refusal_period: refusal period in case of |
| * @IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE [sec] |
| * @range: Measured range [cm] |
| * @range_variance: Measured range variance [cm] |
| * @timestamp: The GP2 Clock [usec] where Channel Estimation notification was |
| * uploaded by the LMAC |
| * @t2t3_initiator: as calculated from the algo in the initiator |
| * @t1t4_responder: as calculated from the algo in the responder |
| * @common_calib: Calib val that was used in for this AP measurement |
| * @specific_calib: val that was used in for this AP measurement |
| * @papd_calib_output: The result of the tof papd calibration that was injected |
| * into the algorithm. |
| */ |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v3 { |
| u8 bssid[ETH_ALEN]; |
| u8 measure_status; |
| u8 measure_bw; |
| __le32 rtt; |
| __le32 rtt_variance; |
| __le32 rtt_spread; |
| s8 rssi; |
| u8 rssi_spread; |
| u8 reserved; |
| u8 refusal_period; |
| __le32 range; |
| __le32 range_variance; |
| __le32 timestamp; |
| __le32 t2t3_initiator; |
| __le32 t1t4_responder; |
| __le16 common_calib; |
| __le16 specific_calib; |
| __le32 papd_calib_output; |
| } __packed; /* LOCATION_RANGE_RSP_AP_ETRY_NTFY_API_S_VER_3 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ap_entry_ntfy_v4 - AP parameters (response) |
| * @bssid: BSSID of the AP |
| * @measure_status: current APs measurement status, one of |
| * &enum iwl_tof_entry_status. |
| * @measure_bw: Current AP Bandwidth: 0 20MHz, 1 40MHz, 2 80MHz |
| * @rtt: The Round Trip Time that took for the last measurement for |
| * current AP [pSec] |
| * @rtt_variance: The Variance of the RTT values measured for current AP |
| * @rtt_spread: The Difference between the maximum and the minimum RTT |
| * values measured for current AP in the current session [pSec] |
| * @rssi: RSSI as uploaded in the Channel Estimation notification |
| * @rssi_spread: The Difference between the maximum and the minimum RSSI values |
| * measured for current AP in the current session |
| * @last_burst: 1 if no more FTM sessions are scheduled for this responder |
| * @refusal_period: refusal period in case of |
| * @IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE [sec] |
| * @timestamp: The GP2 Clock [usec] where Channel Estimation notification was |
| * uploaded by the LMAC |
| * @start_tsf: measurement start time in TSF of the mac specified in the range |
| * request |
| * @rx_rate_n_flags: rate and flags of the last FTM frame received from this |
| * responder |
| * @tx_rate_n_flags: rate and flags of the last ack sent to this responder |
| * @t2t3_initiator: as calculated from the algo in the initiator |
| * @t1t4_responder: as calculated from the algo in the responder |
| * @common_calib: Calib val that was used in for this AP measurement |
| * @specific_calib: val that was used in for this AP measurement |
| * @papd_calib_output: The result of the tof papd calibration that was injected |
| * into the algorithm. |
| */ |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v4 { |
| u8 bssid[ETH_ALEN]; |
| u8 measure_status; |
| u8 measure_bw; |
| __le32 rtt; |
| __le32 rtt_variance; |
| __le32 rtt_spread; |
| s8 rssi; |
| u8 rssi_spread; |
| u8 last_burst; |
| u8 refusal_period; |
| __le32 timestamp; |
| __le32 start_tsf; |
| __le32 rx_rate_n_flags; |
| __le32 tx_rate_n_flags; |
| __le32 t2t3_initiator; |
| __le32 t1t4_responder; |
| __le16 common_calib; |
| __le16 specific_calib; |
| __le32 papd_calib_output; |
| } __packed; /* LOCATION_RANGE_RSP_AP_ETRY_NTFY_API_S_VER_4 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ap_entry_ntfy_v5 - AP parameters (response) |
| * @bssid: BSSID of the AP |
| * @measure_status: current APs measurement status, one of |
| * &enum iwl_tof_entry_status. |
| * @measure_bw: Current AP Bandwidth: 0 20MHz, 1 40MHz, 2 80MHz |
| * @rtt: The Round Trip Time that took for the last measurement for |
| * current AP [pSec] |
| * @rtt_variance: The Variance of the RTT values measured for current AP |
| * @rtt_spread: The Difference between the maximum and the minimum RTT |
| * values measured for current AP in the current session [pSec] |
| * @rssi: RSSI as uploaded in the Channel Estimation notification |
| * @rssi_spread: The Difference between the maximum and the minimum RSSI values |
| * measured for current AP in the current session |
| * @last_burst: 1 if no more FTM sessions are scheduled for this responder |
| * @refusal_period: refusal period in case of |
| * @IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE [sec] |
| * @timestamp: The GP2 Clock [usec] where Channel Estimation notification was |
| * uploaded by the LMAC |
| * @start_tsf: measurement start time in TSF of the mac specified in the range |
| * request |
| * @rx_rate_n_flags: rate and flags of the last FTM frame received from this |
| * responder |
| * @tx_rate_n_flags: rate and flags of the last ack sent to this responder |
| * @t2t3_initiator: as calculated from the algo in the initiator |
| * @t1t4_responder: as calculated from the algo in the responder |
| * @common_calib: Calib val that was used in for this AP measurement |
| * @specific_calib: val that was used in for this AP measurement |
| * @papd_calib_output: The result of the tof papd calibration that was injected |
| * into the algorithm. |
| * @rttConfidence: a value between 0 - 31 that represents the rtt accuracy. |
| * @reserved: for alignment |
| */ |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v5 { |
| u8 bssid[ETH_ALEN]; |
| u8 measure_status; |
| u8 measure_bw; |
| __le32 rtt; |
| __le32 rtt_variance; |
| __le32 rtt_spread; |
| s8 rssi; |
| u8 rssi_spread; |
| u8 last_burst; |
| u8 refusal_period; |
| __le32 timestamp; |
| __le32 start_tsf; |
| __le32 rx_rate_n_flags; |
| __le32 tx_rate_n_flags; |
| __le32 t2t3_initiator; |
| __le32 t1t4_responder; |
| __le16 common_calib; |
| __le16 specific_calib; |
| __le32 papd_calib_output; |
| u8 rttConfidence; |
| u8 reserved[3]; |
| } __packed; /* LOCATION_RANGE_RSP_AP_ETRY_NTFY_API_S_VER_5 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ap_entry_ntfy_v6 - AP parameters (response) |
| * @bssid: BSSID of the AP |
| * @measure_status: current APs measurement status, one of |
| * &enum iwl_tof_entry_status. |
| * @measure_bw: Current AP Bandwidth: 0 20MHz, 1 40MHz, 2 80MHz |
| * @rtt: The Round Trip Time that took for the last measurement for |
| * current AP [pSec] |
| * @rtt_variance: The Variance of the RTT values measured for current AP |
| * @rtt_spread: The Difference between the maximum and the minimum RTT |
| * values measured for current AP in the current session [pSec] |
| * @rssi: RSSI as uploaded in the Channel Estimation notification |
| * @rssi_spread: The Difference between the maximum and the minimum RSSI values |
| * measured for current AP in the current session |
| * @last_burst: 1 if no more FTM sessions are scheduled for this responder |
| * @refusal_period: refusal period in case of |
| * @IWL_TOF_ENTRY_RESPONDER_CANNOT_COLABORATE [sec] |
| * @timestamp: The GP2 Clock [usec] where Channel Estimation notification was |
| * uploaded by the LMAC |
| * @start_tsf: measurement start time in TSF of the mac specified in the range |
| * request |
| * @rx_rate_n_flags: rate and flags of the last FTM frame received from this |
| * responder |
| * @tx_rate_n_flags: rate and flags of the last ack sent to this responder |
| * @t2t3_initiator: as calculated from the algo in the initiator |
| * @t1t4_responder: as calculated from the algo in the responder |
| * @common_calib: Calib val that was used in for this AP measurement |
| * @specific_calib: val that was used in for this AP measurement |
| * @papd_calib_output: The result of the tof papd calibration that was injected |
| * into the algorithm. |
| * @rttConfidence: a value between 0 - 31 that represents the rtt accuracy. |
| * @reserved: for alignment |
| * @rx_pn: the last PN used for this responder Rx in case PMF is configured in |
| * LE byte order. |
| * @tx_pn: the last PN used for this responder Tx in case PMF is configured in |
| * LE byte order. |
| */ |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v6 { |
| u8 bssid[ETH_ALEN]; |
| u8 measure_status; |
| u8 measure_bw; |
| __le32 rtt; |
| __le32 rtt_variance; |
| __le32 rtt_spread; |
| s8 rssi; |
| u8 rssi_spread; |
| u8 last_burst; |
| u8 refusal_period; |
| __le32 timestamp; |
| __le32 start_tsf; |
| __le32 rx_rate_n_flags; |
| __le32 tx_rate_n_flags; |
| __le32 t2t3_initiator; |
| __le32 t1t4_responder; |
| __le16 common_calib; |
| __le16 specific_calib; |
| __le32 papd_calib_output; |
| u8 rttConfidence; |
| u8 reserved[3]; |
| u8 rx_pn[IEEE80211_CCMP_PN_LEN]; |
| u8 tx_pn[IEEE80211_CCMP_PN_LEN]; |
| } __packed; /* LOCATION_RANGE_RSP_AP_ETRY_NTFY_API_S_VER_6, |
| LOCATION_RANGE_RSP_AP_ETRY_NTFY_API_S_VER_7 */ |
| |
| |
| /** |
| * enum iwl_tof_response_status - tof response status |
| * |
| * @IWL_TOF_RESPONSE_SUCCESS: successful range. |
| * @IWL_TOF_RESPONSE_TIMEOUT: request aborted due to timeout expiration. |
| * partial result of ranges done so far is included in the response. |
| * @IWL_TOF_RESPONSE_ABORTED: Measurement aborted by command. |
| * @IWL_TOF_RESPONSE_FAILED: Measurement request command failed. |
| */ |
| enum iwl_tof_response_status { |
| IWL_TOF_RESPONSE_SUCCESS = 0, |
| IWL_TOF_RESPONSE_TIMEOUT = 1, |
| IWL_TOF_RESPONSE_ABORTED = 4, |
| IWL_TOF_RESPONSE_FAILED = 5, |
| }; /* LOCATION_RNG_RSP_STATUS */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ntfy_v5 - ranging response notification |
| * @request_id: A Token ID of the corresponding Range request |
| * @request_status: status of current measurement session, one of |
| * &enum iwl_tof_response_status. |
| * @last_in_batch: reprot policy (when not all responses are uploaded at once) |
| * @num_of_aps: Number of APs to measure (error if > IWL_MVM_TOF_MAX_APS) |
| * @ap: per-AP data |
| */ |
| struct iwl_tof_range_rsp_ntfy_v5 { |
| u8 request_id; |
| u8 request_status; |
| u8 last_in_batch; |
| u8 num_of_aps; |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v3 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_RSP_NTFY_API_S_VER_5 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ntfy_v6 - ranging response notification |
| * @request_id: A Token ID of the corresponding Range request |
| * @num_of_aps: Number of APs results |
| * @last_report: 1 if no more FTM sessions are scheduled, 0 otherwise. |
| * @reserved: reserved |
| * @ap: per-AP data |
| */ |
| struct iwl_tof_range_rsp_ntfy_v6 { |
| u8 request_id; |
| u8 num_of_aps; |
| u8 last_report; |
| u8 reserved; |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v4 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_RSP_NTFY_API_S_VER_6 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ntfy_v7 - ranging response notification |
| * @request_id: A Token ID of the corresponding Range request |
| * @num_of_aps: Number of APs results |
| * @last_report: 1 if no more FTM sessions are scheduled, 0 otherwise. |
| * @reserved: reserved |
| * @ap: per-AP data |
| */ |
| struct iwl_tof_range_rsp_ntfy_v7 { |
| u8 request_id; |
| u8 num_of_aps; |
| u8 last_report; |
| u8 reserved; |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v5 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_RSP_NTFY_API_S_VER_7 */ |
| |
| /** |
| * struct iwl_tof_range_rsp_ntfy_v8 - ranging response notification |
| * @request_id: A Token ID of the corresponding Range request |
| * @num_of_aps: Number of APs results |
| * @last_report: 1 if no more FTM sessions are scheduled, 0 otherwise. |
| * @reserved: reserved |
| * @ap: per-AP data |
| */ |
| struct iwl_tof_range_rsp_ntfy_v8 { |
| u8 request_id; |
| u8 num_of_aps; |
| u8 last_report; |
| u8 reserved; |
| struct iwl_tof_range_rsp_ap_entry_ntfy_v6 ap[IWL_MVM_TOF_MAX_APS]; |
| } __packed; /* LOCATION_RANGE_RSP_NTFY_API_S_VER_8, |
| LOCATION_RANGE_RSP_NTFY_API_S_VER_9 */ |
| |
| #define IWL_MVM_TOF_MCSI_BUF_SIZE (245) |
| /** |
| * struct iwl_tof_mcsi_notif - used for debug |
| * @token: token ID for the current session |
| * @role: '0' - initiator, '1' - responder |
| * @reserved: reserved |
| * @initiator_bssid: initiator machine |
| * @responder_bssid: responder machine |
| * @mcsi_buffer: debug data |
| */ |
| struct iwl_tof_mcsi_notif { |
| u8 token; |
| u8 role; |
| __le16 reserved; |
| u8 initiator_bssid[ETH_ALEN]; |
| u8 responder_bssid[ETH_ALEN]; |
| u8 mcsi_buffer[IWL_MVM_TOF_MCSI_BUF_SIZE * 4]; |
| } __packed; |
| |
| /** |
| * struct iwl_tof_range_abort_cmd |
| * @request_id: corresponds to a range request |
| * @reserved: reserved |
| */ |
| struct iwl_tof_range_abort_cmd { |
| u8 request_id; |
| u8 reserved[3]; |
| } __packed; |
| |
| enum ftm_responder_stats_flags { |
| FTM_RESP_STAT_NON_ASAP_STARTED = BIT(0), |
| FTM_RESP_STAT_NON_ASAP_IN_WIN = BIT(1), |
| FTM_RESP_STAT_NON_ASAP_OUT_WIN = BIT(2), |
| FTM_RESP_STAT_TRIGGER_DUP = BIT(3), |
| FTM_RESP_STAT_DUP = BIT(4), |
| FTM_RESP_STAT_DUP_IN_WIN = BIT(5), |
| FTM_RESP_STAT_DUP_OUT_WIN = BIT(6), |
| FTM_RESP_STAT_SCHED_SUCCESS = BIT(7), |
| FTM_RESP_STAT_ASAP_REQ = BIT(8), |
| FTM_RESP_STAT_NON_ASAP_REQ = BIT(9), |
| FTM_RESP_STAT_ASAP_RESP = BIT(10), |
| FTM_RESP_STAT_NON_ASAP_RESP = BIT(11), |
| FTM_RESP_STAT_FAIL_INITIATOR_INACTIVE = BIT(12), |
| FTM_RESP_STAT_FAIL_INITIATOR_OUT_WIN = BIT(13), |
| FTM_RESP_STAT_FAIL_INITIATOR_RETRY_LIM = BIT(14), |
| FTM_RESP_STAT_FAIL_NEXT_SERVED = BIT(15), |
| FTM_RESP_STAT_FAIL_TRIGGER_ERR = BIT(16), |
| FTM_RESP_STAT_FAIL_GC = BIT(17), |
| FTM_RESP_STAT_SUCCESS = BIT(18), |
| FTM_RESP_STAT_INTEL_IE = BIT(19), |
| FTM_RESP_STAT_INITIATOR_ACTIVE = BIT(20), |
| FTM_RESP_STAT_MEASUREMENTS_AVAILABLE = BIT(21), |
| FTM_RESP_STAT_TRIGGER_UNKNOWN = BIT(22), |
| FTM_RESP_STAT_PROCESS_FAIL = BIT(23), |
| FTM_RESP_STAT_ACK = BIT(24), |
| FTM_RESP_STAT_NACK = BIT(25), |
| FTM_RESP_STAT_INVALID_INITIATOR_ID = BIT(26), |
| FTM_RESP_STAT_TIMER_MIN_DELTA = BIT(27), |
| FTM_RESP_STAT_INITIATOR_REMOVED = BIT(28), |
| FTM_RESP_STAT_INITIATOR_ADDED = BIT(29), |
| FTM_RESP_STAT_ERR_LIST_FULL = BIT(30), |
| FTM_RESP_STAT_INITIATOR_SCHED_NOW = BIT(31), |
| }; /* RESP_IND_E */ |
| |
| /** |
| * struct iwl_ftm_responder_stats - FTM responder statistics |
| * @addr: initiator address |
| * @success_ftm: number of successful ftm frames |
| * @ftm_per_burst: num of FTM frames that were received |
| * @flags: &enum ftm_responder_stats_flags |
| * @duration: actual duration of FTM |
| * @allocated_duration: time that was allocated for this FTM session |
| * @bw: FTM request bandwidth |
| * @rate: FTM request rate |
| * @reserved: for alingment and future use |
| */ |
| struct iwl_ftm_responder_stats { |
| u8 addr[ETH_ALEN]; |
| u8 success_ftm; |
| u8 ftm_per_burst; |
| __le32 flags; |
| __le32 duration; |
| __le32 allocated_duration; |
| u8 bw; |
| u8 rate; |
| __le16 reserved; |
| } __packed; /* TOF_RESPONDER_STATISTICS_NTFY_S_VER_2 */ |
| |
| #define IWL_CSI_MAX_EXPECTED_CHUNKS 16 |
| |
| #define IWL_CSI_CHUNK_CTL_NUM_MASK_VER_1 0x0003 |
| #define IWL_CSI_CHUNK_CTL_IDX_MASK_VER_1 0x000c |
| |
| #define IWL_CSI_CHUNK_CTL_NUM_MASK_VER_2 0x00ff |
| #define IWL_CSI_CHUNK_CTL_IDX_MASK_VER_2 0xff00 |
| |
| struct iwl_csi_chunk_notification { |
| __le32 token; |
| __le16 seq; |
| __le16 ctl; |
| __le32 size; |
| u8 data[]; |
| } __packed; /* CSI_CHUNKS_HDR_NTFY_API_S_VER_1/VER_2 */ |
| |
| #endif /* __iwl_fw_api_location_h__ */ |
