下载与安装 RVS

RVS-WIN-CPU/GPU 版本软件安装

WINDOWS 版本硬件配置要求

要求 配置
CPU I3 6300 双核 4 线程
GPU CPU 版本：任意桌面级 NVIDIA 显卡
GPU 版本：NVIDIA GTX 1060 及以上
内存 最低：8G
推荐：16G
硬盘 128G 空闲
系统 Windows11 及以上

安装RVS软件

RVS CPU 与 GPU 版本安装方式完全相同，下文以 CPU 版为例介绍如何安装 RVS。

安装步骤如下：

  1. 在图漾官网>开发者社区>RVS开发者社区>下载链接，下载 RVS 软件压缩包。

  2. 解压压缩包。

    • CPU 版压缩包名：RobotVisionSuite_XXX_ WinCPU.zip

    • GPU 版压缩包名：RobotVisionSuite_XXX_ WinGPU.zip

  3. 得到安装文件。

    • CPU 版文件名：RobotVisionSuite_XXX_WinCPU.exe

    • GPU 版文件名：RobotVisionSuite_XXX_WinGPU.exe

  4. 双击 exe，启动安装程序。

    说明：假如跳出弹窗 “用户账户控制” ，请选择 `是`。

    p1_2_2

  5. 选择安装语言，推荐使用“简体中文”，点击确定。

    p1_2_3

  6. 浏览 “RobotVisionSuite 软件授权使用协议”，点击下一步。

    p1_2_4

  7. 选择安装位置。

    注意：路径不要有中文，不推荐安装C盘。如果不得不装 C 盘，后续使用请记得设管理员权限。

    p1_2_5

  8. 推荐选择创建桌面快捷方式，该快捷方式包含 RvsRuntime 目录，后续做项目方便。

    p1_2_7

  9. 点击安装。

    p1_2_8

首次运行RVS软件

安装图漾相机驱动

首次使用图漾 USB 相机，需安装 USB 驱动。

  1. 右击RVS桌面快捷方式，选择打开文件所在的位置。

    p1_3_1

  2. 在 “{安装目录}\RvsResources\tyCamDriverx64” 目录下找到“cyusb3.inf”文件，并安装。

    p1_3_11

给予软件管理员权限

软件安装在 C 盘或其他管理员权限盘符的用户必做此步骤，其他用户可酌情跳过。

快捷方式上右键->属性->快捷方式->高级->勾选“用管理员方式运行”

p1_3_2

运行并激活（申请版许可证）

  1. 双击快捷方式，首次启动RVS。在启动动画结束后，会出现以下提示 。

    p1_3_3

  2. 点击 “OK”，在许可证对话框点击 “Copy”，复制机器码。

    p1_3_32

  3. 将机器码邮件发送至 Info@percipio.xyz 或联系图漾销售人员，邮件内容包括但不仅限于，主题为RVS授权，内容为用户或贵公司信息，附件请上传包含该机器码的txt文件 。后续会通过 rvs-support@percipio.xyz 邮箱发送授权码和常用 Q&A 文件到客户指定邮箱。

收到的激活文件是一个license.txt，或者是一段字符串，自行保存为 license.txt，请将这个 txt 文件拷贝到 RVS 安装目录下的 License 目录下。

注意：若激活失败，请检查是否因 Windows 系统默认隐藏文件后缀名，常见的错误是将文件后缀名写成了两个后缀，例如将 license.txt 文件的后缀名错误地写成了 license.txt.txt。

操作步骤：

  1. 桌面快捷方式鼠标右键 → 打开文件所在的位置→ 找到 license 文件夹

  2. 将 license.txt 文件拷贝至 License 目录下。

    注意：在 Windows 系统默认隐藏文件后缀名时，常见的错误是将文件后缀名写成了两个后缀，例如将 license.txt 文件的后缀名错误地写成了 license.txt.txt。

    image-20230713161953575

至此即可完成 RVS 激活，重新双击桌面快捷方式启动即可。

