1.概述
控制“多状态”USB设备的模式。一些新的USB设备有他们的专有Windows驱动板，其中大多数是WWAN和WLAN加密狗。当第一次插入时，它们就像一个闪存，并从那里开始安装Windows驱动程序。如果驱动程序已经安装，它会使存储设备消失，并显示一个新设备(主要是与调制解调器端口组合)。在Linux上，大多数情况下驱动程序作为内核模块可用，如“usbserial”或“option”。但是，设备最初默认绑定到“usb存储”。然后usb_modeswitch可以向设备发送提供的批量消息(很可能是一个大容量存储命令);此消息必须通过分析Windows驱动程序的动作来确定。在某些情况下，USB控制命令用于切换。这些情况由自定义函数处理，不需要提供批量消息。通常，程序是通过一组针对许多已知设备的配置来分发的，这允许在插入时对设备进行完全自动的处理，这可以通过将usb_modeswitch与udev守护进程启动的包装器脚本usb_modeswitch_dispatcher结合起来实现。注意，usb_modeswitch本身没有特定的Linux依赖项。
2.语法
usb_modeswitch [-heWQDIvpVPmM23rwKdHSOBGTNALnsRiuagft] [-c filename]
3.选项
| 选项 | 含义 |
|---|---|
| -h --help | 显示选项摘要 |
| -e --version | 打印版本信息并退出 |
| -v --default-vendor NUM | 要查找的Vendor ID(强制)，通常以十六进制数字的形式给出(例如:0x12d1)。每个USB设备由一个编号被指定给供应商由USB协会和一个编号为各自的模型(Product ID)被供应商选择 |
| -p --default-product NUM | 要查找的Product ID(必须) |
| -V --target-vendor NUM | 目标Vendor ID。当给定时，将搜索和检测最初为信息目的。如果成功检查(选项-s)是活动的，建议提供目标id(Vendor/Product)或目标类 |
| -j --find-mbim | 返回配置编号与MBIM接口和退出 |
| -P --target-product NUM | 目标Produnct ID |
| -b --bus-num NUM | 总线编号 |
| -g --device-num NUM | 如果bus和设备号码被提供，在一个特定的USB端口上的一个特定设备的处理是有保证的，相比之下只使用USB ID。这是重要的，如果在一个系统上有多个类似的设备 |
| -C --target-class NUM | 根据USB规范的目标设备类。有些设备在切换成功后仍保留原来的Vendor/Product ID。为了防止它们再次被处理，可以检查device类。对于未切换的设备，它总是8(存储类)，对于切换的调制解调器，它通常是0xff(特定于供应商)。在复合模式中，观察第一个接口的类 |
| -m --message-endpoint NUM | 用于数据传输的特定端点。只作测试用途;通常端点由设备属性决定 |
| -M --message-content STRING | 作为交换命令发送的批量消息。以十六进制字符串的形式提供 |
| -2, -3 --message-content2, --message-content3 STRING | 作为交换命令发送的其他批量消息。以十六进制字符串的形式提供。当与大容量存储命令一起使用时，强烈建议set -need-response符合规范并避免可能出现的错误 |
| -w --release-delay NUM | 在发出所有批量消息之后，在释放接口之前等待NUM毫秒。对于旧系统上的某些调制解调器(特别是在弹出消息后)是必需的 |
| -n --need-response | 读取对大容量存储命令传输的响应(命令状态包装器)。如果没有读取响应，一些设备在切换时有困难;大多数设备会立即消失。当发送带有-2和-3的多个大容量存储命令时，可能需要设置此选项以避免传输错误 |
| -r --response-endpoint NUM | 如果选项-n是活动的，尝试从那里读取对存储命令的响应。只作测试用途;通常端点由设备属性决定 |
| -K --std-eject | 应用标准的SCSI序列“允许介质删除”和“弹出”。意味着- n。一个“消息”可以添加-M，它将在弹出序列之后传输 |
| -d --detach-only | 只需分离当前驱动程序。对于一些早期设备成功切换来说，这已经足够了。否则，这个特性可以用作特殊情况下的“手术刀”，比如将驱动程序从单独的接口中分离出来 |
| -H --huawei-mode | 发送华为老式设备使用的特殊控制信息 |
| -J --huawei-new-mode | 发送一个特定的批量消息，所有新的华为设备都使用 |
| -S --sierra-mode | 发送一个由Sierra设备使用的特殊控制消息 |
| -G --gct-mode | 发送GCT芯片组使用的特殊控制消息 |
| -T --kobil-mode | 发送Kobil设备使用的特殊控制信息 |
| -N --sequans-mode | 发送一个特殊的控制信息使用Sequans芯片组 |
| -A --mobileaction-mode | 发送一个由移动操作设备使用的特殊控制消息 |
| -B --qisda-mode | 发送一个特殊的控制消息使用Qisda设备 |
| -E --quanta-mode | 发送量子设备使用的特殊控制信息 |
| -F --pantech-mode NUM | 发送由Pantech设备使用的特殊控制信息。值NUM将作为“wValue”在控制消息中使用 |
| -Z --blackberry-mode | 发送一些较新的黑莓设备使用的特殊控制信息 |
| -O --sony-mode | 采用索尼爱立信设备使用的特殊序列。意味着选择——check-success |
| -L --cisco-mode | 发送一系列由思科设备使用的批量消息 |
| -R --reset-usb | 发送USB复位命令到设备。可与任何切换方式组合或单独使用。它总是作为所有设备交互的最后一步来完成。很少有设备需要它来完成切换;除此之外，它在测试期间也很有用 |
| -c --config-file FILENAME | 使用特定的配置文件。如果在命令行参数中提供了任何ID或切换选项，则忽略该选项。在这种情况下，必须在命令行上提供所有强制参数 |
| -f --long-config STRING | 在配置文件语法中以命令行多行字符串的形式提供设备详细信息 |
| -t --stdinput | 在配置文件语法中从标准输入读取设备细节，例如从命令管道重定向(多行文本) |
| -Q --quiet | 不要显示进度或错误消息 |
| -W --verbose | 在运行之前打印所有设置并显示libusb调试消息 |
| -D --sysmode | 稍微改变程序的行为。发出一条包含有效目标设备ID的成功消息，并发出系统slog通知。主要用于与包装器脚本集成 |
| -s --check-success NUM | 切换后，继续检查结果，直到最大。NUM秒。如果提供了目标id或目标类，则它们的出现表明一定成功。否则，原设备的断开被视为可能的证据 |
| -I --no-inquire | 不要从设备获取SCSI属性(默认为on)。为了正确识别不同的设备，存储部分的属性提供了有价值的信息。对于已知和受支持的设备来说，这是不需要的 |
| -i --interface NUM | 选择初始USB接口(默认为0)。仅用于测试目的 |
| -u --configuration NUM | 选择USB配置(应用于任何其他可能的切换操作之后) |
| -a --altsetting NUM | 选择备用USB接口设置(切换后应用)。主要用于测试 |
温馨提示：
以上文章描述如有不清晰之处，欢迎在评论区评论，如有时间，会第一时间回复，谢谢！