Saltar al contenido principal
CloudStudio

Sensores de consumo de energía

Reporte de energía acumulada en Wh y VARh

La integración de sensores de energía por HTTP lleva la siguiente estructura:

POST /services/gear/DeviceIntegrationService.svc/UpdateEnergySensorValueSummation HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"activeEnergySummationWh": 112685.9,
	"reactiveEnergySummationVARh": 18973.4,
	"timestamp": "2021-02-23T14:55:03"
}

Parámetros

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.texto
endpointIDIdentificador único del endpoint o combinación de dirección del dispositivo y dirección del endpoint con formato [deviceAddress]:endpointAddress (Ej: [device-1234]:1). Estos valores pueden verse en la página de administración de endpoints.numérico
activeEnergySummationWhValor acumulado de energía activa informado por el sensor, expresado en watt-hora (Wh).numérico
reactiveEnergySummationVARhValor acumulado de energía reactiva informado por el sensor, expresado en volt-ampere-reactivo-hora (VARh).numérico
timestampValor opcional indicando la fecha y hora UTC correspondiente a la medición. El formato en que se indique esta fecha debe coincidir con alguno de los indicados en la sección formatos de fecha. En caso de que el campo sea omitido, la plataforma asumirá que la medición corresponde a la fecha y hora actuales.text

Reporte de energía acumulada en formato "raw"

La energía acumulada puede ser reportada como un valor crudo (raw), utilizando el conversor de expresiones. Esta opción es conveniente cuando el dispositivo no es capaz de realizar conversiones, y emite valores que necesitan ser transformados antes de inyectarse en la plataforma.

A continuación, se muestra un ejemplo de una petición en formato raw:

POST /services/gear/DeviceIntegrationService.svc/UpdateFlowSensorValueSummationRaw HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"rawData": "112685.9,18973.4",
	"timestamp": "2021-02-23T14:55:03"
}

Como puede verse en este ejemplo, el campo RawData combina el acumulado de energía activa y el acumulado de energía reactiva en un único string, en el que ambos valores están separados por una coma.

Parámetros

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.texto
endpointIDIdentificador único del endpoint, que puede verse en la página de administración de endpoints.numérico
rawDataValor reportado por el sensor, como texto. Deben indicarse dos expresiones en el conversor de expresiones. La primera expresión se utiliza para obtener la energía activa acumulada a partir de la variable rawData. La expresión debe devolver un valor numérico indicando expresado en expresado en watt-hora (Wh). En el ejemplo anterior, podría utilizarse la siguiente expresión:ToNumber(StringPart(rawData, 1, ','))La segunda expresión se utiliza para obtener la energía reactiva acumulada a partir de la variable rawData. La expresión debe devolver un valor numérico indicando expresado en expresado volt-ampere-reactivo-hora (VARh). En el ejemplo anterior, podría utilizarse la siguiente expresión:ToNumber(StringPart(rawData, 2, ','))texto
timestampValor opcional indicando la fecha y hora UTC correspondiente a la medición. El formato en que se indique esta fecha debe coincidir con alguno de los indicados en la sección formatos de fecha. En caso de que el campo sea omitido, la plataforma asumirá que la medición corresponde a la fecha y hora actuales.text

Última actualización

En esta página