快速设置

用户名和密码

User name	Password
radxa	radxa
rock	rock

更新系统

请参考 System Update部分更新系统。

网络配置

以太网设置

使用有线上网时，请将网线插入RJ45接口。桌面右下角会有一个网络连接图标，选择你要连接的网络，就可以上网了。

rock5a/rock5a_wifi

无线网设置

如果需要无线上网，就需要有无线模块。以下是 Radxa ROCK 5A 无线上网教程：

点击桌面右下角的WiFi图标，选择您要连接的WiFi并输入密码。

rock5a/rock5a_wifi

进入 KDE KDE Wallet Service界面，按照指引设置 wallet。
如果WiFi连接成功，网络管理会显示你的wifi名称已激活。如果要关闭wifi，点击箭头所指的方框取消wifi连接。

rock5a/rock5a_wifi

静态 IP 设置

网络通常使用动态 IP 地址来更好地管理网络上的 IP 地址分配。动态 IP 地址通过 DHCP（动态主机配置协议）自动分配，这意味着每台设备在连接到网络时都会分配到一个唯一的 IP 地址。这种方法可以更轻松地管理网络，并避免设备之间发生 IP 地址冲突的可能性。

如果要设置静态 IP 地址，则需要手动为设备分配固定 IP 地址。

如以下操作所示：

system setting >> connections >> wire-ed Ethernet or Wi-Fi >> IPv4 >> select Manual >> Add >> enter address, netmask, gatewat >> Apply

rock5a/rock5a_wifi

区域设置

更改系统语言

**注意：**系统默认设置为英文，如需其他语言，请按照以下说明操作。

在系统设置中，点击区域设置添加语言。

rock5a_system_language_1

选择您想要的语言并单击添加。

rock5a_system_language_2

在新语言列中，单击向上图标提升为默认语言，然后单击应用。重新启动计算机，系统语言将设置为新语言。

rock5a_system_language_3

更改语言输入法

Debian系统默认只有英文输入法，如果需要其他语言的输入法，需要单独安装。这里我们举例说明如何安装拼音。

环境配置

如果使用的Debian环境不是中文环境，需要切换到中文环境，可以使用如下命令切换，然后输入用户密码

sudo dpkg-reconfigure locales

按空格或回车选择确定，准备下一步安装。

rock5a_language_input_1 rock5a_language_input_2

执行以下命令更新并安装系统环境软件：

sudo apt update

安装fcitx中文输入法

打开命令终端并输入以下命令：

sudo apt install fcitx  # 输入 "Y"，将安装包。

执行你需要安装的中文输入法命令，然后输入用户密码。

sudo apt install fcitx-googlepinyin  # 输入“Y”完成安装。

安装成功后，请重启电脑，电脑任务栏会显示键盘图标。

右键单击键盘图片，然后单击配置

点击“+”添加新的语言输入法。

rock5a_language_input_4

点击方框取消 "only show current language"

rock5a_language_input_5

在搜索框中输入Google pinyin，点击确定，完成添加新的语言输入法。

rock5a_language_input_6

单击 ^ 调整语言优先级，如图所示。

rock5a_language_input_7

现在您可以开始使用拼音了。如果要切换语言，只需点击键盘图标即可切换语言输入法。

rock5a_language_input_8

键盘布局

在系统界面打开Input Devices。

rock5a_keyboard_1

单击Layouts，然后单击Add以选择所需的键盘布局。

rock5a_keyboard_2

选择Limit selection by language 或 layout 来设置你想要的键盘布局，你可以点击Preview查看。

rock5a_keyboard_3

你可以点击Move up提升优先级然后点击Apply。

rock5a_keyboard_4

远程访问

SSH

本教程介绍如何使用 SSH 从另一台计算机远程访问电路板。

查看用户名

在电路板上打开终端，在终端中输入以下命令查看用户名


  radxa@rock-5a:~$ whoami
  radxa

该命令显示当前用户的用户名，如上图所示，当前用户的用户名为 radxa

查看 IP 地址

通过命令查看 IP

在电路板上打开终端，在终端中输入以下命令查看 IP 地址：


  radxa@rock-5a:~$ ip a

与主机位于同一网段的 ip 地址就是 SSH 连接所需的 ip 地址，例如，以下输出中的 192.168.2.100 就是我们需要的 ip 地址。

1: lo： <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00 brd 00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host
       valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether 56:ae:03:82:18:51 brd ff:ff:ff:ff:ff:ff:ff:ff:ff
    inet 192.168.2.100/24 brd 192.168.2.255 scope global dynamic noprefixroute eth0
       valid_lft 43176sec preferred_lft 43176sec
    inet6 fe80::8e:d164:96ea:40b6/64 scope link noprefixroute
       valid_lft forever preferred_lft forever

