Skip to content

ADB Login

Overview

ADB (Android Debug Bridge) is one of the most convenient ways to connect to the Rhino Pi X1R without requiring additional display or network configuration.

Prerequisites

Windows

  1. Download and extract the ADB tool package platform-tools
  2. Add the extracted platform-tools directory path to the system environment variable PATH
  3. Open CMD or PowerShell and run adb version to verify the installation

Linux / macOS

bash
# Ubuntu / Debian
sudo apt update
sudo apt install adb

# macOS
brew install android-platform-tools

Hardware Connection

  1. Connect the device using a USB Type-A to Type-C data cable
    • Connect the USB Type-A end to the computer
    • Connect the USB Type-C end to the Type-C port of the Rhino Pi X1R
  2. Power on the device and wait for the system to finish booting (STATUS LED stays solid green)

Establishing an ADB Connection

bash
# View connected devices
adb devices

# Example of normal output:
# List of devices attached
# 47897135   device

If the device is not listed:

  • Confirm that the USB data cable supports data transfer (not a charging-only cable)
  • Reconnect the USB data cable
  • Try a different USB port on the computer

Common ADB Operations

Entering the Shell

  • Method 1: Enter the device command line with normal permissions
bash
# Enter the device command line
adb shell
  • Method 2: Enter the device with root permissions
bash
# Get root permission
adb root
# Enter the device command line
adb shell

File Transfer

bash
# Upload a file to the device
adb push <local-file-path> <device-destination-path>

# Example: upload test.py to /home/aidlux/
adb push test.py /home/aidlux/

# Download a file from the device
adb pull <device-file-path> <local-destination-path>

# Example: download a log file
adb pull /var/log/syslog ./

System Operations

bash
# Reboot the device
adb reboot

# Enter flashing mode (EDL)
adb root
adb reboot edl

# View system information
adb shell cat /proc/version
adb shell cat /proc/cpuinfo

Note

The current system does not support connecting via adb connect <device-ip>:5555.