USB

通用串行总线（USB）是一种行业标准，允许在各种类型的电子设备之间进行数据交换和电力传输。它可以运行在不同的速度上，如低速 1.5 Mbps、全速 12 Mbps、高速 480 Mbps、SuperSpeed 5 Gbps 以及 SuperSpeed Plus 10 Gbps。 Synopsys DesignWare® Core SuperSpeed USB 3.x 为 Qualcomm SoC 上的 USB 提供支持，并连接到两个 PHY：通过 UTMI 接口连接的 USB2 PHY 和通过 PIPE 接口连接的 USB3 PHY。这些 PHY 连接到物理 Type-C 端口，便于与外部世界进行通信。以下是 USB 的关键硬件组件。

USB 控制器
- 主控制器是 Synopsys DesignWare Core SuperSpeed USB 3.x 控制器（Gen1/Gen2）。
  - 两个 Qualcomm 多用途 PHY（QMP）实例，用于 USB SuperSpeed 和 DisplayPort。
  - 用于高速 USB 的 Synopsys PHY。
- 辅助控制器是 Synopsys DesignWare Core 高速 USB 2.0 控制器。
  - 用于高速 USB 的 Synopsys PHY
- 第三控制器是 Synopsys DesignWare Core 高速 USB 2.0 控制器。
  - 用于高速 USB 的 Synopsys PHY。
- Dragonwing IQ-9075 有三个 USB 控制器（主 USB 3.2、辅助 USB 3.2、第三 USB 2.0）
Synopsys DesignWare core SuperSpeed USB 3.x 控制器特性
- Synopsys DesignWare Core SuperSpeed USB 3.x 控制器是符合 USB SuperSpeed 标准的控制器，可以配置为以下方式之一：
  - 仅外设配置
  - 仅主机配置
  - 双角色配置
- 支持所有传输类型（控制、批量、中断和同步）
- 支持 SuperSpeed 批量流
- 符合可扩展主机控制器接口（xHCI）规范
- 主机模式支持 SuperSpeed（5 Gbps）、高速（480 Mbps）、全速（12 Mbps）和低速（1.5 Mbps）操作。
- 设备模式支持 SuperSpeed（5 Gbps）、高速（480 Mbps）和全速（12 Mbps）操作，并最多支持 16 个双向端点（包括控制管道 ep0）。
- 链路电源管理
USB PHY 访问方式
- 通过 AHB2PHY 提供寄存器级接口，用于执行 PHY 相关操作。
USB Type-C
- 支持 USB Type-C 并使用 PM7325B PD 控制器进行电力传输。
- 完全符合 USB Type-C 3.0 电力传输规范。
- 在传输控制器确定连接的链路伙伴的 Type-C 方向、角色和模式后，支持根据 UCSI 框架更新 PM7325B 软件驱动程序。
- 仅用于主 USB 控制器。

时钟

下表列出了 USB 控制器以及高速和 SuperSpeed PHY 正常运行所需的时钟和工作频率。表： USB 控制器时钟

时钟名称	工作频率	描述
`gcc_usb30_prim_master_clk “core_clk”`	200 MHz SuperSpeed 66 MHz 高速	与总线时钟异步；时钟速率在设备树节点内定义
`gcc_cfg_noc_usb3_prim_axi_clk “iface_clk”`	200 MHz SuperSpeed 66 MHz 高速	辅助总线控制器单元时钟。
`gcc_aggre_usb3_prim_axi_clk “bus_aggr_clk”`	200 MHz SuperSpeed 66 MHz 高速	输入到 `aggregator2` 模块的时钟，用于控制从 USB AXI 到 NoC 的数据流
`gcc_usb30_prim_mock_utmi_clk “utmi_clk”`	19.2 MHz	内部控制器 `ref_clk`，用于在 USB 收发器宏单元接口（UTMI）/UTMI+ 低引脚接口（ULPI）挂起时生成 ITP 计数器
`gcc_usb30_prim_sleep_clk “sleep_clk”`	32 kHz	休眠时钟
`gcc_usb3_sec_clkref_clk_en “xo”`	19.2 MHz	HS-PHY（PMIC）的外部参考时钟源
`rpmh_cxo_clk “ref_clk_src”`	19.2 MHz	HS-PHY 的参考时钟源
`gcc_usb_phy_cfg_ahb2phy_clk “cfg_ahb_clk”`	100 MHz	AHB2PHY 块所需的时钟（频率基于 PNoC 频率）。

表： 高速 PHY 时钟

时钟名称	工作频率	描述
`rpmh_cxo_clk “ref_clk_src”`	19.2 MHz	HS-PHY 的参考时钟源
`gcc_usb_phy_cfg_ahb2phy_clk “cfg_ahb_clk”`	100 MHz	AHB2PHY 块所需的时钟（频率基于 PNoC 频率）

表： SuperSpeed PHY 时钟

时钟名称	工作频率	描述
`gcc_usb3_prim_phy_aux_clk "aux_clk”`	19.2 MHz	用于电源状态的 PHY 到 PCI express 接口（PIPE）辅助时钟
`gcc_usb3_prim_phy_pipe_clk “pipe_clk”`	125 MHz	PIPE 的输入源，允许 PHY 和控制器之间的数据传输
`rpmh_cxo_clk "ref_clk_src"`	19.2 MHz	`ref_clk` 的父时钟
`gcc_usb3_prim_clkref_clk "ref_clk"`	19.2 MHz	SS-PHY 的参考时钟源
`gcc_usb3_prim_phy_com_aux_clk "com_aux_clk"`	19.2 MHz	–

电压轨

下表列出了高速和 SuperSpeed PHY 所需的电压轨。表： USB 电压轨

电压轨	电压电平（最大值/标称值/最小值）	设备模式
VREG L1C	1.8	1.7	主 HS-PHY 和辅助 HS-PHY	系统中两个 HS-PHY 使用的 1.8 V 稳压器
VREG L2B	3.3	3.05	主 HS-PHY 和辅助 HS-PHY	系统中两个 HS-PHY 使用的 3.3 V 稳压器
VREG L1B	0.912	0.912	SS-PHY	SS-PHY VDD 核心
VREG L10C	0.880	0.880	主 HS-PHY、辅助 HS-PHY 和 SS-PHY	HS-PHY/SS-PHY VDD 核心

Dragonwing IQ-9075 USB 电压轨

HS PHY: L7A (0.88 V), L6C (1.8 V), L9A (3.3 V)
SS PHY: L1C, L7A

中断

下表列出了 USB 控制器用于通知事件的各种中断。表： USB 控制器中断

中断名称	QCS6490 /QCS5430 中断	Dragonwing IQ-9075 中断	Dragonwing IQ-8275 中断	Dragonwing IQ-615 中断	PDC 唤醒内核处理的中断事件	描述
`dp_hs_phy_irq`	14	PDC14	PDC8	PDC10	PDC14	PDC10	9	10	D+ 变化	–	仅在系统处于 VDD min/XO 关闭状态时使用
`dm_hs_phy_irq`	15	PDC15	PDC7	PDC9	PDC15	PDC9	8	11	D- 变化	–	仅在系统处于 VDD min/XO 关闭状态时使用
`ss_phy_irq`	17	PDC12	PDC13	–	PDC12	–	6	–	LFPS 检测	–	仅在系统处于 VDD min/XO 关闭状态时使用
`pwr_event_irq`	130	287	352	444	131	444	130	663	–	USB PHY 电源状态变化退出/进入 P3/L2	当系统未处于电源崩溃状态时用作主控制器唤醒句柄
`core irq`	133	292	349	442	292	442	133	664	–	总线事件挂起恢复复位控制器事件完成传输完成命令完成	处理所有 USB 控制器事件的主 USB 中断

互连

下表列出了 USB 控制器使用的各种互连。表： USB 互连

互连名称	控制器	目标	互连路径带宽（MBps）
USB-DDR	`MASTER_USB3_0` Dragonwing IQ-9075 `MASTER_USB3_1` `MASTER_USB2` Dragonwing IQ-8275、Dragonwing IQ-615 `MASTER_USB2`	`SLAVE_EBI1`	USB_MEMORY_AVG_HS_BW MBps_to_icc(240) USB_MEMORY_PEAK_HS_BW MBps_to_icc(700) USB_MEMORY_AVG_SS_BW MBps_to_icc(1000) USB_MEMORY_PEAK_SS_BW MBps_to_icc(2500)
APPS-USB	`MASTER_APPSS_PROC`	`SLAVE_USB3_0` Dragonwing IQ-9075 `SLAVE_USB3_1` `SLAVE_USB2` Dragonwing IQ-8275、Dragonwing IQ-615 `SLAVE_USB2`	APPS_USB_AVG_BW 0 APPS_USB_PEAK_BW MBps_to_icc(40)

