Aller au contenu principal
CloudStudio

Capteurs de flux génériques

The integration 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

The integration 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"
}

Parameters

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier or combination of device address and endpoint address in format [deviceAddress]:endpointAddress (e.g.: [device-1234]:1). These values can be found on the endpoint management page.text
summationValueValor acumulado de flujo informado por el sensor. Las unidades son las mismas que las elegidas para la variable genérica asociada al sensor.numeric
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.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"
}

Parameters

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier, which can be found on the endpoint management page.numeric
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.text
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.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

Dernière mise à jour le

Sur cette page