VMSS （Aupera 实现）— 视频机器学习流媒体服务器

1. Aupera 发布包只包含一个 docker 映像文件：xilinxpartners/aupera_general_vmss:v1.2
   
2. 一块支持 2 款 xcu30 设备的 U30 开发板。卫星控制器固件版本为 6.3.2 或更高。
   
3. 一块 U50LV 开发板
4. 一台 x86 Ubuntu 16.04/18.04 机器可将 U50LV 的一个 PCIe x16 和一个 PCIe x8 作为两个 x4 分叉点用于 U30，该文件会将这台计算机命名为“x86_host”
5. X86_Host 的英特网访问

1.在 X86_Host 准备必要的软件：

2.编辑 /etc/sysctl.conf，为转发 ip 启用 net.ipv4.ip_forward=1：

3.加载 docker 映像并进入 docker：

在这里， REPOSITORY:TAG 是存储库名称，例如：general_vmss:v1.0，可输入‘sudo docker images’命令获得； CONTAINER_NAME 是一个用户定义的容器名称，例如：test；而 NFS_ABS_PATH 则是 nfs 共享目录，也是 docker 容器的工作空间，我们将当前目录用作 nfs 目录。

下次 x86_host 重启时，该 shell 不需要执行，只需运行以下命令进入 docker 容器即可：

4.启动 nfs 服务并提取 nfs 文件（在 docker 中）：

然后将在 ${NFS_ABS_PATH} 中获得以下文件/目录：

├── BOOT_full_RC5_5.bin
├── EasyDarwin
├── U30
├── VMSS_APP
├── vmss_drivers.tar.gz
├── xrt_202010.2.6.655-amd64.deb
└── xu30-qspi-burn-58553330_10120113-2.9.3-build111.bin

注：每次 x86_host 重启时，都需要执行该 shell。

5.安装 VMSS 驱动（在 docker 外）：

6.确认 VMSS 驱动已加载（在 docker 外）

注：x86_host 重启时，VMSS 驱动程序将自动加载。

7.启动 MongoDB docker（如果不存在，请下载）

注：您必须通过修改 VMSS docker 容器中的 VMSS_APP/server/conf/plugin.cfg 文件来修改 mongo_url，以匹配主机 ip 地址。
注：每次 x86_host 重启时，都需要执行该步骤。

请联系我们时提供 form表。

1. 设置一个 Xilinx 应用商城帐户（https://appstore.xilinx.com/ -> -> 管理帐户）。
2. 从 Xilinx 应用商店申请 VMSS 产品的评估许可证。此外，该产品还可按浮动许可证或节点锁定许可证购买。
   
   请注意：每一款 U30 开发板都有 2 个设备，全面使用需要 2 个节点。
   
   
3. 至少要为您的帐户创建一个 cred.json 文件（访问密钥）(Manage Account -> Access Key -> Create an Access Key -> Download JSON)。 该文件在 FPGA 运行时为应用商店识别帐户，其必须放在 ${NFS_PATH}U30/drm/cred.json 目录下，其中 NFS_PATH 是指定的共享目录用户，用于 docker 与 x86_host 通信。

1. ${NFS_PATH}U30/drm/license_conf/nodelocked/conf.json 位置位于 docker 映像文件中的节点锁定许可证配置文件必须拷贝到 ${NFS_PATH}U30/drm/conf.json 中。
2. 要使用从应用商店购买的节点锁定许可证，U30 必须在运行时连接因特网，才能生成许可证文件。在第一次生成许可证文件后，它不仅可离线解锁 DRM 保护，而且只对为之生成的特定 FPGA DNA 有效。

1. 浮动许可证/免费试用配置文件为 license_conf/floating。${NFS_PATH}U30/drm/license_conf/floating/conf.json 位置位于 docker 映像文件中的浮动许可证配置文件必须拷贝到 ${NFS_PATH}U30/drm/conf.json 中。
2. 可立即使用从应用商店购买的浮动许可证。浮动许可证不能离线使用。

3.1.1 前提条件

