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: head/sys/net80211/ieee80211_tdma.h 192468 2009-05-20 20:00:40Z sam $
27  * $DragonFly$
28  */
29 #ifndef _NET80211_IEEE80211_TDMA_H_
30 #define _NET80211_IEEE80211_TDMA_H_
31 
32 /*
33  * TDMA-mode implementation definitions.
34  */
35 
36 #define	TDMA_SUBTYPE_PARAM	0x01
37 #define	TDMA_VERSION_V2		2
38 #define	TDMA_VERSION		TDMA_VERSION_V2
39 
40 /* NB: we only support 2 right now but protocol handles up to 8 */
41 #define	TDMA_MAXSLOTS		2	/* max slots/sta's */
42 
43 #define	TDMA_PARAM_LEN_V2	sizeof(struct ieee80211_tdma_param)
44 
45 /*
46  * TDMA information element.
47  */
48 struct ieee80211_tdma_param {
49 	u_int8_t	tdma_id;	/* IEEE80211_ELEMID_VENDOR */
50 	u_int8_t	tdma_len;
51 	u_int8_t	tdma_oui[3];	/* TDMA_OUI */
52 	u_int8_t	tdma_type;	/* TDMA_OUI_TYPE */
53 	u_int8_t	tdma_subtype;	/* TDMA_SUBTYPE_PARAM */
54 	u_int8_t	tdma_version;	/* spec revision */
55 	u_int8_t	tdma_slot;	/* station slot # [0..7] */
56 	u_int8_t	tdma_slotcnt;	/* bss slot count [1..8] */
57 	u_int16_t	tdma_slotlen;	/* bss slot len (100us) */
58 	u_int8_t	tdma_bintval;	/* beacon interval (superframes) */
59 	u_int8_t	tdma_inuse[1];	/* slot occupancy map */
60 	u_int8_t	tdma_pad[2];
61 	u_int8_t	tdma_tstamp[8];	/* timestamp from last beacon */
62 } __packed;
63 
64 #ifdef _KERNEL
65 /*
66  * Implementation state.
67  */
68 struct ieee80211_tdma_state {
69 	u_int	tdma_slotlen;		/* bss slot length (us) */
70 	uint8_t	tdma_version;		/* protocol version to use */
71 	uint8_t	tdma_slotcnt;		/* bss slot count */
72 	uint8_t	tdma_bintval;		/* beacon interval (slots) */
73 	uint8_t	tdma_slot;		/* station slot # */
74 	uint8_t	tdma_inuse[1];		/* mask of slots in use */
75 	uint8_t	tdma_active[1];		/* mask of active slots */
76 	int	tdma_count;		/* active/inuse countdown */
77 	void	*tdma_peer;		/* peer station cookie */
78 	struct timeval tdma_lastprint;	/* time of last rate-limited printf */
79 	int	tdma_fails;		/* fail count for rate-limiting */
80 
81 	/* parent method pointers */
82 	int	(*tdma_newstate)(struct ieee80211vap *, enum ieee80211_state,
83 		    int arg);
84 	void	(*tdma_recv_mgmt)(struct ieee80211_node *,
85 		    struct mbuf *, int, 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