• dev 驅(qū)動接口層：為 wlan 框架提供統(tǒng)一的接口調(diào)用。
• manage 管理層：為用戶提供 Wi-Fi 掃描，鏈接，斷線重連等功能。
• protocol 協(xié)議：負(fù)責(zé)處理 Wi-Fi 產(chǎn)生的數(shù)據(jù)流，如 lwip。

1、使能 wlan 驅(qū)動

在 Linux 下 執(zhí)行如下命令，并開啟 wlan 驅(qū)動。

1$scons--menuconfig
2RT-ThreadComponents--->
3DeviceDrivers--->
4[*]UsingWi-Fiframework--->

開啟 wlan 驅(qū)動后，默認(rèn)會選中 lwip。

如 WiFi SOC 類芯片，原廠 SDK 中已經(jīng)有線程管理 WiFi 數(shù)據(jù)收發(fā)，可關(guān)閉 lwip 中的 Rx thread 和 Tx thread，以節(jié)省系統(tǒng)資源。

1Network--->
2-*-LwIP:lightweightTCP/IPstack--->
3[*]NotuseRxthread
4[*]NotuseTxthread

2、wlan 驅(qū)動框架適配

初始化

通過 rt_wlan_dev_register() 注冊 STATION 和 AP 設(shè)備，并將 wlan 設(shè)備接口函數(shù)注冊進(jìn)對應(yīng)設(shè)備。

 1staticconststructrt_wlan_dev_opsops=
 2{
 3.wlan_init=drv_wlan_init,
 4.wlan_mode=drv_wlan_mode,
 5.wlan_scan=drv_wlan_scan,
 6.wlan_join=drv_wlan_join,
 7.wlan_softap=drv_wlan_softap,
 8.wlan_disconnect=drv_wlan_disconnect,
 9.wlan_ap_stop=drv_wlan_ap_stop,
10.wlan_ap_deauth=drv_wlan_ap_deauth,
11.wlan_scan_stop=drv_wlan_scan_stop,
12.wlan_get_rssi=drv_wlan_get_rssi,
13.wlan_set_powersave=drv_wlan_set_powersave,
14.wlan_get_powersave=drv_wlan_get_powersave,
15.wlan_cfg_promisc=drv_wlan_cfg_promisc,
16.wlan_cfg_filter=drv_wlan_cfg_filter,
17.wlan_cfg_mgnt_filter=drv_wlan_cfg_mgnt_filter,
18.wlan_set_channel=drv_wlan_set_channel,
19.wlan_get_channel=drv_wlan_get_channel,
20.wlan_set_country=drv_wlan_set_country,
21.wlan_get_country=drv_wlan_get_country,
22.wlan_set_mac=drv_wlan_set_mac,
23.wlan_get_mac=drv_wlan_get_mac,
24.wlan_recv=drv_wlan_recv,
25.wlan_send=drv_wlan_send,
26};
27intrt_hw_wifi_init(void)
28{
29rt_err_tret=RT_EOK;
30staticstructrt_wlan_devicewlan0;
31staticstructrt_wlan_devicewlan1;
32memset(&wifi_sta,0,sizeof(wifi_sta));
33ret=rt_wlan_dev_register(&wlan0,RT_WLAN_DEVICE_STA_NAME,&ops,0,&wifi_sta);
34wifi_sta.wlan=&wlan0;
35memset(&wifi_ap,0,sizeof(wifi_ap));
36ret|=rt_wlan_dev_register(&wlan1,RT_WLAN_DEVICE_AP_NAME,&ops,0,&wifi_ap);
37wifi_ap.wlan=&wlan1;
38returnret;
39}
40INIT_DEVICE_EXPORT(rt_hw_wifi_init);

啟動設(shè)備

在 main.c 中 加入 rt_wlan_set_mode 分別設(shè)置 STATION 和 AP 模式。

