linux/drivers/staging/wlan-ng/hfa384x.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: (GPL-2.0 OR MPL-1.1) */
   2/* hfa384x.h
   3 *
   4 * Defines the constants and data structures for the hfa384x
   5 *
   6 * Copyright (C) 1999 AbsoluteValue Systems, Inc.  All Rights Reserved.
   7 * --------------------------------------------------------------------
   8 *
   9 * linux-wlan
  10 *
  11 *   The contents of this file are subject to the Mozilla Public
  12 *   License Version 1.1 (the "License"); you may not use this file
  13 *   except in compliance with the License. You may obtain a copy of
  14 *   the License at http://www.mozilla.org/MPL/
  15 *
  16 *   Software distributed under the License is distributed on an "AS
  17 *   IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  18 *    implied. See the License for the specific language governing
  19 *   rights and limitations under the License.
  20 *
  21 *   Alternatively, the contents of this file may be used under the
  22 *   terms of the GNU Public License version 2 (the "GPL"), in which
  23 *   case the provisions of the GPL are applicable instead of the
  24 *   above.  If you wish to allow the use of your version of this file
  25 *   only under the terms of the GPL and not to allow others to use
  26 *   your version of this file under the MPL, indicate your decision
  27 *   by deleting the provisions above and replace them with the notice
  28 *   and other provisions required by the GPL.  If you do not delete
  29 *   the provisions above, a recipient may use your version of this
  30 *   file under either the MPL or the GPL.
  31 *
  32 * --------------------------------------------------------------------
  33 *
  34 * Inquiries regarding the linux-wlan Open Source project can be
  35 * made directly to:
  36 *
  37 * AbsoluteValue Systems Inc.
  38 * info@linux-wlan.com
  39 * http://www.linux-wlan.com
  40 *
  41 * --------------------------------------------------------------------
  42 *
  43 * Portions of the development of this software were funded by
  44 * Intersil Corporation as part of PRISM(R) chipset product development.
  45 *
  46 * --------------------------------------------------------------------
  47 *
  48 *   [Implementation and usage notes]
  49 *
  50 *   [References]
  51 *      CW10 Programmer's Manual v1.5
  52 *      IEEE 802.11 D10.0
  53 *
  54 * --------------------------------------------------------------------
  55 */
  56
  57#ifndef _HFA384x_H
  58#define _HFA384x_H
  59
  60#define HFA384x_FIRMWARE_VERSION(a, b, c) (((a) << 16) + ((b) << 8) + (c))
  61
  62#include <linux/if_ether.h>
  63#include <linux/usb.h>
  64
  65/*--- Mins & Maxs -----------------------------------*/
  66#define HFA384x_PORTID_MAX              ((u16)7)
  67#define HFA384x_NUMPORTS_MAX            ((u16)(HFA384x_PORTID_MAX + 1))
  68#define HFA384x_PDR_LEN_MAX             ((u16)512) /* in bytes, from EK */
  69#define HFA384x_PDA_RECS_MAX            ((u16)200) /* a guess */
  70#define HFA384x_PDA_LEN_MAX             ((u16)1024) /* in bytes, from EK*/
  71#define HFA384x_SCANRESULT_MAX          ((u16)31)
  72#define HFA384x_HSCANRESULT_MAX         ((u16)31)
  73#define HFA384x_CHINFORESULT_MAX        ((u16)16)
  74#define HFA384x_RID_GUESSING_MAXLEN     2048    /* I'm not really sure */
  75#define HFA384x_RIDDATA_MAXLEN          HFA384x_RID_GUESSING_MAXLEN
  76#define HFA384x_USB_RWMEM_MAXLEN        2048
  77
  78/*--- Support Constants -----------------------------*/
  79#define         HFA384x_PORTTYPE_IBSS                   ((u16)0)
  80#define         HFA384x_PORTTYPE_BSS                    ((u16)1)
  81#define         HFA384x_PORTTYPE_PSUEDOIBSS             ((u16)3)
  82#define         HFA384x_WEPFLAGS_PRIVINVOKED            ((u16)BIT(0))
  83#define         HFA384x_WEPFLAGS_EXCLUDE                ((u16)BIT(1))
  84#define         HFA384x_WEPFLAGS_DISABLE_TXCRYPT        ((u16)BIT(4))
  85#define         HFA384x_WEPFLAGS_DISABLE_RXCRYPT        ((u16)BIT(7))
  86#define         HFA384x_ROAMMODE_HOSTSCAN_HOSTROAM      ((u16)3)
  87#define         HFA384x_PORTSTATUS_DISABLED             ((u16)1)
  88#define         HFA384x_RATEBIT_1                       ((u16)1)
  89#define         HFA384x_RATEBIT_2                       ((u16)2)
  90#define         HFA384x_RATEBIT_5dot5                   ((u16)4)
  91#define         HFA384x_RATEBIT_11                      ((u16)8)
  92
  93/*--- MAC Internal memory constants and macros ------*/
  94/* masks and macros used to manipulate MAC internal memory addresses. */
  95/* MAC internal memory addresses are 23 bit quantities.  The MAC uses
  96 * a paged address space where the upper 16 bits are the page number
  97 * and the lower 7 bits are the offset.  There are various Host API
  98 * elements that require two 16-bit quantities to specify a MAC
  99 * internal memory address.  Unfortunately, some of the API's use a
 100 * page/offset format where the offset value is JUST the lower seven
 101 * bits and the page is  the remaining 16 bits.  Some of the API's
 102 * assume that the 23 bit address has been split at the 16th bit.  We
 103 * refer to these two formats as AUX format and CMD format.  The
 104 * macros below help handle some of this.
 105 */
 106
 107/* Mask bits for discarding unwanted pieces in a flat address */
 108#define         HFA384x_ADDR_FLAT_AUX_PAGE_MASK (0x007fff80)
 109#define         HFA384x_ADDR_FLAT_AUX_OFF_MASK  (0x0000007f)
 110#define         HFA384x_ADDR_FLAT_CMD_PAGE_MASK (0xffff0000)
 111#define         HFA384x_ADDR_FLAT_CMD_OFF_MASK  (0x0000ffff)
 112
 113/* Mask bits for discarding unwanted pieces in AUX format
 114 * 16-bit address parts
 115 */
 116#define         HFA384x_ADDR_AUX_PAGE_MASK      (0xffff)
 117#define         HFA384x_ADDR_AUX_OFF_MASK       (0x007f)
 118
 119/* Make a 32-bit flat address from AUX format 16-bit page and offset */
 120#define         HFA384x_ADDR_AUX_MKFLAT(p, o)   \
 121                ((((u32)(((u16)(p)) & HFA384x_ADDR_AUX_PAGE_MASK)) << 7) | \
 122                ((u32)(((u16)(o)) & HFA384x_ADDR_AUX_OFF_MASK)))
 123
 124/* Make CMD format offset and page from a 32-bit flat address */
 125#define         HFA384x_ADDR_CMD_MKPAGE(f) \
 126                ((u16)((((u32)(f)) & HFA384x_ADDR_FLAT_CMD_PAGE_MASK) >> 16))
 127#define         HFA384x_ADDR_CMD_MKOFF(f) \
 128                ((u16)(((u32)(f)) & HFA384x_ADDR_FLAT_CMD_OFF_MASK))
 129
 130/*--- Controller Memory addresses -------------------*/
 131#define         HFA3842_PDA_BASE        (0x007f0000UL)
 132#define         HFA3841_PDA_BASE        (0x003f0000UL)
 133#define         HFA3841_PDA_BOGUS_BASE  (0x00390000UL)
 134
 135/*--- Driver Download states  -----------------------*/
 136#define         HFA384x_DLSTATE_DISABLED                0
 137#define         HFA384x_DLSTATE_RAMENABLED              1
 138#define         HFA384x_DLSTATE_FLASHENABLED            2
 139
 140/*--- Register Field Masks --------------------------*/
 141#define         HFA384x_CMD_AINFO               ((u16)GENMASK(14, 8))
 142#define         HFA384x_CMD_MACPORT             ((u16)GENMASK(10, 8))
 143#define         HFA384x_CMD_PROGMODE            ((u16)GENMASK(9, 8))
 144#define         HFA384x_CMD_CMDCODE             ((u16)GENMASK(5, 0))
 145#define         HFA384x_STATUS_RESULT           ((u16)GENMASK(14, 8))
 146
 147/*--- Command Code Constants --------------------------*/
 148/*--- Controller Commands --------------------------*/
 149#define         HFA384x_CMDCODE_INIT            ((u16)0x00)
 150#define         HFA384x_CMDCODE_ENABLE          ((u16)0x01)
 151#define         HFA384x_CMDCODE_DISABLE         ((u16)0x02)
 152
 153/*--- Regulate Commands --------------------------*/
 154#define         HFA384x_CMDCODE_INQ             ((u16)0x11)
 155
 156/*--- Configure Commands --------------------------*/
 157#define         HFA384x_CMDCODE_DOWNLD          ((u16)0x22)
 158
 159/*--- Debugging Commands -----------------------------*/
 160#define         HFA384x_CMDCODE_MONITOR         ((u16)(0x38))
 161#define         HFA384x_MONITOR_ENABLE          ((u16)(0x0b))
 162#define         HFA384x_MONITOR_DISABLE         ((u16)(0x0f))
 163
 164/*--- Result Codes --------------------------*/
 165#define         HFA384x_CMD_ERR                 ((u16)(0x7F))
 166
 167/*--- Programming Modes --------------------------
 168 *      MODE 0: Disable programming
 169 *      MODE 1: Enable volatile memory programming
 170 *      MODE 2: Enable non-volatile memory programming
 171 *      MODE 3: Program non-volatile memory section
 172 *-------------------------------------------------
 173 */
 174#define         HFA384x_PROGMODE_DISABLE        ((u16)0x00)
 175#define         HFA384x_PROGMODE_RAM            ((u16)0x01)
 176#define         HFA384x_PROGMODE_NV             ((u16)0x02)
 177#define         HFA384x_PROGMODE_NVWRITE        ((u16)0x03)
 178
 179/*--- Record ID Constants --------------------------*/
 180/*--------------------------------------------------------------------
 181 * Configuration RIDs: Network Parameters, Static Configuration Entities
 182 *--------------------------------------------------------------------
 183 */
 184#define         HFA384x_RID_CNFPORTTYPE         ((u16)0xFC00)
 185#define         HFA384x_RID_CNFOWNMACADDR       ((u16)0xFC01)
 186#define         HFA384x_RID_CNFDESIREDSSID      ((u16)0xFC02)
 187#define         HFA384x_RID_CNFOWNCHANNEL       ((u16)0xFC03)
 188#define         HFA384x_RID_CNFOWNSSID          ((u16)0xFC04)
 189#define         HFA384x_RID_CNFMAXDATALEN       ((u16)0xFC07)
 190
 191/*--------------------------------------------------------------------
 192 * Configuration RID lengths: Network Params, Static Config Entities
 193 * This is the length of JUST the DATA part of the RID (does not
 194 * include the len or code fields)
 195 *--------------------------------------------------------------------
 196 */
 197#define         HFA384x_RID_CNFOWNMACADDR_LEN   ((u16)6)
 198#define         HFA384x_RID_CNFDESIREDSSID_LEN  ((u16)34)
 199#define         HFA384x_RID_CNFOWNSSID_LEN      ((u16)34)
 200
 201/*--------------------------------------------------------------------
 202 * Configuration RIDs: Network Parameters, Dynamic Configuration Entities
 203 *--------------------------------------------------------------------
 204 */
 205#define         HFA384x_RID_CREATEIBSS          ((u16)0xFC81)
 206#define         HFA384x_RID_FRAGTHRESH          ((u16)0xFC82)
 207#define         HFA384x_RID_RTSTHRESH           ((u16)0xFC83)
 208#define         HFA384x_RID_TXRATECNTL          ((u16)0xFC84)
 209#define         HFA384x_RID_PROMISCMODE         ((u16)0xFC85)
 210
 211/*----------------------------------------------------------------------
 212 * Information RIDs: NIC Information
 213 *----------------------------------------------------------------------
 214 */
 215#define         HFA384x_RID_MAXLOADTIME         ((u16)0xFD00)
 216#define         HFA384x_RID_DOWNLOADBUFFER      ((u16)0xFD01)
 217#define         HFA384x_RID_PRIIDENTITY         ((u16)0xFD02)
 218#define         HFA384x_RID_PRISUPRANGE         ((u16)0xFD03)
 219#define         HFA384x_RID_PRI_CFIACTRANGES    ((u16)0xFD04)
 220#define         HFA384x_RID_NICSERIALNUMBER     ((u16)0xFD0A)
 221#define         HFA384x_RID_NICIDENTITY         ((u16)0xFD0B)
 222#define         HFA384x_RID_MFISUPRANGE         ((u16)0xFD0C)
 223#define         HFA384x_RID_CFISUPRANGE         ((u16)0xFD0D)
 224#define         HFA384x_RID_STAIDENTITY         ((u16)0xFD20)
 225#define         HFA384x_RID_STASUPRANGE         ((u16)0xFD21)
 226#define         HFA384x_RID_STA_MFIACTRANGES    ((u16)0xFD22)
 227#define         HFA384x_RID_STA_CFIACTRANGES    ((u16)0xFD23)
 228
 229/*----------------------------------------------------------------------
 230 * Information RID Lengths: NIC Information
 231 * This is the length of JUST the DATA part of the RID (does not
 232 * include the len or code fields)
 233 *---------------------------------------------------------------------
 234 */
 235#define         HFA384x_RID_NICSERIALNUMBER_LEN         ((u16)12)
 236
 237/*--------------------------------------------------------------------
 238 * Information RIDs:  MAC Information
 239 *--------------------------------------------------------------------
 240 */
 241#define         HFA384x_RID_PORTSTATUS          ((u16)0xFD40)
 242#define         HFA384x_RID_CURRENTSSID         ((u16)0xFD41)
 243#define         HFA384x_RID_CURRENTBSSID        ((u16)0xFD42)
 244#define         HFA384x_RID_CURRENTTXRATE       ((u16)0xFD44)
 245#define         HFA384x_RID_SHORTRETRYLIMIT     ((u16)0xFD48)
 246#define         HFA384x_RID_LONGRETRYLIMIT      ((u16)0xFD49)
 247#define         HFA384x_RID_MAXTXLIFETIME       ((u16)0xFD4A)
 248#define         HFA384x_RID_PRIVACYOPTIMP       ((u16)0xFD4F)
 249#define         HFA384x_RID_DBMCOMMSQUALITY     ((u16)0xFD51)
 250
 251/*--------------------------------------------------------------------
 252 * Information RID Lengths:  MAC Information
 253 * This is the length of JUST the DATA part of the RID (does not
 254 * include the len or code fields)
 255 *--------------------------------------------------------------------
 256 */
 257#define         HFA384x_RID_DBMCOMMSQUALITY_LEN  \
 258        ((u16)sizeof(struct hfa384x_dbmcommsquality))
 259#define         HFA384x_RID_JOINREQUEST_LEN \
 260        ((u16)sizeof(struct hfa384x_join_request_data))
 261
 262/*--------------------------------------------------------------------
 263 * Information RIDs:  Modem Information
 264 *--------------------------------------------------------------------
 265 */
 266#define         HFA384x_RID_CURRENTCHANNEL      ((u16)0xFDC1)
 267
 268/*--------------------------------------------------------------------
 269 * API ENHANCEMENTS (NOT ALREADY IMPLEMENTED)
 270 *--------------------------------------------------------------------
 271 */
 272#define         HFA384x_RID_CNFWEPDEFAULTKEYID  ((u16)0xFC23)
 273#define         HFA384x_RID_CNFWEPDEFAULTKEY0   ((u16)0xFC24)
 274#define         HFA384x_RID_CNFWEPDEFAULTKEY1   ((u16)0xFC25)
 275#define         HFA384x_RID_CNFWEPDEFAULTKEY2   ((u16)0xFC26)
 276#define         HFA384x_RID_CNFWEPDEFAULTKEY3   ((u16)0xFC27)
 277#define         HFA384x_RID_CNFWEPFLAGS         ((u16)0xFC28)
 278#define         HFA384x_RID_CNFAUTHENTICATION   ((u16)0xFC2A)
 279#define         HFA384x_RID_CNFROAMINGMODE      ((u16)0xFC2D)
 280#define         HFA384x_RID_CNFAPBCNINT         ((u16)0xFC33)
 281#define         HFA384x_RID_CNFDBMADJUST        ((u16)0xFC46)
 282#define         HFA384x_RID_CNFWPADATA          ((u16)0xFC48)
 283#define         HFA384x_RID_CNFBASICRATES       ((u16)0xFCB3)
 284#define         HFA384x_RID_CNFSUPPRATES        ((u16)0xFCB4)
 285#define         HFA384x_RID_CNFPASSIVESCANCTRL  ((u16)0xFCBA)
 286#define         HFA384x_RID_TXPOWERMAX          ((u16)0xFCBE)
 287#define         HFA384x_RID_JOINREQUEST         ((u16)0xFCE2)
 288#define         HFA384x_RID_AUTHENTICATESTA     ((u16)0xFCE3)
 289#define         HFA384x_RID_HOSTSCAN            ((u16)0xFCE5)
 290
 291#define         HFA384x_RID_CNFWEPDEFAULTKEY_LEN        ((u16)6)
 292#define         HFA384x_RID_CNFWEP128DEFAULTKEY_LEN     ((u16)14)
 293
 294/*--------------------------------------------------------------------
 295 * PD Record codes
 296 *--------------------------------------------------------------------
 297 */
 298#define HFA384x_PDR_PCB_PARTNUM         ((u16)0x0001)
 299#define HFA384x_PDR_PDAVER              ((u16)0x0002)
 300#define HFA384x_PDR_NIC_SERIAL          ((u16)0x0003)
 301#define HFA384x_PDR_MKK_MEASUREMENTS    ((u16)0x0004)
 302#define HFA384x_PDR_NIC_RAMSIZE         ((u16)0x0005)
 303#define HFA384x_PDR_MFISUPRANGE         ((u16)0x0006)
 304#define HFA384x_PDR_CFISUPRANGE         ((u16)0x0007)
 305#define HFA384x_PDR_NICID               ((u16)0x0008)
 306#define HFA384x_PDR_MAC_ADDRESS         ((u16)0x0101)
 307#define HFA384x_PDR_REGDOMAIN           ((u16)0x0103)
 308#define HFA384x_PDR_ALLOWED_CHANNEL     ((u16)0x0104)
 309#define HFA384x_PDR_DEFAULT_CHANNEL     ((u16)0x0105)
 310#define HFA384x_PDR_TEMPTYPE            ((u16)0x0107)
 311#define HFA384x_PDR_IFR_SETTING         ((u16)0x0200)
 312#define HFA384x_PDR_RFR_SETTING         ((u16)0x0201)
 313#define HFA384x_PDR_HFA3861_BASELINE    ((u16)0x0202)
 314#define HFA384x_PDR_HFA3861_SHADOW      ((u16)0x0203)
 315#define HFA384x_PDR_HFA3861_IFRF        ((u16)0x0204)
 316#define HFA384x_PDR_HFA3861_CHCALSP     ((u16)0x0300)
 317#define HFA384x_PDR_HFA3861_CHCALI      ((u16)0x0301)
 318#define HFA384x_PDR_MAX_TX_POWER        ((u16)0x0302)
 319#define HFA384x_PDR_MASTER_CHAN_LIST    ((u16)0x0303)
 320#define HFA384x_PDR_3842_NIC_CONFIG     ((u16)0x0400)
 321#define HFA384x_PDR_USB_ID              ((u16)0x0401)
 322#define HFA384x_PDR_PCI_ID              ((u16)0x0402)
 323#define HFA384x_PDR_PCI_IFCONF          ((u16)0x0403)
 324#define HFA384x_PDR_PCI_PMCONF          ((u16)0x0404)
 325#define HFA384x_PDR_RFENRGY             ((u16)0x0406)
 326#define HFA384x_PDR_USB_POWER_TYPE      ((u16)0x0407)
 327#define HFA384x_PDR_USB_MAX_POWER       ((u16)0x0409)
 328#define HFA384x_PDR_USB_MANUFACTURER    ((u16)0x0410)
 329#define HFA384x_PDR_USB_PRODUCT         ((u16)0x0411)
 330#define HFA384x_PDR_ANT_DIVERSITY       ((u16)0x0412)
 331#define HFA384x_PDR_HFO_DELAY           ((u16)0x0413)
 332#define HFA384x_PDR_SCALE_THRESH        ((u16)0x0414)
 333
 334#define HFA384x_PDR_HFA3861_MANF_TESTSP ((u16)0x0900)
 335#define HFA384x_PDR_HFA3861_MANF_TESTI  ((u16)0x0901)
 336#define HFA384x_PDR_END_OF_PDA          ((u16)0x0000)
 337
 338/*--- Register Test/Get/Set Field macros ------------------------*/
 339
 340#define         HFA384x_CMD_AINFO_SET(value)    ((u16)((u16)(value) << 8))
 341#define         HFA384x_CMD_MACPORT_SET(value)  \
 342                        ((u16)HFA384x_CMD_AINFO_SET(value))
 343#define         HFA384x_CMD_PROGMODE_SET(value) \
 344                        ((u16)HFA384x_CMD_AINFO_SET((u16)value))
 345#define         HFA384x_CMD_CMDCODE_SET(value)          ((u16)(value))
 346
 347#define         HFA384x_STATUS_RESULT_SET(value)        (((u16)(value)) << 8)
 348
 349/* Host Maintained State Info */
 350#define HFA384x_STATE_PREINIT   0
 351#define HFA384x_STATE_INIT      1
 352#define HFA384x_STATE_RUNNING   2
 353
 354/*-------------------------------------------------------------*/
 355/* Commonly used basic types */
 356struct hfa384x_bytestr {
 357        __le16 len;
 358        u8 data[];
 359} __packed;
 360
 361struct hfa384x_bytestr32 {
 362        __le16 len;
 363        u8 data[32];
 364} __packed;
 365
 366/*--------------------------------------------------------------------
 367 * Configuration Record Structures:
 368 *      Network Parameters, Static Configuration Entities
 369 *--------------------------------------------------------------------
 370 */
 371
 372/*-- Hardware/Firmware Component Information ----------*/
 373struct hfa384x_compident {
 374        u16 id;
 375        u16 variant;
 376        u16 major;
 377        u16 minor;
 378} __packed;
 379
 380struct hfa384x_caplevel {
 381        u16 role;
 382        u16 id;
 383        u16 variant;
 384        u16 bottom;
 385        u16 top;
 386} __packed;
 387
 388/*-- Configuration Record: cnfAuthentication --*/
 389#define HFA384x_CNFAUTHENTICATION_OPENSYSTEM    0x0001
 390#define HFA384x_CNFAUTHENTICATION_SHAREDKEY     0x0002
 391#define HFA384x_CNFAUTHENTICATION_LEAP          0x0004
 392
 393/*--------------------------------------------------------------------
 394 * Configuration Record Structures:
 395 *      Network Parameters, Dynamic Configuration Entities
 396 *--------------------------------------------------------------------
 397 */
 398
 399#define HFA384x_CREATEIBSS_JOINCREATEIBSS          0
 400
 401/*-- Configuration Record: HostScanRequest (data portion only) --*/
 402struct hfa384x_host_scan_request_data {
 403        __le16 channel_list;
 404        __le16 tx_rate;
 405        struct hfa384x_bytestr32 ssid;
 406} __packed;
 407
 408/*-- Configuration Record: JoinRequest (data portion only) --*/
 409struct hfa384x_join_request_data {
 410        u8 bssid[WLAN_BSSID_LEN];
 411        u16 channel;
 412} __packed;
 413
 414/*-- Configuration Record: authenticateStation (data portion only) --*/
 415struct hfa384x_authenticate_station_data {
 416        u8 address[ETH_ALEN];
 417        __le16 status;
 418        __le16 algorithm;
 419} __packed;
 420
 421/*-- Configuration Record: WPAData       (data portion only) --*/
 422struct hfa384x_wpa_data {
 423        __le16 datalen;
 424        u8 data[];              /* max 80 */
 425} __packed;
 426
 427/*--------------------------------------------------------------------
 428 * Information Record Structures: NIC Information
 429 *--------------------------------------------------------------------
 430 */
 431
 432/*-- Information Record: DownLoadBuffer --*/
 433/* NOTE: The page and offset are in AUX format */
 434struct hfa384x_downloadbuffer {
 435        u16 page;
 436        u16 offset;
 437        u16 len;
 438} __packed;
 439
 440/*--------------------------------------------------------------------
 441 * Information Record Structures: NIC Information
 442 *--------------------------------------------------------------------
 443 */
 444
 445#define HFA384x_PSTATUS_CONN_IBSS       ((u16)3)
 446
 447/*-- Information Record: commsquality --*/
 448struct hfa384x_commsquality {
 449        __le16 cq_curr_bss;
 450        __le16 asl_curr_bss;
 451        __le16 anl_curr_fc;
 452} __packed;
 453
 454/*-- Information Record: dmbcommsquality --*/
 455struct hfa384x_dbmcommsquality {
 456        u16 cq_dbm_curr_bss;
 457        u16 asl_dbm_curr_bss;
 458        u16 anl_dbm_curr_fc;
 459} __packed;
 460
 461/*--------------------------------------------------------------------
 462 * FRAME STRUCTURES: Communication Frames
 463 *--------------------------------------------------------------------
 464 * Communication Frames: Transmit Frames
 465 *--------------------------------------------------------------------
 466 */
 467/*-- Communication Frame: Transmit Frame Structure --*/
 468struct hfa384x_tx_frame {
 469        u16 status;
 470        u16 reserved1;
 471        u16 reserved2;
 472        u32 sw_support;
 473        u8 tx_retrycount;
 474        u8 tx_rate;
 475        u16 tx_control;
 476
 477        /*-- 802.11 Header Information --*/
 478        struct p80211_hdr hdr;
 479        __le16 data_len;                /* little endian format */
 480
 481        /*-- 802.3 Header Information --*/
 482
 483        u8 dest_addr[6];
 484        u8 src_addr[6];
 485        u16 data_length;        /* big endian format */
 486} __packed;
 487/*--------------------------------------------------------------------
 488 * Communication Frames: Field Masks for Transmit Frames
 489 *--------------------------------------------------------------------
 490 */
 491/*-- Status Field --*/
 492#define         HFA384x_TXSTATUS_ACKERR                 ((u16)BIT(5))
 493#define         HFA384x_TXSTATUS_FORMERR                ((u16)BIT(3))
 494#define         HFA384x_TXSTATUS_DISCON                 ((u16)BIT(2))
 495#define         HFA384x_TXSTATUS_AGEDERR                ((u16)BIT(1))
 496#define         HFA384x_TXSTATUS_RETRYERR               ((u16)BIT(0))
 497/*-- Transmit Control Field --*/
 498#define         HFA384x_TX_MACPORT                      ((u16)GENMASK(10, 8))
 499#define         HFA384x_TX_STRUCTYPE                    ((u16)GENMASK(4, 3))
 500#define         HFA384x_TX_TXEX                         ((u16)BIT(2))
 501#define         HFA384x_TX_TXOK                         ((u16)BIT(1))
 502/*--------------------------------------------------------------------
 503 * Communication Frames: Test/Get/Set Field Values for Transmit Frames
 504 *--------------------------------------------------------------------
 505 */
 506/*-- Status Field --*/
 507#define HFA384x_TXSTATUS_ISERROR(v)     \
 508        (((u16)(v)) & \
 509        (HFA384x_TXSTATUS_ACKERR | HFA384x_TXSTATUS_FORMERR | \
 510        HFA384x_TXSTATUS_DISCON | HFA384x_TXSTATUS_AGEDERR | \
 511        HFA384x_TXSTATUS_RETRYERR))
 512
 513#define HFA384x_TX_SET(v, m, s)         ((((u16)(v)) << ((u16)(s))) & ((u16)(m)))
 514
 515#define HFA384x_TX_MACPORT_SET(v)       HFA384x_TX_SET(v, HFA384x_TX_MACPORT, 8)
 516#define HFA384x_TX_STRUCTYPE_SET(v)     HFA384x_TX_SET(v, \
 517                                                HFA384x_TX_STRUCTYPE, 3)
 518#define HFA384x_TX_TXEX_SET(v)          HFA384x_TX_SET(v, HFA384x_TX_TXEX, 2)
 519#define HFA384x_TX_TXOK_SET(v)          HFA384x_TX_SET(v, HFA384x_TX_TXOK, 1)
 520/*--------------------------------------------------------------------
 521 * Communication Frames: Receive Frames
 522 *--------------------------------------------------------------------
 523 */
 524/*-- Communication Frame: Receive Frame Structure --*/
 525struct hfa384x_rx_frame {
 526        /*-- MAC rx descriptor (hfa384x byte order) --*/
 527        u16 status;
 528        u32 time;
 529        u8 silence;
 530        u8 signal;
 531        u8 rate;
 532        u8 rx_flow;
 533        u16 reserved1;
 534        u16 reserved2;
 535
 536        /*-- 802.11 Header Information (802.11 byte order) --*/
 537        struct p80211_hdr hdr;
 538        __le16 data_len;                /* hfa384x (little endian) format */
 539
 540        /*-- 802.3 Header Information --*/
 541        u8 dest_addr[6];
 542        u8 src_addr[6];
 543        u16 data_length;        /* IEEE? (big endian) format */
 544} __packed;
 545/*--------------------------------------------------------------------
 546 * Communication Frames: Field Masks for Receive Frames
 547 *--------------------------------------------------------------------
 548 */
 549
 550/*-- Status Fields --*/
 551#define         HFA384x_RXSTATUS_MACPORT                ((u16)GENMASK(10, 8))
 552#define         HFA384x_RXSTATUS_FCSERR                 ((u16)BIT(0))
 553/*--------------------------------------------------------------------
 554 * Communication Frames: Test/Get/Set Field Values for Receive Frames
 555 *--------------------------------------------------------------------
 556 */
 557#define         HFA384x_RXSTATUS_MACPORT_GET(value)     ((u16)((((u16)(value)) \
 558                                            & HFA384x_RXSTATUS_MACPORT) >> 8))
 559#define         HFA384x_RXSTATUS_ISFCSERR(value)        ((u16)(((u16)(value)) \
 560                                                  & HFA384x_RXSTATUS_FCSERR))
 561/*--------------------------------------------------------------------
 562 * FRAME STRUCTURES: Information Types and Information Frame Structures
 563 *--------------------------------------------------------------------
 564 * Information Types
 565 *--------------------------------------------------------------------
 566 */
 567#define         HFA384x_IT_HANDOVERADDR                 ((u16)0xF000UL)
 568#define         HFA384x_IT_COMMTALLIES                  ((u16)0xF100UL)
 569#define         HFA384x_IT_SCANRESULTS                  ((u16)0xF101UL)
 570#define         HFA384x_IT_CHINFORESULTS                ((u16)0xF102UL)
 571#define         HFA384x_IT_HOSTSCANRESULTS              ((u16)0xF103UL)
 572#define         HFA384x_IT_LINKSTATUS                   ((u16)0xF200UL)
 573#define         HFA384x_IT_ASSOCSTATUS                  ((u16)0xF201UL)
 574#define         HFA384x_IT_AUTHREQ                      ((u16)0xF202UL)
 575#define         HFA384x_IT_PSUSERCNT                    ((u16)0xF203UL)
 576#define         HFA384x_IT_KEYIDCHANGED                 ((u16)0xF204UL)
 577#define         HFA384x_IT_ASSOCREQ                     ((u16)0xF205UL)
 578#define         HFA384x_IT_MICFAILURE                   ((u16)0xF206UL)
 579
 580/*--------------------------------------------------------------------
 581 * Information Frames Structures
 582 *--------------------------------------------------------------------
 583 * Information Frames: Notification Frame Structures
 584 *--------------------------------------------------------------------
 585 */
 586
 587/*--  Inquiry Frame, Diagnose: Communication Tallies --*/
 588struct hfa384x_comm_tallies_16 {
 589        __le16 txunicastframes;
 590        __le16 txmulticastframes;
 591        __le16 txfragments;
 592        __le16 txunicastoctets;
 593        __le16 txmulticastoctets;
 594        __le16 txdeferredtrans;
 595        __le16 txsingleretryframes;
 596        __le16 txmultipleretryframes;
 597        __le16 txretrylimitexceeded;
 598        __le16 txdiscards;
 599        __le16 rxunicastframes;
 600        __le16 rxmulticastframes;
 601        __le16 rxfragments;
 602        __le16 rxunicastoctets;
 603        __le16 rxmulticastoctets;
 604        __le16 rxfcserrors;
 605        __le16 rxdiscardsnobuffer;
 606        __le16 txdiscardswrongsa;
 607        __le16 rxdiscardswepundecr;
 608        __le16 rxmsginmsgfrag;
 609        __le16 rxmsginbadmsgfrag;
 610} __packed;
 611
 612struct hfa384x_comm_tallies_32 {
 613        __le32 txunicastframes;
 614        __le32 txmulticastframes;
 615        __le32 txfragments;
 616        __le32 txunicastoctets;
 617        __le32 txmulticastoctets;
 618        __le32 txdeferredtrans;
 619        __le32 txsingleretryframes;
 620        __le32 txmultipleretryframes;
 621        __le32 txretrylimitexceeded;
 622        __le32 txdiscards;
 623        __le32 rxunicastframes;
 624        __le32 rxmulticastframes;
 625        __le32 rxfragments;
 626        __le32 rxunicastoctets;
 627        __le32 rxmulticastoctets;
 628        __le32 rxfcserrors;
 629        __le32 rxdiscardsnobuffer;
 630        __le32 txdiscardswrongsa;
 631        __le32 rxdiscardswepundecr;
 632        __le32 rxmsginmsgfrag;
 633        __le32 rxmsginbadmsgfrag;
 634} __packed;
 635
 636/*--  Inquiry Frame, Diagnose: Scan Results & Subfields--*/
 637struct hfa384x_scan_result_sub {
 638        u16 chid;
 639        u16 anl;
 640        u16 sl;
 641        u8 bssid[WLAN_BSSID_LEN];
 642        u16 bcnint;
 643        u16 capinfo;
 644        struct hfa384x_bytestr32 ssid;
 645        u8 supprates[10];       /* 802.11 info element */
 646        u16 proberesp_rate;
 647} __packed;
 648
 649struct hfa384x_scan_result {
 650        u16 rsvd;
 651        u16 scanreason;
 652        struct hfa384x_scan_result_sub result[HFA384x_SCANRESULT_MAX];
 653} __packed;
 654
 655/*--  Inquiry Frame, Diagnose: ChInfo Results & Subfields--*/
 656struct hfa384x_ch_info_result_sub {
 657        u16 chid;
 658        u16 anl;
 659        u16 pnl;
 660        u16 active;
 661} __packed;
 662
 663#define HFA384x_CHINFORESULT_BSSACTIVE  BIT(0)
 664#define HFA384x_CHINFORESULT_PCFACTIVE  BIT(1)
 665
 666struct hfa384x_ch_info_result {
 667        u16 scanchannels;
 668        struct hfa384x_ch_info_result_sub result[HFA384x_CHINFORESULT_MAX];
 669} __packed;
 670
 671/*--  Inquiry Frame, Diagnose: Host Scan Results & Subfields--*/
 672struct hfa384x_hscan_result_sub {
 673        __le16 chid;
 674        __le16 anl;
 675        __le16 sl;
 676        u8 bssid[WLAN_BSSID_LEN];
 677        __le16 bcnint;
 678        __le16 capinfo;
 679        struct hfa384x_bytestr32 ssid;
 680        u8 supprates[10];       /* 802.11 info element */
 681        u16 proberesp_rate;
 682        __le16 atim;
 683} __packed;
 684
 685struct hfa384x_hscan_result {
 686        u16 nresult;
 687        u16 rsvd;
 688        struct hfa384x_hscan_result_sub result[HFA384x_HSCANRESULT_MAX];
 689} __packed;
 690
 691/*--  Unsolicited Frame, MAC Mgmt: LinkStatus --*/
 692
 693#define HFA384x_LINK_NOTCONNECTED       ((u16)0)
 694#define HFA384x_LINK_CONNECTED          ((u16)1)
 695#define HFA384x_LINK_DISCONNECTED       ((u16)2)
 696#define HFA384x_LINK_AP_CHANGE          ((u16)3)
 697#define HFA384x_LINK_AP_OUTOFRANGE      ((u16)4)
 698#define HFA384x_LINK_AP_INRANGE         ((u16)5)
 699#define HFA384x_LINK_ASSOCFAIL          ((u16)6)
 700
 701struct hfa384x_link_status {
 702        __le16 linkstatus;
 703} __packed;
 704
 705/*--  Unsolicited Frame, MAC Mgmt: AssociationStatus (--*/
 706
 707#define HFA384x_ASSOCSTATUS_STAASSOC    ((u16)1)
 708#define HFA384x_ASSOCSTATUS_REASSOC     ((u16)2)
 709#define HFA384x_ASSOCSTATUS_AUTHFAIL    ((u16)5)
 710
 711struct hfa384x_assoc_status {
 712        u16 assocstatus;
 713        u8 sta_addr[ETH_ALEN];
 714        /* old_ap_addr is only valid if assocstatus == 2 */
 715        u8 old_ap_addr[ETH_ALEN];
 716        u16 reason;
 717        u16 reserved;
 718} __packed;
 719
 720/*--  Unsolicited Frame, MAC Mgmt: AuthRequest (AP Only) --*/
 721
 722struct hfa384x_auth_request {
 723        u8 sta_addr[ETH_ALEN];
 724        __le16 algorithm;
 725} __packed;
 726
 727/*--  Unsolicited Frame, MAC Mgmt: PSUserCount (AP Only) --*/
 728
 729struct hfa384x_ps_user_count {
 730        __le16 usercnt;
 731} __packed;
 732
 733struct hfa384x_key_id_changed {
 734        u8 sta_addr[ETH_ALEN];
 735        u16 keyid;
 736} __packed;
 737
 738/*--  Collection of all Inf frames ---------------*/
 739union hfa384x_infodata {
 740        struct hfa384x_comm_tallies_16 commtallies16;
 741        struct hfa384x_comm_tallies_32 commtallies32;
 742        struct hfa384x_scan_result scanresult;
 743        struct hfa384x_ch_info_result chinforesult;
 744        struct hfa384x_hscan_result hscanresult;
 745        struct hfa384x_link_status linkstatus;
 746        struct hfa384x_assoc_status assocstatus;
 747        struct hfa384x_auth_request authreq;
 748        struct hfa384x_ps_user_count psusercnt;
 749        struct hfa384x_key_id_changed keyidchanged;
 750} __packed;
 751
 752struct hfa384x_inf_frame {
 753        u16 framelen;
 754        u16 infotype;
 755        union hfa384x_infodata info;
 756} __packed;
 757
 758/*--------------------------------------------------------------------
 759 * USB Packet structures and constants.
 760 *--------------------------------------------------------------------
 761 */
 762
 763/* Should be sent to the bulkout endpoint */
 764#define HFA384x_USB_TXFRM       0
 765#define HFA384x_USB_CMDREQ      1
 766#define HFA384x_USB_WRIDREQ     2
 767#define HFA384x_USB_RRIDREQ     3
 768#define HFA384x_USB_WMEMREQ     4
 769#define HFA384x_USB_RMEMREQ     5
 770
 771/* Received from the bulkin endpoint */
 772#define HFA384x_USB_ISTXFRM(a)  (((a) & 0x9000) == 0x1000)
 773#define HFA384x_USB_ISRXFRM(a)  (!((a) & 0x9000))
 774#define HFA384x_USB_INFOFRM     0x8000
 775#define HFA384x_USB_CMDRESP     0x8001
 776#define HFA384x_USB_WRIDRESP    0x8002
 777#define HFA384x_USB_RRIDRESP    0x8003
 778#define HFA384x_USB_WMEMRESP    0x8004
 779#define HFA384x_USB_RMEMRESP    0x8005
 780#define HFA384x_USB_BUFAVAIL    0x8006
 781#define HFA384x_USB_ERROR       0x8007
 782
 783/*------------------------------------*/
 784/* Request (bulk OUT) packet contents */
 785
 786struct hfa384x_usb_txfrm {
 787        struct hfa384x_tx_frame desc;
 788        u8 data[WLAN_DATA_MAXLEN];
 789} __packed;
 790
 791struct hfa384x_usb_cmdreq {
 792        __le16 type;
 793        __le16 cmd;
 794        __le16 parm0;
 795        __le16 parm1;
 796        __le16 parm2;
 797        u8 pad[54];
 798} __packed;
 799
 800struct hfa384x_usb_wridreq {
 801        __le16 type;
 802        __le16 frmlen;
 803        __le16 rid;
 804        u8 data[HFA384x_RIDDATA_MAXLEN];
 805} __packed;
 806
 807struct hfa384x_usb_rridreq {
 808        __le16 type;
 809        __le16 frmlen;
 810        __le16 rid;
 811        u8 pad[58];
 812} __packed;
 813
 814struct hfa384x_usb_wmemreq {
 815        __le16 type;
 816        __le16 frmlen;
 817        __le16 offset;
 818        __le16 page;
 819        u8 data[HFA384x_USB_RWMEM_MAXLEN];
 820} __packed;
 821
 822struct hfa384x_usb_rmemreq {
 823        __le16 type;
 824        __le16 frmlen;
 825        __le16 offset;
 826        __le16 page;
 827        u8 pad[56];
 828} __packed;
 829
 830/*------------------------------------*/
 831/* Response (bulk IN) packet contents */
 832
 833struct hfa384x_usb_rxfrm {
 834        struct hfa384x_rx_frame desc;
 835        u8 data[WLAN_DATA_MAXLEN];
 836} __packed;
 837
 838struct hfa384x_usb_infofrm {
 839        u16 type;
 840        struct hfa384x_inf_frame info;
 841} __packed;
 842
 843struct hfa384x_usb_statusresp {
 844        u16 type;
 845        __le16 status;
 846        __le16 resp0;
 847        __le16 resp1;
 848        __le16 resp2;
 849} __packed;
 850
 851struct hfa384x_usb_rridresp {
 852        u16 type;
 853        __le16 frmlen;
 854        __le16 rid;
 855        u8 data[HFA384x_RIDDATA_MAXLEN];
 856} __packed;
 857
 858struct hfa384x_usb_rmemresp {
 859        u16 type;
 860        u16 frmlen;
 861        u8 data[HFA384x_USB_RWMEM_MAXLEN];
 862} __packed;
 863
 864struct hfa384x_usb_bufavail {
 865        u16 type;
 866        u16 frmlen;
 867} __packed;
 868
 869struct hfa384x_usb_error {
 870        u16 type;
 871        u16 errortype;
 872} __packed;
 873
 874/*----------------------------------------------------------*/
 875/* Unions for packaging all the known packet types together */
 876
 877union hfa384x_usbout {
 878        __le16 type;
 879        struct hfa384x_usb_txfrm txfrm;
 880        struct hfa384x_usb_cmdreq cmdreq;
 881        struct hfa384x_usb_wridreq wridreq;
 882        struct hfa384x_usb_rridreq rridreq;
 883        struct hfa384x_usb_wmemreq wmemreq;
 884        struct hfa384x_usb_rmemreq rmemreq;
 885} __packed;
 886
 887union hfa384x_usbin {
 888        __le16 type;
 889        struct hfa384x_usb_rxfrm rxfrm;
 890        struct hfa384x_usb_txfrm txfrm;
 891        struct hfa384x_usb_infofrm infofrm;
 892        struct hfa384x_usb_statusresp cmdresp;
 893        struct hfa384x_usb_statusresp wridresp;
 894        struct hfa384x_usb_rridresp rridresp;
 895        struct hfa384x_usb_statusresp wmemresp;
 896        struct hfa384x_usb_rmemresp rmemresp;
 897        struct hfa384x_usb_bufavail bufavail;
 898        struct hfa384x_usb_error usberror;
 899        u8 boguspad[3000];
 900} __packed;
 901
 902/*--------------------------------------------------------------------
 903 * PD record structures.
 904 *--------------------------------------------------------------------
 905 */
 906
 907struct hfa384x_pdr_pcb_partnum {
 908        u8 num[8];
 909} __packed;
 910
 911struct hfa384x_pdr_pcb_tracenum {
 912        u8 num[8];
 913} __packed;
 914
 915struct hfa384x_pdr_nic_serial {
 916        u8 num[12];
 917} __packed;
 918
 919struct hfa384x_pdr_mkk_measurements {
 920        double carrier_freq;
 921        double occupied_band;
 922        double power_density;
 923        double tx_spur_f1;
 924        double tx_spur_f2;
 925        double tx_spur_f3;
 926        double tx_spur_f4;
 927        double tx_spur_l1;
 928        double tx_spur_l2;
 929        double tx_spur_l3;
 930        double tx_spur_l4;
 931        double rx_spur_f1;
 932        double rx_spur_f2;
 933        double rx_spur_l1;
 934        double rx_spur_l2;
 935} __packed;
 936
 937struct hfa384x_pdr_nic_ramsize {
 938        u8 size[12];            /* units of KB */
 939} __packed;
 940
 941struct hfa384x_pdr_mfisuprange {
 942        u16 id;
 943        u16 variant;
 944        u16 bottom;
 945        u16 top;
 946} __packed;
 947
 948struct hfa384x_pdr_cfisuprange {
 949        u16 id;
 950        u16 variant;
 951        u16 bottom;
 952        u16 top;
 953} __packed;
 954
 955struct hfa384x_pdr_nicid {
 956        u16 id;
 957        u16 variant;
 958        u16 major;
 959        u16 minor;
 960} __packed;
 961
 962struct hfa384x_pdr_refdac_measurements {
 963        u16 value[0];
 964} __packed;
 965
 966struct hfa384x_pdr_vgdac_measurements {
 967        u16 value[0];
 968} __packed;
 969
 970struct hfa384x_pdr_level_comp_measurements {
 971        u16 value[0];
 972} __packed;
 973
 974struct hfa384x_pdr_mac_address {
 975        u8 addr[6];
 976} __packed;
 977
 978struct hfa384x_pdr_mkk_callname {
 979        u8 callname[8];
 980} __packed;
 981
 982struct hfa384x_pdr_regdomain {
 983        u16 numdomains;
 984        u16 domain[5];
 985} __packed;
 986
 987struct hfa384x_pdr_allowed_channel {
 988        u16 ch_bitmap;
 989} __packed;
 990
 991struct hfa384x_pdr_default_channel {
 992        u16 channel;
 993} __packed;
 994
 995struct hfa384x_pdr_privacy_option {
 996        u16 available;
 997} __packed;
 998
 999struct hfa384x_pdr_temptype {
1000        u16 type;
1001} __packed;
1002
1003struct hfa384x_pdr_refdac_setup {
1004        u16 ch_value[14];
1005} __packed;
1006
1007struct hfa384x_pdr_vgdac_setup {
1008        u16 ch_value[14];
1009} __packed;
1010
1011struct hfa384x_pdr_level_comp_setup {
1012        u16 ch_value[14];
1013} __packed;
1014
1015struct hfa384x_pdr_trimdac_setup {
1016        u16 trimidac;
1017        u16 trimqdac;
1018} __packed;
1019
1020struct hfa384x_pdr_ifr_setting {
1021        u16 value[3];
1022} __packed;
1023
1024struct hfa384x_pdr_rfr_setting {
1025        u16 value[3];
1026} __packed;
1027
1028struct hfa384x_pdr_hfa3861_baseline {
1029        u16 value[50];
1030} __packed;
1031
1032struct hfa384x_pdr_hfa3861_shadow {
1033        u32 value[32];
1034} __packed;
1035
1036struct hfa384x_pdr_hfa3861_ifrf {
1037        u32 value[20];
1038} __packed;
1039
1040struct hfa384x_pdr_hfa3861_chcalsp {
1041        u16 value[14];
1042} __packed;
1043
1044struct hfa384x_pdr_hfa3861_chcali {
1045        u16 value[17];
1046} __packed;
1047
1048struct hfa384x_pdr_hfa3861_nic_config {
1049        u16 config_bitmap;
1050} __packed;
1051
1052struct hfa384x_pdr_hfo_delay {
1053        u8 hfo_delay;
1054} __packed;
1055
1056struct hfa384x_pdr_hfa3861_manf_testsp {
1057        u16 value[30];
1058} __packed;
1059
1060struct hfa384x_pdr_hfa3861_manf_testi {
1061        u16 value[30];
1062} __packed;
1063
1064struct hfa384x_pdr_end_of_pda {
1065        u16 crc;
1066} __packed;
1067
1068struct hfa384x_pdrec {
1069        __le16 len;             /* in words */
1070        __le16 code;
1071        union pdr {
1072                struct hfa384x_pdr_pcb_partnum pcb_partnum;
1073                struct hfa384x_pdr_pcb_tracenum pcb_tracenum;
1074                struct hfa384x_pdr_nic_serial nic_serial;
1075                struct hfa384x_pdr_mkk_measurements mkk_measurements;
1076                struct hfa384x_pdr_nic_ramsize nic_ramsize;
1077                struct hfa384x_pdr_mfisuprange mfisuprange;
1078                struct hfa384x_pdr_cfisuprange cfisuprange;
1079                struct hfa384x_pdr_nicid nicid;
1080                struct hfa384x_pdr_refdac_measurements refdac_measurements;
1081                struct hfa384x_pdr_vgdac_measurements vgdac_measurements;
1082                struct hfa384x_pdr_level_comp_measurements level_compc_measurements;
1083                struct hfa384x_pdr_mac_address mac_address;
1084                struct hfa384x_pdr_mkk_callname mkk_callname;
1085                struct hfa384x_pdr_regdomain regdomain;
1086                struct hfa384x_pdr_allowed_channel allowed_channel;
1087                struct hfa384x_pdr_default_channel default_channel;
1088                struct hfa384x_pdr_privacy_option privacy_option;
1089                struct hfa384x_pdr_temptype temptype;
1090                struct hfa384x_pdr_refdac_setup refdac_setup;
1091                struct hfa384x_pdr_vgdac_setup vgdac_setup;
1092                struct hfa384x_pdr_level_comp_setup level_comp_setup;
1093                struct hfa384x_pdr_trimdac_setup trimdac_setup;
1094                struct hfa384x_pdr_ifr_setting ifr_setting;
1095                struct hfa384x_pdr_rfr_setting rfr_setting;
1096                struct hfa384x_pdr_hfa3861_baseline hfa3861_baseline;
1097                struct hfa384x_pdr_hfa3861_shadow hfa3861_shadow;
1098                struct hfa384x_pdr_hfa3861_ifrf hfa3861_ifrf;
1099                struct hfa384x_pdr_hfa3861_chcalsp hfa3861_chcalsp;
1100                struct hfa384x_pdr_hfa3861_chcali hfa3861_chcali;
1101                struct hfa384x_pdr_hfa3861_nic_config nic_config;
1102                struct hfa384x_pdr_hfo_delay hfo_delay;
1103                struct hfa384x_pdr_hfa3861_manf_testsp hfa3861_manf_testsp;
1104                struct hfa384x_pdr_hfa3861_manf_testi hfa3861_manf_testi;
1105                struct hfa384x_pdr_end_of_pda end_of_pda;
1106
1107        } data;
1108} __packed;
1109
1110#ifdef __KERNEL__
1111/*--------------------------------------------------------------------
1112 * ---  MAC state structure, argument to all functions --
1113 * ---  Also, a collection of support types --
1114 *--------------------------------------------------------------------
1115 */
1116struct hfa384x_cmdresult {
1117        u16 status;
1118        u16 resp0;
1119        u16 resp1;
1120        u16 resp2;
1121};
1122
1123/* USB Control Exchange (CTLX):
1124 *  A queue of the structure below is maintained for all of the
1125 *  Request/Response type USB packets supported by Prism2.
1126 */
1127/* The following hfa384x_* structures are arguments to
1128 * the usercb() for the different CTLX types.
1129 */
1130struct hfa384x_rridresult {
1131        u16 rid;
1132        const void *riddata;
1133        unsigned int riddata_len;
1134};
1135
1136enum ctlx_state {
1137        CTLX_START = 0,         /* Start state, not queued */
1138
1139        CTLX_COMPLETE,          /* CTLX successfully completed */
1140        CTLX_REQ_FAILED,        /* OUT URB completed w/ error */
1141
1142        CTLX_PENDING,           /* Queued, data valid */
1143        CTLX_REQ_SUBMITTED,     /* OUT URB submitted */
1144        CTLX_REQ_COMPLETE,      /* OUT URB complete */
1145        CTLX_RESP_COMPLETE      /* IN URB received */
1146};
1147
1148struct hfa384x_usbctlx;
1149struct hfa384x;
1150
1151typedef void (*ctlx_cmdcb_t) (struct hfa384x *, const struct hfa384x_usbctlx *);
1152
1153typedef void (*ctlx_usercb_t) (struct hfa384x *hw,
1154                               void *ctlxresult, void *usercb_data);
1155
1156struct hfa384x_usbctlx {
1157        struct list_head list;
1158
1159        size_t outbufsize;
1160        union hfa384x_usbout outbuf;    /* pkt buf for OUT */
1161        union hfa384x_usbin inbuf;      /* pkt buf for IN(a copy) */
1162
1163        enum ctlx_state state;  /* Tracks running state */
1164
1165        struct completion done;
1166        int reapable;           /* Food for the reaper task */
1167
1168        ctlx_cmdcb_t cmdcb;     /* Async command callback */
1169        ctlx_usercb_t usercb;   /* Async user callback, */
1170        void *usercb_data;      /*  at CTLX completion  */
1171};
1172
1173struct hfa384x_usbctlxq {
1174        spinlock_t lock;
1175        struct list_head pending;
1176        struct list_head active;
1177        struct list_head completing;
1178        struct list_head reapable;
1179};
1180
1181struct hfa384x_metacmd {
1182        u16 cmd;
1183
1184        u16 parm0;
1185        u16 parm1;
1186        u16 parm2;
1187
1188        struct hfa384x_cmdresult result;
1189};
1190
1191#define MAX_GRP_ADDR            32
1192#define WLAN_COMMENT_MAX        80  /* Max. length of user comment string. */
1193
1194#define WLAN_AUTH_MAX           60  /* Max. # of authenticated stations. */
1195#define WLAN_ACCESS_MAX         60  /* Max. # of stations in an access list. */
1196#define WLAN_ACCESS_NONE        0   /* No stations may be authenticated. */
1197#define WLAN_ACCESS_ALL         1   /* All stations may be authenticated. */
1198#define WLAN_ACCESS_ALLOW       2   /* Authenticate only "allowed" stations. */
1199#define WLAN_ACCESS_DENY        3   /* Do not authenticate "denied" stations. */
1200
1201/* XXX These are going away ASAP */
1202struct prism2sta_authlist {
1203        unsigned int cnt;
1204        u8 addr[WLAN_AUTH_MAX][ETH_ALEN];
1205        u8 assoc[WLAN_AUTH_MAX];
1206};
1207
1208struct prism2sta_accesslist {
1209        unsigned int modify;
1210        unsigned int cnt;
1211        u8 addr[WLAN_ACCESS_MAX][ETH_ALEN];
1212        unsigned int cnt1;
1213        u8 addr1[WLAN_ACCESS_MAX][ETH_ALEN];
1214};
1215
1216struct hfa384x {
1217        /* USB support data */
1218        struct usb_device *usb;
1219        struct urb rx_urb;
1220        struct sk_buff *rx_urb_skb;
1221        struct urb tx_urb;
1222        struct urb ctlx_urb;
1223        union hfa384x_usbout txbuff;
1224        struct hfa384x_usbctlxq ctlxq;
1225        struct timer_list reqtimer;
1226        struct timer_list resptimer;
1227
1228        struct timer_list throttle;
1229
1230        struct tasklet_struct reaper_bh;
1231        struct tasklet_struct completion_bh;
1232
1233        struct work_struct usb_work;
1234
1235        unsigned long usb_flags;
1236#define THROTTLE_RX     0
1237#define THROTTLE_TX     1
1238#define WORK_RX_HALT    2
1239#define WORK_TX_HALT    3
1240#define WORK_RX_RESUME  4
1241#define WORK_TX_RESUME  5
1242
1243        unsigned short req_timer_done:1;
1244        unsigned short resp_timer_done:1;
1245
1246        int endp_in;
1247        int endp_out;
1248
1249        int sniff_fcs;
1250        int sniff_channel;
1251        int sniff_truncate;
1252        int sniffhdr;
1253
1254        wait_queue_head_t cmdq; /* wait queue itself */
1255
1256        /* Controller state */
1257        u32 state;
1258        u32 isap;
1259        u8 port_enabled[HFA384x_NUMPORTS_MAX];
1260
1261        /* Download support */
1262        unsigned int dlstate;
1263        struct hfa384x_downloadbuffer bufinfo;
1264        u16 dltimeout;
1265
1266        int scanflag;           /* to signal scan complete */
1267        int join_ap;            /* are we joined to a specific ap */
1268        int join_retries;       /* number of join retries till we fail */
1269        struct hfa384x_join_request_data joinreq;/* join request saved data */
1270
1271        struct wlandevice *wlandev;
1272        /* Timer to allow for the deferred processing of linkstatus messages */
1273        struct work_struct link_bh;
1274
1275        struct work_struct commsqual_bh;
1276        struct hfa384x_commsquality qual;
1277        struct timer_list commsqual_timer;
1278
1279        u16 link_status;
1280        u16 link_status_new;
1281        struct sk_buff_head authq;
1282
1283        u32 txrate;
1284
1285        /* And here we have stuff that used to be in priv */
1286
1287        /* State variables */
1288        unsigned int presniff_port_type;
1289        u16 presniff_wepflags;
1290        u32 dot11_desired_bss_type;
1291
1292        int dbmadjust;
1293
1294        /* Group Addresses - right now, there are up to a total
1295         * of MAX_GRP_ADDR group addresses
1296         */
1297        u8 dot11_grp_addr[MAX_GRP_ADDR][ETH_ALEN];
1298        unsigned int dot11_grpcnt;
1299
1300        /* Component Identities */
1301        struct hfa384x_compident ident_nic;
1302        struct hfa384x_compident ident_pri_fw;
1303        struct hfa384x_compident ident_sta_fw;
1304        struct hfa384x_compident ident_ap_fw;
1305        u16 mm_mods;
1306
1307        /* Supplier compatibility ranges */
1308        struct hfa384x_caplevel cap_sup_mfi;
1309        struct hfa384x_caplevel cap_sup_cfi;
1310        struct hfa384x_caplevel cap_sup_pri;
1311        struct hfa384x_caplevel cap_sup_sta;
1312        struct hfa384x_caplevel cap_sup_ap;
1313
1314        /* Actor compatibility ranges */
1315        struct hfa384x_caplevel cap_act_pri_cfi; /*
1316                                                  * pri f/w to controller
1317                                                  * interface
1318                                                  */
1319
1320        struct hfa384x_caplevel cap_act_sta_cfi; /*
1321                                                  * sta f/w to controller
1322                                                  * interface
1323                                                  */
1324
1325        struct hfa384x_caplevel cap_act_sta_mfi; /*
1326                                                  * sta f/w to modem interface
1327                                                  */
1328
1329        struct hfa384x_caplevel cap_act_ap_cfi; /*
1330                                                 * ap f/w to controller
1331                                                 * interface
1332                                                 */
1333
1334        struct hfa384x_caplevel cap_act_ap_mfi; /* ap f/w to modem interface */
1335
1336        u32 psusercount;        /* Power save user count. */
1337        struct hfa384x_comm_tallies_32 tallies; /* Communication tallies. */
1338        u8 comment[WLAN_COMMENT_MAX + 1];       /* User comment */
1339
1340        /* Channel Info request results (AP only) */
1341        struct {
1342                atomic_t done;
1343                u8 count;
1344                struct hfa384x_ch_info_result results;
1345        } channel_info;
1346
1347        struct hfa384x_inf_frame *scanresults;
1348
1349        struct prism2sta_authlist authlist;     /*
1350                                                 * Authenticated station list.
1351                                                 */
1352        unsigned int accessmode;                /* Access mode. */
1353        struct prism2sta_accesslist allow;      /* Allowed station list. */
1354        struct prism2sta_accesslist deny;       /* Denied station list. */
1355
1356};
1357
1358void hfa384x_create(struct hfa384x *hw, struct usb_device *usb);
1359void hfa384x_destroy(struct hfa384x *hw);
1360
1361int hfa384x_corereset(struct hfa384x *hw, int holdtime, int settletime,
1362                      int genesis);
1363int hfa384x_drvr_disable(struct hfa384x *hw, u16 macport);
1364int hfa384x_drvr_enable(struct hfa384x *hw, u16 macport);
1365int hfa384x_drvr_flashdl_enable(struct hfa384x *hw);
1366int hfa384x_drvr_flashdl_disable(struct hfa384x *hw);
1367int hfa384x_drvr_flashdl_write(struct hfa384x *hw, u32 daddr, void *buf,
1368                               u32 len);
1369int hfa384x_drvr_getconfig(struct hfa384x *hw, u16 rid, void *buf, u16 len);
1370int hfa384x_drvr_ramdl_enable(struct hfa384x *hw, u32 exeaddr);
1371int hfa384x_drvr_ramdl_disable(struct hfa384x *hw);
1372int hfa384x_drvr_ramdl_write(struct hfa384x *hw, u32 daddr, void *buf, u32 len);
1373int hfa384x_drvr_readpda(struct hfa384x *hw, void *buf, unsigned int len);
1374int hfa384x_drvr_setconfig(struct hfa384x *hw, u16 rid, void *buf, u16 len);
1375
1376static inline int
1377hfa384x_drvr_getconfig16(struct hfa384x *hw, u16 rid, void *val)
1378{
1379        int result = 0;
1380
1381        result = hfa384x_drvr_getconfig(hw, rid, val, sizeof(u16));
1382        if (result == 0)
1383                le16_to_cpus(val);
1384        return result;
1385}
1386
1387static inline int hfa384x_drvr_setconfig16(struct hfa384x *hw, u16 rid, u16 val)
1388{
1389        __le16 value = cpu_to_le16(val);
1390
1391        return hfa384x_drvr_setconfig(hw, rid, &value, sizeof(value));
1392}
1393
1394int
1395hfa384x_drvr_setconfig_async(struct hfa384x *hw,
1396                             u16 rid,
1397                             void *buf,
1398                             u16 len, ctlx_usercb_t usercb, void *usercb_data);
1399
1400static inline int
1401hfa384x_drvr_setconfig16_async(struct hfa384x *hw, u16 rid, u16 val)
1402{
1403        __le16 value = cpu_to_le16(val);
1404
1405        return hfa384x_drvr_setconfig_async(hw, rid, &value, sizeof(value),
1406                                            NULL, NULL);
1407}
1408
1409int hfa384x_drvr_start(struct hfa384x *hw);
1410int hfa384x_drvr_stop(struct hfa384x *hw);
1411int
1412hfa384x_drvr_txframe(struct hfa384x *hw, struct sk_buff *skb,
1413                     struct p80211_hdr *p80211_hdr,
1414                     struct p80211_metawep *p80211_wep);
1415void hfa384x_tx_timeout(struct wlandevice *wlandev);
1416
1417int hfa384x_cmd_initialize(struct hfa384x *hw);
1418int hfa384x_cmd_enable(struct hfa384x *hw, u16 macport);
1419int hfa384x_cmd_disable(struct hfa384x *hw, u16 macport);
1420int hfa384x_cmd_allocate(struct hfa384x *hw, u16 len);
1421int hfa384x_cmd_monitor(struct hfa384x *hw, u16 enable);
1422int
1423hfa384x_cmd_download(struct hfa384x *hw,
1424                     u16 mode, u16 lowaddr, u16 highaddr, u16 codelen);
1425
1426#endif /*__KERNEL__ */
1427
1428#endif /*_HFA384x_H */
1429