| 1 |
README for USB_ModeSwitch Data |
| 2 |
|
| 3 |
Almost all new and corrected device configurations since around 2012 |
| 4 |
were collected and compiled by Lars Melin. Thank you! |
| 5 |
|
| 6 |
Without a well-maintained base of configuration info, usb_modeswitch |
| 7 |
would just be a useless blob of code. So: |
| 8 |
|
| 9 |
PLEASE REPORT NEW DEVICES ! |
| 10 |
|
| 11 |
For up-to-date and detailed information (plus a friendly forum) visit |
| 12 |
http://www.draisberghof.de/usb_modeswitch |
| 13 |
|
| 14 |
|
| 15 |
|
| 16 |
This is a data package to complement the full release package of |
| 17 |
USB_ModeSwitch, a tool to switch multi-mode USB devices. |
| 18 |
It is used since usb-modeswitch version 1.0.3. |
| 19 |
|
| 20 |
Recommended version of usb-modeswitch package is 2.4.0 and above. |
| 21 |
|
| 22 |
|
| 23 |
Installation |
| 24 |
============ |
| 25 |
|
| 26 |
Just run "make install". To re-generate udev rules file (Note: "tcl" |
| 27 |
package required), type "make clean" and install again . |
| 28 |
|
| 29 |
|
| 30 |
Tasks initiated by the rules file: |
| 31 |
================================== |
| 32 |
|
| 33 |
- call tiny shell script in /lib/udev which in turn calls the wrapper |
| 34 |
(/usr/sbin/usb_modeswitch_dispatcher) to initiate switching for known |
| 35 |
devices when plugged in or present at boot time |
| 36 |
|
| 37 |
- adding symlink "gsmmodem" to appropriate connection port (out of 2-5 |
| 38 |
ports provided by some devices); this is only a convenience feature and |
| 39 |
NOT needed for switching or later port operation. |
| 40 |
This action will be triggered for known modems only (at least switched |
| 41 |
once before on this system) |
| 42 |
|
| 43 |
|
| 44 |
Explanation about config file names: |
| 45 |
==================================== |
| 46 |
|
| 47 |
Names consist of <VendorID>:<ProductID>, respective to the default device |
| 48 |
mode. |
| 49 |
Should more detailed identification become necessary, one or more attributes |
| 50 |
to test can be attached after further colons: |
| 51 |
<VendorID>:<ProductID>:<Attribute>=<String>[:<Attribute>=<String> ...] |
| 52 |
|
| 53 |
The strings match if they are part of the attribute content. Use "_" |
| 54 |
to match spaces (it will match "_" too!). |
| 55 |
|
| 56 |
Currently recognized attributes are: |
| 57 |
|
| 58 |
uMa = USB, iManufacturer |
| 59 |
uPr = USB, iProduct |
| 60 |
uSe = USB, iSerial |
| 61 |
sVe = SCSI, Vendor |
| 62 |
sMo = SCSI, Model |
| 63 |
sRe = SCSI, Revision |
| 64 |
|
| 65 |
This list is easily extendable should it be necessary. |
| 66 |
|
| 67 |
Example: |
| 68 |
<vid>:<pid>:uPr=CDMA_Mo will match iProduct "CDMA Modem" or "MyCDMA_Mordor" |
| 69 |
|
| 70 |
|
| 71 |
Generic config files (per vendor ID): |
| 72 |
===================================== |
| 73 |
|
| 74 |
Introduced in program package 2.2.0, this feature allows config files with a |
| 75 |
name in the form <idVendor>:#<system flavour>. The default flavour is "linux". |
| 76 |
|
| 77 |
The system parameter is taken from "/proc/version". The main use currently is |
| 78 |
a sort of OS switch to treat all Huawei devices differently on Android. |
| 79 |
There is no guarantee though that the /proc/version information will always |
| 80 |
point to Android, so this method may change in future versions. |
| 81 |
|
| 82 |
Annother form of usage is a fallback if the device ID is yet unknown. For |
| 83 |
Huawei devices, the switching method is uniform and not likely to change, |
| 84 |
so it is possible to provide a generic configuration. |
| 85 |
|
| 86 |
Example file names: "12d1:#android" and "12d1:#linux" |
| 87 |
|
| 88 |
Note that these files have to be created explicitely on demand. Their default |
| 89 |
inclusion has led to unwanted switching attempts with unrelated devices like |
| 90 |
phones. |
| 91 |
|
| 92 |
|
| 93 |
Parameters used only in config files: |
| 94 |
===================================== |
| 95 |
|
| 96 |
These are not evaluated by the binary but by the wrapper. |
| 97 |
|
| 98 |
- WaitBefore=<seconds> delay the switching process |
| 99 |
|
| 100 |
See also complete parameter explanation in REFERENCE. |
| 101 |
|
| 102 |
|
| 103 |
Notes about specific devices: |
| 104 |
============================= |
| 105 |
|
| 106 |
- Huawei devices have a generic entry in the rules file; also there are |
| 107 |
generic config files for these devices (Linux/Android) as fall-back or |
| 108 |
as OS-specific mode control. This was suggested and approved by the |
| 109 |
manufacturer |
| 110 |
|
| 111 |
- 1266:1000 (Royaltek Q110): switching method very likely but unconfirmed |
| 112 |
|
| 113 |
- 05c6:2000 (unnamed HSDPA modem from "dealextreme"): unusually long switching |
| 114 |
time reported, even with MS Windoze - 30 to 40 seconds. Don't be alarmed. |
| 115 |
|
| 116 |
- 0471:1210 (Philips chipset): had to be split after variants with different |
| 117 |
targets and behaviour appeared. This is not fully confirmed yet, please |
| 118 |
report problems. |
| 119 |
|
| 120 |
- 1004:6190 (LG AD600): seems to require an unusually wait before starting the |
| 121 |
modeswitch (10 secs) |
| 122 |
|
| 123 |
|
| 124 |
Legal |
| 125 |
===== |
| 126 |
|
| 127 |
This program is free software; you can redistribute it and/or modify it under |
| 128 |
the terms of the GNU General Public License as published by the Free Software |
| 129 |
Foundation; either version 2 of the License, or (at your option) any later |
| 130 |
version. |
| 131 |
|
| 132 |
This program is distributed in the hope that it will be useful, but WITHOUT ANY |
| 133 |
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A |
| 134 |
PARTICULAR PURPOSE. See the GNU General Public License for more details: |
| 135 |
|
| 136 |
http://www.gnu.org/licenses/gpl.txt |
| 137 |
|
| 138 |
Or find it as the file COPYING in this folder. |
| 139 |
|
| 140 |
|
| 141 |
|
| 142 |
|
| 143 |
Last revised: 2017-02-05, Josua Dietze |