# 主机选项
RB3 Gen 2 开发套件预装了软件，可快速进行设备设置。RB3 Gen 2 设备可以在 Ubuntu、Windows 和 基于 macOS 的主机上实现无缝配置。按照每种操作系统的相应设置说明准备好开发套件，以运行示例程序。
Tab Ubuntu
Tab Windows
Tab macOS
- *class* tabincludedirective
- ## 设置 Ubuntu 主机
设置过程包括设置调试通用异步接收发送器 (UART)、更新软件、获取设备 IP 地址、连接到 Secure Shell (SSH) 终端、连接到高清多媒体接口 (HDMI) 显示器以及从 SSH 终端执行示例程序。以下说明适用于 Ubuntu 22.04 操作系统。
Note
要启动设备，请连接 12V 电源适配器，然后按**电源**按钮，直到看到电源插头旁边的绿色 LED 指示灯亮起。
### 设置调试 UART
要设置调试 UART 连接并查看诊断消息，可使用 micro-USB 线将 RB3 Gen 2 设备上的 micro-USB 端口连接到 Linux 主机。
Minicom 是一种串行通信程序，使管理员用户能够通过串行端口与 RB3 Gen 2 设备进行交互。
1. 要在 Linux 主机上安装 Minicom，可运行以下命令：
sudo apt update
Copy to clipboard
sudo apt install minicom
Copy to clipboard
2. 要检查 USB 端口，可运行以下命令：
ls /dev/ttyUSB*
Copy to clipboard
**示例输出**
/dev/ttyUSB0
3. 要打开 Minicom，可运行以下命令：
sudo minicom -s
Copy to clipboard
4. 按**向下**箭头键选择 **Serial port setup** 选项。
5. 如需设置串行设备配置，可执行以下操作：
1. 按下键盘上的 **A** 设置串行设备名称，例如 `/dev/ttyUSB0`。
2. 按 **Enter** 保存更改。
3. 按下键盘上的 **E** 设置波特率。如果波特率未设置为 **115200**，再次按 **E** 键。按下键盘上的 **Q** 将配置设为 **8N1**。
4. 按 **Enter** 保存更改。
5. 按下键盘上的 **F** 将 **Hardware Flow Control** 设置为 **No**。
Note
确保字母 A、E、Q 和 F 均为大写。
6. 按 **Enter** 保存更改。
6. 选择 **Save setup as dfl** 选项，然后按 **Enter**。
7. 选择 **Exit** 以打开 UART 控制台。
8. 打开串口设备后，按 **ENTER** 弹出登录提示。
9. 要登录 UART 控制台，需提供以下信息：
- **Login**：`root`
- **Password**：`oelinux123`
Note
如果登录控制台并未按预期显示出来，可检查 USB 连接。如有必要，断开 Micro USB，然后再重新连接。
Note
如果要从 UART shell 运行示例程序，可使用以下命令重新挂载具有读/写权限的文件系统：
mount -o rw,remount /
Copy to clipboard
### 检查 Qualcomm Linux 版本
Note
确保主机正在运行 Ubuntu 22.04。
要检查 Qualcomm Linux 版本，请在设备 shell 中运行以下命令之一：
- >
>
> uname -a
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> Linux qcs6490-rb3gen2-vision-kit 6.6.52-qli-1.3-ver.1.1-03321-gd3ed32bf7ee6 #1 SMP PREEMPT Sat Dec 14 12:45:01 UTC 2024 aarch64 aarch64 aarch64 GNU/Linux
或者
- >
>
> cat /etc/os-release
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> ID=qcom-wayland
> NAME=”Qualcomm Linux”
> VERSION=”1.3-ver.1.1”
> VERSION\_ID=1.3-ver.1.1
> PRETTY\_NAME=”Qualcomm Linux 1.3-ver.1.1”
>
>
> Note
>
>
> 要将 Qualcomm AI SDK 软件版本更新至 v2.29，请参考 [Qualcomm AI SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-15B/qairt-install.html)。
>
>
> Important
>
>
> 如果 RB3 Gen 2 设备已在运行最新 Qualcomm Linux 软件，请转至[获取设备 IP 地址](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#wifi-ubuntu)。
### 更新软件
更新软件的过程包括配置前提条件和将软件刷写到设备上。
#### 配置前提条件
确保设备处于紧急下载 (EDL) 模式，再更新 `udev` 规则。
##### EDL 模式
如果开机后设备上没有软件，或现有软件已损坏，设备将进入 EDL 模式。
要强制设备进入 EDL 模式以启用软件刷写，可执行以下操作：
1. 按住 **F\_DL** 按钮。
2. 将设备连接到 12 V 电源。
3. 通过 USB Type-C 接口将设备连接到主机系统。
4. 松开 **F\_DL** 按钮。设备现在应处于 EDL 模式。
5. 要验证设备是否进入 EDL 模式，可在主机上运行以下命令：
lsusb
Copy to clipboard
**示例输出**
Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
##### 更新 udev 规则
确保在 Linux 主机上为 Qualcomm 制造供应商 ID **05c6** 配置 `udev` USB 规则。在 Linux 主机上运行以下命令：
1. 如需进入该目录，可运行以下命令：
cd /etc/udev/rules.d
Copy to clipboard
2. 如需列出目录的内容，可运行以下命令：
ls
Copy to clipboard
- 如果 `51-qcom-usb.rules` 文件不存在，请使用 `sudo vi 51-qcom-usb.rules` 创建文件，并将以下内容添加至文件中：
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"
Copy to clipboard
- 如果该文件存在，则检查先前的内容。使用以下命令查看内容：
cat 51-qcom-usb.rules
Copy to clipboard
3. 如需重启 `udev`，可运行以下命令：
sudo systemctl restart udev
Copy to clipboard
如果 USB 线已连接到主机，拔下然后重新连接以使更新后的规则生效。
#### 刷写软件
RB3 Gen 2 设备支持以下软件：
**（推荐）Qualcomm Intelligent Multimedia Product (QIMP) SDK**
这是推荐用于 RB3 Gen 2 设备的软件。该软件随附多媒体应用程序。
**Qualcomm Intelligent Robotics Product (QIRP) SDK**
该版本 RB3 Gen 2 软件配备了机器人应用程序。
#### QIMP SDK 软件
如需将 QIMP SDK 下载到 x86 或 Arm^®^ 主机，可执行以下操作：
Note
在下载 artifact zip 文件之前，请确保您有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 核心套件
1. 如需将 QIMP SDK 下载到 x86 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
###### 机器视觉套件
1. 如需将 QIMP SDK 下载到 x86 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
##### 在 Arm 主机上
###### 核心套件
1. 如需将 QIMP SDK 下载到 Arm 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
###### 机器视觉套件
1. 如需将 QIMP SDK 下载到 Arm 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
#### QIRP SDK 软件
要将 QIRP SDK 下载到 x86 或 Arm 主机上，执行以下操作：
Note
在下载 artifact zip 文件之前，请确保有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 机器视觉套件
1. 要将 QIRP SDK 下载到 x86 主机上，运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 要在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
##### 在 Arm 主机上
###### 机器视觉套件
1. 要将 QIRP SDK 下载到 Arm 主机上，运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 要在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#link-qdl)。
##### 使用独立的 Qualcomm Download (QDL) 进行刷写
QDL 工具是一款刷写工具，可与 ID 标识为 05c6:9008 USB 设备进行通信。该工具将刷写程序上传到设备，然后将镜像刷写到设备中的 UFS 存储。
>
>
> - 下载 [QDL 工具](https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader)并解压下载的文件夹的内容。
Note
- 根据主机架构使用相应的 QDL 二进制文件。例如，linux\_x64 架构支持的 qdl 二进制文件是 `qdl_2.1.1/QDL_Linux_x64/qdl`。
- 有关 QDL 工具使用的详细信息，请参阅您解压的 QDL 目录中的 **QDL\_User\_Guide**。
在当前发布版本中，对分区表的修改需要重新配置通用闪存存储 (UFS) 并刷写配置数据表 (CDT)。
Note
当您首次刷写当前发布版本时，配置 UFS 和刷写 CDT 是需要完成的一次性的过程。
**配置 UFS**
UFS 配置将存储划分为多个逻辑单元号 (LUN)，从而允许分别存储不同类型的数据。这提高了访问效率和优化了系统结构。
Note
- 默认情况下已配置 UFS。如果 LUN 有任何变更，则必须再次对 UFS 进行配置。
- 要下载 provision XML 文件并检查 UFS 配置对不同 SoC 的适用性，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)中的 **UFS Provisioning** 表。
- 确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl)。
1. 要下载预配文件，请执行以下操作：
根据所需的 SoC，从[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)的 **UFS Provisioning** 表下载相应的 provision 文件。
mkdir
Copy to clipboard
cd
Copy to clipboard
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
Copy to clipboard
unzip provision.zip
Copy to clipboard
2. 要配置 UFS，请运行以下命令：
cd
Copy to clipboard
/qdl_2.1.1/QDL_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf
Copy to clipboard
**示例**
<qdl\_tool\_path>/qdl\_2.1.1/QDL\_Linux\_x64/qdl –storage ufs prog\_firehose\_ddr.elf provision\_1\_3.xml
**刷写 CDT**
Note
确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl)。
CDT 提供平台或设备相关的数据，例如平台 ID、子类型、版本。各种软件（驱动程序/固件）模块可以使用这些信息对平台进行动态检测和初始化。
您可以通过刷写 CDT 二进制文件来更新 CDT：
1. 下载 CDT 二进制文件。
根据所需的开发套件，从发布说明中的 **Flash CDT** 表[下载相应的 CDT](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)。
mkdir
Copy to clipboard
cd
Copy to clipboard
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/cdt/rb3gen2-vision-kit.zip
Copy to clipboard
Note
提供的链接是针对机器视觉套件的。其他开发套件的 CDT 的信息，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)。
>
>
> unzip rb3gen2-core-kit.zip
> Copy to clipboard
2. 要刷写 CDT，请运行以下命令：
cd
Copy to clipboard
/qdl_2.1.1/QDL_Linux_x64/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
Copy to clipboard
**使用 QDL 进行刷写**
Note
确保 ModemManager 工具未运行。
某些 Linux 发行版包括 ModemManager 工具，它允许您配置移动宽带。当设备以 USB 模式连接时，它被标识为 Qualcomm modem，并且 ModemManager 会尝试配置设备。由于这会干扰 QDL 刷写，因此您必须在连接设备之前禁用 ModemManager。
如果使用的是包含 systemd 的 Linux 发行版，请使用以下命令停止 ModemManager 工具：
sudo systemctl stop ModemManager
Copy to clipboard
- 如果需要 ModemManager，可以在刷写完成后重新启动它。
- 确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl)。
- 要刷写镜像，请运行以下命令：
>
>
> cd /target/qcs6490-rb3gen2-core-kit/qcom-multimedia-image
> Copy to clipboard
Note
将 `` 替换为提取的 `qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip` 文件的路径。
>
>
> /qdl_2.1.1/QDL_Linux_x64/qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml
> Copy to clipboard
Note
在当前发布版本中，如果您在 QDL 刷写期间看到 **no boot partition found** 消息，您可以忽略它并继续执行该步骤。
刷写操作成功后，运行 `lsusb` 命令，在终端窗口中查看设备信息，如下第 4 行所示：
>
>
> # Sample output for QCS6490
>
>
> Bus 002 Device 003: ID 05c6:9135 Qualcomm, Inc. qcs6490-rb3gen2-vision-kit
>
>
> Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
>
>
> Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Note
如果刷写失败，请执行以下操作并重试刷写过程：
1. 关闭设备。
2. 断开设备与主机的连接。
3. 重新启动主机。
Note
- 对于机器视觉套件，可将刷写命令中的所有 `qcs6490-rb3gen2-core-kit` 替换为 `qcs6490-rb3gen2-vision-kit`。
- `rawprogram*.xml` 和 `patch*.xml` 是通配符表示法，将匹配指定目录中以 `patch` 和 `rawprogram` 开头的所有文件。
Note
- 成功完成刷写过程后，设备将重新启动。
- 要更新 USB 和以太网控制器固件，请参阅[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
- 要验证更新的软件版本，请参阅[检查 Qualcomm Linux 版本](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#concept-p21-rvz-qbc)。
- 对于 UART 连接，确认检测到的 UART 端口是否与之前配置的端口匹配。
### 获取设备 IP 地址
您可以使用以下任一方法获取 RB3 Gen 2 设备的 IP 地址。
#### 使用以太网
1. 将以太网线的一端插入 RB3 Gen 2 设备的以太网端口（RJ45），并将另一端连接到网络路由器。
2. 连接建立成功后，在 UART 串行控制台执行以下命令获取 IP 地址：
ifconfig eth2
Copy to clipboard
Note
如果在建立连接时遇到问题，参见[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
#### 使用 Wi-Fi
Wi-Fi 在 Station 模式下运行。Wi-Fi host 驱动程序和网络管理身份验证在设备启动期间初始化。用户可以使用 **nmcli** 命令行工具建立无线连接。
1. 要连接到无线接入点（Wi-Fi 路由器），请运行以下命令：
>
>
> nmcli dev wifi connect password
> Copy to clipboard
>
>
> **示例**
>
>
> root@qcs6490-rb3gen2-vision-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘d7b990bd-3b77-4b13-b239-b706553abaf8’.
2. 要检查连接和设备状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 要检查 WLAN 连接状态和 IP 地址，请运行以下命令：
>
>
> ifconfig wlan0
> Copy to clipboard
>
> 
4. 为了确保连接处于活动状态，请对 Google 等网站执行 ping 操作：
>
>
> ping google.com
> Copy to clipboard
**切换网络**
>
>
> 如果您已连接到某个网络并需要重新连接至另一个网络，请执行以下操作：
1. 要断开当前网络，请运行以下命令：
>
>
> nmcli c down QualcommWiFi
> Copy to clipboard
>
>
> Connection ‘QualcommWiFi’ successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)
2. 要检查断开连接状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 要连接到不同的 Wi-Fi 网络，请运行以下命令：
>
>
> nmcli dev wifi connect QualcommAP password XXXXXXXXX
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘6159ac7c-58c2-44fa-938f-45dcb544fac3’.
### 连接到 SSH
确保在连接到 SSH 之前已建立网络连接。
1. 如需根据网络连接类型查找 RB3 Gen 2 设备的 IP 地址，可在 Linux 主机的 UART 控制台中运行相应的命令：
对于以太网：
ifconfig eth2
Copy to clipboard
对于 Wi-Fi：
ifconfig wlan0
Copy to clipboard
2. 从 Linux 主机运行以下命令，以通过 SSH 连接设备。使用通过**步骤 1** 获得的 IP 地址。
ssh root@ip-address
Copy to clipboard
**示例**
`ssh root@192.168.0.222`
3. 要连接 SSH shell，输入以下密码：
oelinux123
Copy to clipboard
Note
确保远程主机连接到与设备相同的 Wi-Fi 接入点。
Note
有关创建非 root 用户帐户的过程，参见[创建非 root 用户帐户](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#non-root-acc)。
### 连接 HDMI 显示屏
如需启用 HDMI 显示屏并查看示例程序的输出，可将 HDMI 线的一端连接到 RB3 Gen 2 设备上的 HDMI 端口，将另一端连接到显示屏。
确保设备已开机并检查 HDMI 显示屏。显示屏上应显示一个特定的图案。
如果显示界面未按预期显示出来，可将 **DIP\_SW\_0** 的 **Switch 4** 切换至 OFF。有关更多信息，参见 [DIP 开关](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-251/rb3_dip_switches.html)。
如果问题仍然存在，请参阅 [HDMI 故障排除](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-18/debug.html#hdmi-troubleshooting)来解决问题。
Note
当前版本不提供将 RB3 Gen 2 设备用作单板计算机的选项。
### 运行示例应用程序
现在可以开始运行[示例应用程序](https://docs.qualcomm.com/doc/80-70017-253Y/topic/demo_app.html#task-ccx-b24-k1c)。
- *class* tabincludedirective
- ## 设置 Windows 主机
设置过程包括设置调试 UART、更新软件、获取设备 IP 地址、连接到 SSH 终端、连接到 HDMI 显示器以及从 SSH 终端执行示例程序。以下说明适用于 Windows 11 操作系统。
Note
要启动设备，请连接 12V 电源适配器，然后按**电源**按钮，直到看到电源插头旁边的绿色 LED 指示灯亮起。
### 设置调试 UART
要设置调试 UART 连接并查看诊断消息，可使用 micro-USB 线将 RB3 Gen 2 设备上的 micro-USB 端口连接到 Windows 主机。
1. 下载 [PuTTY](https://www.putty.org/) 应用到 Windows 主机中。确保选择适合所用 Windows（32 位或 64 位）的正确版本。
2. 运行安装向导并按提示操作。
3. 安装后，通过 **Start** 菜单打开已安装程序列表中的 PuTTY 应用。或者使用任务栏中的搜索栏进行搜索。
4. 在 **PuTTY Configuration** 对话框中，执行以下操作：
1. 选择 **Serial**。
2. 根据 **Windows Device Manager** 上检测到的 UART 端口指定 **Serial line**。
Note
>
>
> 如果未检测到 UART 端口，执行以下操作：
- 对于 x86：下载 [USB 转 UART 串行驱动程序](https://ftdichip.com/wp-content/uploads/2023/09/CDM-v2.12.36.4-WHQL-Certified.zip)并进行更新。
- 对于 Arm：转到 [https://oemdrivers.com/usb-ft232r-usb-uart-arm64](https://oemdrivers.com/usb-ft232r-usb-uart-arm64) 网页。在 **Drivers** 部分，点击 **Show Driver Link(s)** 以访问和下载驱动程序。
3. 将波特率设置为 **115200**。
4. 点击 **Open** 启动 PuTTY 会话。
5. 打开串口设备后，按 **ENTER** 弹出登录提示。
6. 要登录 UART 控制台，需提供以下信息：
- **Login**：`root`
- **Password**：`oelinux123`
Note
如果要从 UART shell 运行示例程序，可使用以下命令重新挂载具有读/写权限的文件系统：
mount -o rw,remount /
Copy to clipboard
### 检查 Qualcomm Linux 版本
要检查 Qualcomm Linux 版本，请在设备 shell 中运行以下命令之一：
- >
>
> uname -a
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> Linux qcs6490-rb3gen2-vision-kit 6.6.52-qli-1.3-ver.1.1-03321-gd3ed32bf7ee6 #1 SMP PREEMPT Sat Dec 14 12:45:01 UTC 2024 aarch64 aarch64 aarch64 GNU/Linux
或者
- >
>
> cat /etc/os-release
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> ID=qcom-wayland
> NAME=”Qualcomm Linux”
> VERSION=”1.3-ver.1.1”
> VERSION\_ID=1.3-ver.1.1
> PRETTY\_NAME=”Qualcomm Linux 1.3-ver.1.1”
>
>
> Note
>
>
> 如需将 Qualcomm AI SDK 软件版本更新至 v2.29，请参考 [Qualcomm AI SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-15B/qairt-install.html)。
>
>
> Important
>
>
> 如果 RB3 Gen 2 设备已在运行最新 Qualcomm Linux 软件，请转至[获取设备 IP 地址](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#device-ip-win)。
### 更新软件
如果您已在 Qualcomm 进行注册并且具备一台 Windows 主机，则可以[使用 PCAT 方法刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-using-pcat)。
对于未注册用户，更新软件的过程包括配置前提条件和将软件刷写到设备上。
#### 配置前提条件
确保设备处于紧急下载 (EDL) 模式。
##### EDL 模式
如果开机后设备上没有软件，或现有软件已损坏，设备将进入 EDL 模式。
要强制设备进入 EDL 模式以启用软件刷新。请执行以下操作：
1. 按住 **F\_DL** 按钮。
2. 将设备连接到 12 V 电源。
3. 通过 USB Type-C 接口将设备连接到主机系统。
4. 松开 **F\_DL** 按钮。设备现在应处于 EDL 模式。
#### 刷写软件
RB3 Gen 2 设备支持以下软件：
**（推荐）Qualcomm Intelligent Multimedia Product (QIMP) SDK**
这是推荐用于 RB3 Gen 2 设备的软件。该软件随附多媒体应用程序。
**Qualcomm Intelligent Robotics Product (QIRP) SDK**
该版本 RB3 Gen 2 软件配备了机器人应用程序。
#### QIMP SDK 软件
如需将 QIMP SDK 下载到 x86 或 Arm^®^ 主机，可执行以下操作：
Note
在下载 artifact zip 文件之前，请确保您有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 核心套件
1. 如需在 x86 主机上下载 QIMP SDK，可将以下 URL 粘贴到浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
###### 机器视觉套件
1. 如需在 x86 主机上下载 QIMP SDK，可将以下 URL 粘贴到浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
##### 在 Arm 主机上
###### 核心套件
1. 如需在 Arm 主机上下载 QIMP SDK，可将以下 URL 粘贴到浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
###### 机器视觉套件
1. 如需在 Arm 主机上下载 QIMP SDK，可将以下 URL 粘贴到浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
要将软件刷写到 RB3 Gen 2 设备上，先安装 PCAT 工具，然后进行软件刷写。有关详细说明，可参见[使用 PCAT 刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-using-pcat)。
#### QIRP SDK 软件
要在 x86 或 Arm 主机上下载 QIRP SDK，请执行以下操作：
Note
在下载 artifact zip 文件之前，请确保您有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 机器视觉套件
1. 要在 x86 主机上下载 QIRP SDK，请将以下 URL 粘贴至浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
##### 在 Arm 主机上
###### 机器视觉套件
1. 要在 Arm 主机上下载 QIRP SDK，请将以下 URL 粘贴至浏览器中：
https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 在开发主机上解压下载的文件。
#### 使用 PCAT 进行刷写
如果您已在 Qualcomm 进行注册并且具备一台 Windows 主机，则可以使用 Qualcomm Product Configuration Assistant (PCAT) 工具刷写软件。
该过程包括下载 Qualcomm^®^ Software Center (QSC)、安装 Qualcomm USB 驱动程序 (QUD)、Qualcomm Unified Tools Service (QUTS) 和 PCAT。安装必要的工具后，下载软件并开始刷新过程。
**图：使用 PCAT 刷新软件的工作流程**
##### 安装 QSC
QSC 管理 Qualcomm 软件并简化开发过程。
1. 使用您的 Qualcomm ID 登录 [https://softwarecenter.qualcomm.com/](https://softwarecenter.qualcomm.com/)。
2. 点击 **Download Software Center**。QSC 可执行文件将下载到您的 Windows 计算机。
3. 点击 QSC `.exe` 可执行文件开始安装。
要在安装后打开 Launcher 桌面程序，请在计算机上的程序菜单中搜索 **Qualcomm Software Center**。
##### 安装 QUD
1. 在 QSC 桌面程序的 **Dashboard** 页面上，在顶部搜索栏中输入 **qud**。将显示搜索结果。
2. 点击 **Qualcomm USB Driver** 卡片，进入工具详细信息页面。
3. 在工具详细信息页面上选择相关工具版本（默认选择最新版本），然后点击 **Install**。
4. 下载完成后，进入 **Downloads** 页面（从通知弹出窗口或顶部菜单栏），然后点击 **Install** 开始安装。
5. 查看许可协议并选择 **I accept** 来开始安装。
##### 安装 QUTS
1. 在 QSC 桌面程序的 **Dashboard** 页面上，在顶部搜索栏中输入 **quts**。将显示搜索结果。
2. 要继续安装过程，可参见[安装 QUD](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#section-jj1-4ts-vbc) 并按照步骤 2 到步骤 5 的过程进行操作。
##### 安装 PCAT
1. 在 QSC 桌面程序的 **Dashboard** 页面上，在顶部搜索栏中输入 **pcat**。将显示搜索结果。
2. 要继续安装过程，可参见[安装 QUD](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#section-jj1-4ts-vbc) 并按照步骤 2 到步骤 5 的过程进行操作。
##### 刷写软件
**前提条件**：确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#edl-link-win)。
Note
Qualcomm Linux 1.3 版本包括对分区表的更改。因此，在刷写二进制文件之前，请确保已完成对通用闪存存储 (UFS) 的重新配置。
要配置 UFS, 请使用 Qualcomm 产品配置助手 (PCAT) 工具。关于 UFS 配置的说明，请参阅[配置 UFS](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#provision-ufs)。
配置 UFS 后，您需要刷新一次性可编程的配置数据表 (CDT)，然后更新 USB 固件。
- 关于 CDT 刷写的步骤，参见[刷写 CDT](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#flash-cdt)。
- 要更新 USB 和以太网控制器固件，请参阅[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
**步骤**
1. 要检查设备是否被 PCAT 工具识别，请在主机上运行以下命令：
pcat -devices
Copy to clipboard
**示例输出**
2. 要将软件刷写到设备上，可在主机上运行以下命令：
PCAT -PLUGIN SD -DEVICE -BUILD "\target\qcs6490-rb3gen2-vision-kit\qcom-multimedia-image" -MEMORYTYPE UFS -FLAVOR asic
Copy to clipboard
Note
对于核心套件，可在命令中将 `qcs6490-rb3gen2-vision-kit` 替换为 `qcs6490-rb3gen2-core-kit`。
**示例**
>
>
> PCAT -PLUGIN SD -DEVICE 57BED305 -BUILD "\target\qcs6490-rb3gen2-vision-kit\qcom-multimedia-image" -MEMORYTYPE UFS -FLAVOR asic
> Copy to clipboard
>
>
> 刷写成功后，将显示以下消息：
>
>
> xxxx INFO] [ FIRMWARE DOWNLOAD LOG ] Process
>
>
> Finished
>
>
> xxxx INFO] Status - TRUE
>
>
> xxxx INFO] Response - Downloading software images completed on the
>
>
> device Qualcomm USB Composite Device:QUSB\_BULK\_CID:042F\_SN:57BED305
Note
- 成功完成刷写过程后，设备将重新启动。
- 要更新 USB 和以太网控制器固件，请参阅[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
- 要验证更新的软件版本，请参阅[检查 Qualcomm Linux 版本](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#ver-link-win)。
- 要连接设备，可参见[连接 SSH](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#ssh-link-win)。
### 获取设备 IP 地址
您可以使用以下任一方法获取 RB3 Gen 2 设备的 IP 地址。
#### 使用以太网
1. 将以太网线的一端插入 RB3 Gen 2 设备的以太网端口（RJ45），并将另一端连接到网络路由器。
2. 连接建立成功后，在 UART 串行控制台执行以下命令获取 IP 地址：
ifconfig eth2
Copy to clipboard
Note
如果在建立连接时遇到问题，参见[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
#### 使用 Wi-Fi
Wi-Fi 在 Station 模式下运行。Wi-Fi 主机驱动程序和网络管理身份验证在设备启动期间初始化。用户可以使用 **nmcli** 命令行工具建立无线连接。
1. 要连接到无线接入点（Wi-Fi 路由器），请运行以下命令：
>
>
> nmcli dev wifi connect password
> Copy to clipboard
>
>
> **示例**
>
>
> root@qcs6490-rb3gen2-vision-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘d7b990bd-3b77-4b13-b239-b706553abaf8’.
2. 要检查连接和设备状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 请运行以下命令，以便检查 WLAN 连接状态和 IP 地址：
>
>
> ifconfig wlan0
> Copy to clipboard
>
> 
4. 为了确保连接处于活动状态，请对 Google 等网站执行 ping 操作：
>
>
> ping google.com
> Copy to clipboard
**切换网络**
>
>
> 如果您已连接到某个网络并需要重新连接至另一个网络，请执行以下操作：
1. 要断开当前网络，请运行以下命令：
>
>
> nmcli c down QualcommWiFi
> Copy to clipboard
>
>
> Connection ‘QualcommWiFi’ successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)
2. 要检查断开连接状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 要连接到不同的 Wi-Fi 网络，请运行以下命令：
>
>
> nmcli dev wifi connect QualcommAP password XXXXXXXXX
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘6159ac7c-58c2-44fa-938f-45dcb544fac3’.
### 连接到 SSH
确保在连接到 SSH 之前已建立网络连接。
1. 如需根据网络连接类型查找 RB3 Gen 2 设备的 IP 地址，可在 UART 控制台中运行相应的命令：
对于以太网：
ifconfig eth2
Copy to clipboard
对于 Wi-Fi：
ifconfig wlan0
Copy to clipboard
2. 从远程主机运行以下命令，与设备建立 SSH 连接。使用通过**步骤 1** 获得的 IP 地址。
ssh root@ip-address
Copy to clipboard
**示例**
`ssh root@192.168.0.222`
3. 要连接 SSH shell，可输入以下密码：
oelinux123
Copy to clipboard
Note
确保远程主机连接到与设备相同的 Wi-Fi 接入点。
Note
有关创建非 root 用户帐户的过程，参见[创建非 root 用户帐户](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#non-root-acc)。
### 连接 HDMI 显示屏
如需启用 HDMI 显示屏并查看示例程序的输出，可将 HDMI 线的一端连接到 RB3 Gen 2 设备上的 HDMI 端口，将另一端连接到显示屏。
确保设备已开机并检查 HDMI 显示屏。显示屏上应显示一个特定的图案。
如果显示界面未按预期显示出来，可将 **DIP\_SW\_0** 的 **Switch 4** 切换至 OFF。有关更多信息，参见 [DIP 开关](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-251/rb3_dip_switches.html)。
如果问题仍然存在，请参阅 [HDMI 故障排除](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-18/debug.html#hdmi-troubleshooting)来解决问题。
Note
当前版本不提供将 RB3 Gen 2 设备用作单板计算机的选项。
### 运行示例应用程序
现在可以开始运行[示例应用程序](https://docs.qualcomm.com/doc/80-70017-253Y/topic/demo_app.html#task-ccx-b24-k1c)。
- *class* tabincludedirective
- ## 设置 macOS 主机
设置过程包括设置调试 UART、更新软件、获取设备 IP 地址、连接到 SSH 终端、连接到 HDMI 显示器以及从 SSH 终端执行示例应用程序。以下说明适用于 macOS 14。
Note
要启动设备，请连接 12V 电源适配器，然后按**电源**按钮，直到看到电源插头旁边的绿色 LED 指示灯亮起。
### 设置调试 UART
要设置调试 UART 连接并查看诊断消息，可使用 micro-USB 线将 RB3 Gen 2 设备上的 micro-USB 端口连接到 macOS 主机。
1. 要检查连接到 macOS 主机的串行设备，请运行以下命令：
ls /dev/cu.*
Copy to clipboard
2. 从串行设备列表中查找该串行设备。您的设备名称应显示在该列表中。
3. 如需打开该串行设备，可运行以下命令：
screen
Copy to clipboard
Note
- 将 `` 替换为设备节点名称。
- 将 `` 替换为适当的波特率。
**示例命令** `ceteam@Qualcomms-MacBook-Pro ~ % screen /dev/cu.usbserial-DM03SDQQ 115200`
4. 打开串行设备后，按 **ENTER** 键调出登录提示。
5. 要登录 UART 控制台，需提供以下信息：
- **Login**：`root`
- **Password**：`oelinux123`
Note
如果要从 UART shell 运行示例程序，可使用以下命令重新挂载具有读/写权限的文件系统：
mount -o rw,remount /
Copy to clipboard
### 检查 Qualcomm Linux 版本
Note
确保主机正在运行 Ubuntu 22.04。
要检查 Qualcomm Linux 版本，请在设备的 shell 中运行以下命令之一：
- >
>
> uname -a
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> Linux qcs6490-rb3gen2-vision-kit 6.6.52-qli-1.3-ver.1.1-03321-gd3ed32bf7ee6 #1 SMP PREEMPT Sat Dec 14 12:45:01 UTC 2024 aarch64 aarch64 aarch64 GNU/Linux
或者
- >
>
> cat /etc/os-release
> Copy to clipboard
输出显示 Qualcomm Linux 版本。
>
>
> ID=qcom-wayland
> NAME=”Qualcomm Linux”
> VERSION=”1.3-ver.1.1”
> VERSION\_ID=1.3-ver.1.1
> PRETTY\_NAME=”Qualcomm Linux 1.3-ver.1.1”
>
>
> Note
>
>
> 如需将 Qualcomm AI SDK 软件版本更新至 v2.29，请参考 [Qualcomm AI SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-15B/qairt-install.html)。
>
>
> Important
>
>
> 如果 RB3 Gen 2 设备已在运行最新 Qualcomm Linux 软件，请转至[获取设备 IP 地址](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#mac-device-ip)。
### 更新软件
更新软件的过程包括搭建虚拟机 (VM) 环境、配置前提条件以及将软件刷写到设备上。
#### 搭建虚拟机
如果没有安装了 Ubuntu 操作系统的计算机，可以在 Mac 主机上搭建运行 Ubuntu 操作系统的虚拟机。
要搭建虚拟机环境，参见[在 Mac 上搭建 Ubuntu 虚拟机](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-41/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html)。
#### 配置前提条件
搭建虚拟机环境后，确保设备处于紧急下载 (EDL) 模式，然后继续更新 `udev` 规则。
##### EDL 模式
如果开机后设备上没有软件，或现有软件已损坏，设备将进入 EDL 模式。
要强制设备进入 EDL 模式以启用软件刷写，可执行以下操作：
1. 按住 **F\_DL** 按钮。
>
>
> 
2. 将设备连接到 12 V 电源。
3. 通过 USB Type-C 接口将设备连接到主机系统。
4. 松开 **F\_DL** 按钮。设备现在应处于 Qualcomm download (QDL) 模式。对于此任务，QDL 与 EDL 可互换使用。
5. 要验证设备是否进入 EDL 模式，可在主机上运行以下命令：
lsusb
Copy to clipboard
**示例输出**
Bus 002 Device 014: ID 05c6:9008 Qualcomm, Inc. Gobi Wireless Modem (QDL mode)
##### 更新 udev 规则
确保在 Ubuntu VM 上为 Qualcomm 制造供应商 ID **05c6** 配置 `udev` USB 规则。
在 Ubuntu VM 上运行以下命令：
1. 如需进入该目录，可运行以下命令：
cd /etc/udev/rules.d
Copy to clipboard
2. 如需列出目录的内容，可运行以下命令：
ls
Copy to clipboard
- 如果 `51-qcom-usb.rules` 文件不存在，请使用 `sudo vi 51-qcom-usb.rules` 创建文件，并将以下内容添加至文件中：
SUBSYSTEMS=="usb", ATTRS{idVendor}=="05c6", ATTRS{idProduct}=="9008", MODE="0666", GROUP="plugdev"
Copy to clipboard
- 如果该文件存在，则检查先前的内容。使用以下命令查看内容：
cat 51-qcom-usb.rules
Copy to clipboard
3. 如需重启 `udev`，可运行以下命令：
sudo systemctl restart udev
Copy to clipboard
如果 USB 线已连接到主机，拔下然后重新连接以使更新后的规则生效。
#### 刷写软件
RB3 Gen 2 设备支持以下软件：
**（推荐）Qualcomm Intelligent Multimedia Product (QIMP) SDK**
这是推荐用于 RB3 Gen 2 设备的软件。该软件随附多媒体应用程序。
**Qualcomm Intelligent Robotics Product (QIRP) SDK**
该版本 RB3 Gen 2 软件配备了机器人应用程序。
#### QIMP SDK 软件
如需将 QIMP SDK 下载到 x86 或 Arm^®^ 主机，可执行以下操作：
Note
在下载 artifact zip 文件之前，请确保您有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 核心套件
1. 如需将 QIMP SDK 下载到 x86 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
###### 机器视觉套件
1. 如需将 QIMP SDK 下载到 x86 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
##### 在 Arm 主机上
###### 核心套件
1. 如需将 QIMP SDK 下载到 Arm 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-core-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
###### 机器视觉套件
1. 如需将 QIMP SDK 下载到 Arm 主机，可运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qimpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
#### QIRP SDK 软件
要在 x86 或 Arm 主机上下载 QIRP SDK，请执行以下操作：
Note
在下载 artifact zip 文件之前，请确保您有足够的可用存储空间，因为解压缩后需要大约 11 GB 的空间。
##### 在 x86 主机上
###### 机器视觉套件
1. 要在 x86 主机上下载 QIRP SDK，请运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/x86/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
##### 在 Arm 主机上
###### 机器视觉套件
1. 要在 Arm 主机上下载 QIRP SDK，请运行以下命令：
wget https://artifacts.codelinaro.org/artifactory/qli-ci/flashable-binaries/qirpsdk/qcs6490-rb3gen2-vision-kit/arm/qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
2. 如需在开发主机上解压下载的文件，可运行以下命令：
unzip qcom-6.6.52-QLI.1.3-Ver.1.1_robotics-product-sdk-1.1.zip
Copy to clipboard
3. 要刷写软件，请参阅[使用独立的 Qualcomm Download (QDL) 进行刷写](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#flash-mac-qdl)。
##### 使用独立的 Qualcomm Download (QDL) 进行刷写
QDL 工具是一款刷写工具，可与 ID 05c6:9008 标识的 USB 设备进行通信。该工具将刷写程序上传到设备，然后将镜像刷写到设备中的 UFS 存储。
>
>
> - 下载 [QDL 工具](https://softwarecenter.qualcomm.com/#/catalog/item/Qualcomm_Device_Loader)并解压下载的文件夹的内容。
Note
- 根据主机架构使用相应的 QDL 二进制文件。例如，linux\_x64 架构支持的 qdl 二进制文件是 `qdl_2.1.1/QDL_Linux_x64/qdl`。
- 有关 QDL 工具使用的详细信息，请参阅您解压的 QDL 目录中的 **QDL\_User\_Guide**。
在当前发布版本中，对分区表的修改需要重新配置通用闪存存储 (UFS) 并刷写配置数据表 (CDT)。
Note
当您首次刷写当前发布版本时，需要进行一次性的配置，来配置 UFS 和刷写 CDT。
**配置 UFS**
UFS 配置将存储划分为多个逻辑单元号 (LUN)，从而允许分别存储不同类型的数据。这提高了访问效率和优化了系统结构。
Note
- 默认情况下已配置 UFS。如果 LUN 有任何变更，则必须对 UFS 重新配置。
- 要下载 provision XML 文件并检查 UFS 配置对不同 SoC 的适用性，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)中的 **UFS Provisioning** 表。
- 确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl-mac)。
1. 要下载 provision 文件，请执行以下操作：
根据所需的 SoC，从[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)中的 **UFS Provisioning** 表下载相应的 provision。
mkdir
Copy to clipboard
cd
Copy to clipboard
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/provision.zip
Copy to clipboard
unzip provision.zip
Copy to clipboard
2. 要配置 UFS，请运行以下命令：
cd
Copy to clipboard
/qdl_2.1.1/QDL_Linux_x64/qdl --storage ufs prog_firehose_ddr.elf
Copy to clipboard
**示例**
<qdl\_tool\_path>/qdl\_2.1.1/QDL\_Linux\_x64/qdl –storage ufs prog\_firehose\_ddr.elf provision\_1\_3.xml
**刷写 CDT**
Note
确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl-mac)。
CDT 提供平台或设备相关的数据，例如平台 ID、子类型、版本。各种软件（驱动程序/固件）模块可以使用这些信息对平台进行动态检测和初始化。
您可以通过刷写 CDT 二进制文件来更新 CDT：
1. 下载 CDT 二进制文件。
根据所需的开发套件，从[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)中的 **Flash CDT** 表下载相应的 CDT。
mkdir
Copy to clipboard
cd
Copy to clipboard
wget https://artifacts.codelinaro.org/artifactory/codelinaro-le/Qualcomm_Linux/QCS6490/cdt/rb3gen2-vision-kit.zip
Copy to clipboard
Note
这里提供的链接是针对机器视觉套件的。其他开发套件的 CDT 信息，请参阅[发布说明](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-241225194606/ReleaseNote.html#release-specific-information)。
>
>
> unzip rb3gen2-core-kit.zip
> Copy to clipboard
2. 要刷写 CDT，请运行以下命令：
cd
Copy to clipboard
/qdl_2.1.1/QDL_Linux_x64/qdl prog_firehose_ddr.elf rawprogram3.xml patch3.xml
Copy to clipboard
**使用 QDL 进行刷写**
Note
确保 ModemManager 工具未运行。
某些 Linux 发行版包括 ModemManager 工具，它允许您配置移动宽带。当设备以 USB 模式连接时，它会被识别为 Qualcomm modem，并且 ModemManager 会尝试配置设备。由于这会干扰 QDL 刷写，因此您必须在连接设备之前禁用 ModemManager。
如果使用的是包含 systemd 的 Linux 发行版，请使用以下命令停止 ModemManager 工具：
sudo systemctl stop ModemManager
Copy to clipboard
- 如果需要 ModemManager，可以在刷写完成后重新启动它。
- 确保设备处于 EDL 模式。更多详细信息，可参见 [EDL 模式](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#move-to-edl-mac)。
- 要刷写镜像，请运行以下命令：
>
>
> cd /target/qcs6490-rb3gen2-core-kit/qcom-multimedia-image
> Copy to clipboard
Note
将 `` 替换为提取的 `qcom-6.6.52-QLI.1.3-Ver.1.1_qim-product-sdk-1.1.2.zip` 文件路径。
>
>
> /qdl_2.1.1/QDL_Linux_x64/qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml
> Copy to clipboard
Note
在当前发布版本中，如果您在 QDL 刷写期间看到 **no boot partition found** 消息，您可以忽略它并继续执行该步骤。
刷写操作成功后，运行 `lsusb` 命令，在终端窗口中查看设备信息，如下第 4 行所示：
>
>
> # Sample output for QCS6490
>
>
> Bus 002 Device 003: ID 05c6:9135 Qualcomm, Inc. qcs6490-rb3gen2-vision-kit
>
>
> Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
>
>
> Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Note
如果刷写失败，请执行以下操作并重试刷写过程：
1. 关闭设备。
2. 断开设备与主机的连接。
3. 重新启动主机。
Note
- 对于机器视觉套件，可将刷写命令中的所有 `qcs6490-rb3gen2-core-kit` 替换为 `qcs6490-rb3gen2-vision-kit`。
- `rawprogram*.xml` 和 `patch*.xml` 是通配符表示法，将匹配指定目录中以 `patch` 和 `rawprogram` 开头的所有文件。
Note
- 成功完成刷写过程后，设备将重新启动。
- 更新 USB 和以太网控制器固件，请参阅[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
- 要验证更新的软件版本，请参阅[检查 Qualcomm Linux 版本](https://docs.qualcomm.com/doc/80-70017-253Y/topic/set_up_the_device.html#version-mac)。
- 对于 UART 连接，确认检测到的 UART 端口是否与之前配置的端口匹配。
### 获取设备 IP 地址
您可以使用以下任一方法获取 RB3 Gen 2 设备的 IP 地址。
#### 使用以太网
1. 将以太网线的一端插入 RB3 Gen 2 设备的以太网端口（RJ45），并将另一端连接到网络路由器。
2. 连接建立成功后，在 UART 串行控制台执行以下命令获取 IP 地址：
ifconfig eth2
Copy to clipboard
Note
如果在建立连接时遇到问题，参见[更新 USB 和以太网控制器固件](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#concept-bzk-yb1-rbc)。
#### 使用 Wi-Fi
Wi-Fi 在 Station 模式下运行。Wi-Fi host 驱动程序和网络管理身份验证在设备启动期间初始化。用户可以使用 **nmcli** 命令行工具建立无线连接。
1. 要连接到无线接入点（Wi-Fi 路由器），请运行以下命令：
>
>
> nmcli dev wifi connect password
> Copy to clipboard
>
>
> **示例**
>
>
> root@qcs6490-rb3gen2-vision-kit:~# nmcli dev wifi connect QualcommWiFi password 1234567890
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘d7b990bd-3b77-4b13-b239-b706553abaf8’.
2. 要检查连接和设备状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 要检查 WLAN 连接状态和 IP 地址，请运行以下命令：
>
>
> ifconfig wlan0
> Copy to clipboard
>
> 
4. 为了确保连接处于活动状态，请对 Google 等网站执行 ping 操作：
>
>
> ping google.com
> Copy to clipboard
**切换网络**
>
>
> 如果您已连接到某个网络并需要重新连接至另一个网络，请执行以下操作：
1. 要断开当前网络，请运行以下命令：
>
>
> nmcli c down QualcommWiFi
> Copy to clipboard
>
>
> Connection ‘QualcommWiFi’ successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)
2. 要检查断开连接状态，请运行以下命令：
>
>
> nmcli -p device
> Copy to clipboard
>
> 
3. 要连接到不同的 Wi-Fi 网络，请运行以下命令：
>
>
> nmcli dev wifi connect QualcommAP password XXXXXXXXX
> Copy to clipboard
>
>
> Device ‘wlan0’ successfully activated with ‘6159ac7c-58c2-44fa-938f-45dcb544fac3’.
### 连接到 SSH
确保在连接到 SSH 之前已建立网络连接。
1. 如需根据网络连接类型查找 RB3 Gen 2 设备的 IP 地址，可在 UART 控制台中运行相应的命令：
对于以太网：
ifconfig eth2
Copy to clipboard
对于 Wi-Fi：
ifconfig wlan0
Copy to clipboard
2. 从远程主机运行以下命令，与设备建立 SSH 连接。使用通过**步骤 1** 获得的 IP 地址。
ssh root@ip-address
Copy to clipboard
**示例**
`ssh root@192.168.0.222`
3. 要连接 SSH shell，可输入以下密码：
oelinux123
Copy to clipboard
Note
确保远程主机连接到与设备相同的 Wi-Fi 接入点。
Note
有关创建非 root 用户帐户的过程，参见[创建非 root 用户帐户](https://docs.qualcomm.com/doc/80-70017-253Y/topic/additional_setup.html#non-root-acc)。
### 连接 HDMI 显示屏
如需启用 HDMI 显示屏并查看示例程序的输出，可将 HDMI 线的一端连接到 RB3 Gen 2 设备上的 HDMI 端口，将另一端连接到显示屏。
确保设备已开机并检查 HDMI 显示屏。显示屏上应显示一个特定的图案。
如果显示界面未按预期显示出来，可将 **DIP\_SW\_0** 的 **Switch 4** 切换至 OFF。有关更多信息，参见 [DIP 开关](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-251/rb3_dip_switches.html)。
如果问题仍然存在，请参阅 [HDMI 故障排除](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-18/debug.html#hdmi-troubleshooting)来解决问题。
Note
当前版本不提供将 RB3 Gen 2 设备用作单板计算机的选项。
### 运行示例应用程序
现在可以开始运行[示例应用程序](https://docs.qualcomm.com/doc/80-70017-253Y/topic/demo_app.html#task-ccx-b24-k1c)。
Last Published: Oct 21, 2025
[Previous Topic
入门指南](https://docs.qualcomm.com/bundle/publicresource/80-70017-253Y/topics/getting_started.md) [Next Topic
示例应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70017-253Y/topics/demo_app.md)