ath9K 驱动注册过程

http://blog.csdn.net/ussam/article/details/24393267

这里使用的是ath9k网卡驱动，硬件平台是TP-link TL-WR841N V7.1 路由器
1 ath_pci_init() 
驱动的主入口为ath_pci_init()（位于linux-3.3.8 /drivers/net/wireless/ath/ath9k文件夹下的pci.c文件中）： 

int ath_pci_init(void)
{
return pci_register_driver(&ath_pci_driver);
}

可以看到ath_pci_driver作为参数传递给了pci_register_driver ()。ath_pci_driver的定义如下（位于linux-3.3.8
/drivers/net/wireless/ath/ath9k文件夹下的pci.c文件中）： 

static struct pci_driver ath_pci_driver = {
.name       = "ath9k",
.id_table   = ath_pci_id_table,
.probe      = ath_pci_probe,
.remove     = ath_pci_remove,
.driver.pm  = ATH9K_PM_OPS,
};

2 ath_pci_probe() 
紧接着，系统会通过probe指针来调用ath_pci_probe函数（ath_pci_probe函数定义于linux-3.3.8 /drivers/net/wireless/ath/ath9k文件夹下的pci.c文件中）。  

static int ath_pci_probe(struct pci_dev *pdev, const struct pci_device_id *id)
{
…
hw = ieee80211_alloc_hw(sizeof(struct ath_softc), &ath9k_ops);
if (!hw) {
dev_err(&pdev->dev, "No memory for ieee80211_hw\n");
ret = -ENOMEM;
goto err_alloc_hw;
}
SET_IEEE80211_DEV(hw, &pdev->dev);
pci_set_drvdata(pdev, hw);

sc = hw->priv;
sc->hw = hw;
sc->dev = &pdev->dev;
sc->mem = mem;
/* Will be cleared in ath9k_start() */
sc->sc_flags |= SC_OP_INVALID;
ret = request_irq(pdev->irq, ath_isr, IRQF_SHARED, "ath9k", sc);
if (ret) {
dev_err(&pdev->dev, "request_irq failed\n");
goto err_irq;
}
sc->irq = pdev->irq;
ret = ath9k_init_device(id->device, sc, &ath_pci_bus_ops);
if (ret) {
dev_err(&pdev->dev, "Failed to initialize device\n");
goto err_init;
}
…
}

3 ieee80211_alloc_hw() 
注意ath_pci_probe()函数体中的这行代码: 
hw = ieee80211_alloc_hw(sizeof(struct ath_softc), &ath9k_ops); 
函数ieee80211_alloc_hw()定义于OpenWRT内核文件夹子目录/net/mac80211，文件main.c中，这里传入的参数是结构体ath9k_ops,
该结构体的定义如下（位于linux-3.3.8 /drivers/net/wireless/ath/ath9k文件夹下的main.c文件中）: 

struct ieee80211_ops ath9k_ops = {
.tx 		    = ath9k_tx,
.start 		    = ath9k_start,
.stop 		    = ath9k_stop,
.add_interface 	    = ath9k_add_interface,
.change_interface   = ath9k_change_interface,
.remove_interface   = ath9k_remove_interface,
.config 	    = ath9k_config,
.configure_filter   = ath9k_configure_filter,
.sta_add	    = ath9k_sta_add,
.sta_remove	    = ath9k_sta_remove,
.sta_notify         = ath9k_sta_notify,
.conf_tx 	    = ath9k_conf_tx,
.bss_info_changed   = ath9k_bss_info_changed,
.set_key            = ath9k_set_key,
.get_tsf 	    = ath9k_get_tsf,
.set_tsf 	    = ath9k_set_tsf,
.reset_tsf 	    = ath9k_reset_tsf,
.ampdu_action       = ath9k_ampdu_action,
.get_survey	    = ath9k_get_survey,
.rfkill_poll        = ath9k_rfkill_poll_state,
.set_coverage_class = ath9k_set_coverage_class,
.flush		    = ath9k_flush,
.tx_frames_pending  = ath9k_tx_frames_pending,
.tx_last_beacon     = ath9k_tx_last_beacon,
.get_stats	    = ath9k_get_stats,
.set_antenna	    = ath9k_set_antenna,
.get_antenna	    = ath9k_get_antenna,
};