使用 Angryip 查找 IP

在无法直接操作主板获取无屏幕或远程 IP 地址时，可以使用此方法查找 IP 地址。

首先主机需要下载 Angryip，然后确保主机和主板在同一个局域网内。
打开 Angryip，选择 IP 范围为 192.168.2.0 - 192.168.2.255（选择主机和主板所在的网段），点击开始，如图所示。
Ctrl + F 查找 rock 关键字，找到主板的 IP 地址。

检查 SSH 服务状态

在终端中运行以下命令：


  radxa@rock-5a:~$ sudo systemctl status ssh

此命令用于查看 SSH 服务的状态。如果运行该命令时提示 "找不到 ssh.service 单元"，则需要安装 SSH 服务。


  radxa@rock-5a:~$ sudo apt-get update
  radxa@rock-5a:~$ sudo apt-get install openssh-server openssh-sftp-server

● ssh.service - OpenBSD Secure Shell server
     Loaded: loaded (/lib/systemd/system/ssh.service; enabled; preset: enabled)
     Active: active (running) since Wed 2024-05-08 07:52:50 UTC; 24min ago
TriggeredBy: ● ssh.socket
       Docs: man:sshd(8)
             man:sshd_config(5)
    Process: 637 ExecStartPre=/usr/sbin/sshd -t (code=exited, status=0/SUCCESS)
   Main PID: 657 (sshd)
      Tasks: 1 (limit: 3420)
     Memory: 5.5M
        CPU: 398ms
     CGroup: /system.slice/ssh.service
             └─657 "sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups"

May 08 07:52:49 radxa-zero systemd[1]: Starting ssh.service - OpenBSD Secure Shell server...
May 08 07:52:50 radxa-zero sshd[657]: Server listening on :: port 22.
May 08 07:52:50 radxa-zero systemd[1]: Started ssh.service - OpenBSD Secure Shell server.
May 08 07:53:22 radxa-zero sshd[783]: Accepted password for radxa from 192.168.31.1 port 49474 ssh2
May 08 07:53:22 radxa-zero sshd[783]: pam_unix(sshd:session): session opened for user radxa(uid=1000) by (uid=0)
May 08 07:53:22 radxa-zero sshd[783]: pam_env(sshd:session): deprecated reading of user environment enabled

如果 Active 状态为 active (running)，则 SSH 处于运行状态。
如果 Active 状态为 inactive (dead)，则 SSH 已停止，即服务未运行，需要重新启动。


  radxa@rock-5a:~$ sudo systemctl restart ssh

如果需要开机自启 SSH 服务，请运行以下命令：


  radxa@rock-5a:~$ sudo systemctl enable --now ssh

SSH 连接到电路板

ssh [username]@[IP address] # or ssh [username]@[hostname]

VNC

本教程介绍如何使用 VNC 从 Windows 计算机远程访问系统。

安装 VNC 服务器

打开终端应用程序，输入以下命令更新软件包列表。


  radxa@rock-5a:~$ sudo apt-get update

输入以下命令安装 TigerVNC 服务器。


  radxa@rock-5a:~$ sudo apt-get install tigervnc-standalone-server

安装 dbus-x11 依赖项以确保与 VNC 服务器的正常连接：


  radxa@rock-5a:~$ sudo apt-get install dbus-x11

安装完成后，要完成 VNC 服务器的初始配置，请使用 vncserver 命令设置安全密码并创建初始配置文件：


  radxa@rock-5a:~$ vncserver

::注意您是否要输入只允许查看的密码（y/n）？ n 提示只允许查看，您是否要选择否并输入 n，这样您就可以根据自己的情况进行远程操作，而不仅仅是观看？ :::

配置 VNC 服务器

TigerVNC 启动后，将创建一个包含 VNC 服务器 IP 地址和端口号（通常为 5901）的 VNC 会话。要改变 VNC 服务器的配置方式，首先要使用以下命令停止运行在 5901 端口的 VNC 服务器实例：


  radxa@rock-5a:~$ vncserver -kill :1

运行 vncserver 命令时，会在 ~/.vnc 目录中生成 xstartup。如果没有生成，请手动创建并赋予其可执行权限：


  radxa@rock-5a:~$ touch ~/.vnc/xstartup
  radxa@rock-5a:~$ chmod +x ~/.vnc/xstartup

