1/*
2 * 802.11e protocol header file
3 *
4 * Copyright (C) 1999-2012, Broadcom Corporation
5 *
6 *      Unless you and Broadcom execute a separate written software license
7 * agreement governing use of this software, this software is licensed to you
8 * under the terms of the GNU General Public License version 2 (the "GPL"),
9 * available at http://www.broadcom.com/licenses/GPLv2.php, with the
10 * following added to such license:
11 *
12 *      As a special exception, the copyright holders of this software give you
13 * permission to link this software with independent modules, and to copy and
14 * distribute the resulting executable under terms of your choice, provided that
15 * you also meet, for each linked independent module, the terms and conditions of
16 * the license of that module.  An independent module is a module which is not
17 * derived from this software.  The special exception does not apply to any
18 * modifications of the software.
19 *
20 *      Notwithstanding the above, under no circumstances may you combine this
21 * software in any way with any other Broadcom software provided under a license
22 * other than the GPL, without Broadcom's express prior written consent.
23 *
24 * $Id: 802.11e.h 241182 2011-02-17 21:50:03Z $
25 */
26
27#ifndef _802_11e_H_
28#define _802_11e_H_
29
30#ifndef _TYPEDEFS_H_
31#include <typedefs.h>
32#endif
33
34/* This marks the start of a packed structure section. */
35#include <packed_section_start.h>
36
37
38/* WME Traffic Specification (TSPEC) element */
39#define WME_TSPEC_HDR_LEN           2           /* WME TSPEC header length */
40#define WME_TSPEC_BODY_OFF          2           /* WME TSPEC body offset */
41
42#define WME_CATEGORY_CODE_OFFSET	0		/* WME Category code offset */
43#define WME_ACTION_CODE_OFFSET		1		/* WME Action code offset */
44#define WME_TOKEN_CODE_OFFSET		2		/* WME Token code offset */
45#define WME_STATUS_CODE_OFFSET		3		/* WME Status code offset */
46
47BWL_PRE_PACKED_STRUCT struct tsinfo {
48	uint8 octets[3];
49} BWL_POST_PACKED_STRUCT;
50
51typedef struct tsinfo tsinfo_t;
52
53/* 802.11e TSPEC IE */
54typedef BWL_PRE_PACKED_STRUCT struct tspec {
55	uint8 oui[DOT11_OUI_LEN];	/* WME_OUI */
56	uint8 type;					/* WME_TYPE */
57	uint8 subtype;				/* WME_SUBTYPE_TSPEC */
58	uint8 version;				/* WME_VERSION */
59	tsinfo_t tsinfo;			/* TS Info bit field */
60	uint16 nom_msdu_size;		/* (Nominal or fixed) MSDU Size (bytes) */
61	uint16 max_msdu_size;		/* Maximum MSDU Size (bytes) */
62	uint32 min_srv_interval;	/* Minimum Service Interval (us) */
63	uint32 max_srv_interval;	/* Maximum Service Interval (us) */
64	uint32 inactivity_interval;	/* Inactivity Interval (us) */
65	uint32 suspension_interval; /* Suspension Interval (us) */
66	uint32 srv_start_time;		/* Service Start Time (us) */
67	uint32 min_data_rate;		/* Minimum Data Rate (bps) */
68	uint32 mean_data_rate;		/* Mean Data Rate (bps) */
69	uint32 peak_data_rate;		/* Peak Data Rate (bps) */
70	uint32 max_burst_size;		/* Maximum Burst Size (bytes) */
71	uint32 delay_bound;			/* Delay Bound (us) */
72	uint32 min_phy_rate;		/* Minimum PHY Rate (bps) */
73	uint16 surplus_bw;			/* Surplus Bandwidth Allowance (range 1.0-8.0) */
74	uint16 medium_time;			/* Medium Time (32 us/s periods) */
75} BWL_POST_PACKED_STRUCT tspec_t;
76
77#define WME_TSPEC_LEN	(sizeof(tspec_t))		/* not including 2-bytes of header */
78
79/* ts_info */
80/* 802.1D priority is duplicated - bits 13-11 AND bits 3-1 */
81#define TS_INFO_TID_SHIFT		1	/* TS info. TID shift */
82#define TS_INFO_TID_MASK		(0xf << TS_INFO_TID_SHIFT)	/* TS info. TID mask */
83#define TS_INFO_CONTENTION_SHIFT	7	/* TS info. contention shift */
84#define TS_INFO_CONTENTION_MASK	(0x1 << TS_INFO_CONTENTION_SHIFT) /* TS info. contention mask */
85#define TS_INFO_DIRECTION_SHIFT	5	/* TS info. direction shift */
86#define TS_INFO_DIRECTION_MASK	(0x3 << TS_INFO_DIRECTION_SHIFT) /* TS info. direction mask */
87#define TS_INFO_PSB_SHIFT		2		/* TS info. PSB bit Shift */
88#define TS_INFO_PSB_MASK		(1 << TS_INFO_PSB_SHIFT)	/* TS info. PSB mask */
89#define TS_INFO_UPLINK			(0 << TS_INFO_DIRECTION_SHIFT)	/* TS info. uplink */
90#define TS_INFO_DOWNLINK		(1 << TS_INFO_DIRECTION_SHIFT)	/* TS info. downlink */
91#define TS_INFO_BIDIRECTIONAL	(3 << TS_INFO_DIRECTION_SHIFT)	/* TS info. bidirectional */
92#define TS_INFO_USER_PRIO_SHIFT	3	/* TS info. user priority shift */
93/* TS info. user priority mask */
94#define TS_INFO_USER_PRIO_MASK	(0x7 << TS_INFO_USER_PRIO_SHIFT)
95
96/* Macro to get/set bit(s) field in TSINFO */
97#define WLC_CAC_GET_TID(pt)	((((pt).octets[0]) & TS_INFO_TID_MASK) >> TS_INFO_TID_SHIFT)
98#define WLC_CAC_GET_DIR(pt)	((((pt).octets[0]) & \
99	TS_INFO_DIRECTION_MASK) >> TS_INFO_DIRECTION_SHIFT)
100#define WLC_CAC_GET_PSB(pt)	((((pt).octets[1]) & TS_INFO_PSB_MASK) >> TS_INFO_PSB_SHIFT)
101#define WLC_CAC_GET_USER_PRIO(pt)	((((pt).octets[1]) & \
102	TS_INFO_USER_PRIO_MASK) >> TS_INFO_USER_PRIO_SHIFT)
103
104#define WLC_CAC_SET_TID(pt, id)	((((pt).octets[0]) & (~TS_INFO_TID_MASK)) | \
105	((id) << TS_INFO_TID_SHIFT))
106#define WLC_CAC_SET_USER_PRIO(pt, prio)	((((pt).octets[0]) & (~TS_INFO_USER_PRIO_MASK)) | \
107	((prio) << TS_INFO_USER_PRIO_SHIFT))
108
109/* 802.11e QBSS Load IE */
110#define QBSS_LOAD_IE_LEN		5	/* QBSS Load IE length */
111#define QBSS_LOAD_AAC_OFF		3	/* AAC offset in IE */
112
113#define CAC_ADDTS_RESP_TIMEOUT		300	/* default ADDTS response timeout in ms */
114
115/* 802.11e ADDTS status code */
116#define DOT11E_STATUS_ADMISSION_ACCEPTED	0	/* TSPEC Admission accepted status */
117#define DOT11E_STATUS_ADDTS_INVALID_PARAM	1	/* TSPEC invalid parameter status */
118#define DOT11E_STATUS_ADDTS_REFUSED_NSBW	3	/* ADDTS refused (non-sufficient BW) */
119#define DOT11E_STATUS_ADDTS_REFUSED_AWHILE	47	/* ADDTS refused but could retry later */
120
121/* 802.11e DELTS status code */
122#define DOT11E_STATUS_QSTA_LEAVE_QBSS		36	/* STA leave QBSS */
123#define DOT11E_STATUS_END_TS				37	/* END TS */
124#define DOT11E_STATUS_UNKNOWN_TS			38	/* UNKNOWN TS */
125#define DOT11E_STATUS_QSTA_REQ_TIMEOUT		39	/* STA ADDTS request timeout */
126
127
128/* This marks the end of a packed structure section. */
129#include <packed_section_end.h>
130
131#endif /* _802_11e_CAC_H_ */
132