试用版许可证

试用版 License 无需申请，直接至 RVS 开发者社区→ 试用License下载下载。

点击链接后弹出一段字符串，自行保存为 license.txt，请将这个 txt 文件拷贝到 RVS 安装目录下的 License 目录下。

操作步骤与申请版本许可证一致。

常见问题

软件启动后白屏（软件界面全白）

现象：双击启动软件后，弹出软件界面始终为不可点击的白色，控制台如下显示：

p1_4_1

解决方案：该问题一般由于笔记本电脑未启用显卡导致（因未接入电源或非高性能模式或设置默认不启用显卡等原因导致）。

操作步骤：打开 Windows11 设置→系统 → 屏幕 →显示卡 → 应用的自定义选项 → 添加应用（或浏览），找到 RobotVisionSuite.exe，然后对这款选择使用独显。

对于没有 NVIDIA 显卡的设备，本软件暂不考虑兼容。

激活生成机器码时闪退

检查电脑网卡设置，是否有未启用或者状态错误的虚拟网卡。

无法保存工程数据图片和日志

检查软件安装路径或保存路径是否为 C 盘等需要管理员权限的地址，参照本文 给予软件管理员权限章节或重新安装此软件到其他盘符。

找不到XXX.dll

检查环境变量，看 path 条目下是否存在 “{RVS安装路径}\RvsResources\bin” ，如果没有，手动将此目录加入到 path 中。

终端打印 Error: Error=XML_ERROR_FILE_NOT_FOUND

检查环境变量，看是否有条目 RVS_ROOT ，值为 RVS 安装目录。如果没有，手动添加进去。

在线更新

注意：RVS 1.3.239 以上版本才可进行在线更新。

操作步骤：

  1. 打开命令行窗口并进入 RVS 安装路径或在 RVS 安装路径下打开命令行窗口。

  2. 查看使用帮助。

    RVSUpdateTool.exe -h

  3. 检查更新。

    RVSUpdateTool.exe check

  4. 执行更新。

    RVSUpdateTool.exe update

  5. 从备份副本中回退。

    RVSUpdateTool.exe fallback

    第7张

开机自启

支持 win10/win11系统下面的 RVS 开机自启，并能一直监视程序是否退出，如果程序退出，会再次自动启动软件。

至下载链接中下载自启动脚本。下载后解压缩文件夹内容如下：

1

  • start.bat：启动 RVS 开机自启脚本。

  • stop.bat：停止 RVS 开机自启脚本。

操作步骤：

  1. 打开 start.bat 脚本文件。

    @echo off

:Excute
cd D:/RobotVisionSuite/runtime/   
start ../RobotVisionSuite.exe -l unstacking.xml -r

:Protect
ping 127.0.0.1 -n 10
for /f "delims= " %%i in ('tasklist^|find /i "RobotVisionSuite.exe"') do (
 if /i "%%i"=="RobotVisionSuite.exe" goto Protect)

goto Excute

    • 此处为 RVS 安装路径，按照实际安装路径进行修改。

      cd D:/RobotVisionSuite/runtime/

    • 若路径中包含空格，需要使用双引号将目录路径括起来，如：

      cd "D:/Program Files(x86)/RobotVisionSuite/runtime/"

    • 此处为运行 RobotVisionSuite.exe，并打开 runtime 目录下指定的工程文件。

      start ../RobotVisionSuite.exe -l unstacking.xml -r

    • 默认为打开 runtime 目录下，若为别的目录，可修改相对路径，如：

      start ../RobotVisionSuite.exe -l ./runtime/unstacking.xml -r

  2. 将 start.bat脚本文件放到 RobotVisionSuite.exe 程序的同级运行目录下，并右键创建生成快捷方式文件start.bat - 快捷方式。

    image-20231204163139849

  3. 将start.bat - 快捷方式文件放到 windows 的启动目录下。

    • win+R 快捷键进入运行，输入 shell:startup 后确定，进入 windows 启动目录。

      image-20231204163455326

    • 将start.bat - 快捷方式文件放到启动目录。

      image-20231204163542423

  4. 重启电脑，观察 RobotVisionSuite.exe 是否开机成功自启动，可手动退出程序 RVS 界面，测试程序是否会重新自启动。

  5. 双击 stop.bat 脚本便可停止软件启动。 2

