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