> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mrdvs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 体积测量完整图文部署说明

> 旧知识社区迁移的图文操作说明，保留配置截图、参数表和接口说明。

> [!NOTE]
>
> 适用于原文所示的独立体积测量软件。 文档与配图沿用中文原稿；软件界面以项目交付版本为准。

> [!NOTE]
>
> 本页保留旧版操作流程。当前 AW3 平台请参阅[应用算法平台](https://docs.mrdvs.com/solutions/aw3.md)，软件名称、参数与接口不可混用。也可查看[部署与接口摘要](https://docs.mrdvs.com/developers/deployment/volume-measurement)。

## 1. 简介

体积检测算法是迈尔微视(MRDVS)开发的专属于体积测量场景使用，用于自研 M 系列相机在物流、快递、煤场、仓储等场景使用。体积检测算法在相机内部运行，无需搭配外置工控机。算法支持静态、动态检测。

软件只需用户进行相机外参标定、绘制检测范围，即可对单个 / 多个物体检测测量。外参标定可自动获取标定结果，可支持多相机拼接检测。

本文主要介绍迈尔微视体积检测功能部署及使用。

## 2. 体积检测应用场景

### 2.1 物流行业

<ol><li>通过获取货物的体积重量等信息，实现精细化运营，有利于提高车辆装载率，降低用车成本、运输成本以及人工成本，实现全流程的降本增效。</li><li>能快速检测货物/箱体体积重量，一键计算运费。配合地磅，还能有效地对货车和集装箱卡车进行测量，确保整车不超重。</li></ol>

### 2.2 快递行业

在快递收发的时候，借助智能体积测量设备，能快速获取货物的体积重量等信息，数据对接到内部系统，便于查找和翻查，既避免了数据丢失的问题，也有效减少了人工投入和提高作业效率。

### 2.3 煤矿行业

传统大型煤炭矿石堆体积测量方式通常采用全站仪、RTK单点测量方式，且需要人工对特征点进行精准提取。然而由于大型煤炭矿石堆通常不便攀爬，精准特征点的提取因而异常困难；同时单点测量方式测量数据密度小，也无法精准获取煤炭矿石堆的体积，导致作业效率极低。

### 2.4 仓储行业

在物流、仓储甚至一般工业行业中，AGV搬运货物，出入库需要进行货物体积、重量检测。

### 3. 解决问题

在物流、仓储等工业行业中，获取物品体积数量、掌握物品出入库情况对生产库存管理具有重要意义。然而传统解决方案始终面对着技术手段缺乏、测量误差大、人工管理效率低下及监管困难等难题。

迈尔微视ToF相机体积检测比雷达、结构光、2D相机更具有优势，迈尔微视相机部署简单，仅需相机固件支架、电源线、网线，算法在相机内部运行，无需多余工控机配置，使用更加便捷、成本相比雷达等更低。

## 4. 相机硬件部署指南

### 4.1 使用相机类型

相机类型：M系列相机

相机用户手册：[M系列ToF相机](https://docs.mrdvs.com/products/m-series/m4-overview.md)

![体积测量完整图文部署说明：图 1](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/a28f58f9-2432-4605-aee2-c8811c0fe221.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=67f45ba615a61e1714a5e9235ab331b7)

### 4.2 相机安装方式

体积检测相机M4采用固定式安装方式，相机向下拍照，尽量保证相机镜面与地面平行，如下图为安装示意图。

![体积测量完整图文部署说明：图 2](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/18837b64-6a77-4a60-9ce3-b8fa0647c995.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=6ce49cf62c567e522aa6639fb9402cdc)

图4.1 安装示意图

### 4.3 相机连接

相机24V供电，通过超 6 类 / 7 类网线连接，相机安装部署后，通过笔记本电脑打开体积检测上位机软件，进行相机的外参标定和检测范围设置。算法会实时在相机内部运行，多台相机部署，需通过千兆交换机进行连接。

![体积测量完整图文部署说明：图 3](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/317bd48f-8fa4-4e0a-989d-6366de6f91e0.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=7da5f44dc521fe3a0e7c250ff940bb89)

## 5. 相机软件安装指南

### 5.1 软件安装流程

第一次使用软件，可以参照如下流程完成操作。

![体积测量完整图文部署说明：图 4](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/0cda21b0-286e-4778-a352-23fc6dd977a5.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=a0726ceb00a1a868e1fba60651bc3e87)

### 5.2 体积检测上位机运行环境要求

建议运行体积检测上位机设备满足要求。

<table><tbody><tr><td>操作系统</td><td>Windows10 及以上</td></tr><tr><td>CPU</td><td>建议 Intel® Core™ i5 七代及以上</td></tr><tr><td>内存</td><td>8G 及以上</td></tr><tr><td>GPU</td><td>Intel(R) UHD Graphics/核显以上</td></tr></tbody></table>

### 5.3 安装相机上位机软件

<ol><li>相机上位机软件可通过迈尔微视知识库进行获取并下载。点击进行下载→[软件下载](https://docs.mrdvs.com/developers/software/lxcameraviewer.md)</li></ol>

2、双击进行安装Lanxin-MRDVS上位机软件，需要上位机安装在c盘以外。

![体积测量完整图文部署说明：图 5](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/cabcc88e-3d26-401e-aaeb-a01cd4a2b1d3.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=72f79b3d95773eac19470674af38f8c1)

3、选择使用的语言后，点击【**确定**】，选择C盘以外的安装目录，并点击【**下一步**】。

![体积测量完整图文部署说明：图 6](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/348dee6d-9f34-4f8d-88fb-6c8b00c6b902.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=dd0f84752444999cfe0c9ef97fe7c7e4)

4、勾选【**创建桌面快捷方式**】，点击【**下一步**】。

![体积测量完整图文部署说明：图 7](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/ce1b8ead-e096-4834-ba4c-261facc55082.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=5af83acbbf3542b25aa3d5d81cd8ace4)

5、点击【**安装**】按钮，开始安装软件。

![体积测量完整图文部署说明：图 8](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/c7a2bf1d-a332-4fab-919a-4d7cbb96b716.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=ce7a44817741a7794bee3b6bb1c7b852)

6、安装完毕后，可运行相机上位机软件。

![体积测量完整图文部署说明：图 9](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/dac8ba59-4e9f-4a33-89b1-e60678f4605f.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=408f1062d3e99c17e7fd0f3dc1b05f0d)

### 5.4 安装体积检测上位机软件

<ol><li>将获得的体积检测上位机软件，复制到相机上位机 \Lanxin-MRDVS\Tools 中。</li></ol>

![体积测量完整图文部署说明：图 10](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/e36c0214-2d47-413e-ba9e-aad7d6b841a2.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=2b0eec19982e8c73a30baa6a53d08ad7)

2、替换时，选择【**替换目标中的文件**】。

![体积测量完整图文部署说明：图 11](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/7cf0179a-1fde-4763-9cd6-ff223c820762.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=d5042f4707b828f52dab1b8f8b719ac8)

3、双击点开即可运行软件。

4、左侧设备列表栏，相机状态处于【**Unknown**】表示相机没有体积检测算法。

![体积测量完整图文部署说明：图 12](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/154d1261-0517-48a5-87fb-b4d8b8771f2d.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=2c04f3978ee3cb7ef948035d5581bef6)

### 5.5 体积检测软件升级

体积检测软件升级，仅需要替换“**.exe**”文件。

### 5.6 算法升级

<ol><li>相机算法升级需要打开相机上位机软件，双击【**LxCameraViewer**】。</li></ol>

![体积测量完整图文部署说明：图 13](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/c9790445-b910-4441-8867-78bf594deaa3.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=cde727a447719ad087f75c13dfa143c3)

2、点击【**打开**】按钮，进行查看相机成像。

![体积测量完整图文部署说明：图 14](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/b4750100-e4b5-4111-a0d9-7fc89c344c98.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=c7e1850caa1272d3e473ca6546aceb71)

3、点击基础工具→功能设置→【**固件升级**】，进行体积检测算法刷入。(算法请找技术支持人员获取)

![体积测量完整图文部署说明：图 15](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/cb352cff-1854-476a-a179-9b5c0f5b229e.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=98222a876e6bd6c26e4cf0c340b14189)

4、点击【**执行**】按钮后，选择“体积检测算法”，点击【**打开**】按钮，开始算法刷入。

![体积测量完整图文部署说明：图 16](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/1d8334a0-0e47-4781-8a2e-765311aaceac.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=681c6425a8df67ca35890d027be3f7ee)

5、算法刷入过程中，相机会重新启动，左侧设备列表相机ID会消失，待重新显示后，表示刷入成功。

![体积测量完整图文部署说明：图 17](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/ade34da0-16e3-40d8-9af0-542a5c13cbe5.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=c6fdcfd82b25c89e766a849753710d27)

6、此时，再次打开体积检测软件，设备列表显示为绿色。

![体积测量完整图文部署说明：图 18](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/7bc15af4-8e94-45ca-9181-e872410b5ccf.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=62ef5b45a6219f52017487f01011d09f)

## 6. 体积检测软件界面

### 6.1 体积检测程序启动

1、双击【 **LxApplicationViewer.exe** 】程序，启动体积检测软件。点击左侧设备列表中在线的相机，打开相机图像。

![体积测量完整图文部署说明：图 19](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/cb274ae3-6877-40e8-ba2b-485fe835c0ec.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=bef0d42e2547b96182d7cadc079217fa)

2、当前用户选择管理员，无需输入密码，直接点击确认进入管理员模式(用户模式无法进行体积检测参数设置)。管理员模式会多出体积检测、相机配置选项。

![体积测量完整图文部署说明：图 20](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/29f2bf28-535d-4b1d-9aa6-03e03100d78a.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=7ed6ce8b609c506eb3cd52293d48df15)

### 6.2 基础工具

基础工具主要包含用户切换、理想地面、外参地面、多个体积盒显示、触发按钮、导出存图、历史回放、体积状态。

![体积测量完整图文部署说明：图 21](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/4cdcef72-7639-4e7f-84c8-4380fbbed27f.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=d429bb4c808882e5e6546332d7ca5d93)

<table><tbody><tr><td>基础工具</td><td>功能含义</td></tr><tr><td>用户切换</td><td>切换权限，用户权限：仅查看检测结果。 管理员权限：可进行相机配置、体积检测参数配置等</td></tr><tr><td>理想地面</td><td>地面参照水平线，可关闭。</td></tr><tr><td>外参地面</td><td>相机外参标定高度的水平面，可关闭。</td></tr><tr><td>体积盒显示</td><td>当检测区域有多个物体检测时，可切换不同体积盒，查看不同物体检测结果。</td></tr><tr><td>触发按钮</td><td>设置为触发模式后，可调用此触发按钮，进行图像和结果获取。</td></tr><tr><td>导出存图</td><td>导出存储的图像</td></tr><tr><td>历史回放</td><td>查看RGB和TOF的图像日志。</td></tr><tr><td>体积检测结果显示</td><td>显示检测结果，物体个数、物体长、宽、高。</td></tr></tbody></table>

### 6.3 全局配置

切换相机工作模式。

![体积测量完整图文部署说明：图 22](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/0c157f74-799a-4f32-9634-cdb91fc83228.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=d450eadbbdb499e8e8601c3040619605)

### 6.4 体积检测

![体积测量完整图文部署说明：图 23](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/e1a0e9a1-7371-4ad5-93df-9d1dd625aada.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=6baa4fea90e4ceb7a1b2c5814d6d77b3)

<table><tbody><tr><td>体积检测全局配置</td><td>功能含义</td></tr><tr><td>算法版本号</td><td>当前算法版本信息。</td></tr><tr><td>触发模式</td><td>触发开关按钮，当将触发模式开启后，点击“保存并下发”按钮，即成功开启。</td></tr><tr><td>向上检测</td><td>相机坐标系反向检测（当前为向下检测，即检测平面到物体表面距离，开启向上检测后，即检测物体表面到相机的距离）。</td></tr><tr><td>检测频率</td><td>算法检测的频率。即多少ms刷新图像+结果数据。</td></tr><tr><td>检测平面距离</td><td>相机距离检测平面距离，此距离跟测量高度有关。单位：mm。</td></tr><tr><td>邻域数量阈值</td><td>滤波参数，无需更改。默认值即可。</td></tr><tr><td>邻域距离阈值</td><td>滤波参数，无需更改，默认值即可。</td></tr><tr><td>法向量滤波阈值</td><td>物体边缘圆角滤波参数，推荐60（一般无需调整）。</td></tr><tr><td>法向量距离阈值</td><td>滤波参数，推荐值20-30（可兼容大部分检测物体）。</td></tr><tr><td>最小点数量</td><td>当物体点云 大于 最小点数量才认为有物体。</td></tr><tr><td>最小X</td><td>物体最小长度，小于此值，无法检测。单位：mm。</td></tr><tr><td>最小Y</td><td>物体最小宽度，小于此值，无法检测。单位：mm。</td></tr><tr><td>最小Z</td><td>物体最小高度，小于此值，无法检测。单位：mm。</td></tr></tbody></table>

![体积测量完整图文部署说明：图 24](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/d4d05111-3551-446e-a866-37f098c13e7d.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=b2ad565a11407bdf16dc8164ab3907d4)

<table><tbody><tr><td>体积检测区域配置</td><td>功能含义</td></tr><tr><td>最小X</td><td>体积检测框X方向最小值</td></tr><tr><td>最大X</td><td>体积检测框X方向最大值</td></tr><tr><td>最小Y</td><td>体积检测框Y方向最小值</td></tr><tr><td>最大Y</td><td>体积检测框Y方向最大值</td></tr><tr><td>最小Z</td><td>体积检测框Z方向最小值</td></tr><tr><td>最大Z</td><td>体积检测框Z方向最大值</td></tr></tbody></table>

### 6.5 相机配置

![体积测量完整图文部署说明：图 25](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/95f4513b-47df-41aa-ae24-5a02749888c1.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=5be12163a0e48436ea609ce01295abda)

<table><tbody><tr><td>相机设置</td><td>功能含义</td></tr><tr><td>相机名称</td><td>修改当前相机的名称，当有多台时，可通过相机名称进行判断。</td></tr><tr><td>仿真模式</td><td>内部使用，用户无需打开。</td></tr><tr><td>存图模式</td><td>开启算法存图，在相机内部进行存储图片数据。</td></tr><tr><td>取图模式</td><td>取图模式分为MDS和SDK，采用MDS不会占用相机权限，可正常打开相机上位机，采用SDK会占用相机权限，运行算法时，无法打开上位机。</td></tr><tr><td>x</td><td>相机标定的x位置</td></tr><tr><td>y</td><td>相机标定的y位置</td></tr><tr><td>z</td><td>相机标定的距离地面高度</td></tr><tr><td>roll</td><td>相机标定的角度</td></tr><tr><td>pitch</td><td>相机标定的角度</td></tr><tr><td>yaw</td><td>相机标定的角度</td></tr><tr><td>理想地面</td><td>默认即可。</td></tr><tr><td>保存并下发</td><td>外参标定完成后，通过点击【保存并下发】按钮进行保存，否则参数不生效</td></tr><tr><td>从相机读取配置</td><td>从相机读取当前配置参数</td></tr><tr><td>外参标定</td><td>标定相机距离地面高度、相机roll、pitch、yaw角度。</td></tr></tbody></table>

### 6.6 语言

中英文进行切换。

### 6.7 状态栏

![体积测量完整图文部署说明：图 26](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/706d6184-84a3-44cb-a6a6-6fb57cf36309.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=55cc1c659072e0d922b7eae38a892274)

<table><tbody><tr><td>状态栏</td><td>功能含义</td></tr><tr><td>RGB</td><td>勾选后，查看RGB图像</td></tr><tr><td>点云</td><td>勾选后，查看点云图像</td></tr><tr><td>停止算法</td><td>点击停止算法后，在下一次相机上电前，不会启动算法。</td></tr><tr><td>升级固件</td><td>可进行算法固件升级</td></tr><tr><td>重启相机</td><td>将相机重新启动。</td></tr></tbody></table>

### 7. 体积检测部署流程

打开体积检测软件后，默认为RGB图，点击进行切换为点云图后，图像会为黑色状态，需要将鼠标移动到图像显示区域，通过鼠标滚轮上下滑动、按住鼠标左键移动，才会显示点云数据。

![体积测量完整图文部署说明：图 27](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/38bf207d-97e3-4f22-9867-e59c1e252ef1.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=16a4bca282c3c9b19d2da58885f6d18d)

![体积测量完整图文部署说明：图 28](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/d91faf31-886e-442c-8ab5-b367a14db036.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=18607fccf43f7bdf474eb2424bf3dd38)

### 7.1 相机网络配置

以Win10系统为例，双击控制面板

进入控制面板后，点击“**查看网络状态和任务**”。

![体积测量完整图文部署说明：图 29](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/95fb9d57-7f0c-4a1f-9376-14267dcb3f6c.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=99ca9936314ac6747ad300b9d86dfed0)

进入网络和共享中心界面，点击“**更改适配器设置**”。

![体积测量完整图文部署说明：图 30](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/5181b10d-ae88-4a9d-9485-4deba6993533.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=ff9434ff1be3bcd55b7766427ff1f566)

进入网络连接界面，鼠标双击选择相机连接的以太网。

![体积测量完整图文部署说明：图 31](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/44b2f404-5ef4-4ddf-8eef-a3ae1eed10d7.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=0489250eafd050160666c97c37d7048e)

查看以太网状态（建议使用千兆网口），并点击“**属性**”按钮。

![体积测量完整图文部署说明：图 32](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/3f3596f1-39e4-4de8-8ba0-240b563ef8fb.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=df39b46e8f1e9fc9f13386dbe698471a)

进入以太网属性界面，找到“**Internet协议版本4(TCP/IPv4)**”，双击打开。

![体积测量完整图文部署说明：图 33](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/58c00f3e-7ce4-4f9f-92a3-16fb4a3198a5.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=9e4f16527a01baedd8f256fd1da34122)

进入Internet协议版本4(TCP/IPv4)界面，选择“**使用下面的IP地址**”，进行IP地址和子网掩码和默认网关的书写。

![体积测量完整图文部署说明：图 34](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/9beedb39-c61d-481b-ac65-eae8966c7684.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=ee218942b877777e83b58a8788862005)

IP地址设置：192.168.100.xxx 子网掩码：255.255.255.0 默认网关：192.168.100.1，如下图设置好的IP，设置完成后点击“确定”按钮。

![体积测量完整图文部署说明：图 35](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/917ecfab-67f5-4f53-8f98-756f33624e7c.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=e206a6b4c69d6cf43f6e7d4c19a74f4c)

点击确定按钮后，会自动回退到上一个界面，再次点击“**确定**”，完成网络配置。

![体积测量完整图文部署说明：图 36](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/395584ea-e679-44f5-818b-4dc6a76389da.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=a587fbbdf6b9f73db4307729c44497fa)

### 7.2 防火墙关闭确认

在 Windows 防火墙中按项目要求放行相机软件及通信端口。下方旧版截图仅用于定位设置入口；部署时保持防火墙开启。

2、以Win10系统为例，双击桌面的【**控制面板**】，进入后点击【**系统和安全**】。

![体积测量完整图文部署说明：图 37](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/03de5534-1fe9-4ffe-9db7-9309b05b73f0.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=91682c7bef3073ece62af245165858da)

3、点击【**Windows Defender防火墙**】按钮进入防火墙页面

![体积测量完整图文部署说明：图 38](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/d61d5bac-33e8-4d46-ab22-1a55500a26ff.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=372b8d5475da047101728ca55c126a5f)

在 Windows 防火墙中按项目要求放行相机软件及通信端口。下方旧版截图仅用于定位设置入口；部署时保持防火墙开启。

在 Windows 防火墙中按项目要求放行相机软件及通信端口。下方旧版截图仅用于定位设置入口；部署时保持防火墙开启。

![体积测量完整图文部署说明：图 39](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/d8583eab-22db-413f-9a42-76dc0908b50b.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=c889ecc01326cc1db99b406bae469aeb)

### 7.3 体积检测外参标定

在 Windows 防火墙中按项目要求放行相机软件及通信端口。下方旧版截图仅用于定位设置入口；部署时保持防火墙开启。

2、点击相机配置，切换到参数标定界面，进行外参标定前，要保证x、y、z、roll、pitch、yaw为0，如果非0，需要将所有参数归0，并点击【**保存并下发**】按钮，参数保存成功后，重新进行外参标定。

![体积测量完整图文部署说明：图 40](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/5b0ac758-4684-43e9-83c5-65f9fc7f1c76.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=9b90868e00062345296d071f40efd3fe)

3、确认参数均为0后，点击【**外参标定**】按钮，标定成功后，软件会弹出提示框。在右侧参数栏中可以看到已经标定的相机参数。

![体积测量完整图文部署说明：图 41](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/69fb9d8f-7938-4488-81c4-d817b5ac5b86.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=1b99aed1f2ee7e821dcbf06a5aa016a7)

4、将“z”相机高度值记录后，将z值改为0，并点击【**保存并下发**】按钮，相机标定参数保存成功。(相机z值需要在体积检测中，检测平面距离进行设置，所以相机标定的高度记录后，需要改为0，否则检测会有问题)

![体积测量完整图文部署说明：图 42](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/291a7bc1-f174-4321-a322-3f7ab22dd720.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=cc438f35faf5f423084d29ab7c277ae5)

5、将标定的参数保存下发后，外参标定完成，下一步进行体积检测参数设置。

### 7.4 体积检测平面距离设置

1、点击体积检测，切换到体积检测参数设置页面，首先进行“检测平面距离”设置，这个关系到绘制检测区域和检测准确度。

![体积测量完整图文部署说明：图 43](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/a5609871-908c-45e6-a129-ff9e86dac5c6.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=a8d1fd82f9ed71a86af665a762201ec2)

2、将外参标定中得到的“z”高度值2709，填入到检测平面距离中，此为相机距离检测平面实际距离，点击【**保存并下发**】按钮，将设置的高度值写入到相机。

![体积测量完整图文部署说明：图 44](https://mintcdn.com/mrdvs/wUazbn5w9ZHGphTF/images/optimized/legacy-manuals/fadaeebd-d48e-4ba2-90d9-87d9017926af.webp?fit=max\&auto=format\&n=wUazbn5w9ZHGphTF\&q=85\&s=46af29a72eb9dfaca3bbdc335b621fd0)

3、通过移动点云图像数据，可以看到地面高度已经变化，此时可进行体积检测区域配置。

![体积测量完整图文部署说明：图 45](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/3d8aeec7-d33b-48e8-a061-890a6ebed8fa.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=d20c3ec495ac264caf67c0e32f38a235)

### 7.5 体积检测范围设置

<ol><li>检测范围设置，调整检测的长宽（xy）建议先切换到上下视图， 如下为各视图的快捷键。</li></ol>

![体积测量完整图文部署说明：图 46](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/30b799d3-964c-4adc-90cc-b0cca7ebe17a.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=4b1c0f211f5ce8423fb6c2145911269b)

2、通过键盘上快捷键切换到上下视图，如下图所示，红色箭头所指的白色框，表示检测范围的x方向，鼠标滚轮滚动即可修改对应数值，完成检测范围长宽调整。当前将检测范围x方向最大、最小设置为600、-600。

![体积测量完整图文部署说明：图 47](https://mintcdn.com/mrdvs/wUazbn5w9ZHGphTF/images/optimized/legacy-manuals/f81e0deb-e48b-4215-99cb-f49c5b0cc3ec.webp?fit=max\&auto=format\&n=wUazbn5w9ZHGphTF\&q=85\&s=1fa5fc9b0ff2658f7e52de8d14a6ce0b)

3、绿色箭头所指的白色框，表示检测范围的y方向，鼠标滚轮滚动即可修改对应数值，完成检测范围长宽调整。当前将检测范围y方向最大、最小设置为480、-580。

![体积测量完整图文部署说明：图 48](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/817b24b0-3bfc-4157-868f-43142cd956e4.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=8b61b8de842132009e2a894891732f99)

4、蓝色箭头所指，表示检测范围的z方向，鼠标滚轮滚动可修改数值，也可直接输入数值，当前检测范围最大z值建议设置比检测平面距离略高出一些，当前检测平面距离为2709，最大z设置为2690。检测最小范围根据物体的大小进行设置，如果物体高度超出最小z值，算法不会进行检测。

![体积测量完整图文部署说明：图 49](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/17fe8b13-04c3-4f75-9e9b-1a5843af9533.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=4da359d071b84fb2346c54429678ef37)

5、将检测区域配置好后，点击【**保存并下发**】按钮，将参数保存到相机内部。

![体积测量完整图文部署说明：图 50](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/18746efa-a7b4-4e85-98fd-b16bcc470536.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=51d821ac12b7d32a6ff24f593e1bef4a)

### 7.6 体积检测结果查看

<ol><li>将外参标定、体积检测参数、体积检测区域设置好后，点击“**基础工具**”，在检测区域内放入物体即可查看结果。当前为无物体，在基础功能栏会显示无任何物体。</li></ol>

![体积测量完整图文部署说明：图 51](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/909c8066-fa20-47ea-b78b-d97bf227cd3b.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=42599ba9f41159f94b0e565895020c2c)

2、当前放入物体后，在体积状态显示栏会显示当前物体长、宽、高信息。

![体积测量完整图文部署说明：图 52](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/8f782245-62e5-4988-bfd1-ccea4c1d9b11.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=f9aa6e62a9659e1d0dc4262f08fbd10f)

3、当放入多个物体后，体积检测结果显示栏会显示多个物体长、宽、高，并会显示物体数量。

![体积测量完整图文部署说明：图 53](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/1f873710-e793-47b1-aaa0-13b76302c457.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=93cc2e7cf0d135bc59e2f859980931a4)

### 7.7 体积检测单次触发功能

<ol><li>体积检测设置界面，将触摸模式打开，并点击【**保存并下发**】按钮，将触发模式成功打开。</li></ol>

![体积测量完整图文部署说明：图 54](https://mintcdn.com/mrdvs/Js40E11R24Kd7KZk/images/optimized/legacy-manuals/4bd31b14-3a53-479b-b2b1-e51ef03634ed.webp?fit=max\&auto=format\&n=Js40E11R24Kd7KZk\&q=85\&s=b32b37f9d43aa749deaaaa7f9b383de9)

2、点击基础工具，通过点击【**单次触发**】按钮，获取图像和结果。

![体积测量完整图文部署说明：图 55](https://mintcdn.com/mrdvs/EMUtVN87McxPf-eH/images/optimized/legacy-manuals/e40f2f1f-6fb0-49bb-ae01-53b0627846fe.webp?fit=max\&auto=format\&n=EMUtVN87McxPf-eH\&q=85\&s=ade883d61b7957bf42fb31e19f0a87dd)

## 8. 通信协议

### 8.1 TCP通讯

<ol><li>可通过 TCP 通讯获取体积检测结果。通过网络调试助手，远程相机 IP: 192.168.100.82，端口: 14951，发送 RESULT\_UPDATE 可以看到返回的体积检测结果信息。</li></ol>

![体积测量完整图文部署说明：图 56](https://mintcdn.com/mrdvs/cqU6KT8A2O5IAc3w/images/optimized/legacy-manuals/018ebf50-eeee-4ab6-b688-4cffbcc99987.webp?fit=max\&auto=format\&n=cqU6KT8A2O5IAc3w\&q=85\&s=69aee88f4c68d184ae5ed4aa490a528b)

### 8.2 UDP 通讯

<ol><li>可通过 UDP 通讯获取体积检测结果。通过网络调试助手，远程相机 IP: 192.168.100.82，端口: 14950，发送 RESULT\_UPDATE 可以看到返回的体积检测结果信息。</li></ol>

![体积测量完整图文部署说明：图 57](https://mintcdn.com/mrdvs/DUmZlc9bQzzoSGuu/images/optimized/legacy-manuals/905bafb7-3038-43f2-9c23-666327a4c4e0.webp?fit=max\&auto=format\&n=DUmZlc9bQzzoSGuu\&q=85\&s=9a14debdc249dcca3f0e6625a4c15972)

### 8.3 HTTP通讯

<ol><li>可通过 HTTP 通讯获取体积检测结果，端口号：14952。</li></ol>

2、上层系统（WMS）对视觉发送结果获取信号，视觉返回一个 JSON 格式的字符串。

<table><tbody><tr><td>**WMS -> 视觉**</td><td>ㅤ</td></tr><tr><td>**结果**</td><td>**含义**</td></tr><tr><td>RESULT\_UPDATE</td><td>触发视觉结果返回信号</td></tr><tr><td>**视觉 -> WMS**</td><td>ㅤ</td></tr><tr><td>**结果**</td><td>**含义**</td></tr><tr><td>IP</td><td>数据来源相机IP</td></tr><tr><td>TM</td><td>体积检测状态</td></tr><tr><td>angle</td><td>框选的物体角度</td></tr><tr><td>cx</td><td>框选物体x坐标</td></tr><tr><td>cy</td><td>框选物体y坐标</td></tr><tr><td>cz</td><td>框选物体z坐标</td></tr><tr><td>height</td><td>物体高度</td></tr><tr><td>length</td><td>物体长度</td></tr><tr><td>width</td><td>物体宽度</td></tr><tr><td>valid</td><td>置信度过低为false，否则为true</td></tr><tr><td>TM\_DATA\_TIME</td><td>体积检测数据提取时间</td></tr><tr><td>TM\_RES\_TIME</td><td>体积检测结果输出时间</td></tr><tr><td>nick\_name</td><td>体积检测相机名称，相机内可配置</td></tr><tr><td>ret\_code</td><td>返回码，0 为成功</td></tr></tbody></table>

**9. 附录**

\{

"IP":"192.168.100.82", //相机IP

"TM":\[\{

"angle":-6.821981430053711, //框选物体角度

"cx":39.98405456542969, //框选物体x坐标

"cy":257.008056640625, //框选物体y坐标

"cz":2400.63818359375, //框选物体z坐标

"height":616.723876953125, //物体高度

"length":525.5135498046875, //物体长度

"type":"","valid":true, //置信度过低为false

"width":419.761474609375}], //物体宽度

"TM\_DATA\_TIME":"2024\_11\_13\_16\_37\_47.422", //体积检测数据时间

"TM\_RES\_TIME":"2024\_11\_13\_16\_37\_48.209", //体积检测结果时间

"nick\_name":"\_default\_", //体积检测相机命名

"ret\_code":0 // 返回码，0 为成功

}


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.