4. 快速使用¶

本章讲述 CAM-C1126S2U/CAM-C1109S2U 配套使用虹软 ArcSoft 人脸识别算法 demo 示例软件的使用方法，不包含具体应用开发。

4.1. 供电说明¶

由于 CAM-C1126S2U 设备内置了高功率 IR 红外补光灯。CAM-C1126S2U 必须接入主机主板出来的机箱后置的 USB 3.0 的接口。如果使用主机机箱前置的 USB 2.0 或者 USB 3.0 接口，可能会出现设备供电不足的情况。另外笔记本的 USB 接口也可能会出现供电不足的情况。在这种供电电流不足情况下，设备可能会一直重启或者断开与上位机的连接。

不同应用场景的供电解决办法：

如果是 Facial_Gate 的应用场景，不需要通过 usb 与上位机进行数据通信的情况下。可以使用较大功率的电源给设备供电。如使用 5V 2A 或者 5V 3A 的电源适配器给设备供电。
如果是需要通过 usb 与上位机进行数据通信的情况，则使用可以外接电源的 usb hub 来给 CAM-C1126S2U 设备电源供电。

4.2. 应用场景介绍¶

虹软 ArcSoft 人脸识别算法套件 demo 示例软件分为两类：

Facial_Gate （人脸识别闸机）应用场景。该应用场景的工作原理是 CAM-C1126CS2U/CAM-C1109S2U 从摄像头获取视频帧数据，在本地进行 AI 人脸识别算法推理，将推理结果与本地数据库预留的人脸图片进行比对。然后将识别结果呈现到 MIPI 屏幕上。
AI_UVC （AI UVC摄像头）应用场景。该应用场景的工作原理是从将 CAM-C1126CS2U/CAM-C1109S2U 当作 UVC 摄像头，并通过 USB RNDIS 协议将 USB 接口模拟成一个网卡设备，这样上位机与 CAM-C1126CS2U/CAM-C1109S2U 就可以使用网络协议进行通信，如 socket 通信。 CAM-C1126CS2U/CAM-C1109S2U 从摄像头获取到视频帧数据，在本地进行 AI 人脸识别算法推理，将推理结果通过 usb 网卡传输到上位机。由上位机对推理结果处理，并且通过屏幕显示的方式呈现识别结果。该应用场景无需接入 MIPI 屏幕。

重要说明：

虹软 ArcSoft 提供的 Facial_Gate 和 AI UVC 的软件均为演示示例 demo ，没有源代码，也没有虹软对应的技术支持。它是用来展示虹软人脸识别算法的。并不能用作商用。由于是演示实例 demo 软件，所以可能存在一些 bug 。如果在使用 demo 的过程中遇到一些 bug ，如 ArcAICamera 上位机可能会出现：插入人脸数据库失败的问题。请尝试重新烧写固件再重新操作验证，中间最好不要出现操作错误，以防触发演示示例软件 bug 。
虹软 ArcSoft 提供人脸识别算法的底层 API 技术支持。
CAM-C1126S2U 设备出厂固件为 AI_UVC 固件。
如果使用时遇到问题请先尝试更新固件。如：修复了部分 Windows 系统RNDIS网卡无法识别或者出现黄色感叹号问题，如果设备出现此现象可以先尝试更新固件。

4.3. Facial_Gate 固件¶

首次使用需要接入上位机进行部署调试，请参考方式一。上位机完成部署后，可使用方式二进行设备使用。 Facial_Gate 应用场景需要接入 MIPI 屏幕使用。

方式一：上位机部署调试步骤：

