泰山派开发之—Ubuntu24.04下Linux开发环境搭建

简介

最近翻到了吃灰已久的泰山派，是刚出来的时候用优惠券买的，当时价格挺便宜的，最近给它翻出来了，打算试试做个项目。买的泰山派容量是2G+16G，SOC芯片使用的是RK3566，搭载1TOP算力的NPU，并且具有丰富的接口，详细参数如下：

官方的参考文档如下：https://wiki.lckfb.com/zh-hans/tspi-rk3566/
由于官方给的是基于Ubuntu18.04的开发环境搭建步骤，然而Ubuntu目前稳定版已经出到了24.04，重新专门为它安装一个18.04版本的系统显然不合适。因此，在这里记录了一下基于Ubuntu24.04进行泰山派Linux开发环境搭建的步骤。

环境准备

• Ubuntu24.04
• 泰山派
• tspi_linux_sdk_repo_20240131.tar.gz
• buildroot_dl_4c7c9df616fb.tar.gz

python2安装

由于python2目前官方已经结束支持，Ubuntu24.04中已经不再默认安装python2了。然而泰山派的SDK编译依然要用到python2，因此我们这里首先进行python2的安装。

安装python2.7

首先运行如下命令，进行系统的更新。

sudo apt update && sudo apt upgrade

之后安装相关依赖

sudo apt install -y build-essential checkinstall libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev

然后我们下载python2的安装包，这里我选择的是2.7.18版本，也是python2的最后一个版本。
下载页面：https://www.python.org/downloads/release/python-2716/
下载链接：https://www.python.org/ftp/python/2.7.18/Python-2.7.18.tgz
下载完成后，我们对压缩包进行解压

tar -xvf Python-2.7.18.tgz

之后，我们进入解压后的目录，检查依赖项和编译器设置，使用configure命令生成 Makefile 文件，并且使用CFLAGS=-fPIC设置编译器生成位置无关的代码，否则可能会报错

cd Python-2.7.18
./configure --enable-optimizations CFLAGS=-fPIC

在完成上述准备后，我们就能够执行如下命令进行编译安装了

sudo make altinstall

其中altinstall可以保证不会覆盖系统默认的 python 命令，从而避免影响系统自带的python3。
最后，我们使用whereis命令，查看安装好的pyhon2.7的路径

whereis python2.7

可以看到我们的python2.7已经成功安装到了/usr/local目录下。
下面我们运行如下命令，进入到python环境中，测试python2.7是否能够正常使用

python2.7

可以看到我们的python2.7已经能够正常运行。

pip安装

目前我们仅仅是安装了python2.7本体，还有许多python的功能包需要使用pip工具进行安装。接下来我们就来安装python2.7的pip工具，运行命令如下：

sudo apt install curl
curl https://bootstrap.pypa.io/pip/2.7/get-pip.py -o get-pip.py
sudo python2.7 get-pip.py

安装完成后，我们运行如下命令进行测试

pip2.7 --version

添加python2软链接

虽然我们上面完成了python2.7的安装，但是系统默认依然还是python3。

我们还需要使用如下命令添加软连接，使得python3和python2分别对应不同版本的python

sudo ln -s /usr/local/bin/python2.7 python2

其中的/usr/local/bin/python2.7对应于你自己实际的python2.7安装路径

SDK编译

解压SDK

首先运行如下命令，解压下载的SDK压缩包

tar -xvzf tspi_linux_sdk_repo_20240131.tar.gz

之后运行如下命令，进行同步

.repo/repo/repo sync -l -j88

同步完成后，会出现如下successfully界面

dl库替代

由于buildroot编译时需要下载很多库，而如果网络不好的话，可能会出现buildroot的库下载失败报错的问题，因此我们使用了立创提供的已经下载好的库，直接进行替换即可。

首先将buildroot_dl_4c7c9df616fb.tar.gz复制到SDK目录中，并运行如下命令，解压buildroot_dl_4c7c9df616fb文件到buildroot/dl目录下

tar -xzf buildroot_dl_4c7c9df616fb.tar.gz

解压完成后，buildroot/dl目录下的部分文件展示如下：

编译准备

在完成上述步骤后，我们就能够进行编译环境的安装了。

安装环境依赖

