wifi_mgmt.h File Reference

WiFi L2 stack public header. More...

#include <zephyr/net/net_mgmt.h>
#include <zephyr/net/wifi.h>
#include <zephyr/net/ethernet.h>
#include <zephyr/net/offloaded_netdev.h>
#include <zephyr/net/net_if.h>

Go to the source code of this file.

Data Structures
struct	wifi_version
	Wi-Fi version. More...
struct	wifi_band_channel
	Wi-Fi structure to uniquely identify a band-channel pair. More...
struct	wifi_scan_params
	Wi-Fi scan parameters structure. More...
struct	wifi_scan_result
	Wi-Fi scan result, each result is provided to the net_mgmt_event_callback via its info attribute (see net_mgmt.h) More...
struct	wifi_connect_req_params
	Wi-Fi connect request parameters. More...
struct	wifi_status
	Generic Wi-Fi status for commands and events. More...
struct	wifi_iface_status
	Wi-Fi interface status. More...
struct	wifi_ps_params
	Wi-Fi power save parameters. More...
struct	wifi_btwt_params
	Wi-Fi broadcast TWT parameters. More...
struct	wifi_twt_params
	Wi-Fi TWT parameters. More...
struct	wifi_twt_flow_info
	Wi-Fi TWT flow information. More...
struct	wifi_enterprise_creds_params
	Wi-Fi enterprise mode credentials. More...
struct	wifi_ps_config
	Wi-Fi power save configuration. More...
struct	wifi_11k_params
	Wi-Fi 11k parameters. More...
struct	wifi_reg_chan_info
	Per-channel regulatory attributes. More...
struct	wifi_reg_domain
	Regulatory domain information or configuration. More...
struct	wifi_raw_scan_result
	Wi-Fi raw scan result. More...
struct	wifi_ap_sta_info
	AP mode - connected STA details. More...
struct	wifi_mode_info
	Wi-Fi mode setup. More...
struct	wifi_filter_info
	Wi-Fi filter setting for monitor, prmoiscuous, TX-injection modes. More...
struct	wifi_channel_info
	Wi-Fi channel setting for monitor and TX-injection modes. More...
struct	wifi_ap_config_params
	Wi-Fi AP configuration parameter. More...
struct	wifi_config_params
	Wi-Fi STA configuration parameter. More...
struct	wifi_wps_config_params
	Wi-Fi wps setup. More...
struct	wifi_bgscan_params
	Wi-Fi background scan parameters. More...
struct	wifi_mgmt_ops
	Wi-Fi management API. More...
struct	net_wifi_mgmt_offload
	Wi-Fi management offload API. More...

Macros
#define	NET_REQUEST_WIFI_SCAN    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_SCAN)
	Request a Wi-Fi scan.
#define	NET_REQUEST_WIFI_CONNECT    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_CONNECT)
	Request a Wi-Fi connect.
#define	NET_REQUEST_WIFI_DISCONNECT    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_DISCONNECT)
	Request a Wi-Fi disconnect.
#define	NET_REQUEST_WIFI_AP_ENABLE    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_ENABLE)
	Request a Wi-Fi access point enable.
#define	NET_REQUEST_WIFI_AP_DISABLE    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_DISABLE)
	Request a Wi-Fi access point disable.
#define	NET_REQUEST_WIFI_AP_RTS_THRESHOLD    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_RTS_THRESHOLD)
	Request a Wi-Fi RTS threshold.
#define	NET_REQUEST_WIFI_IFACE_STATUS    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_IFACE_STATUS)
	Request a Wi-Fi network interface status.
#define	NET_REQUEST_WIFI_11K_CONFIG    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_11K_CONFIG)
#define	NET_REQUEST_WIFI_11K_NEIGHBOR_REQUEST    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_11K_NEIGHBOR_REQUEST)
#define	NET_REQUEST_WIFI_PS    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS)
	Request a Wi-Fi power save.
#define	NET_REQUEST_WIFI_TWT    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_TWT)
	Request a Wi-Fi TWT.
#define	NET_REQUEST_WIFI_BTWT    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_BTWT)
#define	NET_REQUEST_WIFI_PS_CONFIG    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS_CONFIG)
	Request a Wi-Fi power save configuration.
#define	NET_REQUEST_WIFI_REG_DOMAIN    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_REG_DOMAIN)
	Request a Wi-Fi regulatory domain.
