说明：该文档以征程 6 上使用的 Q8 DSP 安装为例，同样的步骤在征程 5 上使用方法类似只是征程 6 使用的 DSP 为 VP6
1.获取所需文件
在配置征程 6 的 DSP 开发环境前，您需要获取以下文件：
OpenExplorer 算法工具链 Docker 镜像
OpenExplorer 算法工具链交付包（OE 包中提供了大量示例，包括 DSP 示例）
OpenExplorer 算法工具链中文文档
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 licenseexport XTENSAD_LICENSE_FILE=/open_explorer/dsp_license/license.dat# set default coreexport XTENSA_CORE=Vision_Q8export 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.binchmod 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.tgztar -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 " >> ~/.bashrcecho "export XTENSA_ROOT=/opt/xtensa/XtDevTools/install/tools/RI-2023.11-linux/XtensaTools" >> ~/.bashrcecho "export PATH=\$PATH:\$XTENSA_ROOT/bin" >> ~/.bashrcsource ~/.bashrc
echo -e "vdsp is ${GREEN}successfully${NC} installed in ${XTENSA_ROOT}"
复制代码
评论