产品管理
页面导读
使用入口与推荐流程
- 进入 设备管理 → 产品管理，先确认产品分类、设备类型、传输协议、通讯协议和认证方式。
- 新增产品后进入产品详情，按设备能力配置物模型、Modbus、SIP、子产品、应用配置或组态应用。
- 完成配置后发布产品，再进入设备管理新增或导入设备。
- 设备上线后回到产品和物模型页面复核数据、指令、事件、规则和告警是否都能正常联动。
一、产品管理介绍
产品是设备的集合，通常是对同类型、同型号物理设备的描述。 你可以通过本文了解 产品 相关的功能。
1、概述
产品具备批量管理相同设备的传输协议、通讯协议、物模型、modbus配置，相同的设备所属同一个产品，实现设备的统一管理的能力。基于产品还可配置场景联动、组态画面等。
2、产品配置项
| 配置项 | 说明 |
|---|---|
| 产品名称 | 必填，产品名，自定义 |
| 产品分类 | 必填，单选下拉框，现在产品分类菜单下配置，多个产品可以归为一个分类， |
| 设备类型 | 必填，单选下拉框，监控直接选择监控设备，其余设备类型参考网关与子设备文档 |
| 通讯协议 | 必填，单选下拉框，对设备上报数据的编解码，必须选择合适的，已有的协议参考协议管理菜单 |
| 传输协议 | 必填，单选下拉框，设备连接物联网平台的方式，必须选择合适的 |
| 固件类型 | 必填，单选下拉框，选择合适的，参考设备OTA升级文档 |
| 联网方式 | 可选，单选下拉框，就是一个标签，根据设备联网方式自行选择 |
| 私有产品 | 开关，设置为私有后下级不能查看 |
| 设备授权 | 开关，设备授权功能，默认不启用，产品启用设备授权码后，需要为设备分配授权码，设备认证时使用 |
| 认证方式 | 必填，设备接入认证方式，单选下拉框，可参考设备接入下不同协议设备接入的文档 |
| 定位方式 | 必填，单选下拉框 自动定位：设备认证时平台会自动获取设备定位； 设备定位：设备通过/info/post主题主动上报经纬度地址信息； 自定义位置：设备详情自行配置经纬度地址信息 |
| 产品编号 | 系统自动生成 |
| 认证账号 | 必填，新增时系统自动生成，可自行修改 |
| 认证密码 | 必填，新增时系统自动生成，可自行修改 |
| 认证密钥 | 必填，新增时系统自动生成，可自行修改 |
| 产品图片 | 可选，自行修改 |
| 备注信息 | 非必填输入框 |
3、产品列表
3.1、新增
点击 "+ 新增" 按钮，打开新增产品窗口，点击确定之后可以看到列表已经存在该产品了
提示
注意：产品设备类型选择网关设备，通讯协议选择ModbusRtu协议、Modbus转Json解析协议-华普物联、ModbusTcp协议、JSON网关解析协议会有一个子产品配置按钮，选中后可直接导入子产品，具体配置方式参考网关与子设备文档
3.2、复制
点击 "复制" 按钮，打开选择产品窗口，选择对应的产品，点击确定即可复制出一个完全一样的产品出来 
3.3、导入
点击 "导入" 按钮，打开导入产品窗口，先下载json模板文件，然后编辑json文件，然后点击上传文件，最后点击确定即可导入
3.4、显示上级机构产品
勾选后会把上级机构的产品查询出来，但是不支持编辑
4、产品详情
产品详情页面包括基本信息、产品模型、Modbus配置、设备授权、组态应用、应用配置等
提示
注意：除了子产品、轮询任务、应用配置，其它功能都需要先把产品取消发布，才可进行编辑
4.1、基本信息
可以进行一些基本信息的修改
4.2、产品模型
物模型是设备在云端的描述，从属性、功能、事件、标签四个维度定义一个真实设备
- 导入物模文件：点击后进入批量导入窗口，先下载产品物模型导入模版文件，编辑好后点击上传文件，最后点确定即可导入
- 导入通用物模型：点击后进入导入通用物模型窗口，选择合适的通用物模型，最后点导入
- 查看物模：点击后进入物模型窗口，可以查看整个物模型的数据结构
4.2、应用配置
移动端状态模式界面支持自定义，可在产品应用配置点击配置，在配置界面根据自己需求自定义界面，配置好后点击启用
4.3、设备授权
可选功能，启用后主要用于设备认证，需要为设备分配授权码
4.4、SIP配置
SIP 协议配置项，对应国标 GB28181 协议（公共安全视频监控联网系统的国家标准），主要作用是让该产品（通常是视频设备，如摄像头）能通过 SIP 协议接入国标 GB28181 的视频监控平台，实现设备注册、视频流传输、设备控制等功能
4.5、子产品
网关设备类型，部分通讯协议支持配置子产品
- 新增：点击后进入选择产品窗口，选择对应子产品，最后点确定进行绑定
- 设置地址：点击后即可编辑子产品默认的子设备地址，不能重复；
4.6、Modbus配置
产品协议为Modbus相关协议的需要配置，modbus设备中网关自身属性或者网关子设备的配置，具体配置方式参考参考网关与子设备文档
4.7、轮询任务
Modbus相关协议的需要配置轮询任务才能主动采集数据，产品Modbus配置-网关/子设备配置-采集方式必须勾选云端轮询，新建设备时设备继承
4.8、指令下发
产品通讯协议选择了ModbusTcp协议，配置一些指令，新建设备时设备继承，可在设备侧点击下发
4.9、组态应用
针对产品进行组态页面设计，该产品下的设备都能查看该组态页面，并实时展示设备上报数据或进行指令下发
5、发布产品
新建产品默认为未发布状态，参考产品详情完成产品定义后，点击 "发布产品" 按钮启用之后可以创建对应该产品的设备
提示
注意：产品如果是未发布状态，设备认证时会失败
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 | 产品、物模型、协议相关表结构和升级脚本 |