卸载 RVS

要卸载 RVS，可以选择以下两种方法之一：

方法一：直接删除 RVS 的安装文件夹，彻底清除 RVS 的所有文件，无需其他操作。

方法二：

  1. 在 RVS 的安装文件夹中，双击 unins000.exe 文件，此方法会保留用户创建的内容，如 license 和 runtime。

    image-20231227172618208

  2. 弹出“用户账户控制”，选择是。

    image-20231227172658524

  3. 弹出“RobotVisionSuite 卸载”，选择是。

    image-20231227172753298

  4. 正在卸载 RobotVisionSuite。

    image-20231227172734414

  5. 完成卸载。

    image-20231227172814234

RVS-Ubuntu-GPU 版本安装

GPU 版本软件安装配置

CPU I7 6700 4核 8 线程以上
GPU 最低：NVIDIA GTX1050 （AI 模块仅可推理，无法训练）
推荐：NVIDIA GTX1060 （全部功能）
要求 配置
内存 最低：8G
推荐：16G
硬盘 128G 空闲
系统 Ubuntu 20.04 STL

更新 NVIDIA 驱动

安装方法一

  1. 打开系统菜单栏，选择软件和更新 → 附加驱动。

  2. 选择 470 及以上版本的驱动并点击 应用更改。

  3. 等待安装结束后，重启电脑。

    p211

安装方法二

  1. 保持 Ubuntu 20.04 原生系统的国内源不变。

  2. 更新源列表。

    sudo apt-get update  

  3. 添加nvidia显卡驱动专用源。

    sudo add-apt-repository ppa:graphics-drivers/ppa

  4. 更新下载源。

    sudo apt-get update

  5. 列出当前系统的显卡驱动信息和可安装的驱动。

    ubuntu-drivers devices

  6. 选择 470 及以上版本的驱动，推荐 nvidia-driver-470 - distro non-free recommended。

    sudo apt-get install nvidia-470

  7. 安装完重启，会覆盖原驱动，所以无需手动屏蔽旧驱动。

    sudo reboot

  8. 重启后查看一下显卡信息：nvidia-smi，如果有正常的显卡信息输出，则安装成功，如下图:

    p222

注意：无法进入系统问题

如果是双系统，重启后有可能会导致黑屏或无法进入ubuntu系统，导致这一问题的有以下两个原因。

原因 1：新显卡驱动没有被 ubuntu 加载

解决办法： 开机进入 grub 选择界面后按 “e” ,进入引导脚本编辑模式，在 quiet splash 之后添加 acpi_osi=linux nomodeset ，用以告诉内核即将启动 linux，接下来加载 linux 相关驱动程序。如此，即可匹配到新安装的 nvidia 驱动，nomodeset 意思是告诉内核不要加载显卡而用 BIOS 模式直到图形界面运行为止，该配置项在开机后需要添加到 /boot/grub/grub.cfg 中。

原因 2：电脑不支持上述安装方式安装显卡

解决办法：通过去官网下载英伟达闭源驱动包 .deb 进行手动安装，安装后会屏蔽 ubuntu 自带驱动，无需手动屏蔽。

安装RVS软件

  1. 下载RVS软件包，文件名：RobotVisionSuite-XX-GPU.run。本案例使用 RobotVisionSuite-1.5-GPU.run。

  2. 给用户给予软件包可执行权限:

​ 方法一 ：右键软件包，选择 Properties (属性)，在 Permissions (权限) 内容中，将 Execute（执行） 后内方框打钩即可。

p231

​ 方法二 ：打开终端，输入命令。

chmod a+x RobotVisionSuite-XXX-GPU.run (注意路径)

