Merge branch 'docs/update_wifi_beacon_timeout_doc_v4.4' into 'release/v4.4'

docs: update wifi beacon timeout docs (v4.4)

See merge request espressif/esp-idf!19044
This commit is contained in:
Jiang Jiang Jian 2022-07-14 18:10:12 +08:00
commit c9119cbcef
2 changed files with 15 additions and 2 deletions

View File

@ -241,6 +241,11 @@ WIFI_EVENT_AP_PROBEREQRECVED
This event is disabled by default. The application can enable it via API :cpp:func:`esp_wifi_set_event_mask()`.
When this event is enabled, it will be raised each time the AP receives a probe request.
WIFI_EVENT_STA_BEACON_TIMEOUT
++++++++++++++++++++++++++++++++++++
If the station does not receive the beacon of the connected AP within the inactive time, the beacon timeout happens, the `WIFI_EVENT_STA_BEACON_TIMEOUT`_ will arise. The application can set inactive time via API :cpp:func:`esp_wifi_set_inactive_time()`.
{IDF_TARGET_NAME} Wi-Fi Station General Scenario
------------------------------------------------
Below is a "big scenario" which describes some small scenarios in Station mode:
@ -1043,10 +1048,12 @@ Another thing we need to consider is the reconnect may not connect the same AP i
Wi-Fi Beacon Timeout
---------------------------
The beacon timeout mechanism is used by {IDF_TARGET_NAME} station to detect whether the AP is alive or not. If the station continuously loses 60 beacons of the connected AP, the beacon timeout happens.
The beacon timeout mechanism is used by {IDF_TARGET_NAME} station to detect whether the AP is alive or not. If the station does not receive the beacon of the connected AP within the inactive time, the beacon timeout happens. The application can set inactive time via API :cpp:func:`esp_wifi_set_inactive_time()`.
After the beacon timeout happens, the station sends 5 probe requests to AP, it disconnects the AP and raises the event `WIFI_EVENT_STA_DISCONNECTED`_ if still no probe response or beacon is received from AP.
It should be considered that the timer used for beacon timeout will be reset during the scanning process. It means that the scan process will affect the triggering of the event `WIFI_EVENT_STA_BEACON_TIMEOUT`_.
{IDF_TARGET_NAME} Wi-Fi Configuration
-------------------------------------

View File

@ -242,6 +242,11 @@ WIFI_EVENT_AP_PROBEREQRECVED
默认情况下,此事件处于禁用状态,应用程序可以通过调用 API :cpp:func:`esp_wifi_set_event_mask()` 启用。
启用后,每当 AP 接收到 probe request 时都将引发此事件。
WIFI_EVENT_STA_BEACON_TIMEOUT
++++++++++++++++++++++++++++++++++++
如果 station 在 inactive 时间内未收到所连接 AP 的 beacon将发生 beacon 超时将引发此事件。inactive 时间通过调用函数 :cpp:func:`esp_wifi_set_inactive_time()` 设置。
{IDF_TARGET_NAME} Wi-Fi station 一般情况
------------------------------------------------
下图为 station 模式下的宏观场景,其中包含不同阶段的具体描述:
@ -975,10 +980,11 @@ Wi-Fi 重新连接
Wi-Fi beacon 超时
---------------------------
{IDF_TARGET_NAME} 使用 beacon 超时机制检测 AP 是否活跃。如果 station 连续丢失了 60 个所连接 AP 的 beacon将发生 beacon 超时。
{IDF_TARGET_NAME} 使用 beacon 超时机制检测 AP 是否活跃。如果 station 在 inactive 时间内未收到所连接 AP 的 beacon将发生 beacon 超时。inactive 时间通过调用函数 :cpp:func:`esp_wifi_set_inactive_time()` 设置。
beacon 超时发生后station 将向 AP 发送 5 个 probe request如果仍未从 AP 接收到 probe response 或 beaconstation 将与 AP 断开连接并产生 `WIFI_EVENT_STA_DISCONNECTED`_ 事件。
需要注意的是,扫描过程中会重置 beacon 超时所使用的定时器,即扫描过程会影响 `WIFI_EVENT_STA_BEACON_TIMEOUT`_ 事件的触发。
{IDF_TARGET_NAME} Wi-Fi 配置
-------------------------------------