使用时钟控制的 USB 控制器复位

下表列出了 USB 控制器和 PHY 使用的复位方法。表： USB 时钟复位方法

时钟名称	复位控制	描述
`GCC_USB3_DP_PHY_PRIM_BCR "global_phy_reset"`	SS-PHY	复位 SS-PHY 控制和状态寄存器
`GCC_USB3_PHY_PRIM_BCR "phy_reset"`	SS-PHY	复位 SS-PHY
`GCC_QUSB2PHY_PRIM_BCR "phy_reset"`	HS-PHY	复位 HS-PHY
`GCC_USB30_PRIM_BCR "core_reset"`	USB 控制器	时钟控制器输出，用于复位 USB 控制器

使用寄存器的 USB 控制器软件复位

下表列出了复位 USB 控制器的寄存器选项。表： USB 控制器复位

USB 控制器寄存器	USB 寄存器位字段	复位控制	描述
DWC3_DCTL	CSFTRST [Bit 30]	USB 控制器	复位 USB 控制器设备栈。
DWC3_GCTL	CORESOFTRESET [Bit 11]	-	DWC3 控制器的全局复位

Dragonwing IQ-9075 控制器复位寄存器

HS: GCC_USB2_PHY_PRIM_BCR
SS: GCC_USB3_PHY_PRIM_BCR/ GCC_USB3PHY_PHY_PRIM_BCR
GCC_USB3_PHY_TERT_BCR
USB30_PRIM_GDSC
USB30_SEC_GDSC
USB20_PRIM_GDSC

Dragonwing IQ-615 辅助 USB 控制器复位寄存器

GCC_USB20_SEC_BCR
GCC_QUSB2PHY_SEC_BCR
GCC_USB2_PHY_SEC_BCR

USB 控制器和 SoC 集成

USB 控制器的知识产权和 PHY 集成到 SoC 中，如下图所示。 图：USB 控制器 PHY 和 SoC 集成USB 3.xcontrollerSoCType-C connectorAHB 2PHYDisplay port controllerSS0_1DPPHY (QMP)SS0_0DPPHY (QMP)EUDHS0PHY(SNPS)PipeUTMISSHS Synopsys DesignWare Core SuperSpeed USB 3.0 知识产权仅控制核心功能，不控制设备规格，如时钟、互连、稳压器和 GDSC。Synopsys DesignWare Core 知识产权嵌入在 Qscratch 包装器（知识产权和软件驱动程序）内，该包装器负责在探测、挂起或恢复状态期间管理所需的资源（时钟、互连、中断、GDSC 和稳压器）。这两个驱动程序共存以确保 USB 功能。有关 USB Qscratch 包装器驱动程序的信息，请参见 https://github.com/torvalds/linux/blob/master/drivers/usb/dwc3/dwc3-qcom.c。有关控制器核心驱动程序的信息，请参见 https://github.com/torvalds/linux/blob/master/drivers/usb/dwc3/core.c。

xHCI 支持

xHCI 规范描述了 USB 2.0 及更高版本的寄存器级主机控制器接口。USB 控制器符合 xHCI 规范，在主机模式下支持 SuperSpeed（5 Gbps）、高速（480 Mbps）、全速（12 Mbps）和低速（1.5 Mbps）操作。在主机模式下使用 Linux 标准 xHCI 驱动程序来操作 USB 控制器。

USB Type-C 连接器系统软件接口（UCSI）

注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持 USB Type-C 功能。

USB Type-C 连接器系统软件接口在 Linux 内核中作为库提供。它定义了一组寄存器和数据结构，用于与系统上的 USB Type-C 连接器进行接口。平台上的 USB Type-C 连接器称为平台策略管理器（PPM），系统软件组件称为 OS 策略管理器（OPM）。
Qualcomm 参考设计使用 UCSI Glink 驱动程序来处理应用处理器上的 OPM 与 PPM 之间的通信，PPM 是使用 PMIC GLINK 在远程子系统（aDSP）上运行的充电器固件。
USB Type-C DisplayPort 备用模式增加了支持额外线缆详情的功能，例如 DPAM 版本和线缆信令。Qualcomm 参考设计支持使用 Type-C 的 DisplayPort，以及同时支持 USB SuperSpeed 和 DisplayPort，DisplayPort 最多两个通道（USB SuperSpeed 两个通道和 DisplayPort 两个通道）。
USB Type-C 电力传输由 PM7325B PD 控制器支持，完全符合 USB PD 3.0 规范。使用 UCSI 接口，支持 USB 数据角色交换和电源角色交换。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持通过 Type-C 连接器进行数据和电源角色交换。
以下是所涉及驱动程序的参考：

USB 功能

Qualcomm 芯片硬件 SoC 允许在双角色设备（DRD）模式下工作。DRD 支持设备和主机两种角色。设备动态检测要切换到的角色，并相应地对控制器进行编程。支持自动挂起功能，可在拔下电缆时关闭 USB 控制器。支持视频、音频、网络共享、文件传输、媒体传输和充电等功能接口。表： USB 功能：Linux

功能	描述
USB_DWC3 控制器	Linux 内核默认支持 Synopsys DesignWare Core。
USB_DWC3_QCOM	使用 Synopsys DesignWare Core 实现 USB 功能的 `Qscratch` 包装器。
运行时电源管理（RPM）	Linux 通过软件驱动程序文件 `dwc3-qcom` 支持 RPM，用于低功耗模式操作。
低功耗模式（LPM）	LPM 从 HS/SS-PHY 以及控制器两方面提供省电选项。
DRD	双角色设备检测允许 USB 在主机和设备模式下工作。

运行时电源管理

可根据您的要求启用运行时电源管理功能。LPM 支持已作为 https://lore.kernel.org/all/20231017131851.8299-1-quic_kriskura@quicinc.com/ 的一部分添加。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持 USB Type-A 端口的运行时电源管理。默认情况下，运行时的 USB 挂起和恢复被禁用。要启用这些功能，请运行以下命令：

echo auto > /sys/bus/platform/devices/a600000.usb/power/control

默认的自动挂起延迟设置为 5 秒。要更改延迟，请运行以下 sysfs 命令：

echo 2000 > /sys/bus/platform/devices/a600000.usb/power/autosuspend_delay_ms

在角色切换期间，DWC3 控制器进入挂起状态，切换 GDSC，并复位控制器，以确保主机模式外设枚举成功。在主机模式下，为了使远程唤醒正常工作，根据您的要求为 xHCI 接口、USB 根集线器和连接的外设启用唤醒和自动挂起。

echo enabled > /sys/bus/platform/devices/xhci-hcd.X.auto/power/wakeup
cd /sys/bus/usb/devices/
echo enabled > usb1/power/wakeup
echo enabled > usb2/power/wakeup

注意主机控制器驱动程序（HCD）设备生成 xhci-hcd.X.auto 值，其中 X = 0、1、2。它表示连接到 USB 的设备数量。连接的设备在 /sys/bus/platform/devices/xhci-hcd.X.auto/usb1/<node number> 下列出。<node number> 值取决于连接到 USB 端口的设备数量。要为 LS 光学鼠标启用远程唤醒，请运行以下命令：

cd /sys/bus/usb/devices/usb1/1-1/
echo auto > power/control
echo enabled > power/wakeup

要检查运行时状态，请运行以下命令：

cat /sys/bus/platform/devices/a600000.usb/power/runtime_status

要避免在组合切换中挂起，请通过运行以下命令删除活动的 UDC 以重新绑定组合：

echo on > /sys/bus/platform/devices/a600000.usb/power/control
echo auto > /sys/bus/platform/devices/a600000.usb/power/control

软件功能

软件支持以下 USB 功能。表： USB 软件功能

