MadWifi理解笔记091121(struct)

ath_softc

 

in file "if_athvar.h"

 

Collaboration diagram for ath_softc:

 

 

 

ath_node

 

in file "if_athvar.h"

 

/* driver-specific node state */ struct ath_node { struct ieee80211_node an_node; /* base class */ u_int16_t an_decomp_index; /* decompression mask index */ u_int32_t an_avgrssi; /* average rssi over all rx frames */ u_int8_t an_prevdatarix; /* rate ix of last data frame */ u_int16_t an_minffrate; /* min rate in kbps for ff to aggregate */ struct ath_buf *an_tx_ffbuf[WME_NUM_AC]; /* ff staging area */ ath_bufhead an_uapsd_q; /* U-APSD delivery queue */ int an_uapsd_qdepth; /* U-APSD delivery queue depth */ ath_bufhead an_uapsd_overflowq; /* U-APSD overflow queue (for > MaxSp frames) */ int an_uapsd_overflowqdepth; /* U-APSD overflow queue depth */ spinlock_t an_uapsd_lock; /* U-APSD delivery queue lock */ /* variable-length rate control state follows */ };

 

其中,ieee80211_node定义在ieee80211_node.h中。

RSSI是接收信号强度值。RSSI is Received Signal Strength Index and means Signal Noise Ratio (SNR). So RSSI = Received Radio signal/ Noise. Foe ex, at 11a mode, If signal strength is -35dbm and Noise floor is -85dbm, then RSSI is 50dbm.Usually it present as % in most case.

 

 

ieee80211_node

in file net80211/ieee80211_node.h

 

