Skip to content

Latest commit

 

History

History
176 lines (139 loc) · 7.03 KB

HowToMake.md

File metadata and controls

176 lines (139 loc) · 7.03 KB

编译指南

English | 简体中文

  • 需要注意，编译需要在sophon-stream目录下进行。

使用开发镜像编译

  • 原则上stream编译不强依赖docker镜像；
  • 如果您使用的主机部分环境不兼容，且不方便更改本机环境，可以使用我们提供的docker镜像进行编译；
  • 请注意，不要将下文的stream_dev镜像和用于模型编译的tpuc_dev镜像混用。

通过dfss下载：

pip3 install dfss
python3 -m dfss [email protected]:/sophon-stream/docker/stream_dev.tar

如果设备为bm1688/cv186ah，而且SDK版本大于等于1.9，则需要拉取如下镜像：

pip3 install dfss
python3 -m dfss [email protected]:/sophon-stream/docker/stream_dev_22.04.tar

如果是首次使用Docker, 可执行下述命令进行安装和配置(仅首次执行):

sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

在下载好的镜像目录中加载镜像

docker load -i stream_dev.tar

可以通过docker images查看加载好的镜像。需要注意镜像版本号，stream_dev_22.04镜像版本号为0.2。

创建容器

docker run --privileged --name stream_dev -v $PWD:/workspace  -it stream_dev:latest
# stream_dev只是举个名字的例子, 请指定成自己想要的容器的名字

容器中的workspace目录会挂载到您运行docker run时所在的宿主机目录，您可以在此容器中编译项目

x86/arm PCIe平台

mkdir build
cd build
cmake ..
make -j4

如果需要qt显示，请先下载公版qt，否则将默认不编译qt组件。

可以通过以下命令下载qt：

sudo apt install qtbase5-dev

如果需要在http_push插件中使用https，请先下载公版OpenSSL，否则将默认不支持https。

可以通过以下命令下载OpenSSL：

sudo apt install libssl-dev

SoC平台

通常在x86主机上交叉编译程序，您需要在x86主机上使用SOPHON SDK搭建交叉编译环境，将程序所依赖的头文件和库文件打包至sophon_sdk_soc目录中。您可以下载SOPHON SDK自行打包，也可以下载我们打包好的文件(根据您的SOC环境选择一个即可)。

下面的四个文件，分别对应官网BM1684/BM1684X SDK的v23.03.01、v23.05.01、v23.07.01、v23.10.01版本。

pip3 install dfss
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/soc0301.tar.gz
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/soc0501.tar.gz
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/soc0701.tar.gz
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/soc1001.tar.gz

下面三个文件，分别对应BM1688 SDK的1.7、1.8、1.9版本。

pip3 install dfss
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/1688_1.7.tar.gz
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/1688_1.8.tar.gz
python3 -m dfss [email protected]:/sophon-stream/soc-sdk/1688_1.9.tar.gz

如果需要使用qt，只需要在x86上下载用于交叉编译的Qt。盒子上环境已经是齐全的，不需要重新下载/安装Qt，并在编译时用QTPATH参数指定qt的路径：（如果不需要使用QT，可以忽略这部分，并且不添加交叉编译时的QTPATH参数）

BM1684/BM1684X设备：

python3 -m dfss [email protected]:sophon-demo/MultiYolov5/qt-5.14-amd64-aarch64-fl2000fb_v1.1.0.tar.xz

BM1688/CV186AH设备：

python3 -m dfss [email protected]:sophon-pipeline/a2_bringup/qtbase.zip

如果需要在http_push插件中使用https，只需要在x86上下载用于交叉编译的openssl，并在编译时使用OPENSSL_PATH参数指定openssl的路径：（如果不需要使用https，可以忽略这部分，并且不添加交叉编译时的OPENSSL_PATH参数）

python3 -m dfss --dflag=openssl_1.1.1f_aarch64

如果使用1.9及之后的SDK版本，需要使用如下命令下载较新的openssl。

python3 -m dfss [email protected]:sophon-stream/soc-sdk/openssl_3_aarch64.tar.gz

交叉编译时，SOPHON_SDK_SOC、QTPATH，OPENSSL_PATH需要填写绝对路径

mkdir build
cd build
cmake ../ -DTARGET_ARCH=soc -DSOPHON_SDK_SOC=/path/to/sophon_sdk_soc -DQTPATH=/path/to/qt -DOPENSSL_PATH=/path/to/openssl
make -j4

如果您需要的SDK版本上文未提供，需要自己打包soc-sdk，可以参考以下流程进行打包。需要注意的是，对于SE9设备，下列命令中的sophon-mw目录名或压缩包文件名应改为sophon-media。

  1. 解压SDK目录下，sophon-img包里的libsophon_soc_<x.y.z>_aarch64.tar.gz，将lib和include的所有内容分别拷贝到您的soc-sdk目录
cd sophon-img_<date>_<hash>
# 创建依赖文件的根目录
mkdir -p soc-sdk
# 解压sophon-img release包里的libsophon_soc_${x.y.z}_aarch64.tar.gz，其中x.y.z为版本号
tar -zxf libsophon_soc_<x.y.z>_aarch64.tar.gz
# 将相关的库目录和头文件目录拷贝到依赖文件根目录下
cp -rf libsophon_soc_<x.y.z>_aarch64/opt/sophon/libsophon-<x.y.z>/lib ${soc-sdk}
cp -rf libsophon_soc_<x.y.z>_aarch64/opt/sophon/libsophon-<x.y.z>/include ${soc-sdk}
  1. 解压sophon-mw包里的sophon-mw-soc_<x.y.z>_aarch64.tar.gz，将sophon-mw下lib和include的所有内容拷贝到您的soc-sdk目录。
cd sophon-mw_<date>_<hash>
# 解压sophon-mw包里的sophon-mw-soc_<x.y.z>_aarch64.tar.gz，其中x.y.z为版本号
tar -zxf sophon-mw-soc_<x.y.z>_aarch64.tar.gz
# 将ffmpeg和opencv的库目录和头文件目录拷贝到依赖文件根目录下
cp -rf sophon-mw-soc_<x.y.z>_aarch64/opt/sophon/sophon-ffmpeg_<x.y.z>/lib ${soc-sdk}
cp -rf sophon-mw-soc_<x.y.z>_aarch64/opt/sophon/sophon-ffmpeg_<x.y.z>/include ${soc-sdk}
cp -rf sophon-mw-soc_<x.y.z>_aarch64/opt/sophon/sophon-opencv_<x.y.z>/lib ${soc-sdk}
cp -rf sophon-mw-soc_<x.y.z>_aarch64/opt/sophon/sophon-opencv_<x.y.z>/include ${soc-sdk}

编译结果

1.framework和element会在build/lib中生成动态链接库

2.samples会在samples/build文件夹生成可执行文件

对于PCIe平台，可以直接在PCIe平台上运行测试；对于SoC平台，需将交叉编译生成的动态链接库和可执行文件拷贝到SoC平台中测试。

3.交叉编译完成后，将编译结果scp到盒子上时，需要保证目录结构不变。

可以使用如下命令直接将主机上的stream目录拷贝到盒子上：

scp -r ./sophon-stream linaro@<your ip>:<your path>

其中，盒子的ip和文件目录您可以根据实际情况进行设置。

4.登录目标盒子，添加环境变量，以确保运行sample中的程序时能找到动态链接库：

echo 'export LD_LIBRARY_PATH=<your path>/sophon-stream/build/lib/:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

其中，<your path>替换为目标盒子中sophon-stream的绝对路径。