RK3588的硬解码实现指南

目录

一、RK3588的硬解码整体流程概览

二、详细步骤与方法

2.1、准备交叉编译环境，在x86开发主机上进行

2.2 交叉编译C++程序

2.3 部署到RK3588开发板

三、总结

一、RK3588的硬解码整体流程概览

准备阶段：在开发主机上配置交叉编译环境。

编译阶段：使用交叉编译工具链编译你的C++程序及其所有依赖库。

部署阶段：将编译好的可执行文件和库文件传输到RK3588目标板上。

运行阶段：在目标板上设置运行时环境并执行程序

二、详细步骤与方法

2.1、准备交叉编译环境，在x86开发主机上进行

        Buildroot系统在编译时已经生成了一套完整的交叉编译工具链。这是最关键的一步。

找到你的工具链：

        在Buildroot的output目录下，host子目录包含了用于你主机（host）的工具链。

# 进入你的Buildroot输出目录
cd /path/to/your/buildroot-2024.02/output/
 
# 重要的路径：
# 工具链所在目录: ./host/bin/
# 系统根目录（sysroot）: ./staging/  （包含所有库的头文件和.so文件）
 
# 将工具链路径加入到PATH环境变量中，方便使用
export PATH=/path/to/your/buildroot-2024.02/output/host/bin:$PATH

        工具链的名称通常是这样的： aarch64-buildroot-linux-gnu-gcc (C编译器) 和  aarch64-buildroot-linux-gnu-g++ (C++编译器)。我们可以用：

   ls ./host/bin/aarch64-buildroot-linux-gnu-*命令查看所有可用的工具。

   配置环境变量：
        为了简化编译命令，我们设置一些环境变量。

export CC=aarch64-buildroot-linux-gnu-gcc
export CXX=aarch64-buildroot-linux-gnu-g++
export SYSROOT=/path/to/your/buildroot-2024.02/output/staging
# PKG_CONFIG_PATH 非常重要，它让pkg-config能够找到目标板的库信息，而不是主机的库
export PKG_CONFIG_SYSROOT_DIR=$SYSROOT
export PKG_CONFIG_PATH=$SYSROOT/usr/lib/pkgconfig:$SYSROOT/usr/share/pkgconfig

2.2 交叉编译C++程序

        假设你的硬解码程序源码目录结构如下：

使用CMake交叉编译（推荐）：

1）创建一个工具链文件（toolchain.cmake），这是告诉CMake使用交叉编译器的标准方式。

# toolchain.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)
 
# 指定交叉编译器
set(CMAKE_C_COMPILER aarch64-buildroot-linux-gnu-gcc)
set(CMAKE_CXX_COMPILER aarch64-buildroot-linux-gnu-g++)
 
# 指定sysroot
set(CMAKE_SYSROOT ${SYSROOT})
set(CMAKE_FIND_ROOT_PATH ${SYSROOT})
 
# 在sysroot中搜索库和头文件，不在主机中搜索
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

2）使用CMake进行编译：

cd my_decoder_project
mkdir build && cd build
# 使用工具链文件进行配置
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain.cmake ..
# 编译
make -j$(nproc)

        编译成功后，你会在 build/目录下得到一个名为 my_decoder（或其他你设定的名字）的可执行文件。使用 file命令检查它：

file my_decoder
# 输出应为：my_decoder: ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), ... 
# 这确认了它是ARM64架构的程序。

如果你的程序使用Makefile：
你需要修改Makefile中的编译器变量。

# 在你的Makefile中修改这些行
CC  = aarch64-buildroot-linux-gnu-gcc
CXX = aarch64-buildroot-linux-gnu-g++
CFLAGS  += --sysroot=$(SYSROOT)
CXXFLAGS += --sysroot=$(SYSROOT)
LDFLAGS += --sysroot=$(SYSROOT)

2.3 部署到RK3588开发板

    将编译好的程序和相关库文件复制到开发板上。最常用的方法是scp（基于SSH）。

    1). 确保开发板网络畅通：确保你的RK3588板子已经通过以太网或Wi-Fi连接到了网络，并且你知道它的IP地址（例如192.168.1.100）。

    2). 确保开发板开启了SSH服务：你的Buildroot系统需要包含openssh包。

    3). 使用scp传输文件：

# 在开发主机上执行
scp ./build/my_decoder root@192.168.1.100:/usr/bin/
# 输入root密码（就是你之前在Buildroot里设置的那个）

        如果程序依赖一些在开发板上没有的特定版本的库（例如你自己编译的FFmpeg），你需要把这些库（ .so文件）也拷贝到板子上对应的路径，通常是 /usr/lib或 /lib。

查找依赖库：

# 在开发主机上，使用工具链中的readelf查看程序依赖哪些库
aarch64-buildroot-linux-gnu-readelf -d my_decoder | grep "NEEDED"
# 使用工具链中的objdump也可以
aarch64-buildroot-linux-gnu-objdump -p my_decoder | grep "NEEDED"

1. 然后去$SYSROOT/lib或$SYSROOT/usr/lib目录下找到这些.so文件，用scp将它们传输到板子的/lib或/usr/lib目录下。

更专业的方法：制作ipk包

        对于正式产品，推荐使用Buildroot的目标包机制将你的程序制作成一个.ipk软件包，然后使用opkg install命令在板子上安装。这可以自动处理依赖关系，属于更高级的部署方式。

2.4、在RK3588上运行程序

1).通过SSH登陆开发板

ssh root@192.168.1.100

2) 直接运行

# 如果程序已经在PATH中（如/usr/bin）
my_decoder /path/to/your/test.h264

或者

# 直接指定路径
/usr/bin/my_decoder /path/to/your/test.h264

3) 处理权限问题（如果需要）：确保你的程序有执行权限。

chmod +x /usr/bin/my_decoder

处理动态链接库问题：如果运行时提示找不到.so库，需要检查LD_LIBRARY_PATH环境变量。

# 可以临时添加库路径
export LD_LIBRARY_PATH=/your/custom/lib/path:$LD_LIBRARY_PATH
./my_decoder

        永久解决方案：将库文件放在系统默认的搜索路径（/lib, /usr/lib）下，或者创建一个.conf文件到/etc/ld.so.conf.d/目录，然后运行ldconfig命令更新缓存。

三、总结

        这个过程是嵌入式Linux开发的精髓：在强大的x86主机上为资源受限的ARM目标板进行开发。

        通过这个流程，你就可以高效地在RK3588上开发、测试和部署任何复杂的C/C++应用程序了。