1.5 WLAN驅動模組化的一些其他修改

從QCA_Networking_2016.SPF.4.0版本開始，OL和DA驅動相互獨立，並新建了一個UMAC模組，作為通用層，並獨立於OL和DA的模組。
因為DA驅動已經獨立於“UMAC+OL”驅動結構，所以將UMAC和OL模組劃分成兩個不同的模組是必須的。

• 將所有的OL檔案都放到一個新模組（qca_ol）中。這個模組將獨立於UMAC模組。
• 建立一個獨立的UMAC模組，獨立於OL和DA模組。

區分Offload相關的檔案
當前的UMAC模組包含通用層，以及Offload的函式和檔案。

當前的Offload檔案
所有的Offload檔案在WLAN驅動的原始碼中，都放在了“offload”目錄中，這些檔案在一起組成一個新的“qca_ol”模組。

Kernel PCI/AHB介面檔案
在獨立的DA設備註冊過程中使用的PCI和AHB初始化檔案，都作為UMAC模組的一部分，被移到了新的qca_ol模組中。

獨立的UMAC模組
設定一個獨立的UMAC模組的目的，是可以將Offload和Direct-Attach之間的共通部分做到一個模組中，這樣Offload和Direct-Attach模組就可以獨立的使用這部分共通程式碼。同時，這樣做也能減少驅動的image大小。
由於所有的offload檔案移到了qca_ol模組中，所以由UMAC直接呼叫的offload函式，將被歸結到下面內容中：

• OL引數函式，從UMAC中呼叫
• OL函式通過“ic”指標訪問OL層
• 在UMAC中的，並且是OL相關的函式
• 獨立於OL的函式，但當前處在OL層。
• OL和DA模組使用到的UMAC函式
• NSS (WiFi OL)模組化

從UMAC呼叫的OL引數函式

用很多OL函式由UMAC直接呼叫，用於配置OL驅動的引數。
作為獨立的UMAC，不能直接呼叫OL層的函式，而是回撥的辦法，來訪問OL或DA層。
ic_vap_get_param不能用時，可以新增這個函式功能。
對於“set”函式，將使用“ic_vap_set_param”。
其他一些類似的函式：

ol_txrx_clear_rawmode_pkt_sim_stats
ol_txrx_host_stats_get
ol_tx_rst_tso_stats
ol_txrx_print_rawmode_pkt_sim_stats
ol_ath_set_vap_cts2self_prot_dtim_bcn
ol_tx_rst_sg_stats
ol_tx_print_sg_stats
ol_rst_rx_cksum_stats
ol_tx_print_tso_stats
ol_txrx_host_msdu_ttl_stats
ol_txrx_debug
ol_txrx_fw_stats_get
ol_ath_ucfg_reset_peer_mumimo_tx_count
ol_txrx_aggr_cfg
ol_rate_is_valid_basic
ol_ath_net80211_get_vap_stats
ol_txrx_host_me_stats
ol_txrx_fw_stats_cfg
ol_txrx_host_stats_clr
ol_print_rx_cksum_stats
 

OL函式通過傳遞“ic”指標來訪問OL層

所有UMAC訪問OL或DA層使用的函式，都應當以回撥的方式完成，比如使用“ic”函式指標。
任何繞過這種策略訪問OL或DA層的函式，都會被判斷出來。所以要麼通過“ic”指標來訪問，或者乾脆將整個模組都移到OL層。
通過以下步驟完成通過“ic”指標訪問。

1. 新增一個“struct ieee80211com”結構體的函式指標。
2. 在OL裝置attach時，註冊到OL函式中 (初始化函式指標) 。
3. 需要訪問OL曾是，呼叫這個函式指標。

比如:

ol_ll_pdev_tx_lock
ol_ll_pdev_tx_unlock
ol_txrx_osif_vdev_register
ol_tx_tso_sg_process_skb
ol_ath_ucfg_get_peer_mumimo_tx_count
ol_net80211_set_mu_whtlist

