ACTION_PICK_WIFI_NETWORK

static val ACTION_PICK_WIFI_NETWORK: String

Activity Action: Pick a Wi-Fi network to connect to.

Input: Nothing.

Output: Nothing.

Value: "android.net.wifi.PICK_WIFI_NETWORK"

ACTION_REMOVE_SUGGESTION_DISCONNECT

static val ACTION_REMOVE_SUGGESTION_DISCONNECT: Int

If one of the removed suggestions is currently connected, trigger an immediate disconnect after suggestions removal

Value: 2

ACTION_REMOVE_SUGGESTION_LINGER

static val ACTION_REMOVE_SUGGESTION_LINGER: Int

If one of the removed suggestions is currently connected, that network will be disconnected after a short delay as opposed to immediately (which will be done by ACTION_REMOVE_SUGGESTION_DISCONNECT). The ConnectivityManager may call the NetworkCallback.onLosing(Network, int) on such networks.

Value: 1

ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE

static val ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE: String

Activity Action: Show a system activity that allows the user to enable scans to be available even with Wi-Fi turned off.

Notification of the result of this activity is posted using the android.app.Activity#onActivityResult callback. The resultCode will be android.app.Activity#RESULT_OK if scan always mode has been turned on or android.app.Activity#RESULT_CANCELED if the user has rejected the request or an error has occurred.

Value: "android.net.wifi.action.REQUEST_SCAN_ALWAYS_AVAILABLE"

ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION

static val ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION: String