功能	描述
外设 ADB	ADB 功能通过 functionFS（FFS）集成
外设大容量存储	通用 Mass_storage 功能
外设 diag	Diag 功能通过 FFS 集成
外设 RNDIS	符合 Linux 内核的标准 RNDIS 协议
外设网络控制调制解调器（NCM）	符合 Linux 内核的标准 NCM 协议
主机 USB 3.0 驱动程序（xHCI）	两个 USB 控制器都支持 xHCI 架构
主机高速 USB	主机模式下的高速 USB 检测
主机 HID/MS/hub 驱动程序	主机模式下的类驱动程序检测
主机视频驱动程序	在有限的网络摄像头型号上验证的 UVC
主机链路电源管理	USB 主机模式 LPM 实现
外设 USB 链路电源管理	USB 设备模式 LPM 实现
DRD	支持双角色设备（主机/设备模式支持）
USB Type-C	由 PM7325B 支持；支持电流充电、CC 逻辑和 SuperSpeed USB 开关选择，均在嵌入式控制器中执行
USB Type-C 显示端口	支持 SuperSpeed USB + DisplayPort 同时运行（2 个 DisplayPort 通道）
USB PD 2.0/3.0 充电	PD 支持取决于所使用的 PM7325B 解决方案。完全符合 PD 3.0
USB 3.1 Gen1	USB 控制器支持 USB 3.x Gen1（5 Gbps）。

USB 架构

Qualcomm USB 软件架构大致由两个组件组成，一个基于纯上游，另一个是包含一些待处理功能相关变更的沙盒。纯上游直接从最新的稳定内核长期支持（LTS）6.6.2 版本中选取。该架构使用 Yocto（4.0 版）配方来创建二进制文件。 图：USB 软件架构/dev/ffs-xxx//dev/ffs-xxx//dev/ffs-xxx//sys/kernel/config/usb_gadget/…/sys/bus/usb/…Function driverFunction driverGadget frameworkconfigfs, UDC coreDevice controller driverClassdriverClassdriverUSB coreHost controller driverdwc3-qcomDWC3 core driversFemto phy driverQMP phy driverUCSIPMIC GLINKPM7325BaDSP corecharger firmwareVBUS, CC, D+,D-HSSS/sys/class/typec/port0/…Dual-role class driverType-C role swapdiag-routerport-bridgeadbd.serviceUSB peripheral mode configurationRuntime power management controlUser-space servicesVFSKernel-spaceType-C connector 沙盒使用以下特定于 Qualcomm 的功能实现。

USB_DWC3_QCOM：主要粘合驱动程序负责主机和设备模式下的 USB 功能，具体取决于连接的内容。粘合驱动程序的设备树条目包括时钟、电源轨和中断等资源。此功能使用 DWC3 核心驱动程序作为库，控制 DWC3 控制器的实际功能。更多详情，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/usb/dwc3/dwc3-qcom.c?h=v6.6.2。
Synopsys femto PHY：Qualcomm Synopsys femto PHY 是高速 USB PHY，负责控制 D+/D- 线路，并与充电器检测一起促进数据传输。更多详情，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/phy/qualcomm/phy-qcom-snps-femto-v2.c?h=v6.6.2。
QMP DisplayPort 组合 PHY：Qualcomm 多用途 PHY（QMP）显示端口组合 PHY 设计用于通用用途。USB 的一个示例用例是 SuperSpeed 和 SuperSpeed-plus 功能，其中 Rx+/Rx- 和 Tx+/Tx- 可用于数据传输。当显示可以在 USB 以 SuperSpeed 工作时占用一对通道进行镜像功能时，PHY 支持显示备用模式。更多详情，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/phy/qualcomm/phy-qcom-qmp-combo.c?h=v6.6.2。

USB 接口

USB 支持多种接口来传输音频、视频、调试信息和网络共享。以下每个 USB 接口通信协议都不同，除了标准 USB 协议外，还有自己的协议。

Android 调试桥（ADB）
- USB ADB 是一个调试接口，通过 USB 连接提供对系统的访问。有关 ADB 的更多信息，请参见 https://developer.android.com/tools/adb。
- 文件名是 dev 节点的虚拟 eps 名称。有关 f_fs.c 的更多信息，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/usb/gadget/function/f_fs.c?h=v6.6.2。
- 用户空间服务：用户空间守护进程 adbd.service 运行 ADB，并负责在底层内核驱动程序和主机 PC 之间建立连接。
诊断（diag）
- Diag 是用于从各个子系统收集日志数据和调试的诊断框架。诊断数据通过 USB 传输到主机 PC。
- 内核驱动程序：Diag 使用 f_fs.c 暴露 /dev/ffs-diag 节点，该节点由用户空间服务操作以进行各种操作。dev 节点具有以下三个文件：
  - ep0：控制操作
  - ep1：读取操作
  - ep2：写入操作这些文件名是 dev 节点的虚拟 eps 名称。有关 f_fs.c 的更多信息，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/usb/gadget/function/f_fs.c?h=v6.6.2。
大容量存储
- 具有大容量存储驱动程序的通用接口驱动程序可供设备作为通用存储设备使用。
- 内核驱动程序：mass_storage 功能由 f_mass_storage.c 驱动程序调节。此驱动程序暴露 dev node[revisit]，由主机 PC 控制。有关大容量存储的更多信息，请参见 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/usb/gadget/function/f_mass_storage.c?h=v6.6.2。
远程网络驱动程序接口规范（RNDIS）
- RNDIS 是 Microsoft 为动态即插即用 I/O 总线（如 USB）上的网络设备开发的规范。
- 内核驱动程序：它使用 f_rndis 驱动程序，该驱动程序存在于上游 Linux 内核中，直接与网络接口或堆栈通信。
网络控制模型（NCM）
- NCM 是一种协议，与 RNDIS 相比，旨在提供高级特性和功能。
- 它通常出现在 USB 设备必须处理苛刻网络任务的应用中。
USB 音频类 2（UAC2）
- UAC2 是控制 USB 音频设备与计算机之间通信的标准。
- UAC2 支持更高的音频数据传输速率，从而改善音频质量并减少延迟。
USB 视频类（UVC）
- UVC 是一种标准，定义了视频流设备（如网络摄像头）应如何使用 USB 与计算机通信。
- UVC 便于视频设备的即插即用功能。

USB 工具

下表列出了一些常用的 USB 工具。表： USB 工具和下载详情

USB 工具	下载链接
平台工具 (adb/fastboot)	https://developer.android.com/tools/releases/platform-tools
USB 视频类 (UVC)	`LibUVC` https://github.com/libuvc/libuvc https://libuvc.github.io/libuvc/
UVC gadget	https://github.com/wlhe/uvc-gadget
UVC streamer	https://github.com/bsapundzhiev/uvc-streamer
UVC Video4Linux	`v4l2-utils`：https://linuxtv.org/downloads/v4l-dvb-apis/driver-api/v4l2-core.html

配置 USB 引导加载程序

引导加载程序中用于调整高速和 SuperSpeed USB 信号质量的设备树参数可以使用 Qualcomm DeviceTree 编辑器（QDTE）工具进行修改。 QDTE 工具用于通过编辑 xbl_config.elf 文件来配置设备树二进制 Blob，如下图所示。有关如何配置设备树 Blob 的更多信息，请参见 QDTE 部分。Linux 主机上的设备树文件路径为 /boot_images/boot/Settings/Soc/<Chipset>/Core/WiredConnectivity/USB/usb.dtsi。 图：设备树布局 下表列出了用于调整 HS-USB PHY 和 SS USB PHY 信号质量的属性。表： USB 配置属性

属性名称	属性描述	数据类型	可能值和值范围	设备行为
`path=/soc/usb0/hs_phy_cfg`	调整主 USB 控制器 HS-PHY 的 USB 信号质量。	UINT32-array	此属性是地址、值对 <`addr`, `val`> 的数组 `addr` 长度为 4 字节。它可以具有 4 个值之一，范围：`[0x88E306C, 0x88E3070, 0x88E3074, 0x88E3078]` `val` 长度为 1 字节，范围：`0x00` 到 `0xFF`	改善主 USB HS-PHY 的 USB 信号质量。
`path=/soc/usb0/ss_phy_cfg`	改善主 USB 控制器 SS-PHY 的信号质量。	UINT32-array	此属性是地址、值对 <`addr`, `val`> 的数组 `addr` 长度为 4 字节。范围：`[0x088E8000, 0x088EB000]` `val` 长度为 1 字节，范围：`0x00` 到 `0xFF`	改善主 USB SS-PHY 的信号质量。
`path=/soc/usb1/hs_phy_cfg`	改善辅助 USB 控制器 HS-PHY 的 USB 信号质量。	UINT32-array	此属性是地址、值对 <`addr`, `val`> 的数组 `addr` 长度为 4 字节。它可以具有 4 个值之一，范围：`[0x88E406C,0x88E4070, 0x88E4074, 0x88E4078]` `val` 长度为 1 字节，范围：`0x00` 到 `0xFF`	改善辅助 USB HS-PHY 的信号质量。
`Path = /sw/usb_config/fastboot_core_num`	选择 Fastboot 的 USB 核心号（主=0/辅助=1）	UINT32	0 或 1	Fastboot 设备根据所选属性在 USB core0 或 core1 上枚举。