1intmain(void)
2{
3rt_kprintf("Hello,RISC-V!
");
4/*setwifiworkmode*/
5rt_wlan_set_mode(RT_WLAN_DEVICE_STA_NAME,RT_WLAN_STATION);
6rt_wlan_set_mode(RT_WLAN_DEVICE_AP_NAME,RT_WLAN_AP);
7return0;
8}

接口實現(xiàn)

在 STATION 模式下，至少需要實現(xiàn)連接路由器 drv_wlan_join() 和斷開路由器 drv_wlan_disconnect() 這 2 個函數(shù)。

在 AP 模式下，至少要實現(xiàn) AP 開啟 drv_wlan_softap 和 AP 關(guān)閉 drv_wlan_ap_stop() 這 2個函數(shù)。

這 4 個函數(shù)可以按照芯片 SDK 上的接口對應(yīng)實現(xiàn)即可。

event 管理

在實現(xiàn)以上接口用，需要在 Wi-Fi 觸發(fā)對應(yīng)事件后，通過 event 通知 wlan 驅(qū)動框架。

在 STATION 模式下，當(dāng)連接路由器成功后，通過 rt_wlan_dev_indicate_event_handle(wifi_sta.wlan, RT_WLAN_DEV_EVT_CONNECT, RT_NULL) 函數(shù)通知 wlan 框架 station 已經(jīng)連接路由成功。當(dāng)斷開路由器后，通過 rt_wlan_dev_indicate_event_handle(wifi_sta.wlan, RT_WLAN_DEV_EVT_DISCONNECT, RT_NULL) 函數(shù)通過 wlan 框架 station 已經(jīng)斷開路由器。

wlan 框架在收到 RT_WLAN_DEV_EVT_CONNECT 時間后會通過 dhcp 服務(wù)獲取 IP。

在 AP 模式下，開啟軟 AP 成功后，通過 rt_wlan_dev_indicate_event_handle(wifi_ap.wlan, RT_WLAN_DEV_EVT_AP_START, RT_NULL) 函數(shù)通知 wlan 框架 AP 模式開啟成功。關(guān)閉軟 AP 成功后，通過 rt_wlan_dev_indicate_event_handle(wifi_ap.wlan, RT_WLAN_DEV_EVT_AP_STOP, RT_NULL) 函數(shù)通知 wlan 框架軟 AP 關(guān)閉。

wlan 框架在收到 RT_WLAN_DEV_EVT_AP_START 時間后會開啟 DHCP_SERVER 服務(wù)。

采用了 RT-Thread wlan 驅(qū)動框架后，芯片 SDK 只需要負(fù)責(zé)管理 WiFi 相關(guān)的連接服務(wù)，而不需要管理 lwip 協(xié)議棧，

數(shù)據(jù)收發(fā)

上面說到 wlan 框架在收到對應(yīng)的 evnet 后，負(fù)責(zé)啟動 lwip 中的對應(yīng)服務(wù)。

• wlan 框架通過 drv_wlan_send() 函數(shù)將需要發(fā)送的網(wǎng)絡(luò)數(shù)據(jù)包發(fā)輸出去。針對WiFi 而言，需要通過判斷設(shè)備是 station 還是 ap 后，將對應(yīng)的數(shù)據(jù)包發(fā)送給 WiFi 。

1staticintdrv_wlan_send(structrt_wlan_device*wlan,void*buff,intlen)
2{
3if(wlan->user_data==&wifi_sta)
4bl_wifi_tx(0,(structpbuf*)buff);
5else
6bl_wifi_tx(1,(structpbuf*)buff);
7returnRT_EOK;
8}

• WiFi 設(shè)備接收到數(shù)據(jù)后，通過 rt_wlan_dev_report_data() 函數(shù)，將數(shù)據(jù)傳遞給 wlan 框架，wlan 框架會進(jìn)一步通過 lwip 做進(jìn)一步處理。

1intbl_wifi_rx(uint8_tidx,structpbuf*p)
2{
3rt_err_tret=RT_EOK;
4if(idx==0)
5ret=rt_wlan_dev_report_data(wifi_sta.wlan,p,p->tot_len);
6else
7ret=rt_wlan_dev_report_data(wifi_ap.wlan,p,p->tot_len);
8returnret;
9}

其他必須實現(xiàn)的接口

• mac相關(guān)

主要實現(xiàn) mac 地址讀取和寫入。

1staticrt_err_tdrv_wlan_set_mac(structrt_wlan_device*wlan,rt_uint8_tmac[])
2{
3wifi_mgmr_sta_mac_set(mac);
4returnRT_EOK;

1staticrt_err_tdrv_wlan_get_mac(structrt_wlan_device*wlan,rt_uint8_tmac[])
2{
3wifi_mgmr_sta_mac_get(mac);
4returnRT_EOK;
5}

• Wi-Fi scan

 1staticrt_err_tdrv_wlan_scan(structrt_wlan_device*wlan,structrt_scan_info*scan_info)
 2{
 3intchannel_input_num=0;
 4uint8_tchannel_input[MAX_FIXED_CHANNELS_LIMIT]={0};
 5constchar*ssid=NULL;
 6uint8_tbssid[6]={0xff,0xff,0xff,0xff,0xff,0xff};
 7uint8_tscan_mode=SCAN_ACTIVE;
 8uint32_tduration_scan_us=0;
 9if(scan_info!=NULL&&scan_info->ssid.len>0)
10{
11ssid=scan_info->ssid.val;
12}
13if(wifi_mgmr_scan_adv(wlan,wifi_scan_complete_callback,channel_input,channel_input_num,bssid,ssid,scan_mode,duration_scan_us)!=0)
14return-RT_ERROR;
15returnRT_EOK;
16}

BL808 WiFi 屬于 SOC 單芯片型無線 MCU，片上集成 WiFi 功能，移植 RT-Thread 過程中，需要使用 RT-Thread wlan 框架。

本文為RT-Thread論壇用戶「燕十三」的原創(chuàng)文章，再次感謝