1. 设备/设备组反向控制界面配置使用手册

2. 修订记录

日期版本说明编写
2019-11-011.0 R1初始化lizhijun
2019-11-051.1 R2配置更新,去掉,控制命令中的equipment_id和aprus_id字段qinguoqing

3. 设备控制面板配置概述

3.1. 文档说明

本文档为智物联《物联网基础平台 MIXIOT》中的子系统FIDIS Pro设备模块控制页面配置规范.

3.2. 适用对象

本文档适用人员范围:MIXIOT平台开发、运维、测试、交付等所有使用人员。

3.3. 支持元素简要说明

名称类型说明元素预览
标准开关SwitchControlTitle标签:可设 按钮标签:开/关 实时数据:不需显示3.3. 反向控制配置 - 图1
按钮开关SwitchControlBtnTitle标签:可设 实时数据:不需显示3.3. 反向控制配置 - 图2
按钮组BtnGroupControlTitle标签:可设 按钮标签:可设多项(标签,设定值,颜色) 实时数据:可配开/关显示3.3. 反向控制配置 - 图3
仪表设定GaugeSetControlTitle标签:可设 仪表标签:可设 确定按钮:确定 实时数据:显示3.3. 反向控制配置 - 图4

4. 设备控制面板配置块说明

总配置以 {} 包裹每一个块
每个块都以 {key:value} 的形式配置在 {} 中

  • 块级字段说明:
    • "name" - 块元素的名称设置
    • "row" - 块行数
    • "col" - 块列数
    • "data" - 块元素列表

4.1. 分块示例说明

  1. {
  2. "AP2018121200001": {
  3. "name": "AP2018121200001",
  4. "row": 4,
  5. "col": 8,
  6. "data": [
  7. ...
  8. ]
  9. }
  10. }

5. 设备控制面板配置元素示例说明

元素配置以 {} 包裹存放于块元素的 data 字段中

  • 通用元素字段说明:
    • "type" - 元素类型
    • "attribute" - 元素属性,symbol标签,唯一值不可重复
    • "name" - 元素名称,即Title标签
    • "itemData" - 元素内容列表
      • "command" - 元素控制命令,具体自行参阅MIXIOT APIP文档
    • "xys" - 元素位置大小信息
      • "pos" - 元素开始位置 [横向坐标x, 纵向坐标y]
      • "len" - 元素长度大小 [行数, 列数]

5.1. 标准开关

  • 元素内容字段说明:
    • "id" - 标识,当数据需要更新时,即为更新数据的来源标识
    • "name" - 元素名称
    • "statusCode" - 状态码,用以更新switch状态,[关闭状态, 开启状态]
    • "command" - 控制命令,0:关闭命令,1:开启命令
  1. {
  2. "type": "SwitchControl",
  3. "attribute": "switchControl__01",
  4. "itemData": [{
  5. "id": "QQQ",
  6. "name": "报警提示音",
  7. "statusCode": [0, 1],
  8. "command": {
  9. "0": {
  10. "i_type": "equipment",
  11. "command": {"param": "[\"Control1\",\"0\"]", "platform": "P"}
  12. },
  13. "1": {
  14. "i_type": "equipment",
  15. "command": {"param": "[\"Control1\",\"1\"]", "platform": "P"}
  16. }
  17. }
  18. }],
  19. "xys": {
  20. "pos": [0, 0],
  21. "len": [1, 5]
  22. }
  23. }

5.2. 按钮开关

  • 元素内容字段说明:
    • "id" - 标识,当数据需要更新时,即为更新数据的来源标识
    • "name" - 元素名称
    • "statusCode" - 状态码,用以更新switch状态,[关闭状态, 开启状态]
    • "command" - 控制命令,0:关闭命令,1:开启命令
  1. {
  2. "type": "SwitchControlBtn",
  3. "attribute": "switchControl__01",
  4. "itemData": [{
  5. "id": "QQQ1",
  6. "name": "风机开关",
  7. "statusCode": [0, 1],
  8. "command": {
  9. "0": {
  10. "i_type": "equipment",
  11. "command": {"param": "[\"Control1\",\"0\"]", "platform": "P"}
  12. },
  13. "1": {
  14. "i_type": "equipment",
  15. "command": {"param": "[\"Control1\",\"1\"]", "platform": "P"}
  16. }
  17. }
  18. }],
  19. "xys": {
  20. "pos": [1, 0],
  21. "len": [1, 5]
  22. }
  23. }

5.3. 按钮组

  • 特殊字段说明:
    • "valueItem": 实时数据项,需要显示则配置此项,
      • "id" - 实时数据来源标识
      • "value" - 初始值
  • 元素内容字段说明:
    • "id" - 标识,当数据需要更新时,即为更新数据的来源标识
    • "name" - 元素名称,即按钮标签
    • "background" - 元素背景
    • "command" - 控制命令
  1. {
  2. "type": "BtnGroupControl",
  3. "attribute": "btnGroupControl__01",
  4. "name": "原料累计(m3)",
  5. "valueItem": {
  6. "id": "S010135",
  7. "value": 0
  8. },
  9. "itemData": [{
  10. "id": "AAA",
  11. "name": "清除",
  12. "background": "#dc3550",
  13. "command": {
  14. "i_type": "equipment",
  15. "command": {"param": "[\"Control1\",\"1\"]", "platform": "P"}
  16. }
  17. },
  18. {
  19. "id": "BBB",
  20. "name": "远程启动",
  21. "background": "#17c68e",
  22. "command": {
  23. "i_type": "equipment",
  24. "command": {"param": "[\"Control1\",\"1\"]", "platform": "P"}
  25. }
  26. }
  27. ],
  28. "xys": {
  29. "pos": [0, 5],
  30. "len": [4, 5]
  31. }
  32. }

5.4. 仪表设定

  • 元素内容字段说明:
    • "id" - 标识,当数据需要更新时,即为更新数据的来源标识
    • "name" - 元素名称,即仪表标签
    • "step" - 元素设定框步长
    • "color" - 元素仪表颜色
    • "command" - 控制命令,$val 为设定框的值,保留字段
  1. {
  2. "type": "GaugeSetControl",
  3. "attribute": "gaugeSetControl__01",
  4. "name": "TT030进料预热后温度调节",
  5. "itemData": [{
  6. "id": "H2",
  7. "name": "当前温度",
  8. "value": 0,
  9. "step": 1,
  10. "color": "#fa8f2a",
  11. "command": {
  12. "i_type": "equipment",
  13. "command": {"param": "[\"Control1\",\"$val\"]", "platform": "P"}
  14. }
  15. }],
  16. "xys": {
  17. "pos": [0, 10],
  18. "len": [5, 6]
  19. }
  20. }