#define	NET_REQUEST_WIFI_MODE    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_MODE)
	Request current Wi-Fi mode.
#define	NET_REQUEST_WIFI_PACKET_FILTER    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PACKET_FILTER)
	Request Wi-Fi packet filter.
#define	NET_REQUEST_WIFI_CHANNEL    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_CHANNEL)
	Request a Wi-Fi channel.
#define	NET_REQUEST_WIFI_AP_STA_DISCONNECT    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_STA_DISCONNECT)
	Request a Wi-Fi access point to disconnect a station.
#define	NET_REQUEST_WIFI_VERSION    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_VERSION)
	Request a Wi-Fi version.
#define	NET_REQUEST_WIFI_CONN_PARAMS    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_CONN_PARAMS)
	Request a Wi-Fi connection parameters.
#define	NET_REQUEST_WIFI_RTS_THRESHOLD    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_RTS_THRESHOLD)
	Request a Wi-Fi RTS threshold.
#define	NET_REQUEST_WIFI_AP_CONFIG_PARAM    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_CONFIG_PARAM)
	Request a Wi-Fi AP parameters configuration.
#define	NET_REQUEST_WIFI_CONFIG_PARAM    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_CONFIG_PARAM)
	Request a Wi-Fi STA parameters configuration.
#define	NET_REQUEST_WIFI_BTM_QUERY   (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_BTM_QUERY)
	Request a Wi-Fi BTM query.
#define	NET_REQUEST_WIFI_PMKSA_FLUSH    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PMKSA_FLUSH)
	Request a Wi-Fi PMKSA cache entries flush.
#define	NET_REQUEST_WIFI_ENTERPRISE_CREDS    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_ENTERPRISE_CREDS)
	Set Wi-Fi enterprise mode CA/client Cert and key.
#define	NET_REQUEST_WIFI_RTS_THRESHOLD_CONFIG    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_RTS_THRESHOLD_CONFIG)
	Request a Wi-Fi RTS threshold configuration.
#define	NET_REQUEST_WIFI_WPS_CONFIG   (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_WPS_CONFIG)
#define	NET_REQUEST_WIFI_START_ROAMING    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_START_ROAMING)
#define	NET_REQUEST_WIFI_NEIGHBOR_REP_COMPLETE    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_NEIGHBOR_REP_COMPLETE)
#define	NET_REQUEST_WIFI_BSS_MAX_IDLE_PERIOD    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_BSS_MAX_IDLE_PERIOD)
#define	NET_REQUEST_WIFI_BGSCAN    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_BGSCAN)
#define	NET_REQUEST_WIFI_P2P_OPER    (NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_P2P_OPER)
#define	NET_EVENT_WIFI_SCAN_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_SCAN_RESULT)
	Event emitted for Wi-Fi scan result.
#define	NET_EVENT_WIFI_SCAN_DONE    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_SCAN_DONE)
	Event emitted when Wi-Fi scan is done.
#define	NET_EVENT_WIFI_CONNECT_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_CONNECT_RESULT)
	Event emitted for Wi-Fi connect result.
#define	NET_EVENT_WIFI_DISCONNECT_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_DISCONNECT_RESULT)
	Event emitted for Wi-Fi disconnect result.
#define	NET_EVENT_WIFI_IFACE_STATUS    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_IFACE_STATUS)
	Event emitted for Wi-Fi network interface status.
#define	NET_EVENT_WIFI_TWT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_TWT)
	Event emitted for Wi-Fi TWT information.
#define	NET_EVENT_WIFI_TWT_SLEEP_STATE    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_TWT_SLEEP_STATE)
	Event emitted for Wi-Fi TWT sleep state.
#define	NET_EVENT_WIFI_RAW_SCAN_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_RAW_SCAN_RESULT)
	Event emitted for Wi-Fi raw scan result.
#define	NET_EVENT_WIFI_DISCONNECT_COMPLETE    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_DISCONNECT_COMPLETE)
	Event emitted Wi-Fi disconnect is completed.
#define	NET_EVENT_WIFI_SIGNAL_CHANGE    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_SIGNAL_CHANGE)
	Event signal change of connected AP.
#define	NET_EVENT_WIFI_NEIGHBOR_REP_COMP    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_NEIGHBOR_REP_COMPLETE)
	Event Neighbor Report Completed.
