Command


Command 是触发器类型的节点,可以获取到应用对于设备的控制指令。应用可以通过调用 EnOS open API 向 IoT Hub 的设备发送指令,当设备在线时,Command 节点将自动获取到对应的指令信息,如该设备的 product key, device key, command ID 等,再通过 Script 节点做对应的数据转换,再发向对应的设备或系统。


当前提供两个 open API 供应用程序调用:Set Measurement PointInvoke Service


../../_images/command_diagram.png

节点类型

Trigger。

输入和输出能力

该节点没有入口点,具有 1 个出口点。输入和输出都是 JSON 格式。

节点属性

../../_images/command.png


名称

必填。

该节点的名称。


产品

必填。

作为指令发送对象的设备的产品。


描述

选填。

该节点的描述。

使用限制

  • 只能选择一种产品。

示例

输入示例

该节点不接收任何输入消息。

输出示例

指令类型: Set Measurement Point

在调用 Set Measurement Point API 后,Command 节点将自动获取到指定设备的 command ID, product key, command type 等信息,并作为 msg 输出。


inputDatakey:valuekeyvalue 将分别为待设置的测点和值。例如,将温度设置为 30.5 度,key 将是 temperaturevalue30.5


{
    "commandId":"commandId",
    "productKey": "UgbJtiGV",
    "deviceKey": "104zf_test_js",
    "assetId": "iSNiomzT",
    "commandType":"setMeasurementPoint",
    "tslIdentifier":"temperature",
    "inputData": {
            "temperature": 30.5
        }
}

指令类型: Invoke Service

在调用 Invoke Service API 后,Command 节点将自动获取到指定设备的 command ID, product key, command type 等信息,并作为 msg 输出。


tslIdentifier 是模型中定义的服务标识符,而 inputData 中的 key:value 将以模型中的服务定义为准,其中 key 可以是 string, integer, array 等。


{
    "commandId":"commandId",
    "productKey": "UgbJtiGV",
    "deviceKey": "104zf_test_js",
    "assetId": "iSNiomzT",
    "commandType":"invokeService",
    "tslIdentifier":"tslIdentifier",
    "inputData": {
            "parameter_1": 1.3,
            "parameter_2": 13
        }
}

相关节点