配置 USB 摄像头

Qualcomm Linux 设备为符合 USB 视频类（UVC）标准的 USB 网络摄像头提供驱动程序支持。Linux 内核的 uvcvideo 驱动程序支持摄像头。有关 uvcvideo 驱动程序的更多信息，请参见 https://www.kernel.org/doc/html/v4.19/media/v4l-drivers/uvcvideo.html。 uvcvideo 驱动程序将这些摄像头暴露为 V4L2 视频设备，可以通过字符设备节点（如 /dev/videoX）访问。在用户空间中，应用程序可以使用 v4l2src GStreamer 插件管理 USB 摄像头，该插件与 Qualcomm 智能多媒体 SDK（IM SDK）一起提供。或者，Yavta（yet another V4L2 test application）等程序直接与 V4L2（Video4Linux2）接口交互以测试和控制摄像头设备。如果目标上没有 YAVTA，请按照以下步骤交叉编译并安装它：

可以使用以下任一方法建立交叉编译环境。

方法 1：要设置交叉编译环境，请运行以下命令。
sudo apt install gcc-aarch64-linux-gnu

方法 2：要设置交叉编译环境，请运行以下命令：

下载交叉编译器。

wget https://releases.linaro.org/archive/14.07/components/toolchain/binaries/gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux.tar.xz

解压交叉编译器。

tar -xf gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux.tar.xz

运行以下命令为交叉编译设置环境。

export PATH=$PATH:`pwd`/gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux/bin

克隆 Yavta 仓库并更改目录。

git clone https://github.com/fastr/yavta.git
cd yavta

交叉编译该工具。

make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-

要将 Yavta 推送到 Qualcomm Linux 硬件 SoC，请执行以下操作：
1. 在宽松模式下打开 SSH shell 或使用 ADB shell。有关如何运行 SSH 的更多信息，请参见 Use SSH 部分。
2. 挂载文件系统。
  mount -o remount,rw /usr
3. 使用 SCP 或类似工具传输文件。例如，scp yavta root@10.92.162.185:/usr/bin
4. 为 Yavta 分配执行权限。
  chmod 0777 /usr/bin/yavta

前提条件：获取图像格式和大小

要通过 Yavta 或 GStreamer 配置 USB 摄像头，以下步骤是必需的。

要了解枚举详情，请插入 USB 摄像头并运行以下命令。

lsusb

将显示以下输出。

Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 03f0:0959 HP, Inc w200
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

从串行控制台识别创建的 USB 摄像头视频节点 /dev/videoX。
ls /sys/bus/usb/devices/1-1/1-1:1.0/video4linux/
注意1-1/1-1:1.0 值根据连接的 USB 设备而变化。将显示以下输出。
video4 video5

要使用 Yavta 查看支持的输出格式和大小，请运行以下命令：

yavta /dev/video*X* --enum-formats

其中 X 值基于节点。例如：

yavta /dev/video4 --enum-formats

将显示以下输出。

Device /dev/video*X* opened: w200: w200 (usb-xhci-hcd.2.auto-1).
- Available formats:
	Format 0: MJPG (47504a4d)
	Type: Video capture (1)
	Name: Motion-JPEG
	Frame size: 1280x720 (1/30, 1/25, 1/20, 1/15, 1/10, 1/5)
	Frame size: 800x600 (1/30)
	Frame size: 640x480 (1/30)
	Frame size: 320x240 (1/30)
	Format 1: YUYV (56595559)
	Type: Video capture (1)
	Name: YUYV 4:2:2
	Frame size: 1280x720 (1/10)
	Frame size: 800x600 (1/15)
	Frame size: 640x480 (1/30)
	Frame size: 320x240 (1/30)

从第 3 步选择所需的图像格式和大小。

使用 Yavta 配置 USB 摄像头

前提条件：确保 Yavta 已交叉编译，并已识别输出格式和大小。

要选择 MJPEG 格式（1280x720 输出大小、30 fps），在 /tmp/ 下捕获 10 帧，文件名为 testmjpeg-00000*.bin，请运行以下命令。

cd /usr/bin

yavta -f MJPEG -s 1280x720 -t 1/30 -c10 -F/tmp/testmjpeg /dev/video*X*

将显示以下输出。

Device /dev/video*X* opened: w200: w200 (usb-xhci-hcd.2.auto-1).
Video format set: width: 1280 height: 720 buffer size: 1843789
Video format: MJPG (47504a4d) 1280x720
Current frame rate: 1/30
Setting frame rate to: 1/30
Frame rate set: 1/30
8 buffers requested.
length: 1843789 offset: 0
Buffer 0 mapped at address 0x7fabd5d000.
length: 1843789 offset: 1847296
Buffer 1 mapped at address 0x7fabb9a000.
length: 1843789 offset: 3694592
Buffer 2 mapped at address 0x7fab9d7000.
length: 1843789 offset: 5541888
Buffer 3 mapped at address 0x7fab814000.
length: 1843789 offset: 7389184
Buffer 4 mapped at address 0x7fab651000.
length: 1843789 offset: 9236480
Buffer 5 mapped at address 0x7fab48e000.
length: 1843789 offset: 11083776
Buffer 6 mapped at address 0x7fab2cb000.
length: 1843789 offset: 12931072
Buffer 7 mapped at address 0x7fab108000.
0 (0) [-] 0 57672 bytes 2459.697791 315967245.973463
1 (1) [-] 1 40816 bytes 2459.730553 315967246.005839
2 (2) [-] 2 40472 bytes 2459.763517 315967246.039485
3 (3) [-] 3 41272 bytes 2459.797002 315967246.073073
4 (4) [-] 4 42232 bytes 2459.830192 315967246.105592
5 (5) [-] 5 46024 bytes 2459.863253 315967246.139142
6 (6) [-] 6 47440 bytes 2459.896755 315967246.172384
7 (7) [-] 7 48840 bytes 2459.930006 315967246.205114
8 (0) [-] 8 50248 bytes 2459.963235 315967246.238308
9 (1) [-] 9 53136 bytes 2459.996526 315967246.272690
Captured 9 frames in 0.300183 seconds (29.981711 fps, 1559555.337911 B/s).
8 buffers released.

要选择 YUV 格式（1280x960 输出大小、30 fps），在 /tmp/ 下捕获 10 帧，生成的文件名为 testyuv-00000*.bin，请运行以下命令。

yavta -f YUYV -s 1280x720 -t 1/30 -c10 -F/tmp/testyuv /dev/video*X*

注意使用命令 #setenforce 0 启用宽松模式。将显示以下输出。