编辑 xstartup 配置文件如下：


  radxa@rock-5a:~$ cat ~/.vnc/xstartup
  #!/bin/sh
  unset SESSION_MANAGER
  unset DBUS_SESSION_BUS_ADDRESS
  unset XDG_RUNTIME_DIR
  /etc/X11/xinit/xinitrc
  [ -x /etc/vnc/xstartup  ] && exec /etc/vnc/xstartup
  [ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources
  xsetroot -solid grey
  #vncconfig -iconic &
  startkde &

编辑配置后，重启 VNC 服务器：


  radxa@rock-5a:~$ vncserver -localhost no

查看 VNC 服务器：


  radxa@rock-5a:~$ vncserver -list
  TigerVNC server sessions:
  X DISPLAY #	RFB PORT #	PROCESS ID	SERVER
  :1         	5901      	2160      	Xtigervnc
  :2         	5902      	2872      	Xtigervnc

在 VNC 查看器上测试连接：在 Windows PC 上打开 VNC 查看器，输入产品的 IP 地址和端口号，然后使用 VNC 服务器的用户名和密码进行验证。

在 Windows PC 上安装 VNC 查看器

在浏览器上进入 VNC 查看器下载页面，如 https://www.realvnc.com/en/connect/download/viewer/。
下载并安装 VNC 查看器。

连接设置

在 VNC 查看器上输入产品的 IP 地址和端口号。2.
使用 VNC 服务器的用户名和密码进行验证。
连接成功后，即可进行远程控制。

TeamViewer

安装 TeamViewer


  radxa@rock-5a:~$ wget https://download.teamviewer.com/download/linux/teamviewer-host_arm64.deb
  radxa@rock-5a:~$ sudo apt install . /teamviewer-host_arm64.deb

配置 TeamViewer


  radxa@rock-5a:~$ sudo teamviewer setup    # Agree to protocol login and authorization

卸载 xfce4-screensaver

信息

此程序修复了 TeamViewer 的键盘和鼠标控件因长时间挂起而无法工作的问题。


  radxa@rock-5a:~$ sudo apt remove xfce4-screensaver

配置虚拟显示器

信息

如果已连接真实显示器，则此步骤为可选步骤。


  radxa@rock-5a:~$ sudo apt update
  radxa@rock-5a:~$ sudo apt install xserver-xorg-video-dummy
  radxa@rock-5a:~$ sudo mv /etc/X11/xorg.conf.d/20-modesetting.conf /etc/X11/xorg.conf.d/20-modesetting.bak
  radxa@rock-5a:~$ sudo nano /etc/X11/xorg.conf.d/10-headless.conf

# Add the following and reboot
Section "Monitor"
        Identifier "dummy_monitor"
        HorizSync 28.0-80.0
        VertRefresh 48.0-75.0
        Modeline "1920x1080" 172.80 1920 2040 2248 2576 1080 1081 1084 1118
EndSection

Section "Device"
        Identifier "dummy_card"
        VideoRam 256000
        Driver "dummy"
EndSection

Section "Screen"
        Identifier "dummy_screen"
        Device "dummy_card"
        Monitor "dummy_monitor"
        SubSection "Display"
        EndSubSection
EndSection

连接到 TeamViewer

您可以参考 TeamViewer 官方文档。

提示

请参考我们的瑞莎系统章节，了解更多软件配置内容。

快速设置

用户名和密码​

更新系统​

网络配置​

以太网设置​

无线网设置​

静态 IP 设置​

区域设置​

更改系统语言​

更改语言输入法​

环境配置​

安装fcitx中文输入法​

键盘布局​

远程访问​

SSH​

查看用户名​

查看 IP 地址​

通过命令查看 IP​

使用 Angryip 查找 IP​

检查 SSH 服务状态​

SSH 连接到电路板​

VNC​

安装 VNC 服务器​

配置 VNC 服务器​

在 Windows PC 上安装 VNC 查看器​

连接设置​

TeamViewer​

安装 TeamViewer​

配置 TeamViewer​

卸载 xfce4-screensaver​

配置虚拟显示器​

连接到 TeamViewer​

用户名和密码

更新系统

网络配置

以太网设置

无线网设置

静态 IP 设置

区域设置

更改系统语言

更改语言输入法

环境配置

安装fcitx中文输入法

键盘布局

远程访问

SSH

查看用户名

查看 IP 地址

通过命令查看 IP

使用 Angryip 查找 IP

检查 SSH 服务状态

SSH 连接到电路板

VNC

安装 VNC 服务器

配置 VNC 服务器

在 Windows PC 上安装 VNC 查看器

连接设置

TeamViewer

安装 TeamViewer

配置 TeamViewer

卸载 xfce4-screensaver

配置虚拟显示器

连接到 TeamViewer