系统启动与基础操作

本文档介绍 shimetapi RK3588 开发板在 Linux 系统下的基本操作，包括系统启动方式、文件系统结构、常用 Linux 命令、用户管理以及 systemd 服务管理，帮助开发者快速上手日常开发工作。

适用范围： shimetapi RK3588 开发板（C-3588LQ V1.0 核心板 + SHIMETAPI-M5-R2A V1.0 底板）在 Linux 6.1（Debian 12 / Ubuntu 22.04，出厂镜像为 Debian 12）下的基础操作。两镜像的差异见Debian 与 Ubuntu 镜像差异。

---

1. 准备工作

1.1 硬件准备

组件	型号/规格	数量	备注
主控板	C-3588LQ 核心板 + SHIMETAPI-M5-R2A 底板	1	已烧录 Linux 系统
调试串口线	USB 转 TTL（3.3V）	1	波特率 1500000（1.5Mbps）
网线	标准 RJ45 网线	1	可选，用于 SSH 登录
电源适配器	4V/5A DC	1	误差 ±5%，建议使用标配电源
电脑	Windows/Linux/Mac	1	安装有串口终端软件

1.2 串口引脚连接

主控板引脚	功能	连接调试器
UART_TX_DEBUG	发送	调试器 RX
UART_RX_DEBUG	接收	调试器 TX
GND	地	调试器 GND

实际登录串口设备：

• 高性能调试：/dev/ttyFIQ0（Rockchip FIQ 调试串口，启动早期即可用）
• 标准 16550A：/dev/ttyS9@1500000 baud（，MMIO 0xfebc0000）
• 早期控制台：earlycon=uart8250,mmio32,0xfeb50000（kernel cmdline 中的临时输出端口）

串口网络标注来源于底板原理图。 注意：请勿将 TX/RX 反接，且不要连接 VCC 引脚（调试器通常由 USB 供电）。

1.3 软件环境

项目	说明
操作系统	Linux 6.1（出厂 Debian 12，可选 Ubuntu 22.04）
串口终端	PuTTY / MobaXterm（Windows），picocom / minicom（Linux/macOS）

1.4 找到串口/ADB 设备号

[电脑端] Windows： 在设备管理器中查看端口，记录 COM 编号（如 COM3）。

[电脑端] Linux：

ls /dev/ttyUSB* /dev/ttyACM*

预期输出（Linux）：

/dev/ttyUSB0

[电脑端] macOS：

ls /dev/tty.usbserial-*

---

2. 开机与登录

2.1 上电并连接串口

步骤 1：连接串口终端

[电脑端] Linux 连接示例：

sudo picocom -b 1500000 /dev/ttyUSB0

[电脑端] macOS 连接示例：

screen /dev/tty.usbserial-xxxx 1500000

RK3588 调试串口波特率为 1500000，与 RK3568 一致。

步骤 2：给开发板上电

接通电源（4V/5A DC），观察指示灯：

• 红色 PWR 灯常亮 → 电源正常
• 绿色 RUN 灯闪烁 → 系统启动中

串口终端将看到 U-Boot 启动日志，随后进入系统登录提示符（主机名以系统实际配置为准，例如 linaro-alip）：

Linux linaro-alip 6.1.x ...

linaro-alip login:

2.2 默认账户登录

默认账户随镜像不同而不同：

镜像	主机名	默认账户	默认密码
Debian 12	linaro-alip	linaro	linaro
Ubuntu 22.04	RK3588	root	123456

串口登录示例（Debian 镜像）：

linaro-alip login: linaro
# 密码 linaro

串口登录示例（Ubuntu 镜像）：

RK3588 login: root
# 密码 123456

登录成功后显示命令提示符：

linaro@linaro-alip:~$

两种镜像的完整差异见Debian 与 Ubuntu 镜像差异。首次登录后建议用 passwd 修改默认密码。

验证当前用户：

whoami

输出：root

---

3. 远程登录（SSH）

3.1 查看开发板 IP 地址

查看有线网卡 IP：

# end1 是 GMAC1 千兆以太网接口（systemd 可预测命名）
ip addr show end1

输出：

3: end1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether fa:fc:7b:12:bc:96 brd ff:ff:ff:ff:ff:ff permaddr 42:46:d0:aa:1a:fa
    inet 192.168.49.60/24 brd 192.168.49.255 scope global dynamic noprefixroute end1
       valid_lft 85520sec preferred_lft 85520sec
    inet6 fe80::65bf:b5fc:7d55:71ee/64 scope link noprefixroute

