Aprovisionamiento de dispositivos de Sidewalk mediante tareas de importación - AWS IoT Wireless
Cómo funciona el aprovisionamiento por lotes de SidewalkConsideraciones clave para el aprovisionamiento por lotes de SidewalkFormato de archivo CSVCómo utilizar el aprovisionamiento por lotes de Sidewalk

Aprovisionamiento de dispositivos de Sidewalk mediante tareas de importación

En esta sección, se muestra cómo puede aprovisionar dispositivos Sidewalk de forma masiva mediante la consola de AWS IoT, las operaciones API de AWS IoT Core para Amazon Sidewalk o la AWS CLI. En las secciones siguientes se explica cómo aprovisionar por lotes los dispositivos de Sidewalk.

Temas

Cómo funciona el aprovisionamiento por lotes de Sidewalk

Los siguientes pasos ilustran cómo funciona el aprovisionamiento por lotes.

  1. Inicio de la tarea de importación de dispositivos inalámbricos

    Para aprovisionar los dispositivos Sidewalk de forma masiva, debe crear una tarea de importación y proporcionar el número de serie del fabricante de Sidewalk (SMSN) de los dispositivos que se van a incorporar a AWS IoT Core para Amazon Sidewalk. Obtuvo el número de serie de fabricación de Sidewalk (SMSN) de los dispositivos en un archivo CSV en un correo electrónico después de que el fabricante cargara los registros de control en Amazon Sidewalk. Para obtener más información sobre el flujo de trabajo y cómo obtener el registro de control, consulte Fabricación de dispositivos de Amazon Sidewalk en la documentación de Amazon Sidewalk.

  2. Ejecución del proceso de importación en segundo plano

    Cuando AWS IoT Core para Amazon Sidewalk recibe la solicitud de tarea de importación, comienza a configurarlo todo e inicia un proceso en segundo plano que sondea el sistema con frecuencia. Una vez que el proceso en segundo plano recibe la instrucción de la tarea de importación, comienza a leer el archivo CSV. AWS IoT Core para Amazon Sidewalk comprueba simultáneamente si se han recibido los registros de control de Amazon Sidewalk.

  3. Creación de registros de dispositivos inalámbricos

    Cuando Amazon Sidewalk recibe el registro de control, AWS IoT Core para Amazon Sidewalk comprueba si los números de serie del registro de control coinciden con los valores de SMSN del archivo CSV. Si los números de serie coinciden, AWS IoT Core para Amazon Sidewalk empezará a crear registros de dispositivos inalámbricos para los dispositivos Sidewalk que correspondan a dichos números de serie. Una vez incorporados todos los dispositivos, la tarea de importación se marca como Completada.

Consideraciones clave para el aprovisionamiento por lotes de Sidewalk

A continuación, se explican algunos factores importantes a la hora de aprovisionar los dispositivos Sidewalk de forma masiva en AWS IoT Core para Amazon Sidewalk.

  • Debe realizar el aprovisionamiento masivo mediante la consola de AWS IoT o las operaciones API de AWS IoT Core para Amazon Sidewalk en la misma Cuenta de AWS en la que creó el perfil de dispositivo.

  • Antes de aprovisionar por lotes los dispositivos de Sidewalk, el perfil de dispositivo ya debe contener información de DAK que indique el soporte técnico de fábrica. De lo contrario, el aprovisionamiento por lotes mediante la consola de AWS IoT o las operaciones de la API de aprovisionamiento por lotes pueden producir un error.

  • Tras iniciar una tarea de importación, procesar el archivo CSV, importar los dispositivos inalámbricos e incorporarlos a AWS IoT Core para Amazon Sidewalk puede tardar, al menos, 10 minutos.

  • Una vez iniciada, la tarea de importación de dispositivos inalámbricos se ejecutará durante 90 días. Durante este tiempo, comprueba si los registros de control se han recibido de Amazon Sidewalk. Si Amazon Sidewalk no recibe el registro de control antes de transcurridos 90 días, la tarea se marcará como Completada con un mensaje que indicará que ha caducado cuando se consulten los detalles de la tarea. El estado de incorporación de los dispositivos de la tarea de importación que estaban esperando el registro de control se marcará como Error.

  • Cuando se intenta actualizar una tarea de importación que ya se ha creado, solo pueden añadir dispositivos adicionales a la tarea. Puede añadir nuevos dispositivos en cualquier momento después de crear una tarea de importación y antes de que la tarea haya comenzado en los dispositivos que ya se hayan agregado a la misma. Si el archivo de actualización contiene números de serie de dispositivos que ya existen en la tarea de importación original, estos números se ignorarán.

  • Cuando solicite una operación de actualización, se asumirá el mismo rol de IAM que utilizó al crear la tarea de importación para acceder al archivo CSV del bucket de Amazon S3.

  • Una tarea de importación solo se puede eliminar si ya se ha completado correctamente o si no se ha podido actualizar. Es posible que una tarea no se actualice en casos como cuando se proporcionó un rol de IAM incorrecto o cuando no se encontró un archivo de bucket de Amazon S3. Una tarea de importación no se puede actualizar ni eliminar si está en el estado PENDING.

  • El archivo CSV que importe a la tarea debe utilizar el formato que se describe en la siguiente sección.