Device /dev/video*X* opened: w200: w200 (usb-xhci-hcd.2.auto-1).
Video format set: width: 1280 height: 720 buffer size: 1843200
Video format: YUYV (56595559) 1280x720
Current frame rate: 1/10
Setting frame rate to: 1/10
Frame rate set: 1/10
8 buffers requested.
length: 1843200 offset: 0
Buffer 0 mapped at address 0x7f9853e000.
length: 1843200 offset: 1843200
Buffer 1 mapped at address 0x7f9837c000.
length: 1843200 offset: 3686400
Buffer 2 mapped at address 0x7f981ba000.
length: 1843200 offset: 5529600
Buffer 3 mapped at address 0x7f97ff8000.
length: 1843200 offset: 7372800
Buffer 4 mapped at address 0x7f97e36000.
length: 1843200 offset: 9216000
Buffer 5 mapped at address 0x7f97c74000.
length: 1843200 offset: 11059200
Buffer 6 mapped at address 0x7f97ab2000.
length: 1843200 offset: 12902400
Buffer 7 mapped at address 0x7f978f0000.
0 (3) [-] 3 1843200 bytes 2536.837027 315967323.172707
1 (4) [-] 4 1843200 bytes 2536.937122 315967323.273059
2 (6) [-] 6 1843200 bytes 2537.136830 315967323.472473
3 (7) [-] 7 1843200 bytes 2537.237183 315967323.572533
4 (2) [-] 17 1843200 bytes 2538.237266 315967324.571848
5 (2) [-] 24 1843200 bytes 2538.936539 315967325.271919
6 (3) [-] 25 1843200 bytes 2539.036550 315967325.372403
Warning: bytes used 0 != image size 1843200
7 (7) [E] 28 0 bytes 2539.336529 3159  325.609436
Warning: bytes used 0 != image size 1843200
8 (0) [E] 22 0 bytes 2538.737975 315967325.610149
Warning: bytes used 0 != image size 1843200
9 (1) [E] 23 0 bytes 2538.837814 315967325.610622
Captured 9 frames in 2.438312 seconds (3.691078 fps, 5291529.549951 B/s).
8 buffers released.

在 Qualcomm IM SDK 中使用 GStreamer 配置 USB 摄像头

Qualcomm IM SDK 使用 GStreamer，一个开源的多媒体框架，用于在多媒体和机器学习领域公开简单的 API 和插件。有关安装 Qualcomm IM SDK 的信息，请参见 Getting Started 部分。 Qualcomm IM SDK 包括 v4l2src 插件，该插件允许从具有所选格式的 USB 摄像头输入。waylandsink 插件负责在 Wayland 显示器上渲染视频输出。 注意前提条件：

确保 Yavta 已交叉编译，并已识别输出格式和大小。
要下载或更新固件，请参见 Download PCIe to USB controller firmware。

要为 Wayland 显示器设置环境变量，请在串行控制台中运行以下命令。
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1

使用 GStreamer 命令将视频从摄像头流式传输到 UI。确保您设置了适当的设备 ID (/dev/videoX) 并根据 USB 摄像头检测选择正确的格式。注意在 GStreamer 中，YUYV 颜色格式称为 YUY2。因此，在设置管道时您必须指定 YUYV 格式，并在 caps 过滤器中使用 YUY2。

对于 720p，运行以下命令：

gst-launch-1.0 -e v4l2src io-mode=dmabuf-import device="/dev/video0" ! video/x-raw,format=YUY2,width=1280,height=720,framerate=10/1 ! waylandsink fullscreen=true

将显示以下输出。

Y2,width=1280,height=720,framerate=10/1 ! waylandsink fullscreen=true
Setting pipeline to PAUSED ...
I/Adreno-UNKNOWN (1985,1985): <ReadGpuID:357>: Reading chip ID through GSL
GBM_INFO::msmgbm_mapper(262)::gbm mapper instantiated
gbm_create_device(224): Info: backend name is: msm_drm
Pipeline is live and does not need PREROLL ...
Pipeline is PREROLLED ...
Setting pipeline to PLAYING ...
New clock: GstSystemClock
gbm_create_device(224): Info: backend name is: msm_drm
GBM_ERR::msmgbm_bo_create(870)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for data fd errono: 22 (Invalid argument) drm fd: 24 data fd: 26
 GBM_ERR::msmgbm_bo_create(923)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for metadata fd errono: 22 (Invalid argument) drm fd: 24 metadata fd: 27
GBM_ERR::msmgbm_bo_create(870)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for data fd errono: 22 (Invalid argument) drm fd: 24 data fd: 29
GBM_ERR::msmgbm_bo_create(923)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for metadata fd errono: 22 (Invalid argument) drm fd: 24 metadata fd: 30
GBM_ERR::msmgbm_bo_create(870)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for data fd errono: 22 (Invalid argument) drm fd: 24 data fd: 32
GBM_ERR::msmgbm_bo_create(923)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for metadata fd errono: 22 (Invalid argument) drm fd: 24 metadata fd: 33
GBM_ERR::msmgbm_bo_create(870)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for data fd errono: 22 (Invalid argument) drm fd: 24 data fd: 35
GBM_ERR::msmgbm_bo_create(923)::DRM_IOCTL_PRIME_FD_TO_HANDLE failed for metadata fd errono: 22 (Invalid argument) drm fd: 24 metadata fd: 36
Redistribute latency...
0:00:47.7 / 99:99:99.

对于 1080p，运行以下命令：

gst-launch-1.0 -e v4l2src io-mode=dmabuf-import device="/dev/video0" ! video/x-raw,format=YUY2,width=1920,height=1080,framerate=5/1 ! waylandsink fullscreen=true

自定义 USB 设备

本节描述 USB 软件中各种配置和自定义的要求。

具有 diag 和 ADB 接口的 USB 组合的示例 shell 脚本

cd /sys/kernel/config/usb_gadget/adb
echo on > /sys/bus/platform/devices/a600000.usb/power/control
echo "" > UDC
mkdir functions/ffs.diag
echo "QCOM" > strings/0x409/manufacturer
echo 0x05c6 > idVendor
echo 0x901d > idProduct
echo "Diag_ADB" > configs/c.1/strings/0x409/configuration

if [ ! -d /dev/ffs-diag ]; then
mkdir -p /dev/ffs-diag
fi
if [ ! -e /dev/ffs-diag/ep0 ]; then
mount -o uid=2000,gid=2000 -t functionfs diag /dev/ffs-diag
fi

/usr/bin/diag-router &

cd configs/c.1
rm -r ffs.usb0
ln -s ../../functions/ffs.diag f1
ln -s ../../functions/ffs.usb0 f2
cd ../../ udcname=`ls -1 /sys/class/udc | head -n 1`
echo $udcname > UDC
echo auto > /sys/bus/platform/devices/a600000.usb/power/control

使用 configfs 自定义

configfs 文件系统提供与 sysfs 功能相反的功能。多种接口可以配置 Linux USB gadget，每个接口代表一个 USB 功能。这些接口的组合可以通过类似于上一节中启动 diag-adb 的命令进行枚举。可用的 USB 组合如下。

A4A1 NCM
4EE7 ADB
900E DIAG
901C DIAG + UAC2
901D DIAG + ADB
9015 MASS_STORAGE + ADB
9024 RNDIS + ADB
902A RNDIS + MASS_STORAGE
902B RNDIS + ADB + MASS_STORAGE
902C RNDIS + DIAG
902D RNDIS + DIAG + ADB
902F RNDIS + DIAG + MASS_STORAGE
9060 DIAG + QDSS + ADB
908C NCM + ADB
90CA DIAG + UAC2 + ADB
90CB DIAG + UVC + ADB
90CC DIAG + UAC2 + UVC + ADB
90DF DIAG + UVC
90E0 DIAG + UAC2 + UVC
F000 MASS_STORAGE
F00E RNDIS

启用和配置 UVC 用例

USB 视频设备类（也称为 USB 视频类或 UVC）是一种 USB 设备类，描述能够流式传输视频的设备，例如网络摄像头、数字摄像机、转码器、模拟视频转换器和静态图像相机。 USB 视频类规范的最新版本为 v1.5。USB 实施者论坛在 v1.5 中描述了基本协议和不同的有效载荷格式。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持 UVC 用例。测试 UVC 的工具和程序如下：

UVC gadget（设备端）：这是一个用于测试 f_uvc 功能驱动程序的示例应用程序。它打开由 uvc_gadget 创建的视频节点，并以指定的帧速率发送 MJPEG 帧。此应用程序为 DUT 交叉编译。注意确保主机上已安装交叉编译 64 位 Arm® 技术编译器所需的软件包和工具。

可以使用以下任一选项建立交叉编译环境。

选项 A：运行以下命令。
sudo apt install gcc-aarch64-linux-gnu

选项 B：要设置交叉编译环境，请运行以下命令：

下载交叉编译器。

wget https://releases.linaro.org/archive/14.07/components/toolchain/binaries/gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux.tar.xz

解压交叉编译器。

tar -xf gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux.tar.xz

运行以下命令为交叉编译设置环境。

export PATH=$PATH:`pwd`/gcc-linaro-aarch64-linux-gnu-4.9-2014.07_linux/bin

要构建 UVC gadget 工具，请执行以下操作。