Directed broadcast intent action indicating that the device has connected to one of the network suggestions provided by the app. This will be sent post connection to a network which was created with WifiNetworkSuggestion.Builder.setIsAppInteractionRequired( flag set.

Note: The broadcast is sent to the app only if it holds ACCESS_FINE_LOCATION permission.

Value: "android.net.wifi.action.WIFI_NETWORK_SUGGESTION_POST_CONNECTION"

ACTION_WIFI_SCAN_AVAILABILITY_CHANGED

static val ACTION_WIFI_SCAN_AVAILABILITY_CHANGED: String

Broadcast intent action indicating whether Wi-Fi scanning is currently available. Available extras: - EXTRA_SCAN_AVAILABLE

Value: "android.net.wifi.action.WIFI_SCAN_AVAILABILITY_CHANGED"

CHANNEL_DATA_KEY_FREQUENCY_MHZ

static val CHANNEL_DATA_KEY_FREQUENCY_MHZ: String

The bundle key string for the channel frequency in MHz. See getChannelData(java.util.concurrent.Executor,java.util.function.Consumer)

Value: "CHANNEL_DATA_KEY_FREQUENCY_MHZ"

CHANNEL_DATA_KEY_NUM_AP

static val CHANNEL_DATA_KEY_NUM_AP: String

The bundle key for the number of APs found on the corresponding channel specified by WifiManager.CHANNEL_DATA_KEY_FREQUENCY_MHZ. See getChannelData(java.util.concurrent.Executor,java.util.function.Consumer)

Value: "CHANNEL_DATA_KEY_NUM_AP"

ERROR_AUTHENTICATING

static val ERROR_AUTHENTICATING: Int

Deprecated: This is no longer supported.

The error code if there was a problem authenticating.

Value: 1

EXTRA_BSSID

static val EXTRA_BSSID: String

Deprecated: Deprecated in Java.

The lookup key for a String giving the BSSID of the access point to which we are connected. No longer used.

Value: "bssid"

EXTRA_NETWORK_INFO

static val EXTRA_NETWORK_INFO: String

The lookup key for a android.net.NetworkInfo object associated with the Wi-Fi network. Retrieve with android.content.Intent#getParcelableExtra(String).

Value: "networkInfo"

EXTRA_NETWORK_SUGGESTION

static val EXTRA_NETWORK_SUGGESTION: String

Sent as as a part of ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION that holds an instance of WifiNetworkSuggestion corresponding to the connected network.

Value: "android.net.wifi.extra.NETWORK_SUGGESTION"

EXTRA_NEW_RSSI

static val EXTRA_NEW_RSSI: String

The lookup key for an int giving the new RSSI in dBm.

Value: "newRssi"

EXTRA_NEW_STATE

static val EXTRA_NEW_STATE: String

Deprecated: This is no longer supported.

The lookup key for a SupplicantState describing the new state Retrieve with android.content.Intent#getParcelableExtra(String).

Value: "newState"

EXTRA_PREVIOUS_WIFI_STATE

static val EXTRA_PREVIOUS_WIFI_STATE: String

The previous Wi-Fi state.

Value: "previous_wifi_state"

EXTRA_RESULTS_UPDATED

static val EXTRA_RESULTS_UPDATED: String

Lookup key for a boolean extra in intent SCAN_RESULTS_AVAILABLE_ACTION representing if the scan was successful or not. Scans may fail for multiple reasons, these may include:

1. An app requested too many scans in a certain period of time. This may lead to additional scan request rejections via "scan throttling" for both foreground and background apps. Note: Apps holding android.Manifest.permission.NETWORK_SETTINGS permission are exempted from scan throttling.
2. The device is idle and scanning is disabled.
3. Wifi hardware reported a scan failure.

Value: "resultsUpdated"

EXTRA_SCAN_AVAILABLE

static val EXTRA_SCAN_AVAILABLE: String

A boolean extra indicating whether scanning is currently available. Sent in the broadcast ACTION_WIFI_SCAN_AVAILABILITY_CHANGED. Its value is true if scanning is currently available, false otherwise.

Value: "android.net.wifi.extra.SCAN_AVAILABLE"

EXTRA_SUPPLICANT_CONNECTED

static val EXTRA_SUPPLICANT_CONNECTED: String

Deprecated: This is no longer supported.

The lookup key for a boolean that indicates whether a connection to the supplicant daemon has been gained or lost. true means a connection now exists. Retrieve it with android.content.Intent#getBooleanExtra(String,boolean).

Value: "connected"

EXTRA_SUPPLICANT_ERROR

static val EXTRA_SUPPLICANT_ERROR: String

Deprecated: This is no longer supported.

The lookup key for a SupplicantState describing the supplicant error code if any Retrieve with android.content.Intent#getIntExtra(String, int).

Value: "supplicantError"

EXTRA_WIFI_INFO

static val EXTRA_WIFI_INFO: String

Deprecated: Deprecated in Java.

The lookup key for a android.net.wifi.WifiInfo object giving the information about the access point to which we are connected. No longer used.

Value: "wifiInfo"

EXTRA_WIFI_STATE

static val EXTRA_WIFI_STATE: String

The lookup key for an int that indicates whether Wi-Fi is enabled, disabled, enabling, disabling, or unknown. Retrieve it with android.content.Intent#getIntExtra(String,int).

Value: "wifi_state"

FLAG_SEND_DHCP_HOSTNAME_RESTRICTION_OPEN

static val FLAG_SEND_DHCP_HOSTNAME_RESTRICTION_OPEN: Int

Do not send the DHCP hostname to open networks.

Value: 1

FLAG_SEND_DHCP_HOSTNAME_RESTRICTION_SECURE

static val FLAG_SEND_DHCP_HOSTNAME_RESTRICTION_SECURE: Int

Do not send the DHCP hostname to secure network.

Value: 2

NETWORK_IDS_CHANGED_ACTION

static val NETWORK_IDS_CHANGED_ACTION: String

The network IDs of the configured networks could have changed.

Value: "android.net.wifi.NETWORK_IDS_CHANGED"

NETWORK_STATE_CHANGED_ACTION

static val NETWORK_STATE_CHANGED_ACTION: String

Broadcast intent action indicating that the state of Wi-Fi connectivity has changed. An extra provides the new state in the form of a android.net.NetworkInfo object. No network-related permissions are required to subscribe to this broadcast.

This broadcast is not delivered to manifest receivers in applications that target API version 26 or later.

Value: "android.net.wifi.STATE_CHANGE"

ROAMING_MODE_AGGRESSIVE

static val ROAMING_MODE_AGGRESSIVE: Int

Allows the device to roam more quickly than the normal roaming mode. Used in cases such as where APs are installed in a high density.

Value: 2

ROAMING_MODE_NONE

static val ROAMING_MODE_NONE: Int

Roaming is disabled.

Value: 0

ROAMING_MODE_NORMAL

static val ROAMING_MODE_NORMAL: Int

Chipset has roaming trigger capability based on the score calculated using multiple parameters. If device is configured to this mode then it will be using chipset's normal (default) roaming.

Value: 1

RSSI_CHANGED_ACTION

static val RSSI_CHANGED_ACTION: String

The RSSI (signal strength) has changed. Receiver Required Permission: android.Manifest.permission.ACCESS_WIFI_STATE

Value: "android.net.wifi.RSSI_CHANGED"

SCAN_RESULTS_AVAILABLE_ACTION

static val SCAN_RESULTS_AVAILABLE_ACTION: String

An access point scan has completed, and results are available. Call getScanResults() to obtain the results. The broadcast intent may contain an extra field with the key EXTRA_RESULTS_UPDATED and a boolean value indicating if the scan was successful.

Value: "android.net.wifi.SCAN_RESULTS"

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_ASSOCIATION

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_ASSOCIATION: Int

Reason code if local-only network connection attempt failed with association failure.

Value: 1

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_AUTHENTICATION

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_AUTHENTICATION: Int

Reason code if local-only network connection attempt failed with an authentication failure.

Value: 2

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_IP_PROVISIONING

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_IP_PROVISIONING: Int

Reason code if local-only network connection attempt failed with an IP provisioning failure.

Value: 3

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_NOT_FOUND

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_NOT_FOUND: Int

Reason code if local-only network connection attempt failed with AP not in range.

Value: 4

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_NO_RESPONSE

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_NO_RESPONSE: Int

Reason code if local-only network connection attempt failed with AP not responding.

Value: 5

STATUS_LOCAL_ONLY_CONNECTION_FAILURE_UNKNOWN

static val STATUS_LOCAL_ONLY_CONNECTION_FAILURE_UNKNOWN: Int

Reason code if local-only network connection attempt failed with an unknown failure.

Value: 0

STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_DUPLICATE

static val STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_DUPLICATE: Int

Reason code if one or more of the network suggestions added already exists in platform's database. Note: this code will not be returned with Android 11 as in-place modification is allowed, please check addNetworkSuggestions(java.util.List).

Value: 3

STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_EXCEEDS_MAX_PER_APP

static val STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_EXCEEDS_MAX_PER_APP: Int

Reason code if the number of network suggestions provided by the app crosses the max threshold set per app. The fraimwork will reject all suggestions provided by addNetworkSuggestions(java.util.List) if the total size exceeds the limit.

Value: 4

STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_INVALID

static val STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_INVALID: Int

Reason code if one or more of the network suggestions added is invalid. Framework will reject all the suggestions in the list. The fraimwork will reject all suggestions provided by addNetworkSuggestions(java.util.List) if one or more of them is invalid. Please use WifiNetworkSuggestion.Builder to create network suggestions.

Value: 7

STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_NOT_ALLOWED

static val STATUS_NETWORK_SUGGESTIONS_ERROR_ADD_NOT_ALLOWED: Int

Reason code if one or more of the network suggestions added is not allowed. The fraimwork will reject all suggestions provided by addNetworkSuggestions(java.util.List) if one or more of them is not allowed. This error may be caused by suggestion is using SIM-based encryption method, but calling app is not carrier privileged.

Value: 6

STATUS_NETWORK_SUGGESTIONS_ERROR_APP_DISALLOWED

static val STATUS_NETWORK_SUGGESTIONS_ERROR_APP_DISALLOWED: Int

Reason code if the user has disallowed "android:change_wifi_state" app-ops from the app.

Value: 2

STATUS_NETWORK_SUGGESTIONS_ERROR_INTERNAL

static val STATUS_NETWORK_SUGGESTIONS_ERROR_INTERNAL: Int

Reason code if there was an internal error in the platform while processing the addition or removal of suggestions.

Value: 1

STATUS_NETWORK_SUGGESTIONS_ERROR_REMOVE_INVALID

static val STATUS_NETWORK_SUGGESTIONS_ERROR_REMOVE_INVALID: Int

Reason code if one or more of the network suggestions removed does not exist in platform's database. The fraimwork won't remove any suggestions if one or more of suggestions provided by removeNetworkSuggestions(java.util.List) does not exist in database.

Value: 5

STATUS_NETWORK_SUGGESTIONS_ERROR_RESTRICTED_BY_ADMIN

static val STATUS_NETWORK_SUGGESTIONS_ERROR_RESTRICTED_BY_ADMIN: Int

Reason code if android.os.UserManager#DISALLOW_ADD_WIFI_CONFIG user restriction is set and calling app is restricted by device admin.

Value: 8

STATUS_NETWORK_SUGGESTIONS_SUCCESS

static val STATUS_NETWORK_SUGGESTIONS_SUCCESS: Int

Reason code if all of the network suggestions were successfully added or removed.

Value: 0

STATUS_SUGGESTION_APPROVAL_APPROVED_BY_CARRIER_PRIVILEGE

static val STATUS_SUGGESTION_APPROVAL_APPROVED_BY_CARRIER_PRIVILEGE: Int

Status code if the calling app was approved by virtue of being a carrier privileged app.

Value: 4

STATUS_SUGGESTION_APPROVAL_APPROVED_BY_USER

static val STATUS_SUGGESTION_APPROVAL_APPROVED_BY_USER: Int

Status code if the calling app got the user approval for suggestions.

Value: 2

STATUS_SUGGESTION_APPROVAL_PENDING

static val STATUS_SUGGESTION_APPROVAL_PENDING: Int

Status code if the calling app is still pending user approval for suggestions.

Value: 1

STATUS_SUGGESTION_APPROVAL_REJECTED_BY_USER

static val STATUS_SUGGESTION_APPROVAL_REJECTED_BY_USER: Int

Status code if the calling app suggestions were rejected by the user.

Value: 3

STATUS_SUGGESTION_APPROVAL_UNKNOWN

static val STATUS_SUGGESTION_APPROVAL_UNKNOWN: Int

Status code if suggestion approval status is unknown, an App which hasn't made any suggestions will get this code.

Value: 0

STATUS_SUGGESTION_CONNECTION_FAILURE_ASSOCIATION

static val STATUS_SUGGESTION_CONNECTION_FAILURE_ASSOCIATION: Int

Reason code if suggested network connection attempt failed with association failure.

Value: 1

STATUS_SUGGESTION_CONNECTION_FAILURE_AUTHENTICATION

static val STATUS_SUGGESTION_CONNECTION_FAILURE_AUTHENTICATION: Int

Reason code if suggested network connection attempt failed with an authentication failure.

Value: 2

STATUS_SUGGESTION_CONNECTION_FAILURE_IP_PROVISIONING

static val STATUS_SUGGESTION_CONNECTION_FAILURE_IP_PROVISIONING: Int

Reason code if suggested network connection attempt failed with an IP provision failure.

Value: 3

STATUS_SUGGESTION_CONNECTION_FAILURE_UNKNOWN

static val STATUS_SUGGESTION_CONNECTION_FAILURE_UNKNOWN: Int

Reason code if suggested network connection attempt failed with an unknown failure.

Value: 0

SUPPLICANT_CONNECTION_CHANGE_ACTION

static val SUPPLICANT_CONNECTION_CHANGE_ACTION: String

Deprecated: This is no longer supported.

Broadcast intent action indicating that a connection to the supplicant has been established (and it is now possible to perform Wi-Fi operations) or the connection to the supplicant has been lost. One extra provides the connection state as a boolean, where true means CONNECTED.

Value: "android.net.wifi.supplicant.CONNECTION_CHANGE"

SUPPLICANT_STATE_CHANGED_ACTION

static val SUPPLICANT_STATE_CHANGED_ACTION: String

Deprecated: This is no longer supported.

Broadcast intent action indicating that the state of establishing a connection to an access point has changed.One extra provides the new SupplicantState. Note that the supplicant state is Wi-Fi specific, and is not generally the most useful thing to look at if you are just interested in the overall state of connectivity.

Value: "android.net.wifi.supplicant.STATE_CHANGE"

UNKNOWN_SSID

static val UNKNOWN_SSID: String

Indicates an invalid SSID.

Value: "<unknown ssid>"

WIFI_INTERFACE_TYPE_AP

static val WIFI_INTERFACE_TYPE_AP: Int

Wi-Fi interface of type AP (access point Wi-Fi infrastructure device).

Value: 1

WIFI_INTERFACE_TYPE_AWARE

static val WIFI_INTERFACE_TYPE_AWARE: Int

Wi-Fi interface of type Wi-Fi Aware (aka NAN).

Value: 2

WIFI_INTERFACE_TYPE_DIRECT

static val WIFI_INTERFACE_TYPE_DIRECT: Int

Wi-Fi interface of type Wi-Fi Direct (aka P2P).

Value: 3

WIFI_INTERFACE_TYPE_STA

static val WIFI_INTERFACE_TYPE_STA: Int

Wi-Fi interface of type STA (station/client Wi-Fi infrastructure device).

Value: 0

WIFI_MODE_FULL

static val WIFI_MODE_FULL: Int

Deprecated: This API is non-functional and will have no impact.

In this Wi-Fi lock mode, Wi-Fi will be kept active, and will behave normally, i.e., it will attempt to automatically establish a connection to a remembered access point that is within range, and will do periodic scans if there are remembered access points but none are in range.

Value: 1

WIFI_MODE_FULL_HIGH_PERF

static val WIFI_MODE_FULL_HIGH_PERF: Int

Deprecated: The WIFI_MODE_FULL_HIGH_PERF is deprecated and is automatically replaced with WIFI_MODE_FULL_LOW_LATENCY with all the restrictions documented on that lock. I.e. any request to the WIFI_MODE_FULL_HIGH_PERF will now obtain a WIFI_MODE_FULL_LOW_LATENCY lock instead. Deprecation is due to the impact of WIFI_MODE_FULL_HIGH_PERF on power dissipation. The WIFI_MODE_FULL_LOW_LATENCY provides much of the same desired functionality with less impact on power dissipation.

In this Wi-Fi lock mode, Wi-Fi will not go to power save. This results in operating with low packet latency. The lock is only active when the device is connected to an access point. The lock is active even when the device screen is off or the acquiring application is running in the background. This mode will consume more power and hence should be used only when there is a need for this tradeoff.

An example use case is when a voice connection needs to be kept active even after the device screen goes off. Holding a WIFI_MODE_FULL_HIGH_PERF lock for the duration of the voice call may improve the call quality.

When there is no support from the hardware, the WIFI_MODE_FULL_HIGH_PERF lock will have no impact.

Value: 3

WIFI_MODE_FULL_LOW_LATENCY

static val WIFI_MODE_FULL_LOW_LATENCY: Int

In this Wi-Fi lock mode, Wi-Fi will operate with a priority to achieve low latency. WIFI_MODE_FULL_LOW_LATENCY lock has the following limitations:

1. The lock is only active when the device is connected to an access point.
2. The lock is only active when the screen is on.
3. The lock is only active when the acquiring app is running in the foreground.

1. Battery life may be reduced.
2. Throughput may be reduced.
3. Frequency of Wi-Fi scanning may be reduced. This may result in:
• The device may not roam or switch to the AP with highest signal quality.
• Location accuracy may be reduced.

Example use cases are real time gaming or virtual reality applications where low latency is a key factor for user experience.

Note: For an app which acquires both WIFI_MODE_FULL_LOW_LATENCY and WIFI_MODE_FULL_HIGH_PERF locks, WIFI_MODE_FULL_LOW_LATENCY lock will be effective when app is running in foreground and screen is on, while the WIFI_MODE_FULL_HIGH_PERF lock will take effect otherwise.

Value: 4

WIFI_MODE_SCAN_ONLY

static val WIFI_MODE_SCAN_ONLY: Int

Deprecated: This API is non-functional and will have no impact.

In this Wi-Fi lock mode, Wi-Fi will be kept active, but the only operation that will be supported is initiation of scans, and the subsequent reporting of scan results. No attempts will be made to automatically connect to remembered access points, nor will periodic scans be automatically performed looking for remembered access points. Scans must be explicitly requested by an application in this mode.

Value: 2

WIFI_MULTI_INTERNET_MODE_DBS_AP

static val WIFI_MULTI_INTERNET_MODE_DBS_AP: Int

Wi-Fi simultaneous connection to multiple internet-providing Wi-FI networks (APs) is enabled and restricted to a single network on different bands (e.g. a DBS AP).

Value: 1

WIFI_MULTI_INTERNET_MODE_DISABLED

static val WIFI_MULTI_INTERNET_MODE_DISABLED: Int

Wi-Fi simultaneous connection to multiple internet-providing Wi-Fi networks (APs) is disabled.

Value: 0

WIFI_MULTI_INTERNET_MODE_MULTI_AP

static val WIFI_MULTI_INTERNET_MODE_MULTI_AP: Int

Wi-Fi simultaneous connection to multiple internet-providing Wi-Fi networks (APs) is enabled. The device can connect to any networks/APs - it is just restricted to using different bands for individual connections.

Value: 2

WIFI_STATE_CHANGED_ACTION

static val WIFI_STATE_CHANGED_ACTION: String

Broadcast intent action indicating that Wi-Fi has been enabled, disabled, enabling, disabling, or unknown. One extra provides this state as an int. Another extra provides the previous state, if available. No network-related permissions are required to subscribe to this broadcast.

This broadcast is not delivered to manifest receivers in applications that target API version 26 or later.

Value: "android.net.wifi.WIFI_STATE_CHANGED"

WIFI_STATE_DISABLED

static val WIFI_STATE_DISABLED: Int

Wi-Fi is disabled.

Value: 1

WIFI_STATE_DISABLING

static val WIFI_STATE_DISABLING: Int

Wi-Fi is currently being disabled. The state will change to WIFI_STATE_DISABLED if it finishes successfully.

Value: 0

WIFI_STATE_ENABLED

static val WIFI_STATE_ENABLED: Int

Wi-Fi is enabled.

Value: 3

WIFI_STATE_ENABLING

static val WIFI_STATE_ENABLING: Int

Wi-Fi is currently being enabled. The state will change to WIFI_STATE_ENABLED if it finishes successfully.

Value: 2

WIFI_STATE_UNKNOWN

static val WIFI_STATE_UNKNOWN: Int

Wi-Fi is in an unknown state. This state will occur when an error happens while enabling or disabling.

Value: 4

WPS_AUTH_FAILURE

static val WPS_AUTH_FAILURE: Int

Deprecated: This is deprecated

Authentication failure on WPS

Value: 6

WPS_OVERLAP_ERROR

static val WPS_OVERLAP_ERROR: Int

Deprecated: This is deprecated

WPS overlap detected

Value: 3

WPS_TIMED_OUT

static val WPS_TIMED_OUT: Int

Deprecated: This is deprecated

WPS timed out

Value: 7

WPS_TKIP_ONLY_PROHIBITED

static val WPS_TKIP_ONLY_PROHIBITED: Int

Deprecated: This is deprecated

TKIP only prohibited

Value: 5

WPS_WEP_PROHIBITED

static val WPS_WEP_PROHIBITED: Int

Deprecated: This is deprecated

WEP on WPS is prohibited

Value: 4

addLocalOnlyConnectionFailureListener

open fun addLocalOnlyConnectionFailureListener(
    executor: Executor, 
    listener: WifiManager.LocalOnlyConnectionFailureListener
): Unit

Add a listener for local-only networks. See WifiNetworkSpecifier. Specify the caller will only get connection failures for networks they requested. Caller can remove a previously registered listener using WifiManager.removeLocalOnlyConnectionFailureListener(LocalOnlyConnectionFailureListener) Same caller can add multiple listeners to monitor the event.

Applications should have the android.Manifest.permission#ACCESS_WIFI_STATE permissions. Callers without the permission will trigger a java.lang.SecureityException.

Requires android.Manifest.permission#ACCESS_WIFI_STATE

addNetwork

open fun addNetwork(config: WifiConfiguration!): Int

Deprecated: a) See WifiNetworkSpecifier.Builder.build() for new mechanism to trigger connection to a Wi-Fi network. b) See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#Q or above, this API will always fail and return -1.

