Integración de dispositivos
Introducción
Esta sección explica cómo integrar dispositivos en la plataforma Gear Studio, es decir:
- Cómo conseguir que los dispositivos envíen datos a la plataforma.
- Cómo conseguir que la plataforma envíe datos hacia los dispositivos, en caso de que los dispositivos lo permitan.
Una vez que un dispositivo está integrado en la plataforma, es posible conseguir lo siguiente:
- Crear dashboards que muestren el estado de los dispositivos en tiempo real.
- Observar la información en una variedad de reportes.
- Crear alertas configurables, con notificaciones vía e-mail y SMS.
- Exportar la información utilizando APIs.
- Monitorear y controlar los dispositivos desde las aplicaciones web de Gear Studio.
- Monitorear y controlar los dispositivos desde iOS y Android utilizando la app de Gear Studio.
Importante: la integración de dispositivos no sólo está disponible para dispositivos comerciales, sino que también permite conectar dispositivos hechos a medida basados en Arduino, nodeMCU, Raspberry Pi y muchos más.
Si no estás seguro de qué es exactamente un “dispositivo”, puedes utiliza esta página para aprender más sobre dispositivos y endpoints.
Conceptos principales
Mensajes de datos
Las integraciones se encargan principalmente de procesar los mensajes recibidos desde los dispositivos de manera que puedan ser procesados por la plataforma, así como de convertir comandos enviados por la plataforma a un formato que los dispositivos puedan procesar. Se consideran dos tipos de mensaje:
- Uplink: los mensajes de uplink son todos aquellos enviados desde los dispositivos hacia la plataforma. La plataforma debe ser capaz de procesar los mensajes de uplink para almacenar la información relevante, y procesarla.
- Downlink: los mensajes de downlink son aquellos enviados desde la plataforma hacia los dispositivos, típicamente en la forma de comandos. Algunos dispositivos no soportan mensajes de uplink, mientras que otros sólo los soportan para operaciones específicas de configuración.
Muchos dispositivos disponen de una integración nativa en la plataforma Gear Studio, y no es necesario hacer más que conectarlos y configurarlos correctamente. Para los dispositivos no soportados nativamente, la integración consiste en definir cómo se procesan los mensajes de uplink, y cómo se construyen los mensajes de downlink.
Modelos de dispositivo
El procesamiento de mensajes de uplink y downlink se realiza por cada modelo de dispositivo. Para los dispositivos soportados nativamente, la integración ya está disponible sin necesidad de trabajo adicional.
Cuando un dispositivo no está soportado nativamente, la integración consiste, mayormente, en crear un modelo de dispositivo que lo represente correctamente, e indicar cómo se procesan los mensajes de uplink, y cómo se construyen los mensajes de downlink. En estos casos es posible utilizar scripts que hagan automáticamente todo el trabajo, de modo que esos modelos de dispositivo se comporten de la misma forma que si fueran soportados nativamente.
Primeros pasos
Creación de un access token
Para las integraciones que se realicen a través de HTTP, MQTT, o LoRaWAN, es primero necesario crear un token de accesso (access token). Esta página contiene más información sobre la administración de tokens de acceso. Los access tokens permiten controlar el acceso y los permisos utilizados para cualquier operación.
Selección de un modelo de dispositivo
Es importante comprender si el dispositivo a integrar está soportado nativamente en la plataforma. Si es así, no es necesario ningún trabajo adicional. Sin embargo, si el modelo de dispositivo no está soportado, será necesario crear un nuevo modelo de dispositivo. Puede verse esta referencia para más información sobre este tema.
Creación de un dispositivo
Una vez que se cuenta con un access token, y la plataforma contiene el modelo de dispositivo a integrar, sólo resta crearlo en la plataforma, para que pueda conectarse. Esto puede lograrse siguiendo esta guía. Si no estás seguro de qué es exactamente un “dispositivo”, puedes utiliza esta página para aprender más sobre dispositivos y endpoints.
Si el modelo de dispositivo está soportado nativamente, o bien se ha creado un modelo de dispositivo que lo represente, y un script que defina los endpoints que contiene, no es necesario ningún otro paso. Sin embargo, en algunos casos, puede ser necesario que crees endpoints dentro del dispositivo en forma manual. En ese caso, puedes hacerlo siguiendo esta guía. Si no estás seguro de qué es exactamente un “endpoint”, puedes utilizar esta página para aprender más sobre dispositivos y endpoints.
Opciones de integración
Actualmente, existen tres alternativas de integración, que se detallan a continuación.
| Integración | Referencia / ayuda |
|---|---|
| MQTT | Integración de dispositivos por MQTT |
| HTTP | Integración de dispositivos por HTTP |
| LoRaWAN | Integración a través de The Things StackIntegración a través de ThingParkIntegración a través de Helium |
Reemplazo de Variable Global
Es el proceso mediante el cual una variable local (definida por un cliente) es eliminada y sustituida por una Variable global , Realizando esta alteración en...
MQTT
Introducción Esta sección describe la integración con la plataforma Gear Studio utilizando MQTT. Esta funcionalidad está orientada a permitir la integración...