设备测试¶
此文件总结了有关设备提供的 USB 功能的基本测试信息。
1. ACM 功能¶
该功能由 usb_f_acm.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“acm”。ACM 功能在其功能目录中仅提供一个属性
port_num
该属性是只读的。
系统中最多可以有 4 个 ACM/通用串行/OBEX 端口。
测试 ACM 功能¶
在主机上
cat > /dev/ttyACM<X>
在设备上
cat /dev/ttyGS<Y>
然后反过来
在设备上
cat > /dev/ttyGS<Y>
在主机上
cat /dev/ttyACM<X>
2. ECM 功能¶
该功能由 usb_f_ecm.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“ecm”。ECM 功能在其功能目录中提供这些属性
ifname
与此功能实例关联的网络设备接口名称
qmult
高速和超高速的队列长度乘数
host_addr
此以太网通过 USB 链接的主机端的 MAC 地址
dev_addr
此以太网通过 USB 链接的设备端的 MAC 地址
并且在创建 functions/ecm.<实例名称> 后，它们包含默认值：qmult 为 5，dev_addr 和 host_addr 是随机选择的。如果该功能未绑定，则可以写入 ifname。写入必须是“usb%d”之类的接口模式，这将导致 net core 选择下一个空闲的 usbX 接口。默认情况下，它设置为“usb%d”。
测试 ECM 功能¶
配置设备和主机的 IP 地址。然后
在设备上
ping <host's IP>
在主机上
ping <device's IP>
3. ECM 子集功能¶
该功能由 usb_f_ecm_subset.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“geth”。ECM 子集功能在其功能目录中提供这些属性
ifname
与此功能实例关联的网络设备接口名称
qmult
高速和超高速的队列长度乘数
host_addr
此以太网通过 USB 链接的主机端的 MAC 地址
dev_addr
此以太网通过 USB 链接的设备端的 MAC 地址
并且在创建 functions/ecm.<实例名称> 后，它们包含默认值：qmult 为 5，dev_addr 和 host_addr 是随机选择的。如果该功能未绑定，则可以写入 ifname。写入必须是“usb%d”之类的接口模式，这将导致 net core 选择下一个空闲的 usbX 接口。默认情况下，它设置为“usb%d”。
测试 ECM 子集功能¶
配置设备和主机的 IP 地址。然后
在设备上
ping <host's IP>
在主机上
ping <device's IP>
4. EEM 功能¶
该功能由 usb_f_eem.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“eem”。EEM 功能在其功能目录中提供这些属性
ifname
与此功能实例关联的网络设备接口名称
qmult
高速和超高速的队列长度乘数
host_addr
此以太网通过 USB 链接的主机端的 MAC 地址
dev_addr
此以太网通过 USB 链接的设备端的 MAC 地址
并且在创建 functions/eem.<实例名称> 后，它们包含默认值：qmult 为 5，dev_addr 和 host_addr 是随机选择的。如果该功能未绑定，则可以写入 ifname。写入必须是“usb%d”之类的接口模式，这将导致 net core 选择下一个空闲的 usbX 接口。默认情况下，它设置为“usb%d”。
测试 EEM 功能¶
配置设备和主机的 IP 地址。然后
在设备上
ping <host's IP>
在主机上
ping <device's IP>
5. FFS 功能¶
该功能由 usb_f_fs.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“ffs”。该功能目录有意为空且不可修改。
创建目录后，系统中会有一个新的 FunctionFS 实例（一个“设备”）可用。一旦“设备”可用，用户应遵循使用 FunctionFS 的标准流程（挂载它，运行实现适当功能的用户空间进程）。应通过将合适的字符串写入 usb_gadget/<gadget>/UDC 来启用设备。
FFS 功能在其功能目录中仅提供一个属性
ready
该属性是只读的，并表示该功能是否已准备好 (1) 使用，例如，如果用户空间已将描述符和字符串写入 ep0，则可以启用该设备。
测试 FFS 功能¶
在设备上：启动该功能的用户空间守护进程，启用该设备
在主机上：使用设备提供的 USB 功能
6. HID 功能¶
该功能由 usb_f_hid.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“hid”。HID 功能在其功能目录中提供这些属性
protocol
要使用的 HID 协议
report_desc
HID 报告中使用的数据，但通过 /dev/hidg<X> 传递的数据除外
report_length
HID 报告长度
subclass
要使用的 HID 子类
对于键盘，协议和子类为 1，report_length 为 8，而 report_desc 为
$ hd my_report_desc
00000000 05 01 09 06 a1 01 05 07 19 e0 29 e7 15 00 25 01 |..........)...%.|
00000010 75 01 95 08 81 02 95 01 75 08 81 03 95 05 75 01 |u.......u.....u.|
00000020 05 08 19 01 29 05 91 02 95 01 75 03 91 03 95 06 |....).....u.....|
00000030 75 08 15 00 25 65 05 07 19 00 29 65 81 00 c0 |u...%e....)e...|
0000003f
可以使用 echo 将这样的字节序列存储到属性中
$ echo -ne \\x05\\x01\\x09\\x06\\xa1.....
测试 HID 功能¶
设备
创建设备
将设备连接到主机，最好不是用于控制设备的主机
运行一个写入 /dev/hidg<N> 的程序，例如在 Linux USB HID 设备驱动程序 中找到的用户空间程序
$ ./hid_gadget_test /dev/hidg0 keyboard
主机
观察来自设备的击键
7. LOOPBACK 功能¶
该功能由 usb_f_ss_lb.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“Loopback”。LOOPBACK 功能在其功能目录中提供这些属性
qlen
环回队列的深度
bulk_buflen
缓冲区长度
测试 LOOPBACK 功能¶
设备：运行该设备
主机：test-usb (tools/usb/testusb.c)
8. 大容量存储功能¶
该功能由 usb_f_mass_storage.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“mass_storage”。MASS STORAGE 功能在其目录中提供这些属性：files
stall
设置为允许功能暂停批量端点。在已知无法正常工作的某些 USB 设备上禁用。您应该将其设置为 true。
num_buffers
管道缓冲区的数量。有效数字为 2..4。仅当设置了 CONFIG_USB_GADGET_DEBUG_FILES 时才可用。
以及与 SCSI LUN #0 对应的默认 lun.0 目录。
可以使用 mkdir 添加新的 lun
$ mkdir functions/mass_storage.0/partition.5
Lun 编号不必连续，但默认创建的 lun #0 除外。最多可以指定 8 个 lun，并且它们都必须按照 <name>.<number> 方案命名。数字可以是 0..8。可能一个好的约定是将 lun 命名为“lun.<number>”，尽管这不是强制性的。
在每个 lun 目录中，都有以下属性文件
file
LUN 的后备文件的路径。如果 LUN 未标记为可移动，则为必需项。
ro
指定 LUN 访问应为只读的标志。如果启用了 CD-ROM 仿真，以及无法在 R/W 模式下打开“文件名”，则也暗示了这一点。
removable
指定应将 LUN 指示为可移动的标志。
cdrom
指定应将 LUN 报告为 CD-ROM 的标志。
nofua
指定 SCSI WRITE(10,12) 中 FUA 标志的标志
forced_eject
此只写文件仅在功能处于活动状态时有用。它会导致后备文件强制从 LUN 中分离，而不管主机是否允许。写入的任何非零字节数都会导致弹出。
测试 MASS STORAGE 功能¶
设备：连接设备，启用它主机：dmesg，查看出现的 USB 驱动器（如果系统配置为自动挂载）
9. MIDI 功能¶
该功能由 usb_f_midi.ko 模块提供。
特定于功能的 configfs 接口¶
创建功能目录时要使用的功能名称是“midi”。MIDI 功能在其功能目录中提供这些属性
buflen
MIDI 缓冲区长度
id
USB MIDI 适配器的 ID 字符串
in_ports
MIDI 输入端口的数量
index
USB MIDI 适配器的索引值
out_ports
MIDI 输出端口的数量
qlen
USB 读取请求队列长度
测试 MIDI 功能¶
有两种情况：从设备向主机播放 mid 和从主机向设备播放 mid。
从设备向主机播放 mid
主机
$ arecordmidi -l
Port Client name Port name
14:0 Midi Through Midi Through Port-0
24:0 MIDI Gadget MIDI Gadget MIDI 1
$ arecordmidi -p 24:0 from_gadget.mid
设备
$ aplaymidi -l
Port Client name Port name
20:0 f_midi f_midi
$ aplaymidi -p 20:0 to_host.mid
从主机向设备播放 mid
设备
$ arecordmidi -l
Port Client name Port name
20:0 f_midi f_midi
$ arecordmidi -p 20:0 from_host.mid
主机
$ aplaymidi -l
Port Client name Port name
14:0 Midi Through Midi Through Port-0
24:0 MIDI Gadget MIDI Gadget MIDI 1
$ aplaymidi -p24:0 to_gadget.mid
from_gadget.mid 的声音应与 to_host.mid 的声音相同。
from_host.id 的声音应与 to_gadget.mid 的声音相同。
可以使用例如安装了 timidity 的软件，将 MIDI 文件播放到扬声器/耳机。
$ aplaymidi -l
Port Client name Port name
14:0 Midi Through Midi Through Port-0
24:0 MIDI Gadget MIDI Gadget MIDI 1
128:0 TiMidity TiMidity port 0
128:1 TiMidity TiMidity port 1
128:2 TiMidity TiMidity port 2
128:3 TiMidity TiMidity port 3
$ aplaymidi -p 128:0 file.mid
可以使用 aconnect 工具逻辑地连接 MIDI 端口，例如：
$ aconnect 24:0 128:0 # try it on the host
在将设备 MIDI 端口连接到 timidity 的 MIDI 端口后，无论在设备端使用 aplaymidi -l 播放什么，都可以在主机的扬声器/耳机中听到。
10. NCM 功能¶
此功能由 usb_f_ncm.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“ncm”。 NCM 功能在其功能目录中提供以下属性：
ifname
与此功能实例关联的网络设备接口名称
qmult
高速和超高速的队列长度乘数
host_addr
此以太网通过 USB 链接的主机端的 MAC 地址
dev_addr
此以太网通过 USB 链接的设备端的 MAC 地址
max_segment_size
P2P 连接所需的段大小。这将设置 MTU 为 14 字节。
并且在创建 functions/ncm.<实例名称> 后，它们包含默认值：qmult 为 5，dev_addr 和 host_addr 是随机选择的。如果该功能未绑定，则可以写入 ifname。写入的内容必须是诸如“usb%d”的接口模式，这将导致网络核心选择下一个空闲的 usbX 接口。默认情况下，它设置为“usb%d”。
测试 NCM 功能¶
配置设备和主机的 IP 地址。然后
在设备上
ping <host's IP>
在主机上
ping <device's IP>
11. OBEX 功能¶
此功能由 usb_f_obex.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“obex”。 OBEX 功能在其功能目录中仅提供一个属性：
port_num
该属性是只读的。
系统中最多可以有 4 个 ACM/通用串行/OBEX 端口。
测试 OBEX 功能¶
在设备上
seriald -f /dev/ttyGS<Y> -s 1024
在主机上
serialc -v <vendorID> -p <productID> -i<interface#> -a1 -s1024 \
-t<out endpoint addr> -r<in endpoint addr>
其中 seriald 和 serialc 是 Felipe 在此处找到的实用程序：
12. PHONET 功能¶
此功能由 usb_f_phonet.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“phonet”。 PHONET 功能在其功能目录中仅提供一个属性：
ifname
与此功能实例关联的网络设备接口名称
测试 PHONET 功能¶
在没有特定硬件的情况下，无法测试 SOCK_STREAM 协议，因此仅测试了 SOCK_DGRAM。为了使后者工作，过去我必须应用此处提到的补丁：
http://www.spinics.net/lists/linux-usb/msg85689.html
需要这些工具：
git://git.gitorious.org/meego-cellular/phonet-utils.git
在主机上
$ ./phonet -a 0x10 -i usbpn0
$ ./pnroute add 0x6c usbpn0
$./pnroute add 0x10 usbpn0
$ ifconfig usbpn0 up
在设备上
$ ./phonet -a 0x6c -i upnlink0
$ ./pnroute add 0x10 upnlink0
$ ifconfig upnlink0 up
然后可以使用一个测试程序：
http://www.spinics.net/lists/linux-usb/msg85690.html
在设备上
$ ./pnxmit -a 0x6c -r
在主机上
$ ./pnxmit -a 0x10 -s 0x6c
结果，一些数据应该从主机发送到设备。然后反之亦然。
在主机上
$ ./pnxmit -a 0x10 -r
在设备上
$ ./pnxmit -a 0x6c -s 0x10
13. RNDIS 功能¶
此功能由 usb_f_rndis.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“rndis”。 RNDIS 功能在其功能目录中提供以下属性：
ifname
与此功能实例关联的网络设备接口名称
qmult
高速和超高速的队列长度乘数
host_addr
此以太网通过 USB 链接的主机端的 MAC 地址
dev_addr
此以太网通过 USB 链接的设备端的 MAC 地址
并且在创建 functions/rndis.<实例名称> 后，它们包含默认值：qmult 为 5，dev_addr 和 host_addr 是随机选择的。如果该功能未绑定，则可以写入 ifname。写入的内容必须是诸如“usb%d”的接口模式，这将导致网络核心选择下一个空闲的 usbX 接口。默认情况下，它设置为“usb%d”。
测试 RNDIS 功能¶
配置设备和主机的 IP 地址。然后
在设备上
ping <host's IP>
在主机上
ping <device's IP>
14. SERIAL 功能¶
此功能由 usb_f_gser.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“gser”。 SERIAL 功能在其功能目录中仅提供一个属性：
port_num
该属性是只读的。
系统中最多可以有 4 个 ACM/通用串行/OBEX 端口。
测试 SERIAL 功能¶
在主机上
insmod usbserial
echo VID PID >/sys/bus/usb-serial/drivers/generic/new_id
在主机上
cat > /dev/ttyUSB<X>
在目标设备上：
cat /dev/ttyGS<Y>
然后反过来
在目标设备上：
cat > /dev/ttyGS<Y>
在主机上
cat /dev/ttyUSB<X>
15. SOURCESINK 功能¶
该功能由 usb_f_ss_lb.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“SourceSink”。 SOURCESINK 功能在其功能目录中提供以下属性：
pattern
0（全零），1（mod63），2（无）
isoc_interval
1..16
isoc_maxpacket
0 - 1023（fs），0 - 1024（hs/ss）
isoc_mult
0..2 (仅限 hs/ss)
isoc_maxburst
0..15 (仅限 ss)
bulk_buflen
缓冲区长度
bulk_qlen
批量队列的深度
iso_qlen
ISO 队列的深度
测试 SOURCESINK 功能¶
设备：运行该设备
主机：test-usb (tools/usb/testusb.c)
16. UAC1 功能（旧版实现）¶
此功能由 usb_f_uac1_legacy.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“uac1_legacy”。 uac1 功能在其功能目录中提供以下属性：
audio_buf_size
音频缓冲区大小
fn_cap
捕获 PCM 设备文件名
fn_cntl
控制设备文件名
fn_play
播放 PCM 设备文件名
req_buf_size
ISO OUT 端点请求缓冲区大小
req_count
ISO OUT 端点请求计数
这些属性具有合理的默认值。
测试 UAC1 功能¶
设备：运行该设备
主机
aplay -l # should list our USB Audio Gadget
17. UAC2 功能¶
此功能由 usb_f_uac2.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“uac2”。 uac2 功能在其功能目录中提供以下属性：
c_chmask
捕获通道掩码
c_srate
捕获采样率列表（以逗号分隔）
c_ssize
捕获样本大小（字节）
c_sync
捕获同步类型 (async/adaptive)
c_mute_present
启用捕获静音控制
c_volume_present
启用捕获音量控制
c_volume_min
捕获音量控制最小值 (1/256 dB)
c_volume_max
捕获音量控制最大值 (1/256 dB)
c_volume_res
捕获音量控制分辨率 (1/256 dB)
c_hs_bint
HS/SS 的捕获 bInterval (1-4: 固定, 0: 自动)
fb_max
异步模式下的最大额外带宽
p_chmask
播放通道掩码
p_srate
播放采样率列表（以逗号分隔）
p_ssize
播放样本大小（字节）
p_mute_present
启用播放静音控制
p_volume_present
启用播放音量控制
p_volume_min
播放音量控制最小值 (1/256 dB)
p_volume_max
播放音量控制最大值 (1/256 dB)
p_volume_res
播放音量控制分辨率 (1/256 dB)
p_hs_bint
HS/SS 的播放 bInterval (1-4: 固定, 0: 自动)
req_number
为捕获和播放预分配的请求数量
function_name
接口名称
if_ctrl_name
拓扑控制名称
clksrc_in_name
输入时钟名称
clksrc_out_name
输出时钟名称
p_it_name
播放输入终端名称
p_it_ch_name
播放输入第一个通道名称
p_ot_name
播放输出终端名称
p_fu_vol_name
播放功能单元名称
c_it_name
捕获输入终端名称
c_it_ch_name
捕获输入第一个通道名称
c_ot_name
捕获输出终端名称
c_fu_vol_name
捕获功能单元名称
c_terminal_type
捕获终端类型的代码
p_terminal_type
播放终端类型的代码
这些属性具有合理的默认值。
测试 UAC2 功能¶
设备：运行 gadget 主机：aplay -l # 应该列出我们的 USB 音频 Gadget
此功能不需要真正的硬件支持，它只是将音频数据流发送到主机/从主机发送数据。为了在设备端实际听到声音，必须在设备端使用类似于以下的命令：
$ arecord -f dat -t wav -D hw:2,0 | aplay -D hw:0,0 &
例如：
$ arecord -f dat -t wav -D hw:CARD=UAC2Gadget,DEV=0 | \
aplay -D default:CARD=OdroidU3
18. UVC 功能¶
此功能由 usb_f_uvc.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“uvc”。 uvc 功能在其功能目录中提供以下属性：
streaming_interval
轮询端点进行数据传输的间隔
streaming_maxburst
超高速配套描述符的 bMaxBurst
streaming_maxpacket
当选择此配置时，此端点能够发送或接收的最大数据包大小
function_name
接口名称
还有“control”和“streaming”子目录，每个子目录都包含许多子目录。 提供了一些合理的默认值，但用户必须提供以下内容：
控制头
在 control/header 中创建，从 control/class/fs 和/或 control/class/ss 链接
流头
在 streaming/header 中创建，从 streaming/class/fs 和/或 streaming/class/hs 和/或 streaming/class/ss 链接
格式描述
在 streaming/mjpeg 和/或 streaming/uncompressed 中创建
帧描述
在 streaming/mjpeg/<format> 和/或 streaming/uncompressed/<format> 中创建
每个帧描述都包含帧间隔规范，并且每个这样的规范都由多行组成，每行都有一个间隔值。 上述规则最好用一个示例来说明：
# mkdir functions/uvc.usb0/control/header/h
# cd functions/uvc.usb0/control/
# ln -s header/h class/fs
# ln -s header/h class/ss
# mkdir -p functions/uvc.usb0/streaming/uncompressed/u/360p
# cat <<EOF > functions/uvc.usb0/streaming/uncompressed/u/360p/dwFrameInterval
666666
1000000
5000000
EOF
# cd $GADGET_CONFIGFS_ROOT
# mkdir functions/uvc.usb0/streaming/header/h
# cd functions/uvc.usb0/streaming/header/h
# ln -s ../../uncompressed/u
# cd ../../class/fs
# ln -s ../../header/h
# cd ../../class/hs
# ln -s ../../header/h
# cd ../../class/ss
# ln -s ../../header/h
测试 UVC 功能¶
设备：运行 gadget，modprobe vivid
# uvc-gadget -u /dev/video<uvc video node #> -v /dev/video<vivid video node #>
- 其中 uvc-gadget 是此程序：
带有这些补丁：
主机
luvcview -f yuv
19. PRINTER 功能¶
此功能由 usb_f_printer.ko 模块提供。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“printer”。 打印机功能在其功能目录中提供以下属性：
pnp_string
要在 pnp 字符串中传递给主机的数据
q_len
每个端点的请求数
测试 PRINTER 功能¶
最基本的测试：
设备：运行该设备
# ls -l /devices/virtual/usb_printer_gadget/
应显示 g_printer<数字>。
如果 udev 处于活动状态，则 /dev/g_printer<数字> 应该会自动出现。
主机
如果 udev 处于活动状态，则例如 /dev/usb/lp0 应该会出现。
主机 -> 设备传输：
设备：
# cat /dev/g_printer<number>
主机
# cat > /dev/usb/lp0
设备 -> 主机传输：
# cat > /dev/g_printer<number>
主机
# cat /dev/usb/lp0
可以使用 Linux USB 打印机 Gadget 驱动程序 中描述的 prn_example 进行更高级的测试。
20. UAC1 功能（虚拟 ALSA 声卡，使用 u_audio API）¶
此功能由 usb_f_uac1.ko 模块提供。它将创建一个虚拟 ALSA 声卡，并且音频流只是从该声卡接收和发送。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“uac1”。uac1 功能在其功能目录中提供以下属性：
c_chmask
捕获通道掩码
c_srate
捕获采样率列表（以逗号分隔）
c_ssize
捕获样本大小（字节）
c_mute_present
启用捕获静音控制
c_volume_present
启用捕获音量控制
c_volume_min
捕获音量控制最小值 (1/256 dB)
c_volume_max
捕获音量控制最大值 (1/256 dB)
c_volume_res
捕获音量控制分辨率 (1/256 dB)
p_chmask
播放通道掩码
p_srate
播放采样率列表（以逗号分隔）
p_ssize
播放样本大小（字节）
p_mute_present
启用播放静音控制
p_volume_present
启用播放音量控制
p_volume_min
播放音量控制最小值 (1/256 dB)
p_volume_max
播放音量控制最大值 (1/256 dB)
p_volume_res
播放音量控制分辨率 (1/256 dB)
req_number
为捕获和回放预分配的请求数量
function_name
接口名称
p_it_name
播放输入终端名称
p_it_ch_name
回放通道名称
p_ot_name
播放输出终端名称
p_fu_vol_name
回放静音/音量功能单元名称
c_it_name
捕获输入终端名称
c_it_ch_name
捕获通道名称
c_ot_name
捕获输出终端名称
c_fu_vol_name
捕获静音/音量功能单元名称
这些属性具有合理的默认值。
测试 UAC1 功能¶
设备：运行 gadget 主机：aplay -l # 应该列出我们的 USB 音频 Gadget
此功能不需要真正的硬件支持，它只是将音频数据流发送到主机/从主机发送数据。为了在设备端实际听到声音，必须在设备端使用类似于以下的命令：
$ arecord -f dat -t wav -D hw:2,0 | aplay -D hw:0,0 &
例如：
$ arecord -f dat -t wav -D hw:CARD=UAC1Gadget,DEV=0 | \
aplay -D default:CARD=OdroidU3
21. MIDI2 功能¶
该功能由 usb_f_midi2.ko 模块提供。它将创建一个虚拟 ALSA 声卡，其中包含一个 UMP rawmidi 设备，UMP 数据包将在其中环回。此外，还会创建一个传统的 rawmidi 设备。UMP rawmidi 也绑定到 ALSA 音序器客户端。
功能特定的 configfs 接口¶
创建功能目录时使用的功能名称为“midi2”。midi2 功能在其功能目录中提供以下属性作为卡片顶层信息：
process_ump
用于处理 UMP 流消息的布尔标志（0 或 1）
static_block
用于静态块的布尔标志（0 或 1）
iface_name
可选的接口名称字符串
该目录包含一个子目录“ep.0”，它为 UMP 端点（USB MIDI 端点的对）提供属性：
protocol_caps
MIDI 协议功能；1：MIDI 1.0，2：MIDI 2.0，或 3：两种协议
protocol
默认 MIDI 协议（1 或 2）
ep_name
UMP 端点名称字符串
product_id
产品 ID 字符串
manufacturer
制造商 ID 号（24 位）
family
设备系列 ID 号（16 位）
model
设备型号 ID 号（16 位）
sw_revision
软件版本号（32 位）
每个端点子目录都包含一个子目录“block.0”，它表示块 0 信息的函数块。其属性如下：
name
函数块名称字符串
direction
此函数块的方向 1：输入，2：输出，或 3：双向
first_group
第一个 UMP 组号（0-15）
num_groups
此函数块中的组数（1-16）
midi1_first_group
MIDI 1.0 的第一个 UMP 组号（0-15）
midi1_num_groups
MIDI 1.0 的组数（0-16）
ui_hint
此函数块的 UI 提示 0：未知，1：接收器，2：发送器，3：两者
midi_ci_verison
支持的 MIDI-CI 版本号（8 位）
is_midi1
旧版 MIDI 1.0 设备（0-2）0：MIDI 2.0 设备，1：无限制的 MIDI 1.0，或 2：低速的 MIDI 1.0
sysex8_streams
SysEx8 流的最大数量（8 位）
active
函数块活动状态的布尔标志（0 或 1）
如果需要多个函数块，您可以通过创建子目录“block.<num>”并使用相应的函数块编号（1、2...）来添加更多函数块。也可以动态删除函数块子目录。请注意，函数块编号必须是连续的。
同样，如果需要多个 UMP 端点，可以通过创建子目录“ep.<num>”来添加更多端点。编号必须是连续的。
要模拟不支持 UMP v1.1 的旧 MIDI 2.0 设备，请将 0 传递给 process_ump 标志。然后，整个 UMP v1.1 请求将被忽略。
测试 MIDI2 功能¶
在设备上：运行 gadget，并运行
$ cat /proc/asound/cards
将会显示一个包含 MIDI2 设备的新声卡。
另一方面，在主机上
$ cat /proc/asound/cards
将会显示一个包含 MIDI1 或 MIDI2 设备的新声卡，具体取决于 USB 音频驱动程序配置。
在这两者上，当主机上启用 ALSA 音序器时，您可以找到 UMP MIDI 客户端，例如“MIDI 2.0 Gadget”。
由于驱动程序只是简单地环回数据，因此无需为了测试而使用真正的设备。
要测试从 gadget 到主机的 MIDI 输入（例如，模拟 MIDI 键盘），您可以发送如下 MIDI 流。
在 gadget 上
$ aconnect -o
....
client 20: 'MIDI 2.0 Gadget' [type=kernel,card=1]
0 'MIDI 2.0 '
1 'Group 1 (MIDI 2.0 Gadget I/O)'
$ aplaymidi -p 20:1 to_host.mid
在主机上
$ aconnect -i
....
client 24: 'MIDI 2.0 Gadget' [type=kernel,card=2]
0 'MIDI 2.0 '
1 'Group 1 (MIDI 2.0 Gadget I/O)'
$ arecordmidi -p 24:1 from_gadget.mid
如果您有一个支持 UMP 的应用程序，您也可以使用 UMP 端口发送/接收原始 UMP 数据包。例如，具有 UMP 支持的 aseqdump 程序可以从 UMP 端口接收。在主机上
$ aseqdump -u 2 -p 24:1
Waiting for data. Press Ctrl+C to end.
Source Group Event Ch Data
24:1 Group 0, Program change 0, program 0, Bank select 0:0
24:1 Group 0, Channel pressure 0, value 0x80000000
要测试从主机到 gadget 的 MIDI 输出（例如，模拟 MIDI 合成器），则反之亦然。
在 gadget 上
$ arecordmidi -p 20:1 from_host.mid
在主机上
$ aplaymidi -p 24:1 to_gadget.mid
支持在主机上 altset 0 上访问 MIDI 1.0，并且它在 gadget 上从/到 UMP 数据包进行转换。它仅绑定到函数块 0。
可以在 SND_CTL_IFACE_RAWMIDI 的 ALSA 控制元素 “Operation Mode” 中观察当前的操作模式。例如
$ amixer -c1 contents
numid=1,iface=RAWMIDI,name='Operation Mode'
; type=INTEGER,access=r--v----,values=1,min=0,max=2,step=0
: values=2
其中 0 = 未使用，1 = MIDI 1.0 (altset 0)，2 = MIDI 2.0 (altset 1)。上面的示例显示它在 2 中运行，即 MIDI 2.0。