Agendar uma mensagem de downlink para enviar para os dispositivos de um grupo de multicast - AWS IoT Wireless
Pré-requisitosAgendar uma mensagem de downlink com o consoleAgendar uma mensagem de downlink com a APIPróximas etapas

Agendar uma mensagem de downlink para enviar para os dispositivos de um grupo de multicast

Após adicionar dispositivos com sucesso a um grupo de multicast, é possível iniciar uma sessão multicast e configurar uma mensagem de downlink para ser enviada a esses dispositivos. A mensagem de downlink deve ser agendada dentro de 48 horas e a hora de início do multicast deve ser pelo menos 30 minutos adiante da hora presente.

nota

Os dispositivos de um grupo de multicast não conseguem reconhecer quando uma mensagem de downlink foi recebida.

Antes de enviar uma mensagem de downlink, é preciso ter criado um grupo de multicast e adicionado com sucesso dispositivos ao grupo para o qual você deseja enviar uma mensagem de downlink. Não é possível adicionar mais dispositivos depois de um horário de início ter sido agendado para a sessão multicast. Para ter mais informações, consulte Criar grupos de multicast e adicionar dispositivos ao grupo.

Se algum dos dispositivos não tiver sido adicionado com sucesso, o grupo de multicast e o status do dispositivo conterão informações para ajudá-lo a solucionar os erros. Se os erros persistirem, para acessar informações sobre como solucioná-los, consulte Monitorar e solucionar problemas do status de um grupo de multicast e dos dispositivos do grupo.

Para enviar uma mensagem de downlink com o console, acesse a página Grupos de multicast do console do AWS IoT e selecione o grupo de multicast que você criou. Na página de detalhes do grupo de multicast, selecione Agendar mensagem de downlink e, depois, selecione Agendar sessão de downlink.

  1. Agendar janela de mensagem de downlink

    É possível configurar uma janela de tempo para que uma mensagem de downlink seja enviada aos dispositivos de um grupo de multicast. É preciso que a mensagem de downlink seja agendada em 48 horas.

    Para agendar uma sessão multicast, especifique os parâmetros a seguir:

    • Data de início e Hora de início: a data e a hora de início devem ser pelo menos 30 minutos depois e 48 horas antes da hora presente.

      nota

      A hora a ser especificada estará em UTC, então considere verificar a diferença de horário pelo fuso horário ao agendar a janela de downlink.

    • Tempo limite da sessão: o tempo após o qual você quer que a sessão multicast atinja o tempo limite se nenhuma mensagem de downlink for recebida. O tempo limite mínimo permitido é de 60 segundos. O valor máximo de tempo limite é de 2 dias para grupos de multicast de classe B e 18 horas para grupos de multicast de classe C.

  2. Configurar uma mensagem de downlink

    Para configurar uma mensagem de downlink, especifique os parâmetros a seguir:

    • Taxa de dados: selecione uma taxa de dados para a mensagem de downlink. A taxa de dados depende da RFRegion e do tamanho da carga. A taxa de dados padrão é 8 para a região US915 e 0 para a região UE868.

    • Frequência: selecione uma frequência para envio da mensagem de downlink. Para evitar conflitos de mensagens, selecione uma frequência disponível conforme a RFRegion.

    • FPort: selecione uma porta de frequência disponível para envio da mensagem de downlink para os seus dispositivos.

    • Carga: especifique o tamanho máximo da carga conforme a taxa de dados. Usando a taxa de dados padrão, pode-se ter um tamanho máximo de carga de 33 bytes na RfRegion US915 e 51 bytes na RfRegion UE868. Com taxas de dados maiores, é possível transferir até um tamanho máximo de carga de 242 bytes.

    Para agendar uma mensagem de downlink, selecione Agendar.

Para agendar uma mensagem de downlink com a API, use a operação de API StartMulticastGroupSession ou o comando start-multicast-group-session da CLI.

É possível utilizar as operações de API ou comandos da CLI a seguir para obter informações sobre um grupo multicast e para excluí-lo.

Para enviar dados a um grupo de multicast depois do início da sessão, use a operação de API SendDataToMulticastGroup ou o comando send-data-to-multicast-group da CLI.

Após configurar uma mensagem de downlink a ser enviada para os dispositivos, a mensagem será enviada no início da sessão. Os dispositivos de um grupo de multicast não podem confirmar o recebimento da mensagem.

Também é possível configurar mensagens de downlink adicionais a serem enviadas para os dispositivos de um grupo de multicast:

  • Para configurar mensagens de downlink adicionais a partir do console:

    1. Acesse a página Grupos de multicast do console do AWS IoT e selecione o grupo de multicast que você criou.

    2. Na página de detalhes do grupo de multicast, selecione Agendar mensagem de downlink e, depois, selecione Configurar mensagem de downlink adicional.

    3. Especifique os parâmetros Taxa de dados, Frequência, FPort e Carga, da mesma forma como configurou esses parâmetros para a primeira mensagem de downlink.

  • Para configurar mensagens de downlink adicionais com a API ou a CLI, chame a operação de API SendDataToMulticastGroup ou o comando send-data-to-multicast-group da CLI para cada mensagem de downlink adicional.

Também é possível atualizar o agendamento da sessão para utilizar uma nova data e hora de início para a sua sessão multicast. O novo agendamento da sessão substituirá a sessão agendada anteriormente.

nota

Só atualize sua sessão multicast quando for necessário. Essas atualizações podem fazer com que um grupo de dispositivos seja ativado por um longo período, esgotando suas baterias.

  • Para atualizar o agendamento da sessão a partir do console:

    1. Acesse a página Grupos de multicast do console do AWS IoT e selecione o grupo de multicast que você criou.

    2. Na página de detalhes do grupo de multicast, selecione Agendar mensagem de downlink e, depois, selecione Atualizar agendamento de sessão.

    3. Especifique os parâmetros Data do estado, Hora de início e Tempo limite da sessão, da mesma forma como especificou esses parâmetros para a primeira mensagem de downlink.

  • Para atualizar o agendamento da sessão a partir da API ou da CLI, use a operação de API StartMulticastGroupSession ou o comando start-multicast-group-session da CLI.