summaryrefslogtreecommitdiff
path: root/_sources
diff options
context:
space:
mode:
Diffstat (limited to '_sources')
-rw-r--r--_sources/demo/usbd_cdc_acm.rst.txt8
-rw-r--r--_sources/index.rst.txt1
-rw-r--r--_sources/quick_start/usb_speed.rst.txt27
3 files changed, 28 insertions, 8 deletions
diff --git a/_sources/demo/usbd_cdc_acm.rst.txt b/_sources/demo/usbd_cdc_acm.rst.txt
index 5ae3568c..758c9e73 100644
--- a/_sources/demo/usbd_cdc_acm.rst.txt
+++ b/_sources/demo/usbd_cdc_acm.rst.txt
@@ -98,13 +98,5 @@ CDC ACM Device
}
- 上述我们需要注意,长度设置为 2048 是为了测试 ZLP 功能,通常实际使用时,接收长度应该使用 CDC_MAX_MPS 。具体原因参考 :ref:`usb_ext`
-- 如果需要做性能测试,使用 tools/test_srcipts/test_cdc_speed.py 进行测试,并在测试之前删除 `usbd_cdc_acm_bulk_out` 和 `usbd_cdc_acm_bulk_in` 中的打印,否则会影响测试结果。
-
-测试命令如下:
-
-.. code-block:: python
-
- python test_cdc_speed.py --port COM17 --mode tx --chunk-length 4M
- python test_cdc_speed.py --port COM17 --mode rx --chunk-length 4M
.. note:: 对于 CDC ACM 搭配 OS 的情况,通常我们 read 使用异步并将数据存储到 ringbuffer 中,write 使用同步搭配 sem 使用。 \ No newline at end of file
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt
index f524fe42..6e3b2f4a 100644
--- a/_sources/index.rst.txt
+++ b/_sources/index.rst.txt
@@ -59,6 +59,7 @@ CherryUSB 是一个小而美的、可移植性高的、用于嵌入式系统的
quick_start/q&a
quick_start/migration
quick_start/opensource
+ quick_start/usb_speed
.. toctree::
:maxdepth: 1
diff --git a/_sources/quick_start/usb_speed.rst.txt b/_sources/quick_start/usb_speed.rst.txt
new file mode 100644
index 00000000..24a43c3c
--- /dev/null
+++ b/_sources/quick_start/usb_speed.rst.txt
@@ -0,0 +1,27 @@
+USB 极限速度测试
+======================
+
+在 tools 中我们提供了一个 USB 极限速度测试工具,帮助用户测试 USB 设备的传输速度。该工具可以测量 USB 设备在不同条件下的读写速度,并生成详细的测试报告。
+
+- test_cdc_speed.c + libusb_winusb_device_for_speed.c
+
+该工具主要使用 libusb 进行测试,因此,需要保证本地文件需要有 libusb 库和头文件,device 使用 winusb,因为如果使用 cdc acm,则需要进行驱动转换。使用如下:
+
+.. code-block:: C
+
+ #默认已经提供 test_cdc_speed.exe
+
+ gcc -O2 -o test_cdc_speed.exe .\test_cdc_speed.c .\libusb-1.0.dll.a -I. -lm
+ .\test_cdc_speed.exe --vendor 0xFFFF --product 0xFFFF --interface 0 --mode tx --chunk-length 4M
+ .\test_cdc_speed.exe --vendor 0xFFFF --product 0xFFFF --interface 0 --mode rx --chunk-length 4M
+
+- test_cdc_speed.py
+
+该工具主要使用 pyserial 进行测试,因此,需要保证已经安装 pyserial 库。使用如下:
+
+.. code-block:: C
+
+ python test_cdc_speed.py --port COM6 --mode tx --chunk-length 4M
+ python test_cdc_speed.py --port COM6 --mode rx --chunk-length 4M
+
+.. note:: python 测试 TX 和 libusb 基本相同,rx 会略低于 libusb,主要原因是因为 pyserial 读取后会放到缓存中,多一次拷贝导致 \ No newline at end of file