| 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_ */ |