Hi3861V100创建Wi-Fi驱动应用的步骤

电子说

1.3w人已加入

描述

Hi3861V100、Hi3861LV100 通过API(Application Programming Interface)面向开发者提供Wi-Fi功能的开发和应用接口,包括芯片初始化、资源配置、Station创建和配置、扫描、关联以及去关联、状态查询等一系列功能, 框架结构如图1-1所示。

wi-fi

各功能模块说明如下:

APP应用开发层:用户基于API接口的二次开发。

Example示例:SDK提供的功能开发示例。

API接口:提供基于SDK的通用接口。

LWIP协议栈:网络协议栈。

WPA SUPPLICANT(含HOSTAPD):Wi-Fi管理模块。

Wi-Fi驱动:802.11协议实现模块。

Platform平台:提供SoC系统板级支持包(包括:芯片和外围设备驱动、操作系统以及系统管理)

wi-fi

1、Wi-Fi驱动加载与卸载

1.1 概述

在完成芯片上电后,驱动加载实现对芯片寄存器的初始配置、校准参数读取与写入、软件资源的申请和配置;驱动卸载实现软件资源的释放。

1.2 开发流程

使用场景:Wi-Fi驱动初始化为Wi-Fi功能提供基本资源配置和芯片初始化,是Wi-Fi功能实现的第一步。当需要配置Wi-Fi功能时,必须先完成驱动的初始化,Wi-Fi功能使用完成后,可以使用去初始化完成资源释放也可以使用软复位来完成资源释放。

功能:Wi-Fi驱动加载与卸载提供的接口如表2-1所示

wi-fi

使用驱动加载与卸载的典型流程:

步骤1:调用hi_wifi_init, 完成Wi-Fi驱动初始化。

步骤2:参考“3 STA功能”或“4 SoftAp功能”配置Wi-Fi功能。

步骤3:调用hi_wifi_deinit,完成Wi-Fi驱动去初始化。

----

结束

返回值如表2-2所示

wi-fi

1.3 注意事项

驱动资源配置不支持运行中修改,须先卸载驱动再进行修改,修改后重新初始化。

驱动为了保证Wi-Fi业务的连续性,会在启动时根据VAP数量和用户数量预申请内存,其中1个VAP资源预申请约5K内存,1个用户资源预申请约7K内存,请根据场景需要合理配置初始化的资源数。目前仅配网时需要用到SoftAp和STA共存,一般建议配置为2个VAP和2个用户;如果可以实现配网时先关闭SoftAp再启动STA去关联,VAP和用户数量均可配置为1。

1.4 编程实例

示例1:基于LiteOS的app_main函数,在系统初始化时自动完成Wi-Fi驱动的加载,此加载方式无须进行卸载开发,系统reboot时自动完成驱动卸载和加载。

wi-fi

wi-fi

示例2:基于shell命令,在系统启动后,通过手动下发shell命令完成Wi-Fi驱动的加载和卸载。

wi-fi

wi-fi

wi-fi

2、STA功能

2.1 概述

STA功能即NON-AP Station功能,实现驱动STA VAP的创建、扫描、关联以及DHCP,完成通信链路的建立。开发STA功能前,须完成驱动加载。

2.2 开发流程

使用场景:当需要接入某个网络并与该网络通信时,需要启动STA功能。

功能:驱动STA功能提供的接口,如表3-1所示。

wi-fi

wi-fi

STA功能开发的典型流程:

步骤1:调用hi_wifi_sta_start, 启动STA。

步骤2:调用hi_wifi_set_bandwidth, 设置STA带宽模式,20M带宽可不用配置。

步骤3:(可选,根据需要配置)调用hi_wifi_sta_set_reconnect_policy, 设置自动重连。

步骤4:调用hi_wifi_sta_scan(或调用hi_wifi_sta_advance_scan;执行带参数扫描),触发STA扫描。

步骤5:调用hi_wifi_sta_scan_results,获取扫描结果。

步骤6:根据接入网络需求,自定义筛选扫描结果,调用hi_wifi_sta_connect, 进行连接。

