madwifi驱动介绍

1 数据结构：

1.1、ath_softc； 主要记录和 wifi 卡设备相关信息，通过 dev 可以获取到该结构

1.2、ieee80211com； 主要提供与 WIFI 卡级相关的内容；

1.3、ieee80211vap； 主要提供与 VAP 级的内容；

1.4、ieee80211_node： 描述本端或者对端节点的内容；

1.5、ath_buf： 接收/发送缓存内容；

1.6、ath_vap： 虚拟 ap 结构；

1.7、ieee80211_key： 保存密钥的相关信息；

struct net_device_stats sc_devstats; //网络设备统计结构

struct ath_statssc_stats; //私有统计结构

int devid; //设备 ID

u_int32_t sc_debug; //调试开关，调试级别

u_int8_t sc_aucDebug[ATH_MODULE_NUM]; /*打印级别*/

void (*sc_recv_mgmt)(struct ieee80211_node *, struct sk_buff *, int, int, u_int32_t); //管理帧消息处理函数

void (*sc_node_cleanup)(struct ieee80211_node *); //节点上下文清除函数

void (*sc_node_free)(struct ieee80211_node *); //节点删除函数

void *sc_bdev; //PCI 设备

struct ath_hal *sc_ah; /* Atheros HAL */

sc_mrretry:1, /* multi-rate retry support */

sc_softled:1, /* enable LED gpio status */

sc_splitmic:1, /* split TKIP MIC keys */

sc_needmib:1, /* enable MIB stats intr */

sc_hasdiversity:1, /* rx diversity available */

sc_diversity:1, /* enable rx diversity */

sc_olddiversity:1, /* diversity setting before XR enable */

sc_hasveol:1, /* tx VEOL support */

sc_hastpc:1, /* per-packet TPC support */

sc_dturbo:1, /* dynamic turbo capable */

sc_beacons:1, /* beacons running */

sc_hasbmask:1, /* bssid mask support */

sc_mcastkey:1, /* mcast key cache search */

sc_hastsfadd:1, /* tsf adjust support */

sc_scanning:1, /* scanning active */

sc_nostabeacons:1, /* no beacons for station */

sc_xrgrppoll:1, /* xr group polls are active */

sc_syncbeacon:1, /* sync/resync beacon timers */

sc_hasclrkey:1, /* CLR key supported */

sc_devstopped:1, /* stopped due to of no tx bufs */

const HAL_RATE_TABLE *sc_rates[IEEE80211_MODE_MAX];

const HAL_RATE_TABLE *sc_currates; /* current rate table */

const HAL_RATE_TABLE *sc_xr_rates; /* XR rate table */

const HAL_RATE_TABLE *sc_half_rates; /* half rate table */

const HAL_RATE_TABLE *sc_quarter_rates; /* quarter rate table */

HAL_OPMODE sc_opmode; //当前 WIFI 卡工作模式 AP/STA/ADHOC。。。

enum ieee80211_phymode sc_curmode; //WIFI 卡工作的无线模式 ABG。。。

u_int16_t sc_curtxpow; /* current tx power limit */ //当前发送功率

u_int16_t sc_curaid; /* current association id */ //当前关联 ID

HAL_CHANNEL sc_curchan; /* current h/w channel */ //当前工作频点

u_int16_t ledoff; /* softled off time */

} sc_hwmap[32]; /* h/w rate ix mappings */

u_int8_t sc_minrateix; //最小速率/* min h/w rate index */

u_int8_t sc_protrix; /* protection rate index */ //RTS CTS 保护保文的速率

u_int8_t sc_mcastantenna; /* Multicast antenna number */ //广播天线号

u_int8_t sc_txantenna; /* data tx antenna (fixed or auto) */ //发送天线号

u_int8_t sc_dfstest_ieeechan; /* IEEE channel number to return to after a dfs mute test */

u_int32_t sc_dfstesttime; /* Time to stay off chan during dfs test */

