Wi-Fi
This document outlines the Wi-Fi related breaking changes in release v6.0.
Removed Functions and Types
The following functions and types have been removed.
- DPP:
The DPP event callback
esp_supp_dpp_event_cb_t
and event enumesp_supp_dpp_event_t
have been removed. Please use Wi-Fi events directly (e.g.WIFI_EVENT_DPP_URI_READY
,WIFI_EVENT_DPP_CFG_RECVD
,WIFI_EVENT_DPP_FAILED
).
RRM: The function
esp_rrm_send_neighbor_rep_request
has been removed. Useesp_rrm_send_neighbor_report_request
instead.- Antenna Configuration:
The functions
esp_wifi_set_ant_gpio
,esp_wifi_get_ant_gpio
,esp_wifi_set_ant
, andesp_wifi_get_ant
have been removed. Please use the equivalent functions fromesp_phy
component:esp_phy_set_ant_gpio
,esp_phy_get_ant_gpio
,esp_phy_set_ant
, andesp_phy_get_ant
.
ESP-NOW: The function
esp_wifi_config_espnow_rate
has been removed. Useesp_now_set_peer_rate_config
instead.
Removed Variables, Macros and Enum Values
Authentication Modes: The authentication modes
WIFI_AUTH_WPA3_EXT_PSK
andWIFI_AUTH_WPA3_EXT_PSK_MIXED_MODE
have been removed. UseWIFI_AUTH_WPA3_PSK
instead.Neighbor Report Event: In the
wifi_event_neighbor_report_t
structure, thereport
field has been removed. Please use then_report
field instead, which is a flexible array member.Wi-Fi Interface: The header file
components/esp_wifi/include/esp_interface.h
has been removed. Thewifi_interface_t
enum is now defined in components/esp_wifi/include/esp_wifi_types_generic.h. The enum values (e.g.WIFI_IF_STA
,WIFI_IF_AP
) are no longer defined based onESP_IF_WIFI_STA
,ESP_IF_WIFI_AP
, etc.Wi-Fi Interface Macros: The macros
ESP_IF_WIFI_STA
andESP_IF_WIFI_AP
have been removed. Please use the enum valuesWIFI_IF_STA
andWIFI_IF_AP
directly.Wi-Fi Disconnection Reasons: The disconnection reason codes
WIFI_REASON_ASSOC_EXPIRE
,WIFI_REASON_NOT_AUTHED
, andWIFI_REASON_NOT_ASSOCED
have been removed. Please useWIFI_REASON_AUTH_EXPIRE
,WIFI_REASON_CLASS2_FRAME_FROM_NONAUTH_STA
, andWIFI_REASON_CLASS3_FRAME_FROM_NONASSOC_STA
respectively.- NAN:
Field
svc_info
from structureswifi_nan_publish_cfg_t
,wifi_nan_subscribe_cfg_t
,wifi_nan_followup_params_t
,wifi_event_ndp_indication_t
,wifi_event_ndp_confirm_t
has been removed. Please use the equivalent fieldsssi
andssi_len
instead.Field
peer_svc_info
from structurewifi_event_nan_receive_t
has been removed. Please use the equivalent fieldsssi
andssi_len
instead.
FTM: Field
use_get_report_api
from structurewifi_ftm_initiator_cfg_t
and fieldftm_report_data
from structurewifi_event_ftm_report_t
has been removed. Please useesp_wifi_ftm_get_report
to fetch raw FTM report data instead.
Modified Functions and Types
The following Wi-Fi functions have been modified.
DPP: The function
esp_supp_dpp_init
no longer accepts a callback and should be called asesp_supp_dpp_init(void)
.WPS: The function
esp_wifi_wps_start
no longer accepts atimeout_ms
argument. It should now be called asesp_wifi_wps_start(void)
.NAN: The function argument
ndp_resp_needed
ofesp_wifi_nan_publish_service
has been moved to structurewifi_nan_publish_cfg_t
.