移远 QuecPi Alpha 使用说明

QuecPi Alpha 原厂支持文档：https://developer.quectel.com/doc/quecpi/QuecPi-Alpha/zh/resource-description/hardware-src.html

1. 快速开始

1.1 环境准备

1.1.1 硬件准备

• 装有 Windows 10 以上的电脑
• QuecPi Alpha
• USB Type-A to Type-C 数据线（随板卡附赠）
• USB Type-A to Type-C 电源线（随板卡附赠，Type-A口可接入普通手机充电器接头）

1.1.2 软件准备

请参见工具安装章节，安装必要的工具以辅助开发者完成硬件产品的使用。

2. AidLux Docker使用

为了能快速与其他厂商板卡结合，阿加犀推出了AidLux 自定义docker方案，为开发者提供AI工具链。如下是Docker以及AI工具链的使用方法简介。

2.1 AidLux Docker使用方法

当开发者拿到设备并开箱后，根据快速开始章节中做好软硬件准备。按照如下步骤开机：

• 1、电源线接入板子POWER IN口。
• 2、数据线的Type-A口接入Windows电脑，Type-C口接入板子Type-C口。
• 3、在Windows电脑端，按Win+R，输入：cmd ,打开Terminal窗口。并输入如下命令检查设备是否被识别。

adb devices

• 4、设备识别到后，输入如下命令，通过adb进入到宿主机系统中。

adb shell

• 5、设备在发货前已预装了AidLux Docker，可使用如下命令查看。

docker images  # 查看image
docker ps -a   # 查看容器

• 6、通过命令进入到容器中：

docker exec -it aidlux bash

2.2 通过Web访问Aidlux Docker

除了通过adb登录系统后再通过docker命令进入到容器的方法之外，阿加犀还为AidLux Docker开发了一款Web Desktop，访问方法如下：

• 1、板卡接入网线，并获取到IP地址。可通过adb shell登录到系统查看IP地址。

adb shell        # 通过adb登录到宿主机系统
ifconfig eth0    # 查看IP地址

• 2、打开浏览器，输入url：http://192.168.111.21:8000/ ，其中 192.168.111.21 应替换为实际的IP地址。

登录密码：aidlux

登录后，可点击下排第一个按钮打开终端，可用于命令行操作。

💡注意

在终端操作中，部分命令需要使用 sudo 命令提升权限，其密码为：aidlux

2.3 文件传输

2.3.1 使用SCP文件传输

SCP传输需要板卡正常联网， 在终端可输入命令查看IP地址：

ifconfig

• 在PC终端中使用下面命令，上传文件test.txt到 /home/aidlux/目录。

scp -r  .\test.txt aidlux@192.168.111.21:/home/aidlux/

• 在 PC 终端中使用下面命令，下载文件到 PC 当前目录。

scp -r aidlux@192.168.111.21:/home/aidlux/test.txt ./

2.3.2 使用AidLux文件浏览器传输文件

使用AidLux文件浏览器传输需要板卡正常联网，若开发板的IP为192.168.110.194，如下步骤进行文件传输：

• 在浏览器中输入url: http://192.168.110.194:8000/ 登录到AidLux桌面环境，密码：aidlux。登录后可点击文件浏览器图标进入。

• 点击右上角上传按钮，传入文件或目录到/home/aidlux/目录下。

• 点击右上角下载按钮，将/home/aidlux/目录下的文件或目录下载到本地。

3. 机器人套件使用

3.1 机器人套件安装

请参见机器人软件安装指南章节进行安装相关软件。

3.2 Ubuntu Desktop访问指南

在使用机器人相关仿真软件时，阿加犀也为开发者提供了一套稳定的Ubuntu Desktop桌面系统。使用方法如下：

• 1、参照2.2 通过Web访问Aidlux Docker章节访问web桌面。

• 2、点击右下角Ubuntu Desktop按钮，启动该服务。

• 3、在Windows电脑上打开VNC连接工具，通过远程登录到Ubuntu Desktop 访问IP：板卡IP 访问端口：5902 访问密码：aidlux

4. AI工具链使用

阿加犀构建了一套完备的边缘端AI开发工具套件帮助开发者加速AI应用落地，其涵盖了底层系统到上层应用级SDK。 详见开发者指南

8.1 Aidlite SDK使用示例

8.1.1 SDK&API文档

AidLite SDK

8.1.2 aidlite_qnn

Python

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_qnn231/python

#运行测试工程脚本：
sudo python3 qnn_yolov5_multi.py 3

# 注意：1、sudo需要输入密码：aidlux 2、当前示例仅调用DSP

C++

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_qnn231/cpp

# 编译可执行程序：
sudo mkdir build && cd build
sudo cmake ..
sudo make

# 运行测试工程脚本：
sudo ./qnn_yolov5_multi 3
# 注意：1、sudo需要输入密码：aidlux 2、当前示例仅调用DSP

8.1.3 aidlite_snpe

Python

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_snpe229/python

# 运行测试工程脚本：sudo python3 snpe2_yolov5_multi.py 3

# 注意：1、sudo需要输入密码：aidlux 2、当前示例仅调用DSP

C++

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_snpe229/cpp

# 编译可执行程序：
sudo mkdir build && cd build
sudo cmake ..
sudo make

# 运行测试工程脚本：
sudo ./snpe2_yolov5_multi 3


# 注意：1、sudo需要输入密码：aidlux 2、当前示例仅调用DSP

8.1.4 aidlite_tflite

Python

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_tflite/python

# 运行测试工程脚本：
# 调用DSP：
sudo python3 tflite_yolov5_multi.py 3

# 注意：1、sudo需要输入密码：aidlux 2、当前示例仅调用DSP

C++

# 进入工程目录：
cd /usr/local/share/aidlite/examples/aidlite_tflite/cpp

# 编译可执行程序：
sudo mkdir build && cd build
sudo cmake ..
sudo make

# 运行测试工程脚本：

# 调用CPU：
sudo ./snpe2_yolov5_multi 1

# 调用GPU：
sudo ./snpe2_yolov5_multi 2

# 调用DSP：
sudo ./snpe2_yolov5_multi 3

# 注意：1、sudo需要输入密码：aidlux

8.2 AidCV使用示例

8.2.1 AidCV SDK文档

AidCV SDK

C++

# 进入工程目录：
cd /usr/local/share/aidcv/samples

# 运行测试工程脚本调用本地视频文件：
python3 test_video.py 0

# 注意：1、使用aidcv时，需要启用图形化桌面，如在aidlux desktop上执行aidcv后才能观看到弹出的窗口。

8.3 Aidstream-gst SDK使用示例

8.3.1 Aidstream-gst SDK文档

Aidstream-gst SDK

8.3.2 纯编解码示例

C++

# 进入工程目录：
cd /usr/local/share/aidstream-gst/example/cxx

# 编译可执行文件：
sudo mkdir build && cd build
sudo cmake -DV4L2=ON ..
sudo make

# 运行测试工程脚本：
./start 1

# 注意：1、sudo需要输入密码：aidlux 2、需修改配置文件/usr/local/share/aidstream-gst/conf/aidstream-gst.conf 中输入输出地址。

8.3.3 编解码+算法示例

C++

# 进入工程目录：
cd /usr/local/share/aidstream-gst/example/cxx

# 编译可执行文件：
sudo mkdir build && cd build
sudo cmake ..
sudo make

# 运行测试工程脚本：
./qnn_rtsp 1

# 注意：1、sudo需要输入密码：aidlux 2、需修改配置文件/usr/local/share/aidstream-gst/conf/aidstream-gst.conf 中输入输出地址。