//总 VAP、终端 VAP、侦听 VAP、发送 BeaconVAP 个数

u_int16_t sc_nvaps; /* # of active virtual ap's */

u_int8_t sc_keymap[ATH_KEYBYTES]; //KEY 使用位域/* key use bit map */

struct ieee80211_node *sc_keyixmap[ATH_KEYMAX]; //KEY 与终端转换表

u_int8_t sc_bssidmask[IEEE80211_ADDR_LEN]; //BSSID 掩码

u_int sc_ledpin; /* GPIO pin for driving LED */

u_int sc_ledon; /* pin setting for LED on */

u_int sc_ledidle; /* idle polling interval */

int sc_ledevent; /* time of last LED event */

u_int8_t sc_rxrate; /* current rx rate for LED */

u_int8_t sc_txrate; /* current tx rate for LED */

u_int16_t sc_ledoff; /* off time for current blink */

int sc_rxbufsize; /* rx size based on mtu */ //接收缓存的大小

struct ath_descdma sc_rxdma; /* RX descriptors */ //接收 DMA 分配上下文

ath_bufhead sc_rxbuf; /* receive buffer */ //接收 BUF 队列

struct ath_buf *sc_rxbufcur; /* current rx buffer */ //临时用途，记录当前使用的 BUF 队列

u_int32_t *sc_rxlink; /* link ptr in last RX desc */ //记录接收缓存的最后描述符，用于链接

spinlock_t sc_rxbuflock; //接收缓存操作锁

struct ATH_TQ_STRUCT sc_rxtq; /* rx intr tasklet */ //接收任务

struct ATH_TQ_STRUCT sc_rxorntq; /* rxorn intr tasklet */

u_int8_t sc_defant; /* current default antenna */ //默认天线

u_int8_t sc_rxotherant; /* rx's on non-default antenna*/

struct ATH_TQ_STRUCT sc_txtq; /* tx intr tasklet */ //发送任务

u_int8_t sc_grppoll_str[GRPPOLL_RATE_STR_LEN];

struct ath_descdma sc_bdma; /* beacon descriptors */ //BEACON 帧 DMA 描述符

ath_bufhead sc_bbuf; /* beacon buffers */ //BEACON 缓存

u_int sc_bhalq; /* HAL q for outgoing beacons */ //BEACON 的 Q num

u_int sc_bmisscount; /* missed beacon transmits */ //BEACON 丢失个数

u_int32_t sc_ant_tx[8]; /* recent tx frames/antenna */ //天线发送报文统计

struct ath_txq *sc_cabq; /* tx q for cab frames */ //BEACON 之后的广播报文发送 Q

struct ath_txq sc_grpplq; /* tx q for XR group polls */ //XR 下的组 POLL 报文发送 Q

struct ath_txq *sc_xrtxq; /* tx q for XR data */ //XR 下的数据报文发送 Q

struct ATH_TQ_STRUCT sc_bmisstq; /* bmiss intr tasklet */ //BEACON 丢失任务

struct ATH_TQ_STRUCT sc_bstucktq; /* beacon stuck intr tasklet */ //BEACON 发送任务

enum {

OK, /* no change needed */

UPDATE, /* update pending */

COMMIT /* beacon sent, commit change */

} sc_updateslot; /* slot time update fsm */

int sc_slotupdate; /* slot to next advance fsm */

struct ieee80211vap *sc_bslot[ATH_BCBUF]; /* beacon xmit slots */ //BEACON 发送槽位

int sc_bnext; /* next slot for beacon xmit */

struct net_device *ic_dev; /* associated device */ //WIFI 设备回指针

u_int8_t ic_promisc; /* vap's needing promisc mode */ //混杂模式

u_int8_t ic_allmulti; /* vap's needing all multicast*/

u_int16_t ic_bmisstimeout; /* beacon miss threshold (ms) */ //BEACON 丢失个数

u_int16_t ic_txpowlimit; /* global tx power limit (in 0.5 dBm) */ //发送功率最大值