系统使用 systemd 可预测接口命名（end1、enP2p33s0 等），不是传统 eth0。 如确需将 end1 改回 eth0，可通过 udev 规则实现（不推荐）。

3.2 从电脑 SSH 连接

[电脑端] SSH 连接示例（IP 以实际为准）：

# Debian 镜像
ssh linaro@192.168.49.60

# Ubuntu 镜像
ssh root@192.168.49.60

将 IP 地址替换为开发板的实际地址，账户密码与串口登录相同（见 2.2 节）。首次连接会提示确认主机指纹，输入 yes 确认。

前提条件： SSH 服务已在开发板上启动。如需确认：

检查 SSH 服务状态：

systemctl status ssh

详见 §6。

---

4. 系统信息确认

确认系统状态的基础检查。

4.1 内核与 CPU

查看内核版本：

uname -a

输出：

Linux linaro-alip 6.1.141 #11 SMP Fri Oct  9 10:22:09 CST 2026 aarch64 GNU/Linux

主机名 linaro-alip 为出厂 SDK 镜像默认值；具体版本号与编译时间取决于固件。

查看 CPU 核心数：

nproc
cat /proc/cpuinfo | grep processor | wc -l

输出：

8
8

8 核（RK3588：4×Cortex-A76 + 4×Cortex-A55，小核 @1.8GHz、大核 @2.256GHz）。

4.2 内存

查看内存：

free -h

输出（4GB 板）：

               total        used        free      shared  buff/cache   available
内存：         3.8Gi       646Mi       2.6Gi       2.7Mi       669Mi       3.2Gi
交换：            0B          0B          0B

实际为本机配置；如出厂为 8GB 板，total 会显示 7.6Gi 左右。

4.3 操作系统

查看发行版：

cat /etc/os-release

输出（节选）：

PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"
ID_LIKE="debian"
RK_BUILD_INFO="root@lcwt-KNPP-D32-R-Series Tue May 26 09:50:52 CST 2026"

4.4 温度监控

查看 7 个热敏区温度（数值除以 1000 即为摄氏度）：

cat /sys/class/thermal/thermal_zone*/temp

输出：

36076
36076
36076
36076
35153
35153
36076

对应 soc / bigcore0 / bigcore1 / littlecore / center / gpu / npu：

• 36076 = 36.076°C
• 35153 = 35.153°C

---

5. 进阶参考（速查表）

5.1 文件系统结构

RK3588 Linux 系统的文件系统采用标准的 Linux FHS，关键目录说明：

目录	说明
/	根文件系统
/bin	基本用户命令（如 ls、cp）
/sbin	系统管理命令（如 fdisk、mkfs）
/etc	系统配置文件
/dev	设备文件
/proc	进程和内核信息虚拟文件系统
/sys	内核和硬件设备信息虚拟文件系统
/var	可变数据（日志、缓存等）
/tmp	临时文件
/home	用户主目录
/root	root 用户主目录
/usr	用户程序和数据
/lib	系统库文件
/mnt	临时挂载点
/boot	内核和启动文件
/oem	OEM 分区，厂商自定义数据
/userdata	用户数据分区

查看磁盘分区：

df -h

输出：

文件系统        大小  已用  可用 已用% 挂载点
/dev/root        14G  4.0G  9.2G   30% /
devtmpfs        1.8G   12K  1.8G    1% /dev
tmpfs           2.0G     0  2.0G    0% /dev/shm
tmpfs           779M  2.2M  777M    1% /run
tmpfs           5.0M   12K  5.0M    1% /run/lock
tmpfs           2.0G   24K  2.0G    1% /tmp
/dev/mmcblk0p7  124M  5.3M  115M    5% /oem
/dev/mmcblk0p8   15G   32M   15G    1% /userdata
tmpfs           390M   36K  390M    1% /run/user/1000

查看具体磁盘挂载信息：

mount | grep "^/dev"

输出：

/dev/mmcblk0p6 on / type ext4 (rw,relatime)
/dev/mmcblk0p7 on /oem type ext4 (rw,relatime)
/dev/mmcblk0p8 on /userdata type ext4 (rw,relatime)

5.2 常用命令速查

文件操作

# 列出文件和目录（含隐藏文件及详细信息）
ls -la

# 切换目录
cd /etc

# 查看当前目录
pwd

# 创建目录
mkdir mydir

# 创建空文件或更新时间戳
touch myfile.txt

# 复制文件
cp source.txt dest.txt

# 移动/重命名
mv oldname.txt newname.txt

# 删除文件
rm file.txt

# 递归删除目录
rm -rf dirname

