DvsenseDriver  1.3.0
The SDK for dvsense products.
载入中...
搜索中...
未找到
DVSyncPro(融视 Pro)快速入门

语言:English

1. 认识融视 Pro

通过 USB 接入上位机时,融视 Pro和普通融合相机一致,可通过配套上位机软件或 SDK 获取、查看和处理融合数据。 日常采集操作与普通融视相机一致,无需先进入相机内部桌面。

Pro 还提供内部二次开发能力。用户可以通过浏览器访问相机的网页版桌面,在相机内部编写、调试和运行算法与程序,让相机承担本地数据处理任务。

2. 通过 USB 开始使用

  1. 在上位机安装配套的 DVSense Insight 软件或 DVSense SDK。
  2. 使用支持数据传输的 USB 线连接相机与上位机,等待相机启动及设备识别完成。
  3. 在上位机软件中选择相机并开始采集,即可查看 RGB 图像、DVS 事件及融合显示。程序开发可参考 SDK 的融合相机示例。

相机同时通过 USB 提供网络接口,系统中会出现一张 **USB 网卡**。这张网卡用于访问相机内部系统,也可以在开启网络共享后为相机提供外网连接。

访问内部桌面只需要上位机与相机网络互通;相机内部需要下载依赖、更新软件或访问外部服务时,才需要开启网络共享。

3. 访问相机内部桌面

初始网络与登录信息

项目 初始值
相机 USB 网口 IP 192.168.137.2
上位机 USB 网卡建议 IP 192.168.137.1
子网掩码 255.255.255.0(即 /24)
相机系统用户名 dvsyncpro
相机系统密码 dvsense
网页版桌面连接密码 dvsense
网页版桌面地址 http://192.168.137.2:6080/vnc.html

连接步骤

  1. 找到插入相机后新增的 USB 网卡;可通过拔插相机观察网卡列表变化来确认。
  2. 若尚未开启网络共享,将上位机这张 USB 网卡的 IPv4 地址手动设为 192.168.137.1,子网掩码设为 255.255.255.0。上位机 USB 网卡的默认网关和 DNS 留空,联网仍使用原来的 Wi-Fi 或有线网卡。
  3. 在上位机终端执行 ping 192.168.137.2,检查相机是否可达。
  4. 在上位机浏览器中打开 相机网页版桌面,点击“连接”(Connect),按提示输入桌面连接密码 dvsense。当前桌面以 dvsyncpro 用户运行;如系统操作要求密码,输入 dvsense。
  5. 进入桌面后,可打开终端或编辑器,在相机内部编写、调试和运行算法与程序。

网页版桌面服务随相机开机自动启动,无需手动启动。

访问地址使用 **HTTP**,端口为 **6080**,页面路径为 **/vnc.html**。当前配置在相机 USB 网口就绪后启动桌面服务,启动期间可稍后刷新页面。进入桌面后会看到终端窗口;关闭终端不会关闭桌面,可在桌面右键菜单中重新打开终端。

4. Windows 下开启网络共享

以下操作适用于提供“Internet 连接共享”选项的 Windows 10/11 环境。

  1. 先确认上位机已通过 Wi-Fi 或有线网络正常连接互联网,再通过 USB 连接相机。
  2. 按 Win + R,输入 ncpa.cpl 并回车,打开“网络连接”。
  3. 找到**当前能够上网的网卡**,例如 Wi-Fi;右键打开“属性”,进入“共享”选项卡。
  4. 勾选“允许其他网络用户通过此计算机的 Internet 连接来连接”。
  5. 在“家庭网络连接”列表中选择**相机对应的 USB 网卡**,点击“确定”。共享的来源是联网网卡,接收共享的是相机 USB 网卡。微软连接共享说明
  6. 查看相机 USB 网卡的 IPv4 配置,确认地址为 192.168.137.1、子网掩码为 255.255.255.0。Windows 共享通常使用该地址,实际以网卡配置为准;若地址不同,需要让相机地址与共享网卡处于同一网段,并对应调整相机网关。
  7. 在相机内部检查网关和 DNS,按第 6 节完成联网验证。

如果没有“共享”选项卡,需检查 Internet 连接共享(ICS)服务和系统管理策略是否允许共享。

5. Ubuntu 下开启网络共享

以下以使用 NetworkManager 的 Ubuntu 桌面版为例。先确保上位机可以正常上网,再为**相机 USB 网卡对应的连接**开启共享。

