summaryrefslogtreecommitdiffstats
path: root/docs/html/sdk/win-usb.jd
blob: 1f74ffed4861d3e0fc2eb6b414682c21af5a080c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
page.title=USB Driver for Windows
@jd:body

<div id="qv-wrapper">
<div id="qv">
  <h2>In this document</h2>
  <ol>
    <li><a href="#notes">Revisions</a></li>
    <li><a href="#WinUsbDriver">Installing the USB Driver for Windows</a></li>
  </ol>
  <h2>See also</h2>
  <ol>
    <li><a
    href="{@docRoot}guide/developing/device.html">Developing on a
    Device</a></li>
    <li><a
    href="adding-components.html">Adding SDK Components</a></li>
  </ol>
</div>
</div>

<p>The USB driver for Windows is a downloadable component for the
Android SDK. If you are developing on Windows and would like to
connect an Android-powered device to test your applications, then you will need
to install the USB driver.</p>

<p>This document provides information about the latest version of the
USB driver and a guide to installing the driver on your development
computer.</p>

<p class="note"><strong>Note:</strong>
If you're developing on Mac OS X or Linux, then you do not need to install a
USB driver. Refer to <a
href="{@docRoot}guide/developing/device.html#setting-up">Setting up a
Device</a> to start development with a device.</p>

<h2 id="notes">Revisions</h2>

<p>The sections below provide notes about successive revisions of the USB Driver
for Windows, as denoted by revision number. To determine what revision of the
USB Driver for Windows you are using, refer to the "Installed Packages" listing
in the Android SDK and AVD Manager.</p>

<script type="text/javascript">
function toggleDiv(link) {
  var toggleable = $(link).parent();
  if (toggleable.hasClass("closed")) {
    //$(".toggleme", toggleable).slideDown("fast");
    toggleable.removeClass("closed");
    toggleable.addClass("open");
    $(".toggle-img", toggleable).attr("title", "hide").attr("src", (toRoot + "assets/images/triangle-opened.png"));
  } else {
    //$(".toggleme", toggleable).slideUp("fast");
    toggleable.removeClass("open");
    toggleable.addClass("closed");
    $(".toggle-img", toggleable).attr("title", "show").attr("src", (toRoot + "assets/images/triangle-closed.png"));
  }
  return false;
}
</script>
<style>
.toggleable {
padding: .25em 1em;
}
.toggleme {
  padding: 1em 1em 0 2em;
  line-height:1em;
}
.toggleable a {
  text-decoration:none;
}
.toggleme a {
  text-decoration:underline;
}
.toggleable.closed .toggleme {
  display:none;
}
#jd-content .toggle-img {
  margin:0;
}
</style>

<div class="toggleable opened">
  <a href="#" onclick="return toggleDiv(this)">
        <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px"
width="9px" />
USB Driver for Windows, Revision 4</a> <em>(December 2010)</em>
  <div class="toggleme">

<dl>
<dt><p>Adds support for the Nexus S.</p></dt>
</dl>
 </div>
</div>

<div class="toggleable closed">
  <a href="#" onclick="return toggleDiv(this)">
        <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
width="9px" />
USB Driver for Windows, Revision 3</a> <em>(January 2010)</em>
  <div class="toggleme">

<dl>
<dt><p>Adds support for the Nexus One.</p></dt>
</dl>
 </div>
</div>

<div class="toggleable closed">
  <a href="#" onclick="return toggleDiv(this)">
        <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
USB Driver for Windows, Revision 2</a> <em>(November 2009)</em>
  <div class="toggleme">

<dl>
<dt><p>Adds support for the Verizon Droid (or similar hardware on
other carriers).</p></dt>
</dl>
 </div>
</div>

<div class="toggleable closed">
  <a href="#" onclick="return toggleDiv(this)">
        <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
USB Driver for Windows, Revision 1</a> <em>(October 2009)</em>
  <div class="toggleme">

<dl>
<dt><p>Initial release of the WinUsb-based driver, with support
for the T-Mobile G1 and myTouch 3G (and similar devices).</p></dt>
</dl>
 </div>
</div>

<h2 id="WinUsbDriver">Installing the USB Driver for Windows</h2>

<div class="sidebox-wrapper">
<div class="sidebox">
  <p>The USB driver for Windows provides support for the following
Android-powered
devices:</p>
  <ul>
    <li>ADP1 / T-Mobile G1*</li>
    <li>ADP2 / Google Ion / T-Mobile myTouch 3G*</li>
    <li>Verizon Droid*</li>
    <li>Nexus One</li>
    <li>Nexus S</li>
  </ul>
  <p>* <em>Or similar hardware on other carriers</em></p>
  <p>Any additional devices will require Windows drivers provided by
the hardware manufacturer.</p>
</div>
</div>


<p>The sections below provide instructions on how to download the USB Driver
for Windows and install it on your development computer. </p>

<h3>Downloading the USB Driver for Windows</h3>

<p>The USB Driver for Windows is available for download as an optional SDK
component. You need the driver only if you are developing on Windows and 
want to connect an Android-powered device to your development environment
over USB. </p>

<p>To install the driver or upgrade your existing driver to the latest
revision, you must first download the driver to your development computer. </p>

<p>To download the driver, use the Android SDK and AVD Manager tool that is
included with the Android SDK. If you haven't yet installed the Android SDK, as
described in <a href="installing.html">Installing the Android SDK</a>, please do
so before continuing with the driver installation. </p>

