征程 6 基于 Linux 和 Node-Locked License 配置 DSP 开发环境

说明：该文档以征程 6上使用的Q8 DSP安装为例，同样的步骤在征程 5 上使用方法类似只是征程 6使用的DSP为VP6

地平线开发者

937人浏览 · 2025-03-14 12:52:07

地平线开发者 · 2025-03-14 12:52:07 发布

说明：该文档以征程 6上使用的Q8 DSP安装为例，同样的步骤在征程 5 上使用方法类似只是征程 6使用的DSP为VP6

1.获取所需文件

在配置征程 6的DSP开发环境前，您需要获取以下文件：

标准工具链发布包部分（请联系地平线项目对接人获取）

OpenExplorer算法工具链Docker镜像
OpenExplorer算法工具链交付包（OE包中提供了大量示例，包括DSP示例）
OpenExplorer算法工具链中文文档

DSP开发包特有部分（请联系地平线项目对接人获取）

DSP开发软件安装程序Xplorer-10.1.11-linux-x64-installer-with-RI-2023.11.bin
DSP开发软件配置文件Vision_Q8_linux_redist2311.tgz
DSP开发软件License（即Node-Locked License）

注意：算法工具链Docker镜像有两种分别是CPU版本的和GPU版本的, 如果您只关注DSP开发，可以使用体积更小、安装更简单的CPU Docker。

2.启动安装环境(Docker)

我们推荐在工具链提供的DOCKER中进行DSP开发环境部署，因此，开始部署之前用户需要先加载docker镜像并启动容器（docker镜像加载和启动部分可以参考工具链的环境说明，这里聚焦DSP使用，不再赘述）。需要注意DSP的License是与网卡的物理地址一一对应的，启动docker时需要再选项中增加–mac-address，来手动设置容器内网卡的MAC地址，启动命令示例如下（–mac-address的内容必须与申请Licence时提供的mac地址完全一致）：

# 手动启动 CPU Docker 镜像
docker run -it --rm 
  --network host \ # 调整网络模式为host
  -v {OE 包路径}:/open_explorer \ # 挂载 OE 包
  -v ./dataset:/data/horizon_j6/data \ # 挂载数据集
  --name j6_dsp_env \
  --mac-address 24:8a:07:71:06:90 \
  openexplorer/ai_toolchain_ubuntu_22_j6_cpu:{version}

容器启动后可以使用 ifconfig 命令查看 mac-address，检查是否与容器启动时提供的MAC一致。

3.DSP开发软件安装

请按照工具链用户手册中DSP开发文档的步骤完成以下两个文件的安装，参考如下：

注意：请先进入Docker环境再执行以下步骤，否则会导致安装失败（本地手动安装可忽略此提示）。

3.1 安装 Xtensa Develop Tools

这里我们默认将 Xtensa Develop Tools 安装在 /opt/xtensa 目录下，您也可以自行指定其他目录。若安装在 /opt/xtensa 目录则需要root权限。执行如下命令：

chmod 777 Xplorer-10.1.11-linux-x64-installer.bin
./Xplorer-10.1.11-linux-x64-installer.bin \
   --mode unattended \
   --prefix /opt/xtensa

3.2 安装 Vision Q8 Core Configuration

将 Vision_Q8_linux.tgz 安装包解压，解压后将其放在 Xtensa Develop Tools 安装目录下指定位置（如：/opt/xtensa/XtDevTools/install/builds/RI-2023.11-linux/ ），放到指定位置后进行安装。安装需要执行如下命令：

tar -zxvf vdsp_builds/Vision_Q8_linux.tgz \
   && mv RI-2023.11-linux/Vision_Q8/ /opt/xtensa/XtDevTools/install/builds/RI-2023.11-linux/ \
   && rm -rf RI-2023.11-linux

 /opt/xtensa/XtDevTools/install/builds/RI-2023.11-linux/Vision_Q8/install \
   --xtensa-tools /opt/xtensa/XtDevTools/install/tools/RI-2023.11-linux/XtensaTools/

4.License配置

DSP开发软件Xtensa Xplorer可以使用的License有两种，一种是Floating License（服务器），另一种是Node-Locked License（license文件），配置其一即可。地平线通过邮件释放给开发者的通常都是Node-Locked License, 本质为txt文件，内容参考如下(HOSTID即为网卡mac地址)：

INCREMENT XT_ISS_BASE_EDC90FD4 xtensad 14.0 17-jul-2025 uncounted \
        83B9777424EF HOSTID=d8bb……e141 SN=horizon_vq8_fusa_694594 \
        TS_OK SIGN="021E 223A 7A4D 47EE 3065 69F8 25D5 CE93 9E2A 4EDE \
        BE02 D933 FE04 …… CB5F 2827 E0E6"
