OpenHarmony开发之Wi-Fi与蓝牙移植适配指南

最新推荐文章于 2025-07-31 19:38:27 发布

你我皆是牛马星人

最新推荐文章于 2025-07-31 19:38:27 发布

阅读量1k

点赞数 17

CC 4.0 BY-SA版权

分类专栏： OpenHarmony HarmonyOS 鸿蒙开发文章标签： java harmonyos 嵌入式硬件 OpenHarmony 分布式鸿蒙开发移植

本文链接：https://blog.csdn.net/adaedwa187545/article/details/149300143

鸿蒙开发同时被 3 个专栏收录

969 篇文章

订阅专栏

OpenHarmony

968 篇文章

订阅专栏

HarmonyOS

967 篇文章

订阅专栏

📌往期推文全新看点（文中附带最新·鸿蒙全栈学习笔记）

📃 鸿蒙（HarmonyOS）北向开发知识点记录~

📃 鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~

📃 鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

📃 嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

📃 对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

📃 鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

📃 记录一场鸿蒙开发岗位面试经历~

📃 持续更新中……

通信子系统目前涉及 Wi-Fi 和蓝牙适配，厂商应当根据芯片自身情况进行适配。

移植指导

Wi-Fi 编译文件内容如下：
路径：“foundation/communication/wifi_lite/BUILD.gn”

group("wifi") {
  deps = [ "$ohos_board_adapter_dir/hals/communication/wifi_lite/wifiservice:wifiservice" ]
}

从中可以看到厂商适配相关接口的.c 文件存放目录应为“$ohos_board_adapter_dir/hals/communication/wifi_lite/wifiservice”，且该目录下 BUILD.gn 文件中的目标应为“wifiservice”。需要厂商适配的 Wi-Fi 接口见表 1 、表 2 和表 3，蓝牙接口见表 4 和表 5。

表 1 wifi_device.h

接口	作用
EnableWifi	启用 Wi-Fista 模式。
DisableWifi	禁用 Wi-Fi sta 模式。
IsWifiActive	检查 Wi-Fi sta 模式是否启用。
Scan	扫描热点信息。
GetScanInfoList	获取所有扫描到的热点列表。
AddDeviceConfig	配置连接到的热点信息。
GetDeviceConfigs	获取配置连接到的热点信息。
RemoveDevice	删除指定的热点配置信息。
ConnectTo	接到指定的热点。
Disconnect	断开 Wi-Fi 连接。
GetLinkedInfo	获取热点连接信息。
RegisterWifiEvent	为指定的 Wi-Fi 事件注册回调。
UnRegisterWifiEvent	取消注册以前为指定 Wi-Fi 事件注册的回调。
GetDeviceMacAddress	获取设备的 MAC 地址。
AdvanceScan	根据指定参数启动 Wi-Fi 扫描。

表 2 wifi_hotspot_config.h

接口	作用
SetBand	设置该热点的频段。
GetBand	获取该热点的频段。

表 3 wifi_hotspot.h

接口	作用
EnableHotspot	启用 Ap 热点模式。
DisableHotspot	禁用 Ap 热点模式。
SetHotspotConfig	设置指定的热点配置。
GetHotspotConfig	获取指定的热点配置。
IsHotspotActive	检查 Ap 热点模式是否启用。
GetStationList	获取连接到此热点的一系列 STA。
GetSignalLevel	获取指定接收信号强度指示器（RSSI）和频带指示的信号电平。
DisassociateSta	使用指定的 MAC 地址断开与 STA 的连接。
AddTxPowerInfo	将 hotspot 功率发送到 beacon。

表 4 ohos_bt_gatt.h

接口	作用
InitBtStack	初始化蓝牙协议栈。
EnableBtStack	使能蓝牙协议栈。
DisableBtStack	禁用蓝牙协议栈。
SetDeviceName	设置蓝牙设备名称。
BleSetAdvData	设置广播数据。
BleStartAdv	开始广播。
BleStartAdvEx	传入构建好的广播数据，参数，开启蓝牙广播。
BleStopAdv	停止发送广播。
BleUpdateAdv	更新 advertising 参数。
BleSetSecurityIoCap	设置蓝牙的 IO 能力为 NONE，配对方式为 justworks。
BleSetSecurityAuthReq	设置蓝牙是否需要配对绑定。
BleGattSecurityRsp	响应安全连接请求。
ReadBtMacAddr	获取设备 MAC 地址。
BleSetScanParameters	设置扫描参数。
BleStartScan	开始扫描。
BleStopScan	停止扫描。
BleGattRegisterCallbacks	注册 gap,GATT 事件回调函数。

表 5 ohos_bt_gatt_server.h

接口	作用
BleGattsRegister	使用指定的应用程序 UUID 注册 GATT 服务器。
BleGattsUnRegister	断开 GATT 服务器与客户端的连接。
BleGattsDisconnect	断开 GATT 服务器与客户端的连接。
BleGattsAddService	添加了一个服务。
BleGattsAddIncludedService	将包含的服务添加到指定的服务。
BleGattsAddCharacteristic	向指定的服务添加特征。
BleGattsAddDescriptor	将描述符添加到指定的特征。
BleGattsStartService	启动一个服务。
BleGattsStopService	停止服务。
BleGattsDeleteService	删除一个服务。
BleGattsClearServices	清除所有服务。
BleGattsSendResponse	向接收到读取或写入请求的客户端发送响应。
BleGattsSendIndication	设备侧向 APP 发送蓝牙数据。
BleGattsSetEncryption	设置 GATT 连接的加密类型。
BleGattsRegisterCallbacks	注册 GATT 服务器回调。
BleGattsStartServiceEx	根据传入的服务列表，创建 gatt 服务。
BleGattsStopServiceEx	传入 gatt 服务句柄，停止 gatt 服务。

说明：
不同版本接口可能存在差异，需要根据当前版本的具体文件进行适配。

适配实例

1.在“config.json”中添加 communication 子系统。
路径：“vendor/MyVendorCompany/MyProduct/config.json”
修改如下：

{ 
    "subsystem": "communication", 
    "components": [ 
        { "component": "wifi_lite", "features":[] }
    ] 
},

2.添加适配文件。
在“vendor/MyVendorCompany/MyProduct/config.json”文件中，通常将配置“ohos_board_adapter_dir”配置为 “//vendor/MyVendorCompany/MyProduct/adapter”。
在“ohos_board_adapter_dir”目录下根据上述适配指导中提到的头文件，适配 Wi-Fi、蓝牙接口。