将参数ath9k_ops传输ieee80211_alloc_hw()函数以后，系统将可以使用参数ath9k_ops中定义的函数指针。以tx为例，在tx.c中将会用到该函数指针。 
下面再来看看ieee80211_alloc_hw()函数： 

struct ieee80211_hw *ieee80211_alloc_hw(size_t priv_data_len,	const struct ieee80211_ops *ops)
{
struct ieee80211_local *local;
int priv_size, i;
struct wiphy *wiphy;
bool use_chanctx;
…
/* Ensure 32-byte alignment of our private data and hw private data.
* We use the wiphy priv data for both our ieee80211_local and for
* the driver's private data
*
* In memory it'll be like this:
*
* +-------------------------+
* | struct wiphy	    |
* +-------------------------+
* | struct ieee80211_local  |
* +-------------------------+
* | driver's private data   |
* +-------------------------+
*
*/
priv_size = ALIGN(sizeof(*local), NETDEV_ALIGN) + priv_data_len;
// 注意这里的mac80211_config_ops
// 以其中的scan成员为例，scan时就会触发对应的函数ieee80211_scan()
wiphy = wiphy_new(&mac80211_config_ops, priv_size); // 注意这里的mac80211_config_ops
if (!wiphy)
return NULL;
…
// 这里的local->ops就变成传进来的参数ath9k_ops
local->ops = ops;
…
// 这个工作队列很重要, sw scan的情况下会schedule这个工作队列来做scan
INIT_DELAYED_WORK(&local->scan_work, ieee80211_scan_work);
…
// 这个tasklet跟接受数据紧密相关，后面会提到
tasklet_init(&local->tasklet,
ieee80211_tasklet_handler,
(unsigned long) local);
…
return &local->hw;
}
EXPORT_SYMBOL(ieee80211_alloc_hw);

4 ath9k_init_device() 
在ath_pci_probe()的函数体中，完成了ieee80211_alloc_hw()之后的另一行重要代码就是： 
ret = ath9k_init_device(id->device, sc, &ath_pci_bus_ops); 
接着分析ath9k_init_device ()（位于OpenWRT内核文件夹子目录/net/mac80211，文件init.c中），观察设备的初始化过程。 

int ath9k_init_device(u16 devid, struct ath_softc *sc, const struct ath_bus_ops *bus_ops)
{
struct ieee80211_hw *hw = sc->hw;
struct ath_common *common;
struct ath_hw *ah;
int error = 0;
struct ath_regulatory *reg;
/* Bring up device */
error = ath9k_init_softc(devid, sc, bus_ops);
if (error != 0)
goto error_init;
ah = sc->sc_ah;
common = ath9k_hw_common(ah);
ath9k_set_hw_capab(sc, hw);
/* Initialize regulatory */
error = ath_regd_init(&common->regulatory, sc->hw->wiphy,
ath9k_reg_notifier);
if (error)
goto error_regd;
reg = &common->regulatory;
/* Setup TX DMA */
error = ath_tx_init(sc, ATH_TXBUF);
if (error != 0)
goto error_tx;
/* Setup RX DMA */
error = ath_rx_init(sc, ATH_RXBUF);
if (error != 0)
goto error_rx;
ath9k_init_txpower_limits(sc);
…
error = ieee80211_register_hw(hw);
if (error)
goto error_register;
error = ath9k_init_debug(ah);
if (error) {
ath_err(common, "Unable to create debugfs files\n");
goto error_world;
}
…
}

4.1 首先初始化softc 

static int ath9k_init_softc(u16 devid, struct ath_softc *sc,
const struct ath_bus_ops *bus_ops)
{
…
tasklet_init(&sc->intr_tq, ath9k_tasklet, (unsigned long)sc);
tasklet_init(&sc->bcon_tasklet, ath_beacon_tasklet,
(unsigned long)sc);
…
}

在这个过程中会初始化tasklet（包括beacon帧的tasklet） 
4.2 初始化数据收发存储器访问 

/* Setup TX DMA */
error = ath_tx_init(sc, ATH_TXBUF);
if (error != 0)
goto error_tx;
/* Setup RX DMA */
error = ath_rx_init(sc, ATH_RXBUF);
if (error != 0)
goto error_rx;

4.3 注册设备 

error = ieee80211_register_hw(hw);

至此，设备启动，驱动程序成功加载到设备上。