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 
73 struct 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 
94 struct 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 
139 struct 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 
160 struct 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 
169 struct 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 
284 struct wi_key {
285           u_int16_t           wi_keylen;
286           u_int8_t            wi_keydat[14];
287 };
288 
289 struct 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 
362 struct 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
388