~ubuntu-branches/ubuntu/quantal/usb-modeswitch/quantal

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Didier Raboud
  • Date: 2009-11-03 11:02:31 UTC
  • Revision ID: james.westby@ubuntu.com-20091103110231-6ldcm8jt48x39qix
Tags: 1.0.5-1
* New 1.0.5 upstream version
  - Configurations are now stored in independent files under
    /etc/usb_modeswitch.d/
  - The devices detection is greatly improved by having a broader set of
    detection fields (Closes: #527122).
  - Two new binaries: usb_modeswitch_sh and usb_modeswitch_tcl.
* Adaptation to new upstream:
  - Add tclsh to Depends.
  - Drop mkrules.py and thus python B-D (Closes: #535445).
  - Update manpage to 1.0.5 (add --version)
* Patches:
  - 01_correct_broken_huawei_conf.patch : refresh. 
  - 02_umconf_is_no_exec.patch          : remove, merged upstream.
  - 03_build_system_to_policy.patch     : refresh.
  - 04_convert_umconf_to_unicode.patch  : Add to get everything in utf-8.
                                          Thanks to W. Martin Borgert.
  - 05_move_wrappers_to_usr.patch       : Add. Moves wrappers to specific
                                          /usr/share/usb_modeswitch
  - 06_disables_rules.patch             : Add to get the udev rules "opt-in"
                                          (See NEWS.Debian)
  - Add headers to make them all comply to DEP-3 Patch Tagging Guidelines.
* Bump Standards-Version to 3.8.3
  - Add README.source.
* Document the major changes in NEWS.Debian
* Switch to source format 3.0 (quilt). Drop quilt Build-Dep and dh snippet.

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
http://www.draisberghof.de/usb_modeswitch
5
5
 
6
6
 
 
7
NEW !! SENSATIONAL AUTOMATED DEVICE HANDLING !! A MUST SEE !!
 
8
.
 
9
.
 
10
.
 
11
.
 
12
.
 
13
uhm, working partially and needing more input ...
 
14
 
 
15
See "How to install 2" and "Known working hardware" for specifics.
 
16
Note: online documentation not updated yet.
 
17
 
 
18
 
7
19
What it is
8
20
==========
9
21
 
17
29
internally, the storage device vanishes (in most cases), and a new device (like
18
30
an USB modem) shows up. Some call that feature "ZeroCD".
19
31
 
20
 
Of course, nothing of this is documented in any form and there is hardly any
21
 
Linux driver available.
 
32
In the beginning, nothing of this was documented in any form and there was
 
33
hardly any Linux support available.
22
34
On the good side, most of the known devices work out of the box with the
23
35
available Linux modules like "usb-storage" or "usbserial". That leaves the
24
36
problem of the mode switching from storage to whatever the thing is supposed to
35
47
Starting from version 0.9.7 it has an optional success check which spares the
36
48
manual call of "lsusb" to note any changes after execution.
37
49
 
38
 
 
39
 
How to install
40
 
==============
 
50
We have already collected a wide range of information on how to switch all sorts of
 
51
devices. If you run into a new one that is unknown yet, don't despair: we can find
 
52
out what you need!
 
53
 
 
54
 
 
55
How to install 1 (semi-automatic use)
 
56
===================================
41
57
 
42
58
A x86 binary is included (compiled on Pentium M, Ubuntu 8.10).
43
59
 
66
82
For details how to automate the process visit the homepage (see above).
67
83
 
68
84
 
 
85
How to install 2 (fully automatic use)
 
86
===================================
 
87
 
 
88
New since version 1.0.3: a fully automatic system integration that will be able
 
89
to identify every known device without user interaction.
 
90
 
 
91
If you want this, use this line at the shell:
 
92
 
 
93
> make integrated_install
 
94
 
 
95
This installs a config file folder "/etc/usb_modeswitch.d", two scripts, an "udev"
 
96
rules file and a slightly changed binary.
 
97
 
 
98
Important: you need "tcl" for this to work; if you enter "tclsh" and you get a "%"
 
99
prompt, you are set. The "tcl" package is part of all distributions I know.
 
100
 
 
101
 
69
102
Known working hardware
70
103
======================
71
104
 
72
105
For details and specific setup see the homepage and the config file.
 
106
The automatic installation is in alpha stage and requires your participation,
 
107
especially if you own a ZTE made device. There is still not enough
 
108
information to tell models and model versions apart. See the announcement of
 
109
1.0.3 !!
73
110
 
74
111
 
75
112
Contribute
126
163
History
127
164
=======
128
165
 
 
166
Version 1.0.5, 2009/08/26
 
167
    More changes and fixes regarding success check; "--version" option;
 
168
    config "database" updated
 
169
Version 1.0.4, 2009/08/23
 
170
    Success check bugs (and others) fixed
 
171
Version 1.0.3, 2009/08/20
 
172
    Success check improved; experimental system integration (fully automated),
 
173
    optional; new parameter "TargetProductList" needed for this; other necessary
 
174
    small adaptations; more devices
129
175
Version 1.0.2, 2009/06/10
130
176
    Output bugs fixed
131
177
Version 1.0.1, 2009/06/08
191
237
 
192
238
 
193
239
 
194
 
Last revised: 2009-06-10, Josua Dietze
 
240
Last revised: 2009-08-26, Josua Dietze