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_tand event enumesp_supp_dpp_event_thave 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_requesthas been removed. Useesp_rrm_send_neighbor_report_requestinstead.- Antenna Configuration:
The functions
esp_wifi_set_ant_gpio,esp_wifi_get_ant_gpio,esp_wifi_set_ant, andesp_wifi_get_anthave been removed. Please use the equivalent functions fromesp_phycomponent: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_ratehas been removed. Useesp_now_set_peer_rate_configinstead.
Removed Variables, Macros and Enum Values
Authentication Modes: The authentication modes
WIFI_AUTH_WPA3_EXT_PSKandWIFI_AUTH_WPA3_EXT_PSK_MIXED_MODEhave been removed. UseWIFI_AUTH_WPA3_PSKinstead.Neighbor Report Event: In the
wifi_event_neighbor_report_tstructure, thereportfield has been removed. Please use then_reportfield instead, which is a flexible array member.Wi-Fi Interface: The header file
components/esp_wifi/include/esp_interface.hhas been removed. Thewifi_interface_tenum 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_STAandESP_IF_WIFI_APhave been removed. Please use the enum valuesWIFI_IF_STAandWIFI_IF_APdirectly.Wi-Fi Disconnection Reasons: The disconnection reason codes
WIFI_REASON_ASSOC_EXPIRE,WIFI_REASON_NOT_AUTHED, andWIFI_REASON_NOT_ASSOCEDhave been removed. Please useWIFI_REASON_AUTH_EXPIRE,WIFI_REASON_CLASS2_FRAME_FROM_NONAUTH_STA, andWIFI_REASON_CLASS3_FRAME_FROM_NONASSOC_STArespectively.- NAN:
Field
svc_infofrom structureswifi_nan_publish_cfg_t,wifi_nan_subscribe_cfg_t,wifi_nan_followup_params_t,wifi_event_ndp_indication_t,wifi_event_ndp_confirm_thas been removed. Please use the equivalent fieldsssiandssi_leninstead.Field
peer_svc_infofrom structurewifi_event_nan_receive_thas been removed. Please use the equivalent fieldsssiandssi_leninstead.
FTM: Field
use_get_report_apifrom structurewifi_ftm_initiator_cfg_tand fieldftm_report_datafrom structurewifi_event_ftm_report_thas been removed. Please useesp_wifi_ftm_get_reportto fetch raw FTM report data instead.
Modified Functions and Types
The following Wi-Fi functions have been modified.
DPP: The function
esp_supp_dpp_initno longer accepts a callback and should be called asesp_supp_dpp_init(void).WPS: The function
esp_wifi_wps_startno longer accepts atimeout_msargument. It should now be called asesp_wifi_wps_start(void).NAN: The function argument
ndp_resp_neededofesp_wifi_nan_publish_servicehas been moved to structurewifi_nan_publish_cfg_t.