#define	NET_EVENT_WIFI_AP_ENABLE_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_AP_ENABLE_RESULT)
	Event emitted for Wi-Fi access point enable result.
#define	NET_EVENT_WIFI_AP_DISABLE_RESULT    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_AP_DISABLE_RESULT)
	Event emitted for Wi-Fi access point disable result.
#define	NET_EVENT_WIFI_AP_STA_CONNECTED    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_AP_STA_CONNECTED)
	Event emitted when Wi-Fi station is connected in AP mode.
#define	NET_EVENT_WIFI_AP_STA_DISCONNECTED    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_AP_STA_DISCONNECTED)
	Event emitted Wi-Fi station is disconnected from AP.
#define	NET_EVENT_WIFI_P2P_DEVICE_FOUND    (NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_P2P_DEVICE_FOUND)
	Event emitted for P2P device found event.
#define	WIFI_BTWT_AGREEMENT_MAX   5
#define	MAX_REG_CHAN_NUM   42
	Max regulatory channel number.
#define	WIFI_WPS_PIN_MAX_LEN   8

Typedefs
typedef void(*	scan_result_cb_t) (struct net_if *iface, int status, struct wifi_scan_result *entry)
	Scan result callback.

Enumerations
enum	net_request_wifi_cmd {   NET_REQUEST_WIFI_CMD_SCAN = 1 , NET_REQUEST_WIFI_CMD_CONNECT , NET_REQUEST_WIFI_CMD_DISCONNECT , NET_REQUEST_WIFI_CMD_AP_ENABLE ,   NET_REQUEST_WIFI_CMD_AP_DISABLE , NET_REQUEST_WIFI_CMD_AP_RTS_THRESHOLD , NET_REQUEST_WIFI_CMD_IFACE_STATUS , NET_REQUEST_WIFI_CMD_11K_CONFIG ,   NET_REQUEST_WIFI_CMD_11K_NEIGHBOR_REQUEST , NET_REQUEST_WIFI_CMD_PS , NET_REQUEST_WIFI_CMD_TWT , NET_REQUEST_WIFI_CMD_BTWT ,   NET_REQUEST_WIFI_CMD_PS_CONFIG , NET_REQUEST_WIFI_CMD_REG_DOMAIN , NET_REQUEST_WIFI_CMD_MODE , NET_REQUEST_WIFI_CMD_PACKET_FILTER ,   NET_REQUEST_WIFI_CMD_CHANNEL , NET_REQUEST_WIFI_CMD_AP_STA_DISCONNECT , NET_REQUEST_WIFI_CMD_VERSION , NET_REQUEST_WIFI_CMD_CONN_PARAMS ,   NET_REQUEST_WIFI_CMD_RTS_THRESHOLD , NET_REQUEST_WIFI_CMD_AP_CONFIG_PARAM , NET_REQUEST_WIFI_CMD_CONFIG_PARAM , NET_REQUEST_WIFI_CMD_DPP ,   NET_REQUEST_WIFI_CMD_BTM_QUERY , NET_REQUEST_WIFI_CMD_PMKSA_FLUSH , NET_REQUEST_WIFI_CMD_ENTERPRISE_CREDS , NET_REQUEST_WIFI_CMD_RTS_THRESHOLD_CONFIG ,   NET_REQUEST_WIFI_CMD_WPS_CONFIG , NET_REQUEST_WIFI_CMD_START_ROAMING , NET_REQUEST_WIFI_CMD_NEIGHBOR_REP_COMPLETE , NET_REQUEST_WIFI_CMD_CANDIDATE_SCAN ,   NET_REQUEST_WIFI_CMD_AP_WPS_CONFIG , NET_REQUEST_WIFI_CMD_BSS_MAX_IDLE_PERIOD , NET_REQUEST_WIFI_CMD_BGSCAN , NET_REQUEST_WIFI_CMD_P2P_OPER }
	Wi-Fi management commands. More...
enum	net_event_wifi_cmd {   NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) ,   NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) ,   NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) ,   NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) ,   NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) , NET_MGMT_CMD =(NET_EVENT_WIFI_CMD_SCAN_RESULT) }
	Wi-Fi management events. More...
enum	wifi_disconn_reason {   WIFI_REASON_DISCONN_SUCCESS = 0 , WIFI_REASON_DISCONN_UNSPECIFIED , WIFI_REASON_DISCONN_USER_REQUEST , WIFI_REASON_DISCONN_AP_LEAVING ,   WIFI_REASON_DISCONN_INACTIVITY }
	Wi-Fi disconnect reason codes. More...
