mirror of
https://github.com/freebsd/freebsd-src
synced 2024-07-23 19:28:36 +00:00
689 lines
22 KiB
C
689 lines
22 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*
|
|
* Copyright (c) 2007-2009 Sam Leffler, Errno Consulting
|
|
* Copyright (c) 2007-2009 Marvell Semiconductor, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer,
|
|
* without modification.
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
* similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
|
|
* redistribution must be conditioned upon including a substantially
|
|
* similar Disclaimer requirement for further binary redistribution.
|
|
*
|
|
* NO WARRANTY
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
* THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
|
|
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
|
|
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
|
|
* THE POSSIBILITY OF SUCH DAMAGES.
|
|
*/
|
|
|
|
#ifndef _MWL_HAL_H_
|
|
#define _MWL_HAL_H_
|
|
/*
|
|
* Hardware Access Layer for Marvell Wireless Devices.
|
|
*/
|
|
|
|
#define MWL_MBSS_SUPPORT /* enable multi-bss support */
|
|
|
|
/*
|
|
* Define total number of TX queues in the shared memory.
|
|
* This count includes the EDCA queues, Block Ack queues, and HCCA queues
|
|
* In addition to this, there could be a management packet queue some
|
|
* time in the future
|
|
*/
|
|
#define MWL_NUM_EDCA_QUEUES 4
|
|
#define MWL_NUM_HCCA_QUEUES 0
|
|
#define MWL_NUM_BA_QUEUES 0
|
|
#define MWL_NUM_MGMT_QUEUES 0
|
|
#define MWL_NUM_ACK_QUEUES 0
|
|
#define MWL_NUM_TX_QUEUES \
|
|
(MWL_NUM_EDCA_QUEUES + MWL_NUM_HCCA_QUEUES + MWL_NUM_BA_QUEUES + \
|
|
MWL_NUM_MGMT_QUEUES + MWL_NUM_ACK_QUEUES)
|
|
#define MWL_MAX_RXWCB_QUEUES 1
|
|
|
|
#define MWL_MAX_SUPPORTED_RATES 12
|
|
#define MWL_MAX_SUPPORTED_MCS 32
|
|
|
|
typedef enum {
|
|
MWL_HAL_OK
|
|
} MWL_HAL_STATUS;
|
|
|
|
/*
|
|
* Transmit queue assignment.
|
|
*/
|
|
enum {
|
|
MWL_WME_AC_BK = 0, /* background access category */
|
|
MWL_WME_AC_BE = 1, /* best effort access category*/
|
|
MWL_WME_AC_VI = 2, /* video access category */
|
|
MWL_WME_AC_VO = 3, /* voice access category */
|
|
};
|
|
|
|
struct mwl_hal {
|
|
bus_space_handle_t mh_ioh; /* BAR 1 copied from softc */
|
|
bus_space_tag_t mh_iot;
|
|
uint32_t mh_imask; /* interrupt mask */
|
|
/* remainder is opaque to driver */
|
|
};
|
|
struct mwl_hal *mwl_hal_attach(device_t dev, uint16_t devid,
|
|
bus_space_handle_t ioh, bus_space_tag_t iot, bus_dma_tag_t tag);
|
|
void mwl_hal_detach(struct mwl_hal *);
|
|
|
|
/*
|
|
* Query whether multi-bss support is available/enabled.
|
|
*/
|
|
int mwl_hal_ismbsscapable(struct mwl_hal *);
|
|
|
|
typedef enum {
|
|
MWL_HAL_AP,
|
|
MWL_HAL_STA, /* infrastructure mode */
|
|
MWL_HAL_IBSS /* ibss/adhoc mode */
|
|
} MWL_HAL_BSSTYPE;
|
|
struct mwl_hal_vap;
|
|
|
|
struct mwl_hal_vap *mwl_hal_newvap(struct mwl_hal *, MWL_HAL_BSSTYPE,
|
|
const uint8_t mac[6]);
|
|
void mwl_hal_delvap(struct mwl_hal_vap *);
|
|
|
|
enum {
|
|
MWL_HAL_DEBUG_SENDCMD = 0x00000001,
|
|
MWL_HAL_DEBUG_CMDDONE = 0x00000002,
|
|
MWL_HAL_DEBUG_IGNHANG = 0x00000004,
|
|
};
|
|
void mwl_hal_setdebug(struct mwl_hal *, int);
|
|
int mwl_hal_getdebug(struct mwl_hal *);
|
|
|
|
typedef struct {
|
|
uint16_t freqLow, freqHigh;
|
|
int nchannels;
|
|
struct mwl_hal_channel {
|
|
uint16_t freq; /* channel center */
|
|
uint8_t ieee; /* channel number */
|
|
int8_t maxTxPow; /* max tx power (dBm) */
|
|
uint8_t targetPowers[4];/* target powers (dBm) */
|
|
#define MWL_HAL_MAXCHAN 40
|
|
} channels[MWL_HAL_MAXCHAN];
|
|
} MWL_HAL_CHANNELINFO;
|
|
int mwl_hal_getchannelinfo(struct mwl_hal *, int band, int chw,
|
|
const MWL_HAL_CHANNELINFO **);
|
|
|
|
/*
|
|
* Return the current ISR setting and clear the cause.
|
|
*/
|
|
static __inline void
|
|
mwl_hal_getisr(struct mwl_hal *mh, uint32_t *status)
|
|
{
|
|
#define MACREG_REG_A2H_INTERRUPT_CAUSE 0x00000C30 // (From ARM to host)
|
|
#define MACREG_REG_INT_CODE 0x00000C14
|
|
uint32_t cause;
|
|
|
|
cause = bus_space_read_4(mh->mh_iot, mh->mh_ioh,
|
|
MACREG_REG_A2H_INTERRUPT_CAUSE);
|
|
if (cause == 0xffffffff) { /* card removed */
|
|
cause = 0;
|
|
} else if (cause != 0) {
|
|
/* clear cause bits */
|
|
bus_space_write_4(mh->mh_iot, mh->mh_ioh,
|
|
MACREG_REG_A2H_INTERRUPT_CAUSE, cause &~ mh->mh_imask);
|
|
(void) bus_space_read_4(mh->mh_iot, mh->mh_ioh,
|
|
MACREG_REG_INT_CODE);
|
|
cause &= mh->mh_imask;
|
|
}
|
|
*status = cause;
|
|
#undef MACREG_REG_INT_CODE
|
|
#undef MACREG_REG_A2H_INTERRUPT_CAUSE
|
|
}
|
|
|
|
void mwl_hal_intrset(struct mwl_hal *mh, uint32_t mask);
|
|
|
|
/*
|
|
* Kick the firmware to tell it there are new tx descriptors
|
|
* for processing. The driver says what h/w q has work in
|
|
* case the f/w ever gets smarter.
|
|
*/
|
|
static __inline void
|
|
mwl_hal_txstart(struct mwl_hal *mh, int qnum)
|
|
{
|
|
#define MACREG_REG_H2A_INTERRUPT_EVENTS 0x00000C18 // (From host to ARM)
|
|
#define MACREG_H2ARIC_BIT_PPA_READY 0x00000001 // bit 0
|
|
#define MACREG_REG_INT_CODE 0x00000C14
|
|
|
|
bus_space_write_4(mh->mh_iot, mh->mh_ioh,
|
|
MACREG_REG_H2A_INTERRUPT_EVENTS, MACREG_H2ARIC_BIT_PPA_READY);
|
|
(void) bus_space_read_4(mh->mh_iot, mh->mh_ioh, MACREG_REG_INT_CODE);
|
|
#undef MACREG_REG_INT_CODE
|
|
#undef MACREG_H2ARIC_BIT_PPA_READY
|
|
#undef MACREG_REG_H2A_INTERRUPT_EVENTS
|
|
}
|
|
|
|
void mwl_hal_cmddone(struct mwl_hal *mh);
|
|
|
|
typedef struct {
|
|
uint32_t FreqBand : 6,
|
|
#define MWL_FREQ_BAND_2DOT4GHZ 0x1
|
|
#define MWL_FREQ_BAND_5GHZ 0x4
|
|
ChnlWidth: 5,
|
|
#define MWL_CH_10_MHz_WIDTH 0x1
|
|
#define MWL_CH_20_MHz_WIDTH 0x2
|
|
#define MWL_CH_40_MHz_WIDTH 0x4
|
|
ExtChnlOffset: 2,
|
|
#define MWL_EXT_CH_NONE 0x0
|
|
#define MWL_EXT_CH_ABOVE_CTRL_CH 0x1
|
|
#define MWL_EXT_CH_BELOW_CTRL_CH 0x3
|
|
: 19; /* reserved */
|
|
} MWL_HAL_CHANNEL_FLAGS;
|
|
|
|
typedef struct {
|
|
uint32_t channel;
|
|
MWL_HAL_CHANNEL_FLAGS channelFlags;
|
|
} MWL_HAL_CHANNEL;
|
|
|
|
/*
|
|
* Get Hardware/Firmware capabilities.
|
|
*/
|
|
struct mwl_hal_hwspec {
|
|
uint8_t hwVersion; /* version of the HW */
|
|
uint8_t hostInterface; /* host interface */
|
|
uint16_t maxNumWCB; /* max # of WCB FW handles */
|
|
uint16_t maxNumMCAddr; /* max # of mcast addresses FW handles*/
|
|
uint16_t maxNumTxWcb; /* max # of tx descs per WCB */
|
|
uint8_t macAddr[6]; /* MAC address programmed in HW */
|
|
uint16_t regionCode; /* EEPROM region code */
|
|
uint16_t numAntennas; /* Number of antenna used */
|
|
uint32_t fwReleaseNumber; /* firmware release number */
|
|
uint32_t wcbBase0;
|
|
uint32_t rxDescRead;
|
|
uint32_t rxDescWrite;
|
|
uint32_t ulFwAwakeCookie;
|
|
uint32_t wcbBase[MWL_NUM_TX_QUEUES - MWL_NUM_ACK_QUEUES];
|
|
};
|
|
int mwl_hal_gethwspecs(struct mwl_hal *mh, struct mwl_hal_hwspec *);
|
|
|
|
/*
|
|
* Supply tx/rx dma-related settings to the firmware.
|
|
*/
|
|
struct mwl_hal_txrxdma {
|
|
uint32_t maxNumWCB; /* max # of WCB FW handles */
|
|
uint32_t maxNumTxWcb; /* max # of tx descs per WCB */
|
|
uint32_t rxDescRead;
|
|
uint32_t rxDescWrite;
|
|
uint32_t wcbBase[MWL_NUM_TX_QUEUES - MWL_NUM_ACK_QUEUES];
|
|
};
|
|
int mwl_hal_sethwdma(struct mwl_hal *mh, const struct mwl_hal_txrxdma *);
|
|
|
|
/*
|
|
* Get Hardware Statistics.
|
|
*
|
|
* Items marked with ! are deprecated and not ever updated. In
|
|
* some cases this is because work has been moved to the host (e.g.
|
|
* rx defragmentation).
|
|
*/
|
|
struct mwl_hal_hwstats {
|
|
uint32_t TxRetrySuccesses; /* tx success w/ 1 retry */
|
|
uint32_t TxMultipleRetrySuccesses;/* tx success w/ >1 retry */
|
|
uint32_t TxFailures; /* tx fail due to no ACK */
|
|
uint32_t RTSSuccesses; /* CTS rx'd for RTS */
|
|
uint32_t RTSFailures; /* CTS not rx'd for RTS */
|
|
uint32_t AckFailures; /* same as TxFailures */
|
|
uint32_t RxDuplicateFrames; /* rx discard for dup seqno */
|
|
uint32_t FCSErrorCount; /* rx discard for bad FCS */
|
|
uint32_t TxWatchDogTimeouts; /* MAC tx hang (f/w recovery) */
|
|
uint32_t RxOverflows; /* no f/w buffer for rx data */
|
|
uint32_t RxFragErrors; /* !rx fail due to defrag */
|
|
uint32_t RxMemErrors; /* out of mem or desc corrupted
|
|
in some way */
|
|
uint32_t RxPointerErrors; /* MAC internal ptr problem */
|
|
uint32_t TxUnderflows; /* !tx underflow on dma */
|
|
uint32_t TxDone; /* MAC tx ops completed
|
|
(possibly w/ error) */
|
|
uint32_t TxDoneBufTryPut; /* ! */
|
|
uint32_t TxDoneBufPut; /* same as TxDone */
|
|
uint32_t Wait4TxBuf; /* !no f/w buf avail when
|
|
supplied a tx descriptor */
|
|
uint32_t TxAttempts; /* tx descriptors processed */
|
|
uint32_t TxSuccesses; /* tx attempts successful */
|
|
uint32_t TxFragments; /* tx with fragmentation */
|
|
uint32_t TxMulticasts; /* tx multicast frames */
|
|
uint32_t RxNonCtlPkts; /* rx non-control frames */
|
|
uint32_t RxMulticasts; /* rx multicast frames */
|
|
uint32_t RxUndecryptableFrames; /* rx failed due to crypto */
|
|
uint32_t RxICVErrors; /* rx failed due to ICV check */
|
|
uint32_t RxExcludedFrames; /* rx discarded, e.g. bssid */
|
|
};
|
|
int mwl_hal_gethwstats(struct mwl_hal *mh, struct mwl_hal_hwstats *);
|
|
|
|
/*
|
|
* Set HT Guard Interval.
|
|
*
|
|
* GIType = 0: enable long and short GI
|
|
* GIType = 1: enable short GI
|
|
* GIType = 2: enable long GI
|
|
*/
|
|
int mwl_hal_sethtgi(struct mwl_hal_vap *, int GIType);
|
|
|
|
/*
|
|
* Set Radio Configuration.
|
|
*
|
|
* onoff != 0 turns radio on; otherwise off.
|
|
* if radio is enabled, the preamble is set too.
|
|
*/
|
|
typedef enum {
|
|
WL_LONG_PREAMBLE = 1,
|
|
WL_SHORT_PREAMBLE = 3,
|
|
WL_AUTO_PREAMBLE = 5,
|
|
} MWL_HAL_PREAMBLE;
|
|
int mwl_hal_setradio(struct mwl_hal *mh, int onoff, MWL_HAL_PREAMBLE preamble);
|
|
|
|
/*
|
|
* Set Antenna Configuration (legacy operation).
|
|
*
|
|
* The RX antenna can be selected using the bitmask
|
|
* ant (bit 0 = antenna 1, bit 1 = antenna 2, etc.)
|
|
* (diversity?XXX)
|
|
*/
|
|
typedef enum {
|
|
WL_ANTENNATYPE_RX = 1,
|
|
WL_ANTENNATYPE_TX = 2,
|
|
} MWL_HAL_ANTENNA;
|
|
int mwl_hal_setantenna(struct mwl_hal *mh, MWL_HAL_ANTENNA dirSet, int ant);
|
|
|
|
/*
|
|
* Set the threshold for using RTS on TX.
|
|
*/
|
|
int mwl_hal_setrtsthreshold(struct mwl_hal_vap *, int threshold);
|
|
|
|
/*
|
|
* Set the adapter to operate in infrastructure mode.
|
|
*/
|
|
int mwl_hal_setinframode(struct mwl_hal_vap *);
|
|
|
|
/*
|
|
* Set Radar Detection Configuration.
|
|
*/
|
|
typedef enum {
|
|
DR_DFS_DISABLE = 0,
|
|
DR_CHK_CHANNEL_AVAILABLE_START = 1,
|
|
DR_CHK_CHANNEL_AVAILABLE_STOP = 2,
|
|
DR_IN_SERVICE_MONITOR_START = 3
|
|
} MWL_HAL_RADAR;
|
|
int mwl_hal_setradardetection(struct mwl_hal *mh, MWL_HAL_RADAR action);
|
|
/*
|
|
* Set the region code that selects the radar bin'ing agorithm.
|
|
*/
|
|
int mwl_hal_setregioncode(struct mwl_hal *mh, int regionCode);
|
|
|
|
/*
|
|
* Initiate an 802.11h-based channel switch. The CSA ie
|
|
* is included in the next beacon(s) using the specified
|
|
* information and the firmware counts down until switch
|
|
* time after which it notifies the driver by delivering
|
|
* an interrupt with MACREG_A2HRIC_BIT_CHAN_SWITCH set in
|
|
* the cause register.
|
|
*/
|
|
int mwl_hal_setchannelswitchie(struct mwl_hal *,
|
|
const MWL_HAL_CHANNEL *nextchan, uint32_t mode, uint32_t count);
|
|
|
|
/*
|
|
* Set regdomain code (IEEE SKU).
|
|
*/
|
|
enum {
|
|
DOMAIN_CODE_FCC = 0x10, /* USA */
|
|
DOMAIN_CODE_IC = 0x20, /* Canda */
|
|
DOMAIN_CODE_ETSI = 0x30, /* Europe */
|
|
DOMAIN_CODE_SPAIN = 0x31, /* Spain */
|
|
DOMAIN_CODE_FRANCE = 0x32, /* France */
|
|
DOMAIN_CODE_ETSI_131 = 0x130,/* ETSI w/ 1.3.1 radar type */
|
|
DOMAIN_CODE_MKK = 0x40, /* Japan */
|
|
DOMAIN_CODE_MKK2 = 0x41, /* Japan w/ 10MHz chan spacing */
|
|
DOMAIN_CODE_DGT = 0x80, /* Taiwan */
|
|
DOMAIN_CODE_AUS = 0x81, /* Australia */
|
|
};
|
|
|
|
/*
|
|
* Transmit rate control. Rate codes with bit 0x80 set are
|
|
* interpreted as MCS codes (this limits us to 0-127). The
|
|
* transmit rate can be set to a single fixed rate or can
|
|
* be configured to start at an initial rate and drop based
|
|
* on retry counts.
|
|
*/
|
|
typedef enum {
|
|
RATE_AUTO = 0, /* rate selected by firmware */
|
|
RATE_FIXED = 2, /* rate fixed */
|
|
RATE_FIXED_DROP = 1, /* rate starts fixed but may drop */
|
|
} MWL_HAL_TXRATE_HANDLING;
|
|
|
|
typedef struct {
|
|
uint8_t McastRate; /* rate for multicast frames */
|
|
#define RATE_MCS 0x80 /* rate is an MCS index */
|
|
uint8_t MgtRate; /* rate for management frames */
|
|
struct {
|
|
uint8_t TryCount; /* try this many times */
|
|
uint8_t Rate; /* use this tx rate */
|
|
} RateSeries[4]; /* rate series */
|
|
} MWL_HAL_TXRATE;
|
|
|
|
int mwl_hal_settxrate(struct mwl_hal_vap *,
|
|
MWL_HAL_TXRATE_HANDLING handling, const MWL_HAL_TXRATE *rate);
|
|
/* NB: hack for setting rates while scanning */
|
|
int mwl_hal_settxrate_auto(struct mwl_hal *, const MWL_HAL_TXRATE *rate);
|
|
|
|
/*
|
|
* Set the Slot Time Configuration.
|
|
* NB: usecs must either be 9 or 20 for now.
|
|
*/
|
|
int mwl_hal_setslottime(struct mwl_hal *mh, int usecs);
|
|
|
|
/*
|
|
* Adjust current transmit power settings according to powerLevel.
|
|
* This translates to low/medium/high use of the current tx power rate tables.
|
|
*/
|
|
int mwl_hal_adjusttxpower(struct mwl_hal *, uint32_t powerLevel);
|
|
/*
|
|
* Set the transmit power for the specified channel; the power
|
|
* is taken from the calibration data and capped according to
|
|
* the specified max tx power (in dBm).
|
|
*/
|
|
int mwl_hal_settxpower(struct mwl_hal *, const MWL_HAL_CHANNEL *,
|
|
uint8_t maxtxpow);
|
|
|
|
/*
|
|
* Set the Multicast Address Filter.
|
|
* A packed array addresses is specified.
|
|
*/
|
|
#define MWL_HAL_MCAST_MAX 32
|
|
int mwl_hal_setmcast(struct mwl_hal *mh, int nmc, const uint8_t macs[]);
|
|
|
|
/*
|
|
* Crypto Configuration.
|
|
*/
|
|
typedef struct {
|
|
uint16_t pad;
|
|
uint16_t keyTypeId;
|
|
#define KEY_TYPE_ID_WEP 0
|
|
#define KEY_TYPE_ID_TKIP 1
|
|
#define KEY_TYPE_ID_AES 2 /* AES-CCMP */
|
|
uint32_t keyFlags;
|
|
#define KEY_FLAG_INUSE 0x00000001 /* indicate key is in use */
|
|
#define KEY_FLAG_RXGROUPKEY 0x00000002 /* Group key for RX only */
|
|
#define KEY_FLAG_TXGROUPKEY 0x00000004 /* Group key for TX */
|
|
#define KEY_FLAG_PAIRWISE 0x00000008 /* pairwise */
|
|
#define KEY_FLAG_RXONLY 0x00000010 /* only used for RX */
|
|
#define KEY_FLAG_AUTHENTICATOR 0x00000020 /* Key is for Authenticator */
|
|
#define KEY_FLAG_TSC_VALID 0x00000040 /* Sequence counters valid */
|
|
#define KEY_FLAG_WEP_TXKEY 0x01000000 /* Tx key for WEP */
|
|
#define KEY_FLAG_MICKEY_VALID 0x02000000 /* Tx/Rx MIC keys are valid */
|
|
uint32_t keyIndex; /* for WEP only; actual key index */
|
|
uint16_t keyLen; /* key size in bytes */
|
|
union { /* key material, keyLen gives size */
|
|
uint8_t wep[16]; /* enough for 128 bits */
|
|
uint8_t aes[16];
|
|
struct {
|
|
/* NB: group or pairwise key is determined by keyFlags */
|
|
uint8_t keyMaterial[16];
|
|
uint8_t txMic[8];
|
|
uint8_t rxMic[8];
|
|
struct {
|
|
uint16_t low;
|
|
uint32_t high;
|
|
} rsc;
|
|
struct {
|
|
uint16_t low;
|
|
uint32_t high;
|
|
} tsc;
|
|
} __packed tkip;
|
|
}__packed key;
|
|
} __packed MWL_HAL_KEYVAL;
|
|
|
|
/*
|
|
* Plumb a unicast/group key. The mac address identifies
|
|
* the station, use the broadcast address for group keys.
|
|
*/
|
|
int mwl_hal_keyset(struct mwl_hal_vap *, const MWL_HAL_KEYVAL *kv,
|
|
const uint8_t mac[6]);
|
|
|
|
/*
|
|
* Plumb a unicast/group key. The mac address identifies
|
|
* the station, use the broadcast address for group keys.
|
|
*/
|
|
int mwl_hal_keyreset(struct mwl_hal_vap *, const MWL_HAL_KEYVAL *kv,
|
|
const uint8_t mac[6]);
|
|
|
|
/*
|
|
* Set the MAC address.
|
|
*/
|
|
int mwl_hal_setmac(struct mwl_hal_vap *, const uint8_t addr[6]);
|
|
|
|
/*
|
|
* Set the beacon frame contents. The firmware will modify the
|
|
* frame only to add CSA and WME ie's and to fill in dynamic fields
|
|
* such as the sequence #..
|
|
*/
|
|
int mwl_hal_setbeacon(struct mwl_hal_vap *, const void *, size_t);
|
|
|
|
/*
|
|
* Handle power save operation for AP operation when offloaded to
|
|
* the host (SET_HW_SPEC_HOST_POWERSAVE). mwl_hal_setbss_powersave
|
|
* informs the firmware whether 1+ associated stations are in power
|
|
* save mode (it will then buffer mcast traffic). mwl_hal_setsta_powersave
|
|
* specifies a change in power save state for an associated station.
|
|
*/
|
|
int mwl_hal_setpowersave_bss(struct mwl_hal_vap *, uint8_t nsta);
|
|
int mwl_hal_setpowersave_sta(struct mwl_hal_vap *, uint16_t aid, int ena);
|
|
|
|
/*
|
|
* Set Association Configuration for station operation.
|
|
*/
|
|
int mwl_hal_setassocid(struct mwl_hal_vap *, const uint8_t bssId[6],
|
|
uint16_t assocId);
|
|
|
|
/*
|
|
* Set the current channel.
|
|
*/
|
|
int mwl_hal_setchannel(struct mwl_hal *mh, const MWL_HAL_CHANNEL *c);
|
|
|
|
/*
|
|
* A-MPDU Block Ack (BA) stream support. There are several
|
|
* streams that the driver must multiplex. Once assigned
|
|
* to a station the driver queues frames to a corresponding
|
|
* transmit queue and the firmware handles all the work.
|
|
*
|
|
* XXX no way to find out how many streams are supported
|
|
*/
|
|
typedef struct {
|
|
void *data[2]; /* opaque data */
|
|
int txq;
|
|
} MWL_HAL_BASTREAM;
|
|
|
|
const MWL_HAL_BASTREAM *mwl_hal_bastream_alloc(struct mwl_hal_vap *,
|
|
int ba_type, const uint8_t Macaddr[6], uint8_t Tid,
|
|
uint8_t ParamInfo, void *, void *);
|
|
const MWL_HAL_BASTREAM *mwl_hal_bastream_lookup(struct mwl_hal *mh, int s);
|
|
int mwl_hal_bastream_create(struct mwl_hal_vap *, const MWL_HAL_BASTREAM *,
|
|
int BarThrs, int WindowSize, uint16_t seqno);
|
|
int mwl_hal_bastream_destroy(struct mwl_hal *mh, const MWL_HAL_BASTREAM *);
|
|
int mwl_hal_getwatchdogbitmap(struct mwl_hal *mh, uint8_t bitmap[1]);
|
|
int mwl_hal_bastream_get_seqno(struct mwl_hal *mh, const MWL_HAL_BASTREAM *,
|
|
const uint8_t Macaddr[6], uint16_t *pseqno);
|
|
/* for sysctl hookup for debugging */
|
|
void mwl_hal_setbastreams(struct mwl_hal *mh, int mask);
|
|
int mwl_hal_getbastreams(struct mwl_hal *mh);
|
|
|
|
/*
|
|
* Set/get A-MPDU aggregation parameters.
|
|
*/
|
|
int mwl_hal_setaggampduratemode(struct mwl_hal *, int mode, int thresh);
|
|
int mwl_hal_getaggampduratemode(struct mwl_hal *, int *mode, int *thresh);
|
|
|
|
/*
|
|
* Inform the firmware of a new association station.
|
|
* The address is the MAC address of the peer station.
|
|
* The AID is supplied sans the 0xc000 bits. The station
|
|
* ID is defined by the caller. The peer information must
|
|
* be supplied.
|
|
*
|
|
* NB: All values are in host byte order; any byte swapping
|
|
* is handled by the hal.
|
|
*/
|
|
typedef struct {
|
|
uint32_t LegacyRateBitMap;
|
|
uint32_t HTRateBitMap;
|
|
uint16_t CapInfo;
|
|
uint16_t HTCapabilitiesInfo;
|
|
uint8_t MacHTParamInfo;
|
|
uint8_t Rev;
|
|
struct {
|
|
uint8_t ControlChan;
|
|
uint8_t AddChan;
|
|
uint8_t OpMode;
|
|
uint8_t stbc;
|
|
} __packed AddHtInfo;
|
|
} __packed MWL_HAL_PEERINFO;
|
|
int mwl_hal_newstation(struct mwl_hal_vap *, const uint8_t addr[6],
|
|
uint16_t aid, uint16_t sid, const MWL_HAL_PEERINFO *,
|
|
int isQosSta, int wmeInfo);
|
|
int mwl_hal_delstation(struct mwl_hal_vap *, const uint8_t addr[6]);
|
|
|
|
/*
|
|
* Prod the firmware to age packets on station power
|
|
* save queues and reap frames on the tx aggregation q's.
|
|
*/
|
|
int mwl_hal_setkeepalive(struct mwl_hal *mh);
|
|
|
|
typedef enum {
|
|
AP_MODE_B_ONLY = 1,
|
|
AP_MODE_G_ONLY = 2,
|
|
AP_MODE_MIXED = 3,
|
|
AP_MODE_N_ONLY = 4,
|
|
AP_MODE_BandN = 5,
|
|
AP_MODE_GandN = 6,
|
|
AP_MODE_BandGandN = 7,
|
|
AP_MODE_A_ONLY = 8,
|
|
AP_MODE_AandG = 10,
|
|
AP_MODE_AandN = 12,
|
|
} MWL_HAL_APMODE;
|
|
int mwl_hal_setapmode(struct mwl_hal_vap *, MWL_HAL_APMODE);
|
|
|
|
/*
|
|
* Enable/disable firmware operation. mwl_hal_start is
|
|
* also used to sync state updates, e.g. beacon frame
|
|
* reconstruction after content changes.
|
|
*/
|
|
int mwl_hal_stop(struct mwl_hal_vap *);
|
|
int mwl_hal_start(struct mwl_hal_vap *);
|
|
|
|
/*
|
|
* Add/Remove station from Power Save TIM handling.
|
|
*
|
|
* If set is non-zero the AID is enabled, if zero it is removed.
|
|
*/
|
|
int mwl_hal_updatetim(struct mwl_hal_vap *, uint16_t aid, int set);
|
|
|
|
/*
|
|
* Enable/disable 11g protection use. This call specifies
|
|
* the ERP information element flags to use.
|
|
*/
|
|
int mwl_hal_setgprot(struct mwl_hal *, int);
|
|
|
|
/*
|
|
* Enable/disable WMM support.
|
|
*/
|
|
int mwl_hal_setwmm(struct mwl_hal *mh, int onoff);
|
|
|
|
/*
|
|
* Configure WMM EDCA parameters for the specified h/w ring.
|
|
*/
|
|
int mwl_hal_setedcaparams(struct mwl_hal *mh, uint8_t qnum,
|
|
uint32_t CWmin, uint32_t CWmax, uint8_t AIFSN, uint16_t TXOPLimit);
|
|
|
|
/*
|
|
* Configure rate adaptation for indooor/outdoor operation.
|
|
* XXX wtf?
|
|
*/
|
|
int mwl_hal_setrateadaptmode(struct mwl_hal *mh, uint16_t mode);
|
|
|
|
typedef enum {
|
|
CSMODE_CONSERVATIVE = 0,
|
|
CSMODE_AGGRESSIVE = 1,
|
|
CSMODE_AUTO_ENA = 2,
|
|
CSMODE_AUTO_DIS = 3,
|
|
} MWL_HAL_CSMODE;
|
|
int mwl_hal_setcsmode(struct mwl_hal *mh, MWL_HAL_CSMODE csmode);
|
|
|
|
/*
|
|
* Configure 11n protection on/off.
|
|
*/
|
|
typedef enum {
|
|
HTPROTECT_NONE = 0, /* disable */
|
|
HTPROTECT_OPT = 1, /* optional */
|
|
HTPROTECT_HT20 = 2, /* protect only HT20 */
|
|
HTPROTECT_HT2040 = 3, /* protect HT20/40 */
|
|
HTPROTECT_AUTO = 4, /* automatic */
|
|
} MWL_HAL_HTPROTECT;
|
|
int mwl_hal_setnprot(struct mwl_hal_vap *, MWL_HAL_HTPROTECT mode);
|
|
/*
|
|
* Configure 11n protection mechanism for when protection is enabled.
|
|
*/
|
|
int mwl_hal_setnprotmode(struct mwl_hal_vap *, uint8_t mode);
|
|
|
|
/*
|
|
* Enable/disable Marvell "turbo mode"".
|
|
*/
|
|
int mwl_hal_setoptimizationlevel(struct mwl_hal *mh, int onoff);
|
|
|
|
/*
|
|
* Set MIMO Power Save handling for a station; the enable and mode
|
|
* values come directly from the Action frame.
|
|
*/
|
|
int mwl_hal_setmimops(struct mwl_hal *mh, const uint8_t addr[6],
|
|
uint8_t enable, uint8_t mode);
|
|
|
|
/*
|
|
* Retrieve the region/country code from the EEPROM.
|
|
*/
|
|
int mwl_hal_getregioncode(struct mwl_hal *mh, uint8_t *countryCode);
|
|
int mwl_hal_GetBeacon(struct mwl_hal *mh, uint8_t *pBcn, uint16_t *pLen);
|
|
int mwl_hal_SetRifs(struct mwl_hal *mh, uint8_t QNum);
|
|
|
|
/*
|
|
* Set/get promiscuous mode.
|
|
*/
|
|
int mwl_hal_setpromisc(struct mwl_hal *, int ena);
|
|
int mwl_hal_getpromisc(struct mwl_hal *);
|
|
|
|
/*
|
|
* Enable/disable CF-End use.
|
|
*/
|
|
int mwl_hal_setcfend(struct mwl_hal *, int ena);
|
|
|
|
/*
|
|
* Enable/disable sta-mode DWDS use/operation.
|
|
*/
|
|
int mwl_hal_setdwds(struct mwl_hal *, int ena);
|
|
|
|
/*
|
|
* Diagnostic interface. This is an open-ended interface that
|
|
* is opaque to applications. Diagnostic programs use this to
|
|
* retrieve internal data structures, etc. There is no guarantee
|
|
* that calling conventions for calls other than MWL_DIAG_REVS
|
|
* are stable between HAL releases; a diagnostic application must
|
|
* use the HAL revision information to deal with ABI/API differences.
|
|
*/
|
|
int mwl_hal_getdiagstate(struct mwl_hal *mh, int request,
|
|
const void *args, uint32_t argsize,
|
|
void **result, uint32_t *resultsize);
|
|
|
|
int mwl_hal_fwload(struct mwl_hal *mh, void *fwargs);
|
|
#endif /* _MWL_HAL_H_ */
|