master
  1/*	$NetBSD: wi_ieee.h,v 1.24 2005/12/11 12:21:29 christos Exp $	*/
  2
  3/*
  4 * Copyright (c) 1997, 1998, 1999
  5 *	Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
  6 *
  7 * Redistribution and use in source and binary forms, with or without
  8 * modification, are permitted provided that the following conditions
  9 * are met:
 10 * 1. Redistributions of source code must retain the above copyright
 11 *    notice, this list of conditions and the following disclaimer.
 12 * 2. Redistributions in binary form must reproduce the above copyright
 13 *    notice, this list of conditions and the following disclaimer in the
 14 *    documentation and/or other materials provided with the distribution.
 15 * 3. All advertising materials mentioning features or use of this software
 16 *    must display the following acknowledgement:
 17 *	This product includes software developed by Bill Paul.
 18 * 4. Neither the name of the author nor the names of any co-contributors
 19 *    may be used to endorse or promote products derived from this software
 20 *    without specific prior written permission.
 21 *
 22 * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
 23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 25 * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
 26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 32 * THE POSSIBILITY OF SUCH DAMAGE.
 33 *
 34 * $FreeBSD: src/sys/i386/include/if_wavelan_ieee.h,v 1.4 1999/12/29 04:33:01 peter Exp $
 35 */
 36
 37#ifndef _IF_WAVELAN_IEEE_H
 38#define _IF_WAVELAN_IEEE_H
 39
 40/*
 41 * FreeBSD driver ported to NetBSD by Bill Sommerfeld in the back of the
 42 * Oslo IETF plenary meeting.
 43 * The stuff in here should probably go into a generic extension to the
 44 * ifmedia goop.
 45 *
 46 * Michael Graff brought over the encryption bits.
 47 */
 48
 49/*
 50 * This header defines a simple command interface to the FreeBSD
 51 * WaveLAN/IEEE driver (wi) driver, which is used to set certain
 52 * device-specific parameters which can't be easily managed through
 53 * ifconfig(8). No, sysctl(2) is not the answer. I said a _simple_
 54 * interface, didn't I.
 55 */
 56
 57#ifndef SIOCSWAVELAN
 58#define SIOCSWAVELAN	SIOCSIFGENERIC
 59#endif
 60
 61#ifndef SIOCGWAVELAN
 62#define SIOCGWAVELAN	SIOCGIFGENERIC
 63#endif
 64
 65/*
 66 * Technically I don't think there's a limit to a record
 67 * length. The largest record is the one that contains the CIS
 68 * data, which is 240 words long, so 256 should be a safe
 69 * value.
 70 */
 71#define WI_MAX_DATALEN	512
 72
 73struct wi_req {
 74	u_int16_t	wi_len;
 75	u_int16_t	wi_type;
 76	u_int16_t	wi_val[WI_MAX_DATALEN];
 77};
 78
 79/*
 80 * Private LTV records (interpreted only by the driver). This is
 81 * a minor kludge to allow reading the interface statistics from
 82 * the driver.
 83 */
 84#define WI_RID_IFACE_STATS	0x0100
 85#define WI_RID_MGMT_XMIT	0x0200
 86#ifdef WICACHE
 87#define WI_RID_ZERO_CACHE	0x0300
 88#define WI_RID_READ_CACHE	0x0400
 89#endif
 90#define	WI_RID_MONITOR_MODE	0x0500
 91#define	WI_RID_SCAN_APS		0x0600
 92#define	WI_RID_READ_APS		0x0700
 93
 94struct wi_80211_hdr {
 95	u_int16_t		frame_ctl;
 96	u_int16_t		dur_id;
 97	u_int8_t		addr1[6];
 98	u_int8_t		addr2[6];
 99	u_int8_t		addr3[6];
100	u_int16_t		seq_ctl;
101	u_int8_t		addr4[6];
102};
103
104#define WI_FCTL_VERS		0x0002
105#define WI_FCTL_FTYPE		0x000C
106#define WI_FCTL_STYPE		0x00F0
107#define WI_FCTL_TODS		0x0100
108#define WI_FCTL_FROMDS		0x0200
109#define WI_FCTL_MOREFRAGS	0x0400
110#define WI_FCTL_RETRY		0x0800
111#define WI_FCTL_PM		0x1000
112#define WI_FCTL_MOREDATA	0x2000
113#define WI_FCTL_WEP		0x4000
114#define WI_FCTL_ORDER		0x8000
115
116#define WI_FTYPE_MGMT		0x0000
117#define WI_FTYPE_CTL		0x0004
118#define WI_FTYPE_DATA		0x0008
119
120#define WI_STYPE_MGMT_ASREQ	0x0000	/* association request */
121#define WI_STYPE_MGMT_ASRESP	0x0010	/* association response */
122#define WI_STYPE_MGMT_REASREQ	0x0020	/* reassociation request */
123#define WI_STYPE_MGMT_REASRESP	0x0030	/* reassociation response */
124#define WI_STYPE_MGMT_PROBEREQ	0x0040	/* probe request */
125#define WI_STYPE_MGMT_PROBERESP	0x0050	/* probe response */
126#define WI_STYPE_MGMT_BEACON	0x0080	/* beacon */
127#define WI_STYPE_MGMT_ATIM	0x0090	/* announcement traffic ind msg */
128#define WI_STYPE_MGMT_DISAS	0x00A0	/* disassociation */
129#define WI_STYPE_MGMT_AUTH	0x00B0	/* authentication */
130#define WI_STYPE_MGMT_DEAUTH	0x00C0	/* deauthentication */
131
132#define	WI_STYPE_CTL_PSPOLL	0x00A0
133#define	WI_STYPE_CTL_RTS	0x00B0
134#define	WI_STYPE_CTL_CTS	0x00C0
135#define	WI_STYPE_CTL_ACK	0x00D0
136#define	WI_STYPE_CTL_CFEND	0x00E0
137#define	WI_STYPE_CTL_CFENDACK	0x00F0
138
139struct wi_mgmt_hdr {
140	u_int16_t		frame_ctl;
141	u_int16_t		duration;
142	u_int8_t		dst_addr[6];
143	u_int8_t		src_addr[6];
144	u_int8_t		bssid[6];
145	u_int16_t		seq_ctl;
146};
147
148/*
149 * Lucent/wavelan IEEE signal strength cache
150 *
151 * driver keeps cache of last
152 * MAXWICACHE packets to arrive including signal strength info.
153 * daemons may read this via ioctl
154 *
155 * Each entry in the wi_sigcache has a unique macsrc.
156 */
157#ifdef WICACHE
158#define	MAXWICACHE	10
159
160struct wi_sigcache {
161	char	macsrc[6];	/* unique MAC address for entry */
162	int	ipsrc;		/* ip address associated with packet */
163	int	signal;		/* signal strength of the packet */
164	int	noise;		/* noise value */
165	int	quality;	/* quality of the packet */
166};
167#endif
168
169struct wi_counters {
170	u_int32_t		wi_tx_unicast_frames;
171	u_int32_t		wi_tx_multicast_frames;
172	u_int32_t		wi_tx_fragments;
173	u_int32_t		wi_tx_unicast_octets;
174	u_int32_t		wi_tx_multicast_octets;
175	u_int32_t		wi_tx_deferred_xmits;
176	u_int32_t		wi_tx_single_retries;
177	u_int32_t		wi_tx_multi_retries;
178	u_int32_t		wi_tx_retry_limit;
179	u_int32_t		wi_tx_discards;
180	u_int32_t		wi_rx_unicast_frames;
181	u_int32_t		wi_rx_multicast_frames;
182	u_int32_t		wi_rx_fragments;
183	u_int32_t		wi_rx_unicast_octets;
184	u_int32_t		wi_rx_multicast_octets;
185	u_int32_t		wi_rx_fcs_errors;
186	u_int32_t		wi_rx_discards_nobuf;
187	u_int32_t		wi_tx_discards_wrong_sa;
188	u_int32_t		wi_rx_WEP_cant_decrypt;
189	u_int32_t		wi_rx_msg_in_msg_frags;
190	u_int32_t		wi_rx_msg_in_bad_msg_frags;
191};
192
193/*
194 * Network parameters, static configuration entities.
195 */
196#define WI_RID_PORTTYPE		0xFC00 /* Connection control characteristics */
197#define WI_RID_MAC_NODE		0xFC01 /* MAC address of this station */
198#define WI_RID_DESIRED_SSID	0xFC02 /* Service Set ID for connection */
199#define WI_RID_OWN_CHNL		0xFC03 /* Comm channel for BSS creation */
200#define WI_RID_OWN_SSID		0xFC04 /* IBSS creation ID */
201#define WI_RID_OWN_ATIM_WIN	0xFC05 /* ATIM window time for IBSS creation */
202#define WI_RID_SYSTEM_SCALE	0xFC06 /* scale that specifies AP density */
203#define WI_RID_MAX_DATALEN	0xFC07 /* Max len of MAC frame body data */
204#define WI_RID_MAC_WDS		0xFC08 /* MAC addr of corresponding WDS node */
205#define WI_RID_PM_ENABLED	0xFC09 /* ESS power management enable */
206#define WI_RID_PM_EPS		0xFC0A /* PM EPS/PS mode */
207#define WI_RID_MCAST_RX		0xFC0B /* ESS PM mcast reception */
208#define WI_RID_MAX_SLEEP	0xFC0C /* max sleep time for ESS PM */
209#define WI_RID_HOLDOVER		0xFC0D /* holdover time for ESS PM */
210#define WI_RID_NODENAME		0xFC0E /* ID name of this node for diag */
211#define WI_RID_DTIM_PERIOD	0xFC10 /* beacon interval between DTIMs */
212#define WI_RID_WDS_ADDR1	0xFC11 /* port 1 MAC of WDS link node */
213#define WI_RID_WDS_ADDR2	0xFC12 /* port 1 MAC of WDS link node */
214#define WI_RID_WDS_ADDR3	0xFC13 /* port 1 MAC of WDS link node */
215#define WI_RID_WDS_ADDR4	0xFC14 /* port 1 MAC of WDS link node */
216#define WI_RID_WDS_ADDR5	0xFC15 /* port 1 MAC of WDS link node */
217#define WI_RID_WDS_ADDR6	0xFC16 /* port 1 MAC of WDS link node */
218#define WI_RID_MCAST_PM_BUF	0xFC17 /* PM buffering of mcast */
219#define WI_RID_ENCRYPTION	0xFC20 /* enable/disable WEP */
220#define WI_RID_AUTHTYPE		0xFC21 /* specify authentication type */
221#define WI_RID_P2_TX_CRYPT_KEY	0xFC23
222#define WI_RID_P2_CRYPT_KEY0	0xFC24
223#define WI_RID_P2_CRYPT_KEY1	0xFC25
224#define WI_RID_MICROWAVE_OVEN	0xFC25
225#define WI_RID_P2_CRYPT_KEY2	0xFC26
226#define WI_RID_P2_CRYPT_KEY3	0xFC27
227#define WI_RID_P2_ENCRYPTION	0xFC28
228#define	 PRIVACY_INVOKED	0x01
229#define	 EXCLUDE_UNENCRYPTED	0x02
230#define	 HOST_ENCRYPT		0x10
231#define	 IV_EVERY_FRAME		0x00	/* IV = Initialization Vector */
232#define	 IV_EVERY10_FRAME	0x20	/* every 10 frame IV reuse */
233#define	 IV_EVERY50_FRAME	0x40	/* every 50 frame IV reuse */
234#define	 IV_EVERY100_FRAME	0x60	/* every 100 frame IV reuse */
235#define	 HOST_DECRYPT		0x80
236#define WI_RID_WEP_MAPTABLE	0xFC29
237#define WI_RID_CNFAUTHMODE	0xFC2A
238#define WI_RID_ROAMING_MODE	0xFC2D
239#define	WI_RID_ALT_RETRY_COUNT	0xFC32 /* retry count if WI_TXCNTL_ALTRTRY */
240#define WI_RID_OWN_BEACON_INT	0xFC33 /* beacon xmit time for BSS creation */
241#define WI_RID_SET_TIM		0xFC40
242#define WI_RID_DBM_ADJUST	0xFC46 /* RSSI - WI_RID_DBM_ADJUST ~ dBm */
243#define WI_RID_BASIC_RATE	0xFCB3
244#define WI_RID_SUPPORT_RATE	0xFCB4
245
246/*
247 * Network parameters, dynamic configuration entities
248 */
249#define WI_RID_MCAST_LIST	0xFC80 /* multicast addrs to put in filter */
250#define WI_RID_CREATE_IBSS	0xFC81 /* create IBSS */
251#define WI_RID_FRAG_THRESH	0xFC82 /* frag len, unicast msg xmit */
252#define WI_RID_RTS_THRESH	0xFC83 /* frame len for RTS/CTS handshake */
253#define WI_RID_TX_RATE		0xFC84 /* data rate for message xmit
254 					* 0 == Fixed 1mbps
255 					* 1 == Fixed 2mbps
256 					* 2 == auto fallback
257					*/
258#define WI_RID_PROMISC		0xFC85 /* enable promisc mode */
259#define WI_RID_FRAG_THRESH0	0xFC90
260#define WI_RID_FRAG_THRESH1	0xFC91
261#define WI_RID_FRAG_THRESH2	0xFC92
262#define WI_RID_FRAG_THRESH3	0xFC93
263#define WI_RID_FRAG_THRESH4	0xFC94
264#define WI_RID_FRAG_THRESH5	0xFC95
265#define WI_RID_FRAG_THRESH6	0xFC96
266#define WI_RID_RTS_THRESH0	0xFC97
267#define WI_RID_RTS_THRESH1	0xFC98
268#define WI_RID_RTS_THRESH2	0xFC99
269#define WI_RID_RTS_THRESH3	0xFC9A
270#define WI_RID_RTS_THRESH4	0xFC9B
271#define WI_RID_RTS_THRESH5	0xFC9C
272#define WI_RID_RTS_THRESH6	0xFC9D
273#define WI_RID_TX_RATE0		0xFC9E
274#define WI_RID_TX_RATE1		0xFC9F
275#define WI_RID_TX_RATE2		0xFCA0
276#define WI_RID_TX_RATE3		0xFCA1
277#define WI_RID_TX_RATE4		0xFCA2
278#define WI_RID_TX_RATE5		0xFCA3
279#define WI_RID_TX_RATE6		0xFCA4
280#define WI_RID_DEFLT_CRYPT_KEYS	0xFCB0
281#define WI_RID_TX_CRYPT_KEY	0xFCB1
282#define WI_RID_TICK_TIME	0xFCE0 	/* Auxiliary Timer tick interval */
283
284struct wi_key {
285	u_int16_t		wi_keylen;
286	u_int8_t		wi_keydat[14];
287};
288
289struct wi_ltv_keys {
290	u_int16_t		wi_len;
291	u_int16_t		wi_type;
292	struct wi_key		wi_keys[4];
293};
294
295/*
296 * NIC information
297 */
298#define WI_RID_DNLD_BUF		0xFD01
299#define WI_RID_MEMSZ		0xFD02 /* memory size info (XXX Lucent) */
300#define	WI_RID_PRI_IDENTITY	0xFD02 /* primary funcs firmware ident (PRISM2) */
301#define WI_RID_PRI_SUP_RANGE	0xFD03 /* primary supplier compatibility */
302#define WI_RID_CIF_ACT_RANGE	0xFD04 /* controller sup. compatibility */
303#define WI_RID_SERIALNO		0xFD0A /* card serial number */
304#define WI_RID_CARD_ID		0xFD0B /* card identification */
305#define WI_RID_MFI_SUP_RANGE	0xFD0C /* modem supplier compatibility */
306#define WI_RID_CFI_SUP_RANGE	0xFD0D /* controller sup. compatibility */
307#define WI_RID_CHANNEL_LIST	0xFD10 /* allowed comm. frequencies. */
308#define WI_RID_REG_DOMAINS	0xFD11 /* list of intendted regulatory doms */
309#define WI_RID_TEMP_TYPE	0xFD12 /* hw temp range code */
310#define WI_RID_CIS		0xFD13 /* PC card info struct */
311#define WI_RID_STA_IDENTITY	0xFD20 /* station funcs firmware ident */
312#define WI_RID_STA_SUP_RANGE	0xFD21 /* station supplier compat */
313#define WI_RID_MFI_ACT_RANGE	0xFD22
314#define WI_RID_SYMBOL_IDENTITY	0xFD24
315#define WI_RID_CFI_ACT_RANGE	0xFD33
316#define WI_RID_COMMQUAL		0xFD43
317#define WI_RID_SCALETHRESH	0xFD46
318#define WI_RID_PCF		0xFD87
319
320/*
321 * MAC information
322 */
323#define WI_RID_PORT_STAT	0xFD40 /* actual MAC port con control stat */
324#define WI_RID_CURRENT_SSID	0xFD41 /* ID of actually connected SS */
325#define WI_RID_CURRENT_BSSID	0xFD42 /* ID of actually connected BSS */
326#define WI_RID_COMMS_QUALITY	0xFD43 /* quality of BSS connection */
327#define WI_RID_CUR_TX_RATE	0xFD44 /* current TX rate */
328#define WI_RID_CUR_BEACON_INT	0xFD45 /* current beacon interval */
329#define WI_RID_CUR_SCALE_THRESH	0xFD46 /* actual system scane thresh setting */
330#define WI_RID_PROT_RESP_TIME	0xFD47 /* time to wait for resp to req msg */
331#define WI_RID_SHORT_RTR_LIM	0xFD48 /* max tx attempts for short frames */
332#define WI_RID_LONG_RTS_LIM	0xFD49 /* max tx attempts for long frames */
333#define WI_RID_MAX_TX_LIFE	0xFD4A /* max tx frame handling duration */
334#define WI_RID_MAX_RX_LIFE	0xFD4B /* max rx frame handling duration */
335#define WI_RID_CF_POLL		0xFD4C /* contention free pollable ind */
336#define WI_RID_AUTH_ALGS	0xFD4D /* auth algorithms available */
337#define WI_RID_AUTH_TYPE	0xFD4E /* available auth types */
338#define WI_RID_WEP_AVAIL	0xFD4F /* WEP privacy option available */
339#define WI_RID_CUR_TX_RATE1	0xFD80
340#define WI_RID_CUR_TX_RATE2	0xFD81
341#define WI_RID_CUR_TX_RATE3	0xFD82
342#define WI_RID_CUR_TX_RATE4	0xFD83
343#define WI_RID_CUR_TX_RATE5	0xFD84
344#define WI_RID_CUR_TX_RATE6	0xFD85
345#define WI_RID_OWN_MAC		0xFD86 /* unique local MAC addr */
346#define WI_RID_PCI_INFO		0xFD87 /* point coordination func cap */
347
348/*
349 * Scan Information
350 */
351#define	WI_RID_BCAST_SCAN_REQ	0xFCAB /* Broadcast Scan request (Symbol) */
352#define	 BSCAN_5SEC		0x01
353#define	 BSCAN_ONETIME		0x02
354#define	 BSCAN_PASSIVE		0x40
355#define	 BSCAN_BCAST		0x80
356#define WI_RID_SCAN_REQ		0xFCE1 /* Scan request (STA only) */
357#define WI_RID_JOIN_REQ		0xFCE2 /* Join request (STA only) */
358#define	WI_RID_AUTH_STATION	0xFCE3 /* Authenticates Station (AP) */
359#define	WI_RID_CHANNEL_REQ	0xFCE4 /* Channel Information Request (AP) */
360#define WI_RID_SCAN_RESULTS	0xFD88 /* Scan Results Table */
361
362struct wi_apinfo {
363	int			scanreason;	/* ScanReason */
364	char			bssid[6];	/* BSSID (mac address) */
365	int			channel;	/* Channel */
366	int			signal;		/* Signal level */
367	int			noise;		/* Average Noise Level*/
368	int			quality;	/* Quality */
369	int			namelen;	/* Length of SSID string */
370	char			name[32];	/* SSID string */
371	int			capinfo;	/* Capability info. */
372	int			interval;	/* BSS Beacon Interval */
373	int			rate;		/* Data Rate */
374};
375
376/*
377 * Modem information
378 */
379#define WI_RID_PHY_TYPE		0xFDC0 /* phys layer type indication */
380#define WI_RID_CURRENT_CHAN	0xFDC1 /* current frequency */
381#define WI_RID_PWR_STATE	0xFDC2 /* pwr consumption status */
382#define WI_RID_CCA_MODE		0xFDC3 /* clear chan assess mode indication */
383#define WI_RID_CCA_TIME		0xFDC4 /* clear chan assess time */
384#define WI_RID_MAC_PROC_DELAY	0xFDC5 /* MAC processing delay time */
385#define WI_RID_DATA_RATES	0xFDC6 /* supported data rates */
386
387#endif