## 页面导读

- **适用场景**: 适合平台管理员创建产品、配置接入协议、定义物模型，并为后续设备接入做好准备。
- **前置条件**: 已明确设备类型、通讯协议、传输协议、认证方式，以及是否需要网关、Modbus 或视频能力。
- **操作路径**: 设备管理 → 产品管理 → 新增产品 → 配置物模型/授权/子产品 → 发布产品。
- **验收点**: 产品状态为已发布，物模型配置完整，认证信息可用于设备端连接平台。

## 使用入口与推荐流程

<div class="doc-path">
  <ol>
    <li>进入 <strong>设备管理 → 产品管理</strong>，先确认产品分类、设备类型、传输协议、通讯协议和认证方式。</li>
    <li>新增产品后进入产品详情，按设备能力配置物模型、Modbus、SIP、子产品、应用配置或组态应用。</li>
    <li>完成配置后发布产品，再进入设备管理新增或导入设备。</li>
    <li>设备上线后回到产品和物模型页面复核数据、指令、事件、规则和告警是否都能正常联动。</li>
  </ol>
</div>

## 一、产品管理介绍

产品是设备的集合，通常是对同类型、同型号物理设备的描述。
你可以通过本文了解 **产品** 相关的功能。<br> <img src="./images/product/product-01.png" alt="一、产品管理介绍页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

### 1、概述

产品具备批量管理相同设备的传输协议、通讯协议、物模型、modbus配置，相同的设备所属同一个产品，实现设备的统一管理的能力。基于产品还可配置场景联动、组态画面等。

### 2、产品配置项

| 配置项  | 说明                                                                                                                             |\
|------|--------------------------------------------------------------------------------------------------------------------------------|
| 产品名称 | 必填，产品名，自定义                                                                                                                     |\
| 产品分类 | 必填，单选下拉框，现在产品分类菜单下配置，多个产品可以归为一个分类，                                                                                             |
| 设备类型 | 必填，单选下拉框，监控直接选择监控设备，其余设备类型参考<a href="/doc/business/v2/link/sub-device.html" target="_blank" rel="nofollow">网关与子设备文档</a> |
| 通讯协议 | 必填，单选下拉框，对设备上报数据的编解码，必须选择合适的，已有的协议参考协议管理菜单                                                                                     |
| 传输协议 | 必填，单选下拉框，设备连接物联网平台的方式，必须选择合适的                                                                                                  |
| 固件类型 | 必填，单选下拉框，选择合适的，参考<a href="/doc/business/v2/dev/ota.html">设备OTA升级文档</a>                                                   |
| 联网方式 | 可选，单选下拉框，就是一个标签，根据设备联网方式自行选择                                                                                                   |
| 私有产品 | 开关，设置为私有后下级不能查看                                                                                                                |
| 设备授权 | 开关，设备授权功能，默认不启用，产品启用设备授权码后，需要为设备分配授权码，设备认证时使用                                                                                  |
| 认证方式 | 必填，设备接入认证方式，单选下拉框，可参考设备接入下不同协议设备接入的文档                                                                                          |
| 定位方式 | 必填，单选下拉框<br>自动定位：设备认证时平台会自动获取设备定位；<br>设备定位：设备通过/info/post主题主动上报经纬度地址信息；<br>自定义位置：设备详情自行配置经纬度地址信息                               |
| 产品编号 | 系统自动生成                                                                                                                         |
| 认证账号 | 必填，新增时系统自动生成，可自行修改                                                                                                             |
| 认证密码 | 必填，新增时系统自动生成，可自行修改                                                                                                             |
| 认证密钥 | 必填，新增时系统自动生成，可自行修改                                                                                                             |
| 产品图片 | 可选，自行修改                                                                                                                        |
| 备注信息 | 非必填输入框                                                                                                                         |

### 3、产品列表

#### 3.1、新增

点击 "+ **新增**" 按钮，打开新增产品窗口，点击确定之后可以看到列表已经存在该产品了

::: tip
注意：产品设备类型选择**网关设备**，通讯协议选择ModbusRtu协议、Modbus转Json解析协议-华普物联、ModbusTcp协议、JSON网关解析协议会有一个**子产品配置按钮**，选中后可直接导入子产品，具体配置方式参考<a href="/doc/business/v2/link/sub-device.html" target="_blank" rel="nofollow">网关与子设备文档</a>
:::

