[PATCH v5 5/8] docs/zh_CN: Add dwc3.rst translation

Updated
From:Kefan Bai <baikefan@leap-io-kernel.com>
Date:
Message-ID:<2db4262245b49fcc25e50f2f82ad7a617c04a32f.1765180570.git.baikefan@leap-io-kernel.com>
Patch:v5 · 5/8
Language:zh_CN
Patch-ID:f140c709c089d3ac3e9357d888d838511f4dd9d6
Files:Documentation/translations/zh_CN/usb/dwc3.rstDocumentation/translations/zh_CN/usb/index.rst

Patch content 2 changed files

Translate .../usb/dwc3.rst into Chinese Update the translation through commit ecefae6db042("docs: usb: rename files to .rst and add them to drivers-api") Reviewed-by: Yanteng Si <siyanteng@cqsoftware.com.cn>Signed-off-by: Kefan Bai <baikefan@leap-io-kernel.com>--- Documentation/translations/zh_CN/usb/dwc3.rst | 60 +++++++++++++++++++ .../translations/zh_CN/usb/index.rst          |  2 +- 2 files changed, 61 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/usb/dwc3.rst diff --git a/Documentation/translations/zh_CN/usb/dwc3.rst b/Documentation/translations/zh_CN/usb/dwc3.rstnew file mode 100644index 000000000000..700aee545559--- /dev/null+++ b/Documentation/translations/zh_CN/usb/dwc3.rst@@ -0,0 +1,60 @@+.. SPDX-License-Identifier: GPL-2.0+.. include:: ../disclaimer-zh_CN.rst++:Original: Documentation/usb/dwc3.rst+:翻译:++ 白钶凡 Kefan Bai <baikefan@leap-io-kernel.com>++:校译:++++==========+DWC3 驱动+==========+++待完成+~~~~~~++在你阅读时可以随便挑点儿东西做 :)++- 将中断处理程序转换为基于每端点线程的IRQ++  事实证明,一些DWC3命令大约需要~1ms才能完成。+  当前代码会一直自旋等待命令完成,这是不好的设计。++  实现思路:++  - DWC core实现了一个用于按端点解复用中断的IRQ控制器。中断号在+    probe阶段分配,并归属于该设备。如果硬件通过MSI为每个端点+    提供独立的中断,那么这个虚拟的IRQ控制器就可以被硬件真实的端点+    中断所取代。++  - 在调用usb_ep_enable()时会申请和分配中断资源,+    在调用usb_ep_disable()时会释放中断资源。+    最差的情况是32个中断,最少为ep0/1的两个中断。+  - dwc3_send_gadget_ep_cmd()将在wait_for_completion_timeout()中休眠到命令完成。+  - 中断处理程序分为以下几个部分:++    - 设备的中断处理主程序+      遍历每个事件,对其调用generic_handle_irq()。+      在generic_handle_irq()返回后,确认事件计数器,最终完成中断处理。++    - 设备的中断处理线程+      无++    - EP中断的处理主程序+      读取事件并尝试处理它。所有需要休眠的操作都交给线程处理。+      事件保存在每个端点的数据结构中。+      需要注意:一旦把事件交给线程去处理,就要注意不要自己再去处理它,+      否则可能会导致低优先级的事件先于高优先级事件被处理。++    - EP中断的处理线程+      处理剩余的EP工作,这些工作可能会导致休眠,例如等待命令完成。++  延迟:++   不应该增加延迟,因为中断线程具有较高优先级,会在用户空间普通任务之前运行+   (除非用户更改了调度优先级)。diff --git a/Documentation/translations/zh_CN/usb/index.rst b/Documentation/translations/zh_CN/usb/index.rstindex 6b7706e7df9f..e90465f0dc69 100644--- a/Documentation/translations/zh_CN/usb/index.rst+++ b/Documentation/translations/zh_CN/usb/index.rst@@ -20,10 +20,10 @@ USB 支持     acm     authorization     chipidea+    dwc3  Todolist: -*   dwc3 *   ehci *   usbmon *   functionfs--2.52.0