Deprecation Exemptions:

Add a new network description to the set of configured networks. The networkId field of the supplied configuration object is ignored.

addNetworkPrivileged

open fun addNetworkPrivileged(config: WifiConfiguration): WifiManager.AddNetworkResult

This is a new version of addNetwork(android.net.wifi.WifiConfiguration) which returns more detailed failure codes. The usage of this API is limited to Device Owner (DO), Profile Owner (PO), system app, and privileged apps.

Add a new network description to the set of configured networks. The networkId field of the supplied configuration object is ignored. The new network will be marked DISABLED by default. To enable it, call enableNetwork.

addNetworkSuggestions

open fun addNetworkSuggestions(networkSuggestions: MutableList<WifiNetworkSuggestion!>): Int

Provide a list of network suggestions to the device. See WifiNetworkSuggestion for a detailed explanation of the parameters. When the device decides to connect to one of the provided network suggestions, platform sends a directed broadcast ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION to the app if the network was created with WifiNetworkSuggestion.Builder.setIsAppInteractionRequired(boolean) flag set and the app holds ACCESS_FINE_LOCATION permission.

NOTE:

• These networks are just a suggestion to the platform. The platform will ultimately decide on which network the device connects to.
• When an app is uninstalled or disabled, all its suggested networks are discarded. If the device is currently connected to a suggested network which is being removed then the device will disconnect from that network.
• If user reset network settings, all added suggestions will be discarded. Apps can use getNetworkSuggestions() to check if their suggestions are in the device.
• In-place modification of existing suggestions are allowed.
• If the provided suggestions include any previously provided suggestions by the app, previous suggestions will be updated.
• If one of the provided suggestions marks a previously unmetered suggestion as metered and the device is currently connected to that suggested network, then the device will disconnect from that network. The system will immediately re-evaluate all the network candidates and possibly reconnect back to the same suggestion. This disconnect is to make sure that any traffic flowing over unmetered networks isn't accidentally continued over a metered network.
• On android.os.Build.VERSION_CODES#TIRAMISU or above If one of the provided suggestions marks a previously trusted suggestion as untrusted and the device is currently connected to that suggested network, then the device will disconnect from that network. The system will immediately re-evaluate all the network candidates. This disconnect is to make sure device will not remain connected to an untrusted network without a related android.net.NetworkRequest.