# 查看文件全部内容
cat file.txt

# 分页查看（q 退出）
less file.txt

# 查看首/尾 n 行
head -n 20 file.txt
tail -n 20 file.txt

# 实时查看日志（Ctrl+C 退出）
tail -f /var/log/syslog

文件查找与搜索

# 按文件名查找
find /etc -name "*.conf"

# 按内容搜索（无匹配返回 exit code 1）
grep -r "linaro" /etc/os-release

# 查找可执行文件位置
which ls       # 单个
whereis ls     # 二进制 + 手册

输出示例：

$ find /etc -name 'hostname'
/etc/hostname

$ grep -r "linaro" /etc/os-release
（无输出）

$ which ls
/usr/bin/ls

$ whereis ls
ls: /usr/bin/ls /usr/share/man/man1/ls.1.1.gz

进程管理

# 查看进程
ps aux

# 动态查看（交互式终端使用，q 退出）
top
htop    # 需 apt install htop

# 按名称查找
ps aux | grep ssh

# 终止进程（PID 由 ps aux 获得）
kill <PID>
kill -9 <PID>    # 强制终止

ps aux 节选：

USER         PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root           1  0.4  0.3 169284 12252 ?        Ss   05:03   0:04 /sbin/init
root           2  0.0  0.0      0     0 ?        S    05:03   0:00 [kthreadd]

系统信息

# 系统运行时间
uptime

# 系统启动时间
cat /proc/version

$ uptime
 05:25:56 up 22 min,  1 user,  load average: 0.06, 0.03, 0.03

$ cat /proc/version
Linux version 6.1.141 (xyp@lcwt-KNPP-D32-R-Series) (aarch64-none-linux-gnu-gcc ...) #11 SMP Fri Oct  9 10:22:09 CST 2026

5.3 用户管理

查看用户

whoami    # 当前用户
who       # 已登录的用户
w         # 用户及其活动
cat /etc/passwd   # 所有用户

$ whoami
root

$ who
linaro   tty7         2026-04-27 19:49 (:0)

$ w
 05:19:44 up 15 min,  1 user,  load average: 0.00, 0.02, 0.04
USER     TTY      来自           LOGIN@   IDLE   JCPU   PCPU WHAT
linaro   tty7     :0               274月26 170days  1.98s  0.55s xfce4-session

cat /etc/passwd 节选：

root:x:0:0:root:/root:/bin/bash
daemon:x:1:1:daemon:/usr/sbin:/usr/sbin/nologin
...
linaro:x:1000:1000:linaro,,,:/home/linaro:/bin/bash

出厂镜像默认用户是 linaro（UID 1000），可作为 sudo 用户使用 root 权限。

添加 / 删除用户

# 创建新用户（自动建主目录 + 指定 shell）
useradd -m -s /bin/bash newuser

# 设置密码
passwd newuser

# 仅删除用户（保留主目录）
userdel newuser

# 删除用户 + 主目录
userdel -r newuser

-m 自动创建 /home/newuser，-s 指定默认 shell。

用户组管理

# 查看用户所属组
groups root

# 将用户添加到 sudo 组
usermod -aG sudo newuser

# 创建 / 修改组
groupadd mygroup
usermod -aG mygroup newuser

$ groups root
root : root

出厂镜像中 root 已绑定 root 组；linaro 需要先加入 sudo 组，才能使用 sudo 提权。 /usr/bin/sudo 已预装。

切换用户

# 切换到其他用户
su - newuser

# 临时以 root 权限执行单条命令
sudo apt update

---

6. systemd 服务管理

RK3588 Linux 系统使用 systemd 作为系统和服务管理器。

重要： Debian 12 / OpenSSH 9.x 默认服务名是 ssh.service（不是 sshd.service）。 配置文件路径仍为 /etc/ssh/sshd_config。

6.1 查看与启停服务

# 查看服务状态
systemctl status ssh

# 启动 / 停止 / 重启
systemctl start ssh
systemctl stop ssh
systemctl restart ssh

# 仅重新加载配置（不重启进程）
systemctl reload ssh

systemctl status ssh 节选：

