mirror of
https://github.com/espressif/esp-idf.git
synced 2025-08-27 10:24:04 +00:00
48 lines
1.8 KiB
ReStructuredText
48 lines
1.8 KiB
ReStructuredText
Wi-Fi
|
|
======
|
|
|
|
:link_to_translation:`zh_CN:[中文]`
|
|
|
|
|
|
Wi-Fi Scan and Connect
|
|
------------------------
|
|
|
|
The following types have been modified:
|
|
|
|
- :component_file:`esp_wifi/include/esp_wifi_he_types.h`
|
|
|
|
- :cpp:struct:`esp_wifi_htc_omc_t`:
|
|
|
|
- ``uph_id``, ``ul_pw_headroom``, ``min_tx_pw_flag`` are deprecated.
|
|
|
|
- :component_file:`esp_wifi/include/esp_wifi_types_generic.h`
|
|
|
|
- :cpp:struct:`wifi_ap_record_t`:
|
|
|
|
- The type of ``bandwidth`` has been changed from ``uint8_t`` to ``wifi_bandwidth_t``
|
|
|
|
Breaking Changes
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Wi-Fi Authentication Mode Changes for WPA3-Enterprise
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
In ESP-IDF versions prior to v5.4, the authentication mode (``wifi_auth_mode_t``) for Access Points (APs) supporting WPA3-Enterprise-Only and WPA3-Enterprise-Transition was identified as ``WIFI_AUTH_WPA2_ENTERPRISE``.
|
|
|
|
Starting from v5.4, this behavior has been updated:
|
|
|
|
- APs supporting **WPA3-Enterprise-Only** mode are now detected with ``wifi_auth_mode_t`` set to ``WIFI_AUTH_WPA3_ENTERPRISE``.
|
|
- APs supporting **WPA3-Enterprise-Transition** mode are detected with ``wifi_auth_mode_t`` set to ``WIFI_AUTH_WPA2_WPA3_ENTERPRISE``.
|
|
|
|
.. note::
|
|
|
|
**Impact on Applications**
|
|
|
|
If your application strictly checks for ``WIFI_AUTH_WPA2_ENTERPRISE`` or ``WIFI_AUTH_ENTERPRISE`` to identify enterprise APs, it will not recognize APs operating in WPA3-Enterprise-Only or WPA3-Enterprise-Transition modes.
|
|
|
|
**Recommended Action**
|
|
|
|
To ensure compatibility with these modes, update your application's authentication mode checks to include the new ``WIFI_AUTH_WPA3_ENTERPRISE`` and ``WIFI_AUTH_WPA2_WPA3_ENTERPRISE`` modes.
|
|
|
|
This may involve updating conditional statements or authentication procedures to account for ``WIFI_AUTH_WPA3_ENTERPRISE`` and ``WIFI_AUTH_WPA2_WPA3_ENTERPRISE``.
|