移植通信子系统
通信子系统目前涉及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服务。 |
说明: 不同版本接口可能存在差异,需要根据当前版本的具体文件进行适配。
适配实例
-
在“config.json”中添加communication子系统。 路径:“vendor/MyVendorCompany/MyProduct/config.json”
修改如下:
{ "subsystem": "communication", "components": [ { "component": "wifi_lite", "features":[] } ] },
-
添加适配文件。
在“vendor/MyVendorCompany/MyProduct/config.json”文件中,通常将配置“ohos_board_adapter_dir”配置为 “//vendor/MyVendorCompany/MyProduct/adapter”。
在“ohos_board_adapter_dir”目录下根据上述适配指导中提到的头文件,适配Wi-Fi、蓝牙接口。
以上就是本篇文章所带来的鸿蒙开发中一小部分技术讲解;想要学习完整的鸿蒙全栈技术。可以在结尾找我可全部拿到!
下面是鸿蒙的完整学习路线,展示如下:
除此之外,根据这个学习鸿蒙全栈学习路线,也附带一整套完整的学习【文档+视频】,内容包含如下:
内容包含了:(ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、鸿蒙南向开发、鸿蒙项目实战)等技术知识点。帮助大家在学习鸿蒙路上快速成长!
鸿蒙【北向应用开发+南向系统层开发】文档
鸿蒙【基础+实战项目】视频
鸿蒙面经
为了避免大家在学习过程中产生更多的时间成本,对比我把以上内容全部放在了↓↓↓想要的可以自拿喔!谢谢大家观看!