From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-m49221.qiye.163.com (mail-m49221.qiye.163.com [45.254.49.221]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 59EB239A81A; Sun, 10 May 2026 14:09:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.254.49.221 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778422161; cv=none; b=a9xoT04yz0XHrH12feV6RRmGXSEhqzqkz6OkWs0mtcv6X2Ey5/X4whPrN8KJWTGQdaCcUDHJS75xFlso2p4MuwUg9v/Kc4GpARCR3iKfx9cO09TvYrVr8nA8hKe977C+onvvA9/F43e0yD8CH9HavNcfs3BFMbcdFW/mqowSY5U= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778422161; c=relaxed/simple; bh=wyjBriCJMNye0PeX03QKREfP4l0oxB3LdgwAueLeTKc=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=Po7SaDOhM//SflOB2Ib3j7zxJVjtr1xAqyJw5FIfbv2mGf9LWWKHcPiZcAuk1SLrQChCGAhucxMtKCxWb0sYWyXRMsIO5voJ9xqde2rN4OZHpDq0L/XQ6jpY0XtEgR3++b91ovnOApQeSezSpudHuebv3yuiOMJFFJes+kT0p+Q= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=leap-io-kernel.com; spf=pass smtp.mailfrom=leap-io-kernel.com; dkim=pass (2048-bit key) header.d=leap-io-kernel.com header.i=@leap-io-kernel.com header.b=FKgvi+Yc; arc=none smtp.client-ip=45.254.49.221 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=leap-io-kernel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=leap-io-kernel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=leap-io-kernel.com header.i=@leap-io-kernel.com header.b="FKgvi+Yc" Received: from server001 (unknown [222.130.22.242]) by smtp.qiye.163.com (Hmail) with ESMTP id 3dd2c7004; Sun, 10 May 2026 21:53:51 +0800 (GMT+08:00) From: Kefan Bai To: linux-usb@vger.kernel.org, si.yanteng@linux.dev Cc: gregkh@linuxfoundation.org, seakeel@gmail.com, alexs@kernel.org, dzm91@hust.edu.cn, corbet@lwn.net, skhan@linuxfoundation.org, linux-doc@vger.kernel.org, doubled@leap-io-kernel.com Subject: [PATCH v6 5/8] docs/zh_CN: Add dwc3.rst translation Date: Sun, 10 May 2026 21:53:36 +0800 Message-ID: <3c577322de70e143a6e57d60be7199f3b50d8a78.1778415392.git.baikefan@leap-io-kernel.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-HM-Tid: 0a9e122a6f5d09d5kunm9f76e21d35e09a X-HM-MType: 1 X-HM-Spam-Status: e1kfGhgUHx5ZQUtXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly tZV1koWUFITzdXWRgWCB1ZQUpXWS1ZQUlXWQ8JGhUIEh9ZQVkaHRhJVhgdGExLTR1ITE4YTlYVFA kWGhdVEwETFhoSFyQUDg9ZV1kYEgtZQVlJSUlVSkhLVUlJVUlPSVlXWRYaDxIVHRRZQVlPQkxVSE pMSEJVS1VKS1kG DKIM-Signature: a=rsa-sha256; b=FKgvi+YcyDLwLB8blYpvD+hePdySQa4TTi8O2W4eLviRtpCMleJ8P5vh6dorHdKQnMAYTE6FRa+XUH2PJrTqnHDNJ3ukpkXKAZqfpROno6RyWe+ZYefKDCqmuqHM5WM+L5SY4iCmf0JAtVDQF54tYruvsDTNHo08JLRZkqf+qIpfoGX+SeeTb1YErE0vujR0cWoaHQ2SWMUFkIK7mz3B5vdvxWHmfYllk+4ZVAAY1TIuPCl7wCulk+cWdlYgd32Fs8vKLvHroGhWvho6lJm++RX2mJAMq6sBx/iOzGE1OxyHSmAkoUGMI3Pki0Gm23HR3pbokEryyYHsiCpBtbi24g==; s=default; c=relaxed/relaxed; d=leap-io-kernel.com; v=1; bh=JcnQv15Zq9vCmnWhCDk2jnbMBx6Lvo45ZM9b20nvvYY=; h=date:mime-version:subject:message-id:from; 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 Signed-off-by: Kefan Bai --- 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.rst new file mode 100644 index 000000000000..92108ff8cc80 --- /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 + +:校译: + + + +=========== +DWC3 驱动 +=========== + + +待办 +~~~~~~ + +阅读时如果想顺手认领点任务，可以从下面挑一项 :) + +- 将中断处理程序改为每个端点各自使用线程化 IRQ + + 事实证明，有些 DWC3 命令大约需要 ``~1 ms`` 才能完成。 + 当前代码会一直自旋等待命令完成，这种设计并不好。 + + 实现思路： + + - DWC 核心实现了一个按端点对中断进行解复用的 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()`` 返回后，确认事件计数器，使中断最终消失。 + + - 设备级线程化处理程序 + 无。 + + - 端点中断的主处理程序 + 读取事件并尽量处理它。凡是需要睡眠的操作都交给线程处理。 + 事件保存在每个端点的数据结构中。 + 还要注意，一旦把某项工作交给线程处理，就不要再在主处理程序里处理它， + 以免出现优先级反转之类的问题。 + + - 端点中断的线程化处理程序 + 处理剩余的端点工作，这些工作可能会睡眠，例如等待命令完成。 + + 延迟: + + 不应增加延迟，因为中断线程具有较高优先级，会在普通用户态任务之前运行 + （除非用户更改了调度优先级）。 diff --git a/Documentation/translations/zh_CN/usb/index.rst b/Documentation/translations/zh_CN/usb/index.rst index 70fe33fc37d9..6d669c41d1cd 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.54.0