Merge branch 'bugfix/fix_some_wifi_bugs_230403_v4.4' into 'release/v4.4'

esp_wifi: fix some wifi bugs 230403(Backport v4.4) See merge request espressif/esp-idf!23049
espressif · Apr 10, 2023 · 43a38fc · 43a38fc
2 parents b7ddd82 + 4b3ff10
commit 43a38fc
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 4 deletions.
diff --git a/components/esp_wifi/lib b/components/esp_wifi/lib
diff --git a/docs/en/api-guides/wifi.rst b/docs/en/api-guides/wifi.rst
@@ -1273,7 +1273,9 @@ API :cpp:func:`esp_wifi_set_config()` can be used to configure the station. And
 | channel          | If the channel is 0, the station scans the channel 1 ~ N to  |
 |                  | search for the target AP; otherwise, the station starts by   |
 |                  | scanning the channel whose value is the same as that of the  |
-|                  | "channel" field, and then scans others to find the target AP.|
+|                  | "channel" field, and then scans the channel 1 ~ N but skip   |
+|                  | the specific channel to find the target AP. For example, if  |
+|                  | the channel is 3, the scan order will be 3, 1, 2, 4,..., N.  |
 |                  | If you do not know which channel the target AP is running on,|
 |                  | set it to 0.                                                 |
 +------------------+--------------------------------------------------------------+

diff --git a/docs/zh_CN/api-guides/wifi.rst b/docs/zh_CN/api-guides/wifi.rst
@@ -1227,8 +1227,9 @@ API :cpp:func:`esp_wifi_set_config()` 可用于配置 station。配置的参数
 | bssid       | 只有当 bssid_set 为 1 时有效。见字段 "bssid_set"。                        |
 +-------------+---------------------------------------------------------------------------+
 | channel     | 该字段为 0 时，station 扫描信道 1~N 寻找目标 AP；否则，station            |
-|             | 首先扫描值与 "channel" 字段相同的信道，再扫描其他信道。如果您不知道目标   |
-|             | AP 在哪个信道，请将该字段设置为 0。                                       |
+|             | 首先扫描值与 "channel" 字段相同的信道，再扫描其他信道。比如，当该字段设置 |
+|             | 为 3 时，扫描顺序为 3，1，2，4,...，N。如果您不知道目标 AP 在哪个信道，   |
+|             | 请将该字段设置为 0。                                                      |
 +-------------+---------------------------------------------------------------------------+
 | sort_method | 该字段仅用于 WIFI_ALL_CHANNEL_SCAN 模式。如果设置为                       |
 |             | WIFI_CONNECT_AP_BY_SIGNAL，所有匹配的 AP                                  |