<img src="./images/product/product-02.png" alt="新增页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 3.2、复制

点击 "**复制**" 按钮，打开选择产品窗口，选择对应的产品，点击确定即可复制出一个完全一样的产品出来  <br> <img src="./images/product/product-03.png" alt="复制页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 3.3、导入

点击 "**导入**" 按钮，打开导入产品窗口，先下载json模板文件，然后编辑json文件，然后点击上传文件，最后点击确定即可导入<br> <img src="./images/product/product-04.png" alt="导入页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 3.4、显示上级机构产品

勾选后会把上级机构的产品查询出来，但是不支持编辑

### 4、产品详情

产品详情页面包括基本信息、产品模型、Modbus配置、设备授权、组态应用、应用配置等
::: tip
注意：除了子产品、轮询任务、应用配置，其它功能都需要先把产品**取消发布**，才可进行编辑
:::

#### 4.1、基本信息

可以进行一些基本信息的修改<br> <img src="./images/product/product-05.png" alt="基本信息页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.2、产品模型

物模型是设备在云端的描述，从属性、功能、事件、标签四个维度定义一个真实设备

* 导入物模文件：点击后进入批量导入窗口，先下载产品物模型导入模版文件，编辑好后点击上传文件，最后点确定即可导入
* 导入通用物模型：点击后进入导入通用物模型窗口，选择合适的通用物模型，最后点导入
* 查看物模：点击后进入物模型窗口，可以查看整个物模型的数据结构

<img src="./images/product/product-06.png" alt="产品模型页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />  

#### 4.2、应用配置

移动端**状态模式**界面支持自定义，可在产品应用配置点击配置，在配置界面根据自己需求自定义界面，配置好后点击**启用**<br> <img src="./images/product/product-07.png" alt="应用配置页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.3、设备授权

可选功能，启用后主要用于设备认证，需要为设备分配授权码<br> <img src="./images/product/product-08.png" alt="设备授权页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.4、SIP配置

SIP 协议配置项，对应国标 GB28181 协议（公共安全视频监控联网系统的国家标准），主要作用是让该产品（通常是视频设备，如摄像头）能通过 SIP 协议接入国标 GB28181 的视频监控平台，实现设备注册、视频流传输、设备控制等功能<br> <img src="./images/product/product-09.png" alt="SIP配置页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.5、子产品

网关设备类型，部分通讯协议支持配置子产品

* 新增：点击后进入选择产品窗口，选择对应子产品，最后点确定进行绑定
* 设置地址：点击后即可编辑子产品默认的子设备地址，不能重复；

<img src="./images/product/product-10.png" alt="子产品页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />  

#### 4.6、Modbus配置

产品协议为**Modbus相关协议**的需要配置，modbus设备中网关自身属性或者网关子设备的配置，具体配置方式参考参考<a href="/doc/business/v2/link/sub-device.html" target="_blank" rel="nofollow">网关与子设备文档</a><br> <img src="./images/product/product-11.png" alt="Modbus配置页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.7、轮询任务

Modbus相关协议的需要配置轮询任务才能主动采集数据，产品Modbus配置-网关/子设备配置-采集方式必须勾选**云端轮询**，新建设备时设备继承<br> <img src="./images/product/product-12.png" alt="轮询任务页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.8、指令下发

产品通讯协议选择了ModbusTcp协议，配置一些指令，新建设备时设备继承，可在设备侧点击下发<br> <img src="./images/product/product-13.png" alt="指令下发页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

#### 4.9、组态应用

针对产品进行组态页面设计，该产品下的设备都能查看该组态页面，并实时展示设备上报数据或进行指令下发<br> <img src="./images/product/product-14.png" alt="组态应用页面截图" style="border:1px solid #ccc;border-radius:6px;margin:8px 0;" loading="lazy" />

### 5、发布产品

新建产品默认为未发布状态，参考产品详情完成产品定义后，点击 "**发布产品**" 按钮启用之后可以创建对应该产品的设备\
::: tip
注意：产品如果是未发布状态，设备认证时会失败
:::

### 6、多租户

