Use Android Debug Bridge over USB or Wi-Fi

You can use your Clover Dev Kit in the sandbox environment to run published apps and allow non-root connections with Android Debug Bridge (ADB). ADB allows you to debug your Clover application using a USB or Wi-Fi connection.

🚧

IMPORTANT

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. 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. Theadb_usb.ini file sample:

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

• For Station Solo, connect the micro USB cable to the hub under the merchant device.

• For Station Duo, connect the micro USB cable to the hub under the merchant device.

• For Clover Mini, use a standard micro USB A-to-B cable to the hub.
  Cable sources: ShowMeCables, Monoprice, StarTech

• For Clover Flex 3, connect a standard micro USB A-to-B cable to the hub.
  Cable sources: ShowMeCables, Monoprice, StarTech

• For Clover Flex, connect the micro USB A-to-B cable to the hub under the merchant device.
  Cable sources: ShowMeCables, Monoprice, StarTech

• For Clover Station 2018, use a standard USB-to-micro-USB cable to connect to the debugging port. See Video—How to Plug In a Micro-USB Debug Cable in Clover Sandbox Station 2018.

• For Clover Mobile, 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.

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 How to install Android ADB Driver manually. For more information, see how to force install a driver.

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 disable any ethernet network connection on your Dev Kit for the device to fall back to Wi-Fi, which then enables wireless debugging.
2. Complete the steps to connect to a device over Wi-Fi (Android 10 and lower) for a standard Android device.

Frequently asked questions

• Contact [email protected] with your order number for questions related to the shipment of your Clover Dev Kit.
• See Frequently asked questions (FAQs) for more questions related to Dev Kits.
• Visit our Clover Developer Community to see if there is an existing response to your question.