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.