sys/netproto/802_11/ieee80211_tdma.h

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