diff --git a/docs/en/api-guides/wifi.rst b/docs/en/api-guides/wifi.rst index 21136cf56b..dc4a7b4056 100644 --- a/docs/en/api-guides/wifi.rst +++ b/docs/en/api-guides/wifi.rst @@ -10,7 +10,7 @@ Wi-Fi Driver - Support WPA/WPA2/WPA3/WPA2-Enterprise and WPS - Support AMPDU, HT40, QoS and other key features - Support Modem-sleep -- Support an Espressif-specific protocol which, in turn, supports up to **1 km** of data traffic +- Support the Espressif-specific ESP-NOW protocol and Long Range mode, which supports up to **1 km** of data traffic - Up to 20 MBit/s TCP throughput and 30 MBit/s UDP throughput over the air - Support Sniffer - Support both fast scan and all-channel scan @@ -1560,6 +1560,50 @@ The table below shows the best throughput results we got in Espressif's lab and When the throughput is tested by iperf example, the sdkconfig is :idf_file:`examples/wifi/iperf/sdkconfig.defaults.esp32c3`. +.. only:: esp32s3 + + .. list-table:: + :header-rows: 1 + :widths: 10 10 10 15 20 + + * - Type/Throughput + - Air In Lab + - Shield-box + - Test Tool + - IDF Version (commit ID) + * - Raw 802.11 Packet RX + - N/A + - **130 MBit/s** + - Internal tool + - NA + * - Raw 802.11 Packet TX + - N/A + - **130 MBit/s** + - Internal tool + - NA + * - UDP RX + - 30 MBit/s + - 88 MBit/s + - iperf example + - 15575346 + * - UDP TX + - 30 MBit/s + - 98 MBit/s + - iperf example + - 15575346 + * - TCP RX + - 20 MBit/s + - 73 MBit/s + - iperf example + - 15575346 + * - TCP TX + - 20 MBit/s + - 83 MBit/s + - iperf example + - 15575346 + + When the throughput is tested by iperf example, the sdkconfig is :idf_file:`examples/wifi/iperf/sdkconfig.defaults.esp32s3`. + Wi-Fi 80211 Packet Send --------------------------- @@ -1859,9 +1903,9 @@ Wi-Fi Fragment supports Wi-Fi receiving fragment, but doesn't support Wi-Fi transmitting fragment. -.. only:: esp32c3 +.. only:: esp32c3 or esp32s3 - ESP32C3 supports Wi-Fi receiving and transmitting fragment. + {IDF_TARGET_NAME} supports Wi-Fi receiving and transmitting fragment. WPS Enrollee ------------------------- @@ -1984,10 +2028,32 @@ Increasing the size or number of the buffers mentioned above properly can improv **CACHE:** - :ref:`CONFIG_ESP32S2_INSTRUCTION_CACHE_SIZE` - Configure the size of the instruction cache. + Configure the size of the instruction Cache. - :ref:`CONFIG_ESP32S2_INSTRUCTION_CACHE_LINE_SIZE` - Configure the width of the instruction cache bus. + Configure the width of the instruction Cache bus. + +.. only:: esp32s3 + + **CACHE:** + + - :ref:`CONFIG_ESP32S3_INSTRUCTION_CACHE_SIZE` + Configure the size of the instruction Cache. + + - :ref:`CONFIG_ESP32S3_INSTRUCTION_CACHE_LINE_SIZE` + Configure the size of the instruction Cache bus. + + - :ref:`CONFIG_ESP32S3_ICACHE_ASSOCIATED_WAYS` + Configure the associated ways of the instruction Cache. + + - :ref:`CONFIG_ESP32S3_DATA_CACHE_SIZE` + Configure the size of the Data Cache. + + - :ref:`CONFIG_ESP32S3_DATA_CACHE_LINE_SIZE` + Configure the line size of the Data Cache. + + - :ref:`CONFIG_ESP32S3_DCACHE_ASSOCIATED_WAYS` + Configure the associated ways of the Data Cache. .. note:: The buffer size mentioned above is fixed as 1.6 KB. @@ -2199,7 +2265,7 @@ The parameters not mentioned in the following table should be set to the default - **Minimum rank** This is the minimum configuration rank of {IDF_TARGET_NAME}. The protocol stack only uses the necessary memory for running. It is suitable for scenarios that have no requirement for performance and the application requires lots of space. -.. only:: esp32c3 +.. only:: esp32c3 or esp32s3 **Ranks:** diff --git a/docs/zh_CN/api-guides/wifi.rst b/docs/zh_CN/api-guides/wifi.rst index 397b55fd5b..dd114c6c7b 100644 --- a/docs/zh_CN/api-guides/wifi.rst +++ b/docs/zh_CN/api-guides/wifi.rst @@ -1387,6 +1387,50 @@ AP 睡眠 使用 iperf example 测试吞吐量时，sdkconfig 是 :idf_file:` 示例/wifi/iperf/sdkconfig.defaults.esp32c3`。 +.. only:: esp32s3 + + .. list-table:: + :header-rows: 1 + :widths: 10 10 10 15 20 + + * - 类型/吞吐量 + - 实验室空气状况 + - 屏蔽箱 + - 测试工具 + - IDF 版本 (commit ID) + * - 原始 802.11 数据包接收数据 + - N/A + - **130 MBit/s** + - 内部工具 + - N/A + * - 原始 802.11 数据包发送数据 + - N/A + - **130 MBit/s** + - 内部工具 + - N/A + * - UDP 接收数据 + - 30 MBit/s + - 88 MBit/s + - iperf example + - 15575346 + * - UDP 发送数据 + - 30 MBit/s + - 98 MBit/s + - iperf example + - 15575346 + * - TCP 接收数据 + - 20 MBit/s + - 73 MBit/s + - iperf example + - 15575346 + * - TCP 发送数据 + - 20 MBit/s + - 83 MBit/s + - iperf example + - 15575346 + + 使用 iperf example 测试吞吐量时，sdkconfig 是 :idf_file:` 示例/wifi/iperf/sdkconfig.defaults.esp32s3`。 + Wi-Fi 80211 数据包发送 --------------------------- @@ -1664,9 +1708,9 @@ Wi-Fi 分片 支持 Wi-Fi 接收分片，但不支持 Wi-Fi 发送分片。 -.. only:: esp32c3 +.. only:: esp32c3 or esp32s3 - ESP32C3 支持 Wi-Fi 接收和发送分片。 + {IDF_TARGET_NAME} 支持 Wi-Fi 接收和发送分片。 WPS 注册 ------------------------- @@ -1794,6 +1838,28 @@ Wi-Fi 使用的堆内存峰值是 Wi-Fi 驱动程序 **理论上消耗的最大 - :ref:`CONFIG_ESP32S2_INSTRUCTION_CACHE_LINE_SIZE` 配置指令缓存总线的宽度。 +.. only:: esp32s3 + + **缓存：** + + - :ref:`CONFIG_ESP32S3_INSTRUCTION_CACHE_SIZE` + 配置指令缓存的大小。 + + - :ref:`CONFIG_ESP32S3_INSTRUCTION_CACHE_LINE_SIZE` + 配置指令缓存总线的宽度。 + + - :ref:`CONFIG_ESP32S3_ICACHE_ASSOCIATED_WAYS` + 配置指令缓存相连方式. + + - :ref:`CONFIG_ESP32S3_DATA_CACHE_SIZE` + 配置数据缓存的大小. + + - :ref:`CONFIG_ESP32S3_DATA_CACHE_LINE_SIZE` + 配置数据缓存行大小. + + - :ref:`CONFIG_ESP32S3_DCACHE_ASSOCIATED_WAYS` + 配置数据缓存相连方式. + .. note:: 上述的缓冲区大小固定为 1.6 KB。 @@ -2002,7 +2068,7 @@ Wi-Fi 使用的堆内存峰值是 Wi-Fi 驱动程序 **理论上消耗的最大 - **最小等级** {IDF_TARGET_NAME} 的最小配置等级。协议栈只使用运行所需的内存。适用于对性能没有要求，而应用程序需要大量内存的场景。 -.. only:: esp32c3 +.. only:: esp32c3 or esp32s3 **等级：**