在UMAC中的，並且是OL相關的函式
許多到OL層資料通路相關的函式，都在osif_umac檔案中，這是UMAC模組的一部分。這些檔案都是OL裝置相關的，所以會被移到offload模組。
比如:

osif_ol_ll_vap_hardstart
osif_ol_hadstart_vap_vow_debug
osif_deliver_data_ol

獨立於OL的函式，但當前處在OL層
有一些函式是處在OL層的，但卻和OL層沒什麼關係，這些可以作為通用部分和UMAC模組的一部分。這些函式可以移到UMAC模組。
比如：

transcap_nwifi_to_8023
dscp_tid_map

OL和DA模組使用到的UMAC函式
因為UMAC在OL或DA模組之前啟動，所以OL或DA模組需要的函式，需要開放出來。
在開發的階段1，建立了一個新的umac_exports.c檔案，用於開發一些必要的函式。

NSS (WiFi OL)模組化
osif_nss檔案將會是“umac”模組的一部分，但是osif_nss_wifiol相關的檔案，將被移到“qca_ol”模組中，因為這些是OL晶片組相關的。
這樣就增加了一個限制，“umac”不能直接呼叫osif_nss_wifiol函式，因為“umac”模組將在“qca_ol”前啟動。
為了避免這樣的限制，osif_nss_ol_pdev_attach函式呼叫時，將會攜帶一個函式陣列指標，這個函式指標陣列將會初始化成相應的osif_nss_wifiol函式。
下面這個nss_wifi_offload_funcs結構體，用於就是含有相應函式指標的陣列。這個結構體在osif_nss_ol_pdev_attach函式中，會被傳遞到ic->nss_funcs。

struct nss_wifi_offload_funcs nss_wifi_funcs = {
    osif_nss_ol_store_other_pdev_stavap,
    osif_nss_vdev_me_reset_snooplist,
    osif_nss_vdev_me_update_member_list,
    osif_nss_ol_vap_xmit,
    osif_nss_vdev_me_update_hifitlb,
    osif_nss_vdev_me_dump_denylist,
    osif_nss_vdev_me_add_deny_member,
    osif_nss_ol_vdev_set_cfg,
    osif_nss_vdev_process_mpsta_tx,
    osif_nss_ol_wifi_monitor_set_filter,
    osif_nss_vdev_get_nss_id,
    osif_nss_vdev_process_extap_tx,
    osif_nss_vdev_me_dump_snooplist,
    osif_nss_ol_vap_delete,
    osif_nss_vdev_me_add_member_list,
    osif_nss_vdev_vow_dbg_cfg,
    osif_nss_ol_enable_dbdc_process,
    osif_nss_vdev_get_nss_wifiol_ctx,
    osif_nss_vdev_me_delete_grp_list,
    osif_nss_vdev_me_create_grp_list,
    osif_nss_vdev_me_delete_deny_list,
    osif_nss_vdev_me_remove_member_list
};

“qcawifi.sh”指令碼的變化
qcawifi.sh指令碼用於安裝WLAN驅動模組，傳遞模組引數，它也同樣需要修改去使用這種模組化。

UMAC和OL模組之間的模組引數劃分

所有的模組引數但前都被傳遞到了UMAC模組。因為qca_ol和qca_da模組分開的關係，qcawifi.sh指令碼也應該做相應的變化，根據當前的模組傳遞引數。
下面是一些傳遞到相應模組的模組引數。

模組啟動順序

WLAN驅動模組需要按照下面的順序啟動，這取決於互相的依賴。

asf
adf
ath_dfs
ath_spectral
umac
ath_hal
ath_rate_ahteros
hst_tx99
ath_dev
qca_da
qca_ol (這個模組可以在umac之後啟動)

qca_ol模組將啟動OL裝置，qca_da模組將啟動DA裝置。他們之間互相獨立，裝置的啟動順序，將取決於誰先被檢測到。這也會決定radio的名字。

WLAN驅動韌體大小
OL和DA晶片組，都使用的平臺。

只使用OL晶片組的平臺。

只使用DA晶片組的平臺。

圖 1-12 WLAN驅動韌體大小