Formato de archivo CSV

El archivo CSV contenido en un bucket de Amazon S3 que especifique para la tarea de importación debe tener el siguiente formato:

  • La fila 1 debe usar la palabra clave smsn, que indica que el archivo CSV importado contiene el SMSN de los dispositivos que se van a importar.

  • Las filas 2 y siguientes deben contener el SMSN de los dispositivos que se van a incorporar. El SMSN del dispositivo debe tener el formato de 64 caracteres hexadecimales.

Este archivo JSON muestra un ejemplo de formato de archivo CSV.

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Cómo utilizar el aprovisionamiento por lotes de Sidewalk

En los pasos siguientes se muestra cómo utilizar el aprovisionamiento por lotes de Amazon Sidewalk.

  1. Suministro de los números de serie de dispositivo

    Para aprovisionar los dispositivos de Sidewalk, debe proporcionar los números de serie de los dispositivos que se van a incorporar. Puede aprovisionar los dispositivos mediante cualquiera de los siguientes métodos.

    • Aprovisionar cada dispositivo de forma individual utilizando su número de serie de fabricación de Sidewalk (SMSN). Este método resulta útil cuando se quiere probar el flujo de trabajo e incorporar el dispositivo más rápido sin tener que cargar un archivo CSV con el rol de IAM adecuado ni esperar a que los dispositivos estén listos para incorporarse a la tarea.

    • Aprovisionar los dispositivos en lote proporcionando una URL de bucket de Amazon S3 que contenga el SMSN de los dispositivos que se van a aprovisionar en un archivo CSV. Este método es especialmente útil cuando se cuenta con una gran cantidad de dispositivos para incorporar. En este caso, incorporar cada dispositivo de forma individual puede resultar tedioso. En su lugar, solo tiene que proporcionar la ruta al archivo CSV que se ha cargado en un bucket de Amazon S3 y el rol de IAM para acceder al archivo.

  2. Obtención del estado de la tarea de importación y de incorporación de dispositivos

    Respecto de cada tarea de importación que cree, puede recuperar información sobre el estado de incorporación de la tarea y de los dispositivos añadidos a la misma. También puede ver información de estado adicional, como el motivo por el que no se pudo incorporar una tarea o un dispositivo. Para obtener más información, consulte

  3. (Opcional) Actualización o eliminación de la tarea de importación

    Puede actualizar o eliminar una tarea de importación que ya haya creado.

    • Puede actualizar una tarea de importación y añadirle dispositivos adicionales en cualquier momento antes de que esta comience en los dispositivos que ya se hayan agregado. AWS IoT Core para Amazon Sidewalk asume el mismo rol de IAM que utilizó al crear la tarea de importación. Al crear la tarea, especifique el nuevo archivo CSV que contiene los números de serie de los dispositivos que desea añadir a la tarea.

      nota

      Al actualizar una tarea de importación existente, solo puede añadir dispositivos a la tarea. AWS IoT Core para Amazon Sidewalk realiza una operación de unión entre los dispositivos que ya están en la tarea de importación y los que usted está intentando añadir. Si el nuevo archivo contiene números de serie de dispositivos que ya existen en la tarea de importación, estos números se ignorarán.

    • Puede eliminar una tarea de importación que ya se haya completado correctamente o que no se haya podido actualizar en casos como cuando la información del rol de IAM sea incorrecta o cuando un archivo de bucket de S3 no esté disponible al crear o actualizar una tarea.

Temas