Saltar al contenido principal
CloudStudio

Sensores genéricos de flujo

La integración de sensores de flujo genéricos utiliza la misma API que los sensores de flujo no-genéricos. La única diferencia es que los sensores genéricos deben informar el flujo utilizando la unidad de medida correspondiente a la variable genérica asociada al sensor.

Reporte de flujo acumulado en unidades

La integración de sensores genéricos de flujo por MQTT lleva la siguiente estructura, que es idéntica a la de los sensores de flujo no-genéricos:

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"summationValue": 112685,
	"timestamp": "2021-02-23T14:55:03",
	"mqttMethod": "UpdateFlowSensorValueSummation",
	"mqttRID": "tkrs34"
}

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.texto
summationValueValor acumulado de flujo informado por el sensor. Las unidades son las mismas que las elegidas para la variable genérica asociada al sensor.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
mqttMethodMétodo correspondiente del servicio, en este caso UpdateFlowSensorValueSummationstring
mqttRIDIdentificador opcional para la petición, en caso de que se desee obtener una respuesta de confirmación.string

Reporte de flujo acumulado en formato "raw"

El flujo puede ser reportado 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:

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"rawData": "112685",
	"timestamp": "2021-02-23T14:55:03",
	"mqttMethod": "UpdateFlowSensorValueSummationRaw",
	"mqttRID": "tkrs34"
}

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. Debe indicarse una expresión en el conversor de expresiones. La expresión debe devolver un valor numérico indicando el valor acumulado de flujo informado por el sensor, expresado en las unidades de la variable genérica asociada al sensor.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
mqttMethodMétodo correspondiente del servicio, en este caso UpdateFlowSensorValueSummationRawstring
mqttRIDIdentificador opcional para la petición, en caso de que se desee obtener una respuesta de confirmación.string

Última actualización

En esta página