

# Agendar uma mensagem de downlink para enviar para os dispositivos de um grupo de multicast
<a name="lorawan-multicast-schedule-downlink"></a>

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.

## Pré-requisitos
<a name="lorawan-multicast-downlink-prereq"></a>

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](lorawan-create-multicast-groups.md).

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](lorawan-multicast-status.md).

## Agendar uma mensagem de downlink com o console
<a name="lorawan-multicast-downlink-console"></a>

Para enviar uma mensagem de downlink com o console, acesse a página [Grupos de multicast](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) 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.

1. 

**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**.

## Agendar uma mensagem de downlink com a API
<a name="lorawan-multicast-downlink-api"></a>

Para agendar uma mensagem de downlink com a API, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartMulticastGroupSession.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartMulticastGroupSession.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-multicast-group-session](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/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.
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetMulticastGroupSession.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetMulticastGroupSession.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group-session](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group-session)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroupSession.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroupSession.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group-session](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group-session)

Para enviar dados a um grupo de multicast depois do início da sessão, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToMulticastGroup.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-multicast-group](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-multicast-group) da CLI.

## Próximas etapas
<a name="lorawan-multicast-downlink-next"></a>

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.

### Configurar mensagens de downlink adicionais
<a name="lorawan-multicast-downlink-additional"></a>

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](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) do console do AWS IoT e selecione o grupo de multicast que você criou.

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

  1. 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToMulticastGroup.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-multicast-group](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-multicast-group) da CLI para cada mensagem de downlink adicional.

### Atualizar o agendamento da sessão
<a name="lorawan-multicast-downlink-update"></a>

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](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) do console do AWS IoT e selecione o grupo de multicast que você criou.

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

  1. 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartMulticastGroupSession.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartMulticastGroupSession.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-multicast-group-session](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-multicast-group-session) da CLI.