Porting the Communication Subsystem

The communication subsystem porting process involves Wi-Fi and Bluetooth adaptation. Vendors need to perform adaptation based on the chip conditions.

Procedure

To implement Wi-Fi adaptation, perform the following steps:

Path: foundation/communication/wifi_lite/BUILD.gn

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

As shown above, the .c file of the vendor adaptation interfaces is stored in the $ohos_board_adapter_dir/hals/communication/wifi_lite/wifiservice directory, where the target in the BUILD.gn file is wifiservice. Table 1, Table 2, and Table 3 list the Wi-Fi interfaces that need to be adapted by vendors. Table 4 and Table 5 list the Bluetooth interfaces.

Table 1 wifi_device.h

API	Description
EnableWifi	Enables the Wi-Fi STA mode.
DisableWifi	Disables the Wi-Fi STA mode.
IsWifiActive	Check whether the Wi-Fi STA mode is enabled.
Scan	Scans for hotspots.
GetScanInfoList	Obtains the list of all found hotspots.
AddDeviceConfig	Adds the information about the hotspot to be connected.
GetDeviceConfigs	Obtains the information about the connected hotspot.
RemoveDevice	Deletes the information about a specified hotspot.
ConnectTo	Connects to a specified hotspot.
Disconnect	Severs the Wi-Fi connection.
GetLinkedInfo	Obtains hotspot connection information.
RegisterWifiEvent	Registers a callback for a specified Wi-Fi event.
UnRegisterWifiEvent	Deregisters the callback previously registered for a specified Wi-Fi event.
GetDeviceMacAddress	Obtains the device MAC address.
AdvanceScan	Starts Wi-Fi scanning based on specified parameters.

Table 2 wifi_hotspot_config.h

API	Description
SetBand	Sets the frequency band of the hotspot.
GetBand	Obtains the frequency band of the hotspot.

Table 3 wifi_hotspot.h

API	Description
EnableHotspot	Enables AP hotspot mode.
DisableHotspot	Disables AP hotspot mode.
SetHotspotConfig	Configures settings for a specified hotspot.
GetHotspotConfig	Obtains settings of a specified hotspot.
IsHotspotActive	Checks whether AP hotspot mode is enabled.
GetStationList	Obtains a list of STAs connected to the hotspot.
GetSignalLevel	Obtains the signal level of the specified received signal strength indicator (RSSI) and frequency band indicator.
DisassociateSta	Disconnects from the STA that matches the specified MAC address.
AddTxPowerInfo	Sends the hotspot power to the beacon.

Table 4 ohos_bt_gatt.h

API	Description
InitBtStack	Initializes the Bluetooth protocol stack.
EnableBtStack	Enables the Bluetooth protocol stack.
DisableBtStack	Disables the Bluetooth protocol stack.
SetDeviceName	Sets the Bluetooth device name.
BleSetAdvData	Sets the data to advertise.
BleStartAdv	Starts advertising.
BleStartAdvEx	Transfers the constructed advertising data and parameters to enable Bluetooth advertising.
BleStopAdv	Stops sending advertising messages.
BleUpdateAdv	Updates the advertising parameters.
BleSetSecurityIoCap	Sets the Bluetooth I/O capability to NONE and pairing mode to justworks.
BleSetSecurityAuthReq	Sets whether Bluetooth pairing is required.
BleGattSecurityRsp	Responds to a secure connection request.
ReadBtMacAddr	Obtains the device MAC address.
BleSetScanParameters	Sets scan parameters.
BleStartScan	Starts scanning
BleStopScan	Stops scanning.
BleGattRegisterCallbacks	Registers a callback for GAP and GATT events.

Table 5 ohos_bt_gatt_server.h

API	Description
BleGattsRegister	Registers with the GATT server using the specified application UUID.
BleGattsUnRegister	Deregisters from the GATT server.
BleGattsDisconnect	Disconnects the GATT server from the client.
BleGattsAddService	Adds a service.
BleGattsAddIncludedService	Adds an included service to a specified service.
BleGattsAddCharacteristic	Adds a feature to a specified service.
BleGattsAddDescriptor	Adds a descriptor to a specified feature.
BleGattsStartService	Start a service.
BleGattsStopService	Stops a service.
BleGattsDeleteService	Deletes a service.
BleGattsClearServices	Clears all services.
BleGattsSendResponse	Sends a response to the client that receives the read or write request.
BleGattsSendIndication	Sends Bluetooth data from the device to the application.
BleGattsSetEncryption	Sets the encryption type of the GATT connection.
BleGattsRegisterCallbacks	Registers a GATT server callback.
BleGattsStartServiceEx	Creates a GATT service based on the passed service list.
BleGattsStopServiceEx	Stops the GATT service based on the passed handle .

NOTE

The APIs may vary according to the version. Adapt the APIs according to the specific file of the current version.

Example

Add the communication subsystem to the config.json file.

Path: vendor/MyVendorCompany/MyProduct/config.json

The sample code is as follows:
```
{ 
    "subsystem": "communication", 
    "components": [ 
        { "component": "wifi_lite", "features":[] }
    ] 
},
```
Add an adaptation file.

In the vendor/MyVendorCompany/MyProduct/config.json file, set ohos_board_adapter_dir to //vendor/MyVendorCompany/MyProduct/adapter.

In the ohos_board_adapter_dir directory, adapt the Wi-Fi and Bluetooth APIs based on the aforementioned header files.