有功功率传感器
报告有功功率 in Watts
的 HTTP 集成 active power sensors使用以下结构:
POST /services/gear/DeviceIntegrationService.svc/UpdateActivePowerSensorStatus HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"activePowerWatts": 18.5,
"timestamp": "2021-02-23T14:55:03"
}参数
| 名称 | 说明 | 数据类型 |
|---|---|---|
| accessToken | 具有更新端点信息权限的访问令牌。更多信息请参见该页面。 | text |
| endpointID | 唯一端点标识符或设备地址与端点地址的组合(格式为 [deviceAddress]:endpointAddress,例如:[device-1234]:1)。这些值可以在端点管理页面找到。 | numeric |
| activePowerWatts | Active power, ex按下ed in Watts. | numeric |
| timestamp | 可选值,表示与测量对应的 UTC 日期和时间。日期格式必须与日期格式部分指定的格式之一相匹配。如果省略该字段,平台将假定测量对应于当前日期和时间。 | text |
报告有功功率 in "raw" Format
Active power 可以以 raw 值 使用 ex按下ion converter. 当设备无法执行转换并发出需要在注入平台前进行转换的值时,此选项很方便。
下面是 raw 格式请求的示例:
POST /services/gear/DeviceIntegrationService.svc/UpdateActivePowerSensorStatusRaw HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"rawData": "18.5",
"timestamp": "2021-02-23T14:55:03"
}参数
| 名称 | 说明 | 数据类型 |
|---|---|---|
| accessToken | 具有更新端点信息权限的访问令牌。更多信息请参见该页面。 | text |
| endpointID | 唯一端点标识符,可以在端点管理页面找到。 | numeric |
| rawData | 传感器报告的值,以文本形式。必须在表达式转换器中指定表达式。表达式必须返回一个数值 indicating the measured active power, ex按下ed in Watts. | text |
| timestamp | 可选值,表示与测量对应的 UTC 日期和时间。日期格式必须与日期格式部分指定的格式之一相匹配。如果省略该字段,平台将假定测量对应于当前日期和时间。 | text |