克隆 uvc-gadget 仓库。

git clone https://github.com/wlhe/uvc-gadget.git
cd uvc-gadget

修改 Makefile 以进行静态构建。

git diff
diff --git a/Makefile b/Makefile
index ccf5a34..5be54cc 100644
--- a/Makefile
+++ b/Makefile
@@ -2,7 +2,7 @@ CROSS_COMPILE   ?=
 ARCH           ?= x86
 KERNEL_DIR     ?= /usr/src/linux
-CC             := $(CROSS_COMPILE)gcc
+CC             := $(CROSS_COMPILE)gcc -static
 KERNEL_INCLUDE := -I$(KERNEL_DIR)/include -I$(KERNEL_DIR)/arch/$(ARCH)/include
 CFLAGS         := -W -Wall -g $(KERNEL_INCLUDE)
 LDFLAGS                := -g

为 arm64 交叉编译以生成 uvc-gadget 可执行文件。
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-

UVC viewer（主机端）：要接收 UVC 数据，请在计算机上打开任何 USB 网络摄像头应用程序。
1. 要验证，请将 UVC gadget 应用程序和示例图像文件推送到设备，请执行以下操作：
  1. 在宽松模式下打开 SSH shell 或使用 ADB shell。有关如何运行 SSH 的更多信息，请参见 Use SSH 部分。
  2. 挂载文件系统。
    mount -o remount,rw /usr
  3. 使用 SCP 或类似工具传输文件。例如，scp uvc-gadget root@10.92.175.138:/usr/bin
  4. 分配执行权限。
    chmod 0777 /usr/bin/uvc-gadget
2. 更改为任何 UVC 组合（90DF 或 90CB）。

只有在用户空间视频应用程序打开时，USB 才会在 UVC 组合中枚举。要发生 USB 枚举，请通过控制台（串行控制台或 SSH shell 或使用 ADB shell）启动 uvc_gadget 应用程序。

YUYV
1. 将 image-720.yuv 图像文件推送到 /root 或 /etc。
  scp image-720.yuv root@10.92.175.138:/root
2. 使用 uvc-gadget 工具验证 image-720.yuv 图像。
  uvc-gadget -u /dev/videoX -i /root/image-720.yuv -s 2 -m 2 -n 32 -t 10 -f 0
  - 其中 X 表示组合切换后创建的新视频节点
  - 其中 -f 是格式，值如下：
    - 0 = V4L2_PIX_FMT_YUYV
    - 1 = V4L2_PIX_FMT_MJPEG
MJPEG
1. 将 image-720.jpg 图像文件推送到 /root 或 /etc。
  scp image-720.jpg root@10.92.175.138:/root
2. 使用 uvc-gadget 工具验证 image-720.jpg 图像。
  uvc-gadget -u /dev/videoX -i /root/image-720.jpg -s 2 -m 2 -n 32 -t 10 -f 1
  - 其中 X 表示组合切换后创建的新视频节点
  - 其中 -f 是 <format>，值如下：
    - 0 = V4L2_PIX_FMT_YUYV
    - 1 = V4L2_PIX_FMT_MJPEG

有关用法信息，请运行以下命令。

./uvc-gadget -h

将显示以下输出。

Usage: uvc-gadget [options]
Available options are
-b             Use bulk mode
-d             Do not use any real V4L2 capture device
-f <format>    Select frame format
        0 = V4L2_PIX_FMT_YUYV
        1 = V4L2_PIX_FMT_MJPEG
-h             Print this help screen and exit
-i image       MJPEG image
-m             Streaming mult for ISOC (b/w 0 and 2)
-n             Number of Video buffers (b/w 2 and 32)
-o <IO method> Select UVC IO method:
        0 = MMAP
        1 = USER_PTR
-r <resolution> Select frame resolution:
        0 = 360p, VGA (640x360)
        1 = 720p, WXGA (1280x720)
-s <speed>     Select USB bus speed (b/w 0 and 2)
        0 = Full Speed (FS)
        1 = High Speed (HS)
        2 = Super Speed (SS)
-t             Streaming burst (b/w 0 and 15)
-u device      UVC Video Output device
-v device      V4L2 Video Capture device

UAC 用例

USB 音频使用同步、中断和控制传输。所有音频数据都使用同步传输进行传输。中断传输用于传递有关音频时钟可用性的信息，控制传输用于设置音量、请求采样率。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持 UAC 用例。要验证，请选择具有 UAC 功能的 USB 组合。要捕获或播放，请使用 rootfs 中提供的 tinyutils 应用程序，如 tinyplay/tinycap。当 UAC 驱动程序绑定成功时，该应用程序会打开 /dev/snd/ 中创建的 PCM 节点。以下是一些示例命令。

列出 Linux 主机上的声卡。

arecord -L 
aplay -f S16_LE -r 44100 -c 2 -D front:CARD=qcs6490rb3gen2v,DEV=0 441k_16bit_5min_m1dB.wav

播放音频文件。

要将音频从设备播放到主机，请推送具有匹配音频配置的 file.wav 文件。以下是示例配置的示例。

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/p_chmask

输出：

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/c_chmask

输出：

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/p_srate

输出：

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/c_srate

输出：

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/p_ssize

输出：

cat /sys/kernel/config/usb_gadget/adb/functions/uac2.0/c_ssize

输出：

注意要修改音频配置，请在将 USB 组合建立为 90CA 之前调整上述参数。

在 SSH shell 上运行以下命令或使用 ADB shell。

tinyplay

将显示以下输出。

Usage: tinyplay file.wav [-D card] [-d device] [-p period_size] [-n n_periods]

在 Linux 主机上运行以下带有 arecord 等应用程序的命令来捕获音频。
arecord -f S16_LE -r 44100 -c 2 -D front:CARD=qcs6490rb3gen2v,DEV=0 test1.wav

录制音频文件。

在 Linux 主机上运行以下带有 aplay 等应用程序的命令来播放音频。

aplay -f S16_LE -r 44100 -c 2 -D front:CARD=qcs6490rb3gen2v,DEV=0 441k_16bit_5min_m1dB.wav

在设备的 SSH shell 上运行以下命令或使用 ADB shell。

tinycap

将显示以下输出。

Usage: tinycap file.wav [-D card] [-d device] [-c channels] [-r rate] [-b bits] [-a 	bits_packed] [-p period_size] [-n n_periods] [-T capture time]

USB 电力传输中的数据角色交换

数据角色交换（DR_SWAP）是使用 USB Type-C 连接器在端口伙伴之间交换 DFP（主机）和 UFP（设备）角色。电源角色交换（PR_SWAP）在端口伙伴之间交换源和接收角色。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持使用 Type-C 连接器进行数据和电源角色交换。

数据角色

要将数据角色从主机切换到设备，请运行以下命令：

cat /sys/class/typec/port0/data_role

将显示以下输出。

[host] device

echo device > /sys/class/typec/port0/data_role
cat /sys/class/typec/port0/data_role

将显示以下输出。

host [device]

要将数据角色从设备切换到主机，请运行以下命令：

cat /sys/class/typec/port0/data_role

将显示以下输出。

host [device]

echo host > /sys/class/typec/port0/data_role
cat /sys/class/typec/port0/data_role

将显示以下输出。

[host] device

电源角色

要将电源角色从接收切换到源，请运行以下命令：

cat /sys/class/typec/port0/power_role

将显示以下输出。

source [sink]

echo source > /sys/class/typec/port0/power_role
cat /sys/class/typec/port0/power_role

将显示以下输出。

[source] sink

要将电源角色从源切换到接收，请运行以下命令：

cat /sys/class/typec/port0/power_role

将显示以下输出。

[source] sink

echo sink > /sys/class/typec/port0/power_role
cat /sys/class/typec/port0/power_role

将显示以下输出。

source [sink]

验证 USB 设备

下表列出了验证 USB 设备和主机模式的各种方法。表： USB 设备和主机模式验证