/* * Node specific information. Note that drivers are expected * to derive from this structure to add device-specific per-node * state. This is done by overriding the ic_node_* methods in * the ieee80211com structure. */ struct ieee80211_node { struct ieee80211vap *ni_vap; struct ieee80211com *ni_ic; struct ieee80211_node_table *ni_table; TAILQ_ENTRY(ieee80211_node) ni_list; LIST_ENTRY(ieee80211_node) ni_hash; atomic_t ni_refcnt; u_int ni_scangen; /* gen# for timeout scan */ u_int8_t ni_authmode; /* authentication algorithm */ u_int16_t ni_flags; /* special-purpose state */ #define IEEE80211_NODE_AUTH 0x0001 /* authorized for data */ #define IEEE80211_NODE_QOS 0x0002 /* QoS enabled */ #define IEEE80211_NODE_ERP 0x0004 /* ERP enabled */ /* NB: this must have the same value as IEEE80211_FC1_PWR_MGT */ #define IEEE80211_NODE_PWR_MGT 0x0010 /* power save mode enabled */ #define IEEE80211_NODE_AREF 0x0020 /* authentication ref held */ #define IEEE80211_NODE_UAPSD 0x0040 /* U-APSD power save enabled */ #define IEEE80211_NODE_UAPSD_TRIG 0x0080 /* U-APSD triggerable state */ #define IEEE80211_NODE_UAPSD_SP 0x0100 /* U-APSD SP in progress */ #define IEEE80211_NODE_PS_CHANGED 0x0200 /* PS state change */ u_int8_t ni_ath_flags; /* Atheros feature flags */ /* NB: These must have the same values as IEEE80211_ATHC_* */ #define IEEE80211_NODE_TURBOP 0x0001 /* Turbo prime enable */ #define IEEE80211_NODE_COMP 0x0002 /* Compresssion enable */ #define IEEE80211_NODE_FF 0x0004 /* Fast Frame capable */ #define IEEE80211_NODE_XR 0x0008 /* Atheros WME enable */ #define IEEE80211_NODE_AR 0x0010 /* AR capable */ #define IEEE80211_NODE_BOOST 0x0080 u_int16_t ni_ath_defkeyindex; /* Atheros def key index */ #define IEEE80211_INVAL_DEFKEY 0x7FFF u_int16_t ni_associd; /* assoc response */ u_int16_t ni_txpower; /* current transmit power (in 0.5 dBm) */ u_int16_t ni_vlan; /* vlan tag */ u_int32_t *ni_challenge; /* shared-key challenge */ u_int8_t *ni_wpa_ie; /* captured WPA ie */ u_int8_t *ni_rsn_ie; /* captured RSN ie */ u_int8_t *ni_wme_ie; /* captured WME ie */ u_int8_t *ni_ath_ie; /* captured Atheros ie */ u_int8_t *ni_suppchans; /* supported channels */ u_int8_t *ni_suppchans_new; /* supported channels of ongoing association */ u_int8_t *ni_needed_chans; /* nodes which don't support these will be removed */ u_int8_t ni_n_needed_chans; /* size of ni_needed_chans list */ u_int16_t ni_txseqs[17]; /* tx seq per-tid */ u_int16_t ni_rxseqs[17]; /* rx seq previous per-tid */ unsigned long ni_rxfragstamp; /* time stamp of last rx frag */ struct sk_buff *ni_rxfrag; /* rx frag reassembly */ struct ieee80211_rsnparms ni_rsn; /* RSN/WPA parameters */ struct ieee80211_key ni_ucastkey; /* unicast key */ int ni_rxkeyoff; /* Receive key offset */ /* hardware */ u_int64_t ni_rtsf; /* recv timestamp */ unsigned long ni_last_rx; /* recv jiffies */ u_int8_t ni_rssi; /* recv ssi */ /* header */ u_int8_t ni_macaddr[IEEE80211_ADDR_LEN]; u_int8_t ni_bssid[IEEE80211_ADDR_LEN]; /* beacon, probe response */ union { u_int8_t data[8]; __le64 tsf; } ni_tstamp; /* from last rcv'd beacon */ u_int16_t ni_intval; /* beacon interval */ u_int16_t ni_intval_old; /* beacon interval before first change */ u_int16_t ni_intval_cnt; /* count of ni_intval != ni_intval_old */ unsigned long ni_intval_end; /* end of transition interval jiffies */ u_int16_t ni_capinfo; /* capabilities */ u_int8_t ni_esslen; u_int8_t ni_essid[IEEE80211_NWID_LEN]; struct ieee80211_rateset ni_rates; /* negotiated rate set */ struct ieee80211_channel *ni_chan; u_int16_t ni_fhdwell; /* FH only */ u_int8_t ni_fhindex; /* FH only */ u_int8_t ni_erp; /* ERP from beacon/probe resp */ u_int16_t ni_timoff; /* byte offset to TIM ie */ /* others */ struct sk_buff_head ni_savedq; /* packets queued for pspoll */ short ni_inact; /* inactivity mark count */ short ni_inact_reload; /* inactivity reload value */ int ni_txrate; /* index to ni_rates[] */ struct ieee80211_nodestats ni_stats; /* per-node statistics */ struct ieee80211vap *ni_prev_vap; /* previously associated vap */ u_int8_t ni_uapsd; /* U-APSD per-node flags matching WMM STA Qos Info field */ u_int8_t ni_uapsd_maxsp; /* maxsp from flags above */ u_int16_t ni_uapsd_trigseq[WME_NUM_AC]; /* trigger suppression on retry */ __le16 ni_pschangeseq; };

 

 

ieee80211vap

in file net80211/ieee80211_car.h

struct ieee80211vap { struct net_device *iv_dev; /* associated device */ struct net_device_stats iv_devstats; /* interface statistics */ struct ifmedia iv_media; /* interface media config */ struct iw_statistics iv_iwstats; /* wireless statistics block */ struct ctl_table_header *iv_sysctl_header; ...... }

 

 

 

ath_buf

in file ath/if_athvar.h

struct ath_buf { /* FFXXX: convert both list types to TAILQ to save a field? */ STAILQ_ENTRY(ath_buf) bf_list; #ifdef ATH_SUPERG_FF TAILQ_ENTRY(ath_buf) bf_stagelist; /* fast-frame staging list */ #endif struct ath_desc *bf_desc; /* virtual addr of desc */ struct ath_desc_status bf_dsstatus; /* tx/rx descriptor status */ dma_addr_t bf_daddr; /* physical addr of desc */ struct sk_buff *bf_skb; /* skbuff for buf */ dma_addr_t bf_skbaddr; /* physical addr of skb data - always used by one desc */ u_int32_t bf_status; /* status flags */ u_int16_t bf_flags; /* tx descriptor flags */ u_int64_t bf_tsf; int16_t bf_channoise; #ifdef ATH_SUPERG_FF /* XXX: combine this with bf_skbaddr if it ever changes to accommodate * multiple segments. */ u_int16_t bf_numdescff; /* number of descs used for FF (these are extra) */ u_int32_t bf_queueage; /* "age" of txq when this buffer placed on stageq */ dma_addr_t bf_skbaddrff[ATH_TXDESC - 1]; /* extra addrs for FF */ #endif int bf_taken_at_line; /* XXX: Want full alloc backtrace */ const char *bf_taken_at_func; };

 

 

ath_desc

in file hal/ath_desc.h

struct ath_desc { /* * The following definitions are passed directly * the hardware and managed by the HAL. Drivers * should not touch those elements marked opaque. */ u_int32_t ds_link; /* phys address of next descriptor */ u_int32_t ds_data; /* phys address of data buffer */ u_int32_t ds_ctl0; /* opaque DMA control 0 */ u_int32_t ds_ctl1; /* opaque DMA control 1 */ u_int32_t ds_hw[HAL_DESC_HW_SIZE]; /* opaque h/w region */ };

 

ath_desc_status

in file hal/ah_desc.h

struct ath_desc_status { union { struct ath_tx_status tx;/* xmit status */ struct ath_rx_status rx;/* recv status */ } ds_us; }; #define ds_txstat ds_us.tx #define ds_rxstat ds_us.rx

 

 

 

 

ath_tx_status

in file hal/ah_desc.h

/* * Transmit descriptor status. This structure is filled * in only after the tx descriptor process method finds a * ``done'' descriptor; at which point it returns something * other than HAL_EINPROGRESS. * * Note that ts_antenna may not be valid for all h/w. It * should be used only if non-zero. */ struct ath_tx_status { u_int16_t ts_seqnum; /* h/w assigned sequence number */ u_int16_t ts_tstamp; /* h/w assigned timestamp */ u_int8_t ts_status; /* frame status, 0 => xmit ok */ u_int8_t ts_rate; /* h/w transmit rate index */ #define HAL_TXSTAT_ALTRATE 0x80 /* alternate xmit rate used */ int8_t ts_rssi; /* tx ack RSSI */ u_int8_t ts_shortretry; /* # short retries */ u_int8_t ts_longretry; /* # long retries */ u_int8_t ts_virtcol; /* virtual collision count */ u_int8_t ts_antenna; /* antenna information */ u_int8_t ts_finaltsi; /* final transmit series index */ #ifdef AH_SUPPORT_AR5416 /* 802.11n status */ u_int8_t ts_flags; /* misc flags */ int8_t ts_rssi_ctl[3]; /* tx ack RSSI [ctl, chain 0-2] */ int8_t ts_rssi_ext[3]; /* tx ack RSSI [ext, chain 0-2] */ /* #define ts_rssi ts_rssi_combined */ u_int32_t ts_ba_low; /* blockack bitmap low */ u_int32_t ts_ba_high; /* blockack bitmap high */ u_int32_t ts_evm0; /* evm bytes */ u_int32_t ts_evm1; u_int32_t ts_evm2; #endif /* AH_SUPPORT_AR5416 */ };

 

 

ath_rx_status

in file hal/ath_desc.h

/* * Receive descriptor status. This structure is filled * in only after the rx descriptor process method finds a * ``done'' descriptor; at which point it returns something * other than HAL_EINPROGRESS. * * If rx_status is zero, then the frame was received ok; * otherwise the error information is indicated and rs_phyerr * contains a phy error code if HAL_RXERR_PHY is set. In general * the frame contents is undefined when an error occurred thought * for some errors (e.g. a decryption error), it may be meaningful. * * Note that the receive timestamp is expanded using the TSF to * at least 15 bits (regardless of what the h/w provides directly). * Newer hardware supports a full 32-bits; use HAL_CAP_32TSTAMP to * find out if the hardware is capable. * * rx_rssi is in units of dbm above the noise floor. This value * is measured during the preamble and PLCP; i.e. with the initial * 4us of detection. The noise floor is typically a consistent * -96dBm absolute power in a 20MHz channel. */ struct ath_rx_status { u_int16_t rs_datalen; /* rx frame length */ u_int8_t rs_status; /* rx status, 0 => recv ok */ u_int8_t rs_phyerr; /* phy error code */ int8_t rs_rssi; /* rx frame RSSI (combined for 11n) */ u_int8_t rs_keyix; /* key cache index */ u_int8_t rs_rate; /* h/w receive rate index */ u_int8_t rs_more; /* more descriptors follow */ u_int32_t rs_tstamp; /* h/w assigned timestamp */ u_int32_t rs_antenna; /* antenna information */ #ifdef AH_SUPPORT_AR5416 /* 802.11n status */ int8_t rs_rssi_ctl[3]; /* rx frame RSSI [ctl, chain 0-2] */ int8_t rs_rssi_ext[3]; /* rx frame RSSI [ext, chain 0-2] */ u_int8_t rs_isaggr; /* is part of the aggregate */ u_int8_t rs_moreaggr; /* more frames in aggr to follow */ u_int8_t rs_num_delims; /* number of delims in aggr */ u_int8_t rs_flags; /* misc flags */ u_int32_t rs_evm0; /* evm bytes */ u_int32_t rs_evm1; u_int32_t rs_evm2; #endif /* AH_SUPPORT_AR5416 */ };