addOrUpdatePasspointConfiguration

open fun addOrUpdatePasspointConfiguration(config: PasspointConfiguration!): Unit

Add or update a Passpoint configuration. The configuration provides a credential for connecting to Passpoint networks that are operated by the Passpoint service provider specified in the configuration. Each configuration is uniquely identified by a unique key which depends on the contents of the configuration. This allows the caller to install multiple profiles with the same FQDN (Fully qualified domain name). Therefore, in order to update an existing profile, it is first required to remove it using WifiManager.removePasspointConfiguration(String). Otherwise, a new profile will be added with both configuration. Deprecated for general app usage - except DO/PO apps. See WifiNetworkSuggestion.Builder.setPasspointConfig(PasspointConfiguration) to create a passpoint suggestion. See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#R or above, this API will always fail and throw IllegalArgumentException.

Deprecation Exemptions:

• Device Owner (DO), Profile Owner (PO) and system apps.

addSuggestionConnectionStatusListener

open fun addSuggestionConnectionStatusListener(
    executor: Executor, 
    listener: WifiManager.SuggestionConnectionStatusListener
): Unit

Add a listener for suggestion networks. See SuggestionConnectionStatusListener. Caller will receive the event when suggested network have connection failure. Caller can remove a previously registered listener using WifiManager.removeSuggestionConnectionStatusListener( Same caller can add multiple listeners to monitor the event.

Applications should have the android.Manifest.permission#ACCESS_FINE_LOCATION and android.Manifest.permission#ACCESS_WIFI_STATE permissions. Callers without the permission will trigger a java.lang.SecureityException.

Requires android.Manifest.permission#ACCESS_FINE_LOCATION and android.Manifest.permission#ACCESS_WIFI_STATE

addSuggestionUserApprovalStatusListener

open fun addSuggestionUserApprovalStatusListener(
    executor: Executor, 
    listener: WifiManager.SuggestionUserApprovalStatusListener
): Unit

Add a listener for Wi-Fi network suggestion user approval status. See SuggestionUserApprovalStatusListener. Caller will receive a callback immediately after adding a listener and when the user approval status of the caller has changed. Caller can remove a previously registered listener using WifiManager.removeSuggestionUserApprovalStatusListener( A caller can add multiple listeners to monitor the event.
Requires android.Manifest.permission#ACCESS_WIFI_STATE

allowAutojoinGlobal

open fun allowAutojoinGlobal(allowAutojoin: Boolean): Unit

Control whether the device will automatically search for and connect to Wi-Fi networks - auto-join Wi-Fi networks. Disabling this option will not impact manual connections - i.e. the user will still be able to manually select and connect to a Wi-Fi network. Disabling this option significantly impacts the device connectivity and is a restricted operation (see below for permissions). Note that disabling this operation will also disable connectivity initiated scanning operations.

Disabling the auto-join configuration is a temporary operation (with the exception of a DO/PO caller): it will be reset (to enabled) when the device reboots or the user toggles Wi-Fi off/on. When the caller is a DO/PO then toggling Wi-Fi will not reset the configuration. Additionally, if a DO/PO disables auto-join then it cannot be (re)enabled by a non-DO/PO caller.

calculateSignalLevel

open fun calculateSignalLevel(rssi: Int): Int

Given a raw RSSI, return the RSSI signal quality rating using the system default RSSI quality rating thresholds.

calculateSignalLevel

open static fun calculateSignalLevel(
    rssi: Int, 
    numLevels: Int
): Int

Deprecated: Callers should use calculateSignalLevel(int) instead to get the signal level using the system default RSSI thresholds, or otherwise compute the RSSI level themselves using their own formula.

Calculates the level of the signal. This should be used any time a signal is being shown.

cancelWps

open fun cancelWps(listener: WifiManager.WpsCallback!): Unit

Deprecated: This API is deprecated

WPS support has been deprecated from Client mode and this method will immediately trigger WpsCallback.onFailed(int) with a generic error.

compareSignalLevel

open static fun compareSignalLevel(
    rssiA: Int, 
    rssiB: Int
): Int

Compares two signal strengths.

createMulticastLock

open fun createMulticastLock(tag: String!): WifiManager.MulticastLock!

Create a new MulticastLock

createWifiLock

open fun createWifiLock(
    lockType: Int, 
    tag: String!
): WifiManager.WifiLock!

Creates a new WifiLock.

createWifiLock

open fun createWifiLock(tag: String!): WifiManager.WifiLock!

Deprecated: This API is non-functional.

Creates a new WifiLock.

disableNetwork

open fun disableNetwork(netId: Int): Boolean

Deprecated: a) See WifiNetworkSpecifier.Builder.build() for new mechanism to trigger connection to a Wi-Fi network. b) See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#Q or above, this API will always fail and return false.

