Debian Codegraph @

README

raw
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