235 lines
8.0 KiB
C
235 lines
8.0 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*
|
|
* Copyright (c) 2007 Marvell Semiconductor, Inc.
|
|
* Copyright (c) 2007 Sam Leffler, Errno Consulting
|
|
* Copyright (c) 2008 Weongyo Jeong <weongyo@freebsd.org>
|
|
* 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 _DEV_MALOHAL_H
|
|
#define _DEV_MALOHAL_H
|
|
|
|
#define MALO_NUM_TX_QUEUES 1
|
|
#define MALO_MAX_TXWCB_QUEUES MALO_NUM_TX_QUEUES
|
|
|
|
/* size of f/w command buffer */
|
|
#define MALO_CMDBUF_SIZE 0x4000
|
|
|
|
#define MALO_FW_CHECK_USECS (5 * 1000) /* 5ms */
|
|
#define MALO_FW_MAX_NUM_CHECKS 200
|
|
|
|
/*
|
|
* Calibration data builtin to the firmware. The firmware image
|
|
* has a single set of calibration tables that we retrieve right
|
|
* after download. This can be overridden by the driver (e.g. for
|
|
* a different regdomain and/or tx power setup).
|
|
*/
|
|
struct malo_hal_caldata {
|
|
/* pt is short for `power target'. */
|
|
#define MALO_PWTAGETRATETABLE20M (14 * 4)
|
|
uint8_t pt_ratetable_20m[MALO_PWTAGETRATETABLE20M];
|
|
};
|
|
|
|
/*
|
|
* Get Hardware/Firmware capabilities.
|
|
*/
|
|
struct malo_hal_hwspec {
|
|
uint8_t hwversion; /* version of the HW */
|
|
uint8_t hostinterface; /* host interface */
|
|
uint16_t maxnum_wcb; /* max # of WCB FW handles */
|
|
/* max # of mcast addresses FW handles*/
|
|
uint16_t maxnum_mcaddr;
|
|
uint16_t maxnum_tx_wcb; /* max # of tx descs per WCB */
|
|
/* MAC address programmed in HW */
|
|
uint8_t macaddr[6];
|
|
uint16_t regioncode; /* EEPROM region code */
|
|
uint16_t num_antenna; /* Number of antenna used */
|
|
uint32_t fw_releasenum; /* firmware release number */
|
|
uint32_t wcbbase0;
|
|
uint32_t rxdesc_read;
|
|
uint32_t rxdesc_write;
|
|
uint32_t ul_fw_awakecookie;
|
|
uint32_t wcbbase[4];
|
|
};
|
|
|
|
/*
|
|
* Supply tx/rx dma-related settings to the firmware.
|
|
*/
|
|
struct malo_hal_txrxdma {
|
|
uint32_t maxnum_wcb; /* max # of WCB FW handles */
|
|
uint32_t maxnum_txwcb; /* max # of tx descs per WCB */
|
|
uint32_t rxdesc_read;
|
|
uint32_t rxdesc_write;
|
|
uint32_t wcbbase[4];
|
|
};
|
|
|
|
/*
|
|
* 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).
|
|
*
|
|
* XXX low/up cases.
|
|
*/
|
|
struct malo_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 */
|
|
};
|
|
|
|
/*
|
|
* 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)
|
|
*/
|
|
enum malo_hal_antenna {
|
|
MHA_ANTENNATYPE_RX = 1,
|
|
MHA_ANTENNATYPE_TX = 2,
|
|
};
|
|
|
|
/*
|
|
* Set Radio Configuration.
|
|
*
|
|
* onoff != 0 turns radio on; otherwise off.
|
|
* if radio is enabled, the preamble is set too.
|
|
*/
|
|
enum malo_hal_preamble {
|
|
MHP_LONG_PREAMBLE = 1,
|
|
MHP_SHORT_PREAMBLE = 3,
|
|
MHP_AUTO_PREAMBLE = 5,
|
|
};
|
|
|
|
struct malo_hal_channel_flags {
|
|
uint32_t freqband : 6,
|
|
#define MALO_FREQ_BAND_2DOT4GHZ 0x1
|
|
: 26; /* reserved */
|
|
};
|
|
|
|
struct malo_hal_channel {
|
|
uint32_t channel;
|
|
struct malo_hal_channel_flags flags;
|
|
};
|
|
|
|
struct malo_hal_txrate {
|
|
uint8_t mcastrate; /* rate for multicast frames */
|
|
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 */
|
|
};
|
|
|
|
struct malo_hal {
|
|
device_t mh_dev;
|
|
|
|
bus_space_handle_t mh_ioh; /* BAR 1 copied from softc */
|
|
bus_space_tag_t mh_iot;
|
|
uint32_t mh_imask; /* interrupt mask */
|
|
int mh_flags;
|
|
#define MHF_CALDATA 0x0001 /* cal data retrieved */
|
|
#define MHF_FWHANG 0x0002 /* fw appears hung */
|
|
|
|
char mh_mtxname[12];
|
|
struct mtx mh_mtx;
|
|
bus_dma_tag_t mh_dmat; /* bus DMA tag for cmd buffer */
|
|
bus_dmamap_t mh_dmamap; /* DMA map for cmd buffer */
|
|
uint16_t *mh_cmdbuf; /* f/w cmd buffer */
|
|
bus_addr_t mh_cmdaddr; /* physaddr of cmd buffer */
|
|
|
|
struct malo_hal_caldata mh_caldata;
|
|
|
|
int mh_debug;
|
|
#define MALO_HAL_DEBUG_SENDCMD 0x00000001
|
|
#define MALO_HAL_DEBUG_CMDDONE 0x00000002
|
|
#define MALO_HAL_DEBUG_IGNHANG 0X00000004
|
|
};
|
|
|
|
#define MALO_HAL_LOCK(mh) mtx_lock(&mh->mh_mtx)
|
|
#define MALO_HAL_LOCK_ASSERT(mh) mtx_assert(&mh->mh_mtx, MA_OWNED)
|
|
#define MALO_HAL_UNLOCK(mh) mtx_unlock(&mh->mh_mtx)
|
|
|
|
struct malo_hal *malo_hal_attach(device_t, uint16_t,
|
|
bus_space_handle_t, bus_space_tag_t,
|
|
bus_dma_tag_t);
|
|
int malo_hal_fwload(struct malo_hal *, char *, char *);
|
|
int malo_hal_gethwspecs(struct malo_hal *,
|
|
struct malo_hal_hwspec *);
|
|
void malo_hal_detach(struct malo_hal *);
|
|
void malo_hal_intrset(struct malo_hal *, uint32_t);
|
|
int malo_hal_setantenna(struct malo_hal *,
|
|
enum malo_hal_antenna, int);
|
|
int malo_hal_setradio(struct malo_hal *, int,
|
|
enum malo_hal_preamble);
|
|
int malo_hal_setchannel(struct malo_hal *,
|
|
const struct malo_hal_channel *);
|
|
int malo_hal_setmaxtxpwr(struct malo_hal *, uint16_t);
|
|
int malo_hal_settxpower(struct malo_hal *, const struct malo_hal_channel *);
|
|
int malo_hal_setpromisc(struct malo_hal *, int);
|
|
int malo_hal_setassocid(struct malo_hal *,
|
|
const uint8_t[IEEE80211_ADDR_LEN], uint16_t);
|
|
void malo_hal_txstart(struct malo_hal *, int);
|
|
void malo_hal_getisr(struct malo_hal *, uint32_t *);
|
|
void malo_hal_cmddone(struct malo_hal *);
|
|
int malo_hal_prescan(struct malo_hal *);
|
|
int malo_hal_postscan(struct malo_hal *, uint8_t *, uint8_t);
|
|
int malo_hal_set_slot(struct malo_hal *, int);
|
|
int malo_hal_set_rate(struct malo_hal *, uint16_t, uint8_t);
|
|
int malo_hal_setmcast(struct malo_hal *, int, const uint8_t[]);
|
|
|
|
#endif
|