WLAN开发概述

WLAN开发概述

简介

WLAN是基于统一驱动平台（以下简称HDF）开发的模块，该模块可实现跨操作系统迁移，自适应器件差异，模块化拼装编译等功能。各WLAN厂商驱动开发人员可根据WLAN模块提供的向下统一接口适配各自的驱动代码，HAL层开发人员可根据WLAN模块提供的向上统一接口获取如下能力：建立/关闭WLAN热点，扫描，关联WLAN热点等等。WLAN模块框架图如下：

图 1 WLAN框架

WLAN驱动接口架构

WLAN模块有三部分对外开放的API接口，如下图所示：

1、对HAL层提供的能力接口；

2、驱动直接调用WLAN模块能力接口；

3、提供给各厂商实现的能力接口，本章节以下内容将从以初始化为例进行开发指导。

图 2 WLAN模块开放能力分布图

接口说明

WLAN驱动模块对HAL层开发人员提供的接口功能有：建立/关闭WLAN热点、扫描WLAN、开始关联、断开连接等等。

WLAN驱动模块提供了驱动开发人员可直接调用的能力接口，主要功能有：创建/释放WifiModule、关联/取消关联、申请/释放net buf、lwip的pbuf和netbuf的相互转换等等。

表1 提供了部分接口说明如下：

表 1 可直接调用的接口

头文件	接口名称	功能描述
wifi_module.h	struct WifiModule WifiModuleCreate(const struct HdfConfigWifiModuleConfig config);	基于HDF开发WLAN驱动时，创建一个WifiModule。
	void WifiModuleDelete(struct WifiModule module);	基于HDF开发WLAN驱动时，删除并释放WifiModule所有数据。
	int32_t DelFeature(struct WifiModule module, uint16_t featureType);	基于HDF开发WLAN驱动时，从WifiModule删除一个功能组件。
	int32_t AddFeature(struct WifiModule module, uint16_t featureType, struct WifiFeature featureData);	基于HDF开发WLAN驱动时，注册一个功能组件到WifiModule。
wifi_mac80211_ops.h	int32_t (startAp)(NetDevice netDev);	启动AP。
	int32_t (stopAp)(NetDevice netDev);	停止AP。
	int32_t (connect)(NetDevice netDev, WifiConnectParams param);	开始连接。
	int32_t (disconnect)(NetDevice netDev, uint16_t reasonCode);	断开连接。
hdf_netbuf.h	static inline void NetBufQueueInit(struct NetBufQueue q);	初始化net buffer队列。
	struct NetBuf NetBufAlloc(uint32_t size);	申请net buffer。
	void NetBufFree(struct NetBuf nb);	释放net buffer。
	struct NetBuf Pbuf2NetBuf(const struct NetDevice netdev, struct pbuf lwipBuf);	lwip的pbuf转换为net buffer。
	struct pbuf NetBuf2Pbuf(const struct NetBuf *nb);	net buffer转换为lwip的pbuf。

WLAN驱动模块提供了需驱动开发人员实现的能力接口，主要功能有：初始化/注销net device、打开/关闭net device、获取net device的状态等等。

表2 提供了部分接口说明如下：

表 2 需要开发人员实现的接口

头文件	接口名称	功能描述
net_device.h	int32_t (init)(struct NetDevice netDev);	初始化net device。
	struct NetDevStats (getStats)(struct NetDevice netDev);	获取net device的状态。
	int32_t (setMacAddr)(struct NetDevice netDev, void addr);	设置mac地址。
	void (deInit)(struct NetDevice netDev);	注销net device。
	int32_t (open)(struct NetDevice netDev);	打开net device。
	int32_t (stop)(struct NetDevice netDev);	关闭net device。