p232

  1. 直接双击安装包进行安装，或在终端输入： ./RobotVisionSuite-XXX-GPU.run(注意路径)。点击Next。

    p233

  2. 默认安装目录为 ~/rvs-installed ，点击Next。

    p234

  3. 选择安装的组件，一般为全选，选择Select All，点击Next。

    p235

  4. 许可证书，选择同意(I accept the license)，点击Next。

    p236

  5. 开始安装，点击 install 。

    p237

  6. 如果在安装过程中如果弹出Installer Error的弹窗，Ignore(忽略)即可.

    p238

  7. 此处需要用户密码。

    p239

  8. 等待安装结束，点击 Finish。

p2310

启动RVS

初次运行 RVS

  1. 脚本启动RVS：打开终端，首先进入 RVS 安装目录的 script 下:

    cd ~/rvs-installed/script/

  2. 启动软件:

    ./rvs_start.sh

    p241

  3. 如果界面正常启动，则可跳过该步骤，如若无法正常启动界面，如提示库缺少，如 error while loading shared libraries:XXX:cannot open shared object file，则需要补充 RVS 环境依赖。

    仍然在 RVS 安装目录的 script 下，执行 rvs_pre_install.sh。输入命令如下。

    sudo ./rvs_pre_install.sh

    p242

  4. 在界面正常启动的情况下，会弹出需要激活文件的弹窗，点击 OK。

    p243

  5. 随后会弹出 许可证 窗口，用来激活软件。

    p244

获得软件激活（申请版许可证）

点击 复制 这串机器码，发送邮件到 Info@percipio.xyz 或联系图漾销售人员，邮件内容包括但不仅限于，主题为 RVS 授权，内容为用户或贵公司信息，附件请上传包含机器码的 txt 文件。后续会通过 rvs-support@percipio.xyz 邮箱发送授权码和常用 Q&A 文件到客户指定邮箱。

激活文件名为 license.txt，请将这个 txt 文件拷贝到 RVS 安装目录下的 Licenses 下 (~/rvs-installed/License)，即可完成RVS激活。

p245

获得软件激活（试用版许可证）

试用版 License 无需申请，直接至 RVS 开发者社区→ 试用License下载下载。

点击链接后弹出一段字符串，自行保存为 license.txt，请将这个 txt 文件拷贝到 RVS 安装目录下的 License 目录下。

操作步骤与申请版本许可证一致。

图标运行 RVS

在激活后，启动方式仍为脚本启动： 脚本启动RVS：打开终端，首先进入 RVS 安装目录的 script 下。

cd ~/rvs-installed/script/

启动软件：

./rvs_start.sh

或者您可以使用图标快速进入RVS软件：

当第一次使用脚本启动后，找到 dock 栏中RVS 软件图标，右键图标选择 Add to Favorites 即可固定在dock 栏。

RVS-GPU 版本的 docker 镜像安装

RVS 的 docker 镜像适用于需编译 node 的工作环境，但仍然可以将已经编译好的 .So 动态链接库手动添加 RVS 安装目录下的 rvs_sdk/build/lib（若没有需手动创建），这样没有安装镜像的设备也可以使用已经编译好的动态库。

安装docker

下载 dockerInstall 安装脚本，文件名为 dockerInstall.sh。

./dockerInstall.sh

测试 docker 是否安装成功。

sudo docker run --rm --gpus all nvidia/cuda:11.0.3-base-ubuntu20.04 nvidia-smi

p251

如果有类似上面表格样式的输出信息，证明成功。如果没装cuda11.0，这一步会自动安装，等待即可。

p252

Ubuntu 添加用户到 docker 组用户，免 sudo 运行

方法一：直接执行 docker 命令会遇到权限问题， 原因是 /var/run/docker.sock 文件，除 root 用户，只有 docker 组用户才可读写。

  1. 查看全部组用户。

    cat /etc/group

  2. 将当前用户加入到 docker 组。

    sudo gpasswd -a 用户名 docker

  3. 然后 logout 当前用户，重新登录，或者重启，之后 cat /etc/group 如下图。

    p253

