Holdingbyte

Appearance

基础数据 ​

基础数据接口提供了系统配置选项和设备类型信息。

获取因子配置选项 ​

获取因子配置时可用的各种选项数据。

http
GET /api/v2/base/factor-options/

响应 ​

json
{
    "success": true,
    "data": {
        "data_type_choices": [
            ["INT16", "16位整数"],
            ["UINT16", "16位无符号整数"],
            ["INT32", "32位整数"],
            ["UINT32", "32位无符号整数"],
            ["FLOAT", "单精度浮点数"]
        ],
        "modbus_type_choices": [
            ["INPUT_REGISTER", "输入寄存器"],
            ["HOLDING_REGISTER", "保持寄存器"],
            ["DISCRETE_INPUT", "离散输入"],
            ["COIL", "线圈"]
        ],
        "data_endian_choices": [
            ["ABCD", "大端 (ABCD)"],
            ["DCBA", "小端 (DCBA)"],
            ["BADC", "大端字节交换 (BADC)"],
            ["CDAB", "小端字节交换 (CDAB)"]
        ]
    },
    "error": null
}

字段说明 ​

  • data_type_choices: 数据类型选项

    • INT16: 16位整数
    • UINT16: 16位无符号整数
    • INT32: 32位整数
    • UINT32: 32位无符号整数
    • FLOAT: 单精度浮点数

  • modbus_type_choices: Modbus 数据类型选项

    • INPUT_REGISTER: 输入寄存器（只读）
    • HOLDING_REGISTER: 保持寄存器（可读写）
    • DISCRETE_INPUT: 离散输入（只读布尔值）
    • COIL: 线圈（可读写布尔值）

  • data_endian_choices: 字节序选项

    • ABCD: 大端序（高字节在前）
    • DCBA: 小端序（低字节在前）
    • BADC: 大端字节交换
    • CDAB: 小端字节交换

获取设备类型列表 ​

获取系统支持的设备类型配置列表。

http
GET /api/v2/base/device-types/

响应 ​

json
{
    "success": true,
    "data": [
        {
            "type": "temp",
            "name": "温度",
            "unit": "℃",
            "icon": "https://ums.holdingbyte.com/media/icon/temp.png"
        },
        {
            "type": "humi",
            "name": "湿度",
            "unit": "%RH",
            "icon": "https://ums.holdingbyte.com/media/icon/humi.png"
        }
    ],
    "error": null
}

字段说明 ​

  • type: 设备类型标识符
  • name: 设备类型名称
  • unit: 数据单位
  • icon: 设备类型图标 URL