• 一个 Aupera U30 固件 QSPI 闪存转储文件。固件文件命名为 xu30-qspi-burn.bin。
• 一款带两个 xcu30 设备的 U30 开发板。
• 一台 x86 Ubuntu 16.04/18.04 机器通过所安装的 Xilinx XRT-2.6.655（在该主机中运行“sudo dpkg -i xrt_202010.2.6.655-xxx.deb”）支持 PCIe×8 分叉点，xrt 软件包 v2.6.655 可通过{链接下载。 

3.1.2 U30 固件安装过程

1.获得 XRT 环境：

2.检查卫星控制器 (SC) 固件版本：

它将显示如下内容：

如果 SC 固件版本低于 6.3.2，请联系 Xilinx 或 Aupera 支持，升级 SC 固件

3.读取开发板的 PCIe 总线

它将显示如下内容：

BDF ID、07:00.1 和 08:00.1 是下一步使用的 card_id。一块 U30 开发板有两个 FPGA 器件（PCIe 端点）。

4.使用 XRT xbmgmt 实用程序闪存 U30 开发板

其中，card_id 是第 2 步读取的 ID，如 07:00.0，而 binfile 则是 Aupera 固件 QSPI 闪存转储文件的文件名。
它将显示如下过程：

完成后，用相同的闪存转储文件闪存第 2 步读取的第二个 card_id（如 07:00:1）。

4.下电和上电（冷重启）主机，以更新闪存的 FPGA 映像。

3.2.1 前提条件

• 一台安装了 Xilinx XRT-2.8.726 的 x86 Ubuntu 16.04/18.04 机器（在步骤 3.1.1 中运行“sudo apt remove xrt”，卸载 XRT 2.6.655，然后在主机中运行“sudo dpkg -i xrt_202020.2.8.726-xxx.deb”，安装 XRT 2.8.726），xrt 软件包 v2.6.655 可通过 链接下载
• 安装在 PCIe x16 插槽中的 U50LV 开发板
  

3.2.2 U50LV Shell 安装过程

1.获得 XRT 环境：

2.读取 U50LV 开发板的 PCIe 总线

屏幕将显示如下信息：

07:00.1 Processing accelerators: Xilinx Corporation Device 5061
BDF ID、07:00.1 是下一步使用的 card_id。U50LV 开发板只有 1 个 FPGA 器件（PCIe 端点）。

3.对于 U50LV 卡，DPUCAHX8H 使用的目标平台是 gen3x4 版本，而不是标准的 gen3x16 版本。请下载并安装所需的 gen3x4 目标平台文件。

CentOS/Redhat 7.4-7.7: Xilinx-u50lv-gen3x4-xdma-2-202010.1-2902115-noarch_rpm.tar.gz
Ubuntu 16.04: Xilinx-u50lv-gen3x4-xdma-2-202010.1-2902115-16.04_deb.tar.gz
Ubuntu 18.04: Xilinx-u50lv-gen3x4-xdma-2-202010.1-2902115-18.04_deb.tar.gz

4.使用 Alveo XRT xbmgmt 实用程序闪存 U50 开发板

其中，card_id 是第 2 步读取的 ID，如 07:00.0，而 firmware_file 则是文件名 xilinx_u50lv_gen3x4_xdma_base_2

5.冷重启主机，从闪存加载 FPGA 映像并验证是否检测到 FPGA 电路板。

更多 U50LV Shell 安装步骤，请参见 Xilinx github 文档。

1. 在安装了 U30 和 U50 开发板的 x86_host 中准备好 U30 和 U50LV 的固件和驱动。
2. 有一个 RTSP 流媒体来源（如摄像头），格式为：encode=h264/h265、resolution=1080p、fps=30、gop=3。
3. 从 IP 摄像头获取 RTSP URL，如"rtsp://admin:admin123@172.16.1.15:554"，作为输入，或将本地文件以所需格式或本地 mp4 文件形式传输至 RTSP 服务器。
   
   温馨提示：VMSS docker 包含一个 rtsp 传输工具，可用来将本地文件传输至 rtsp 服务器，步骤如下：
   请确保在 VMSS docker 中。
   进入 docker 中的 $NFS_ABS_PATH/EasyDarwin 目录。
   运行“nohup ./easydarwin -c easydarwin.xml -d 1>/dev/null 2>/dev/null &”，使用默认 rtsp 端口 554 启动 rtsp 服务器。
   稍等一会儿。
   使用 ffmpeg 传输本地文件，如“ffmpeg -stream_loop -1 -re -i test.mp4 -c copy -rtsp_transport tcp -f rtsp rtsp://localhost:554/vmss-in”。
   
   
4. VMSS docker 运行在 x86_host。(查看 1.2 步骤 3 和 4)
5. MongoDB docker 运行在 x86_host。(查看 1.2 步骤 7)

注：一个名为 cred.json 的证书文件和一个名为 conf.json 的配置文件必须放在 U30/drm 目录下。请参考本文档的第 2 部分，生成这些文件并将其复制到 U30/drm 中，以替换一个现有的示例文件，并确保这两款 U30 器件都可编程为正确的固件，然后执行以下命令：

如果这个步骤出现了一些 DRM 激活失败的错误消息，请检查 conf.json 和 cred.json 是否正确。如果该步骤长时间挂起，没有任何响应，常见原因如下：

• 检查 VMSS 驱动程序是否已准备就绪。如果缺少 VMMS 驱动程序（xocl 和 xdma），请重新安装，因为有时在系统更新时重启机器，可能会导致驱动程序加载不正确。 重新安装驱动程序后，请重启 VMSS docker 容器。
• 运行 U30 启动脚本前，nfs 服务未启动。nfs 服务可通过运行“root/nfs.sh”脚本启动。

如果启动脚本运行正确，最后应该会有以下消息：

1.进入 VMSS docker 容器：

2.运行 VMSS 服务器：

1.进入 VMSS docker 容器

2.启动 VMSS 客户端，打开一个会话：

3.关闭一个会话的命令：

4.关闭一个会话的命令：

如欲了解有关 vmss 客户端的使用详情，请在 VMSS_APP/client 目录下参阅 README.md。

1. 登录 MongoDB docker（在主机上）：

2.打开数据库 vmss_db：

3. 在数据库 vmss_db 中浏览结果：

其中“retail”是网络名， 5fc8b1306dedf93052684a49 是会话 id 字符串。该命令将显示指定会话的结果。

检查检测或分类结果。

1.登录 MongoDB docker（在主机上）：

2.打开数据库 vmss_db：

3.在数据库 vmss_db 中浏览结果：

其中“零售”是网络名，5fc8b1306dedf93052684a49 是会话 id 字符串。该命令将显示指定会话的结果。