View source for Zero/Debian

{{Zero_header}}

{{Languages|zero/Debian}}

    [[Zero | Radxa Zero]] > [[zero/Debian | Debian]]

__TOC__

== 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 [[zero/dev/serial-console | Serial Console]]

==== Option 2: SSH ====
SSH server  is enabled on port 22 of Radxa Zero image. 

Please use [https://angryip.org/ 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

===Desktop ===

The preinstalled Desktop is xfce4.

=== Install and update  necessary packages (optional) ===

Add Radxa APT, see [[zero/radxa-apt | 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.

=== <span id="common_hardware_interface">Common Hardware Interfaces, I2C, PWM, SPI, UART, etc</span> ===

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 at least version 5.10.69-5-amlogic. If not, then try

  $ sudo apt update
  $ sudo apt install -y linux-headers-5.10.69-5-amlogic-gfeede6ac474e
  $ sudo apt install -y linux-image-5.10.69-5-amlogic-gfeede6ac474e

==== I2C ====

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. 

  overlays=meson-g12a-i2c-ee-m1-gpioh-6-gpioh-7

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. 

  overlays=meson-g12a-i2c-ee-m1-gpiox-10-gpiox-11

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

  overlays=meson-g12a-i2c-ee-m3-gpioa-14-gpioa-15

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

  overlays=meson-g12a-i2c-ao-m0-gpioao-2-gpioao-3

Please note that do not 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.

==== PWM ====

===== PWM_C channel =====

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

  overlays=meson-g12a-pwm-c-on-gpiox-8

You would see directory /sys/devices/platform/soc/ffd00000.bus/ffd1a000.pwm is generated.

Then you can set up PWM-C channel with directory /sys/devices/platform/soc/ffd00000.bus/ffd1a000.pwm/pwm/pwmchipY.

===== PWMAO_A channel =====

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

  overlays=meson-g12a-pwmao-a-on-gpioao-11

You would see directory /sys/devices/platform/soc/ff800000.bus/ff807000.pwm is generated.

Then you can set up PWMAO_A channel with directory /sys/devices/platform/soc/ff800000.bus/ff807000.pwm/pwm/pwmchipY.

==== SPI ====

To enable SPI_A (/dev/spidev0.0), add item "meson-g12a-spi-spidev" to the "overlays=" line.

  overlays=meson-g12a-spi-spidev
  param_spidev_spi_bus=0
  param_spidev_max_freq=10000000

To enable SPI_B (/dev/spidev1.0), add item "meson-g12a-spi-spidev" to the "overlays=" line.

  overlays=meson-g12a-spi-spidev
  param_spidev_spi_bus=1
  param_spidev_max_freq=10000000

==== UART ====

One uart port cannot be used as common serial communication and serial console at the same time.

===== Common serial communication =====

To set UART_AO_A as common serial communication devices, add this item "meson-g12a-uart-ao-a-on-gpioao-0-gpioao-1" to the "overlays=" line. The device /dev/ttyAML0 is available.

  overlays=meson-g12a-uart-ao-a-on-gpioao-0-gpioao-1

To set UART_AO_B as common serial communication devices, add this item "meson-g12a-uart-ao-b-on-gpioao-2-gpioao-3" to the "overlays=" line. The device /dev/ttyAML1 is available.

  overlays=meson-g12a-uart-ao-b-on-gpioao-2-gpioao-3

To set UART_AO_B as common serial communication devices, add this item "meson-g12a-uart-ao-b-on-gpioao-8-gpioao-9" to the "overlays=" line. The device /dev/ttyAML1 is available.

  overlays=meson-g12a-uart-ao-b-on-gpioao-8-gpioao-9

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

  overlays=meson-g12a-uart-ee-c

Please note that do not add overlays meson-g12a-uart-ao-b-on-gpioao-2-gpioao-3 and meson-g12a-uart-ao-b-on-gpioao-8-gpioao-9 at the same time.

===== Serial console =====

To set UART_AO_A as serial console, add the following two lines to /boot/uEnv.txt

  console=ttyAML0,115200
  overlays=meson-g12a-uart-ao-a-on-gpioao-0-gpioao-1

=== USB Audio ===

See [[zero/hardware/audio | Audio]].

=== USB Camera ===

See [[zero/hardware/camera/ | Camera module]].

=== Changelogs ===