1 /****************************************************************************** 2 * 3 * This file is provided under a dual BSD/GPLv2 license. When using or 4 * redistributing this file, you may do so under either license. 5 * 6 * GPL LICENSE SUMMARY 7 * 8 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. 9 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH 10 * Copyright(c) 2016 - 2017 Intel Deutschland GmbH 11 * Copyright(c) 2018 Intel Corporation 12 * 13 * This program is free software; you can redistribute it and/or modify 14 * it under the terms of version 2 of the GNU General Public License as 15 * published by the Free Software Foundation. 16 * 17 * This program is distributed in the hope that it will be useful, but 18 * WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 20 * General Public License for more details. 21 * 22 * The full GNU General Public License is included in this distribution 23 * in the file called COPYING. 24 * 25 * Contact Information: 26 * Intel Linux Wireless <linuxwifi@intel.com> 27 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 28 * 29 * BSD LICENSE 30 * 31 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved. 32 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH 33 * Copyright(c) 2016 - 2017 Intel Deutschland GmbH 34 * Copyright(c) 2018 Intel Corporation 35 * All rights reserved. 36 * 37 * Redistribution and use in source and binary forms, with or without 38 * modification, are permitted provided that the following conditions 39 * are met: 40 * 41 * * Redistributions of source code must retain the above copyright 42 * notice, this list of conditions and the following disclaimer. 43 * * Redistributions in binary form must reproduce the above copyright 44 * notice, this list of conditions and the following disclaimer in 45 * the documentation and/or other materials provided with the 46 * distribution. 47 * * Neither the name Intel Corporation nor the names of its 48 * contributors may be used to endorse or promote products derived 49 * from this software without specific prior written permission. 50 * 51 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 52 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 53 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 54 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 55 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 56 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 57 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 58 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 59 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 60 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 61 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 62 * 63 *****************************************************************************/ 64 65 #ifndef __iwl_fw_api_tdls_h__ 66 #define __iwl_fw_api_tdls_h__ 67 68 #include "fw/api/tx.h" 69 #include "fw/api/phy-ctxt.h" 70 71 #define IWL_MVM_TDLS_STA_COUNT 4 72 73 /* Type of TDLS request */ 74 enum iwl_tdls_channel_switch_type { 75 TDLS_SEND_CHAN_SW_REQ = 0, 76 TDLS_SEND_CHAN_SW_RESP_AND_MOVE_CH, 77 TDLS_MOVE_CH, 78 }; /* TDLS_STA_CHANNEL_SWITCH_CMD_TYPE_API_E_VER_1 */ 79 80 /** 81 * struct iwl_tdls_channel_switch_timing - Switch timing in TDLS channel-switch 82 * @frame_timestamp: GP2 timestamp of channel-switch request/response packet 83 * received from peer 84 * @max_offchan_duration: What amount of microseconds out of a DTIM is given 85 * to the TDLS off-channel communication. For instance if the DTIM is 86 * 200TU and the TDLS peer is to be given 25% of the time, the value 87 * given will be 50TU, or 50 * 1024 if translated into microseconds. 88 * @switch_time: switch time the peer sent in its channel switch timing IE 89 * @switch_timeout: switch timeout the peer sent in its channel switch timing IE 90 */ 91 struct iwl_tdls_channel_switch_timing { 92 __le32 frame_timestamp; /* GP2 time of peer packet Rx */ 93 __le32 max_offchan_duration; /* given in micro-seconds */ 94 __le32 switch_time; /* given in micro-seconds */ 95 __le32 switch_timeout; /* given in micro-seconds */ 96 } __packed; /* TDLS_STA_CHANNEL_SWITCH_TIMING_DATA_API_S_VER_1 */ 97 98 #define IWL_TDLS_CH_SW_FRAME_MAX_SIZE 200 99 100 /** 101 * struct iwl_tdls_channel_switch_frame - TDLS channel switch frame template 102 * 103 * A template representing a TDLS channel-switch request or response frame 104 * 105 * @switch_time_offset: offset to the channel switch timing IE in the template 106 * @tx_cmd: Tx parameters for the frame 107 * @data: frame data 108 */ 109 struct iwl_tdls_channel_switch_frame { 110 __le32 switch_time_offset; 111 struct iwl_tx_cmd tx_cmd; 112 u8 data[IWL_TDLS_CH_SW_FRAME_MAX_SIZE]; 113 } __packed; /* TDLS_STA_CHANNEL_SWITCH_FRAME_API_S_VER_1 */ 114 115 /** 116 * struct iwl_tdls_channel_switch_cmd_tail - tail of iwl_tdls_channel_switch_cmd 117 * 118 * @timing: timing related data for command 119 * @frame: channel-switch request/response template, depending to switch_type 120 */ 121 struct iwl_tdls_channel_switch_cmd_tail { 122 struct iwl_tdls_channel_switch_timing timing; 123 struct iwl_tdls_channel_switch_frame frame; 124 } __packed; 125 126 /** 127 * struct iwl_tdls_channel_switch_cmd - TDLS channel switch command 128 * 129 * The command is sent to initiate a channel switch and also in response to 130 * incoming TDLS channel-switch request/response packets from remote peers. 131 * 132 * @switch_type: see &enum iwl_tdls_channel_switch_type 133 * @peer_sta_id: station id of TDLS peer 134 * @ci: channel we switch to 135 * @tail: command tail 136 */ 137 struct iwl_tdls_channel_switch_cmd { 138 u8 switch_type; 139 __le32 peer_sta_id; 140 struct iwl_fw_channel_info ci; 141 struct iwl_tdls_channel_switch_cmd_tail tail; 142 } __packed; /* TDLS_STA_CHANNEL_SWITCH_CMD_API_S_VER_1 */ 143 144 /** 145 * struct iwl_tdls_channel_switch_notif - TDLS channel switch start notification 146 * 147 * @status: non-zero on success 148 * @offchannel_duration: duration given in microseconds 149 * @sta_id: peer currently performing the channel-switch with 150 */ 151 struct iwl_tdls_channel_switch_notif { 152 __le32 status; 153 __le32 offchannel_duration; 154 __le32 sta_id; 155 } __packed; /* TDLS_STA_CHANNEL_SWITCH_NTFY_API_S_VER_1 */ 156 157 /** 158 * struct iwl_tdls_sta_info - TDLS station info 159 * 160 * @sta_id: station id of the TDLS peer 161 * @tx_to_peer_tid: TID reserved vs. the peer for FW based Tx 162 * @tx_to_peer_ssn: initial SSN the FW should use for Tx on its TID vs the peer 163 * @is_initiator: 1 if the peer is the TDLS link initiator, 0 otherwise 164 */ 165 struct iwl_tdls_sta_info { 166 u8 sta_id; 167 u8 tx_to_peer_tid; 168 __le16 tx_to_peer_ssn; 169 __le32 is_initiator; 170 } __packed; /* TDLS_STA_INFO_VER_1 */ 171 172 /** 173 * struct iwl_tdls_config_cmd - TDLS basic config command 174 * 175 * @id_and_color: MAC id and color being configured 176 * @tdls_peer_count: amount of currently connected TDLS peers 177 * @tx_to_ap_tid: TID reverved vs. the AP for FW based Tx 178 * @tx_to_ap_ssn: initial SSN the FW should use for Tx on its TID vs. the AP 179 * @sta_info: per-station info. Only the first tdls_peer_count entries are set 180 * @pti_req_data_offset: offset of network-level data for the PTI template 181 * @pti_req_tx_cmd: Tx parameters for PTI request template 182 * @pti_req_template: PTI request template data 183 */ 184 struct iwl_tdls_config_cmd { 185 __le32 id_and_color; /* mac id and color */ 186 u8 tdls_peer_count; 187 u8 tx_to_ap_tid; 188 __le16 tx_to_ap_ssn; 189 struct iwl_tdls_sta_info sta_info[IWL_MVM_TDLS_STA_COUNT]; 190 191 __le32 pti_req_data_offset; 192 struct iwl_tx_cmd pti_req_tx_cmd; 193 u8 pti_req_template[0]; 194 } __packed; /* TDLS_CONFIG_CMD_API_S_VER_1 */ 195 196 /** 197 * struct iwl_tdls_config_sta_info_res - TDLS per-station config information 198 * 199 * @sta_id: station id of the TDLS peer 200 * @tx_to_peer_last_seq: last sequence number used by FW during FW-based Tx to 201 * the peer 202 */ 203 struct iwl_tdls_config_sta_info_res { 204 __le16 sta_id; 205 __le16 tx_to_peer_last_seq; 206 } __packed; /* TDLS_STA_INFO_RSP_VER_1 */ 207 208 /** 209 * struct iwl_tdls_config_res - TDLS config information from FW 210 * 211 * @tx_to_ap_last_seq: last sequence number used by FW during FW-based Tx to AP 212 * @sta_info: per-station TDLS config information 213 */ 214 struct iwl_tdls_config_res { 215 __le32 tx_to_ap_last_seq; 216 struct iwl_tdls_config_sta_info_res sta_info[IWL_MVM_TDLS_STA_COUNT]; 217 } __packed; /* TDLS_CONFIG_RSP_API_S_VER_1 */ 218 219 #endif /* __iwl_fw_api_tdls_h__ */ 220