方法二：如果 /etc/group/ 不存在 docker，使用下面方法将用户添加到 docker 用户组就无需 sudo 权限。

  1. 首先创建用户组。

    sudo groupadd docker

  2. 将用户加入组。

    sudo gpasswd -a${USER}docker

  3. 重启服务。

    sudo service docker restart

  4. 切换当前会话到新组。

    newgrp - docker

docker 加载镜像

下载 rvs-runtime-x.x.x.tar.gz 安装包，解压后文件名为 rvs-runtime-x.x.x.tar。

在解压后的目录下输入：

docker load -i rvs-runtime-x.x.x.tar

加载完以后通过命令 docker images 可查看当前已加载的镜像，如图：

p254

docker启动软件

  1. 脚本启动docker：打开终端。首先进入RVS安装目录下的script下：

    cd ~/rvs-installed/script/

    启动docker镜像：

    ./docker_run.sh

    进入到docker容器中：

    ./docker_exec.sh

    成功进入 docker 会显示为 root 用户。

    image-20230510145543513

  2. 启动RVS软件：在 docker 中输入 runtime 即可快速进入工程项目目录。

    runtime

    启动RVS

    RobotVisionSuite

    p256 当已经完成了RVS-GPU版本的激活，可以正常启动软件界面，但此时想进入RVS-GPU的docker环境中启动软件界面，却弹出对话框，“no license file exists!”，请您在已经进入docker的终端中输入以下命令：

    export RVS_LICENSE_DIR="/rvs/Licenses"

    一般来说，仅推荐在 docker 中编译，尽量不在 docker 中启动图形界面。

  3. 同时您也可以手动进入projects目录下，管理多个工程项目：

    cd /rvs/projects

    浏览当前文件夹下的多个项目

    ls

    image-20230510151203647

在线更新

注意：RVS 1.3.239 以上版本才可进行在线更新。

操作步骤：

  1. 进入 ./rvs-installed/script 目录下打开命令行窗口。

  2. 查看使用帮助。

    ./RVSUpdateTool -h

  3. 检查更新。

    ./RVSUpdateTool check

  4. 执行更新。

    ./RVSUpdateTool update

  5. 从备份副本中回退。

    ./RVSUpdateTool fallback

    7a089b4bcefca5ed93e3d6ff55d30bbe

卸载 RVS

直接删除 RVS 的安装文件夹，将彻底清除 RVS 的所有文件，无需其他操作。

注意：如果想要继续使用 RVS，请注意保留 license、projects 以及二次开发的内容。

RVS-Ubuntu-CPU 版本软件安装

CPU版本软件安装配置

要求 配置
CPU I3 6300 双核 4 线程
GPU 无需 GPU 或 GPU 低于 1050
内存 最低：8G
推荐：16G
硬盘 128G 空闲
系统 Ubuntu 20.04STL

安装 RVS 软件

CPU 与 GPU 版本安装方式完全相同，参照 RVS-Ubuntu-GPU 安装操作。

安装docker

下载 dockerInstall 安装脚本，文件名为 dockerInstall-cpu.sh。本章节除了测试 docker 是否安装成功与 GPU 有差异，其余如 docker 镜像安装、启动软件与 GPU 描述一致，本章节将不再赘述，请参考 RVS-Ubuntu-GPU 章节操作。

./dockerInstall-cpu.sh

测试docker是否安装成功：

docker run ubuntu:20.04 /bin/echo “Hello world”

p331

如果有类似上面表格样式的输出信息，证明成功。如果没装 ubuntu20.04 镜像，这一步会自动安装，等待即可。

p332

卸载 RVS

直接删除 RVS 的安装文件夹，将彻底清除 RVS 的所有文件，无需其他操作。

注意：如果想要继续使用 RVS，请注意保留 license、projects 以及二次开发的内容。