INCREMENT XT_XCC_FUSA_EDC90FD4 xtensad 14.0 17-jul-2025 uncounted \
        FBA437B07B64 HOSTID=d8bb……e141 SN=horizon_vq8_fusa_694594 \
        TS_OK SIGN="0233 C6EE 9AFB 7C5A 9CAB 73C9 9442 72B5 24E1 35F7 \
        CC03 0425 8E1F …… F9CE F702 C17B C9A9"
INCREMENT XT_XPLORER_SE xtensad 14.0 17-jul-2025 uncounted \
        88DF41A5D73B HOSTID=d8bb……e141 SN=horizon_vq8_fusa_694594 \
        TS_OK SIGN="0222 5119 …… 6956 92FC F985 1C82 \
        9B00 7797 AE62 …… A39E 54B2 8084 D695 12A6"

注：出于安全和隐私考虑，上述内容隐去了真实数据，仅为形式参考。

另外：如果文件中有 SERVER 行和 VENDOR 行，则需要删除，只保留 3 个 feature 对应的 INCREMENT 行即可。修改完成后将其改名为 license.dat，并存放在 Docker 可访问路径下，比如： /open_explorer/dsp_license/license.dat

5.环境变量设置

# set license
export XTENSAD_LICENSE_FILE=/open_explorer/dsp_license/license.dat
# set default core
export XTENSA_CORE=Vision_Q8
export XTENSA_ROOT=/opt/xtensa/XtDevTools/install/tools/RI-2023.11-linux/XtensaTools/
export PATH=$PATH:$XTENSA_ROOT/bin

6.验证环境

完成上述步骤后，执行以下两条命令，如果均可以正常执行，表明DSP开发环境配置成功。

xt-clang --help  
xt-run   --help

7.后续开发流程

配置好开发环境后就可以正式开始DSP的程序开发了，OE包中的DSP示例位于samples\ucp_tutorial\custom_operator\dsp_sample中，同时工具链用户手册中的DSP开发文档、DSP开发流程、DSP API**手册、DSP示例包使用说明会提供详细的指导。

附：以下脚本可用于快速安装和配置DSP开发环境

install.sh#!/bin/bashset -eSCRIPTS_DIR=$(cd $(dirname $0); pwd)GREEN='\033[1;32m'BLUE='\033[1;34m'CYAN='\033[1;36m'NC='\033[0m' No Colorecho -e ${BLUE}"Start install vdsp envirement..."${NC}echo -e "Step-1: ${CYAN}安装Xtensa Develop Tools${NC}"这里我们默认把它安装在/opt/xtensa目录下（没有root权限可以通过--prefix自行指定其它目录，后续需要将/opt/xtensa替换为该目录）XPLORER_BIN=Xplorer-10.1.11-linux-x64-installer-with-RI-2023.11.bin
chmod 777 ${XPLORER_BIN}
./${XPLORER_BIN} --mode unattended --prefix /opt/xtensa

echo -e "Step-2:${CYAN}安装 Xtensa Tools${NC}"XTENSA_TOOLS=echo -e "Step-3:${CYAN}安装 VQ8 Core Configuration${NC}"CORE_CONFIGURATION=Vision_Q8_linux_redist2311.tgz
tar -zxvf ${CORE_CONFIGURATION} \&& mv RI-2023.11-linux/Vision_Q8/ /opt/xtensa/XtDevTools/install/builds/RI-2023.11-linux/ \&& rm -rf RI-2023.11-linux
/opt/xtensa/XtDevTools/install/builds/RI-2023.11-linux/Vision_Q8/install \
   --xtensa-tools /opt/xtensa/XtDevTools/install/tools/RI-2023.11-linux/XtensaTools/

echo -e "Step-4: ${CYAN}配置环境变量${NC}"echo "export XTENSA_CORE=Vision_Q8 # set default core" >> ~/.bashrc 
#echo "export LM_LICENSE_FILE=5280@10.9.9.21:5280@10.9.9.22:5280@10.9.9.23:5280@10.9.9.24:5280@10.9.9.25  # set license server " >> ~/.bashrcecho "export XTENSAD_LICENSE_FILE=/data/common/dsp/license/license.dat  # set license " >> ~/.bashrc
echo "export XTENSA_ROOT=/opt/xtensa/XtDevTools/install/tools/RI-2023.11-linux/XtensaTools" >> ~/.bashrc
echo "export PATH=\$PATH:\$XTENSA_ROOT/bin" >> ~/.bashrc
source ~/.bashrc

echo -e "vdsp is ${GREEN}successfully${NC} installed in ${XTENSA_ROOT}"