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.

nota

Para obter informações sobre como conectar sua plataforma de hardware e configurá-la, consulte Provisionamento e registro do seu dispositivo final e Configuração do kit de desenvolvimento de hardware (HDK) na documentação do Amazon Sidewalk.

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

nota

A API SendDataToWirelessDevice pode retornar um ID de mensagem, mas a mensagem talvez não seja entregue com sucesso. Para verificar o status da mensagem que foi enviada ao dispositivo, você pode ativar eventos de status de entrega de mensagens para suas contas e dispositivos do Sidewalk. Para obter mais informações sobre como ativar esse evento, consulte Notificações de eventos para recursos do Sidewalk. Para obter mais informações sobre esse tipo de evento, consulte Eventos de entrega de mensagens.

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.

Parâmetros de metadados de uplink do Sidewalk
Parâmetro	Descrição	Tipo	Obrigatório
PayloadData	A carga útil da mensagem enviada do dispositivo sem fio.	String	Sim
WirelessDeviceID	O identificador do dispositivo sem fio que está enviando os dados	String	Sim
Sidewalk.CmdExStatus	Status do runtime do comando. As mensagens do tipo de resposta devem incluir o código de status, COMMAND_EXEC_STATUS_SUCCESS. No entanto, as notificações talvez não incluam o código de status.	Enumeração	Não
Sidewalk.NackExStatus	Status nack da resposta, que pode ser RADIO_TX_ERROR ou MEMORY_ERROR.	Matriz de strings	Não