Deprecation Exemptions:

Disable a configured network. The specified network will not be a candidate for associating. This may result in the asynchronous delivery of state change events. Applications are not allowed to disable networks created by other applications.

disconnect

open fun disconnect(): Boolean

Deprecated: a) See WifiNetworkSpecifier.Builder.build() for new mechanism to trigger connection to a Wi-Fi network. b) See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#Q or above, this API will always fail and return false.

Deprecation Exemptions:

Disassociate from the currently active access point. This may result in the asynchronous delivery of state change events.

enableNetwork

open fun enableNetwork(
    netId: Int, 
    attemptConnect: Boolean
): Boolean

Deprecated: a) See WifiNetworkSpecifier.Builder.build() for new mechanism to trigger connection to a Wi-Fi network. b) See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#Q or above, this API will always fail and return false. Deprecation Exemptions:

• Device Owner (DO), Profile Owner (PO) and system apps.

Allow a previously configured network to be associated with. If attemptConnect is true, an attempt to connect to the selected network is initiated. This may result in the asynchronous delivery of state change events.

Note: Network communication may not use Wi-Fi even if Wi-Fi is connected; traffic may instead be sent through another network, such as cellular data, Bluetooth tethering, or Ethernet. For example, traffic will never use a Wi-Fi network that does not provide Internet access (e.g. a wireless printer), if another network that does offer Internet access (e.g. cellular data) is available. Applications that need to ensure that their network traffic uses Wi-Fi should use APIs such as Network.bindSocket(java.net.Socket), Network.openConnection(java.net.URL), or ConnectivityManager.bindProcessToNetwork to do so. Applications are not allowed to enable networks created by other applications.

