---
updatedAt: 2026-03-24T12:08:44.000Z
agentTools:
  projectIndex: https://docs.clover.com/dev/llms.txt
---

# Use Android Debug Bridge over USB or Wi-Fi

[block:html]
{
  "html": "<div class=\"container-top\">\n  <!-- North America -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">North America</div>\n    </div>\n  </div>\n\n  <!-- Europe -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">Europe</div>\n    </div>\n  </div>\n\n  <!-- Latin America -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">Latin America</div>\n    </div>\n  </div>\n</div>\n\n<!-- CSS moved to global stylesheet-->\n"
}
[/block]

<br />

<meta name=" description" content="Learn how to use Android Debug Bridge (ADB) to debug your Clover application using a USB or Wi-Fi connection."> 

[block:html]
{
  "html": "<!-- 2024-Nov-8 DS-7347 Added video link and orientation info for Flex 3-->"
}
[/block]

You can use your [Clover Dev Kit](https://docs.clover.com/docs/clover-dev-kits) in the sandbox environment to run published apps and allow non-root connections with the <a href="https://developer.android.com/tools/adb" target="_blank">Android Debug Bridge (ADB)</a>. To use `adb` commands:

* Install and properly configure ADB on your computer.
* Connect the device either with your computer through USB or over a WiFi network.

**Note:** You cannot connect or debug Clover Station in the sandbox environment over USB. To use ADB with a sandbox Clover Station, [connect through Wi-Fi](https://docs.clover.com/docs/use-android-debug-bridge-adb#use-android-debug-bridge-over-wi-fi). Clover Station TCP/IP port is set to **5555**.

# Enable Android Debug Bridge

1. Open the `adb_usb.ini` file in a text editor.

* On operating system X, this file is located at `~/.android/`.
* On Windows, this file is located at `C:\Users\[username]\.android`.

2. Add a new line with the value `0x28f3`. The`adb_usb.ini` file sample:

```shell adb_usb.ini with Clover vendor ID
# ANDROID 3RD PARTY USB VENDOR ID LIST -- DO NOT EDIT.
# USE 'android update adb' TO GENERATE.
# 1 USB VENDOR ID PER LINE.
0x28f3 #clover vendor id
```

3. Save and close the file.

## Use Android Debug Bridge over USB

You can use ADB to access your Dev Kit directly using a micro USB/USB A-to-B cable. To connect your computer and the Dev Kit:

1. Connect the micro USB A end of the cable to your computer.
2. Connect the other end of the cable to your Dev Kit as follows:

[block:html]
{
  "html": "<head>\n    <meta charset=\"UTF-8\">\n    <style>\n        table {\n            border-collapse: collapse; /* Ensures borders are merged */\n            width: 100%; /* Makes the table responsive */\n        }\n        th, td {\n            border: 1px solid #ddd; /* Adds border to cells */\n            padding: 8px; /* Adds padding for better readability */\n            text-align: left; /* Aligns text to the left */\n        }\n        img {\n            width: 1200px; /* Set a larger width for images */\n            height: auto; /* Maintains aspect ratio */\n        }\n        .caption {\n            font-size: 0.5em;\n            color: #555; \n        }\n    </style>\n</head>\n<body>\n    <table>\n        <thead>\n            <tr>\n                <th>Dev Kit</th>\n                <th>Description</th>\n                <th>Image</th>\n            </tr>\n        </thead>\n        <tbody>\n            <tr>\n                <td>Station Solo</td>\n                <td>Connect the micro USB cable to the hub under the merchant device.</td>\n                <td>\n                    <img src=\"https://files.readme.io/2586dc9-Station.png\" alt=\"Station Solo micro USB cable\">\n                    <br>Station Solo micro USB cable\n                </td>\n            </tr>\n            <tr>\n                <td>Station Duo</td>\n                <td>Connect the micro USB cable to the hub under the merchant device.</td>\n                <td>\n                    <img src=\"https://files.readme.io/6ddf5ca-Duo.png\" alt=\"Station Duo micro USB cable\">\n                    <br>Station Duo micro USB cable\n                </td>\n            </tr>\n            <tr>\n                <td>Mini</td>\n                <td>\n                    Use a standard micro USB A-to-B cable to the hub.<br>\n                    Cable sources:\n                    <a href=\"https://www.showmecables.com/by-category/cables/cables-computer/usb-2-0/usb-2-0-a-male-to-b-male\" target=\"_blank\">ShowMeCables</a>, \n                    <a href=\"https://www.zoro.com/monoprice-usb-20-cable-6-ftl-black-5438/i/G0723387/#specifications\" target=\"_blank\">Monoprice</a>, \n                    <a href=\"https://www.amazon.com/StarTech-com-Beige-USB-2-0-Cable/dp/B000067SMW/ref=sr_1_4?s=electronics&ie=UTF8&qid=1547766355&sr=1-4&keywords=3+foot+usb+atob+cable\" target=\"_blank\">StarTech</a>.\n                </td>\n                <td>\n                    <img src=\"https://files.readme.io/7e724c8-Mini.png\" alt=\"Mini micro USB A-to-B cable\">\n                    <br>Mini micro USB A-to-B cable\n                </td>\n            </tr>\n            <tr>\n                <td>Flex 3</td>\n                <td>\n                    Connect a standard micro USB A-to-B cable to the hub.<br>\n                    Watch video:\n                    <a href=\"https://www.youtube.com/embed/R94x07LeXt0\" target=\"_blank\">How to set up the Flex 3 Developer Kit</a>.<br>\n                    <strong>Note:</strong> Flex 3 uses proprietary signals over the USB-C port when connecting to the hub. ADB works in a single orientation. Rotate the USB-C end of the hub so that the flat part of the green screws faces down.<br>\n                    Cable sources:<br>\n                    <a href=\"https://www.showmecables.com/by-category/cables/cables-computer/usb-2-0/usb-2-0-a-male-to-b-male\" target=\"_blank\">ShowMeCables</a>, \n                    <a href=\"https://www.zoro.com/monoprice-usb-20-cable-6-ftl-black-5438/i/G0723387/#specifications\" target=\"_blank\">Monoprice</a>, \n                    <a href=\"https://www.amazon.com/StarTech-com-Beige-USB-2-0-Cable/dp/B000067SMW/ref=sr_1_4?s=electronics&ie=UTF8&qid=1547766355&sr=1-4&keywords=3+foot+usb+atob+cable\" target=\"_blank\">StarTech</a>.\n                </td>\n                <td>\n                    <img src=\"https://files.readme.io/18e2969-Flex3_debug-connection.png\" alt=\"Flex 3 micro USB A-to-B cable\">\n                    <br>Flex 3 micro USB A-to-B cable\n                </td>\n            </tr>\n            <tr>\n                <td>Flex</td>\n                <td>\n                    Connect the micro USB A-to-B cable to the hub under the merchant device.<br>\n                    Cable sources:\n                    <a href=\"https://www.showmecables.com/by-category/cables/cables-computer/usb-2-0/usb-2-0-a-male-to-b-male\" target=\"_blank\">ShowMeCables</a>, \n                    <a href=\"https://www.zoro.com/monoprice-usb-20-cable-6-ftl-black-5438/i/G0723387/#specifications\" target=\"_blank\">Monoprice</a>, \n                    <a href=\"https://www.amazon.com/StarTech-com-Beige-USB-2-0-Cable/dp/B000067SMW/ref=sr_1_4?s=electronics&ie=UTF8&qid=1547766355&sr=1-4&keywords=3+foot+usb+atob+cable\" target=\"_blank\">StarTech</a>.\n                </td>\n                <td>\n                    <img src=\"https://files.readme.io/a0732f0-9067e6d-Flex.jpg\" alt=\"Flex micro USB A-to-B cable\">\n                    <br>Flex micro USB A-to-B cable\n                </td>\n            </tr>\n            <tr>\n                <td>Station 2018</td>\n                <td>\n                    Use a standard USB-to-micro-USB cable to connect to the debugging port.<br>\n                    Watch video:\n                    <a href=\"https://www.youtube.com/watch?v=qbuvwdv4LWE\" target=\"_blank\">How to plug in a micro-USB debug cable in Sandbox Station 2018</a>.\n                </td>\n                <td>\n                    <img src=\"https://files.readme.io/8ea348a-Station_2018.png\" alt=\"Station 2018 micro USB cable\">\n                    <br>Station 2018 micro USB cable\n                </td>\n            </tr>\n            <tr>\n                <td>Mobile</td>\n                <td>Connect the micro USB cable to the port at the bottom of the handle. This is the same port used to connect the Dev Kit to the USB wall charger.</td>\n                <td>\n                    <img src=\"https://files.readme.io/be22f0b-205912b-Clover_Mobile.jpg\" alt=\"Mobile micro USB cable\">\n                    <br>Mobile micro USB cable\n                </td>\n            </tr>\n        </tbody>\n    </table>\n</body>\n</html>\n"
}
[/block]

3. In Android Studio, select **View > Tool Windows > Terminal** (**Alt+F12/Option+F12**) and run `adb devices`. The system displays your Dev Kit identifier, which is a 14-character alphanumeric identifier.

> 📘 NOTE
>
> If you are a Windows user and experience issues with your computer not recognizing the Dev Kit, see <a href="https://gsmusbdriver.com/install-usb-driver" target="_blank">How to install Android ADB Driver manually</a>. For more information, see <a href="https://revryl.com/2013/08/06/install-unsigned-drivers/" target="_blank">how to force install a driver</a>

## Use Android Debug Bridge over Wi-Fi

Once you've configured your computer to recognize the Dev Kit using ADB, you can connect to the device over Wi-Fi:

1. Disconnect or deactivate any ethernet network connection on your Dev Kit for the device to fall back to Wi-Fi, which then supports wireless debugging.
2. Complete the steps to <a href="https://developer.android.com/studio/command-line/adb.html#wireles" target="_blank">connect to a device over Wi-Fi (Android 10 and lower)</a> for a standard Android device.

# Get support

* Email [Clover Developer Relations](mailto:developer-relations@devrel.clover.com) for questions related to your Clover Dev Kit.
* See [Frequently asked questions (FAQs)](https://docs.clover.com/docs/faqs#dev-kit) for more questions related to Dev Kits.