Conversión de datos crudos (raw)

La conversión de datos crudos realizar cálculos sobre los datos obtenidos de un dispositivo, y adaptarlos a los valores necesarios para introducirlos en la plataforma. Esto permite utilizar dispositivos de prácticamente cualquier marca y modelo, con sólo crear expresiones que permitan convertir los valores entregados por el dispositivo.

¿Cómo puedo inyectar datos crudos en la plataforma?

El envío de datos crudos se realiza, tanto por HTTP como por MQTT, utilizando las APIs terminadas en “Raw”. Por ejemplo, para alimentar la plataforma con información sobre un sensor de temperatura, pero utilizando datos “crudos”, deberá utilizarse la API “UpdateTemperatureSensorStatusRaw”. Se recomienda consultar la siguiente tabla para conocer los métodos disponibles para inyectar datos crudos para cada tipo de endpoint.

Uso de expresiones y la variable “RawData”

Todas las APIs terminadas en “Raw” tienen un parámetro “rawData” en el que el dispositivo debe informar el valor medido. Este valor se convierte internamente en una variable denominada “RawData”, que puede utilizarse en el evaluador de expresiones.

Como ejemplo para una conversión, utilizaremos un sensor de temperatura con las siguientes características:

• Unidades: el dispositivo informa la temperatura en grados Fahrenheit
• Rango de medición: de -30 grados Fahrenheit hasta +140 grados Fahrenheit.
• La temperatura es informada en décimas de grado Fahrenheit (es decir, no tiene decimales, pero está multiplicada por 10).

La plataforma Gear, sin embargo, precisa que las temperaturas sean informadas en grados Celsius, lo cual requiere entonces una conversión. Para lograr esta conversión, será necesario realizar los siguientes pasos:

• Dividir el valor obtenido por 10.
• Y convertir la temperatura recibida de grados Fahrenheit a Celsius.

Para conseguir esto, debería utilizarse la siguiente expresión:

FahrenheitToCelsius(ToNumber(RawData) / 10)

Esta expresión hace lo siguiente:

• Utiliza la variable RawData, que es una variable implícita que existe en todas las operaciones de conversión de datos crudos, y representa el contenido del dato crudo como string.
• Utiliza la función ToNumber para convertir la variable RawData a un valor numérico equivalente.
• Divide el valor obtenido por 10.
• Finalmente, utiliza la función FahrenheitToCelsius para convertir este valor a grados Celsius.

Más información

Para más información sobre el uso de expresiones, ver la sección Expresiones, que contiene una descripción más detallada del motor de expresiones, los tipos de datos, operadores, funciones, y ejemplos de cada uno.