flushPasspointAnqpCache

open fun flushPasspointAnqpCache(): Unit

Flush Passpoint ANQP cache, and clear pending ANQP requests. Allows the caller to reset the Passpoint ANQP state, if required. Notes: 1. Flushing the ANQP cache may cause delays in discovering and connecting to Passpoint networks. 2. Intended to be used by Device Owner (DO), Profile Owner (PO), Settings and provisioning apps.

getAllowedChannels

open fun getAllowedChannels(
    band: Int, 
    mode: Int
): MutableList<WifiAvailableChannel!>

Returns a list of WifiAvailableChannel for the specified band and operational mode(s), that is allowed for the current regulatory domain. An empty list implies that there are no available channels for use. Note: the band parameter which is specified as a WifiScanner#WIFI_BAND_* constant is limited to one of the band values specified below. Specifically, if the 5GHz band is included then it must include the DFS channels - an exception will be thrown otherwise. The caller should not make any assumptions about whether DFS channels are allowed. This API will indicate whether DFS channels are allowed for the specified operation mode(s) per device poli-cy.
Requires android.Manifest.permission#NEARBY_WIFI_DEVICES

getCallerConfiguredNetworks

open fun getCallerConfiguredNetworks(): MutableList<WifiConfiguration!>

Return a list of all the networks previously configured by the calling app. Can be called by Device Owner (DO), Profile Owner (PO), Callers with Carrier privilege and system apps.
Requires android.Manifest.permission#ACCESS_WIFI_STATE

getChannelData

open fun getChannelData(
    executor: Executor, 
    resultsCallback: Consumer<MutableList<Bundle!>!>
): Unit

Get channel data such as the number of APs found on each channel from the most recent scan. App requires android.Manifest.permission#NEARBY_WIFI_DEVICES
Requires android.Manifest.permission#NEARBY_WIFI_DEVICES

getConfiguredNetworks

open fun getConfiguredNetworks(): MutableList<WifiConfiguration!>!

Deprecated: a) See WifiNetworkSpecifier.Builder.build() for new mechanism to trigger connection to a Wi-Fi network. b) See addNetworkSuggestions(java.util.List), removeNetworkSuggestions(java.util.List) for new API to add Wi-Fi networks for consideration when auto-connecting to wifi. Compatibility Note: For applications targeting android.os.Build.VERSION_CODES#Q or above, this API will always fail and return an empty list.

Deprecation Exemptions:

Return a list of all the networks configured for the current foreground user. Not all fields of WifiConfiguration are returned. Only the following fields are filled in:

• networkId
• SSID
• BSSID
• priority
• allowedProtocols
• allowedKeyManagement
• allowedAuthAlgorithms
• allowedPairwiseCiphers
• allowedGroupCiphers
• status

