Merge branch 'contrib/github_pr_9694' into 'master'

add low power doc and picture (GitHub PR) Closes IDFGH-8201 See merge request espressif/esp-idf!20675
espressif · Jul 19, 2023 · 0ac1ee4 · 0ac1ee4
2 parents 1b6ef8a + b24bc1c
commit 0ac1ee4
Show file tree

Hide file tree

Showing 51 changed files with 1,639 additions and 0 deletions.
diff --git a/docs/_static/Low-power-DFS-current.png b/docs/_static/Low-power-DFS-current.png
diff --git a/docs/_static/Low-power-DFS-modem-current.png b/docs/_static/Low-power-DFS-modem-current.png
diff --git a/docs/_static/Low-power-DFS-process.png b/docs/_static/Low-power-DFS-process.png
diff --git a/docs/_static/Low-power-DTIM4.png b/docs/_static/Low-power-DTIM4.png
diff --git a/docs/_static/Low-power-WiFi-base-current.png b/docs/_static/Low-power-WiFi-base-current.png
diff --git a/docs/_static/Low-power-auto-light-sleep-current.png b/docs/_static/Low-power-auto-light-sleep-current.png
diff --git a/docs/_static/Low-power-auto-light-sleep-process.png b/docs/_static/Low-power-auto-light-sleep-process.png
diff --git a/docs/_static/Low-power-deep-sleep-current.png b/docs/_static/Low-power-deep-sleep-current.png
diff --git a/docs/_static/Low-power-deep-sleep-process.png b/docs/_static/Low-power-deep-sleep-process.png
diff --git a/docs/_static/Low-power-modem-current.png b/docs/_static/Low-power-modem-current.png
diff --git a/docs/_static/Low-power-modem-process.png b/docs/_static/Low-power-modem-process.png
diff --git a/docs/_static/Low-power-time.png b/docs/_static/Low-power-time.png
diff --git a/docs/_static/Low-power-wifi-auto-light-current.png b/docs/_static/Low-power-wifi-auto-light-current.png
diff --git a/docs/_static/Low-power-wifi-auto-light-process.png b/docs/_static/Low-power-wifi-auto-light-process.png
diff --git a/docs/en/api-guides/sleep-current/esp32_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32_summary.inc b/docs/en/api-guides/sleep-current/esp32_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32_summary.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c2_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32c2_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c2_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c2_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32c2_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c2_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c2_summary.inc b/docs/en/api-guides/sleep-current/esp32c2_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c2_summary.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c3_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32c3_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c3_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c3_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32c3_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c3_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c3_summary.inc b/docs/en/api-guides/sleep-current/esp32c3_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c3_summary.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c6_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32c6_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c6_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c6_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32c6_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c6_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32c6_summary.inc b/docs/en/api-guides/sleep-current/esp32c6_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32c6_summary.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s2_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32s2_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s2_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s2_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32s2_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s2_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s2_summary.inc b/docs/en/api-guides/sleep-current/esp32s2_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s2_summary.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s3_light_sleep.inc b/docs/en/api-guides/sleep-current/esp32s3_light_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s3_light_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s3_modem_sleep.inc b/docs/en/api-guides/sleep-current/esp32s3_modem_sleep.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s3_modem_sleep.inc
diff --git a/docs/en/api-guides/sleep-current/esp32s3_summary.inc b/docs/en/api-guides/sleep-current/esp32s3_summary.inc
@@ -0,0 +1 @@
+.. include:: ../../../zh_CN/api-guides/sleep-current/esp32s3_summary.inc
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32_light_sleep.inc b/docs/zh_CN/api-guides/sleep-current/esp32_light_sleep.inc
@@ -0,0 +1,27 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20  10 20 20 20
+
+  * - CPU frequency
+    - DTIM
+    - Average current(mA)
+    - Max current(mA)
+    - Min current(mA)
+
+  * - 160 MHz
+    - 1
+    - 3.34
+    - 129.36
+    - 1.35
+
+  * - 160 MHz
+    - 3
+    - 2.33
+    - 130.17
+    - 1.33
+
+  * - 160 MHz
+    - 10
+    - 2.19
+    - 129.87
+    - 1.32
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32_modem_sleep.inc b/docs/zh_CN/api-guides/sleep-current/esp32_modem_sleep.inc
@@ -0,0 +1,52 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20 10 10 20 20 20
+
+  * - CPU frequency
+    - DFS
+    - DTIM
+    - Average current(mA)
+    - Max current(mA)
+    - Min current(mA)
+
+  * - 160 MHz
+    - ON
+    - 1
+    - 22.65
+    - 133.03
+    - 5.48
+
+  * - 160 MHz
+    - OFF
+    - 1
+    - 31.12
+    - 253.74
+    - 27.18
+
+  * - 160 MHz
+    - ON
+    - 3
+    - 21.89
+    - 247.68
+    - 5.25
+
+  * - 160 MHz
+    - OFF
+    - 3
+    - 28.81
+    - 209.42
+    - 27.77
+
+  * - 160 MHz
+    - ON
+    - 10
+    - 20.01
+    - 216.51
+    - 6.02
+
+  * - 160 MHz
+    - OFF
+    - 10
+    - 29.66
+    - 114.17
+    - 27.77
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32_summary.inc b/docs/zh_CN/api-guides/sleep-current/esp32_summary.inc
@@ -0,0 +1,69 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20  20 30 20 20
+
+  * - 项目
+    - Modem Sleep
+    - Modem Sleep+DFS
+    - auto light Sleep
+    - Deep Sleep
+
+  * - 休眠
+    - 自动
+    - 自动
+    - 自动
+    - 手动
+
+  * - 唤醒
+    - 自动
+    - 自动
+    - 自动
+    - 配置唤醒源
+
+  * - Wi-Fi连接
+    - 保持
+    - 保持
+    - 保持
+    - 断开
+
+  * - CPU
+    - 开
+    - 开/降频
+    - 暂停
+    - 关
+
+  * - 系统时钟
+    - 开
+    - 开
+    - 关
+    - 关
+
+  * - 外设
+    - 开
+    - 开
+    - 开
+    - 关
+
+  * - DTIM1
+    - 31.12 mA
+    - 22.65 mA
+    - 3.34 mA
+    - /
+
+  * - DTIM3
+    - 28.81 mA
+    - 21.89 mA
+    - 2.33 mA
+    - /
+
+  * - DTIM10
+    - 29.66 mA
+    - 20.01 mA
+    - 2.19 mA
+    - /
+
+  * - 平均电流
+    - /
+    - /
+    - /
+    - 5 μA
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32c2_light_sleep.inc b/docs/zh_CN/api-guides/sleep-current/esp32c2_light_sleep.inc
@@ -0,0 +1,27 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20  10 20 20 20
+
+  * - CPU frequency
+    - DTIM
+    - Average current(mA)
+    - Max current(mA)
+    - Min current(mA)
+
+  * - 120 MHz
+    - 1
+    - 1.6
+    - 67.8
+    - 0.12
+
+  * - 120 MHz
+    - 3
+    - 0.71
+    - 66.5
+    - 0.12
+
+  * - 120 MHz
+    - 10
+    - 0.39
+    - 64.8
+    - 0.12
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32c2_modem_sleep.inc b/docs/zh_CN/api-guides/sleep-current/esp32c2_modem_sleep.inc
@@ -0,0 +1,52 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20 10 10 20 20 20
+
+  * - CPU frequency
+    - DFS
+    - DTIM
+    - Average current(mA)
+    - Max current(mA)
+    - Min current(mA)
+
+  * - 120 MHz
+    - ON
+    - 1
+    - 7.5
+    - 65.9
+    - 6.0
+
+  * - 120 MHz
+    - OFF
+    - 1
+    - 13.6
+    - 221.5
+    - 12.6
+
+  * - 120 MHz
+    - ON
+    - 3
+    - 6.9
+    - 65.4
+    - 6.0
+
+  * - 120 MHz
+    - OFF
+    - 3
+    - 13.0
+    - 220.2
+    - 12.6
+
+  * - 120 MHz
+    - ON
+    - 10
+    - 6.6
+    - 64.9
+    - 6.0
+
+  * - 120 MHz
+    - OFF
+    - 10
+    - 12.9
+    - 216.8
+    - 12.6
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32c2_summary.inc b/docs/zh_CN/api-guides/sleep-current/esp32c2_summary.inc
@@ -0,0 +1,69 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20  20 30 20 20
+
+  * - 项目
+    - Modem Sleep
+    - Modem Sleep+DFS
+    - auto light Sleep
+    - Deep Sleep
+
+  * - 休眠
+    - 自动
+    - 自动
+    - 自动
+    - 手动
+
+  * - 唤醒
+    - 自动
+    - 自动
+    - 自动
+    - 配置唤醒源
+
+  * - Wi-Fi连接
+    - 保持
+    - 保持
+    - 保持
+    - 断开
+
+  * - CPU
+    - 开
+    - 开/降频
+    - 暂停
+    - 关
+
+  * - 系统时钟
+    - 开
+    - 开
+    - 关
+    - 关
+
+  * - 外设
+    - 开
+    - 开
+    - 开
+    - 关
+
+  * - DTIM1
+    - 13.6
+    - 7.5
+    - 1.6
+    - /
+
+  * - DTIM3
+    - 13.0
+    - 6.9
+    - 0.71
+    - /
+
+  * - DTIM10
+    - 12.9
+    - 6.6
+    - 0.39
+    - /
+
+  * - 平均电流
+    - /
+    - /
+    - /
+    - 4.9 μA
diff --git a/docs/zh_CN/api-guides/sleep-current/esp32c3_light_sleep.inc b/docs/zh_CN/api-guides/sleep-current/esp32c3_light_sleep.inc
@@ -0,0 +1,27 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 20  10 20 20 20
+
+  * - CPU frequency
+    - DTIM
+    - Average current(mA)
+    - Max current(mA)
+    - Min current(mA)
+
+  * - 160 MHz
+    - 1
+    - 1.4
+    - 87.26
+    - 0.14
+
+  * - 160 MHz
+    - 3
+    - 0.62
+    - 86.33
+    - 0.14
+
+  * - 160 MHz
+    - 10
+    - 0.31
+    - 86.11
+    - 0.14
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		.. include:: ../../../zh_CN/api-guides/sleep-current/esp32_light_sleep.inc