2 * wpa_supplicant - Off-channel Action frame TX/RX
3 * Copyright (c) 2009-2010, Atheros Communications
4 * Copyright (c) 2011, Qualcomm Atheros
6 * This software may be distributed under the terms of the BSD license.
7 * See README for more details.
13 #include "utils/eloop.h"
14 #include "wpa_supplicant_i.h"
16 #include "offchannel.h"
20 static struct wpa_supplicant *
21 wpas_get_tx_interface(struct wpa_supplicant *wpa_s, const u8 *src)
23 struct wpa_supplicant *iface;
25 if (os_memcmp(src, wpa_s->own_addr, ETH_ALEN) == 0)
29 * Try to find a group interface that matches with the source address.
31 iface = wpa_s->global->ifaces;
33 if (os_memcmp(wpa_s->pending_action_src,
34 iface->own_addr, ETH_ALEN) == 0)
39 wpa_printf(MSG_DEBUG, "P2P: Use group interface %s "
40 "instead of interface %s for Action TX",
41 iface->ifname, wpa_s->ifname);
49 static void wpas_send_action_cb(void *eloop_ctx, void *timeout_ctx)
51 struct wpa_supplicant *wpa_s = eloop_ctx;
52 struct wpa_supplicant *iface;
56 without_roc = wpa_s->pending_action_without_roc;
57 wpa_s->pending_action_without_roc = 0;
59 "Off-channel: Send Action callback (without_roc=%d pending_action_tx=%p pending_action_tx_done=%d)",
60 without_roc, wpa_s->pending_action_tx,
61 !!wpa_s->pending_action_tx_done);
63 if (wpa_s->pending_action_tx == NULL || wpa_s->pending_action_tx_done)
67 * This call is likely going to be on the P2P device instance if the
68 * driver uses a separate interface for that purpose. However, some
69 * Action frames are actually sent within a P2P Group and when that is
70 * the case, we need to follow power saving (e.g., GO buffering the
71 * frame for a client in PS mode or a client following the advertised
72 * NoA from its GO). To make that easier for the driver, select the
73 * correct group interface here.
75 iface = wpas_get_tx_interface(wpa_s, wpa_s->pending_action_src);
77 if (wpa_s->off_channel_freq != wpa_s->pending_action_freq &&
78 wpa_s->pending_action_freq != 0 &&
79 wpa_s->pending_action_freq != iface->assoc_freq) {
80 wpa_printf(MSG_DEBUG, "Off-channel: Pending Action frame TX "
81 "waiting for another freq=%u (off_channel_freq=%u "
83 wpa_s->pending_action_freq,
84 wpa_s->off_channel_freq,
86 if (without_roc && wpa_s->off_channel_freq == 0) {
88 * We may get here if wpas_send_action() found us to be
89 * on the correct channel, but remain-on-channel cancel
90 * event was received before getting here.
92 wpa_printf(MSG_DEBUG, "Off-channel: Schedule "
93 "remain-on-channel to send Action frame");
94 if (wpa_drv_remain_on_channel(
95 wpa_s, wpa_s->pending_action_freq, 200) <
97 wpa_printf(MSG_DEBUG, "Off-channel: Failed to "
98 "request driver to remain on "
99 "channel (%u MHz) for Action Frame "
100 "TX", wpa_s->pending_action_freq);
102 wpa_s->off_channel_freq = 0;
103 wpa_s->roc_waiting_drv_freq =
104 wpa_s->pending_action_freq;
110 wpa_printf(MSG_DEBUG, "Off-channel: Sending pending Action frame to "
111 MACSTR " using interface %s",
112 MAC2STR(wpa_s->pending_action_dst), iface->ifname);
113 res = wpa_drv_send_action(iface, wpa_s->pending_action_freq, 0,
114 wpa_s->pending_action_dst,
115 wpa_s->pending_action_src,
116 wpa_s->pending_action_bssid,
117 wpabuf_head(wpa_s->pending_action_tx),
118 wpabuf_len(wpa_s->pending_action_tx),
119 wpa_s->pending_action_no_cck);
121 wpa_printf(MSG_DEBUG, "Off-channel: Failed to send the "
122 "pending Action frame");
124 * Use fake TX status event to allow state machines to
127 offchannel_send_action_tx_status(
128 wpa_s, wpa_s->pending_action_dst,
129 wpabuf_head(wpa_s->pending_action_tx),
130 wpabuf_len(wpa_s->pending_action_tx),
131 OFFCHANNEL_SEND_ACTION_FAILED);
137 * offchannel_send_action_tx_status - TX status callback
138 * @wpa_s: Pointer to wpa_supplicant data
139 * @dst: Destination MAC address of the transmitted Action frame
140 * @data: Transmitted frame payload
141 * @data_len: Length of @data in bytes
144 * This function is called whenever the driver indicates a TX status event for
145 * a frame sent by offchannel_send_action() using wpa_drv_send_action().
147 void offchannel_send_action_tx_status(
148 struct wpa_supplicant *wpa_s, const u8 *dst, const u8 *data,
149 size_t data_len, enum offchannel_send_action_result result)
151 if (wpa_s->pending_action_tx == NULL) {
152 wpa_printf(MSG_DEBUG, "Off-channel: Ignore Action TX status - "
153 "no pending operation");
157 if (os_memcmp(dst, wpa_s->pending_action_dst, ETH_ALEN) != 0) {
158 wpa_printf(MSG_DEBUG, "Off-channel: Ignore Action TX status - "
159 "unknown destination address");
163 /* Accept report only if the contents of the frame matches */
164 if (data_len - wpabuf_len(wpa_s->pending_action_tx) != 24 ||
165 os_memcmp(data + 24, wpabuf_head(wpa_s->pending_action_tx),
166 wpabuf_len(wpa_s->pending_action_tx)) != 0) {
167 wpa_printf(MSG_DEBUG, "Off-channel: Ignore Action TX status - "
168 "mismatching contents with pending frame");
169 wpa_hexdump(MSG_MSGDUMP, "TX status frame data",
171 wpa_hexdump_buf(MSG_MSGDUMP, "Pending TX frame",
172 wpa_s->pending_action_tx);
176 wpa_printf(MSG_DEBUG, "Off-channel: Delete matching pending action frame");
178 wpabuf_free(wpa_s->pending_action_tx);
179 wpa_s->pending_action_tx = NULL;
181 wpa_printf(MSG_DEBUG, "Off-channel: TX status result=%d cb=%p",
182 result, wpa_s->pending_action_tx_status_cb);
184 if (wpa_s->pending_action_tx_status_cb) {
185 wpa_s->pending_action_tx_status_cb(
186 wpa_s, wpa_s->pending_action_freq,
187 wpa_s->pending_action_dst, wpa_s->pending_action_src,
188 wpa_s->pending_action_bssid,
189 data, data_len, result);
195 * offchannel_send_action - Request off-channel Action frame TX
196 * @wpa_s: Pointer to wpa_supplicant data
197 * @freq: The frequency in MHz indicating the channel on which the frame is to
198 * transmitted or 0 for the current channel (only if associated)
199 * @dst: Action frame destination MAC address
200 * @src: Action frame source MAC address
201 * @bssid: Action frame BSSID
202 * @buf: Frame to transmit starting from the Category field
203 * @len: Length of @buf in bytes
204 * @wait_time: Wait time for response in milliseconds
205 * @tx_cb: Callback function for indicating TX status or %NULL for now callback
206 * @no_cck: Whether CCK rates are to be disallowed for TX rate selection
207 * Returns: 0 on success or -1 on failure
209 * This function is used to request an Action frame to be transmitted on the
210 * current operating channel or on another channel (off-channel). The actual
211 * frame transmission will be delayed until the driver is ready on the specified
212 * channel. The @wait_time parameter can be used to request the driver to remain
213 * awake on the channel to wait for a response.
215 int offchannel_send_action(struct wpa_supplicant *wpa_s, unsigned int freq,
216 const u8 *dst, const u8 *src, const u8 *bssid,
217 const u8 *buf, size_t len, unsigned int wait_time,
218 void (*tx_cb)(struct wpa_supplicant *wpa_s,
219 unsigned int freq, const u8 *dst,
220 const u8 *src, const u8 *bssid,
221 const u8 *data, size_t data_len,
222 enum offchannel_send_action_result
226 wpa_printf(MSG_DEBUG, "Off-channel: Send action frame: freq=%d dst="
227 MACSTR " src=" MACSTR " bssid=" MACSTR " len=%d",
228 freq, MAC2STR(dst), MAC2STR(src), MAC2STR(bssid),
231 wpa_s->pending_action_tx_status_cb = tx_cb;
233 if (wpa_s->pending_action_tx) {
234 wpa_printf(MSG_DEBUG, "Off-channel: Dropped pending Action "
235 "frame TX to " MACSTR,
236 MAC2STR(wpa_s->pending_action_dst));
237 wpabuf_free(wpa_s->pending_action_tx);
239 wpa_s->pending_action_tx_done = 0;
240 wpa_s->pending_action_tx = wpabuf_alloc(len);
241 if (wpa_s->pending_action_tx == NULL) {
242 wpa_printf(MSG_DEBUG, "Off-channel: Failed to allocate Action "
243 "frame TX buffer (len=%llu)",
244 (unsigned long long) len);
247 wpabuf_put_data(wpa_s->pending_action_tx, buf, len);
248 os_memcpy(wpa_s->pending_action_src, src, ETH_ALEN);
249 os_memcpy(wpa_s->pending_action_dst, dst, ETH_ALEN);
250 os_memcpy(wpa_s->pending_action_bssid, bssid, ETH_ALEN);
251 wpa_s->pending_action_freq = freq;
252 wpa_s->pending_action_no_cck = no_cck;
254 if (freq != 0 && wpa_s->drv_flags & WPA_DRIVER_FLAGS_OFFCHANNEL_TX) {
255 struct wpa_supplicant *iface;
258 iface = wpas_get_tx_interface(wpa_s,
259 wpa_s->pending_action_src);
260 wpa_s->action_tx_wait_time = wait_time;
262 ret = wpa_drv_send_action(
263 iface, wpa_s->pending_action_freq,
264 wait_time, wpa_s->pending_action_dst,
265 wpa_s->pending_action_src, wpa_s->pending_action_bssid,
266 wpabuf_head(wpa_s->pending_action_tx),
267 wpabuf_len(wpa_s->pending_action_tx),
268 wpa_s->pending_action_no_cck);
270 wpa_s->pending_action_tx_done = 1;
275 struct wpa_supplicant *tx_iface;
276 tx_iface = wpas_get_tx_interface(wpa_s, src);
277 if (tx_iface->assoc_freq == freq) {
278 wpa_printf(MSG_DEBUG, "Off-channel: Already on "
279 "requested channel (TX interface operating "
285 if (wpa_s->off_channel_freq == freq || freq == 0) {
286 wpa_printf(MSG_DEBUG, "Off-channel: Already on requested "
287 "channel; send Action frame immediately");
288 /* TODO: Would there ever be need to extend the current
289 * duration on the channel? */
290 wpa_s->pending_action_without_roc = 1;
291 eloop_cancel_timeout(wpas_send_action_cb, wpa_s, NULL);
292 eloop_register_timeout(0, 0, wpas_send_action_cb, wpa_s, NULL);
295 wpa_s->pending_action_without_roc = 0;
297 if (wpa_s->roc_waiting_drv_freq == freq) {
298 wpa_printf(MSG_DEBUG, "Off-channel: Already waiting for "
299 "driver to get to frequency %u MHz; continue "
300 "waiting to send the Action frame", freq);
304 wpa_printf(MSG_DEBUG, "Off-channel: Schedule Action frame to be "
305 "transmitted once the driver gets to the requested "
307 if (wait_time > wpa_s->max_remain_on_chan)
308 wait_time = wpa_s->max_remain_on_chan;
309 else if (wait_time == 0)
311 if (wpa_drv_remain_on_channel(wpa_s, freq, wait_time) < 0) {
312 wpa_printf(MSG_DEBUG, "Off-channel: Failed to request driver "
313 "to remain on channel (%u MHz) for Action "
317 wpa_s->off_channel_freq = 0;
318 wpa_s->roc_waiting_drv_freq = freq;
325 * offchannel_send_send_action_done - Notify completion of Action frame sequence
326 * @wpa_s: Pointer to wpa_supplicant data
328 * This function can be used to cancel a wait for additional response frames on
329 * the channel that was used with offchannel_send_action().
331 void offchannel_send_action_done(struct wpa_supplicant *wpa_s)
333 wpa_printf(MSG_DEBUG, "Off-channel: Action frame sequence done "
335 wpabuf_free(wpa_s->pending_action_tx);
336 wpa_s->pending_action_tx = NULL;
337 if (wpa_s->drv_flags & WPA_DRIVER_FLAGS_OFFCHANNEL_TX &&
338 wpa_s->action_tx_wait_time)
339 wpa_drv_send_action_cancel_wait(wpa_s);
341 if (wpa_s->off_channel_freq || wpa_s->roc_waiting_drv_freq) {
342 wpa_drv_cancel_remain_on_channel(wpa_s);
343 wpa_s->off_channel_freq = 0;
344 wpa_s->roc_waiting_drv_freq = 0;
350 * offchannel_remain_on_channel_cb - Remain-on-channel callback function
351 * @wpa_s: Pointer to wpa_supplicant data
352 * @freq: Frequency (in MHz) of the selected channel
353 * @duration: Duration of the remain-on-channel operation in milliseconds
355 * This function is called whenever the driver notifies beginning of a
356 * remain-on-channel operation.
358 void offchannel_remain_on_channel_cb(struct wpa_supplicant *wpa_s,
359 unsigned int freq, unsigned int duration)
361 wpa_s->roc_waiting_drv_freq = 0;
362 wpa_s->off_channel_freq = freq;
363 wpas_send_action_cb(wpa_s, NULL);
368 * offchannel_cancel_remain_on_channel_cb - Remain-on-channel stopped callback
369 * @wpa_s: Pointer to wpa_supplicant data
370 * @freq: Frequency (in MHz) of the selected channel
372 * This function is called whenever the driver notifies termination of a
373 * remain-on-channel operation.
375 void offchannel_cancel_remain_on_channel_cb(struct wpa_supplicant *wpa_s,
378 wpa_s->off_channel_freq = 0;
383 * offchannel_pending_action_tx - Check whether there is a pending Action TX
384 * @wpa_s: Pointer to wpa_supplicant data
385 * Returns: Pointer to pending frame or %NULL if no pending operation
387 * This function can be used to check whether there is a pending Action frame TX
388 * operation. The returned pointer should be used only for checking whether it
389 * is %NULL (no pending frame) or to print the pointer value in debug
390 * information (i.e., the pointer should not be dereferenced).
392 const void * offchannel_pending_action_tx(struct wpa_supplicant *wpa_s)
394 return wpa_s->pending_action_tx;
399 * offchannel_clear_pending_action_tx - Clear pending Action frame TX
400 * @wpa_s: Pointer to wpa_supplicant data
402 void offchannel_clear_pending_action_tx(struct wpa_supplicant *wpa_s)
404 wpabuf_free(wpa_s->pending_action_tx);
405 wpa_s->pending_action_tx = NULL;
410 * offchannel_deinit - Deinit off-channel operations
411 * @wpa_s: Pointer to wpa_supplicant data
413 * This function is used to free up any allocated resources for off-channel
416 void offchannel_deinit(struct wpa_supplicant *wpa_s)
418 offchannel_clear_pending_action_tx(wpa_s);
419 eloop_cancel_timeout(wpas_send_action_cb, wpa_s, NULL);