Agregación del perfil del dispositivo y el dispositivo final de Sidewalk - AWS IoT Wireless
Agregación del dispositivo de Sidewalk (consola)Agregación del dispositivo de Sidewalk (CLI)

Agregación del perfil del dispositivo y el dispositivo final de Sidewalk

En esta sección se muestra cómo puede crear un perfil de dispositivo. También muestra cómo puede usar la consola de AWS IoT y la AWS CLI para añadir el dispositivo final Sidewalk a AWS IoT Core para Amazon Sidewalk.

Agregación del dispositivo de Sidewalk (consola)

Para añadir el dispositivo de Sidewalk mediante la consola de AWS IoT, vaya a la pestaña Sidewalk del Centro de dispositivos, seleccione Aprovisionar dispositivo y, a continuación, lleve a cabo los siguientes pasos.

  1. Especificación de los detalles del dispositivo

    Especifique la información de configuración del dispositivo de Sidewalk. También puede crear un nuevo perfil de dispositivo o elegir un perfil existente para el dispositivo de Sidewalk.

    1. Especifique un nombre de dispositivo y una descripción opcional. La descripción puede tener una longitud máxima de 2048 caracteres. Estos campos se pueden editar después de crear el dispositivo.

    2. Elige un perfil de dispositivo para asociarlo al dispositivo de Sidewalk. Si ya tiene algún perfil de dispositivo, puede elegir su perfil. Si crea un nuevo perfil, seleccione Crear nuevo perfil y, a continuación, introduzca un nombre para el mismo.

      nota

      Para asociar etiquetas al perfil del dispositivo, después de crearlo, vaya al Centro de perfiles y, a continuación, edite su perfil para añadir esta información.

    3. Especifica el nombre del destino que enrutará los mensajes del dispositivo a otros Servicios de AWS. Si aún no ha creado un destino, vaya al Centro de destinos para crearlo. A continuación, podrá elegir ese destino para el dispositivo de Sidewalk. Para obtener más información, consulte Agregación de un destino para el dispositivo final de Sidewalk.

    4. Seleccione Siguiente para seguir añadiendo el dispositivo de Sidewalk.

  2. Asociación del dispositivo de Sidewalk a un objeto de AWS IoT (opcional)

    Si lo desea, puede asociar su dispositivo de Sidewalk a un objeto de AWS IoT. Los objetos de IoT son entradas del registro de dispositivos de AWS IoT. Los objetos facilitan la búsqueda y la administración de los dispositivos. Al asociar un objeto al dispositivo, este puede acceder a otras características de AWS IoT Core.

    Para asociar el dispositivo a un objeto, seleccione Registro de objetos automático.

    1. Introduzca un nombre único para el objeto de IoT al que quiera asociar el dispositivo de Sidewalk. Los nombres de los objetos distinguen mayúsculas de minúsculas y deben ser únicos en su Cuenta de AWS y Región de AWS.

    2. Proporcione cualquier configuración adicional para el objeto de IoT, como usar un tipo de objeto o atributos con búsqueda permitida que se puedan usar para filtrar una lista de objetos.

    3. Seleccione Siguiente, verifique la información sobre el dispositivo de Sidewalk y, a continuación, seleccione Crear.

Agregación del dispositivo de Sidewalk (CLI)

Para añadir el dispositivo de Sidewalk y descargar los archivos JSON que se utilizarán para aprovisionar el dispositivo de Sidewalk, realice las siguientes operaciones de API.

Paso 1: Creación de un perfil de dispositivo

Para crear un perfil de dispositivo en la Cuenta de AWS, utilice la operación CreateDeviceProfile de la API o el comando create-device-profile de la CLI. Al crear el perfil de dispositivo, especifique el nombre y proporcione etiquetas opcionales como pares de nombre-valor.

Por ejemplo, el comando siguiente crea un perfil de dispositivo para los dispositivos de Sidewalk:

aws iotwireless create-device-profile \ 
    --name sidewalk_profile --sidewalk {}

La ejecución de este comando devuelve el nombre de recurso de Amazon (ARN) y el ID del perfil de dispositivo como salida.

{
    "DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Paso 2: Agregación del dispositivo de Sidewalk

Para añadir el dispositivo Sidewalk a su cuenta de AWS IoT Core para Amazon Sidewalk, utilice la operación API CreateWirelessDevice o el comando create-wireless-device de la CLI. Al crear el dispositivo, especifique los siguientes parámetros, además de un nombre y una descripción opcionales para el dispositivo de Sidewalk.

nota

Si desea asociar el dispositivo Sidewalk a un objeto de AWS IoT, utilice la operación API AssociateWirelessDeviceWithThing o el comando associate-wireless-device-with-thing de la CLI.

El comando siguiente muestra un ejemplo de creación de un dispositivo de Sidewalk:

aws iotwireless create-wireless-device \ 
     --cli-input-json "file://device.json"

A continuación se muestra el contenido del archivo device.json.

Contenido de device.json

{
  "Type": "Sidewalk",
  "Name": "SidewalkDevice",  
  "DestinationName": "SidewalkDestination",
  "Sidewalk": {
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"    
    }
}

La ejecución de este comando devuelve el ID del dispositivo y el nombre de recurso de Amazon (ARN) como salida.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678"
}