From 0f8056321f4d4552fb96a671c3cd194814ad0d4e Mon Sep 17 00:00:00 2001 From: Scott Main Date: Fri, 7 Jan 2011 10:45:03 -0800 Subject: [PATCH] cherrypick Change-Id: Ic268b65b127b356155dd62d737029ce442c12f51 docs: add OEM USB Drivers document and update install guide with windows 7 procedures misc style edits Change-Id: Icadbfc1136463a75039f87e7c0cbc79d29afbd84 --- docs/html/guide/developing/device.jd | 12 +- .../html/images/developing/sdk-usb-driver.png | Bin 0 -> 120183 bytes docs/html/sdk/oem-usb.jd | 81 +++++ docs/html/sdk/sdk_toc.cs | 6 +- docs/html/sdk/win-usb.jd | 311 ++++++++++-------- 5 files changed, 272 insertions(+), 138 deletions(-) create mode 100644 docs/html/images/developing/sdk-usb-driver.png create mode 100644 docs/html/sdk/oem-usb.jd diff --git a/docs/html/guide/developing/device.jd b/docs/html/guide/developing/device.jd index 4bed963ce6efb..657f5495c991e 100644 --- a/docs/html/guide/developing/device.jd +++ b/docs/html/guide/developing/device.jd @@ -13,8 +13,12 @@ page.title=Connecting Hardware Devices

See also

    +
  1. Google USB Driver
    2. +
  2. OEM USB Drivers
  3. USB Driver for Windows
    4. +href="{@docRoot}guide/developing/eclipse-adt.html">Developing in Eclipse, with ADT +
  4. Developing in other IDEs