enum	wifi_ap_status {   WIFI_STATUS_AP_SUCCESS = 0 , WIFI_STATUS_AP_FAIL , WIFI_STATUS_AP_CHANNEL_NOT_SUPPORTED , WIFI_STATUS_AP_CHANNEL_NOT_ALLOWED ,   WIFI_STATUS_AP_SSID_NOT_ALLOWED , WIFI_STATUS_AP_AUTH_TYPE_NOT_SUPPORTED , WIFI_STATUS_AP_OP_NOT_SUPPORTED , WIFI_STATUS_AP_OP_NOT_PERMITTED }
	Wi-Fi AP mode result codes. More...
enum	wifi_mgmt_op { WIFI_MGMT_GET = 0 , WIFI_MGMT_SET = 1 }
	Generic get/set operation for any command. More...
enum	wifi_twt_sleep_state { WIFI_TWT_STATE_SLEEP = 0 , WIFI_TWT_STATE_AWAKE = 1 }
	Wi-Fi TWT sleep states. More...
enum	wifi_wps_op { WIFI_WPS_PBC = 0 , WIFI_WPS_PIN_GET = 1 , WIFI_WPS_PIN_SET = 2 }
	Operation for WPS. More...
enum	wifi_sap_iface_state {   WIFI_SAP_IFACE_UNINITIALIZED , WIFI_SAP_IFACE_DISABLED , WIFI_SAP_IFACE_COUNTRY_UPDATE , WIFI_SAP_IFACE_ACS ,   WIFI_SAP_IFACE_HT_SCAN , WIFI_SAP_IFACE_DFS , WIFI_SAP_IFACE_NO_IR , WIFI_SAP_IFACE_ENABLED }
	Wi-Fi AP status. More...
enum	wifi_bgscan_type { WIFI_BGSCAN_NONE = 0 , WIFI_BGSCAN_SIMPLE , WIFI_BGSCAN_LEARN }
	Wi-Fi background scan implementation. More...
enum	wifi_ext_capab {   WIFI_EXT_CAPAB_20_40_COEX = 0 , WIFI_EXT_CAPAB_GLK = 1 , WIFI_EXT_CAPAB_EXT_CHAN_SWITCH = 2 , WIFI_EXT_CAPAB_TIM_BROADCAST = 18 ,   WIFI_EXT_CAPAB_BSS_TRANSITION = 19 }

Functions
void	wifi_mgmt_raise_connect_result_event (struct net_if *iface, int status)
	Wi-Fi management connect result event.
void	wifi_mgmt_raise_disconnect_result_event (struct net_if *iface, int status)
	Wi-Fi management disconnect result event.
void	wifi_mgmt_raise_iface_status_event (struct net_if *iface, struct wifi_iface_status *iface_status)
	Wi-Fi management interface status event.
void	wifi_mgmt_raise_twt_event (struct net_if *iface, struct wifi_twt_params *twt_params)
	Wi-Fi management TWT event.
void	wifi_mgmt_raise_twt_sleep_state (struct net_if *iface, int twt_sleep_state)
	Wi-Fi management TWT sleep state event.
void	wifi_mgmt_raise_raw_scan_result_event (struct net_if *iface, struct wifi_raw_scan_result *raw_scan_info)
	Wi-Fi management raw scan result event.
void	wifi_mgmt_raise_disconnect_complete_event (struct net_if *iface, int status)
	Wi-Fi management disconnect complete event.
void	wifi_mgmt_raise_ap_enable_result_event (struct net_if *iface, enum wifi_ap_status status)
	Wi-Fi management AP mode enable result event.
void	wifi_mgmt_raise_ap_disable_result_event (struct net_if *iface, enum wifi_ap_status status)
	Wi-Fi management AP mode disable result event.
void	wifi_mgmt_raise_ap_sta_connected_event (struct net_if *iface, struct wifi_ap_sta_info *sta_info)
	Wi-Fi management AP mode STA connected event.
void	wifi_mgmt_raise_ap_sta_disconnected_event (struct net_if *iface, struct wifi_ap_sta_info *sta_info)
	Wi-Fi management AP mode STA disconnected event.

Detailed Description

WiFi L2 stack public header.