From 594537c475fc5d6ba90b02f61cd91d08a77fb055 Mon Sep 17 00:00:00 2001
From: "C.S.M" <caosenmiao@espressif.com>
Date: Fri, 29 May 2026 15:53:48 +0800
Subject: [PATCH] doc(jpeg): Update jpeg performance on esp32s31

---
 docs/en/api-reference/peripherals/jpeg.rst    | 345 ++++++++++++------
 docs/zh_CN/api-reference/peripherals/jpeg.rst | 345 ++++++++++++------
 2 files changed, 466 insertions(+), 224 deletions(-)

diff --git a/docs/en/api-reference/peripherals/jpeg.rst b/docs/en/api-reference/peripherals/jpeg.rst
index f1d2c409cca..0ba1ffdbd45 100644
--- a/docs/en/api-reference/peripherals/jpeg.rst
+++ b/docs/en/api-reference/peripherals/jpeg.rst
@@ -233,126 +233,247 @@ Both decoder and encoder are not cause too much CPU involvement. Only header par
 JPEG decoder performance
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. list-table::
-    :header-rows: 1
-    :widths: 25 25 25 25 25
-    :align: center
+.. only:: esp32p4
 
-    * - JPEG Height
-      - JPEG Width
-      - Pixel Format in [#]_
-      - Pixel Format out [#]_
-      - Performance (fps)
-    * - 1080
-      - 1920
-      - YUV422
-      - RGB888/RGB565
-      - 48
-    * - 720
-      - 1280
-      - YUV422
-      - RGB888/RGB565
-      - 109
-    * - 480
-      - 800
-      - YUV422
-      - RGB888/RGB565
-      - 253
-    * - 480
-      - 640
-      - YUV422
-      - RGB888/RGB565
-      - 307
-    * - 480
-      - 320
-      - YUV422
-      - RGB888/RGB565
-      - 571
-    * - 720
-      - 1280
-      - GRAY
-      - GRAY
-      - 161
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
 
-.. [#] Format of the already compressed image
-.. [#] Format after decompressing
+      * - JPEG Height
+        - JPEG Width
+        - Pixel Format in [#]_
+        - Pixel Format out [#]_
+        - Performance (fps)
+      * - 1080
+        - 1920
+        - YUV422
+        - RGB888/RGB565
+        - 48
+      * - 720
+        - 1280
+        - YUV422
+        - RGB888/RGB565
+        - 109
+      * - 480
+        - 800
+        - YUV422
+        - RGB888/RGB565
+        - 253
+      * - 480
+        - 640
+        - YUV422
+        - RGB888/RGB565
+        - 307
+      * - 480
+        - 320
+        - YUV422
+        - RGB888/RGB565
+        - 571
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 161
+
+  .. [#] Format of the already compressed image
+  .. [#] Format after decompressing
+
+.. only:: esp32s31
+
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
+
+      * - JPEG Height
+        - JPEG Width
+        - Pixel Format in [#]_
+        - Pixel Format out [#]_
+        - Performance (fps)
+      * - 1080
+        - 1920
+        - YUV422
+        - RGB888/RGB565
+        - 28
+      * - 720
+        - 1280
+        - YUV422
+        - RGB888/RGB565
+        - 62
+      * - 480
+        - 800
+        - YUV422
+        - RGB888/RGB565
+        - 138
+      * - 480
+        - 320
+        - YUV422
+        - RGB888/RGB565
+        - 286
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 96
+
+  .. [#] Format of the already compressed image
+  .. [#] Format after decompressing
 
 JPEG encoder performance
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. list-table::
-    :header-rows: 1
-    :widths: 25 25 25 25 25
-    :align: center
+.. only:: esp32p4
 
-    * - JPEG Height
-      - JPEG Width
-      - Pixel Format in [#]_
-      - Pixel Format out [#]_
-      - Performance (fps)
-    * - 1080
-      - 1920
-      - RGB888
-      - YUV422
-      - 26
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV422
-      - 36
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV420
-      - 40
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV444
-      - 24
-    * - 1080
-      - 1920
-      - RGB888
-      - YUV422
-      - 26
-    * - 720
-      - 1280
-      - RGB565
-      - YUV420
-      - 88
-    * - 720
-      - 1280
-      - RGB565
-      - YUV444
-      - 55
-    * - 720
-      - 1280
-      - RGB565
-      - YUV422
-      - 81
-    * - 480
-      - 800
-      - RGB888
-      - YUV420
-      - 142
-    * - 640
-      - 800
-      - RGB888
-      - YUV420
-      - 174
-    * - 480
-      - 320
-      - RGB888
-      - YUV420
-      - 315
-    * - 720
-      - 1280
-      - GRAY
-      - GRAY
-      - 163
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
 
-.. [#] Format of Original Image
-.. [#] Down sampling method
+      * - JPEG Height
+        - JPEG Width
+        - Pixel Format in [#]_
+        - Pixel Format out [#]_
+        - Performance (fps)
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 26
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV422
+        - 36
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV420
+        - 40
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV444
+        - 24
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 26
+      * - 720
+        - 1280
+        - RGB565
+        - YUV420
+        - 88
+      * - 720
+        - 1280
+        - RGB565
+        - YUV444
+        - 55
+      * - 720
+        - 1280
+        - RGB565
+        - YUV422
+        - 81
+      * - 480
+        - 800
+        - RGB888
+        - YUV420
+        - 142
+      * - 640
+        - 800
+        - RGB888
+        - YUV420
+        - 174
+      * - 480
+        - 320
+        - RGB888
+        - YUV420
+        - 315
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 163
+
+  .. [#] Format of Original Image
+  .. [#] Down sampling method
+
+.. only:: esp32s31
+
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
+
+      * - JPEG Height
+        - JPEG Width
+        - Pixel Format in [#]_
+        - Pixel Format out [#]_
+        - Performance (fps)
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 21
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV422
+        - 21
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV420
+        - 25
+      * - 720
+        - 1280
+        - RGB565
+        - YUV420
+        - 62
+      * - 720
+        - 1280
+        - RGB565
+        - YUV422
+        - 47
+      * - 480
+        - 800
+        - RGB888
+        - YUV444
+        - 74
+      * - 480
+        - 800
+        - RGB888
+        - YUV422
+        - 108
+      * - 480
+        - 800
+        - RGB888
+        - YUV420
+        - 126
+      * - 480
+        - 320
+        - RGB888
+        - YUV444
+        - 173
+      * - 480
+        - 320
+        - RGB888
+        - YUV422
+        - 241
+      * - 480
+        - 320
+        - RGB888
+        - YUV420
+        - 273
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 92
+
+  .. [#] Format of Original Image
+  .. [#] Down sampling method
 
 .. _jpeg-pixel-storage-layout:
 
diff --git a/docs/zh_CN/api-reference/peripherals/jpeg.rst b/docs/zh_CN/api-reference/peripherals/jpeg.rst
index a832a3dcc77..fdeaf2914a0 100644
--- a/docs/zh_CN/api-reference/peripherals/jpeg.rst
+++ b/docs/zh_CN/api-reference/peripherals/jpeg.rst
@@ -233,126 +233,247 @@ JPEG 编码器引擎
 JPEG 解码器性能
 ~~~~~~~~~~~~~~~
 
-.. list-table::
-    :header-rows: 1
-    :widths: 25 25 25 25 25
-    :align: center
+.. only:: esp32p4
 
-    * - JPEG 高度
-      - JPEG 宽度
-      - 像素输入格式 [#]_
-      - 像素输出格式 [#]_
-      - 性能 (fps)
-    * - 1080
-      - 1920
-      - YUV422
-      - RGB888/RGB565
-      - 48
-    * - 720
-      - 1280
-      - YUV422
-      - RGB888/RGB565
-      - 109
-    * - 480
-      - 800
-      - YUV422
-      - RGB888/RGB565
-      - 253
-    * - 480
-      - 640
-      - YUV422
-      - RGB888/RGB565
-      - 307
-    * - 480
-      - 320
-      - YUV422
-      - RGB888/RGB565
-      - 571
-    * - 720
-      - 1280
-      - GRAY
-      - GRAY
-      - 161
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
 
-.. [#] 已压缩图像格式
-.. [#] 解压后图像格式
+      * - JPEG 高度
+        - JPEG 宽度
+        - 像素输入格式 [#]_
+        - 像素输出格式 [#]_
+        - 性能 (fps)
+      * - 1080
+        - 1920
+        - YUV422
+        - RGB888/RGB565
+        - 48
+      * - 720
+        - 1280
+        - YUV422
+        - RGB888/RGB565
+        - 109
+      * - 480
+        - 800
+        - YUV422
+        - RGB888/RGB565
+        - 253
+      * - 480
+        - 640
+        - YUV422
+        - RGB888/RGB565
+        - 307
+      * - 480
+        - 320
+        - YUV422
+        - RGB888/RGB565
+        - 571
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 161
+
+  .. [#] 已压缩图像格式
+  .. [#] 解压后图像格式
+
+.. only:: esp32s31
+
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
+
+      * - JPEG 高度
+        - JPEG 宽度
+        - 像素输入格式 [#]_
+        - 像素输出格式 [#]_
+        - 性能 (fps)
+      * - 1080
+        - 1920
+        - YUV422
+        - RGB888/RGB565
+        - 28
+      * - 720
+        - 1280
+        - YUV422
+        - RGB888/RGB565
+        - 62
+      * - 480
+        - 800
+        - YUV422
+        - RGB888/RGB565
+        - 138
+      * - 480
+        - 320
+        - YUV422
+        - RGB888/RGB565
+        - 286
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 96
+
+  .. [#] 已压缩图像格式
+  .. [#] 解压后图像格式
 
 JPEG 编码器性能
 ~~~~~~~~~~~~~~~
 
-.. list-table::
-    :header-rows: 1
-    :widths: 25 25 25 25 25
-    :align: center
+.. only:: esp32p4
 
-    * - JPEG 高度
-      - JPEG 宽度
-      - 像素输入格式 [#]_
-      - 像素输出格式 [#]_
-      - 性能 (fps)
-    * - 1080
-      - 1920
-      - RGB888
-      - YUV422
-      - 26
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV422
-      - 36
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV420
-      - 40
-    * - 1080
-      - 1920
-      - RGB565
-      - YUV444
-      - 24
-    * - 1080
-      - 1920
-      - RGB888
-      - YUV422
-      - 26
-    * - 720
-      - 1280
-      - RGB565
-      - YUV420
-      - 88
-    * - 720
-      - 1280
-      - RGB565
-      - YUV444
-      - 55
-    * - 720
-      - 1280
-      - RGB565
-      - YUV422
-      - 81
-    * - 480
-      - 800
-      - RGB888
-      - YUV420
-      - 142
-    * - 640
-      - 800
-      - RGB888
-      - YUV420
-      - 174
-    * - 480
-      - 320
-      - RGB888
-      - YUV420
-      - 315
-    * - 720
-      - 1280
-      - GRAY
-      - GRAY
-      - 163
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
 
-.. [#] 原图格式
-.. [#] 下采样法
+      * - JPEG 高度
+        - JPEG 宽度
+        - 像素输入格式 [#]_
+        - 像素输出格式 [#]_
+        - 性能 (fps)
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 26
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV422
+        - 36
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV420
+        - 40
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV444
+        - 24
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 26
+      * - 720
+        - 1280
+        - RGB565
+        - YUV420
+        - 88
+      * - 720
+        - 1280
+        - RGB565
+        - YUV444
+        - 55
+      * - 720
+        - 1280
+        - RGB565
+        - YUV422
+        - 81
+      * - 480
+        - 800
+        - RGB888
+        - YUV420
+        - 142
+      * - 640
+        - 800
+        - RGB888
+        - YUV420
+        - 174
+      * - 480
+        - 320
+        - RGB888
+        - YUV420
+        - 315
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 163
+
+  .. [#] 原图格式
+  .. [#] 下采样法
+
+.. only:: esp32s31
+
+  .. list-table::
+      :header-rows: 1
+      :widths: 25 25 25 25 25
+      :align: center
+
+      * - JPEG 高度
+        - JPEG 宽度
+        - 像素输入格式 [#]_
+        - 像素输出格式 [#]_
+        - 性能 (fps)
+      * - 1080
+        - 1920
+        - RGB888
+        - YUV422
+        - 21
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV422
+        - 21
+      * - 1080
+        - 1920
+        - RGB565
+        - YUV420
+        - 25
+      * - 720
+        - 1280
+        - RGB565
+        - YUV420
+        - 62
+      * - 720
+        - 1280
+        - RGB565
+        - YUV422
+        - 47
+      * - 480
+        - 800
+        - RGB888
+        - YUV444
+        - 74
+      * - 480
+        - 800
+        - RGB888
+        - YUV422
+        - 108
+      * - 480
+        - 800
+        - RGB888
+        - YUV420
+        - 126
+      * - 480
+        - 320
+        - RGB888
+        - YUV444
+        - 173
+      * - 480
+        - 320
+        - RGB888
+        - YUV422
+        - 241
+      * - 480
+        - 320
+        - RGB888
+        - YUV420
+        - 273
+      * - 720
+        - 1280
+        - GRAY
+        - GRAY
+        - 92
+
+  .. [#] 原图格式
+  .. [#] 下采样法
 
 .. _jpeg-pixel-storage-layout: