mirror of
https://github.com/freebsd/freebsd-src
synced 2024-10-18 14:23:55 +00:00
22a3aee637
PS-POLL support. This implements PS-POLL awareness i nthe * Implement frame "leaking", which allows for a software queue to be scheduled even though it's asleep * Track whether a frame has been leaked or not * Leak out a single non-AMPDU frame when transmitting aggregates * Queue BAR frames if the node is asleep * Direct-dispatch the rest of control and management frames. This allows for things like re-association to occur (which involves sending probe req/resp as well as assoc request/response) when the node is asleep and then tries reassociating. * Limit how many frames can set in the software node queue whilst the node is asleep. net80211 is already buffering frames for us so this is mostly just paranoia. * Add a PS-POLL method which leaks out a frame if there's something in the software queue, else it calls net80211's ps-poll routine. Since the ath PS-POLL routine marks the node as having a single frame to leak, either a software queued frame would leak, OR the next queued frame would leak. The next queued frame could be something from the net80211 power save queue, OR it could be a NULL frame from net80211. TODO: * Don't transmit further BAR frames (eg via a timeout) if the node is currently asleep. Otherwise we may end up exhausting management frames due to the lots of queued BAR frames. I may just undo this bit later on and direct-dispatch BAR frames even if the node is asleep. * It would be nice to burst out a single A-MPDU frame if both ends support this. I may end adding a FreeBSD IE soon to negotiate this power save behaviour. * I should make STAs timeout of power save mode if they've been in power save for more than a handful of seconds. This way cards that get "stuck" in power save mode don't stay there for the "inactivity" timeout in net80211. * Move the queue depth check into the driver layer (ath_start / ath_transmit) rather than doing it in the TX path. * There could be some naughty corner cases with ps-poll leaking. Specifically, if net80211 generates a NULL data frame whilst another transmitter sends a normal data frame out net80211 output / transmit, we need to ensure that the NULL data frame goes out first. This is one of those things that should occur inside the VAP/ic TX lock. Grr, more investigations to do.. Tested: * STA: AR5416, AR9280 * AP: AR5416, AR9280, AR9160
169 lines
6 KiB
C
169 lines
6 KiB
C
/*-
|
|
* Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer,
|
|
* without modification.
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
* similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
|
|
* redistribution must be conditioned upon including a substantially
|
|
* similar Disclaimer requirement for further binary redistribution.
|
|
*
|
|
* NO WARRANTY
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
* THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
|
|
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
|
|
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
|
|
* THE POSSIBILITY OF SUCH DAMAGES.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
#ifndef __IF_ATH_TX_H__
|
|
#define __IF_ATH_TX_H__
|
|
|
|
/*
|
|
* some general macros
|
|
*/
|
|
#define INCR(_l, _sz) (_l) ++; (_l) &= ((_sz) - 1)
|
|
/*
|
|
* return block-ack bitmap index given sequence and starting sequence
|
|
*/
|
|
#define ATH_BA_INDEX(_st, _seq) (((_seq) - (_st)) & (IEEE80211_SEQ_RANGE - 1))
|
|
|
|
#define WME_BA_BMP_SIZE 64
|
|
#define WME_MAX_BA WME_BA_BMP_SIZE
|
|
|
|
/*
|
|
* How 'busy' to try and keep the hardware txq
|
|
*/
|
|
#define ATH_AGGR_MIN_QDEPTH 2
|
|
|
|
/*
|
|
* Watermark for scheduling TIDs in order to maximise aggregation.
|
|
*
|
|
* If hwq_depth is greater than this, don't schedule the TID
|
|
* for packet scheduling - the hardware is already busy servicing
|
|
* this TID.
|
|
*
|
|
* If hwq_depth is less than this, schedule the TID for packet
|
|
* scheduling in the completion handler.
|
|
*/
|
|
#define ATH_AGGR_SCHED_HIGH 4
|
|
#define ATH_AGGR_SCHED_LOW 2
|
|
|
|
/*
|
|
* return whether a bit at index _n in bitmap _bm is set
|
|
* _sz is the size of the bitmap
|
|
*/
|
|
#define ATH_BA_ISSET(_bm, _n) (((_n) < (WME_BA_BMP_SIZE)) && \
|
|
((_bm)[(_n) >> 5] & (1 << ((_n) & 31))))
|
|
|
|
|
|
/* extracting the seqno from buffer seqno */
|
|
#define SEQNO(_a) ((_a) >> IEEE80211_SEQ_SEQ_SHIFT)
|
|
|
|
/*
|
|
* Whether the current sequence number is within the
|
|
* BAW.
|
|
*/
|
|
#define BAW_WITHIN(_start, _bawsz, _seqno) \
|
|
((((_seqno) - (_start)) & 4095) < (_bawsz))
|
|
|
|
/*
|
|
* Maximum aggregate size
|
|
*/
|
|
#define ATH_AGGR_MAXSIZE 65530
|
|
|
|
extern void ath_freetx(struct mbuf *m);
|
|
extern void ath_tx_node_flush(struct ath_softc *sc, struct ath_node *an);
|
|
extern void ath_tx_txq_drain(struct ath_softc *sc, struct ath_txq *txq);
|
|
extern void ath_txfrag_cleanup(struct ath_softc *sc, ath_bufhead *frags,
|
|
struct ieee80211_node *ni);
|
|
extern int ath_txfrag_setup(struct ath_softc *sc, ath_bufhead *frags,
|
|
struct mbuf *m0, struct ieee80211_node *ni);
|
|
extern int ath_tx_start(struct ath_softc *sc, struct ieee80211_node *ni,
|
|
struct ath_buf *bf, struct mbuf *m0);
|
|
extern int ath_raw_xmit(struct ieee80211_node *ni, struct mbuf *m,
|
|
const struct ieee80211_bpf_params *params);
|
|
|
|
/* software queue stuff */
|
|
extern void ath_tx_swq(struct ath_softc *sc, struct ieee80211_node *ni,
|
|
struct ath_txq *txq, int queue_to_head, struct ath_buf *bf);
|
|
extern void ath_tx_tid_init(struct ath_softc *sc, struct ath_node *an);
|
|
extern void ath_tx_tid_hw_queue_aggr(struct ath_softc *sc, struct ath_node *an,
|
|
struct ath_tid *tid);
|
|
extern void ath_tx_tid_hw_queue_norm(struct ath_softc *sc, struct ath_node *an,
|
|
struct ath_tid *tid);
|
|
extern void ath_txq_sched(struct ath_softc *sc, struct ath_txq *txq);
|
|
extern void ath_tx_normal_comp(struct ath_softc *sc, struct ath_buf *bf,
|
|
int fail);
|
|
extern void ath_tx_aggr_comp(struct ath_softc *sc, struct ath_buf *bf,
|
|
int fail);
|
|
extern void ath_tx_addto_baw(struct ath_softc *sc, struct ath_node *an,
|
|
struct ath_tid *tid, struct ath_buf *bf);
|
|
extern struct ieee80211_tx_ampdu * ath_tx_get_tx_tid(struct ath_node *an,
|
|
int tid);
|
|
extern void ath_tx_tid_sched(struct ath_softc *sc, struct ath_tid *tid);
|
|
|
|
/* TX addba handling */
|
|
extern int ath_addba_request(struct ieee80211_node *ni,
|
|
struct ieee80211_tx_ampdu *tap, int dialogtoken,
|
|
int baparamset, int batimeout);
|
|
extern int ath_addba_response(struct ieee80211_node *ni,
|
|
struct ieee80211_tx_ampdu *tap, int dialogtoken,
|
|
int code, int batimeout);
|
|
extern void ath_addba_stop(struct ieee80211_node *ni,
|
|
struct ieee80211_tx_ampdu *tap);
|
|
extern void ath_bar_response(struct ieee80211_node *ni,
|
|
struct ieee80211_tx_ampdu *tap, int status);
|
|
extern void ath_addba_response_timeout(struct ieee80211_node *ni,
|
|
struct ieee80211_tx_ampdu *tap);
|
|
|
|
/*
|
|
* AP mode power save handling (of stations)
|
|
*/
|
|
extern void ath_tx_node_sleep(struct ath_softc *sc, struct ath_node *an);
|
|
extern void ath_tx_node_wakeup(struct ath_softc *sc, struct ath_node *an);
|
|
extern int ath_tx_node_is_asleep(struct ath_softc *sc, struct ath_node *an);
|
|
extern void ath_tx_node_reassoc(struct ath_softc *sc, struct ath_node *an);
|
|
|
|
/*
|
|
* Hardware queue stuff
|
|
*/
|
|
extern void ath_tx_push_pending(struct ath_softc *sc, struct ath_txq *txq);
|
|
|
|
/*
|
|
* Misc debugging stuff
|
|
*/
|
|
#ifdef ATH_DEBUG_ALQ
|
|
extern void ath_tx_alq_post(struct ath_softc *sc, struct ath_buf *bf_first);
|
|
#endif /* ATH_DEBUG_ALQ */
|
|
|
|
/*
|
|
* Setup path
|
|
*/
|
|
#define ath_txdma_setup(_sc) \
|
|
(_sc)->sc_tx.xmit_setup(_sc)
|
|
#define ath_txdma_teardown(_sc) \
|
|
(_sc)->sc_tx.xmit_teardown(_sc)
|
|
#define ath_txq_restart_dma(_sc, _txq) \
|
|
(_sc)->sc_tx.xmit_dma_restart((_sc), (_txq))
|
|
#define ath_tx_handoff(_sc, _txq, _bf) \
|
|
(_sc)->sc_tx.xmit_handoff((_sc), (_txq), (_bf))
|
|
#define ath_draintxq(_sc, _rtype) \
|
|
(_sc)->sc_tx.xmit_drain((_sc), (_rtype))
|
|
|
|
extern void ath_xmit_setup_legacy(struct ath_softc *sc);
|
|
|
|
#endif
|