Conecte seu dispositivo do Sidewalk e visualize o formato dos metadados de uplink

Neste tutorial, você usará o cliente de teste MQTT para testar a conectividade e ver as mensagens trocadas entre seu dispositivo final e a Nuvem AWS. Para receber mensagens, no cliente de teste MQTT, assine o tópico especificado ao criar a regra de IoT para o destino. Também é possível enviar uma mensagem de downlink do AWS IoT Core para Amazon Sidewalk ao dispositivo utilizando a operação de API SendDataToWirelessDevice. Você pode verificar se a mensagem foi entregue ativando a notificação de evento de status de entrega da mensagem.

Enviar mensagens de downlink para o dispositivo final

Utilize a operação de API SendDataToWirelessDevice ou o comando send-data-to-wireless-device da CLI para enviar mensagens de downlink do AWS IoT Core para Amazon Sidewalk ao dispositivo final do Sidewalk. O exemplo a seguir mostra como executar esse comando. Os dados da carga útil são o binário a ser enviado, codificado em base64.

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

O exemplo a seguir mostra uma saída da execução desse comando, que é um ID da mensagem de downlink enviada ao dispositivo.

{
    MessageId: "6011dd36-0043d6eb-0072-0008"
}

Visualizar o formato das mensagens de uplink do dispositivo

Depois de conectar seu dispositivo, você pode se inscrever no tópico (por exemplo, project/sensor/observed) que especificou ao criar a regra de destino e observar as mensagens de uplink vindas do dispositivo.

Se você especificou um nome de tópico ao criar o destino, você pode se inscrever no tópico para monitorar mensagens de uplink vindas do dispositivo final. Acesse o cliente de teste MQTT na página Teste do console AWS IoT, insira o nome do tópico (por exemplo, project/sensor/observed) e escolha Inscrição.

O exemplo a seguir mostra o formato das mensagens de uplink enviadas dos dispositivos do Sidewalk para a AWS IoT. O WirelessMetadata contém metadados sobre a solicitação de mensagem.

{
   "PayloadData":"ZjRlNjY1ZWNlNw==",
   "WirelessDeviceId":"wireless_device_id",   
   "WirelessMetadata":{
      "Sidewalk":{
         "CmdExStatus":"Cmd",
         "SidewalkId":"device_id",
         "Seq":0,
         "MessageType":"messageType"
      }
    }
}   

A tabela a seguir mostra uma definição dos diferentes parâmetros nos metadados do uplink. O device-id é o ID do dispositivo sem fio, como ABCDEF1234, e messageType é o tipo de mensagem de uplink recebida do dispositivo.