@@ -66,8 +70,10 @@ would on the emulator. Before you can start, there are just a few things to do:<
  • Setup your system to detect your device.
    • @@ -156,6 +155,9 @@
      +
    • + OEM USB Drivers +
    • SDK System Requirements
      • diff --git a/docs/html/sdk/win-usb.jd b/docs/html/sdk/win-usb.jd index 1f74ffed4861d..ffaec4c8b6f33 100644 --- a/docs/html/sdk/win-usb.jd +++ b/docs/html/sdk/win-usb.jd @@ -1,4 +1,4 @@ -page.title=USB Driver for Windows +page.title=Google USB Driver @jd:body -

      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.

      +

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

      -

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

      +

      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 OEM USB Drivers.

      + +
      +
      +

      The Google USB driver for Windows provides support for the following +Android-powered devices:

      +
        +
      • ADP1 / T-Mobile G1*
        • +
      • ADP2 / Google Ion / T-Mobile myTouch 3G*
        • +
      • Verizon Droid*
        • +
      • Nexus One
        • +
      • Nexus S
        • +
      +

      * Or similar hardware on other carriers

      +

      Any additional devices will require Windows drivers provided by +the hardware manufacturer. See OEM USB Drivers.

      +
      +

      Note: If you're developing on Mac OS X or Linux, then you do not need to install a @@ -34,6 +55,12 @@ USB driver. Refer to Setting up a Device to start development with a device.

      +

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

      + + + +

      Revisions

      The sections below provide notes about successive revisions of the USB Driver @@ -132,77 +159,49 @@ for the T-Mobile G1 and myTouch 3G (and similar devices).

      -

      Installing the USB Driver for Windows

      -
      -
      -

      The USB driver for Windows provides support for the following -Android-powered -devices:

      -
        -
      • ADP1 / T-Mobile G1*
        • -
      • ADP2 / Google Ion / T-Mobile myTouch 3G*
        • -
      • Verizon Droid*
        • -
      • Nexus One
        • -
      • Nexus S
        • -
      -

      * Or similar hardware on other carriers

      -

      Any additional devices will require Windows drivers provided by -the hardware manufacturer.

      +

      Downloading the Google USB Driver

      + +
      + +

      Figure 1. The SDK and AVD Manager + with the Google USB Driver selected.

      -
      - - -

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

      - -

      Downloading the USB Driver for Windows

      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.

      - -

      To install the driver or upgrade your existing driver to the latest -revision, you must first download the driver to your development computer.

      +want to connect an Android-powered device (ADP, Nexus One, or Nexus S) to your +development environment over USB.

      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 Installing the Android SDK, please do -so before continuing with the driver installation.

      +included with the Android SDK:

      +
        +
      1. Launch the SDK and AVD Manager by double-clicking SDK Manager.exe, + at the root of your SDK directory.
        2. +
      2. Expand the Third party Add-ons and Google Inc. add-ons.
        3. +
      3. Check Google Usb Driver package and click Install selected.
        4. +
      4. Proceed to install the package. When done, the driver files are +downloaded into the <sdk>\google-usb_driver\ directory.
        5. +
      -

      When you are ready to download the driver, follow the instructions given in -Adding SDK Components to launch the Android -SDK and AVD Manager. From the Available Packages panel, select -"Usb Driver Package" and download it to your computer. The driver files are -downloaded into the <sdk>\google-usb_driver\ directory.

      -

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

      -

      Once you've completed the USB driver installation, -please see Installing the USB Driver + +

      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.

      + +

      Tip: When you finish the USB driver installation, +see Developing on a Device for other important information about using an Android-powered device for development.

        -
      1. Windows Vista: -
          -
        1. Perform a fresh installation
          2. -
        2. Upgrade an existing driver
          3. -
        -
        2. -
      2. Windows XP: -
          -
        1. Perform a fresh installation
          2. -
        2. Upgrade an existing driver
          3. -
        -
        3. +
      3. Windows 7
        4. +
      4. Windows XP
        5. +
      5. Windows Vista
      @@ -213,94 +212,140 @@ 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.

      -

      Windows Vista: Perform a fresh installation

      -

      To install the Android USB driver on Windows Vista for the first time:

      +

      Windows 7

      + +

      To install the Android USB driver on Windows 7 for the first time:

        -
      1. Connect your Android-powered device to your computer's USB port. Windows - will detect the device and launch the Found New Hardware wizard.
        2. -
      2. Select "Locate and install driver software."
        3. -
      3. Select "Don't search online."
        4. -
      4. Select "I don't have the disk. Show me other options."
        5. -
      5. Select "Browse my computer for driver software."
        6. -
      6. 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—it doesn't matter.
        7. -
      7. Click "Next." Vista may prompt you to confirm the privilege elevation - required for driver installation. Confirm it.
        8. -
      8. When Vista asks if you'd like to install the Google ADB Interface device, - click "Install" to install the driver.
        9. +
      9. Connect your Android-powered device to your computer's USB port.
        10. +
      10. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
        11. +
      11. Select Devices in the left pane.
        12. +
      12. Locate and expand Other device in the right pane.
        13. +
      13. Right-click the device name (such as Nexus S) and select Update + Driver Software. + This will launch the Hardware Update Wizard.
        14. +
      14. Select Browse my computer for driver software and click + Next.
        15. +
      15. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.)
        16. +
      16. Click Next to install the driver.
      - -

      Windows Vista: Upgrade an existing driver

      - -

      To upgrade an existing Android USB driver on Windows Vista with the new +

      Or, to upgrade an existing Android USB driver on Windows 7 with the new driver:

      1. Connect your Android-powered device to your computer's USB port.
        2. -
      2. Right-click on "Computer" from your desktop or Windows Explorer, - and select "Manage."
        3. -
      3. Select "Device Manager" in the left pane of the Computer Management +
      4. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
        5. +
      5. Select Device Manager in the left pane of the Computer Management window.
        6. -
      6. Locate and expand "ADB Interface" in the right pane.
        7. -
      7. Right-click on "HTC Dream Composite ADB Interface", and select "Update - Driver Software..."
        8. -
      8. 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."
        9. -
      9. 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—it doesn't matter.
        10. -
      10. Click "Next." Vista may prompt you to confirm the privilege elevation - required for driver installation. Confirm it.
        11. -
      11. When Vista asks if you'd like to install the Google ADB Interface device, - click "Install" to install the driver.
        12. +
      12. Locate and expand Android Phone in the right pane.
        13. +
      13. Right-click Android Composite ADB Interface and select Update + Driver. + This will launch the Hardware Update Wizard.
        14. +
      14. Select Install from a list or specific location and click + Next.
        15. +
      15. Select Search for the best driver in these locations; un-check +Search removable media; and check Include this location in the +search.
        16. +
      16. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.)
        17. +
      17. Click Next to upgrade the driver.
      -

      Windows XP: Perform a fresh installation

      + + + +

      Windows XP

      To install the Android USB driver on Windows XP for the first time:

      1. Connect your Android-powered device to your computer's USB port. Windows will detect the device and launch the Hardware Update Wizard.
        2. -
      2. Select "Install from a list or specific location" and click - "Next."
        3. -
      3. Select "Search for the best driver in these locations"; un-check "Search - removable media"; and check "Include this location in the search."
        4. -
      4. Click "Browse..." and locate the folder where you copied the installation - package.
        5. -
      5. Click "Next" to install the driver.
        6. +
      6. Select Install from a list or specific location and click + Next.
        7. +
      7. Select Search for the best driver in these locations; un-check +Search + removable media; and check Include +this location in the search.
        8. +
      8. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.)
        9. +
      9. Click Next to install the driver.
      - -

      Windows XP: Upgrade an existing driver

      - -

      To upgrade an existing Android USB driver on Windows XP with the new +

      Or, to upgrade an existing Android USB driver on Windows XP with the new driver:

      1. Connect your Android-powered device to your computer's USB port.
        2. -
      2. Right-click on "My Computer" from your desktop or Windows Explorer, - and select "Manage."
        3. -
      3. Select "Device Manager" in the left pane of the Computer Management - window.
        4. -
      4. Locate and expand "Android Phone" in the right pane.
        5. -
      5. Right-click "Android Composite ADB Interface" and select "Update - Driver..." +
      6. Right-click on My Computer from your desktop or Windows Explorer, + and select Manage.
        7. +
      7. Select Device Manager in the left pane.
        8. +
      8. Locate and expand Android Phone in the right pane.
        9. +
      9. Right-click Android Composite ADB Interface and select Update + Driver. This will launch the Hardware Update Wizard.
        10. -
      10. Select "Install from a list or specific location" and click - "Next."
        11. -
      11. Select "Search for the best driver in these locations"; un-check "Search - removable media"; and check "Include this location in the search."
        12. -
      12. Click "Browse..." and locate the folder where you copied the installation - package.
        13. -
      13. Click "Next" to install the driver.
        14. +
      14. Select Install from a list or specific location and click + Next.
        15. +
      15. Select Search for the best driver in these locations; un-check Search + removable media; and check Include +this location in the search.
        16. +
      16. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.)
        17. +
      17. Click Next to upgrade the driver.
        18. +
      + + + +

      Windows Vista

      + +

      To install the Android USB driver on Windows Vista for the first time:

      + +
        +
      1. Connect your Android-powered device to your computer's USB port. Windows + will detect the device and launch the Found New Hardware wizard.
        2. +
      2. Select Locate and install driver software.
        3. +
      3. Select Don't search online.
        4. +
      4. Select I don't have the disk. Show me other options.
        5. +
      5. Select Browse my computer for driver software.
        6. +
      6. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.) As long as you specified the exact +location of the + installation package, you may leave Include subfolders checked or + unchecked—it doesn't matter.
        7. +
      7. Click Next. Vista may prompt you to confirm the privilege elevation + required for driver installation. Confirm it.
        8. +
      8. When Vista asks if you'd like to install the Google ADB Interface device, + click Install to install the driver.
        9. +
      + +

      Or, to upgrade an existing Android USB driver on Windows Vista with the new +driver:

      + +
        +
      1. Connect your Android-powered device to your computer's USB port.
        2. +
      2. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
        3. +
      3. Select Device Manager in the left pane.
        4. +
      4. Locate and expand ADB Interface in the right pane.
        5. +
      5. Right-click on HTC Dream Composite ADB Interface, and select Update + Driver Software.
        6. +
      6. 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.
        7. +
      7. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\google-usb_driver\}.) As long as you specified the +exact location of the + installation package, you may leave Include subfolders checked or + unchecked—it doesn't matter.
        8. +
      8. Click Next. Vista might prompt you to confirm the privilege elevation + required for driver installation. Confirm it.
        9. +
      9. When Vista asks if you'd like to install the Google ADB Interface device, + click Install to upgrade the driver.