● ssh.service - OpenBSD Secure Shell server
     Loaded: loaded (/lib/systemd/system/ssh.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-10-15 05:09:39 UTC; 10min ago
       Docs: man:sshd(8)
             man:sshd_config(5)
    Process: 16587 ExecStartPre=/usr/sbin/sshd -t (code=exited, status=0/SUCCESS)
   Main PID: 16588 (sshd)
      Tasks: 1 (limit: 4318)

start/stop/restart/reload 命令均执行成功无输出。 注意：stop ssh 会立即断开所有 SSH 连接，请仅在串口登录后再执行。

6.2 开机自启

systemctl is-enabled ssh    # 查询
systemctl enable ssh        # 启用
systemctl disable ssh       # 禁用

$ systemctl is-enabled ssh
enabled

推荐保持 SSH 服务开机自启。

6.3 查看所有服务

# 运行中的服务
systemctl list-units --type=service --state=running

# 列出所有单元文件（含未启用的）
systemctl list-unit-files --type=service

list-units 节选：

  UNIT                         LOAD   ACTIVE SUB     DESCRIPTION
  acpid.service                loaded active running ACPI event daemon
  bluetooth.service            loaded active running Bluetooth service
  lightdm.service              loaded active running Light Display Manager
  NetworkManager.service       loaded active running Network Manager
  rknn-mdns.service            loaded active running Rockchip mDNS Device Discovery
  ssh.service                  loaded active running OpenBSD Secure Shell server

list-unit-files 节选：

UNIT FILE                         STATE   PRESET
anacron.service                   enabled enabled
lightdm.service                   enabled enabled
networking.service                enabled enabled
NetworkManager.service            enabled enabled
ssh.service                       enabled enabled

出厂镜像开机自启的服务包含桌面 lightdm、网络 NetworkManager、SSH ssh.service、蓝牙 bluetooth 等。

6.4 系统日志

# 查指定服务的最近日志
journalctl -u ssh

# 最近 10 条（--no-pager 禁止分页）
journalctl -n 10 --no-pager

# 实时查看（Ctrl+C 退出）
journalctl -f

journalctl -u ssh -n 5：

10月 15 05:09:39 linaro-alip sshd[16588]: Server listening on 0.0.0.0 port 22.
10月 15 05:09:39 linaro-alip sshd[16588]: Server listening on :: port 22.
10月 14 09:56:30 linaro-alip sshd[1641]: Server listening on 0.0.0.0 port 22.
10月 14 09:56:30 linaro-alip sshd[1641]: Server listening on :: port 22.
10月 14 09:56:30 linaro-alip sshd[1641]: Server listening on 0.0.0.0 port 22.

journalctl -n 10 --no-pager：

10月 15 05:19:02 linaro-alip irqbalance[626]: -----------------------------------------------------------------------------
10月 15 05:19:02 linaro-alip irqbalance[626]: -----------------------------------------------------------------------------
...
10月 15 05:20:06 linaro-alip systemd[1]: Configuration file /lib/systemd/system/rkaiq_3A.service is marked world-writable. Please remove world writability permission bits. Proceeding anyway.

已知小问题：日志中会出现 rkaiq_3A.service 权限告警（world-writable，即所有用户都可写）。 不影响运行，建议修复：chmod 644 /lib/systemd/system/rkaiq_3A.service。

---

7. 故障排除

7.1 串口无输出

现象： 上电后串口终端没有任何输出。

原因： 串口线连接错误或波特率设置不正确。

解决方案：

1. 检查 TX/RX 是否接反（TX 接调试器 RX，RX 接调试器 TX）
2. 确认波特率设置为 1500000
3. 确认串口设备号正确（Windows 下检查 COM 口）
4. 尝试重新插拔 USB 转 TTL 模块

7.2 登录密码错误

现象： 输入密码后提示 Login incorrect。

原因： 默认密码可能已被修改，或系统镜像不同。

解决方案：

1. 出厂默认 root 无密码，直接回车。如已修改，需重置或重新烧录。
2. 如完全无法登录，需重新烧录系统镜像。

7.3 SSH 连接被拒绝

现象： SSH 连接时提示 Connection refused。

原因： SSH 服务未启动或网络未配置。

解决方案：

# 通过串口登录后，检查 SSH 服务状态
systemctl status ssh

# 如果未启动，启动 SSH 服务
systemctl start ssh
systemctl enable ssh

7.4 NPU 设备未识别

现象： dmesg | grep rknpu 无输出。

原因： 内核未启用 NPU 驱动或设备树未配置 NPU 节点。

解决方案：

• 确认内核配置中 CONFIG_ROCKCHIP_NPU=y
• 确认设备树中 rknpu 节点 status = "okay"
• 重新编译内核并烧录

---

相关文档

• 01_系统启动与基础操作 — 系统基础操作
• 02_网络配置与SSH — 网络和远程登录配置
• 03_软件包管理与更新 — 软件包管理
• 05_hardware-reference/00_硬件事实基线 — 硬件事实清单