Linux Certif

Toute la documentation sur la certification Linux LPI

usb_modeswitch

NAME

usb-modeswitch --- Switching tool for controlling "flip flop" USB devices

SYNOPSIS

usb-modeswitch [-hvpVPmMrdHn] [-c filename]

DESCRIPTION

This manual page was written for the Debian distribution because the original program does not have a manual page.
 

Several new USB devices have their proprietary Windows drivers onboard, especially WAN dongles. When plugged in for the first time, they act like a flash storage and start installing the driver from there. If the driver is already installed, the storage device vanishes and a new device, such as an USB modem, shows up. This is called the "ZeroCD" feature.
 

On Debian, this is not needed, since the driver is included as a Linux kernel module, such as "usbserial". However, the device still shows up as "usb-storage" by default. usb-modeswitch solves that issue by sending the command which actually performs the switching of the device from "usb-storage" to "usbserial".
 

OPTIONS

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-h --help

Show summary of options.

-v --DefaultVendor [nr]

Set Vendor number to look for.

-p --DefaultProduct [nr]

Set Model number to look for.

-V --TargetVendor [nr]

Target Vendor; needed for success check.

-P --TargetProduct [nr]

Target Model; needed for success check.

-C --TargetClass [nr]

Target Device Class; if found, quit

-m --MessageEndpoint [nr]

Where to direct command sequence

-M --MessageContent [nr]

Command sequence to send

-r --ResponseEndPoint [nr]

If given, read response from there

-d --DetachStorageOnly [1|0]

Whether to just detach the storage driver

-H --HuaweiMode [1|0]

Whether to just apply the Huawei mode

-S --SierraMode [1|0]

Whether to just apply the Sierra mode

-O --SonyMode [1|0]

Whether to just apply the Sony mode

-R --ResetUSB [1|0]

Whether to reset the device in the end

-c --config [filename]

Load different config file

-Q --quiet

Don't show progress or error messages

-W --verbose

Print all settings before running

-s --success [nr]

Check switching result after [nr] secs

-i --Interface

Select initial USB interface (default: 0)

-u --Configuration

Select USB configuration

-a --AltSetting

Select alternative USB interface setting

AUTHOR

This manual page was written by Didier Raboud didier@raboud.com for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
 

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.