图形界面设置

  1. 打开“设置 → 网络”,找到相机对应的 USB 有线连接并打开其设置。
  2. 在“IPv4”页面,将方法改为“共享给其他计算机”(Shared to other computers)。
  3. 如果界面允许指定共享地址,将地址设为 192.168.137.1、子网掩码设为 255.255.255.0,网关留空;保存并重新启用该连接。
  4. 如果界面不能填写共享地址,使用下面的命令行设置。

必须核对共享网段: NetworkManager 未指定共享地址时,通常自动选择 10.42.x.0/24,与相机初始地址不在同一网段。本说明统一使用 192.168.137.1/24,便于保持相机初始 IP 不变。NetworkManager IPv4 说明

命令行设置

在 **Ubuntu 上位机**终端中查看连接名称及对应网卡:

nmcli -f NAME,DEVICE,TYPE connection show --active

确认相机 USB 网卡对应的连接名称,将下方的 相机USB连接名 替换为实际名称,然后执行:

sudo nmcli connection modify "相机USB连接名" \
ipv4.method shared \
ipv4.addresses 192.168.137.1/24 \
ipv4.gateway "" \
ipv4.dns "" \
ipv4.never-default yes
sudo nmcli connection up "相机USB连接名"

重新启用连接可能短暂中断网页版桌面,恢复后重新连接即可。共享模式由 NetworkManager 管理转发及相关网络服务,无需另行手动配置转发规则。

6. 相机端的联网设置与验证

上位机开启共享后,相机内部的 USB 网络连接还需要正确的默认网关和 DNS。进入相机网页版桌面,在网络设置中检查 USB 网络连接的 IPv4 参数;如果已配置正确,无需重复修改。

相机端参数 建议设置
IP 地址 192.168.137.2
子网掩码 255.255.255.0
默认网关 192.168.137.1(上位机 USB 网卡地址)
DNS 可使用网络允许访问的 DNS,例如 223.5.5.5;Ubuntu 共享也可使用 192.168.137.1

保存网络设置时,桌面连接可能短暂中断,稍后重新连接即可。

在**相机内部终端**依次执行:

ping -c 3 192.168.137.1
ping -c 3 223.5.5.5
getent hosts www.dvsense.com
  • 能访问 192.168.137.1:相机与上位机的 USB 网络连通。
  • 能访问外部 IP:外网转发可用;如果网络屏蔽 ping,可用浏览器访问网站进一步验证。
  • 能解析网站域名并打开网页:DNS 和外网访问正常。

7. 使用 WebRTC 观察 Sync Viewer 融合效果

相机内部提供 dvsense_dvsyncpro_webrtc_viewer 示例,可将同步后的 RGB 图像与 DVS 事件叠加结果通过 WebRTC 传到上位机浏览器。它与桌面版 Sync Viewer 使用相同的同步分组处理方式,适合直接观察融合效果。

默认的预编译 Sample 包不提供这个 WebRTC 示例,需要手动编译开发包附带的示例程序。 SDK 通过 apt 安装 deb 包,提供预编译库、公开头文件、CMake 配置和示例程序源码,不提供 SDK 内部实现源码。以下步骤在相机内部的 Ubuntu 终端执行,示例链接已安装的 SDK 库。

安装编译和运行依赖

先按前文开启网络共享,使相机可以访问软件源,并确认已配置适用于相机 Ubuntu 版本及 ARM64 架构的 DVSense apt 源。安装 SDK 开发包及依赖:

sudo apt update
sudo apt install libdvsensedriver-dev build-essential cmake pkg-config libopencv-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
libgstreamer-plugins-bad1.0-dev libsoup-3.0-dev libjson-glib-dev \
gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
gstreamer1.0-plugins-bad gstreamer1.0-nice

使用已安装的 SDK 单独编译

当前 deb 开发包将示例源码安装到 /usr/share/DvsenseDriver/Samples,其中 WebRTC 示例位于 /usr/share/DvsenseDriver/Samples/DvsenseDVSyncproWebRtcViewer。SDK 的 CMake 配置位于 /usr/share/cmake/DvsenseDriver,动态库位于 /usr/lib。将示例复制到用户目录,再进行编译:

cp -r /usr/share/DvsenseDriver/Samples/DvsenseDVSyncproWebRtcViewer \
~/dvsyncpro-webrtc-sample
cmake -S ~/dvsyncpro-webrtc-sample -B ~/dvsyncpro-webrtc-sample/build \
-DCMAKE_BUILD_TYPE=Release \
-DDvsenseDriver_DIR=/usr/share/cmake/DvsenseDriver
cmake --build ~/dvsyncpro-webrtc-sample/build \
--target dvsense_dvsyncpro_webrtc_viewer -j2

这会链接 deb 包提供的预编译 SDK 库,只编译 WebRTC 示例程序。无需安装 dvsense-driver-samples 预编译例程包。

若找不到示例目录,可用 dpkg -L libdvsensedriver-dev 查看已安装文件,并通过 sudo apt install --only-upgrade libdvsensedriver-dev 更新开发包。如果更新后仍不包含该目录,请联系技术支持获取包含此示例的开发包。

旧版开发包中的示例可能缺少独立 CMake 构建入口。若复制出的 CMakeLists.txt 开头缺少以下配置,可在原有内容之前补充:

cmake_minimum_required(VERSION 3.16)
project(DvsenseDVSyncproWebRtcViewer LANGUAGES CXX)
find_package(DvsenseDriver COMPONENTS Driver REQUIRED)

若 CMake 找不到 SDK,请确认开发包已安装,执行 dpkg -L libdvsensedriver-dev 核对 DvsenseDriverConfig.cmake 的实际位置,并将 DvsenseDriver_DIR 指向包含该文件的目录。若提示缺少 GStreamer、libsoup 或 json-glib,检查上面的依赖是否安装成功。

启动与观看

  1. 通过第 3 节的 noVNC 地址进入相机桌面,打开终端。先停止其他正在使用内部相机的采集程序,再启动此示例。
  2. 按上述步骤完成编译后,在**相机内部终端**执行:

    ~/dvsyncpro-webrtc-sample/build/dvsense_dvsyncpro_webrtc_viewer 8080
  3. 保持终端中的程序运行,在**上位机浏览器**中新开标签页,访问 WebRTC 融合预览,即 http://192.168.137.2:8080/。页面自动建立连接,无需输入 noVNC 桌面密码。
  4. 对着相机移动物体或挥动手掌,观察 RGB 画面上叠加的红、蓝事件点。画面上方的 APS、Events、Triggers 分别显示已接收的 RGB 帧数、DVS 事件数和内部RGB和DVS同步信号数;这些计数是累计值。
  5. 结束观察时,在启动程序的相机终端按 Ctrl + C 停止。关闭浏览器页面只会断开观看连接,程序仍在相机内部运行。

WebRTC 预览只需要 USB 网络互通,**无需开启外网共享**。noVNC 桌面使用 6080 端口,WebRTC 示例使用 8080 端口;桌面服务随开机启动,WebRTC 示例需要按上述步骤启动。程序第一个参数可指定其他端口,例如使用 8081 后,访问地址对应改为 http://192.168.137.2:8081/。

若启动时提示找不到 SDK 动态库,先执行 sudo ldconfig 更新系统库缓存,再用 ldd ~/dvsyncpro-webrtc-sample/build/dvsense_dvsyncpro_webrtc_viewer 检查是否存在 not found,并核对 SDK 开发包及其依赖是否安装完整。

无法观看时

  • 页面打不开:检查程序是否仍在运行、是否出现启动错误,以及访问端口是否与启动参数一致。
  • 页面打开但连接失败:先关闭其他观看标签页,再刷新;检查浏览器是否支持 WebRTC,以及上位机防火墙是否允许 WebRTC 使用的 UDP 通信。
  • 只有状态文字或画面不更新:查看相机终端输出和 APS、Events、Triggers 计数,检查内部相机是否已被其他程序占用。

8. 常见问题

现象 优先检查
上位机看不到相机或 USB 网卡 USB 线是否支持数据传输、相机是否完成启动、驱动是否正常安装
无法访问 192.168.137.2 USB 网卡是否为 192.168.137.1/24;其他网卡或 VPN 是否也使用 192.168.137.0/24,造成路由冲突
相机 IP 可达,但网页版桌面打不开 网页地址的协议、端口和路径是否正确;桌面服务是否完成启动
桌面能打开,但相机无法上网 共享是否选中了相机 USB 网卡;相机网关是否指向上位机 USB 地址;上位机是否能够上网
能访问外部 IP,但打不开域名 相机 DNS 是否正确且可达

SDK 取流和数据处理可继续参考融合相机使用教程和 1.3.0 API 迁移说明。