USB 模式	功能	描述
USB 设备模式	ADB	默认情况下，USB 在仅 ADB 组合中枚举。
Diag	请参见 Example shell script for a USB composition with diag and ADB interfaces 并通过 Configfs 更改 USB 组合。
大容量存储	更改 USB 组合并选择任何 mass_storage 组合，如 PID 9015。
电缆连接和断开时的 USB LPM	手动断开 USB，以便 `dwc3-qcom` 模块切换到低功耗模式。
网络控制调制解调器（NCM）	将 USB 组合更改为任何支持 NCM 的 PID，如 908C。
USB 主机模式	主机人机接口设备（HID）类	通过将 HID 类设备直接连接到被测设备来切换到主机模式。
主机大容量存储（MS）类	通过将 MS 类设备直接连接到被测设备来切换到主机模式。
主机集线器类	通过将集线器类设备直接连接到被测设备来切换到主机模式。
主机电源管理	当 `dwc3-qcom` 模块在主机模式下切换到低功耗模式时，外设支持主机模式挂起（耳机）状态。
外设连接和断开时的 USB LPM	当 `dwc3-qcom` 模块在主机模式下切换到低功耗模式时，外设支持主机模式挂起（耳机）。
高速 USB L1 LPM	当 `dwc3-qcom` 模块在主机模式下切换到低功耗模式时，高速外设支持主机模式挂起（耳机）。
USB 摄像头	请参见 Configure USB camera。

调试 USB 问题

本节介绍了获取调试日志的各种方法。调试方法包括 regdumps、调试 ftraces、configfs 节点。这些日志在调试低功耗模式进入-退出、SMMU 故障、无时钟访问等问题时，提供事件和控制器状态详情的可见性。注意Dragonwing IQ-9075 和 Dragonwing IQ-8275 不支持 USB Type-C 功能。

跟踪 USB

debugfs 跟踪提供了对 USB 线路上每个事务的更深层次的视图。要查看跟踪列表，请运行以下命令。

ls /sys/kernel/tracing/events/dwc3

注意确保已挂载 debugfs。如果未挂载，请运行以下命令挂载 debugfs。

mount -t debugfs none /sys/kernel/debug

以下是可用于验证 xHCI/gadget 堆栈/USB Type-C 连接器系统软件接口（UCSI）中数据传输的跟踪。

dwc3_alloc_request  dwc3_event              dwc3_gadget_generic_cmd  enable
dwc3_complete_trb   dwc3_free_request       dwc3_gadget_giveback     filter
dwc3_ctrl_req       dwc3_gadget_ep_cmd      dwc3_prepare_trb
dwc3_ep_dequeue     dwc3_gadget_ep_disable  dwc3_readl
dwc3_ep_queue       dwc3_gadget_ep_enable   dwc3_writel

要列出 xHCI/主机控制器驱动程序（HCD）中的跟踪，请运行以下命令。

ls /sys/kernel/tracing/events/xhci-hcd

以下是可用于验证 xHCI/HCD 中数据传输的跟踪。

enable                            xhci_handle_cmd_config_ep
filter                            xhci_handle_cmd_disable_slot
  xhci_add_endpoint                 xhci_handle_cmd_reset_dev
  xhci_address_ctrl_ctx             xhci_handle_cmd_reset_ep
  xhci_address_ctx                  xhci_handle_cmd_set_deq
  xhci_alloc_dev                    xhci_handle_cmd_set_deq_ep
  xhci_alloc_virt_device            xhci_handle_cmd_stop_ep
  xhci_configure_endpoint           xhci_handle_command
  xhci_configure_endpoint_ctrl_ctx  xhci_handle_event
  xhci_dbc_alloc_request            xhci_handle_port_status
  xhci_dbc_free_request             xhci_handle_transfer
  xhci_dbc_gadget_ep_queue          xhci_hub_status_data
  xhci_dbc_giveback_request         xhci_inc_deq
  xhci_dbc_handle_event             xhci_inc_enq
  xhci_dbc_handle_transfer          xhci_queue_trb
  xhci_dbc_queue_request            xhci_ring_alloc
  xhci_dbg_address                  xhci_ring_ep_doorbell
  xhci_dbg_cancel_urb               xhci_ring_expansion
  xhci_dbg_context_change           xhci_ring_free
  xhci_dbg_init                     xhci_ring_host_doorbell
  xhci_dbg_quirks                   xhci_setup_addressable_virt_device
  xhci_dbg_reset_ep                 xhci_setup_device
  xhci_dbg_ring_expansion           xhci_setup_device_slot
  xhci_discover_or_reset_device     xhci_stop_device
  xhci_free_dev                     xhci_urb_dequeue
  xhci_free_virt_device             xhci_urb_enqueue
  xhci_get_port_status              xhci_urb_giveback
  xhci_handle_cmd_addr_dev

要列出 USB 视频类（UVC）gadget 驱动程序的可用事件，请运行以下命令。

ls /sys/kernel/tracing/events/gadget

将显示以下输出。

enable                      usb_gadget_activate
  filter                      usb_gadget_clear_selfpowered
  usb_ep_alloc_request        usb_gadget_connect
  usb_ep_clear_halt           usb_gadget_deactivate
  usb_ep_dequeue              usb_gadget_disconnect
  usb_ep_disable              usb_gadget_frame_number
  usb_ep_enable               usb_gadget_giveback_request
  usb_ep_fifo_flush           usb_gadget_set_remote_wakeup
  usb_ep_fifo_status          usb_gadget_set_selfpowered
  usb_ep_free_request         usb_gadget_vbus_connect
  usb_ep_queue                usb_gadget_vbus_disconnect
  usb_ep_set_halt             usb_gadget_vbus_draw
  usb_ep_set_maxpacket_limit  usb_gadget_wakeup
  usb_ep_set_wedge

要列出 UCSI 驱动程序中的可用事件，请运行以下命令。

ls /sys/kernel/tracing/events/ucsi

将显示以下输出。

enable  ucsi_connector_change  ucsi_register_port  ucsi_run_command
filter  ucsi_register_altmode  ucsi_reset_ppm

USB regdump

USB debugfs 提供以下信息。注意a600000.usb 地址因芯片组而异。

操作模式。

cat /sys/kernel/debug/usb/a600000.usb/mode

示例输出：

device

设备模式下所有端点的状态和传输环缓冲区（TRB）队列。

当前链路状态。

cat /sys/kernel/debug/usb/a600000.usb/link_state

示例输出。

Sleep

列表处理器（LSP）转储。

cat /sys/kernel/debug/usb/a600000.usb/lsp_dump

示例输出：

GDBGLSP[0] = 0x40000000
GDBGLSP[1] = 0x00003a80
GDBGLSP[2] = 0x38200000
GDBGLSP[3] = 0x00802000
GDBGLSP[4] = 0x126f1000
GDBGLSP[5] = 0x3a800018
GDBGLSP[6] = 0x00000a80
GDBGLSP[7] = 0xfc03f14a
GDBGLSP[8] = 0x0b803fff
GDBGLSP[9] = 0x00000000
GDBGLSP[10] = 0x000000f8
GDBGLSP[11] = 0x000000f8
GDBGLSP[12] = 0x000000f8
GDBGLSP[13] = 0x000000f8
GDBGLSP[14] = 0x000000f8
GDBGLSP[15] = 0x000000f8

ls /sys/kernel/debug/usb/a600000.usb

示例输出：

ep0in    ep11out  ep14in   ep1out  ep4in   ep6out  ep9in       regdump
ep0out   ep12in   ep14out  ep2in   ep4out  ep7in   ep9out      testmode
ep10in   ep12out  ep15in   ep2out  ep5in   ep7out  link_state
ep10out  ep13in   ep15out  ep3in   ep5out  ep8in   lsp_dump
ep11in   ep13out  ep1in    ep3out  ep6in   ep8out  mode

regdump 命令提供以下寄存器的寄存器空间的当前状态：

设备模式寄存器，如 DCTL、DSTS 和 DCFG
全局寄存器，如 GCTL 和 GSTS

cd /sys/kernel/debug/usb/a600000.usb
cat regdump
                

示例输出：

