3、开发环境搭建：交叉编译工具链、系统镜像烧录、SSH连接、基础开发工具与依赖库安装

RK3588作为一款高性能八核应用处理器，其开发环境搭建与传统的x86_64服务器或桌面开发有显著差异。开发者通常需要在性能强劲的x86_64主机上进行代码编写与交叉编译，生成ARM64架构的可执行文件后，再通过烧录或网络传输部署到目标板卡上运行。本章将系统讲解从零搭建RK3588开发环境的完整链路，涵盖交叉编译工具链的配置、系统镜像的烧录方法、SSH远程连接的建立，以及基础开发工具与依赖库的安装策略，帮助开发者建立起一套高效、可复现的嵌入式开发工作流。

3.1 交叉编译工具链：核心原理与配置方法

3.1.1 为什么需要交叉编译

RK3588搭载的是ARM Cortex-A76/A55大小核架构，其指令集为ARMv8.2-A（64位）。而大多数开发者的PC主机基于x86_64架构。由于两种架构的机器码不兼容，直接在x86主机上编译得到的二进制文件无法在RK3588上运行。交叉编译（Cross Compilation）即在x86_64主机上安装针对ARM64架构的编译器，生成目标平台可执行的代码。对于RK3588，官方推荐的工具链为aarch64-linux-gnu-系列，GCC版本通常为11.3或12.2，对应glibc版本需与目标系统rootfs匹配。

3.1.2 工具链安装与验证

在Ubuntu 22.04主机上，可通过apt直接安装或使用Rockchip SDK自带的工具链。推荐使用apt安装标准工具链，便于版本管理：

# 更新软件源
sudo apt update
# 安装交叉编译工具链及基础依赖
sudo apt install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
# 验证安装
aarch64-linux-gnu-gcc --version
# 输出示例：aarch64-linux-gnu-gcc (Ubuntu 11.3.0-1ubuntu1~22.04) 11.3.0

安装完成后，编写一个简单的测试程序验证编译链路是否正常：

# 创建测试文件
echo '#include <stdio.h>
int main() { printf("RK3588 Cross Compile OK\n"); return 0; }' > test.c
# 交叉编译
aarch64-linux-gnu-gcc test.c -o test_arm64
# 查看文件类型
file test_arm64
# 输出：test_arm64: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked

3.2 系统镜像烧录：从Loader模式到分区写入

3.2.1 烧录原理与准备工作

RK3588的烧录过程基于Rockchip的Loader机制。目标板进入Loader模式（或MaskROM模式）后，主机通过USB连接，使用官方工具RKDevTool（Windows）或upgrade_tool（Linux）将镜像写入eMMC或SD卡。烧录前需准备以下文件：uboot.img、boot.img、rootfs.img、misc.img以及分区表文件parameter.txt。这些文件通常由SDK编译产出，或从官方固件包中提取。

3.2.2 Linux环境下的烧录流程

在Linux主机上，推荐使用upgrade_tool命令行工具，便于脚本化集成：

# 安装依赖
sudo apt install -y libusb-1.0-0-dev
# 下载并解压upgrade_tool（以v1.5为例）
wget https://dl.radxa.com/rock5/tools/linux/upgrade_tool_v1.5.zip
unzip upgrade_tool_v1.5.zip -d upgrade_tool
cd upgrade_tool
# 进入Loader模式：按住MaskKey按键，同时上电，或使用命令
sudo ./upgrade_tool LD
# 烧录整个镜像包（update.img包含所有分区）
sudo ./upgrade_tool UF update.img
# 或单独烧录某个分区
sudo ./upgrade_tool DI -b boot.img
sudo ./upgrade_tool DI -r rootfs.img

3.3 SSH连接与远程开发环境配置

3.3.1 网络配置与SSH服务启用

系统烧录完成后，目标板首次启动需配置网络。推荐使用串口终端（如minicom或PuTTY）登录，执行nmtui或编辑/etc/network/interfaces配置静态IP。确保目标板与主机处于同一局域网后，启用SSH服务：

# 在目标板上执行
sudo systemctl enable ssh
sudo systemctl start ssh
# 查看IP地址
ip addr show eth0

3.3.2 SSH密钥认证与免密登录

为提高开发效率，建议配置SSH密钥认证，避免每次输入密码：

# 在主机上生成密钥（若已有可跳过）
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa
# 复制公钥到目标板
ssh-copy-id user@192.168.1.100
# 测试免密登录
ssh user@192.168.1.100

对于文件传输，可使用scp或rsync同步编译产物：

# 将交叉编译的可执行文件传输到目标板
scp test_arm64 user@192.168.1.100:/home/user/
# 使用rsync同步整个目录（增量传输）
rsync -avz --progress ./build/ user@192.168.1.100:/home/user/app/

3.4 基础开发工具与依赖库安装

3.4.1 目标板基础工具链

RK3588的rootfs通常基于Ubuntu或Debian，安装基础开发工具需使用ARM64架构的软件源。首次登录后，建议执行以下操作：

# 更新软件源（使用国内镜像加速）
sudo sed -i 's/ports.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo apt update
# 安装基础开发工具
sudo apt install -y build-essential cmake git vim htop \
    python3 python3-pip python3-venv \
    net-tools network-manager \
    gdb valgrind strace

3.4.2 多媒体与AI依赖库

针对本课程的多路视频与NPU推理场景，需安装以下关键依赖库：

• OpenCV（带GStreamer支持）：用于视频采集与图像预处理，需编译安装以启用硬件编解码。
• FFmpeg：提供多路视频流的解码、转码能力，需开启RKMPP硬件加速。
• RKNN Runtime：Rockchip官方NPU推理运行时，提供C/C++和Python API。
• GStreamer插件：用于构建视频流水线，支持RTSP推拉流。

# 安装OpenCV依赖
sudo apt install -y libopencv-dev python3-opencv
# 安装FFmpeg
sudo apt install -y ffmpeg libavcodec-dev libavformat-dev libavutil-dev
# 安装RKNN Runtime（以rknn-toolkit2 v1.6为例）
pip3 install rknn-toolkit2-1.6.0-cp38-cp38-linux_aarch64.whl

3.5 常见误区与工程化建议

工程化建议：将交叉编译工具链、SDK路径、目标板IP等环境变量写入~/.bashrc或项目级.env文件；使用Makefile或CMake管理编译流程；建立自动化烧录脚本，集成单元测试与冒烟测试，确保每次镜像变更可追溯。