summaryrefslogtreecommitdiffstats
path: root/docs/html/sdk/win-usb.jd
blob: 3dfe55d0fb09a22a06a5403cef0a0663fc26ce11 (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
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
page.title=Google USB Driver
@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">Downloading the Google USB Driver</a></li>
    <li><a href="#InstallingDriver">Installing the USB Driver</a>
      <ol>
        <li><a href="#Win7">Windows 7</a></li>
        <li><a href="#WinXp">Windows XP</a></li>
        <li><a href="#WinVista">Windows Vista</a></li>
      </ol>
    </li>
  </ol>
  <h2>See also</h2>
  <ol>
    <li><a href="{@docRoot}guide/developing/device.html">Developing on a Device</a></li>
    <li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li>
    <li><a href="{@docRoot}sdk/oem-usb.html">OEM USB Drivers</a></li>
  </ol>
</div>
</div>

<p>The Google USB driver is a downloadable component for Windows developers, available
for download from the AVD and SDK Manager.</p>

<p>The Google USB Driver is only for Android Developer Phones (ADP), Nexus One, and Nexus S.
If you're using a different Android-powered device,
then you need to get a USB driver from the device OEM. For help finding the appropriate
driver, see the list of <a href="{@docRoot}sdk/oem-usb.html">OEM USB Drivers</a>.</p>

<div class="sidebox-wrapper">
<div class="sidebox">
  <p>The Google 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. See <a href="{@docRoot}sdk/oem-usb.html">OEM USB Drivers</a>.</p>
</div>
</div>

<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>

<p>The sections below provide instructions on how to download the USB Driver
for Windows and install it on your development computer. </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">Downloading the Google USB Driver</h2>

<div class="figure" style="width:498px;margin:0">
  <img src="{@docRoot}images/developing/sdk-usb-driver.png" alt="" />
  <p class="img-caption"><strong>Figure 1.</strong> The SDK and AVD Manager
    with the Google USB Driver selected.</p>
</div>

<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 (ADP, Nexus One, or Nexus S) to your
development environment over USB. </p>

<p>To download the driver, use the Android SDK and AVD Manager tool that is
included with the <a href="{@docRoot}sdk/index.html">Android SDK</a>:</p>
<ol>
  <li>Launch the SDK and AVD Manager by double-clicking <code>SDK Manager.exe</code>,
  at the root of your SDK directory.</li>
  <li>Expand the <em>Third party Add-ons</em> and <em>Google Inc. add-ons</em>.</li>
  <li>Check <strong>Google Usb Driver package</strong> and click <strong>Install selected</strong>.</li>
  <li>Proceed to install the package. When done, the driver files are
downloaded into the <code>&lt;sdk&gt;\extras\google\usb_driver\</code> directory.</li>
</ol>



<h2 id="InstallingDriver">Installing the USB Driver</h2>

<p>Once you've downloaded your USB driver, follow the instructions below to install or upgrade the
driver, based on your version of Windows and whether you're installing for the first time
or upgrading an existing driver.</p>

<p class="note"><strong>Tip:</strong> When you finish the USB driver installation,
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><a href="#Win7">Windows 7</a></li>
  <li><a href="#WinXp">Windows XP</a></li>
  <li><a href="#WinVista">Windows Vista</a></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="Win7">Windows 7</h3>


<p>To install the Android USB driver on Windows 7 for the first time:</p>
<ol>
  <li>Connect your Android-powered device to your computer's USB port.</li>
  <li>Right-click on <em>Computer</em> from your desktop or Windows Explorer,
    and select <strong>Manage</strong>.</li>
  <li>Select <strong>Devices</strong> in the left pane.</li>
  <li>Locate and expand <em>Other device</em> in the right pane.</li>
  <li>Right-click the device name (such as <em>Nexus S</em>) and select <strong>Update
  Driver Software</strong>.
    This will launch the Hardware Update Wizard.</li>
  <li>Select <strong>Browse my computer for driver software</strong> and click
    <strong>Next</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
  <li>Click <strong>Next</strong> to install the driver.</li>
</ol>

<p>Or, to <em>upgrade</em> an existing Android USB driver on Windows 7 with the new
driver:</p>

<ol>
  <li>Connect your Android-powered device to your computer's USB port.</li>
  <li>Right-click on <em>Computer</em> from your desktop or Windows Explorer,
    and select <strong>Manage</strong>.</li>
  <li>Select <strong>Device Manager</strong> in the left pane of the Computer Management
  window.</li>
  <li>Locate and expand <em>Android Phone</em> in the right pane.</li>
  <li>Right-click <em>Android Composite ADB Interface</em> and select <strong>Update
  Driver</strong>.
    This will launch the Hardware Update Wizard.</li>
  <li>Select <strong>Install from a list or specific location</strong> and click
    <strong>Next</strong>.</li>
  <li>Select <strong>Search for the best driver in these locations</strong>; un-check
<strong>Search removable media</strong>; and check <strong>Include this location in the
search</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
  <li>Click <strong>Next</strong> to upgrade the driver.</li>
</ol>





<h3 id="WinXp">Windows XP</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 <strong>Install from a list or specific location</strong> and click
    <strong>Next</strong>.</li>
  <li>Select <strong>Search for the best driver in these locations</strong>; un-check
<strong>Search
    removable media</strong>; and check <strong>Include
this location in the search</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
  <li>Click <strong>Next</strong> to install the driver.</li>
</ol>

<p>Or, to <em>upgrade</em> 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 <em>My Computer</em> from your desktop or Windows Explorer,
    and select <strong>Manage</strong>.</li>
  <li>Select <strong>Device Manager</strong> in the left pane.</li>
  <li>Locate and expand <em>Android Phone</em> in the right pane.</li>
  <li>Right-click <em>Android Composite ADB Interface</em> and select <strong>Update
  Driver</strong>.
    This will launch the Hardware Update Wizard.</li>
  <li>Select <strong>Install from a list or specific location</strong> and click
    <strong>Next</strong>.</li>
  <li>Select <strong>Search for the best driver in these locations</strong>; un-check <strong>Search
    removable media</strong>; and check <strong>Include
this location in the search</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
  <li>Click <strong>Next</strong> to upgrade the driver.</li>
</ol>



<h3 id="WinVista">Windows Vista</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 <strong>Locate and install driver software</strong>.</li>
  <li>Select <strong>Don't search online</strong>.</li>
  <li>Select <strong>I don't have the disk. Show me other options</strong>.</li>
  <li>Select <strong>Browse my computer for driver software</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.) As long as you specified the
exact location of the 
    installation package, you may leave <strong>Include subfolders</strong> checked or
  unchecked&mdash;it doesn't matter.</li>
  <li>Click <strong>Next</strong>. 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 <strong>Install</strong> to install the driver.</li>
</ol>

<p>Or, to <em>upgrade</em> 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 <em>Computer</em> from your desktop or Windows Explorer,
    and select <strong>Manage</strong>.</li>
  <li>Select <strong>Device Manager</strong> in the left pane.</li>
  <li>Locate and expand <em>ADB Interface</em> in the right pane.</li>
  <li>Right-click on <em>HTC Dream Composite ADB Interface</em>, and select <strong>Update
  Driver Software</strong>.</li>
  <li>When Vista starts updating the driver, a prompt will ask how you want to
  search for the driver
    software. Select <strong>Browse my computer for driver software</strong>.</li>
  <li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.) As long as you specified the
exact location of the 
    installation package, you may leave <strong>Include subfolders</strong> checked or
    unchecked&mdash;it doesn't matter.</li>
  <li>Click <strong>Next</strong>. Vista might 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 <strong>Install</strong> to upgrade the driver.</li>
</ol>