Los dispositivos de puerta de enlace MQTT se comunican con IoT Platform mediante temas personalizados. IoT Platform transmite todos los datos del dispositivo, tanto ascendentes como descendentes.
Temas
IoT Platform se comunica con los dispositivos de puerta de enlace a través de temas MQTT. Debe definir temas personalizados que cumplan con las especificaciones estándar del protocolo MQTT. Para obtener más información, consulte What is a topic.
Un dispositivo utiliza el mismo tema personalizado tanto para enviar datos ascendentes como para recibir datos descendentes.
A continuación se presenta una tabla que compara los temas en IoT Platform con los del protocolo MQTT estándar.
|
Elemento |
IoT Platform |
Protocolo MQTT estándar |
|
Longitud |
El tema debe tener entre 1 y 128 caracteres. |
El tema puede tener hasta 65,535 caracteres. |
|
Conjunto de caracteres |
El tema solo puede contener letras, dígitos y guiones bajos (_). |
El tema puede contener caracteres UTF-8. No existen otras restricciones. |
Límites
Un dispositivo de puerta de enlace MQTT puede suscribirse a un máximo de 100 temas.
Si establece el parámetro Device Operation Authorizations de una categoría de tema en Subscribe, puede especificar los caracteres comodín
plus sign (+)ynumber sign (#)en la categoría de tema para permitir que los dispositivos se suscriban a varios temas simultáneamente. Para obtener más información sobre el uso de caracteres comodín, consulte Custom topics with one or more wildcard characters.
Comunicación ascendente: de los dispositivos a IoT Platform
Un dispositivo publica mensajes en un tema personalizado. IoT Platform recibe estos mensajes mediante una suscripción del lado del servidor AMQP o la función de reenvío de datos.
Al configurar las reglas de reenvío de datos, tenga en cuenta lo siguiente:
Solo la nueva versión de la función de reenvío de datos admite dispositivos de puerta de enlace. Para obtener más información, consulte Configure a data forwarding parser.
No es posible reenviar mensajes entre productos y dispositivos de puerta de enlace de IoT Platform y productos y dispositivos comunes de IoT Platform.
Al reenviar los datos de un dispositivo de puerta de enlace a otro tema, debe configurar el parámetro deviceName. Para obtener más información, consulte Functions to forward data to data destinations.
Para especificar un tema de origen para el reenvío de datos, introduzca el nombre del tema. Para obtener más información, consulte Add a data source.
Las suscripciones del lado del servidor solo admiten los tipos de mensaje Device Upstream Notification, Device Status Change Notification y Device Changes Throughout Lifecycle. Para obtener más información, consulte Configure AMQP server-side subscription.
Comunicación descendente: de IoT Platform a los dispositivos
IoT Platform invoca la operación Pub para publicar mensajes en un tema personalizado. Los dispositivos reciben los mensajes al suscribirse al tema.