基于RK3588单板机Linux系统操作指南（一）

前  言

本文档为单板机/工控机配套Linux系统使用说明，内容主要包含系统存储分区说明、系统启动配置、系统常规操作、系统升级流程等内容。
 

备注：本文适用于SBC-TL3588单板机及EPC-TL3588工控机系列（由SBC-TL3588单板机搭配扩展板与外壳组成），文中所有演示均基于4GByte LPDDR4X + 32GByte eMMC硬件配置的单板机开展。

开发环境

Windows开发环境：Windows10 64bit、Windows7 64bit

Linux开发环境：VMware16.2.5、Ubuntu22.04.4 64bit

系统版本：Tronlong-Desktop 22.04（类Ubuntu）、Linux-6.1.141、U-Boot 2017.09

术语表

为便于阅读，下表对文档出现的关键术语进行解释；对于广泛认同释义的术语，在此不做注释。

1系统启动说明

1.1启动方式

系统上电后，由CPU内部BootRom的引导代码依次从eMMC、SD卡、USB接口检测SPL启动程序，从第一个包含SPL启动程序的设备开始启动。SPL启动后，将优先从SD系统卡（非常规SD卡）引导U-Boot镜像，否则，将从原启动设备引导U-Boot镜像。

系统启动后自动登录root用户，调试串口终端会打印如下类似启动信息。"Bootdev(atags)：mmc 0"表示从eMMC启动，"Bootdev(atags)：mmc 1"表示从系统启动卡启动。

1.2打印信息说明

（1）Bootloader阶段打印信息

备注：Git系列号请以实际情况为准。

如上打印信息可知，单板机内存容量为4GiB，内存速率最高为2112MHz。

（2）Kernel阶段打印信息

如上打印信息可知，内核版本为6.1.141-rt36-00050-ga59887c1b0a8，根文件系统位于eMMC的mmcblk0p6存储分区。打印信息解析如下表所示：

备注：Git系列号请以实际情况为准。

（3）Rootfs阶段打印信息

如上打印信息可知，文件系统版本为Tronlong-Desktop 22.04。

2内存与存储分区说明

2.1内存分区

我司提供的系统已对单板机DDR内存进行划分，具体配置说明如下表。

（1）执行如下命令，可查看内核管理的内存空间。下图为4GByte容量LPDDR4X配置单板机的查询结果。

Target# cat /sys/kernel/debug/memblock/memory

（2）执行如下命令查看内核已经分配的内存。

Target# cat /sys/kernel/debug/memblock/reserved

编号5为CMA（连续内存区管理）空间，其余为内核管理空间。CMA的地址范围一般由内核自动分配，CMA内存空间为分配给驱动使用，应用层不可使用。

备注：单板机上电启动后，调试串口终端打印系统分配的CMA内存地址、大小信息与上图查询结果不一致，原因是Reserved节点将CMA与相邻连续的Reserved memory合并显示。因此，实际的CMA内存地址、大小信息以系统启动打印信息为准。

2.2存储分区

3系统设置说明

3.1开关机管理说明

（1）系统关机

执行如下命令，关闭系统。

Target# poweroff

（2）系统重启

执行如下命令，重启系统。

Target# reboot

备注：短按单板机复位按键RESET(KEY1)，亦可重启系统。

3.2系统用户说明

（1）root用户

root用户为系统中的超级管理员账户。具有最高权限，可访问和修改系统中的所有文件和配置。通常，root用户不受普通用户权限的限制，因此可以执行任何操作，包括安装软件、修改系统设置和删除文件等。

（2）自动登录

系统已通过设置systemd的serial-getty@.service服务配置实现自动以root用户登录功能，无需手动输入用户名密码。

实现自动登录serial-getty@.service服务的新增代码如下；若无需自动登录，注释以下代码即可。

ExecStart=-/sbin/agetty --autologin root --noclear %I $TERM

3.3时间配置说明

（1）系统时区

系统默认时区为：亚洲-中国-上海。

执行以下命令，可修改时区，本次修改系统时区为：美洲-美国阿拉斯加州。

Target# ln -sf /usr/share/zoneinfo/America/Adak /etc/localtime

（2）自动对时

系统默认支持NTP(Network Time Protocol)自动对时，系统会通过网络与时间服务器同步，确保系统时间准确。