Introdução à integração de seus dispositivos do Sidewalk

Criar um perfil do dispositivo

Crie um perfil de dispositivo que contenha as configurações compartilhadas para seus dispositivos do Sidewalk. Ao criar o perfil, especifique um name para o perfil como uma sequência alfanumérica. Para criar um perfil, vá até a guia Sidewalk do hub Perfis no console de AWS IoT e escolha Criar perfil, ou use a operação da API CreateDeviceProfile ou o comando da CLI create-device-profile, conforme mostrado neste exemplo.

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

Crie seu dispositivo final do Sidewalk

Crie o dispositivo final do Sidewalk com o AWS IoT Core para Amazon Sidewalk. Especifique um nome de destino e a ID do perfil do dispositivo obtido na etapa anterior. Para adicionar um dispositivo, vá até a guia Sidewalk do hub Dispositivos no console de AWS IoT e escolha Provisionar dispositivo, ou use a operação da API CreateWirelessDevice ou o comando da CLI create-wireless-device, conforme mostrado neste exemplo.

// 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"

Obtenha informações sobre o perfil do dispositivo e o dispositivo sem fio

Obtenha as informações sobre o perfil do dispositivo e o dispositivo sem fio como um JSON. O JSON conterá informações sobre os detalhes do dispositivo, certificados do dispositivo, chaves privadas DeviceTypeId e o número de série de fabricação do Sidewalk (SMSN).

Crie o perfil do IAM

Crie um perfil do IAM que conceda permissão ao AWS IoT Core para Amazon Sidewalk para enviar dados à regra do AWS IoT. Para criar o perfil, use a operação de API CreateRole ou o comando de CLI create-role. Você pode nomear o perfil como SidewalkRole.

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

Crie uma regra para o destino

Crie uma regra de AWS IoT que processe os dados do dispositivo e especifique o tópico no qual as mensagens são publicadas. Você observará mensagens sobre esse tópico depois de se conectar à plataforma de hardware. Use a operação da API AWS IoT Core, CreateTopicRule, ou o comando da AWS CLI, create-topic-rule, para criar uma regra para o destino.

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

Crie um destino

Crie um destino que associe seu dispositivo Sidewalk à regra de IoT que o processa para uso com outros Serviços da AWS. Você pode adicionar um destino usando o hub Destinos do console de AWS IoT, a operação da API CreateDestination ou o comando da CLI create-destination.

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

Conecte seu dispositivo final do Sidewalk

Conecte o HDK ao seu computador e siga as instruções fornecidas pela documentação do fornecedor para conectar-se ao seu HDK. Para obter mais informações, consulte Provisionamento e registro do seu dispositivo final na documentação do Amazon Sidewalk.

Ver e trocar mensagens

Use o cliente MQTT para assinar o tópico especificado na regra e visualizar a mensagem recebida. Você também pode usar a operação da API SendDataToWirelessDevice ou o comando da CLI send-data-to-wireless-device para enviar uma mensagem de downlink para o seu dispositivo e verificar o status da conectividade.

(Opcional) Você pode ativar o evento de status de entrega da mensagem para verificar se a mensagem de downlink foi recebida com sucesso.

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