This article explains how to use ADB (Android Debug Bridge), a command-line utility included with Google's Android SDK Platform Tools.
ADB can be used to communicate with an Elo Android device from a computer over USB or a network connection. Common uses include copying files, installing and uninstalling applications, running shell commands, collecting logs, and debugging applications.
Some earlier Elo Android platforms include a Switch USB to Device Mode setting in Developer Options. Newer Elo Android platforms, including supported Android 14 devices, do not require this setting. On these devices, enable USB debugging and connect the appropriate USB cable.
On Elo platforms that require Switch USB to Device Mode, enabling Device Mode may disable communication with USB peripheral ports. When access to USB peripherals must be maintained, use ADB over a network connection when possible.
Setting Up ADB on the Computer
- Download the Android SDK Platform Tools from the Android Developers website.
- Extract the downloaded ZIP file to a location that is easily accessible.
Enabling Developer Options on the Elo Device
- Open the Elo device Control Panel. If prompted, enter the Control Panel password.
- If the password has not been changed, the default password may be 1elo.
- In the Apps area, select Settings.
- Open About Phone, About Tablet, or About Device, depending on the Elo platform.
- Tap Build Number seven times or until the You are now a developer message appears.
- Return to the previous Settings screen.
- Open Developer Options. Depending on the Android version, Developer Options may be located under System or System > Advanced.
Configuring USB Debugging
Newer Elo Android Platforms - Including Android 14
- Make sure the USB cable is not connected to the Elo device.
- In Developer Options, enable USB debugging.
- Select OK if prompted to confirm USB debugging.
The Switch USB to Device Mode option used on some earlier Elo Android platforms is not required on supported newer Android 14 platforms. If this option is not displayed in Developer Options, continue with the USB connection procedure below.
Earlier Elo Android Platforms with Device Mode
If the Elo device includes a Switch USB to Device Mode option in Developer Options:
- Make sure the USB cable is not connected to the Elo device.
- Enable USB debugging.
- Enable Switch USB to Device Mode.
- Select OK if prompted.
Enabling Switch USB to Device Mode on applicable Elo platforms may stop communication with the USB peripheral ports.
Connecting to the Elo Device over USB
- Connect the Elo device to the developer computer using the appropriate USB data cable.
USB cable and debug-port requirements vary by Elo product. Examples include:
- I-Series 2.0: USB Type-A to USB Type-A.
- PayPoint Plus for Android and PayPoint for Android Rev B: Mini-USB to USB Type-A.
- Newer Elo Android products: Use the USB debug port and cable specified in the product's user manual.
Use a USB cable that supports data. Charge-only USB cables cannot establish an ADB connection.
- Open Windows Command Prompt or Windows Terminal and navigate to the extracted platform-tools directory.
- Enter the following command:
adb devices- The Elo device may display an authorization message asking whether to allow USB debugging from the connected computer.
- If prompted, select Allow or OK. You may also select Always allow from this computer if appropriate.
- Run the following command again:
adb devices- Verify that the Elo device is listed with a status of device.
The Elo device is now ready to accept ADB commands from the developer computer.
Using ADB over a Network Connection
ADB can also communicate with supported Elo Android devices using a network connection. This can be useful when USB Device Mode would interfere with attached USB peripherals.
Switching an Existing USB ADB Connection to TCP/IP
- Connect the Elo device and developer computer to the same network.
- Establish a working USB ADB connection using the procedures above.
- Determine the IP address of the Elo device.
- From the developer computer, enter:
adb tcpip 5555- Enter the following command, replacing <device-ip-address> with the IP address of the Elo device:
adb connect <device-ip-address>:5555Example:
adb connect 192.168.1.100:5555- Run the following command to verify the network connection:
adb devicesThe Elo device should appear in the list using its IP address followed by :5555.
Only use ADB over TCP/IP on a trusted network. Do not expose an ADB connection to an untrusted or publicly accessible network.
Troubleshooting USB ADB Connections
If the Elo device does not appear when running adb devices, perform the following steps.
- On the Elo device, return to Settings > Developer Options.
- Select Revoke USB debugging authorizations.
- Select OK to clear previously authorized computers.
- Disable USB debugging.
- Disconnect the USB cable from the Elo device.
- From Windows Command Prompt or Windows Terminal, enter the following commands:
adb kill-server
adb start-server- Re-enable USB debugging.
- On an earlier Elo platform that requires Device Mode, also enable Switch USB to Device Mode.
- Reconnect the USB cable.
- Run:
adb devices- If prompted on the Elo device, select Always allow from this computer and then select Allow or OK.
- Run the following command again:
adb devices- If the Elo device is listed with a status of device, the connection has been successfully restored.
Additional Information
For additional information about Android Debug Bridge, see Android Debug Bridge (adb) - Android Developers.
Please report any broken links by emailing support@elotouch.com and include a link to the knowledge article