1/*-
2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
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 * $FreeBSD: releng/12.0/sys/net80211/ieee80211_tdma.h 326272 2017-11-27 15:23:17Z pfg $
29 */
30#ifndef _NET80211_IEEE80211_TDMA_H_
31#define _NET80211_IEEE80211_TDMA_H_
32
33/*
34 * TDMA-mode implementation definitions.
35 */
36
37#define	TDMA_SUBTYPE_PARAM	0x01
38#define	TDMA_VERSION_V2		2
39#define	TDMA_VERSION		TDMA_VERSION_V2
40
41/* NB: we only support 2 right now but protocol handles up to 8 */
42#define	TDMA_MAXSLOTS		2	/* max slots/sta's */
43
44#define	TDMA_PARAM_LEN_V2	sizeof(struct ieee80211_tdma_param)
45
46/*
47 * TDMA information element.
48 */
49struct ieee80211_tdma_param {
50	u_int8_t	tdma_id;	/* IEEE80211_ELEMID_VENDOR */
51	u_int8_t	tdma_len;
52	u_int8_t	tdma_oui[3];	/* TDMA_OUI */
53	u_int8_t	tdma_type;	/* TDMA_OUI_TYPE */
54	u_int8_t	tdma_subtype;	/* TDMA_SUBTYPE_PARAM */
55	u_int8_t	tdma_version;	/* spec revision */
56	u_int8_t	tdma_slot;	/* station slot # [0..7] */
57	u_int8_t	tdma_slotcnt;	/* bss slot count [1..8] */
58	u_int16_t	tdma_slotlen;	/* bss slot len (100us) */
59	u_int8_t	tdma_bintval;	/* beacon interval (superframes) */
60	u_int8_t	tdma_inuse[1];	/* slot occupancy map */
61	u_int8_t	tdma_pad[2];
62	u_int8_t	tdma_tstamp[8];	/* timestamp from last beacon */
63} __packed;
64
65#ifdef _KERNEL
66/*
67 * Implementation state.
68 */
69struct ieee80211_tdma_state {
70	u_int	tdma_slotlen;		/* bss slot length (us) */
71	uint8_t	tdma_version;		/* protocol version to use */
72	uint8_t	tdma_slotcnt;		/* bss slot count */
73	uint8_t	tdma_bintval;		/* beacon interval (slots) */
74	uint8_t	tdma_slot;		/* station slot # */
75	uint8_t	tdma_inuse[1];		/* mask of slots in use */
76	uint8_t	tdma_active[1];		/* mask of active slots */
77	int	tdma_count;		/* active/inuse countdown */
78	void	*tdma_peer;		/* peer station cookie */
79	struct timeval tdma_lastprint;	/* time of last rate-limited printf */
80	int	tdma_fails;		/* fail count for rate-limiting */
81
82	/* parent method pointers */
83	int	(*tdma_newstate)(struct ieee80211vap *, enum ieee80211_state,
84		    int arg);
85	void	(*tdma_recv_mgmt)(struct ieee80211_node *,
86		    struct mbuf *, int,
87		    const struct ieee80211_rx_stats *rxs, int, int);
88	void	(*tdma_opdetach)(struct ieee80211vap *);
89};
90
91#define	TDMA_UPDATE_SLOT	0x0001	/* tdma_slot changed */
92#define	TDMA_UPDATE_SLOTCNT	0x0002	/* tdma_slotcnt changed */
93#define	TDMA_UPDATE_SLOTLEN	0x0004	/* tdma_slotlen changed */
94#define	TDMA_UPDATE_BINTVAL	0x0008	/* tdma_bintval changed */
95
96void	ieee80211_tdma_vattach(struct ieee80211vap *);
97
98int	ieee80211_tdma_getslot(struct ieee80211vap *vap);
99void	ieee80211_parse_tdma(struct ieee80211_node *ni, const uint8_t *ie);
100uint8_t *ieee80211_add_tdma(uint8_t *frm, struct ieee80211vap *vap);
101struct ieee80211_beacon_offsets;
102void	ieee80211_tdma_update_beacon(struct ieee80211vap *vap,
103	    struct ieee80211_beacon_offsets *bo);
104#endif /* _KERNEL */
105#endif /* !_NET80211_IEEE80211_TDMA_H_ */
106