Introducción a la incorporación de sus dispositivos de Sidewalk

Creación de un perfil de dispositivo

Cree un perfil de dispositivo que contenga las configuraciones compartidas de los dispositivos de Sidewalk. Al crear el perfil, especifique un name para el perfil como cadena alfanumérica. Para crear un perfil, vaya a la pestaña Sidewalk del Centro de Perfiles de la consola de AWS IoT y elija Crear perfil o utilice la operación CreateDeviceProfile de la API o el comando create-device-profile de la CLI, como se muestra en este ejemplo.

// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}

Creación del dispositivo final de Sidewalk

Cree el dispositivo final Sidewalk con AWS IoT Core para Amazon Sidewalk. Especifique un nombre de destino y el ID del perfil de dispositivo obtenido en el paso anterior. Para crear un dispositivo, vaya a la pestaña Sidewalk del Centro de dispositivos de la consola de AWS IoT y elija Aprovisionar dispositivo o utilice la operación CreateWirelessDevice de la API o el comando create-wireless-device de la CLI, como se muestra en este ejemplo.

// Add your Sidewalk device by using the device profile ID. 
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \ 
    --destination-name SidewalkDestination \
    --sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"

Obtención del perfil de dispositivo y la información del dispositivo inalámbrico

Obtenga el perfil de dispositivo y la información del dispositivo inalámbrico como un JSON. El JSON contendrá información sobre los detalles y los certificados del dispositivo, las claves privadas, el DeviceTypeId y el número de serie del fabricante de Sidewalk (SMSN).

Creación del rol de IAM

Cree un rol de IAM que le conceda a AWS IoT Core para Amazon Sidewalk el permiso necesario para enviar datos a la regla de AWS IoT. Para crear el rol, utilice la operación CreateRole de la API o el comando create-role de la CLI. Puede nombrar el rol como SidewalkRole.

aws iam create-role --role-name lambda-ex \ 
    --assume-role-policy-document file://lambda-trust-policy.json

Creación de una regla para el destino

Cree una regla de AWS IoT que procesará los datos del dispositivo y especificará el tema en el que se publicarán los mensajes. Observará los mensajes sobre este tema después de conectarse a la plataforma de hardware. Para crear una regla para el destino, utilice la operación de la API de AWS IoT Core, CreateTopicRule, o el comando de la AWS CLI, create-topic-rule.

aws iot create-topic-rule --rule-name Sidewalkrule \ 
    --topic-rule-payload file://myrule.json

Creación de un destino

Cree un destino que asocie su dispositivo de Sidewalk con la regla de IoT que lo procesa para usarlo con otros Servicios de AWS. Puede agregar un destino mediante el Centro de destinos de la consola de AWS IoT, la operación CreateDestination de la API o el comando create-destination de la CLI.

aws iotwireless create-destination --name SidewalkDestination \
    --expression-type RuleName --expression SidewalkRule \
    --role-arn arn:aws:iam::123456789012:role/SidewalkRole

Conexión del dispositivo final de Sidewalk

Conecte el HDK al equipo y siga las instrucciones indicadas en la documentación del proveedor para conectarse al HDK. Para obtener más información, consulte Aprovisionamiento y registro de un dispositivo final en la documentación de Amazon Sidewalk.

Visualización e intercambio de mensajes

Utilice el cliente MQTT para suscribirse al tema especificado en la regla y ver el mensaje recibido. También puede usar la operación SendDataToWirelessDevice de la API o el comando send-data-to-wireless-device de la CLI para enviar un mensaje de enlace descendente al dispositivo y verificar el estado de conectividad.

(Opcional) Puede habilitar el evento de estado de entrega del mensaje para comprobar si el mensaje del enlace descendente se ha recibido correctamente.

aws iotwireless send-data-to-wireless-device \
    --id "<Wireless_Device_ID>" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}