HTTP/MQTT/CoAP全支持:JVS物联网平台多协议接入与产品配置全解析

0 阅读1分钟

在万物互联的时代,物联网平台是连接物理世界与数字世界的核心枢纽。面对海量、异构的设备接入与管理挑战,如何实现设备的标准化定义、快速部署与高效运维,成为物联网解决方案成功落地的关键。

JVS 物联网平台的产品管理模块,作为平台的核心功能之一,它通过“产品模板”抽象定义设备的数据模型、功能接口与通信规范,将具体的设备功能标准化、数字化。

一、产品管理模块概述

1.1 模块定位

产品管理是物联网平台的核心功能模块,作为设备接入和管理的基础,通过定义设备的功能属性、数据模型和通信协议,实现设备实例的抽象模板化管理。基于产品模板,用户可以快速批量创建配置相同的物联网设备,大幅提升设备部署效率。

1.2 核心概念

1.2.1 产品模板与设备实例

  • 产品模板:对设备的抽象定义,包含设备的功能属性、数据模型和通信协议,是设备标准化的核心载体
  • 设备实例:产品模板的具体落地,是实际接入平台的物理设备,直接面向业务场景
  • 关系:一个产品模板可衍生多个设备实例,设备实例继承产品模板的所有属性和配置,实现标准化管理

1.2.2 物模型

  • 定义:对设备功能的抽象描述框架,将设备功能拆解为属性、功能和事件三个维度
  • 属性:设备的状态信息(如开关状态、温度值),反映设备当前运行状态
  • 功能:设备可执行的操作(如开关控制、参数设置),实现对设备的远程控制
  • 事件:设备主动上报的信息(如故障告警、状态变更),用于异常监控和业务触发

1.2.3 产品类型

  • 直连设备:直接与平台建立连接的设备,如各类传感器、执行器
  • 网关设备:作为中间枢纽,连接多个子设备接入平台,实现设备集群管理
  • 网关子设备:通过网关设备间接接入平台的设备,适用于分布式部署场景
  • 监控设备:用于视频监控的设备,如网络摄像头、视频采集器

1.2.4 接入方式

HTTP协议

  • 适用场景:数据量小、实时性要求不高的设备,如环境传感器、智能家居设备
  • 技术优势:协议成熟,无需额外开发,兼容性强,快速上手
  • 局限性:实时性差,不适合高频数据传输,资源消耗较大
  • 典型应用:环境监测系统、智能家居控制平台

MQTT协议

  • 适用场景:数据量大、实时性要求高的设备,如工业自动化设备、智能电表
  • 技术优势:低带宽消耗,支持持久化连接,消息推送及时可靠
  • 局限性:需额外开发MQTT客户端,配置相对复杂
  • 典型应用:工业物联网平台、智能电网系统

CoAP协议

  • 适用场景:资源受限的低功耗设备,如电池供电的物联网传感器
  • 技术优势:轻量级设计,协议开销小,适合低功耗设备
  • 局限性:功能相对简单,兼容性较差
  • 典型应用:智能农业监测、野外环境监测

MQTT Broker

  • 适用场景:作为MQTT代理节点,连接大规模MQTT客户端
  • 技术优势:支持海量设备接入,消息路由灵活高效
  • 局限性:需额外部署和维护,对服务器性能要求较高
  • 典型应用:智慧城市项目、大规模物联网平台

数据采集

  • 适用场景:通过数据采集器接入的设备,适用于工厂现场设备级接入
  • 技术优势:支持多协议转换,适配不同类型设备
  • 局限性:需额外部署数据采集器,整体成本较高
  • 典型应用:工业自动化系统、设备监控平台

1.3 核心功能

  • 产品创建与配置管理
  • 产品分类体系构建
  • 物模型标准化定义
  • 规则联动策略设置

二、产品管理功能操作指南

2.1 页面访问路径

  1. 登录物联网平台系统
  2. 通过左侧导航栏进入「设备管理」→「产品」模块
  3. 页面默认展示所有已创建的产品列表

2.2 产品列表视图

产品卡片核心信息

  • 产品名称:设备型号或自定义业务名称
  • 创建时间:产品模板创建的时间戳
  • 产品分类:设备所属业务类别(如继电器、温湿度变送器)
  • 产品类型:直连设备/网关设备等类型标识
  • 操作按钮:详情查看、修改配置、删除产品

