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

本文介绍了鸿蒙系统通信子系统的移植适配方法，包含Wi-Fi和蓝牙模块。首先提供了Wi-Fi和蓝牙接口的详细说明表，包括功能和使用方法。接着给出具体适配步骤：1)在config.json中添加communication子系统；2)创建适配文件实现接口功能。文章还提醒开发者注意版本差异可能导致接口变化，需要根据实际版本调整。适配工作完成后，系统将具备完整的Wi-Fi和蓝牙通信能力。本文为鸿蒙系统开发者

你我皆是牛马星人

1320人浏览 · 2025-07-12 21:14:31

你我皆是牛马星人 · 2025-07-12 21:14:31 发布

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

📃 鸿蒙（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、蓝牙接口。