Skip to content

控制台 · 位号与模板

位号与模板是数据的"定义侧":模板描述一类设备有哪些能力(位号/指令/事件),位号挂在模板下承载实际数据。这页讲在控制台上怎么管理这两层——新增模板、给模板配位号、把设备绑到模板上,以及每个界面动作背后的 API。

你在这里:已在设备管理里建过设备,现在要定义"这台设备有哪些数据"。字段与对象模型见模板位号;属性怎么填见属性与配置

模板管理

打开模板管理。页面结构与设备管理一致:工具栏(检索/筛选/新增)+ 模板卡片列表 + 分页;卡片上直接提供 启用/停用(物模型开关)、删除。

新增模板:填名称、编码(profileCode,租户内唯一)后保存——模板本身只是"壳",能力靠下面的位号/指令/事件定义。

模板详情四个页签:

页签内容
模板信息名称、编码、启用状态等基本字段
关联位号该模板定义的全部位号(配置读写属性、单位、类型)
关联指令设备级自定义指令定义
关联事件事件定义(驱动上报的外部事件)

停用模板(物模型开关关闭)后,其下设备的能力定义不再参与采集与命令校验——批量暂停一类设备时比逐台停用设备更省事。

位号管理

打开位号(从模板详情的"关联位号"页签进入,或导航直达)。工具栏支持按设备/模板/名称检索与启用状态筛选;卡片动作:编辑、启用/停用、删除、详情。

新增/编辑位号的关键字段:

字段说明
名称 / 编码展示名 + pointCode(同一模板下唯一)
读写类型rwFlag:只读 / 只写 / 读写——决定能否下写命令
单位与精度展示与换算用
驱动属性配置该位号在本驱动协议下的取值参数(如 Modbus 的 slaveId/functionCode/offset)——位号级读写命令的取值来源就是这里,不是指令属性

位号值的读写语义(latest/list 接口、命令轮询)见数据与命令

界面动作与 API 的对应

界面动作API(经网关,manager 中心)语义
模板检索POST …/profile/list分页查询,租户隔离
新增模板POST …/profile/add建模板(不回传 ID)
模板启停POST …/profile/update(enableFlag)物模型开关
位号检索POST …/point/list支持按设备/模板过滤
新增/编辑位号POST …/point/add / …/point/update含属性配置一起提交
位号启停/删除…/point/update / …/point/delete

延伸阅读

基于 AGPL-3.0 协议发布