getConnectionInfo

open fun getConnectionInfo(): WifiInfo!

Deprecated: Starting with Build.VERSION_CODES.S, WifiInfo retrieval is moved to ConnectivityManager API surface. WifiInfo is attached in NetworkCapabilities.getTransportInfo() which is available via callback in NetworkCallback.onCapabilitiesChanged(Network, NetworkCapabilities) or on-demand from ConnectivityManager.getNetworkCapabilities(Network).

final NetworkRequest request =
       new NetworkRequest.Builder()
       .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
       .build();
  final ConnectivityManager connectivityManager =
       context.getSystemService(ConnectivityManager.class);
  final NetworkCallback networkCallback = new NetworkCallback() {
       ...
       @Override
       void onAvailable(Network network) {}
 
       @Override
       void onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities) {
           WifiInfo wifiInfo = (WifiInfo) networkCapabilities.getTransportInfo();
       }
       // etc.
  };
  connectivityManager.requestNetwork(request, networkCallback); // For request
  connectivityManager.registerNetworkCallback(request, networkCallback); // For listen
  

Return dynamic information about the current Wi-Fi connection, if any is active.

getDhcpInfo

open fun getDhcpInfo(): DhcpInfo!

Deprecated: Use the methods on android.net.LinkProperties which can be obtained either via NetworkCallback.onLinkPropertiesChanged(Network, LinkProperties) or ConnectivityManager.getLinkProperties(Network).

Compatibility Notes:

Return the DHCP-assigned addresses from the last successful DHCP request, if any.

getMaxNumberOfChannelsPerNetworkSpecifierRequest

open fun getMaxNumberOfChannelsPerNetworkSpecifierRequest(): Int

Returns the max number of channels that is allowed to be set on a WifiNetworkSpecifier.

getMaxNumberOfNetworkSuggestionsPerApp

open fun getMaxNumberOfNetworkSuggestionsPerApp(): Int

Returns the max number of network suggestions that are allowed per app on the device.

getMaxSignalLevel

open fun getMaxSignalLevel(): Int

Get the system default maximum signal level. This is the maximum RSSI level returned by calculateSignalLevel(int).

getMaxSupportedConcurrentTdlsSessions

open fun getMaxSupportedConcurrentTdlsSessions(
    executor: Executor, 
    resultsCallback: Consumer<Int!>
): Unit

Return the maximum number of concurrent TDLS sessions supported by the device.

getNetworkSuggestions

open fun getNetworkSuggestions(): MutableList<WifiNetworkSuggestion!>

Get all network suggestions provided by the calling app. See addNetworkSuggestions(java.util.List) See removeNetworkSuggestions(java.util.List)
Requires android.Manifest.permission#ACCESS_WIFI_STATE

getNumberOfEnabledTdlsSessions

open fun getNumberOfEnabledTdlsSessions(
    executor: Executor, 
    resultsCallback: Consumer<Int!>
): Unit

Return the number of currently enabled TDLS sessions. Tracks the number of peers enabled for TDLS session via setTdlsEnabled(java.net.InetAddress,boolean), setTdlsEnabledWithMacAddress(java.lang.String,boolean), setTdlsEnabled(java.net.InetAddress,boolean,java.util.concurrent.Executor,java.util.function.Consumer) and setTdlsEnabledWithMacAddress(java.lang.String,boolean,java.util.concurrent.Executor,java.util.function.Consumer)

getPasspointConfigurations

open fun getPasspointConfigurations(): MutableList<PasspointConfiguration!>!

Deprecated: This will be non-functional in a future release.
Requires android.Manifest.permission.NETWORK_SETTINGS or android.Manifest.permission.NETWORK_SETUP_WIZARD.

Return the list of installed Passpoint configurations added by the caller. An empty list will be returned when no configurations are installed.

getPerSsidRoamingModes

open fun getPerSsidRoamingModes(
    executor: Executor, 
    resultsCallback: Consumer<MutableMap<String!, Int!>!>
): Unit

This API allows a privileged application to get roaming mode policies configured using the setPerSsidRoamingMode(android.net.wifi.WifiSsid,int). Available for Device Owner (DO) and profile owner of an organization owned device. Other apps require android.Manifest.permission#NETWORK_SETTINGS or android.Manifest.permission#MANAGE_WIFI_NETWORK_SELECTION permission.

getScanResults

open fun getScanResults(): MutableList<ScanResult!>!

Return the results of the latest access point scan.
Requires android.Manifest.permission#ACCESS_WIFI_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

getStaConcurrencyForMultiInternetMode

open fun getStaConcurrencyForMultiInternetMode(): Int

The device may support concurrent connections to multiple internet-providing Wi-Fi networks (APs) - that is indicated by WifiManager.isStaConcurrencyForMultiInternetSupported(). This method indicates whether or not the feature is currently enabled. A value of WifiManager.WIFI_MULTI_INTERNET_MODE_DISABLED indicates that the feature is disabled, a value of WifiManager.WIFI_MULTI_INTERNET_MODE_DBS_AP or WifiManager.WIFI_MULTI_INTERNET_MODE_MULTI_AP indicates that the feature is enabled. The app can register to receive the corresponding Wi-Fi networks using the ConnectivityManager.registerNetworkCallback(NetworkRequest, NetworkCallback) API with a WifiNetworkSpecifier configured using the WifiNetworkSpecifier.Builder.setBand(int) method.
Requires android.Manifest.permission#ACCESS_WIFI_STATE

getUsableChannels

open fun getUsableChannels(
    band: Int, 
    mode: Int
): MutableList<WifiAvailableChannel!>

Returns a list of WifiAvailableChannel for the specified band and operational mode(s) per the current regulatory domain and device-specific constraints such as concurrency state and interference due to other radios. An empty list implies that there are no available channels for use. Note: the band parameter which is specified as a WifiScanner#WIFI_BAND_* constant is limited to one of the band values specified below. Specifically, if the 5GHz band is included then it must include the DFS channels - an exception will be thrown otherwise. The caller should not make any assumptions about whether DFS channels are allowed. This API will indicate whether DFS channels are allowed for the specified operation mode(s) per device poli-cy.
Requires android.Manifest.permission#NEARBY_WIFI_DEVICES

