En esta sección podrás ver como implementar equipos de terceras partes a nuestra plataforma Gear. De esta manera podrás controlar y conocer los estados de los dispositivos. También ver esta información en dashboards personalizados y generar reportes.
Esta funcionalidad está orientada a permitir la integración con dispositivos hechos con Arduino, nodeMCU, Raspberry Pi y demás.
Para conectarse a nuestro servidor MQTT es necesario hacerlo a través del puerto 8883. Se requiere usuario, contraseña y certificado TLS. Dónde el usuario es el client secure id. El mismo que se debe utilizar como sufijo de los topics. De esta manera, este usuario solo tendrá privilegios para leer y escribir sobre los topics que correspondan a su sufijo/usuario.
Las credenciales serán brindadas por el equipo de Cloud Studio.
El ClientID de MQTT debe ser un valor único por cada conexion que se realice al Broker. Sugerimos utilizar la siguiente nomenclatura:
{client-secure-id}{valor-generico}
Ej: 16SAD5656S01
Dónde:
Para realizar el request por MQTT el topic siempre será {client-secure-id}/HttpApi/DeviceIntegration, donde cliente-secure-id es el usuario único por cliente, además para cada petición cambiará el método por el deseado.
Si la petición se pudo ejecutar, se responderá a través del topic de respuestas. Siguiendo el formato especificado. Para mas información de las respuestas ver la documentación.
Es importante el uso del parámetro "mqttRID" para poder identificar la respuesta correspondiente a la petición realizada.
El topic donde se publicarán las respuestas será {client-secure-id}/HttpApi/DeviceIntegrationResponse. Es necesario realizar una suscripción a este topic para detectar cuando hayan respuestas para las peticiones realizadas.
El payload que se obtendrá es el siguiente: