xref: /dragonfly/sys/netproto/802_11/ieee80211_tdma.h (revision 4f8987191685094ced50a1d8a22484df5224696d)
1 /*-
2  * Copyright (c) 2007-2009 Sam Leffler, Errno Consulting
3  * Copyright (c) 2007-2009 Intel Corporation
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 #ifndef _NET80211_IEEE80211_TDMA_H_
29 #define _NET80211_IEEE80211_TDMA_H_
30 
31 /*
32  * TDMA-mode implementation definitions.
33  */
34 
35 #define   TDMA_SUBTYPE_PARAM  0x01
36 #define   TDMA_VERSION_V2               2
37 #define   TDMA_VERSION                  TDMA_VERSION_V2
38 
39 /* NB: we only support 2 right now but protocol handles up to 8 */
40 #define   TDMA_MAXSLOTS                 2         /* max slots/sta's */
41 
42 #define   TDMA_PARAM_LEN_V2   sizeof(struct ieee80211_tdma_param)
43 
44 /*
45  * TDMA information element.
46  */
47 struct ieee80211_tdma_param {
48           u_int8_t  tdma_id;  /* IEEE80211_ELEMID_VENDOR */
49           u_int8_t  tdma_len;
50           u_int8_t  tdma_oui[3];        /* TDMA_OUI */
51           u_int8_t  tdma_type;          /* TDMA_OUI_TYPE */
52           u_int8_t  tdma_subtype;       /* TDMA_SUBTYPE_PARAM */
53           u_int8_t  tdma_version;       /* spec revision */
54           u_int8_t  tdma_slot;          /* station slot # [0..7] */
55           u_int8_t  tdma_slotcnt;       /* bss slot count [1..8] */
56           u_int16_t tdma_slotlen;       /* bss slot len (100us) */
57           u_int8_t  tdma_bintval;       /* beacon interval (superframes) */
58           u_int8_t  tdma_inuse[1];      /* slot occupancy map */
59           u_int8_t  tdma_pad[2];
60           u_int8_t  tdma_tstamp[8];     /* timestamp from last beacon */
61 } __packed;
62 
63 #ifdef _KERNEL
64 /*
65  * Implementation state.
66  */
67 struct ieee80211_tdma_state {
68           u_int     tdma_slotlen;                 /* bss slot length (us) */
69           uint8_t   tdma_version;                 /* protocol version to use */
70           uint8_t   tdma_slotcnt;                 /* bss slot count */
71           uint8_t   tdma_bintval;                 /* beacon interval (slots) */
72           uint8_t   tdma_slot;                    /* station slot # */
73           uint8_t   tdma_inuse[1];                /* mask of slots in use */
74           uint8_t   tdma_active[1];               /* mask of active slots */
75           int       tdma_count;                   /* active/inuse countdown */
76           void      *tdma_peer;                   /* peer station cookie */
77           struct timeval tdma_lastprint;          /* time of last rate-limited printf */
78           int       tdma_fails;                   /* fail count for rate-limiting */
79 
80           /* parent method pointers */
81           int       (*tdma_newstate)(struct ieee80211vap *, enum ieee80211_state,
82                         int arg);
83           void      (*tdma_recv_mgmt)(struct ieee80211_node *,
84                         struct mbuf *, int,
85                         const struct ieee80211_rx_stats *rxs, int, int);
86           void      (*tdma_opdetach)(struct ieee80211vap *);
87 };
88 
89 #define   TDMA_UPDATE_SLOT    0x0001    /* tdma_slot changed */
90 #define   TDMA_UPDATE_SLOTCNT 0x0002    /* tdma_slotcnt changed */
91 #define   TDMA_UPDATE_SLOTLEN 0x0004    /* tdma_slotlen changed */
92 #define   TDMA_UPDATE_BINTVAL 0x0008    /* tdma_bintval changed */
93 
94 void      ieee80211_tdma_vattach(struct ieee80211vap *);
95 
96 int       ieee80211_tdma_getslot(struct ieee80211vap *vap);
97 void      ieee80211_parse_tdma(struct ieee80211_node *ni, const uint8_t *ie);
98 uint8_t *ieee80211_add_tdma(uint8_t *frm, struct ieee80211vap *vap);
99 struct ieee80211_beacon_offsets;
100 void      ieee80211_tdma_update_beacon(struct ieee80211vap *vap,
101               struct ieee80211_beacon_offsets *bo);
102 #endif /* _KERNEL */
103 #endif /* !_NET80211_IEEE80211_TDMA_H_ */
104