1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
2 /*
3  * Copyright (C) 2012-2014, 2018 Intel Corporation
4  * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
5  * Copyright (C) 2016-2017 Intel Deutschland GmbH
6  */
7 #ifndef __iwl_fw_api_tdls_h__
8 #define __iwl_fw_api_tdls_h__
9 
10 #include "fw/api/tx.h"
11 #include "fw/api/phy-ctxt.h"
12 
13 #define IWL_MVM_TDLS_STA_COUNT	4
14 
15 /* Type of TDLS request */
16 enum iwl_tdls_channel_switch_type {
17 	TDLS_SEND_CHAN_SW_REQ = 0,
18 	TDLS_SEND_CHAN_SW_RESP_AND_MOVE_CH,
19 	TDLS_MOVE_CH,
20 }; /* TDLS_STA_CHANNEL_SWITCH_CMD_TYPE_API_E_VER_1 */
21 
22 /**
23  * struct iwl_tdls_channel_switch_timing - Switch timing in TDLS channel-switch
24  * @frame_timestamp: GP2 timestamp of channel-switch request/response packet
25  *	received from peer
26  * @max_offchan_duration: What amount of microseconds out of a DTIM is given
27  *	to the TDLS off-channel communication. For instance if the DTIM is
28  *	200TU and the TDLS peer is to be given 25% of the time, the value
29  *	given will be 50TU, or 50 * 1024 if translated into microseconds.
30  * @switch_time: switch time the peer sent in its channel switch timing IE
31  * @switch_timeout: switch timeout the peer sent in its channel switch timing IE
32  */
33 struct iwl_tdls_channel_switch_timing {
34 	__le32 frame_timestamp; /* GP2 time of peer packet Rx */
35 	__le32 max_offchan_duration; /* given in micro-seconds */
36 	__le32 switch_time; /* given in micro-seconds */
37 	__le32 switch_timeout; /* given in micro-seconds */
38 } __packed; /* TDLS_STA_CHANNEL_SWITCH_TIMING_DATA_API_S_VER_1 */
39 
40 #define IWL_TDLS_CH_SW_FRAME_MAX_SIZE 200
41 
42 /**
43  * struct iwl_tdls_channel_switch_frame - TDLS channel switch frame template
44  *
45  * A template representing a TDLS channel-switch request or response frame
46  *
47  * @switch_time_offset: offset to the channel switch timing IE in the template
48  * @tx_cmd: Tx parameters for the frame
49  * @data: frame data
50  */
51 struct iwl_tdls_channel_switch_frame {
52 	__le32 switch_time_offset;
53 	struct iwl_tx_cmd tx_cmd;
54 	u8 data[IWL_TDLS_CH_SW_FRAME_MAX_SIZE];
55 } __packed; /* TDLS_STA_CHANNEL_SWITCH_FRAME_API_S_VER_1 */
56 
57 /**
58  * struct iwl_tdls_channel_switch_cmd_tail - tail of iwl_tdls_channel_switch_cmd
59  *
60  * @timing: timing related data for command
61  * @frame: channel-switch request/response template, depending to switch_type
62  */
63 struct iwl_tdls_channel_switch_cmd_tail {
64 	struct iwl_tdls_channel_switch_timing timing;
65 	struct iwl_tdls_channel_switch_frame frame;
66 } __packed;
67 
68 /**
69  * struct iwl_tdls_channel_switch_cmd - TDLS channel switch command
70  *
71  * The command is sent to initiate a channel switch and also in response to
72  * incoming TDLS channel-switch request/response packets from remote peers.
73  *
74  * @switch_type: see &enum iwl_tdls_channel_switch_type
75  * @peer_sta_id: station id of TDLS peer
76  * @ci: channel we switch to
77  * @tail: command tail
78  */
79 struct iwl_tdls_channel_switch_cmd {
80 	u8 switch_type;
81 	__le32 peer_sta_id;
82 	struct iwl_fw_channel_info ci;
83 	struct iwl_tdls_channel_switch_cmd_tail tail;
84 } __packed; /* TDLS_STA_CHANNEL_SWITCH_CMD_API_S_VER_1 */
85 
86 /**
87  * struct iwl_tdls_channel_switch_notif - TDLS channel switch start notification
88  *
89  * @status: non-zero on success
90  * @offchannel_duration: duration given in microseconds
91  * @sta_id: peer currently performing the channel-switch with
92  */
93 struct iwl_tdls_channel_switch_notif {
94 	__le32 status;
95 	__le32 offchannel_duration;
96 	__le32 sta_id;
97 } __packed; /* TDLS_STA_CHANNEL_SWITCH_NTFY_API_S_VER_1 */
98 
99 /**
100  * struct iwl_tdls_sta_info - TDLS station info
101  *
102  * @sta_id: station id of the TDLS peer
103  * @tx_to_peer_tid: TID reserved vs. the peer for FW based Tx
104  * @tx_to_peer_ssn: initial SSN the FW should use for Tx on its TID vs the peer
105  * @is_initiator: 1 if the peer is the TDLS link initiator, 0 otherwise
106  */
107 struct iwl_tdls_sta_info {
108 	u8 sta_id;
109 	u8 tx_to_peer_tid;
110 	__le16 tx_to_peer_ssn;
111 	__le32 is_initiator;
112 } __packed; /* TDLS_STA_INFO_VER_1 */
113 
114 /**
115  * struct iwl_tdls_config_cmd - TDLS basic config command
116  *
117  * @id_and_color: MAC id and color being configured
118  * @tdls_peer_count: amount of currently connected TDLS peers
119  * @tx_to_ap_tid: TID reverved vs. the AP for FW based Tx
120  * @tx_to_ap_ssn: initial SSN the FW should use for Tx on its TID vs. the AP
121  * @sta_info: per-station info. Only the first tdls_peer_count entries are set
122  * @pti_req_data_offset: offset of network-level data for the PTI template
123  * @pti_req_tx_cmd: Tx parameters for PTI request template
124  * @pti_req_template: PTI request template data
125  */
126 struct iwl_tdls_config_cmd {
127 	__le32 id_and_color; /* mac id and color */
128 	u8 tdls_peer_count;
129 	u8 tx_to_ap_tid;
130 	__le16 tx_to_ap_ssn;
131 	struct iwl_tdls_sta_info sta_info[IWL_MVM_TDLS_STA_COUNT];
132 
133 	__le32 pti_req_data_offset;
134 	struct iwl_tx_cmd pti_req_tx_cmd;
135 	u8 pti_req_template[0];
136 } __packed; /* TDLS_CONFIG_CMD_API_S_VER_1 */
137 
138 /**
139  * struct iwl_tdls_config_sta_info_res - TDLS per-station config information
140  *
141  * @sta_id: station id of the TDLS peer
142  * @tx_to_peer_last_seq: last sequence number used by FW during FW-based Tx to
143  *	the peer
144  */
145 struct iwl_tdls_config_sta_info_res {
146 	__le16 sta_id;
147 	__le16 tx_to_peer_last_seq;
148 } __packed; /* TDLS_STA_INFO_RSP_VER_1 */
149 
150 /**
151  * struct iwl_tdls_config_res - TDLS config information from FW
152  *
153  * @tx_to_ap_last_seq: last sequence number used by FW during FW-based Tx to AP
154  * @sta_info: per-station TDLS config information
155  */
156 struct iwl_tdls_config_res {
157 	__le32 tx_to_ap_last_seq;
158 	struct iwl_tdls_config_sta_info_res sta_info[IWL_MVM_TDLS_STA_COUNT];
159 } __packed; /* TDLS_CONFIG_RSP_API_S_VER_1 */
160 
161 #endif /* __iwl_fw_api_tdls_h__ */
162