![]() |
DvsenseDriver
1.3.0
The SDK for dvsense products.
|
语言:English
通过 USB 接入上位机时,融视 Pro和普通融合相机一致,可通过配套上位机软件或 SDK 获取、查看和处理融合数据。 日常采集操作与普通融视相机一致,无需先进入相机内部桌面。
Pro 还提供内部二次开发能力。用户可以通过浏览器访问相机的网页版桌面,在相机内部编写、调试和运行算法与程序,让相机承担本地数据处理任务。
相机同时通过 USB 提供网络接口,系统中会出现一张 **USB 网卡**。这张网卡用于访问相机内部系统,也可以在开启网络共享后为相机提供外网连接。
访问内部桌面只需要上位机与相机网络互通;相机内部需要下载依赖、更新软件或访问外部服务时,才需要开启网络共享。
| 项目 | 初始值 |
|---|---|
| 相机 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 |
网页版桌面服务随相机开机自动启动,无需手动启动。
访问地址使用 **HTTP**,端口为 **6080**,页面路径为 **/vnc.html**。当前配置在相机 USB 网口就绪后启动桌面服务,启动期间可稍后刷新页面。进入桌面后会看到终端窗口;关闭终端不会关闭桌面,可在桌面右键菜单中重新打开终端。
以下操作适用于提供“Internet 连接共享”选项的 Windows 10/11 环境。
如果没有“共享”选项卡,需检查 Internet 连接共享(ICS)服务和系统管理策略是否允许共享。
以下以使用 NetworkManager 的 Ubuntu 桌面版为例。先确保上位机可以正常上网,再为**相机 USB 网卡对应的连接**开启共享。
必须核对共享网段: NetworkManager 未指定共享地址时,通常自动选择 10.42.x.0/24,与相机初始地址不在同一网段。本说明统一使用 192.168.137.1/24,便于保持相机初始 IP 不变。NetworkManager IPv4 说明
在 **Ubuntu 上位机**终端中查看连接名称及对应网卡:
确认相机 USB 网卡对应的连接名称,将下方的 相机USB连接名 替换为实际名称,然后执行:
重新启用连接可能短暂中断网页版桌面,恢复后重新连接即可。共享模式由 NetworkManager 管理转发及相关网络服务,无需另行手动配置转发规则。
上位机开启共享后,相机内部的 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 |
保存网络设置时,桌面连接可能短暂中断,稍后重新连接即可。
在**相机内部终端**依次执行:
相机内部提供 dvsense_dvsyncpro_webrtc_viewer 示例,可将同步后的 RGB 图像与 DVS 事件叠加结果通过 WebRTC 传到上位机浏览器。它与桌面版 Sync Viewer 使用相同的同步分组处理方式,适合直接观察融合效果。
默认的预编译 Sample 包不提供这个 WebRTC 示例,需要手动编译开发包附带的示例程序。 SDK 通过 apt 安装 deb 包,提供预编译库、公开头文件、CMake 配置和示例程序源码,不提供 SDK 内部实现源码。以下步骤在相机内部的 Ubuntu 终端执行,示例链接已安装的 SDK 库。
先按前文开启网络共享,使相机可以访问软件源,并确认已配置适用于相机 Ubuntu 版本及 ARM64 架构的 DVSense apt 源。安装 SDK 开发包及依赖:
当前 deb 开发包将示例源码安装到 /usr/share/DvsenseDriver/Samples,其中 WebRTC 示例位于 /usr/share/DvsenseDriver/Samples/DvsenseDVSyncproWebRtcViewer。SDK 的 CMake 配置位于 /usr/share/cmake/DvsenseDriver,动态库位于 /usr/lib。将示例复制到用户目录,再进行编译:
这会链接 deb 包提供的预编译 SDK 库,只编译 WebRTC 示例程序。无需安装 dvsense-driver-samples 预编译例程包。
若找不到示例目录,可用 dpkg -L libdvsensedriver-dev 查看已安装文件,并通过 sudo apt install --only-upgrade libdvsensedriver-dev 更新开发包。如果更新后仍不包含该目录,请联系技术支持获取包含此示例的开发包。
旧版开发包中的示例可能缺少独立 CMake 构建入口。若复制出的 CMakeLists.txt 开头缺少以下配置,可在原有内容之前补充:
若 CMake 找不到 SDK,请确认开发包已安装,执行 dpkg -L libdvsensedriver-dev 核对 DvsenseDriverConfig.cmake 的实际位置,并将 DvsenseDriver_DIR 指向包含该文件的目录。若提示缺少 GStreamer、libsoup 或 json-glib,检查上面的依赖是否安装成功。
按上述步骤完成编译后,在**相机内部终端**执行:
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 开发包及其依赖是否安装完整。
| 现象 | 优先检查 |
|---|---|
| 上位机看不到相机或 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 迁移说明。