Rock3/Debian
ROCK 3 > Debian
Contents
- 1 Work with ROCK 3 Debian
- 1.1 Introduction to ROCK 3 Debian
- 1.2 List of boards supported
- 1.3 Access from the Host PC/Laptop
- 1.4 Debian Default User Account
- 1.5 Build
- 1.6 Radxa APT
- 1.7 Upgrade necessary packages
- 1.8 NPU
- 1.9 General purpose input-output (GPIO)
- 1.10 Common Hardware Interfaces, I2C, PWM, SPI, UART, CAN, etc
- 1.11 Check DDR size
- 1.12 Storage device
- 1.13 Test RTC Device
- 1.14 Test Audio Player
- 1.15 Test USB Host
- 1.16 Control PWM Fan
- 1.17 Ethernet
- 1.18 3A Ethernet
- 1.19 3B Ethernet
- 1.20 CM3 IO Ethernet
- 1.21 WiFi
- 1.22 3A WiFi
- 1.23 3B WiFi
- 1.24 CM3 IO WiFi
- 1.25 Bluetooth
- 1.26 3A Bluetooth
- 1.27 3B Bluetooth
- 1.28 CM3 IO Bluetooth
- 1.29 Changelogs of ROCK 3 Debian Release
Work with ROCK 3 Debian
Introduction to ROCK 3 Debian
This guide is available for official ROCK 3 Debian images.
ROCK 3 Debian is an easy to use desktop system. While working with ROCK 3 Debian, you will find it do well on playing music, Internet, Bluetooth, AI and so on.
ROCK 3 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.
List of boards supported
- ROCK 3A
- ROCK 3B
- Radxa E23
- Radxa E25
- Radxa CM3 IO
Access from the Host PC/Laptop
Option 1: Serial console
See Serial Console
Option 2: SSH
SSH server is enabled on port 22 of ROCK 3 default 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
Build
XFCE4 Desktop | Server |
---|---|
* ROCK 3A * ROCK 3B * Radxa CM3 IO |
* Radxa E23 * Radxa E25 |
Radxa APT
Radxa APT source includes stable one and testing one. Stable source includes stable packages while testing source includes latest but maybe unstable packages.
Radxa APT stable source is added by default while testing source is not added.
You can uncomment line like "deb http://apt.radxa.com/buster-testing/ buster main" in file /etc/apt/sources.list.d/apt-radxa-com.list to add testing source.
See file /etc/apt/sources.list.d/apt-radxa-com.list
deb http://apt.radxa.com/buster-stable/ buster main deb http://apt.radxa.com/buster-testing/ buster main
After adding testing source, you need to update APT and install your needed packages.
$ sudo apt-get update
For more detail about Radxa APT, please see Radxa APT.
Upgrade necessary packages
Here is the example of upgrading rockchip-overlay and kernel packages. Pakcage linux-4.19-rock-3-latest provides the latest ROCK 3 kernel packages.
$ sudo apt-get update $ sudo apt-get install -y rockchip-overlay $ sudo apt-get install -y linux-4.19-rock-3-latest
NPU
SoC RK3566/RK3568 is equipped with 0.8TOPS NPU. See NPU Run Test to test it on your ROCK 3 boards.
General purpose input-output (GPIO)
- ROCK 3 A has one 40-pin expansion header. To control them, see ROCK 3 A GPIO .
Common Hardware Interfaces, I2C, PWM, SPI, UART, CAN, etc
The ROCK 3 system images use configuration file /boot/uEnv.txt.
Warning: Remember there is only one line including item "overlays=" in file /boot/uEnv.txt.
To enable I2C, PWM, SPI, UART, CAN, etc, please see RK3566/RK3568 Available Overlay (ROCK 3 A, ROCK 3 B, Radxa CM3) part of Device Tree Overlays.
Check DDR size
ROCK 3 has several different DDR sizes, such as 2G, 4G, 8G, etc. Here it is 8G.
$ free -h total used free shared buff/cache available Mem: 7.4Gi 72Mi 7.1Gi 16Mi 182Mi 7.2Gi Swap: 0B 0B 0B
Storage device
- eMMC: /dev/mmcblk0
- uSD Card: /dev/mmcblk1
- NVME M.2 SDD: /dev/nvme0n1
Test RTC Device
Firstly, plug in RTC battery and power on.Check the rtc device:
root@rock3a:~# dmesg | grep rtc [ 0.749597] rk808-rtc rk808-rtc: registered as rtc0 [ 0.751404] rk808-rtc rk808-rtc: setting system clock to 2017-08-04 09:00:02 UTC (1501837202)
Secondly, use the following commands to set the system time and synchronize it to rtc.
root@rock3a:~# date -s "2021-08-17 20:00:00" root@rock3a:~# hwclock -w root@rock3a:~# hwclock -r 2021-08-17 20:00:04.745124+00:00 root@rock3a:~# poweroff
and then disconnect the power supply
Finally, 10 minutes later we power on ROCK 3 A via Type-C Port and check the rtc clock.
root@rock3a:~# hwclock -r 2021-08-17 20:10:14.745124+00:00
We see that rtc runs about 10 minutes also. That's good.
Test Audio Player
Download a wav audio file, and use the command to test the HP player.
$ amixer -c 1 cset numid=1 3 numid=1,iface=MIXER,name='Playback Path' ; type=ENUMERATED,access=rw------,values=1,items=11 ; Item #0 'OFF' ; Item #1 'RCV' ; Item #2 'SPK' ; Item #3 'HP' ; Item #4 'HP_NO_MIC' ; Item #5 'BT' ; Item #6 'SPK_HP' ; Item #7 'RING_SPK' ; Item #8 'RING_HP' ; Item #9 'RING_HP_NO_MIC' ; Item #10 'RING_SPK_HP' : values=3 $ aplay -D plughw:1,0 test.wav Playing WAVE 'test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo
To test the Mic recording, please follow:
$ amixer -c 1 cset numid=2 1 $ arecord -Dhw:1,0 -d 10 -f cd -r 44100 -c 2 -t wav ./mic_test.wav #this is a record command Recording WAVE './mic_test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo $ aplay -D plughw:1,0 mic_test.wav
Test USB Host
Plug in the U dish and use the command by serial console.
$ dmesg | tail [ 133.773558] usb 2-1: SerialNumber: CCYYB18M1CFKO4H4 [ 133.774332] usb-storage 2-1:1.0: USB Mass Storage device detected [ 133.774657] scsi host0: usb-storage 2-1:1.0 [ 134.841096] scsi 0:0:0:0: Direct-Access aigo U350 1100 PQ: 0 ANSI: 6 [ 134.846394] sd 0:0:0:0: [sda] 30720000 512-byte logical blocks: (15.7 GB/14.6 GiB) [ 134.847554] sd 0:0:0:0: [sda] Write Protect is off [ 134.847635] sd 0:0:0:0: [sda] Mode Sense: 43 00 00 00 [ 134.848824] sd 0:0:0:0: [sda] Write cache: enabled, read cache: enabled, doesn't support DPO or FUA [ 134.858173] sda: sda1 [ 134.861161] sd 0:0:0:0: [sda] Attached SCSI removable disk
$ sudo mount /dev/sda1 /mnt $ lsblk root@linaro-alip:~# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 1 14.7G 0 disk └─sda1 8:1 1 14.7G 0 part /mnt
If /dev/sda1 is successfully mounted, this usb host is working properly.
Control PWM Fan
There is one 3-pin PWM Fan header on ROCK 3A/3B.
To control them, try the following steps.
- Step 1: Add rk3568-pwm8-m0-fan overlay
You need to add the item "rk3568-pwm8-m0-fan" to line "overlays=" in file /boot/uEnv.txt. For example.
overlays=rk3568-can1-m0 rk3568-pwm8-m0-fan
- Step 2: Reboot ROCK 3A/3B and confirm that the directory /sys/devices/platform/fe6f0000.pwm related to pwm8 is created.
root@rock-3a:~# ls /sys/devices/platform/fe6f0000.pwm driver driver_override modalias of_node power pwm subsystem uevent
- Step 3: Set PWM period, duty_cycle, polarity and enable with root permission.
root@rock-3a:~# echo 0 > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/export root@rock-3a:~# echo 10000 > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/pwm0/period root@rock-3a:~# echo 5000 > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/pwm0/duty_cycle root@rock-3a:~# echo normal > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/pwm0/polarity root@rock-3a:~# echo 1 > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/pwm0/enable # Turn on fan root@rock-3a:~# echo 0 > /sys/devices/platform/fe6f0000.pwm/pwm/pwmchip*/pwm0/enable # Turn off fan
Ethernet
3A Ethernet
ROCK 3A is equipped with one 1G Ethernet port. You can use a network cable (one end connected to the external network port or route) to connect your ROCK 3 to the network. The ROCK 3 will automatically configure the network for your surfing on the Internet.
To test the Ethernet, we need to follow the steps:
- Switch to super user mode by command
$ sudo su
- Check whether the Ethernet is normal by command, ifconfig, which would show us a network card, eth0, and the Ethernet IP address. Also, use tool, ping, to connect to a normal domain.
$ ifconfig $ ping www.baidu.com
- If failed to connect to a normal domain. , try
$ sudo dhclient eth0
3B Ethernet
ROCK 3B is equipped with two 1G Ethernet ports. You can use two network cable (one end connected to the external network port or route) to connect your ROCK 3B to the network. The ROCK 3B will automatically configure the network for your surfing on the Internet.
To test the Ethernet, we need to follow the steps:
- Switch to super user mode by command
$ sudo su
- Check whether the Ethernet is normal by command, ifconfig, which would show us two network card, eth0 and eth1, and the Ethernet IP address. Also, use tool, ping, to connect to a normal domain.
$ ifconfig $ ping www.baidu.com
- If failed to connect to a normal domain. , try
$ sudo dhclient eth0 $ sudo dhclient eth1
CM3 IO Ethernet
CM3 IO is equipped with one 1G Ethernet port. You can use a network cable (one end connected to the external network port or route) to connect your CM3 IO to the network. CM3 IO will automatically configure the network for your surfing on the Internet.
To test the Ethernet, we need to follow the steps:
- Switch to super user mode by command
$ sudo su
- Check whether the Ethernet is normal by command, ifconfig, which would show us a network card, eth0, and the Ethernet IP address. Also, use tool, ping, to connect to a normal domain.
$ ifconfig $ ping www.baidu.com
- If failed to connect to a normal domain. , try
$ sudo dhclient eth0
WiFi
3A WiFi
Table of wireless modules supported on ROCK 3A.
Model | Chip | WiFi | BT | Others |
---|---|---|---|---|
ROCK Pi Wireless Module A1 | BCM43436B0 | 2.4G, 36Mbps | 4.2 | |
ROCK Pi Wireless Module A2 | BCM43456 | 2.4G&5G, 200Mbps | 5.0 | |
ROCK Pi Wireless Module A3 | BCM43598 | 2.4G&5G, >400Mbps | 5.0 | Support RSDB |
ROCK Pi Wireless Module A6 | BCM43752 | 2.4G&5G, WiFi 6 | 5.0 | |
Realtek RTL8723BE | RTL8723BE | 2.4G | 4.0 | |
Realtek RTL8822CE | RTL8822CE | 2.4G&5G | 5.0 | |
Intel 0MHK36 | Intel 3165 | 2.4G&5G | 4.2 | |
Intel 7265NGW | Intel 7265 | 2.4G&5G | 4.2 |
3B WiFi
Table of wireless modules supported on ROCK 3B.
Model | Chip | WiFi | BT | Others |
---|---|---|---|---|
AP7275S | BCM43752 | 2.4G&5G, WiFi 6 | 5.0 |
CM3 IO WiFi
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 iperf3.
Bluetooth
3A Bluetooth
Table of wireless modules supported on ROCK 3A.
Model | Chip | WiFi | BT | Others |
---|---|---|---|---|
ROCK Pi Wireless Module A1 | BCM43436B0 | 2.4G, 36Mbps | 4.2 | |
ROCK Pi Wireless Module A2 | BCM43456 | 2.4G&5G, 200Mbps | 5.0 | |
ROCK Pi Wireless Module A3 | BCM43598 | 2.4G&5G, >400Mbps | 5.0 | Support RSDB |
ROCK Pi Wireless Module A6 | BCM43752 | 2.4G&5G, WiFi 6 | 5.0 | |
Realtek RTL8723BE | RTL8723BE | 2.4G | 4.0 | |
Realtek RTL8822CE | RTL8822CE | 2.4G&5G | 5.0 | |
Intel 0MHK36 | Intel 3165 | 2.4G&5G | 4.2 | |
Intel 7265NGW | Intel 7265 | 2.4G&5G | 4.2 |
Radxa APT includes broadcom-wifibt-firmware package for Broadcom wireless modules and intel-wifibt-firmware package for Intel wireless modules. Take a look at your module and download the corresponding packages.
For example:
root@rock3a:~# apt-get update -y root@rock3a:~# apt-get install -y broadcom-wifibt-firmware intel-wifibt-firmware
Below is the example of testing Broadcom modules bluetooth.
- Check Bluetooth service.
root@rock3a:~# systemctl status bluetooth
- Run Bluetooth service if the Bluetooth service is inactive.
root@rock3a:~# systemctl start bluetooth
- Check Bluetooth device.
root@rock3a:~# hciconfig hci0: Type: Primary Bus: UART BD Address: 10:2C:6B:49:D5:53 ACL MTU: 1021:8 SCO MTU: 64:1 UP RUNNING RX bytes:850 acl:0 sco:0 events:58 errors:0 TX bytes:2814 acl:0 sco:0 commands:58 errors:0
- Example: Connect to Bluetooth Speaker.
- Install pulseaudio packages.
root@rock3a:~# apt-get install -y pulseaudio-module-bluetooth pulseaudio
- Run pulseaudio.
root@rock3a:~# pulseaudio --start
- Connect using bluetoothctl.
root@rock3a:~# bluetoothctl [bluetooth]# default-agent [bluetooth]# power on [bluetooth]# scan on [bluetooth]# trust 41:42:1A:8D:A9:65 #BT-280 [bluetooth]# pair 41:42:1A:8D:A9:65 [bluetooth]# connect 41:42:1A:8D:A9:65
- Play songs and enjoy it.
3B Bluetooth
Table of wireless modules supported on ROCK 3B.
Model | Chip | WiFi | BT | Others |
---|---|---|---|---|
AP7275S | BCM43752 | 2.4G&5G, WiFi 6 | 5.0 |
CM3 IO Bluetooth
Changelogs of ROCK 3 Debian Release
2021.11.15
rock3a_debian_buster_xfce4_arm64_20211113_0127-gpt.img
- Kernel version: 4.19.193-16-rockchip-g0cca7bdf9cdb
- U-Boot version: 2017.09-gf95bc56c33d-210525
- Support Intel Wireless 3165 / 7265 modules
- Support boot.scr and dt overlays
2021.09.15
rock3a_debian_buster_xfce4_arm64_20210914_0334-gpt.img
- Kernel version: 4.19.193-10-rockchip-g152e34a538b4
- Package broadcom-wifibt-firmware version: 1.3
- Package rockchip-overlay version: 2.9
- Package rtl8723be-firmware version: 0.1
2021.08.24
rock3a_debian_buster_xfce4_arm64_20210824_0136-gpt.img
- Kernel version: 4.19.193-2-rockchip-g7cf7399ddb5c
- U-Boot version: 2017.09-gbd2fa07970e-210525