设备接入 MIPI 屏幕。MIPI 屏幕的连接方法请参考：《Display使用》。
设备接上上位机主板出来的USB 3.0接口，使用 TYPE-C 线供电开机。
上位机搜索到 ADB 设备则代表设备已经正常开机。
开机后 Windows 主机会识别到一张 USB 网卡，设置该网卡静态 IP 地址属性如下：
- IP 地址：172.16.110.5
- 子网掩码： 255.255.255.0
- 网关： 172.16.110.1
- 首选 DNS ：8.8.8.8
打开浏览器地址栏输入172.16.110.2可进入 Web 后端管理平台。PS：如果驱动网卡设备不正常可以使用驱动精灵等第三方驱动安装工具安装或者更新驱动。
首次使用 Web 后端管理平台需要设置登录密码：
登录后，选择设备激活。激活码请联系业务购买。
激活设备后在 Web 后端管理平台上点击：[人员管理–>人员注册] 来进行人脸注册操作。进行人脸注册操作。
完成人脸注册后，人脸面对摄像头，可以看到 MIPI 屏幕输出人脸识别结果。

方式二：不接入上位机使用步骤：

设备接入 MIPI 屏幕。MIPI 屏幕的连接方法请参考：《Display使用》。
将 TYPE-C 单独接到 5V/2A 的电源。
人脸面对摄像头，可以看到 MIPI 屏幕输出人脸识别结果。

说明：

设备外接了 MIPI 屏幕会先看到 Firefly 的开机 logo，稍等片刻界面进入预置的闸机应用，如果闸机应用未授权，会显示未授权或授权失败无法进行人脸识别。

_images/authorization.png

4.4. AI_UVC 固件¶

AI_UVC 根据使用平台不同，需要安装不同的上位机 APP 工具。虹软提供了 Windows 上位机 APP 工具和 Android 上位机 APP 工具，没有提供 Linux 上位机 APP 工具。

ArcAICameraSetup.exe、Android APK和使用说明都可以在此仓库下载获取：

https://gitlab.com/firefly-linux/external/arcuvc_app.git

4.4.1. Windows¶

官方测试使用 Windows10 系统。测试步骤如下：

点击下载 Windows 上位机工具：ArcAICameraSetup 。
CAM-C1126S2U 接入 Windows 主机主板出来的机箱后置USB 3.0接口。
正常开机后红外补光灯会亮起。
正常开机后 Windows 主机会识别到一张 USB RNDIS 网卡。Windows 主机设置该网卡静态 IP 地址属性如下：
- IP 地址：172.16.110.5
- 子网掩码： 255.255.255.0
- 网关： 172.16.110.1
- 首选 DNS ：8.8.8.8
设置完成可以和 CAM-C1126S2U 设备进行网络通讯。PS：如果驱动网卡设备不正常可以使用驱动精灵等第 3 方驱动安装工具安装或者更新驱动。
安装 Windows 上位机工具ArcAICameraSetup.exe并打开，按提示进行授权后可以使用内置 AI_UVC 应用。PS：请联系业务购买授权码。
设置界面，点击右上角按钮可以进入人脸注册：
识别成功，注册成功后可以回到预览页面查看效果：
识别记录，识别到人脸后会记录在后台：

4.4.2. Android¶

官方测试使用 RK3399 Andorid 7.1。测试步骤如下：

点击下载 Android 上位机 APP 工具：Android APK 。
接上 Android 设备的 USB 3.0接口。
正常开机后红外补光灯会亮起。
下载安装ArcSoft_AICamera_xxx.apk并且打开应用,按提示进行授权后可以使用内置 AI_UVC 应用。PS：请联系业务购买授权码。
授权，获取设备信息并且联系我们根据设备信息生成离线授权文件：
预览，授权成功后回到预览画面可以看到人脸识别功能已经被激活：
设置，点击预览界面右上方齿轮可以进入设置界面，默认管理员密码为 123456 ：
更换自己公司的logo和公司名：
根据自己的需求配置自己的识别参数：
点击右上角人脸注册注册自己第一张人脸：
注册成功后，回到预览界面查看效果：
可以进入设置浏览识别成功和失败记录：

4.5. 应用授权¶

无论使用Windows还是Android进行激活，都会进入到类似以下界面。请点击采集设备信息把提示生成的文件拷贝出来并且保存。并且把该文件发送给业务然后联系业务购买授权。业务会提供对应的设备离线激活文件，您可以使用该文件激活设备。

重要说明：