首先运行如下命令，安装编译环境所需要的依赖。

sudo apt install -y git make openjdk-8-jdk git-core gnupg flex bison gperf build-essential zip curl zlib1g-dev libgl1-mesa-dev gcc-multilib g++-multilib libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libxml2-utils xsltproc unzip bc imagemagick ccache schedtool libssl-dev clang
sudo apt-get install whiptail ssh libssl-dev liblz4-tool expect patchelf chrpath gawk texinfo chrpath diffstat binfmt-support qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib unzip device-tree-compiler ncurses-dev

板级配置

运行如下命令进行泰山派SDK的板级配置，并在弹出来的选项卡中选择BoardConfig-rk3566-tspi-v10.mk

./build.sh lunch

编译buildroot系统

在完成以上准备后，我们就能够编译buildroot系统了。

由于buildroot中使用的python3.8.6，因此我们在编译时也必须使用python3.8环境才能正常进行，否则在编译时可能会报错

这里我们使用pyenv工具，安装python3.8.19并使其生效。

pyenv install 3.8.19
pyenv local 3.8.19  # 仅当前目录生效

之后需要设置环境变量RK_ROOTFS_SYSTEM为buildroot

export RK_ROOTFS_SYSTEM=buildroot

为避免编译buildroot时报错multiple definition of bwriter_buffer，可以将如下代码添加到buildroot/package/squashfs/0001-include-sysmacros.patch文件的末尾（未验证是否为必须步骤）

diff -ruN squashfs-3de1687d7432ea9b302c2db9521996f506c140a3/squashfs-tools/mksquashfs.h squashfs-3de1687d7432ea9b302c2db9521996f506c140a3-patch/squashfs-tools/mksquashfs.h
--- squashfs-3de1687d7432ea9b302c2db9521996f506c140a3/squashfs-tools/mksquashfs.h       2015-12-07 09:42:03.000000000 +0800
+++ squashfs-3de1687d7432ea9b302c2db9521996f506c140a3-patch/squashfs-tools/mksquashfs.h 2025-01-02 16:59:52.994326895 +0800
@@ -133,7 +133,7 @@
 #define BLOCK_OFFSET 2
 
 extern struct cache *reader_buffer, *fragment_buffer, *reserve_cache;
-struct cache *bwriter_buffer, *fwriter_buffer;
+extern struct cache *bwriter_buffer, *fwriter_buffer;
 extern struct queue *to_reader, *to_deflate, *to_writer, *from_writer,
        *to_frag, *locked_fragment, *to_process_frag;
 extern struct append_file **file_mapping;

最后运行如下命令，进行全编译。

./build.sh all

如果只编译（u-Boot，kernel，Rootfs，Recovery），则在编译完成以后还需要再执⾏./mkfirmware.sh 进⾏固件打包，与./build.sh updateimg生成镜像，否则rockdev目录下生成img镜像不是最新的。

电源配置

在首次进行编译时，会遇到电源配置选项。这里除了VCCIO4和VCCIO6选1.8V其他都选3V3。如果没有弹出电源选择框，则需要安装sudo apt install whiptail后再重新进行编译。

在Ubuntu24.04环境下，可能会在编译完kernel或buildroot后中断并且无报错信息，这时只需要重新执行build命令即可。
编译成功后的输出如下：

打包固件

之后运行如下命令进行固件打包

./mkfirmware.sh

运行如下命令查看固件，可以看到固件已经是最新的了。

ls ./rockdev -l

打包镜像

生成的固件是零散的，并且不便于下载，因此我们可以使用如下命令将打包好的固件生成一个update.img镜像，便于后续的镜像下载。

./build.sh updateimg

执行完毕后，就能够在rockdev生成update.img镜像文件了。

小结

至此，我们就完成了Ubuntu24.04环境下泰山派的SDK搭建。其中最值得注意的是在Ubuntu24.04环境下执行build命令可能会意外中断，如果未出现error报错，则无需执行clean操作，只需直接重新执行build命令即可。这样可以避免全量编译，从而大幅缩短构建时间，尤其是buildroot根文件系统的编译过程，因为它需要对所有功能包逐一编译，极为耗时。下一博客中，我们将介绍如何在linux下进行固件的烧录。