Edge Impulse - Qualcomm Dragonwing Documentation

Edge Impulse 是为 Qualcomm Dragonwing 设备构建新的边缘 AI 模型的最简单方式。它是一个端到端平台，可帮助您构建数据集、训练模型，并在完全硬件加速下运行模型。它支持使用音频、图像和其他传感器数据构建 AI 模型，或以多种格式自带模型。

训练 AI 模型

要开始使用 Edge Impulse 进行构建：

按照您开发板的设备设置进行操作

请确保您已按照开发板的设备设置完成操作。

注册免费的开发者账户

在 studio.edgeimpulse.com 注册一个免费的开发者账户。

从 Nodesource PPA 安装 Node.js 22

在开发板的终端或 ssh 会话中：

# Remove existing installation (if needed)
rm -f /usr/local/bin/node /usr/local/bin/npm

# Install Node.js v22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Verify installation (might need to open a new terminal window)
node -v
# ... Should return v22.x.x

# Make a place to install global packages w/o needing sudo
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# Add to your PATH
echo "" >> ~/.bash_profile
echo "# Begin node.js/npm" >> ~/.bash_profile
echo "export PATH=\$PATH:$HOME/.npm-global/bin" >> ~/.bash_profile
echo "# End node.js/npm" >> ~/.bash_profile
echo "" >> ~/.bash_profile

# To ensure you have access to the global packages from the current session
source ~/.bash_profile

如果您在非交互式 SSH 命令或不加载 ~/.bash_profile 的 shell 中运行这些命令，请同时在当前 shell 中导出路径：export PATH="$PATH:$HOME/.npm-global/bin"。

安装 Linux 版 Edge Impulse 并连接您的开发板

# Install the CLI
npm install -g edge-impulse-linux

# Install QNN library for Hexagon NPU acceleration
sudo apt install -y libqnn-dev

# Connect to your project (to switch projects, add --clean)
edge-impulse-linux

连接到 Edge Impulse 的 Qualcomm Dragonwing 开发板

按照端到端教程构建您的第一个 AI 模型

按照端到端教程之一构建您的第一个 AI 模型。

**提示：**使用右上角的目标选择器选择您的 Qualcomm Dragonwing 开发板，以获得准确的性能信息。要运行您的模型，请在开发板的终端或 ssh 会话中：

edge-impulse-linux-runner

这会自动构建并下载您的模型，并在 NPU 上运行（仅限量化模型）。或者，要手动下载 EIM 文件，请在 Edge Impulse 项目的 Deployment 页面中搜索 “Linux (AARCH64 with Qualcomm QNN)“。

在 Qualcomm Dragonwing 开发板 NPU 上运行的对象跟踪模型

自带模型

Edge Impulse 还允许您以 SavedModel、ONNX、TFLite、LiteRT 或 scikit-learn 格式自带模型 (BYOM)。通过 BYOM 部署的模型在 Dragonwing 平台上得到全面支持，并提供 NPU 加速（针对量化模型）。请参阅 Edge Impulse 文档 > Bring Your Own Model。

构建在 NPU 上运行的 C++ 应用程序

要使用 Edge Impulse 模型构建在 Dragonwing 开发板 NPU 上运行的 C++ 应用程序，请先安装 AI Runtime SDK - Community Edition，方法是在开发板上打开终端并运行：

# Install the SDK
wget -qO- https://cdn.edgeimpulse.com/qc-ai-docs/device-setup/install_ai_runtime_sdk.sh | bash

# Use the SDK in your current session
source ~/.bash_profile

之后，只需按照 edgeimpulse/example-standalone-inferencing-linux 中 “Qualcomm SoCs with Hexagon NPU” 部分下的步骤操作即可——但请跳过 AI Engine Direct SDK 的手动安装。该 SDK 已经配置好了。

提示

查看 NPU 性能

Dragonwing 平台配备强大的 NPU（神经处理单元），可显著加速 AI 推理。要查看 NPU 对性能的影响，可以通过以下方式在 CPU 上运行模型：

edge-impulse-linux-runner --force-target runner-linux-aarch64

例如，在 RB3 Gen 2 Vision Kit 上，一个基于 YOLO 的量化示例模型（700 万参数）在 CPU 上每次推理需要 47ms，而在 NPU 上仅需 2ms（！）。

故障排除

错误：EACCES: permission denied, mkdir ‘/usr/lib/node_modules/edge-impulse-linux’

默认情况下，npm install -g edge-impulse-linux 会尝试写入 /usr/lib/node_modules，这在 Ubuntu 上需要 sudo 权限。最简单的解决方法是为全局软件包创建一个新文件夹，并通过以下命令将其添加到您的 PATH：

# Make a place to install global packages w/o needing sudo
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# Add to your PATH
echo "" >> ~/.bash_profile
echo "# Begin node.js/npm" >> ~/.bash_profile
echo "export PATH=\$PATH:$HOME/.npm-global/bin" >> ~/.bash_profile
echo "# End node.js/npm" >> ~/.bash_profile
echo "" >> ~/.bash_profile

# To ensure you have access to the global packages from the current session
source ~/.bash_profile

# Re-install Edge Impulse for Linux
npm install -g edge-impulse-linux

​训练 AI 模型

​自带模型

​构建在 NPU 上运行的 C++ 应用程序

​提示

​查看 NPU 性能

​故障排除

​错误：EACCES: permission denied, mkdir ‘/usr/lib/node_modules/edge-impulse-linux’

训练 AI 模型

自带模型

构建在 NPU 上运行的 C++ 应用程序

提示

查看 NPU 性能

故障排除

错误：EACCES: permission denied, mkdir ‘/usr/lib/node_modules/edge-impulse-linux’