对于需要使用虹软人脸识别算法底层 API 的客户。请跟业务索要激活授权的：APP_ID 、SDK_KEY 和 ACTIVE_KEY 信息。
激活文件和设备是一一对应的，获取到激活文件后请务必保存好。
正常升级官方固件后可以使用对应激活文件重新激活。
激活设备后绝对不可以进行擦除或者其他修改 backup 分区的操作，否则需要重新购买授权激活。

_images/androi_activation.png

4.6. 设备调试¶

CAM-C1126S2U/CAM-C1109S2U 设备可以使用TYPE-C OTG 线缆和串口进行设备调试。

4.6.1. USB 线缆调试¶

4.6.1.1. 硬件接线¶

准备一条 TYPE-C 线。TYPE-C 线一端接电脑的 USB 口，另一端接 USB OTG 调试接口。接线如下图：
基于你的系统安装 ADB。

4.6.1.2. Windows 下的 ADB 安装：¶

Windows版本下载链接：https://dl.google.com/android/repository/platform-tools-latest-windows.zip

解压 platform-tools-latest-windows.zip 到自定义目录
按键 windows + r 打开运行，输入 sysdm.cpl ，回车。高级–>环境变量–>系统变量–>双击 Path –>新建
例：设置如下图所示：
注：路径需要改成你解压的自定义目录

以管理员权限打开命令提示符，此时电脑 USB 接口连接了 RV1126 的 USB 调试口。命令提示符终端输入 adb devices

C:\Users\lvsx>adb devices
* daemon not running; starting now at tcp:5037
* daemon started successfully
List of devices attached
d70a14329414b400        device

使用 ADB 进行调试。
```
adb shell
```

4.6.1.3. Ubuntu 下的 ADB 安装¶

apt-get 安装 android-tools-adb 包

sudo apt-get update
sudo apt-get install android-tools-adb

验证安装：

lvsx@lvsx:~$ adb devices
* daemon not running; starting now at tcp:5037
* daemon started successfully
List of devices attached
d70a14329414b400	device

使用 ADB 进入设备调试。
```
adb shell
```
使用 ADB 拷贝 linux pc 文件到 rv1126 设备的 userdata 目录。
```
adb push /path/to/your-file /userdata/
```
使用 ADB 拷贝 rv1126 设备文件到 pc 本地目录。rv1126-file 更换为实际的文件名称。
```
adb pull /path/to/rv1126-file ./
```

4.6.2. 网口调试¶

CAM-C1126S2U 设备需要设置静态 IP 地址来进行网口调试。该调试方法需要建立在用户手动设置静态 IP 之后才能进行。

注意：AI_UVC 固件默认没有打开用于 SSH 登录终端的服务。只能使用 ADB 和串口调试。如果需要 SSH 登录终端的服务，需要在 buildroot 配置里面进行打开。

4.6.2.1. 网络 ADB 调试¶

设备接入 TYPE-C 接口
连接设备网络 ADB。假设 CAM-C1126S2U 设备设置的静态 IP 地址为：172.16.110.5 。则执行以下命令进行连接：
```
adb connect 172.16.110.5
```
使用 ADB 进行调试。
```
adb shell
```

4.6.2.2. ssh 调试¶

ssh 登录到开发板进行调试。
2021 年 9 月份之前版本的固件默认账户为：root，默认密码为：rockchip。
2021 年 9 月份之后版本的固件默认账户为：root，默认密码为：firefly。
假设 CAM-C1126S2U 设备设置的静态 IP 地址为：172.16.110.5 。则执行以下命令进行连接：
```
ssh root@172.16.110.5
```
Debian10 系统连接方式如下。默认账户为：firefly，默认密码为：firefly。
```
ssh firefly@172.16.110.5
```

4.6.3. 串口调试¶

准备 USB 转串口模块，推荐使用 Firefly 的串口模块。
USB 串口模块连接主机 USB 口和设备串口。
设置波特率为 1.5 M 。
根据你的系统下载、安装、打开系统平台支持的串口调试工具（Ubuntu 推荐使用 minicom，Window 推荐使用 putty ）。如果有串口调试工具有软硬件流控的配置项请关闭该功能。
串口接线说明：如下图从上往下依次是 RX, TX, GND。