USB - Qualcomm Dragonwing Documentation

通用串行总线(USB)支持电子设备之间的数据交换和供电,速率从 1.5 Mbps(低速)到 10 Gbps(SuperSpeed Plus)。IQ-8275 使用 Synopsys DesignWare Core SuperSpeed USB 3.x 控制器,连接到 USB2 PHY(UTMI)和 USB3 PHY(PIPE)接口。该开发板配备三个 USB 连接器:两个 Type-C(USB0、USB1)和一个 micro-USB(USB2)。

控制器

控制器	地址	最大速率
USB0	0xa600000	USB 3.x SuperSpeed
USB1	0xa800000	USB 3.x SuperSpeed
USB2	0xa400000	USB 2.0 High Speed

特性

硬件特性

特性	说明
双角色设备(DRD)	主机和设备模式,支持动态角色检测
USB 3.1 Gen1	USB0 和 USB1 上的 SuperSpeed 5 Gbps
USB 2.0 High Speed	所有控制器上的 480 Mbps
xHCI	符合 eXtensible Host Controller Interface 标准
传输类型	控制、批量、中断、等时

软件特性

外设模式: 大容量存储、诊断(FunctionFS)、RNDIS、NCM 主机模式: xHCI、HID/MS/Hub 类驱动、UVC(USB 摄像头)、链路电源管理

配置

运行时电源管理

echo auto > /sys/bus/platform/devices/a600000.usb/power/control
echo 2000 > /sys/bus/platform/devices/a600000.usb/power/autosuspend_delay_ms
cat /sys/bus/platform/devices/a600000.usb/power/runtime_status

在组合切换期间防止挂起

echo on > /sys/bus/platform/devices/a600000.usb/power/control
# Perform composition switch
echo auto > /sys/bus/platform/devices/a600000.usb/power/control

USB 摄像头

IQ-8275 通过 uvcvideo 内核驱动支持符合 USB 视频类(UVC)标准的 USB 摄像头,设备以 /dev/videoX 的形式暴露。

检测摄像头

lsusb
v4l2-ctl --list-devices
ls -l /dev/v4l/by-id/

检查支持的格式

yavta /dev/video2 --enum-formats

视频流

yavta
GStreamer

yavta -f MJPEG -s 1280x720 -t 1/30 -c10 -F/home/ubuntu/test.jpeg /dev/video2

export XDG_RUNTIME_DIR=/run/user/$(id -u ubuntu)
export WAYLAND_DISPLAY=wayland-1

gst-launch-1.0 -e v4l2src device=/dev/video2 ! \
  video/x-raw,format=YUY2,width=1280,height=720,framerate=30/1 ! \
  videoconvert ! waylandsink fullscreen=true

验证

lsusb                              # List connected USB devices
cat /sys/kernel/debug/usb/devices  # Detailed device info
cat /sys/kernel/debug/usb/a600000.usb/mode        # Check USB mode
cat /sys/kernel/debug/usb/a600000.usb/link_state  # Check link state

调试

mount -t debugfs none /sys/kernel/debug
echo 1 > /sys/kernel/debug/tracing/events/dwc3/enable
echo 1 > /sys/kernel/debug/tracing/events/xhci-hcd/enable
cat /sys/kernel/debug/tracing/trace

故障排除

USB 设备未被枚举

cat /sys/kernel/debug/usb/a600000.usb/mode
cat /sys/kernel/debug/usb/a600000.usb/link_state
dmesg | grep -i usb

重新绑定 gadget:qusb unbind && qusb bind
检查线缆连接和电源轨

USB 摄像头无法工作

lsusb
ls /dev/video*
dmesg | grep -i uvc
lsmod | grep uvcvideo

组合切换失败

echo on > /sys/bus/platform/devices/a600000.usb/power/control
qusb setpid <PID>
echo auto > /sys/bus/platform/devices/a600000.usb/power/control

​控制器

​特性

​硬件特性

​软件特性

​配置

​运行时电源管理

​在组合切换期间防止挂起

​USB 摄像头

​验证

​调试

​故障排除

​资源

控制器

特性