> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edge Impulse

> 使用 Edge Impulse 平台在 Dragonwing 设备上构建和部署边缘 AI 模型，并获得完整的 NPU 加速。

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

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/edgeimpulse0.png" />
</Frame>

## 训练 AI 模型

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

<Steps>
  <Step title="按照您开发板的设备设置进行操作">
    请确保您已按照开发板的设备设置完成操作。
  </Step>

  <Step title="注册免费的开发者账户">
    在 [studio.edgeimpulse.com](https://studio.edgeimpulse.com) 注册一个免费的开发者账户。
  </Step>

  <Step title="从 Nodesource PPA 安装 Node.js 22">
    在开发板的终端或 ssh 会话中：

    ```shell theme={null}
    # 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
    ```

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

  <Step title="安装 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
    ```

    <Frame caption="连接到 Edge Impulse 的 Qualcomm Dragonwing 开发板">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/edgeimpulse1.png" />
    </Frame>
  </Step>

  <Step title="按照端到端教程构建您的第一个 AI 模型">
    按照 [端到端教程](https://docs.edgeimpulse.com/tutorials)之一构建您的第一个 AI 模型。
  </Step>
</Steps>

\*\*提示：\*\*使用右上角的目标选择器选择您的 Qualcomm Dragonwing 开发板，以获得准确的性能信息。

要运行您的模型，请在开发板的终端或 ssh 会话中：

```
edge-impulse-linux-runner
```

这会自动构建并下载您的模型，并在 NPU 上运行（仅限量化模型）。

或者，要手动下载 EIM 文件，请在 Edge Impulse 项目的 **Deployment** 页面中搜索 "Linux (AARCH64 with Qualcomm QNN)"。

<Frame caption="在 Qualcomm Dragonwing 开发板 NPU 上运行的对象跟踪模型">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-prod/zh/AI-Developer-Workflow-Ubuntu/_images/edgeimpulse2.png" />
</Frame>

## 自带模型

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

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

要使用 Edge Impulse 模型构建在 Dragonwing 开发板 NPU 上运行的 C++ 应用程序，请先安装 [AI Runtime SDK - Community Edition](https://softwarecenter.qualcomm.com/catalog/item/Qualcomm_AI_Runtime_Community)，方法是在开发板上打开终端并运行：

```
# 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](https://github.com/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：

```shell theme={null}
# 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
```