页面功能特性

  • 新建产品:点击「+ 新建」按钮快速创建新产品模板
  • 智能搜索:支持通过产品名称快速定位目标产品
  • 视图切换:支持列表视图与网格视图自由切换
  • 分页导航:支持多页数据高效浏览

2.3 常用操作流程

1. 查看产品详情

  • 点击产品卡片的「详情」按钮
  • 进入产品详情页面,查看完整配置信息

2. 修改产品基本信息

  • 点击产品卡片的「修改」按钮
  • 进入产品编辑页面,调整产品基础配置

3. 删除产品

  • 点击产品卡片的「删除」按钮
  • 确认删除操作,完成产品模板清理

三、产品详情设置

3.1 页面布局设计

左侧产品信息区域

  • 产品卡片:展示产品名称、启用状态、关联设备数量
  • 基本信息:产品ID、分类、类型、创建时间、创建人
  • 启用开关:一键控制产品模板是否可用

右侧功能标签页

  • 物模型:定义设备的数据模型和功能接口
  • 设备列表:管理该产品模板下的所有设备实例
  • 接入方式:配置设备接入协议和参数
  • 规则联动:设置设备触发规则和业务逻辑

3.2 物模型配置

3.2.1 物模型概述

物模型作为设备功能的抽象描述框架,将设备功能拆解为三个核心维度:

  • 属性:设备的状态信息(如开关状态、温度值),支持读写操作
  • 功能:设备可执行的操作(如开关控制、参数设置),支持远程调用
  • 事件:设备主动上报的信息(如故障告警、状态变更),支持订阅推送

3.2.2 产品属性配置详解

配置流程

  1. 填写标识符:需与设备实际输出的属性名保持一致
  2. 定义名称:设置属性的中文名称,便于业务识别
  3. 选择数据类型:根据属性值类型选择合适的数据类型
  4. 设置读写类型:根据设备功能定义属性的访问权限
  5. 选择取值来源:根据属性值的获取方式进行配置
  6. 填写单位:补充属性值的单位信息(可选)
  7. 点击「保存」按钮完成配置

配置项说明

  • 标识符:设备属性的唯一标识,需与设备实际输出严格匹配

  • 名称:属性的中文名称,用于业务展示和识别

  • 数据类型:支持整数、浮点型、双精度、长整型、字符串、布尔等类型

  • 读写类型:支持只读、只写或读写三种访问权限

  • 取值来源:支持设备上报、公式转换、手动输入三种获取方式

  • 设备上报:设备主动上报的实时属性值

  • 公式转换:通过预设公式计算得到的属性值

  • 手动输入:人工配置的静态属性值

  • 单位:属性值的度量单位,如℃、%、m等

配置注意事项

  • 标识符需全局唯一,不可重复
  • 数据类型需与设备实际输出保持一致
  • 读写类型需根据设备功能合理设置
  • 取值来源需结合业务场景选择

3.2.3 功能配置详解

配置项说明

  • 标识符:设备功能的唯一标识,需与设备实际接口名一致
  • 名称:功能的中文名称,便于业务识别
  • 是否异步:功能调用的执行方式,支持同步或异步
  • 输入参数:功能调用所需的参数定义
  • 输出参数:功能调用返回的结果定义
  • 超时:功能调用的超时时间设置
  • 说明:功能的详细业务说明

配置流程

  1. 填写标识符:需与设备实际接口名保持一致
  2. 定义名称:设置功能的中文名称,便于业务识别
  3. 选择异步模式:根据功能执行时间合理选择
  4. 配置输入参数:定义功能调用所需的参数
  5. 配置输出参数:定义功能调用返回的结果
  6. 设置超时时间:配置功能调用的超时阈值
  7. 填写业务说明:补充功能的详细业务描述
  8. 点击「保存」按钮完成配置

3.2.4 事件配置详解

配置项说明

  • 标识符:设备事件的唯一标识,需与设备实际事件名一致
  • 事件名称:事件的中文名称,便于业务识别
  • 事件等级:事件的严重程度,支持普通、警告、紧急三个等级
  • 输出参数:事件上报的参数定义
  • 是否异步:事件处理的执行方式,支持同步或异步
  • 说明:事件的详细业务说明

