Please enable javascript, or click here to visit my ecommerce web site powered by Shopify.
Jump to: navigation, search


    Radxa Zero >  Debian

Work with Radxa Zero Debian

Introduction to Radxa Zero Debian

Radxa Zero Debian is an easy to use desktop system. While working with Radxa Zero Debian, you will find it do well on playing music, Internet, Bluetooth and so on.

Radxa Zero Debian uses systemd to manage system.

Command prepended by $ means the command may be executed by an unprivileged user. And command prepended by # means the command may be executed by an privileged user. But the symbol, $ or #, is not part of the command.

Access from the Host PC/Laptop

Option 1: Serial console

Check Serial Console

Option 2: SSH

SSH server is enabled on port 22 of Radxa Zero image.

Please use angryip to find your board IP address.

 $ ping ip-of-device
 $ ssh rock@ip-of-device

Debian Default User Account

Non-root User:

 User Name : rock
 Password  : rock


The preinstalled Desktop is xfce4.

Install and update necessary packages

Add Radxa APT, see Radxa APT.

Install packages;

 $ sudo apt-get update

Network Connection

There is one method for network connection, WIFI.

WIFI Connection

Radxa Zero supports 2.4G/5G WIFI wireless network.

To test the WIFI performance, we need to follow the steps:
  • Switch to super user mode
 $ sudo su
  • Open the WIFI
 $ nmcli r wifi on
  • Scan WIFI
 $ nmcli dev wifi
  • Connect to WIFI network
 $ nmcli dev wifi connect "wifi_name" password "wifi_password"
  • Test WIFI perpormance by tool iperf.

Common Hardware Interfaces, I2C, PWM, SPI, UART, etc

The Radxa Zero system images use configuration file /boot/uEnv.txt.

Warning: Remember there is only one line including item "overlays=" in file /boot/uEnv.txt.

Make sure that kernel is newer than 5.10.69-2-amlogic. If not, then try

 $ sudo apt update
 $ sudo apt install -y linux-headers-5.10.69-3-amlogic-gacf75c74f9
 $ sudo apt install -y linux-image-5.10.69-3-amlogic-gacf75c74f9


To enable I2C_EE_M1 on GPIOH_6 and GPIOH_7 (/dev/i2c-1), add item "meson-g12a-i2c-ee-m1-gpioh-6-gpioh-7" to the "overlays=" line.


To enable I2C_EE_M1 on GPIOX_10 and GPIOX_11 (/dev/i2c-1), add item "meson-g12a-i2c-ee-m1-gpiox-10-gpiox-11" to the "overlays=" line.


To enable I2C_EE_M3 (/dev/i2c-3), add item "meson-g12a-i2c-ee-m3-gpioa-14-gpioa-15" to the "overlays=" line.


To enable I2C_AO_M0 (/dev/i2c-4), add item "meson-g12a-i2c-ao-m0-gpioao-2-gpioao-3" to the "overlays=" line.


Please note that you cannot add overlays meson-g12a-i2c-ee-m1-gpioh-6-gpioh-7 and meson-g12a-i2c-ee-m1-gpiox-10-gpiox-11 at the same time.


To enable PWM_C, add item "eson-g12a-pwm-c-on-gpiox-8" to the "overlays=" line.


To enable PWMAO_A, add item "meson-g12a-pwmao-a-on-gpioao-11" to the "overlays=" line.



To enable SPI1, add item "meson-g12a-spi-spidev" to the "overlays=" line.



To set UART_EE_C as common serial communication devices, add these items "meson-g12a-uart-ee-c" to the "overlays=" line. The device /dev/ttyAML4 is available.