xref: /dragonfly/sys/netproto/802_11/ieee80211_superg.h (revision 4f655ef568316df0b575f05cebf37546415c0d24)
1 /*-
2  * Copyright (c) 2009 Sam Leffler, Errno Consulting
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  *
25  * $FreeBSD$
26  */
27 #ifndef _NET80211_IEEE80211_SUPERG_H_
28 #define _NET80211_IEEE80211_SUPERG_H_
29 
30 /*
31  * Atheros' 802.11 SuperG protocol support.
32  */
33 
34 /*
35  * Atheros advanced capability information element.
36  */
37 struct ieee80211_ath_ie {
38           uint8_t             ath_id;                       /* IEEE80211_ELEMID_VENDOR */
39           uint8_t             ath_len;            /* length in bytes */
40           uint8_t             ath_oui[3];                   /* ATH_OUI */
41           uint8_t             ath_oui_type;                 /* ATH_OUI_TYPE */
42           uint8_t             ath_oui_subtype;    /* ATH_OUI_SUBTYPE */
43           uint8_t             ath_version;                  /* spec revision */
44           uint8_t             ath_capability;               /* capability info */
45 #define   ATHEROS_CAP_TURBO_PRIME                 0x01      /* dynamic turbo--aka Turbo' */
46 #define   ATHEROS_CAP_COMPRESSION                 0x02      /* data compression */
47 #define   ATHEROS_CAP_FAST_FRAME                  0x04      /* fast (jumbo) frames */
48 #define   ATHEROS_CAP_XR                          0x08      /* Xtended Range support */
49 #define   ATHEROS_CAP_AR                          0x10      /* Advanded Radar support */
50 #define   ATHEROS_CAP_BURST             0x20      /* Bursting - not negotiated */
51 #define   ATHEROS_CAP_WME                         0x40      /* CWMin tuning */
52 #define   ATHEROS_CAP_BOOST             0x80      /* use turbo/!turbo mode */
53           uint8_t             ath_defkeyix[2];
54 } __packed;
55 
56 #define   ATH_OUI_VERSION               0x00
57 #define   ATH_OUI_SUBTYPE               0x01
58 
59 #ifdef _KERNEL
60 struct ieee80211_stageq {
61           struct mbuf                   *head;              /* frames linked w/ m_nextpkt */
62           struct mbuf                   *tail;              /* last frame in queue */
63           int                           depth;              /* # items on head */
64 };
65 
66 struct ieee80211_superg {
67           /* fast-frames staging q */
68           struct ieee80211_stageq       ff_stageq[WME_NUM_AC];
69 };
70 
71 void      ieee80211_superg_attach(struct ieee80211com *);
72 void      ieee80211_superg_detach(struct ieee80211com *);
73 void      ieee80211_superg_vattach(struct ieee80211vap *);
74 void      ieee80211_superg_vdetach(struct ieee80211vap *);
75 
76 uint8_t *ieee80211_add_ath(uint8_t *, uint8_t, ieee80211_keyix);
77 uint8_t *ieee80211_add_athcaps(uint8_t *, const struct ieee80211_node *);
78 void      ieee80211_parse_ath(struct ieee80211_node *, uint8_t *);
79 int       ieee80211_parse_athparams(struct ieee80211_node *, uint8_t *,
80               const struct ieee80211_frame *);
81 
82 void      ieee80211_ff_node_init(struct ieee80211_node *);
83 void      ieee80211_ff_node_cleanup(struct ieee80211_node *);
84 
85 static inline int
ieee80211_amsdu_tx_ok(struct ieee80211_node * ni)86 ieee80211_amsdu_tx_ok(struct ieee80211_node *ni)
87 {
88 
89           /* First: software A-MSDU transmit? */
90           if ((ni->ni_ic->ic_caps & IEEE80211_C_SWAMSDUTX) == 0)
91                     return (0);
92 
93           /* Next: does the VAP have AMSDU TX enabled? */
94           if ((ni->ni_vap->iv_flags_ht & IEEE80211_FHT_AMSDU_TX) == 0)
95                     return (0);
96 
97           /* Next: 11n node? (assumed that A-MSDU TX to HT nodes is ok */
98           if ((ni->ni_flags & IEEE80211_NODE_HT) == 0)
99                     return (0);
100 
101           /* ok, we can at least /do/ AMSDU to this node */
102           return (1);
103 }
104 
105 struct mbuf * ieee80211_amsdu_check(struct ieee80211_node *ni, struct mbuf *m);
106 struct mbuf *ieee80211_ff_check(struct ieee80211_node *, struct mbuf *);
107 void      ieee80211_ff_age(struct ieee80211com *, struct ieee80211_stageq *,
108                int quanta);
109 
110 /*
111  * See ieee80211_ff_age() for a description of the locking
112  * expectation here.
113  */
114 static __inline void
ieee80211_ff_flush(struct ieee80211com * ic,int ac)115 ieee80211_ff_flush(struct ieee80211com *ic, int ac)
116 {
117           struct ieee80211_superg *sg = ic->ic_superg;
118 
119           if (sg != NULL && sg->ff_stageq[ac].depth)
120                     ieee80211_ff_age(ic, &sg->ff_stageq[ac], 0x7fffffff);
121 }
122 
123 /*
124  * See ieee80211_ff_age() for a description of the locking
125  * expectation here.
126  */
127 static __inline void
ieee80211_ff_age_all(struct ieee80211com * ic,int quanta)128 ieee80211_ff_age_all(struct ieee80211com *ic, int quanta)
129 {
130           struct ieee80211_superg *sg = ic->ic_superg;
131 
132           if (sg != NULL) {
133                     if (sg->ff_stageq[WME_AC_VO].depth)
134                               ieee80211_ff_age(ic, &sg->ff_stageq[WME_AC_VO], quanta);
135                     if (sg->ff_stageq[WME_AC_VI].depth)
136                               ieee80211_ff_age(ic, &sg->ff_stageq[WME_AC_VI], quanta);
137                     if (sg->ff_stageq[WME_AC_BE].depth)
138                               ieee80211_ff_age(ic, &sg->ff_stageq[WME_AC_BE], quanta);
139                     if (sg->ff_stageq[WME_AC_BK].depth)
140                               ieee80211_ff_age(ic, &sg->ff_stageq[WME_AC_BK], quanta);
141           }
142 }
143 
144 struct mbuf *ieee80211_ff_encap(struct ieee80211vap *, struct mbuf *,
145               int, struct ieee80211_key *);
146 struct mbuf * ieee80211_amsdu_encap(struct ieee80211vap *vap, struct mbuf *m1,
147               int hdrspace, struct ieee80211_key *key);
148 
149 struct mbuf *ieee80211_ff_decap(struct ieee80211_node *, struct mbuf *);
150 
151 static __inline struct mbuf *
ieee80211_decap_fastframe(struct ieee80211vap * vap,struct ieee80211_node * ni,struct mbuf * m)152 ieee80211_decap_fastframe(struct ieee80211vap *vap, struct ieee80211_node *ni,
153     struct mbuf *m)
154 {
155           return IEEE80211_ATH_CAP(vap, ni, IEEE80211_NODE_FF) ?
156               ieee80211_ff_decap(ni, m) : m;
157 }
158 #endif /* _KERNEL */
159 #endif /* _NET80211_IEEE80211_SUPERG_H_ */
160