IoT Platform:Crear un dispositivo de puerta de enlace (MQTT)

Requisitos previos

Debe haber agregado una puerta de enlace y creado un producto de puerta de enlace que utilice verificación de primera parte. Para obtener más información, consulte Create a gateway product (MQTT).

Contexto

• Después de crear una puerta de enlace en la nube con Third-party Authentication, IoT Platform crea automáticamente un dispositivo basado en el valor deviceName devuelto cuando el dispositivo se conecta por primera vez.

  Puede usar MQTT.fx para simular un dispositivo que se conecta a IoT Platform a través de la puerta de enlace en la nube. Para obtener más información, consulte Use MQTT.fx to connect a device (Alibaba Cloud FC authentication).

• Después de crear una puerta de enlace que utiliza one-party verification, importe la información de verificación del dispositivo a IoT Platform para crear dispositivos de puerta de enlace.

Agregar dispositivos por lotes

1. Inicie sesión en la consola de IoT Platform.

2. En la página Instance Overview, haga clic en la instancia Enterprise objetivo de Exclusive Edition.

3. En el panel de navegación izquierdo, seleccione Device Management > Products. Busque el producto de puerta de enlace que creó y haga clic en Manage Devices en la columna Actions.

4. En la página Devices, haga clic en Batch Add.

5. En el cuadro de diálogo Batch Add Devices, haga clic en Download .csv Template.

6. En la plantilla, complete los campos SN, nombre de usuario MQTT y contraseña MQTT, y luego guarde el archivo.

   Importante

   • El nombre de usuario MQTT y la contraseña MQTT son obligatorios. El SN es opcional.

   • El nombre de usuario MQTT debe tener entre 4 y 32 caracteres y puede contener letras, dígitos, guiones (-), guiones bajos (_), arrobas (@), puntos (.) y dos puntos (:). Cada nombre de usuario MQTT debe ser único por producto.

   • La contraseña MQTT debe tener entre 1 y 32 caracteres y puede contener letras, dígitos, guiones (-), guiones bajos (_), arrobas (@), puntos (.) y dos puntos (:).

   • Un solo archivo puede contener un máximo de 10,000 registros de dispositivos. No importe dispositivos duplicados.

7. Regrese al cuadro de diálogo Batch Add Devices, haga clic en Upload File, seleccione el archivo guardado y luego haga clic en OK.

   Una vez cargado el archivo, el cuadro de diálogo muestra el estado Parsing Completed y el Total Devices. Después de confirmar la información, haga clic en OK.

   Si la lista de dispositivos contiene información no válida, aparecerá un mensaje de error. Haga clic en Download Invalid List, revise las entradas no válidas, corríjalas y vuelva a cargar el archivo.

   El mensaje de error indica los campos específicos no válidos, como un SN, nombre de usuario MQTT o contraseña MQTT incorrectos. Compruebe y corrija la información antes de volver a cargar el archivo.

Referencia de API

Resultados

Una vez importada la información de verificación del dispositivo, IoT Platform crea un dispositivo para cada entrada y utiliza el nombre de usuario MQTT cargado como nombre del dispositivo. Los nuevos dispositivos de puerta de enlace aparecen en la página Device Management > Devices. En la Device List, el node type de cada dispositivo es device, su estado es inactive, el dispositivo está habilitado y la columna Last Online Time se encuentra vacía.

Siguientes pasos

Después de crear los dispositivos de puerta de enlace, debe actualizar sus endpoints:

• Si los dispositivos ya tienen un endpoint configurado, cree un registro CNAME para asignar ese endpoint a la URL de la puerta de enlace. Para obtener más información sobre la configuración de DNS, consulte Alibaba Cloud DNS.

• Si los dispositivos no tienen un endpoint configurado, debe configurar la URL de la puerta de enlace en los dispositivos. Para obtener más información, consulte Connect a device over MQTT.

Para encontrar la URL de la puerta de enlace, consulte View the gateway URL.

Para obtener más información sobre cómo los dispositivos de puerta de enlace se conectan a IoT Platform para comunicarse, consulte Messaging overview.

Puede usar MQTT.fx para simular un dispositivo de puerta de enlace y conectarlo a IoT Platform para establecer comunicación. Para obtener más información, consulte Connect a device by using MQTT.fx (one-party verification).