<p>When you are ready to download the driver, follow the instructions given in
<a href="adding-components.html">Adding SDK Components</a> to launch the Android
SDK and AVD Manager. From the <strong>Available Packages</strong> panel, select
"Usb Driver Package" and download it to your computer. The driver files are
downloaded into the <code>&lt;sdk&gt;\google-usb_driver\</code> directory.</p>

<p>After the download, follow the instructions below to install or upgrade the
driver, based on your needs and Windows operating system version. If you are
connecting an Android-powered device to your computer for the first time, follow
the below procedure to "Perform a fresh installation." If you have installed one
of the older USB drivers and would like to upgrade to the latest version, follow
the procedure to "Upgrade an existing driver."</p>

<p>Once you've completed the USB driver installation,
please see <a
href="{@docRoot}guide/developing/device.html">Developing on a Device</a> for
other important information about using an Android-powered device for
development.</p>

<ol class="nolist">
  <li><strong>Windows Vista:</strong>
    <ol class="nolist">
      <li><a href="#VistaFreshInstall">Perform a fresh installation</a></li>
      <li><a href="#VistaUpgrade">Upgrade an existing driver</a></li>
    </ol>
  </li>
  <li><strong>Windows XP:</strong>
    <ol class="nolist">
      <li><a href="#XPFreshInstall">Perform a fresh installation</a></li>
      <li><a href="#XPUpgrade">Upgrade an existing driver</a></li>
    </ol>
  </li>
</ol>


<p class="caution"><strong>Caution:</strong>
You may make changes to <code>android_winusb.inf</code> file found inside
<code>usb_driver\</code> (for example, to add support for other devices),
however, this will lead to security warnings when you install or upgrade the
driver. Making any other changes to the driver files may break the installation
process.</p>

<h3 id="VistaFreshInstall">Windows Vista: Perform a fresh installation</h3>

<p>To install the Android USB driver on Windows Vista for the first time:</p>

<ol>
  <li>Connect your Android-powered device to your computer's USB port. Windows
  will detect the device and launch the Found New Hardware wizard.</li>
  <li>Select "Locate and install driver software."</li>
  <li>Select "Don't search online."</li>
  <li>Select "I don't have the disk. Show me other options."</li>
  <li>Select "Browse my computer for driver software."</li>
  <li>Click "Browse..." and locate the folder where you copied the
    installation package. As long as you specified the exact location of the 
    installation package, you may leave "Include subfolders" checked or
  unchecked&mdash;it doesn't matter.</li>
  <li>Click "Next." Vista may prompt you to confirm the privilege elevation
  required for driver installation. Confirm it.</li>
  <li>When Vista asks if you'd like to install the Google ADB Interface device,
  click "Install" to install the driver.</li>
</ol>


<h3 id="VistaUpgrade">Windows Vista: Upgrade an existing driver</h3>

<p>To upgrade an existing Android USB driver on Windows Vista with the new
driver:</p>

<ol>
  <li>Connect your Android-powered device to your computer's USB port.</li>
  <li>Right-click on "Computer" from your desktop or Windows Explorer,
    and select "Manage."</li>
  <li>Select "Device Manager" in the left pane of the Computer Management
  window.</li>
  <li>Locate and expand "ADB Interface" in the right pane.</li>
  <li>Right-click on "HTC Dream Composite ADB Interface", and select "Update
  Driver Software..."</li>
  <li>When Vista starts updating the driver, a prompt will ask how you want to
  search for the driver
    software. Select "Browse my computer for driver software."</li>
  <li>Click "Browse..." and locate the folder where you copied the
    installation package. As long as you specified the exact location of the 
    installation package, you may leave "Include subfolders" checked or
    unchecked&mdash;it doesn't matter.</li>
  <li>Click "Next." Vista may prompt you to confirm the privilege elevation
  required for driver installation. Confirm it.</li>
  <li>When Vista asks if you'd like to install the Google ADB Interface device,
  click "Install" to install the driver.</li>
</ol>


<h3 id="XPFreshInstall">Windows XP: Perform a fresh installation</h3>

<p>To install the Android USB driver on Windows XP for the first time:</p>

<ol>
  <li>Connect your Android-powered device to your computer's USB port. Windows 
    will detect the device and launch the Hardware Update Wizard.</li>
  <li>Select "Install from a list or specific location" and click
    "Next."</li>
  <li>Select "Search for the best driver in these locations"; un-check "Search
    removable media"; and check "Include this location in the search."</li>
  <li>Click "Browse..." and locate the folder where you copied the installation 
    package.</li>
  <li>Click "Next" to install the driver.</li>
</ol>


<h3 id="XPUpgrade">Windows XP: Upgrade an existing driver</h3>

<p>To upgrade an existing Android USB driver on Windows XP with the new
driver:</p>

<ol>
  <li>Connect your Android-powered device to your computer's USB port.</li>
  <li>Right-click on "My Computer" from your desktop or Windows Explorer,
    and select "Manage."</li>
  <li>Select "Device Manager" in the left pane of the Computer Management
  window.</li>
  <li>Locate and expand "Android Phone" in the right pane.</li>
  <li>Right-click "Android Composite ADB Interface" and select "Update
  Driver..."
    This will launch the Hardware Update Wizard.</li>
  <li>Select "Install from a list or specific location" and click
    "Next."</li>
  <li>Select "Search for the best driver in these locations"; un-check "Search
    removable media"; and check "Include this location in the search."</li>
  <li>Click "Browse..." and locate the folder where you copied the installation 
    package.</li>
  <li>Click "Next" to install the driver.</li>
</ol>