Evolution-x/hardware_interfaces
1
0
Fork 0
mirror of https://github.com/Evolution-X/hardware_interfaces synced 2026-02-01 11:36:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Wifi HAL Multi STA: Clarify behavior during single STA

Browse Source 
Firmware should maintain the last set multi STA
use case & primary connection across periods of
single STA.

Bug: 183861582
Test: compiles
Change-Id: Iab7b9298216a90ddcd792aec794266c9edb397fa
This commit is contained in:
David Su
2021-03-31 12:27:21 -07:00
parent 7eb0b7a239
commit 8baf600058
1 changed files with 17 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
wifi/1.5/IWifiChip.hal
View File

@@ -47,6 +47,15 @@ interface IWifiChip extends @1.4::IWifiChip {
* - This will be invoked before an active wifi connection is established on the second
* interface.
* - This use-case hint is implicitly void when the second STA interface is brought down.
* - When there is only 1 STA interface, the must should still retain the last use case
* set, which must become active the next time multi STA is enabled.
* 1. Initialize with single STA.
* 2. Framework creates second STA.
* 3. Framework sets use case to DUAL_STA_NON_TRANSIENT_UNBIASED.
* 4. Framework destroys second STA. Only 1 STA remains.
* 5. Framework recreates second STA.
* 6. The active use case remains DUAL_STA_NON_TRANSIENT_UNBIASED (i.e. firmware should not
* automatically change it during period of single STA unless requested by framework).
*/
enum MultiStaUseCase : uint8_t {
/**
@@ -100,11 +109,14 @@ interface IWifiChip extends @1.4::IWifiChip {
/**
* Invoked to indicate that the provided iface is the primary STA iface when there are more
* than 1 STA iface concurrently active.
* Note: If the wifi firmware/chip cannot support multiple instances of any offload
* (like roaming, APF, rssi threshold, etc), the firmware should ensure that these
* offloads are at least enabled for the primary interface. If the new primary interface is
* already connected to a network, the firmware must switch all the offloads on
* this new interface without disconnecting.
* Notes:
* - If the wifi firmware/chip cannot support multiple instances of any offload
* (like roaming, APF, rssi threshold, etc), the firmware should ensure that these
* offloads are at least enabled for the primary interface. If the new primary interface is
* already connected to a network, the firmware must switch all the offloads on
* this new interface without disconnecting.
* - When there is only 1 STA interface, the firmware must still retain the last primary
* connection, which must become active the next time multi STA is enabled.
*
* @param ifname Name of the STA iface.
* @return status WifiStatus of the operation.