租户隔离，上级机构能使用和编辑下级机构的产品；下级机构能查看使用但不能编辑上级机构的产品；

### 7、配置决策表

创建产品时最容易选错的是设备类型、通讯协议、传输协议和认证方式。建议按下面表格先判断，再创建产品。

| 场景 | 设备类型 | 传输协议 | 通讯协议 | 说明 |
| --- | --- | --- | --- | --- |
| 普通 MQTT 传感器 | 直连设备 | MQTT | JSON 解析或自定义协议 | 最常见接入方式，适合快速上手 |
| HTTP 主动上报设备 | 直连设备 | HTTP | JSON 解析或自定义协议 | 适合低频上报、已有 HTTP 能力的设备 |
| TCP 私有协议设备 | 直连设备 | TCP | 自定义协议 | 需要服务端编解码适配 |
| Modbus RTU 网关 | 网关设备 | 按现场链路选择 | ModbusRtu 或网关协议 | 需要配置子产品、寄存器和轮询任务 |
| Modbus TCP 设备 | 直连设备或网关设备 | Modbus TCP | ModbusTcp 协议 | 需要明确设备作为客户端还是服务端 |
| GB28181 摄像头 | 监控设备 | SIP/GB28181 | SIP/视频协议 | 需要配置 SIP 和流媒体服务 |
| 车载定位终端 | 直连设备 | TCP/JT808 | JT808 协议 | 需要规划终端手机号和设备编号映射 |

## 发布前验收清单

发布产品前建议逐项检查：

| 检查项 | 正常状态 |
| --- | --- |
| 产品基础信息 | 产品名称、分类、设备类型、协议、认证方式已确认 |
| 物模型 | 属性、功能、事件标识符唯一，数据类型正确 |
| 认证信息 | MQTT/HTTP/TCP 账号、密码、密钥已生成 |
| 设备授权 | 若启用授权，已准备授权码分配方式 |
| Modbus 配置 | 寄存器、从机地址、功能码、轮询任务已确认 |
| 子产品 | 网关产品已绑定需要管理的子产品 |
| SIP 配置 | 视频产品已配置 SIP 信息和流媒体服务 |
| 应用配置 | 移动端状态模式或组态应用已按需启用 |
| 发布状态 | 产品最终状态为已发布 |

## 常见问题

### 产品发布失败

检查必填字段是否完整，物模型标识符是否重复，协议配置是否缺失。部分配置需要先取消发布才能修改。

### 设备认证失败

优先检查产品是否已发布，设备端使用的产品 ID、设备编号、认证账号、认证密码是否与当前产品一致。

### 设备上报后页面不显示数据

检查物模型标识符是否与上报报文中的 `id` 完全一致，数据类型是否匹配，产品是否发布后再创建设备。

### 下级机构看不到产品

检查产品是否为私有产品、机构数据权限、当前角色权限以及是否勾选显示上级机构产品。

## 二次开发入口

| 类型 | 路径或接口 | 说明 |
| --- | --- | --- |
| Vue3 页面 | `vue3/src/views/iot/product` | 产品列表、产品详情、产品模型和应用配置 |
| Vue3 API | `vue3/src/api/iot` | 产品、模型、协议等接口封装 |
| 后端接口 | `/iot/product` | 产品管理接口 |
| 后端接口 | `/iot/model` | 产品物模型接口 |
| 后端接口 | `/iot/protocol` | 协议管理接口 |
| 协议模块 | `springboot/fastbee-protocol` | 设备协议编解码 |
| 业务模块 | `springboot/fastbee-open-api` | 产品相关 Controller |
| SQL 脚本 | `springboot/sql` | 产品、物模型、协议相关表结构和升级脚本 |

## 关联文档

* [产品到设备的完整闭环](https://www.fastbee.cn/doc/business/v2/start/product-device-flow.html)
* [通用物模型](https://www.fastbee.cn/doc/business/v2/manual/things.html)
* [设备管理](https://www.fastbee.cn/doc/business/v2/manual/device.html)
* [MQTT 协议设备接入](https://www.fastbee.cn/doc/business/v2/link/mqtt.html)
* [设备接入排错清单](https://www.fastbee.cn/doc/business/v2/link/access-troubleshooting.html)