GSBUSCFG0 = 0x2222000e
GSBUSCFG1 = 0x00001700
GTXTHRCFG = 0x00000000
GRXTHRCFG = 0x00000000
GCTL = 0x00102000
GEVTEN = 0x00000000
GSTS = 0x7e800000
GUCTL1 = 0x810c1802
GSNPSID = 0x5533330a
GGPIO = 0x00000000
GUID = 0x00060500
GUCTL = 0x0d00c010
GBUSERRADDR0 = 0x00000000
GBUSERRADDR1 = 0x00000000
GPRTBIMAP0 = 0x00000000
GPRTBIMAP1 = 0x00000000
GHWPARAMS0 = 0x4020400a
GDBGFIFOSPACE = 0x00420000
GDBGLTSSM = 0x41090658
GDBGBMU = 0x20300000
GPRTBIMAP_HS0 = 0x00000000
GPRTBIMAP_HS1 = 0x00000000
GPRTBIMAP_FS0 = 0x00000000
GPRTBIMAP_FS1 = 0x00000000
GUCTL2 = 0x0198440d
VER_NUMBER = 0x00000000
VER_TYPE = 0x00000000
GUSB2PHYCFG(0) = 0x00002400
GUSB2I2CCTL(0) = 0x00000000
GUSB2PHYACC(0) = 0x00000000
GUSB3PIPECTL(0) = 0x030e0002
GTXFIFOSIZ(0) = 0x00000042
GRXFIFOSIZ(0) = 0x00000305
GEVNTADRLO(0) = 0xfffff000
GEVNTADRHI(0) = 0x0000000f
GEVNTSIZ(0) = 0x00001000
GEVNTCOUNT(0) = 0x00000000
GHWPARAMS8 = 0x000007ea
GUCTL3 = 0x00010000
GFLADJ = 0x8c80c8a0
DCFG = 0x00cc08b4
DCTL = 0x8cf00a00
DEVTEN = 0x00000257
DSTS = 0x008a5200
DGCMDPAR = 0x00000000
DGCMD = 0x00000000
DALEPENA = 0x0000000f
DEPCMDPAR2(0) = 0x00000000
DEPCMDPAR1(0) = 0xffffe000
DEPCMDPAR0(0) = 0x0000000f
DEPCMD(0) = 0x00000006
OCFG = 0x00000000
OCTL = 0x00000000
OEVT = 0x00000000
OEVTEN = 0x00000000
OSTS = 0x00000000

使用 sysfs 查看主机模式的文件系统属性

要查看总线详情，请运行以下命令。

lsusb

示例输出：

Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 03f0:134a HP, Inc Optical Mouse
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

要列出当前目录的内容，请运行以下命令。

cd /sys/bus/usb/devices/
ls

示例输出：

1-0:1.0  1-1  1-1:1.0  2-0:1.0  usb1  usb2

要查看有关 USB 设备的详细信息，请运行以下命令。

cat /sys/kernel/debug/usb/devices

示例输出：

T:  Bus=01 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#=  1 Spd=480  MxCh= 1
B:  Alloc=  0/800 us ( 0%), #Int=  0, #Iso=  0
D:  Ver= 2.00 Cls=09(hub  ) Sub=00 Prot=01 MxPS=64 #Cfgs=  1
P:  Vendor=1d6b ProdID=0002 Rev= 6.05
S:  Manufacturer=Linux 6.5.0-rc4 xhci-hcd
S:  Product=xHCI Host Controller
S:  SerialNumber=xhci-hcd.0.auto
C:* #Ifs= 1 Cfg#= 1 Atr=e0 MxPwr=  0mA
I:* If#= 0 Alt= 0 #EPs= 1 Cls=09(hub  ) Sub=00 Prot=00 Driver=hub
E:  Ad=81(I) Atr=03(Int.) MxPS=   4 Ivl=256ms

T:  Bus=01 Lev=01 Prnt=01 Port=00 Cnt=01 Dev#=  2 Spd=1.5  MxCh= 0
D:  Ver= 2.00 Cls=00(>ifc ) Sub=00 Prot=00 MxPS= 8 #Cfgs=  1
P:  Vendor=03f0 ProdID=134a Rev= 1.00
S:  Manufacturer=PixArt
S:  Product=HP USB Optical Mouse
C:* #Ifs= 1 Cfg#= 1 Atr=a0 MxPwr=100mA
I:* If#= 0 Alt= 0 #EPs= 1 Cls=03(HID  ) Sub=01 Prot=02 Driver=usbhid
E:  Ad=81(I) Atr=03(Int.) MxPS=   4 Ivl=10ms

T:  Bus=02 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#=  1 Spd=5000 MxCh= 1
B:  Alloc=  0/800 us ( 0%), #Int=  0, #Iso=  0
D:  Ver= 3.00 Cls=09(hub  ) Sub=00 Prot=03 MxPS= 9 #Cfgs=  1
P:  Vendor=1d6b ProdID=0003 Rev= 6.05
S:  Manufacturer=Linux 6.5.0-rc4 xhci-hcd
S:  Product=xHCI Host Controller
S:  SerialNumber=xhci-hcd.0.auto
C:* #Ifs= 1 Cfg#= 1 Atr=e0 MxPwr=  0mA
I:* If#= 0 Alt= 0 #EPs= 1 Cls=09(hub  ) Sub=00 Prot=00 Driver=hub
E:  Ad=81(I) Atr=03(Int.) MxPS=   4 Ivl=256ms

USB 示例

QCS6490：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts 有关 USB 驱动程序中的 RPM 更改和其他示例的信息，请参见 https://patchwork.kernel.org/project/linux-usb/list/?series=793939&archive=both。有关如何扁平化设备树的信息，请参见 https://lore.kernel.org/all/af60c05b-4a0f-51b8-486a-1fc601602515@quicinc.com/ 和 https://lore.kernel.org/all/20231016-dwc3-refactor-v1-0-ab4a84165470@quicinc.com/。 \

简介

架构

关键文档

技术

系统

发布说明

时钟

电压轨

中断

互连

使用时钟控制的 USB 控制器复位

使用寄存器的 USB 控制器软件复位

USB 控制器和 SoC 集成

xHCI 支持

USB Type-C 连接器系统软件接口（UCSI）

USB 功能

运行时电源管理

软件功能

USB 架构

USB 接口

USB 工具

配置 USB 引导加载程序

配置 USB 摄像头

前提条件：获取图像格式和大小

使用 Yavta 配置 USB 摄像头

在 Qualcomm IM SDK 中使用 GStreamer 配置 USB 摄像头

自定义 USB 设备

具有 diag 和 ADB 接口的 USB 组合的示例 shell 脚本

使用 configfs 自定义

启用和配置 UVC 用例

UAC 用例

USB 电力传输中的数据角色交换

验证 USB 设备

调试 USB 问题

跟踪 USB

USB regdump

使用 sysfs 查看主机模式的文件系统属性

USB 示例

简介

架构

关键文档

技术

系统

发布说明

​时钟

​电压轨

​中断

​互连

​使用时钟控制的 USB 控制器复位

​使用寄存器的 USB 控制器软件复位

​USB 控制器和 SoC 集成

​xHCI 支持

​USB Type-C 连接器系统软件接口（UCSI）

​USB 功能

​运行时电源管理

​软件功能

​USB 架构

​USB 接口

​USB 工具

​配置 USB 引导加载程序

​配置 USB 摄像头

​前提条件：获取图像格式和大小

​使用 Yavta 配置 USB 摄像头

​在 Qualcomm IM SDK 中使用 GStreamer 配置 USB 摄像头

​自定义 USB 设备

​具有 diag 和 ADB 接口的 USB 组合的示例 shell 脚本

​使用 configfs 自定义

​启用和配置 UVC 用例

​UAC 用例

​USB 电力传输中的数据角色交换

​验证 USB 设备

​调试 USB 问题

​跟踪 USB

​USB regdump

​使用 sysfs 查看主机模式的文件系统属性

​USB 示例

时钟

电压轨

中断

互连

使用时钟控制的 USB 控制器复位

使用寄存器的 USB 控制器软件复位

USB 控制器和 SoC 集成

xHCI 支持

USB Type-C 连接器系统软件接口（UCSI）

USB 功能

运行时电源管理

软件功能

USB 架构

USB 接口

USB 工具

配置 USB 引导加载程序

配置 USB 摄像头

前提条件：获取图像格式和大小

使用 Yavta 配置 USB 摄像头

在 Qualcomm IM SDK 中使用 GStreamer 配置 USB 摄像头

自定义 USB 设备

具有 diag 和 ADB 接口的 USB 组合的示例 shell 脚本

使用 configfs 自定义

启用和配置 UVC 用例

UAC 用例

USB 电力传输中的数据角色交换

验证 USB 设备

调试 USB 问题

跟踪 USB

USB regdump

使用 sysfs 查看主机模式的文件系统属性

USB 示例