docs: add performance show

Signed-off-by: sakumisu <[email protected]>

14 files changed, 72 insertions, 0 deletions

diff --git a/docs/source/show/img/usbdev_msc.png b/docs/source/show/img/usbdev_msc.png
new file mode 100644
index 00000000..30f22383
--- /dev/null
+++ b/docs/source/show/img/usbdev_msc.png
diff --git a/docs/source/show/img/usbdev_rndis_linux.png b/docs/source/show/img/usbdev_rndis_linux.png
new file mode 100644
index 00000000..94b97312
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_linux.png
diff --git a/docs/source/show/img/usbdev_rndis_lwip.png b/docs/source/show/img/usbdev_rndis_lwip.png
new file mode 100644
index 00000000..f4cfd0b3
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_lwip.png
diff --git a/docs/source/show/img/usbdev_rndis_lwip2.png b/docs/source/show/img/usbdev_rndis_lwip2.png
new file mode 100644
index 00000000..3fde91f9
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_lwip2.png
diff --git a/docs/source/show/img/usbdev_rndis_wifi.png b/docs/source/show/img/usbdev_rndis_wifi.png
new file mode 100644
index 00000000..d6817876
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_wifi.png
diff --git a/docs/source/show/img/usbdev_rndis_wifi2.png b/docs/source/show/img/usbdev_rndis_wifi2.png
new file mode 100644
index 00000000..dba9f3dd
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_wifi2.png
diff --git a/docs/source/show/img/usbdev_rndis_win.png b/docs/source/show/img/usbdev_rndis_win.png
new file mode 100644
index 00000000..4a46dd46
--- /dev/null
+++ b/docs/source/show/img/usbdev_rndis_win.png
diff --git a/docs/source/show/img/usbhost_msc.png b/docs/source/show/img/usbhost_msc.png
new file mode 100644
index 00000000..ec546a8d
--- /dev/null
+++ b/docs/source/show/img/usbhost_msc.png
diff --git a/docs/source/show/img/usbhost_msc_xhci.png b/docs/source/show/img/usbhost_msc_xhci.png
new file mode 100644
index 00000000..084250f2
--- /dev/null
+++ b/docs/source/show/img/usbhost_msc_xhci.png
diff --git a/docs/source/show/img/usbhost_rndis.png b/docs/source/show/img/usbhost_rndis.png
new file mode 100644
index 00000000..75adba38
--- /dev/null
+++ b/docs/source/show/img/usbhost_rndis.png
diff --git a/docs/source/show/img/usbhost_rndis2.png b/docs/source/show/img/usbhost_rndis2.png
new file mode 100644
index 00000000..86aea3c4
--- /dev/null
+++ b/docs/source/show/img/usbhost_rndis2.png
diff --git a/docs/source/show/img/usbhost_uvc.gif b/docs/source/show/img/usbhost_uvc.gif
new file mode 100644
index 00000000..c4df04e0
--- /dev/null
+++ b/docs/source/show/img/usbhost_uvc.gif
diff --git a/docs/source/show/img/usbhost_wifi.png b/docs/source/show/img/usbhost_wifi.png
new file mode 100644
index 00000000..e57fd85b
--- /dev/null
+++ b/docs/source/show/img/usbhost_wifi.png
diff --git a/docs/source/show/index.rst b/docs/source/show/index.rst
new file mode 100644
index 00000000..f9966805
--- /dev/null
+++ b/docs/source/show/index.rst
@@ -0,0 +1,72 @@
+性能展示
+==============================
+
+以下演示了 CherryUSB 在不同应用中的性能表现。主要演示高速模式，全速看不出什么性能差异。
+
+CDC 通信
+----------------
+
+可以达到硬件极限性能，当然需要硬件理论支持到这速度，CherryUSB 就支持到这速度,举例如下：
+
+- HPM 系列(从机可以到 42MB/S, 主机 44MB/S, 已经达到硬件极限)
+- BL 系列（从机 32MB/S, 主机 25MB/S, 已经达到硬件极限）
+- STM32F4 全速（从机 900KB/S, 主机 1.12MB/S, 已经达到硬件极限）
+
+从机测速demo: cdc_acm_template.c 并且关闭 log，脚本使用 `tools/test_srcipts/test_cdc_speed.py`
+主机测速demo: usb_host.c 中 TEST_USBH_CDC_SPEED=1
+
+
+USB Device MSC
+-----------------
+
+演示 USB Device MSC 使用 SDXC3.0 + EMMC 测试。
+
+.. figure:: img/usbdev_msc.png
+
+USB Device RNDIS
+-----------------------
+
+.. note:: 默认 rndis 仅支持单包，因此下面速度为最低速度。多包支持需要联系作者。
+
+演示 USB Device RNDIS 局域网下搭配 lwip 的速度。
+
+作为 client
+
+.. figure:: img/usbdev_rndis_lwip.png
+
+作为 server
+
+.. figure:: img/usbdev_rndis_lwip2.png
+
+演示 USB Device RNDIS + WIFI 透传测试。
+
+.. figure:: img/usbdev_rndis_wifi.png
+.. figure:: img/usbdev_rndis_wifi2.png
+
+演示 USB Device RNDIS + 百兆以太网透传测试。
+
+.. figure:: img/usbdev_rndis_win.png
+.. figure:: img/usbdev_rndis_linux.png
+
+
+USB Host MSC
+-----------------------
+
+演示 USB Host MSC 在 USB2.0 和 USB3.0 下的速度，U盘推荐使用固态测试。
+
+.. figure:: img/usbhost_msc.png
+.. figure:: img/usbhost_msc_xhci.png
+
+USB Host UVC
+-----------------------
+
+演示 USB Host UVC 驱动 648 * 480 YUV 摄像头。FPS 30。
+
+.. figure:: img/usbhost_uvc.gif
+
+USB Host WIFI
+-----------------------
+
+演示 USB Host 驱动 BL616 USB WIFI。
+
+.. figure:: img/usbhost_wifi.png