配置流程

  1. 填写标识符:需与设备实际事件名保持一致
  2. 定义名称:设置事件的中文名称,便于业务识别
  3. 选择事件等级:根据事件严重程度合理选择
  4. 配置输出参数:定义事件上报的参数
  5. 选择异步模式:根据事件处理时间合理选择
  6. 填写业务说明:补充事件的详细业务描述
  7. 点击「保存」按钮完成配置

3.2.5 TSL配置详解

TSL概述

TSL(Thing Specification Language)是物模型的JSON格式标准化描述,用于定义设备的属性、功能和事件。TSL包含三个核心模块:

  • properties:属性模块,定义产品的属性相关配置
  • services:服务模块,定义产品的服务相关配置
  • events:事件模块,定义产品的事件相关配置

配置流程

  1. 进入物模型的TSL标签页
  2. 编辑JSON格式的TSL内容
  3. 点击「保存」按钮完成配置

3.3 产品对应设备列表

设备实例信息展示

  • 设备名称:自定义的设备业务名称
  • 最后在线时间:设备最后一次连接平台的时间
  • 创建时间:设备实例注册到平台的时间
  • 设备说明:设备的业务描述信息

操作流程

  1. 点击「查看详情」进入设备详情页面
  2. 支持分页浏览和设备搜索功能

3.5 接入方式配置

3.5.1 接入方式概述

平台支持多种设备接入协议,适配不同业务场景需求:

HTTP协议

  • 适用场景:数据量小、实时性要求不高的设备
  • 优势:简单易用,无需额外开发
  • 局限:实时性差,不适合高频数据传输

MQTT协议

  • 适用场景:数据量大、实时性要求高的设备
  • 优势:低带宽消耗,支持持久化连接
  • 局限:需额外开发MQTT客户端

CoAP协议

  • 适用场景:资源受限的低功耗设备
  • 优势:轻量级设计,适合低功耗设备
  • 局限:功能相对简单

MQTT Broker

  • 适用场景:作为MQTT代理节点,连接大规模客户端
  • 优势:支持海量设备接入
  • 局限:需额外部署和维护

数据采集

  • 适用场景:通过数据采集器接入的设备
  • 优势:支持多协议转换
  • 局限:需额外部署数据采集器

3.5.2 配置流程

  1. 进入产品详情页面
  2. 点击「接入方式」标签页
  3. 选择合适的接入协议
  4. 配置协议参数(如服务器地址、端口号)
  5. 保存配置信息

3.6 规则联动配置

规则列表展示

  • 规则名称:自定义的规则业务名称
  • 状态:规则的发布状态(未发布/已发布)
  • 规则编码:系统自动生成的唯一标识
  • 作用域:规则适用的产品范围

操作流程

  1. 点击「+ 新建」按钮创建新规则
  2. 配置规则触发条件和执行动作
  3. 点击「发布」按钮启用规则

四、产品管理工作流

4.1 产品创建流程

  1. 点击「+ 新建」按钮启动创建流程
  2. 填写产品基本信息(名称、分类、类型)
  3. 定义物模型属性和功能
  4. 配置设备接入方式
  5. 设置规则联动策略
  6. 保存并启用产品模板

4.2 设备接入流程

  1. 创建产品模板并定义物模型
  2. 在产品详情页面进入「设备列表」
  3. 点击「添加设备」按钮注册新设备
  4. 填写设备基本信息(名称、说明)
  5. 保存设备信息
  6. 设备接入平台完成初始化

4.3 产品模板与设备实例关系

  1. 产品模板定义设备的通用属性和功能标准
  2. 设备实例继承产品模板的所有配置信息
  3. 设备实例可根据业务需求修改部分属性值
  4. 产品模板更新后,关联设备实例自动同步配置

五、注意事项

5.1 产品管理

  • 产品创建后不可删除,仅支持禁用操作
  • 产品分类需提前在「产品分类」模块完成配置
  • 物模型定义后,设备接入需严格遵循定义的属性规范

5.2 设备管理

  • 设备名称需全局唯一,不可重复
  • 设备删除后无法恢复,操作需谨慎
  • 设备状态实时更新可能存在1-2分钟延迟

5.3 规则管理

  • 未发布的规则不会生效
  • 规则配置需考虑设备性能和网络带宽限制
  • 规则执行结果可在「运维管理」模块查看

在线demo:iot.bctools.cn

开源框架:gitee.com/software-mi…