WLAN开发概述

简介

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

图 1 WLAN框架

WLAN开发概述 - 图1

WLAN驱动接口架构

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

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

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

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

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

WLAN开发概述 - 图2

接口说明

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。