From ad68fdd702f9dc75de686e383657be510440956b Mon Sep 17 00:00:00 2001 From: Scott Main Date: Thu, 5 Nov 2009 18:53:59 -0800 Subject: docs: add new document for the win usb driver; remove usb guide from the device document. --- docs/html/guide/developing/device.jd | 222 +++++++++-------------------------- docs/html/sdk/sdk_toc.cs | 6 +- docs/html/sdk/win-usb.jd | 200 +++++++++++++++++++++++++++++++ 3 files changed, 261 insertions(+), 167 deletions(-) create mode 100644 docs/html/sdk/win-usb.jd diff --git a/docs/html/guide/developing/device.jd b/docs/html/guide/developing/device.jd index 9dea053..8fa4cec 100644 --- a/docs/html/guide/developing/device.jd +++ b/docs/html/guide/developing/device.jd @@ -11,8 +11,16 @@ page.title=Developing on a Device
  • Android Dev Phone 1
    • -
  • Setting up a Device for Development
    • -
  • Installing the WinUsb Driver
    • +
  • Setting up a Device for Development +
      +
    1. USB Vendor IDs
      2. +
    +
    • + +

    See also

    +
      +
    1. USB Driver for Windows
    @@ -117,27 +125,36 @@ would on the emulator. There are just a few things to do before you can start.Turn on "USB Debugging" on your device.

    On the device, go to the home screen, press MENU, select Applications > Development, then enable USB debugging.

    -
  • Setup your system to detect your device.
    • @@ -149,157 +166,30 @@ with a Device Chooser dialog that lists the available emulator(s) and con Select the device to install and run the application there.

    If using the Android Debug Bridge (adb), -you can issue commands with the -d flag to target your connected device.

    - - - - -

    Installing the WinUsb Driver

    - -

    A WinUsb-based driver is needed in order to use your Android-powered device for development on a Windows machine. -The USB installation package can be found in the <sdk>\usb_driver\ -folder of your SDK package.

    - -

    Note: If you are connecting an Android-powered device to your computer -for the first time, folllow the procedure to "Perform a fresh installation." -Android SDKs older than version 1.6 included a non-WinUsb-based driver -for connecting your device. If you installed the older USB driver and it is working properly, -you do not need to upgrade to the new driver. However, if you are having problems with the driver or -would simply like to upgrade to the latest version, follow the procedure to "Upgrade an existing -driver."

    - -

    Before you begin installing or upgrading the USB driver, you must -copy the USB installation package to a secure location on your computer. -For example, you might want to create a directory at C:\Android\Windows\USB\install\ and -move it there. Once you've moved the installation package, select the appropriate procedure below, -based on your operating system and whether you're installing for the first time or upgrading.

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

    Caution: -You may make changes to android_winusb.inf file found inside usb_driver\ -(e.g., to add support for new 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.

    - -

    Windows Vista: Perform a fresh installation

    - -

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

    Return to Setting up a Device for Development.

    - - - -

    Windows Vista: Upgrade an existing driver

    - -

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

    - -
      -
    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 window.
      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 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.
      8. -
    8. Click "Next." Vista may 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 install the driver.
      10. -
    - -

    Return to Setting up a Device for Development.

    - - - -

    Windows XP: Perform a fresh installation

    - -

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

    Return to Setting up a Device for Development.

    - - - -

    Windows XP: Upgrade an existing driver

    - -

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

    - -
      -
    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..." - This will launch the Hardware Update Wizard.
      6. -
    6. Select "Install from a list or specific location" and click - "Next."
      7. -
    7. Select "Search for the best driver in these locations"; uncheck "Search - removable media"; and check "Include this location in the search."
      8. -
    8. Click "Browse..." and locate the folder where you copied the installation - package.
      9. -
    9. Click "Next" to install the driver.
      10. -
    - -

    Return to Setting up a Device for Development.

    - - - - - - - - - - - - - - +you can issue commands with the -d flag to target your +connected device.

    + + +

    USB Vendor IDs

    +

    This table provides a reference to the vendor IDs needed in order to add +device support on Linux. The USB Vendor ID is the value given to the +SYSFS{idVendor} property in the rules file.

    + + + + + + + + + + + + + + + + + +
    ManufacturerUSB Vendor ID
    Acer0502
    HTC0bb4
    Huawei12d1
    LG1004
    Motorola22b8
    Samsung04e8
    Sony Ericsson0fce
    diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index 900b067..4aed0ca 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -75,7 +75,11 @@ diff --git a/docs/html/sdk/win-usb.jd b/docs/html/sdk/win-usb.jd new file mode 100644 index 0000000..3a5a30f --- /dev/null +++ b/docs/html/sdk/win-usb.jd @@ -0,0 +1,200 @@ +page.title=USB Driver for Windows +@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.

    + +

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

    + +

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

    + +

    Revision Notes

    + +

    Revision 2

    +

    Adds support for the Verizon Droid (or similar hardware on +other carriers). Released November 2009.

    + +

    Revision 1

    +

    This was the initial release of the WinUsb-based driver, with support +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:

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

    * Or similar hardware on other carriers

    +

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

    +
    +
    + +

    Before you perform the installation below, you must have the USB +driver saved to your development computer. To get the USB driver, use +the AVD and SDK Manager included with the SDK Tools to download the USB driver +as an SDK component. For more information, read Adding SDK Components.

    + +

    Once you have the USB driver saved to your computer, select the +appropriate procedure below, based on your operating system and whether you're +installing for the first time or upgrading.

    + +

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

    Caution: +You may make changes to android_winusb.inf file found inside +usb_driver\ (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.

    + +

    Windows Vista: Perform a fresh installation

    + +

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

    Windows Vista: Upgrade an existing driver

    + +

    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 of the Computer Management + window.
      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 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.
      8. +
    8. Click "Next." Vista may 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 install the driver.
      10. +
    + + +

    Windows XP: Perform a fresh installation

    + +

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

    Windows XP: Upgrade an existing driver

    + +

    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..." + This will launch the Hardware Update Wizard.
      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 folder where you copied the installation + package.
      9. +
    9. Click "Next" to install the driver.
      10. +
    + -- cgit v1.1