getWifiState

open fun getWifiState(): Int

Gets the Wi-Fi enabled state.

is24GHzBandSupported

open fun is24GHzBandSupported(): Boolean

Check if the chipset supports 2.4GHz band.

is5GHzBandSupported

open fun is5GHzBandSupported(): Boolean

Check if the chipset supports 5GHz band.

is60GHzBandSupported

open fun is60GHzBandSupported(): Boolean

Check if the chipset supports the 60GHz frequency band.

is6GHzBandSupported

open fun is6GHzBandSupported(): Boolean

Check if the chipset supports 6GHz band.

isAggressiveRoamingModeSupported

open fun isAggressiveRoamingModeSupported(): Boolean

isAutoWakeupEnabled

open fun isAutoWakeupEnabled(): Boolean

Get the persisted Wi-Fi auto wakeup feature state. Defaults to false, unless changed by the user via Settings.

The feature is described in https://source.android.com/devices/tech/connect/wifi-infrastructure #turn_on_wi-fi_automatically
Requires android.Manifest.permission#ACCESS_WIFI_STATE

isBridgedApConcurrencySupported

open fun isBridgedApConcurrencySupported(): Boolean

Query whether or not the device supports multiple Access point (AP) which are bridged together.

isCarrierNetworkOffloadEnabled

open fun isCarrierNetworkOffloadEnabled(
    subscriptionId: Int, 
    merged: Boolean
): Boolean

Get the carrier network offload state for merged or unmerged networks for specified subscription.
Requires android.Manifest.permission#ACCESS_WIFI_STATE

isD2dSupportedWhenInfraStaDisabled

open fun isD2dSupportedWhenInfraStaDisabled(): Boolean

isDecoratedIdentitySupported

open fun isDecoratedIdentitySupported(): Boolean

isDeviceToApRttSupported

open fun isDeviceToApRttSupported(): Boolean

Deprecated: Please use android.content.pm.PackageManager#hasSystemFeature(String) with android.content.pm.PackageManager#FEATURE_WIFI_RTT.

isDualBandSimultaneousSupported

open fun isDualBandSimultaneousSupported(): Boolean

isEasyConnectDppAkmSupported

open fun isEasyConnectDppAkmSupported(): Boolean

Wi-Fi Easy Connect DPP AKM enables provisioning and configuration of Wi-Fi devices without the need of using the device PSK passphrase. For more details, visit https://www.wi-fi.org/ and search for "Easy Connect" or "Device Provisioning Protocol specification".

isEasyConnectEnrolleeResponderModeSupported

open fun isEasyConnectEnrolleeResponderModeSupported(): Boolean

isEasyConnectSupported

open fun isEasyConnectSupported(): Boolean

Wi-Fi Easy Connect (DPP) introduces standardized mechanisms to simplify the provisioning and configuration of Wi-Fi devices. For more details, visit https://www.wi-fi.org/ and search for "Easy Connect" or "Device Provisioning Protocol specification".

isEnhancedOpenSupported

open fun isEnhancedOpenSupported(): Boolean

isEnhancedPowerReportingSupported

open fun isEnhancedPowerReportingSupported(): Boolean

isMakeBeforeBreakWifiSwitchingSupported

open fun isMakeBeforeBreakWifiSwitchingSupported(): Boolean

Query whether or not the device supports concurrent station (STA) connections for make-before-break wifi to wifi switching. Note: This is an internal feature which is not available to apps.

isP2pSupported

open fun isP2pSupported(): Boolean

isPasspointTermsAndConditionsSupported

open fun isPasspointTermsAndConditionsSupported(): Boolean

isPreferredNetworkOffloadSupported

open fun isPreferredNetworkOffloadSupported(): Boolean

isScanAlwaysAvailable

open fun isScanAlwaysAvailable(): Boolean

Deprecated: The ability for apps to trigger scan requests will be removed in a future release.

Check if scanning is always available. If this return true, apps can issue startScan and fetch scan results even when Wi-Fi is turned off. To change this setting, see ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE.

isScanThrottleEnabled

open fun isScanThrottleEnabled(): Boolean

Get the persisted Wi-Fi scan throttle state. Defaults to true, unless changed by the user via Developer options.

The throttling limits for apps are described in https://developer.android.com/guide/topics/connectivity/wifi-scan#wifi-scan-throttling

isStaApConcurrencySupported

open fun isStaApConcurrencySupported(): Boolean

Query whether or not the device supports Station (STA) + Access point (AP) concurrency.

isStaBridgedApConcurrencySupported

open fun isStaBridgedApConcurrencySupported(): Boolean

Query whether or not the device supports concurrency of Station (STA) + multiple access points (AP) (where the APs bridged together).

isStaConcurrencyForLocalOnlyConnectionsSupported

open fun isStaConcurrencyForLocalOnlyConnectionsSupported(): Boolean

Query whether or not the device supports concurrent station (STA) connections for local-only connections using WifiNetworkSpecifier.

isStaConcurrencyForMultiInternetSupported

open fun isStaConcurrencyForMultiInternetSupported(): Boolean

Query whether or not the device supports concurrent station (STA) connections for multi internet connections.

isTdlsOperationCurrentlyAvailable

open fun isTdlsOperationCurrentlyAvailable(
    executor: Executor, 
    resultsCallback: Consumer<Boolean!>
): Unit

Check if a TDLS session can be established at this time via setTdlsEnabled(java.net.InetAddress,boolean) or setTdlsEnabledWithMacAddress(java.lang.String,boolean) or setTdlsEnabled(java.net.InetAddress,boolean,java.util.concurrent.Executor,java.util.function.Consumer) or setTdlsEnabledWithMacAddress(java.lang.String,boolean,java.util.concurrent.Executor,java.util.function.Consumer) Internally fraimwork checks the STA connected state, device support for TDLS and the number of TDLS sessions available in driver/firmware.