xref: /freebsd/sys/net80211/ieee80211_tdma.h (revision 7fdf597e96a02165cfe22ff357b857d5fa15ed8a)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2007-2009 Sam Leffler, Errno Consulting
5  * Copyright (c) 2007-2009 Intel Corporation
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
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