RK3588 Ubuntu优化：ARM开发板系统部署指南

欢迎使用Ubuntu Rockchip社区项目，这是一个专注于将Ubuntu系统移植到Rockchip硬件平台的开源 initiative。本指南将帮助您在RK3588开发板上完成从环境准备到系统优化的全流程部署，特别针对新手用户设计，强调实战操作与问题解决。

部署准备篇：硬件与环境配置

核心准备三要素

请牢记部署成功的三个关键：卡速足、电源稳、显网全
这三个要素直接决定系统部署的稳定性和后续使用体验。

硬件要求清单

⌛ 约10分钟准备时间

请确保您已准备以下硬件组件：

• 存储介质：UHS-I以上规格的SD卡（建议32GB以上容量）
• 电源供应：DC 5V 3A电源适配器（务必使用官方推荐规格）
• 显示设备：HDMI显示器及连接线（首次配置必需）
• 网络设备：有线以太网连接（推荐）或兼容的无线模块
• 输入设备：USB键盘和鼠标（或通过SSH远程访问）

💡 注意：使用劣质电源可能导致系统不稳定或无法启动，建议投资购买品牌电源适配器。

软件环境准备

⌛ 约5分钟准备时间

您需要在电脑上安装以下工具：

• 镜像烧录工具（如balenaEtcher或USBimager）
• 终端模拟器（用于SSH连接，如Putty或系统自带终端）
• SD卡格式化工具（如SD Card Formatter）

# 检查系统是否已安装必要工具（以Ubuntu为例）
sudo apt update
sudo apt install -y git wget curl # 基础工具

部署实施篇：从镜像到系统启动

获取系统镜像

⌛ 约20分钟（取决于网络速度）

您可以通过两种方式获取系统镜像：

1. 预编译镜像（推荐新手）
   从项目发布页面下载适用于您开发板的最新镜像文件

2. 源码构建（高级用户）

   # 克隆项目仓库
   git clone https://gitcode.com/gh_mirrors/ub/ubuntu-rockchip
   cd ubuntu-rockchip
   
   # 查看支持的开发板列表
   ls config/boards/
   
   # 构建指定开发板的镜像（以Rock 5B为例）
   sudo ./scripts/config-image.sh rock-5b
   

镜像烧录步骤

⌛ 约15分钟

1. 插入SD卡到电脑
2. 打开balenaEtcher工具
3. 选择下载的系统镜像文件
4. 选择SD卡设备
5. 点击"Flash"开始烧录
6. 等待验证完成

💡 注意：烧录过程中不要移除SD卡或关闭电脑，中断可能导致SD卡损坏。

首次启动配置

⌛ 约5分钟（首次启动时间较长）

1. 将烧录好的SD卡插入开发板
2. 连接HDMI显示器、键盘和电源
3. 接通电源，系统将自动启动

🔄 启动过程：

• 显示Rockchip启动Logo → 内核加载 → 系统初始化 → 用户配置

首次启动后，系统会引导您完成：

• 语言选择
• 时区设置
• 用户名和密码创建
• 网络配置

核心特性篇：系统功能与架构解析

系统架构概览

graph TD
    A[Ubuntu系统层] --> B[硬件抽象层]
    B --> C[Rockchip驱动层]
    C --> D[硬件设备]
    A --> E[用户空间应用]
    E --> F[桌面环境]
    E --> G[开发工具链]

项目核心目录结构：

• config/：系统配置中心，包含开发板、系统版本和风格定义
• overlay/：系统覆盖文件，用于定制系统行为
• packages/：U-Boot引导程序包，针对不同开发板优化

硬件加速能力

RK3588平台提供强大的硬件加速功能：

• 3D图形加速：通过panfork驱动支持OpenGL ES 3.2
• 视频编解码：支持4K H.265/H.264硬件加速
• 图像处理：集成ISP支持高质量摄像头输入

系统登录方式

服务器版本登录：

# 通过SSH连接
ssh ubuntu@[开发板IP地址]
# 默认用户名：ubuntu，默认密码：ubuntu（首次登录需修改）

桌面版本登录：

• 通过HDMI显示器直接操作
• 按照图形界面引导完成初始设置

性能优化篇：嵌入式Ubuntu性能调优

存储介质性能对比

存储类型	读取速度	写入速度	适用场景	价格区间
UHS-I SD卡	80-100MB/s	40-60MB/s	入门测试	¥30-80
UHS-II SD卡	150-200MB/s	80-120MB/s	日常使用	¥80-150
NVMe SSD	1000-2000MB/s	800-1500MB/s	高性能需求	¥200-500

💡 注意：部分开发板需要额外的NVMe转接板才能使用NVMe SSD。

系统优化配置

⌛ 约10分钟

启用性能模式：

# 安装性能管理工具
sudo apt install -y cpufrequtils

# 设置性能模式
sudo cpufreq-set -g performance

# 验证设置
cpufreq-info | grep "current policy"

优化内存使用：

# 调整交换空间（如果内存小于4GB）
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 设置开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

配置自动更新：

# 安装无人值守升级工具
sudo apt install -y unattended-upgrades

# 启用自动更新
sudo dpkg-reconfigure -plow unattended-upgrades

常见坑点解决指南

启动问题

Q: 开发板通电后无任何显示
A: 检查以下几点：

1. 确认电源适配器规格是否满足5V 3A要求
2. 尝试更换HDMI线缆或显示器
3. 重新烧录SD卡，确保镜像文件完整

Q: 卡在启动logo界面
A: 可能是SD卡兼容性问题，尝试：

1. 使用推荐品牌的SD卡（如SanDisk、Kingston）
2. 格式化SD卡为FAT32格式后重新烧录
3. 尝试不同版本的系统镜像

网络连接

Q: 无法连接WiFi
A: 确保：

1. 使用支持的无线模块（项目支持列表见config/boards/）
2. 正确配置WiFi：

# 查看网络接口
ip link show

# 连接WiFi
nmcli device wifi connect "SSID" password "密码"

硬件兼容性

Q: 蓝牙无法使用
A: 部分蓝牙模块需要额外配置：

# 检查蓝牙服务状态
systemctl status bluetooth

# 重启蓝牙服务
sudo systemctl restart bluetooth

# 重新加载蓝牙驱动（针对特定模块）
sudo /usr/lib/scripts/ap6275p-bluetooth.sh

部署检查清单

检查项	状态	备注
硬件准备完成	□	SD卡、电源、显示器等
系统镜像下载/构建	□	确认匹配开发板型号
镜像成功烧录	□	验证烧录结果
首次启动配置完成	□	完成用户设置
网络连接正常	□	有线或无线连接
系统更新完成	□	sudo apt upgrade
性能优化应用	□	应用性能配置
基本功能测试	□	验证显示、声音、网络

通过以上步骤，您已成功在RK3588开发板上部署并优化了Ubuntu系统。这个平台不仅适合学习嵌入式开发，还可用于构建媒体中心、物联网网关和边缘计算设备等多种应用场景。如有进一步需求，可查阅项目中的高级配置文档。