步骤7:调用hi_wifi_sta_get_connect_info,查询Wi-Fi连接状态。

步骤8:连接成功后,调用netifapi_dhcp_start,启动DHCP客户端,获取IP地址。

步骤9:调用hi_wifi_sta_disconncet,离开当前连接的网络。

步骤10:调用netifapi_dhcps_stop,停止DHCP客户端。

步骤11:调用hi_wifi_sta_stop,关闭STA。

---结束

返回值如表3-2所示

wi-fi

2.3 注意事项

STA支持5M/1 OM窄带模式,需要时可调用接口设置,不调用则默认启动20M带宽STA。

扫描为非阻塞式接口,扫描命令下发成功后需要延迟一段时间后再获取扫描结果,全信道扫描延迟时间建议设置为1s。

可通过指定SSID、BSSID、信道等带指定参数的扫描,实现更精准地扫描,缩短扫描时间。

已知待连接网络的参数时,可省去扫描过程,直接发起连接。

连接为非阻塞式接口,连接命令下发成功后,需要通过命令获取连接状态。

注册事件回调函数后,Wi-Fi相关的事件会通过该回调上报用户,用户可根据事件执行后续动作。

不支持重复启动STA,再次启动STA时须先执行关闭STA。

关闭STA步骤为可选,设备所处的网络地位不变,不需要执行关闭STA。

2.4 编程实例

示例:实现STA功能启动、扫描、关联以及获取IP地址。

wi-fi

wi-fi

wi-fi

wi-fi

wi-fi

3、SoftAp功能

3.1 概述

SoftAp功能提供网络接入点供其他STA接入,并对接入的STA提供DHCP Server服务。

3.2 开发流程

使用场景:当需要创建一个网络接入点,供其他设备接入并共享网络内的数据时,需要使用SoftAP功能。

功能:提供的接口如表4-1所示。

wi-fi

wi-fi

SoftAP功能开发的典型流程:

步骤1:配置SoftAp的网络参数:

-调用hi_wifi_softap_set_protocol_mode,设置协议模式。

-调用hi_wifi_softap_set_beacon_period,设置beacon周期。

-调用hi_wifi_softap_ set_dtim_period,设置dtim周期。

步骤2:调用hi_wifi_softap_start,启动SoftAp。

步骤3:调用hi_wifi_set_bandwidth,设置SoftAp的带宽,20M带宽可不用配置。

步骤4:调用netifapi_netif_set_addr,配置DHCP服务器。

步骤5:调用netifapi_dhcps_start,启动DHCP服务器。

步骤6:调用netifapi_dhcps_stop,停止DHCP服务器。

步骤7:调用hi_wifi_softap_stop,关闭SoftAp。

--结束

返回值如表4-2所示

wi-fi

3.3 注意事项

SoftAp的网络参数为可选配置,无特殊要求均可使用初始默认值。

SoftAp支持5M/1 0M窄带模式,需要时可调用接口设置,不调用则默认启动20M带宽SoftAp。

SoftAp的网络参数在关闭SoftAp时不会重置,会继续沿用_上一次配置,重启单板可恢复至初始默认值。

SoftAp模式下最大关联用户数限制:

-小于初始化时配置的用户数量。

-最大关联用户不超过2个。

3.4 编程实例

示例:实现将SoftAp功能的beacon周期配置为200ms,并启动SoftAp,最后将DHCP服务器的IP地址配置为192.168.43.1。

wi-fi

wi-fi

除此之外,Wi-Fi软件应用创建还包括了混杂模式、CSI数据采集、STA&SoftAP共存、Wi-Fi&蓝牙共存、软件重传等诸多无线网实用功能开发。想详细了解学习的童鞋,可以扫码加入我们的鸿蒙技术交流群,免费领取领取完整的基于HarmonyOS Hi3861V100开发板Wi-Fi模组应用开发文档。另外还给大家准备了超级详细的Hi3861V100硬件&软件开发文档资料,也一并免费送给大家学习。
责任编辑人:CC

打开APP阅读更多精彩内容
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

×
20
完善资料,
赚取积分