Command¶
Command 是触发器类型的节点,可以获取到应用对于设备的控制指令。应用可以通过调用 EnOS open API 向 IoT Hub 的设备发送指令,当设备在线时,Command 节点将自动获取到对应的指令信息,如该设备的 product key, device key, command ID 等,再通过 Script 节点做对应的数据转换,再发向对应的设备或系统。
当前提供两个 open API 供应用程序调用:Set Measurement Point 和 Invoke Service。
节点类型¶
Trigger。
输入和输出能力¶
该节点没有入口点,具有 1 个出口点。输入和输出都是 JSON 格式。
节点属性¶
名称
必填。
该节点的名称。
产品
必填。
作为指令发送对象的设备的产品。
描述
选填。
该节点的描述。
使用限制¶
只能选择一种产品。
示例¶
输入示例¶
该节点不接收任何输入消息。
输出示例¶
指令类型: Set Measurement Point¶
在调用 Set Measurement Point API 后,Command 节点将自动获取到指定设备的 command ID, product key, command type 等信息,并作为 msg 输出。
inputData
中 key:value 的 key 和 value 将分别为待设置的测点和值。例如,将温度设置为 30.5 度,key 将是 temperature、 value 为 30.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
}
}