# Crie grupos de multicast para enviar uma carga de downlink para vários dispositivos Para enviar uma carga de downlink para vários dispositivos, crie um grupo de multicast. Com o multicast, uma fonte pode enviar dados para um único endereço multicast, que é, então, distribuído para um grupo inteiro de dispositivos destinatários. Os dispositivos de um grupo de multicast compartilham o mesmo endereço multicast, chaves de sessão e contador de quadros. Usando as mesmas chaves de sessão, os dispositivos de um grupo de multicast podem descriptografar a mensagem quando uma transmissão de downlink for iniciada. Um grupo de multicast é compatível apenas com downlink. Ele não confirma se a carga do downlink foi recebida pelos dispositivos. Com os grupos multicast do AWS IoT Core for LoRaWAN, você pode: + Filtrar sua lista de dispositivos com o perfil de dispositivo, RFRegion ou classe de dispositivo e, depois, adicionar esses dispositivos a um grupo de multicast. + Agendar e enviar uma ou mais mensagens de carga de downlink a dispositivos em um grupo de multicast dentro de uma janela de distribuição de 48 horas. + Fazer com que os dispositivos mudem temporariamente para o modo Classe B ou Classe C no início da sua sessão multicast para receber a mensagem de downlink. + Monitorar a configuração de um grupo de multicast e o estado de seus dispositivos, além de solucionar quaisquer problemas. + Usar atualizações de firmware sem fio (FUOTA) para implantar com segurança atualizações de firmware em dispositivos em um grupo de multicast. O vídeo a seguir descreve como é possível criar grupos multicast do AWS IoT Core for LoRaWAN e fornece orientações sobre o processo de adição de um dispositivo ao grupo e a programação de uma mensagem de downlink para o grupo. [![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/LcCR-1eKX1w/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/LcCR-1eKX1w) O seguinte demonstra como criar seu grupo de multicast e programar uma mensagem de downlink. **Topics** + [Criar grupos de multicast e adicionar dispositivos ao grupo](lorawan-create-multicast-groups.md) + [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 para enviar para os dispositivos de um grupo de multicast](lorawan-multicast-schedule-downlink.md) # Criar grupos de multicast e adicionar dispositivos ao grupo É possível criar grupos de multicast usando o console ou a CLI. Se estiver criando seu grupo de multicast pela primeira vez, recomendamos usar o console para adicionar seu grupo de multicast. Quando desejar gerenciar seu grupo de multicast e adicionar ou remover dispositivos do grupo, você pode usar a CLI. Após trocar a sinalização com os dispositivos finais adicionados, o AWS IoT Core for LoRaWAN estabelece as chaves compartilhadas com os dispositivos finais e configura os parâmetros para a transferência de dados. ## Pré-requisitos Antes de criar grupos de multicast e adicionar dispositivos ao grupo: + Prepare seus dispositivos para configuração de multicast e FUOTA especificando os parâmetros de configuração da FUOTA `GenAppKey` e `FPorts`. Para ter mais informações, consulte [Preparar dispositivos para configuração multicast e FUOTA](lorawan-prepare-devices-multicast.md). + Verifique se os dispositivos são compatíveis com os modos de operação de classe B ou de classe C. Dependendo da classe de dispositivo compatível com seu dispositivo, selecione um perfil de dispositivo que esteja com um ou ambos os modos **Compatível com classe B** ou **Compatível com classe C** ativados. Para acessar mais informações sobre perfis de dispositivos, consulte [Adicionar perfis ao AWS IoT Core for LoRaWAN](lorawan-define-profiles.md). No início da sessão multicast, uma janela de distribuição de classe B ou classe C é utilizada para enviar mensagens de downlink aos dispositivos do seu grupo. ## Criar grupos de multicast usando o console Para criar grupos de multicast 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 **Criar grupo de multicast**. 1. **Crie um grupo de multicast** Para criar um grupo de multicast, especifique as propriedades e tags de multicast do grupo. 1. **Especifique as propriedades de multicast** Para especificar propriedades de multicast, insira as informações a seguir relativas ao grupo de multicast. + **Nome**: insira um nome exclusivo do grupo de multicast. O nome só pode conter letras, números, hifens e sublinhado. Ele não pode conter espaços. + **Descrição**: você pode fornecer uma descrição opcional do grupo de multicast. A descrição pode ser até 2.048 caracteres de comprimento. 1. **Tags para grupo de multicast** Opcionalmente, é possível fornecer quaisquer pares de valores-chave como **Tags** para o grupo de multicast. Para continuar criando o grupo de multicast, selecione **Próximo**. 1. **Adicione dispositivos a um grupo de multicast** É possível adicionar dispositivos individuais ou um grupo de dispositivos ao seu grupo de multicast. Para adicionar dispositivos: 1. **Especifique a RFRegion** Especifique a **RFRegion** ou a banda de frequência do grupo de multicast. A **RFRegion** do grupo de multicast deve corresponder à **RFRegion** dos dispositivos que você adiciona ao grupo de multicast. Para obter mais informações sobre a **RFRegion**, consulte [Considere a seleção de faixas de frequência LoRa para os gateways e conexão de dispositivos](lorawan-rfregion-permissions.md#lorawan-frequency-bands). 1. **Selecione uma classe de dispositivo multicast** Escolha se você deseja que dispositivos do grupo de multicast mudem para o modo classe B ou classe C no início da sessão multicast. Uma sessão de classe B pode receber mensagens de downlink em slots regulares de downlink e uma sessão de classe C pode receber mensagens de downlink a qualquer instante. 1. **Escolha os dispositivos que deseja adicionar ao grupo** Escolha se você deseja adicionar dispositivos ao grupo de multicast de modo individual ou em lotes. + Para adicionar os dispositivos individualmente, insira o ID do dispositivo sem fio de cada dispositivo que você quer adicionar ao grupo. + Para adicionar dispositivos em lotes, é possível filtrar os dispositivos que você deseja adicionar por perfil ou tags do dispositivo. No perfil de dispositivo, você pode adicionar dispositivos com um perfil compatível com classe B, classe C ou ambas as classes de dispositivos. 1. Para criar um grupo de multicast, selecione **Criar**. Os detalhes do grupo de multicast e os dispositivos adicionados aparecem no grupo. Para acessar informações sobre o status do grupo de multicast e seus dispositivos e para solucionar quaisquer problemas, consulte [Monitorar e solucionar problemas do status de um grupo de multicast e dos dispositivos do grupo](lorawan-multicast-status.md). Após criar um grupo de multicast, você pode selecionar **Ação** para editar, excluir ou adicionar dispositivos ao grupo de multicast. Após adicionar os dispositivos, é possível agendar uma sessão para que a carga de downlink seja enviada para os dispositivos do grupo. ## Criar grupos de multicast usando a API Para criar grupos de multicast e adicionar dispositivos ao grupo usando a API: 1. **Crie um grupo de multicast** Para criar o grupo de multicast, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html) da CLI. É possível fornecer um arquivo `input.json` como entrada para o comando `create-multicast-group`. ``` aws iotwireless create-multicast-group \ --cli-input-json file://input.json ``` onde: **Conteúdo de input.json** ``` { "Description": "Multicast group to send downlink payload and perform FUOTA.", "LoRaWAN": { "DlClass": "ClassB", "RfRegion": "US915" }, "Name": "MC_group_FUOTA" } ``` Após criar seu grupo de multicast, é possível usar as seguintes operações de API ou comandos da CLI para atualizar, excluir ou obter informações sobre os seus grupos de multicast. + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html) + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html) + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html) + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html) 1. **Adicione dispositivos a um grupo de multicast** É possível adicionar dispositivos ao seu grupo de multicast individualmente ou em lotes. + Para adicionar dispositivos em lotes ao seu grupo de multicast, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html) da CLI. Para filtrar os dispositivos que você deseja associar em lote ao seu grupo de multicast, forneça uma string de consulta. O seguinte demonstra como você pode adicionar um grupo de dispositivos que tenha um perfil de dispositivo com o ID especificado vinculado a ele. ``` aws iotwireless start-bulk-associate-wireless-device-with-multicast-group \ --id "12abd34e-5f67-89c2-9293-593b1bd862e0" \ --cli-input-json file://input.json ``` onde: **Conteúdo de input.json** ``` { "QueryString": "DeviceProfileName: MyWirelessDevice AND DeviceProfileId: d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf", "Tags": [ { "Key": "Multicast", "Value": "ClassB" } ] } ``` Aqui, `multicast-groups/d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf/bulk` é o URL usado para associar dispositivos ao grupo. + Para adicionar dispositivos individualmente ao seu grupo de multicast, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html) ou o comando a CLI [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html). Forneça o ID do dispositivo sem fio de todos os dispositivos que você deseja adicionar ao grupo. ``` aws iotwireless associate-wireless-device-with-multicast-group \ --id "12abd34e-5f67-89c2-9293-593b1bd862e0" \ --wireless-device-id "ab0c23d3-b001-45ef-6a01-2bc3de4f5333" ``` Após criar seu grupo de multicast, é possível usar as seguintes operações de API ou comandos da CLI para obter informações sobre seu grupo de multicast ou para desassociar dispositivos. + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html) + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html) + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html) **nota** A operação de API `ListWirelessDevices` pode ser usada para listar dispositivos sem fio em geral e dispositivos sem fio que estejam associados a um grupo de multicast ou a uma tarefa FUOTA. Para listar dispositivos sem fio que estão associados a um grupo de multicast, use a operação de API `ListWirelessDevices` com `MulticastGroupID` como filtro. Para listar dispositivos sem fio que estão associados a uma tarefa FUOTA, use a operação de API `ListWirelessDevices` com `FuotaTaskID` como filtro. ## Próximas etapas Após criar um grupo de multicast e adicionar dispositivos, é possível seguir adicionando dispositivos e monitorar o status do grupo de multicast e de seus dispositivos. Se os dispositivos foram adicionados com êxito ao grupo, é possível configurar e programar uma mensagem de downlink para ser enviada a eles. Antes de poder enviar uma mensagem de downlink, o status dos dispositivos deve ser **Pronto para configuração do Multicast**. Depois que você agenda uma mensagem de downlink, o status é alterado para **Tentativa de sessão**. Para ter mais informações, consulte [Agendar uma mensagem de downlink para enviar para os dispositivos de um grupo de multicast](lorawan-multicast-schedule-downlink.md). Se quiser atualizar o firmware dos dispositivos do grupo do multicast, é possível realizar atualizações de firmware sem fio (FUOTA) com o AWS IoT Core for LoRaWAN. Para ter mais informações, consulte [Atualização de firmware sem fios (FUOTA) para dispositivos do AWS IoT Core for LoRaWAN](lorawan-mc-fuota-overview.md). Se os dispositivos não foram adicionados, ou se você recebeu um erro no grupo de multicast ou nos status do dispositivo, passe o mouse sobre o erro para obter mais informações e resolvê-lo. Se você ainda receber um erro, para obter informações sobre como solucionar o problema, consulte [Monitorar e solucionar problemas do status de um grupo de multicast e dos dispositivos do grupo](lorawan-multicast-status.md). # Monitorar e solucionar problemas do status de um grupo de multicast e dos dispositivos do grupo Depois que você adicionar dispositivos e criar seu grupo de multicast, abra o Console de gerenciamento da AWS. Navegue até 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 para visualizar seus detalhes. Você verá informações sobre o grupo de multicast, o número de dispositivos adicionados e os detalhes de status dos dispositivos. É possível usar as informações de status para monitorar o progresso da sua sessão multicast e solucionar quaisquer erros. ## Status do grupo de multicast Seu grupo de multicast pode ter uma das mensagens de status a seguir exibidas no Console de gerenciamento da AWS. + **Pendente** Esse status indica que um grupo de multicast foi criado por você, mas ele ainda não tem uma sessão multicast. Essa mensagem de status será exibida quando um grupo for criado. Durante esse período, é possível atualizar seu grupo de multicast e associar ou desassociar dispositivos ao grupo. Após o status mudar de **Pendente**, dispositivos adicionais não poderão ser adicionados no grupo. + **Tentativa de sessão** Depois que os dispositivos forem adicionados com êxito ao grupo de multicast, quando o grupo tiver uma sessão multicast agendada, essa mensagem de status será exibida. Durante esse período, não é possível atualizar ou adicionar dispositivos no grupo de multicast. Se cancelar sua sessão multicast, o status do grupo será alterado para **Pendente**. + **Em sessão** Quando for a primeira sessão da sua sessão multicast, essa mensagem de status será exibida. Um grupo de multicast também permanece nesse estado quando está associado a uma tarefa FUOTA que possui uma sessão contínua de atualização de firmware. Caso não haja uma tarefa FUOTA associada na sessão e se a sessão multicast for cancelada porque o tempo da sessão excedeu o tempo limite ou porque você cancelou a sessão multicast, o status do grupo será alterado para **Pendente**. + **Espera de exclusão** Se você excluir um grupo de multicast, o status do grupo será alterado para **Espera de exclusão**. As exclusões são permanentes e irreversíveis. Essa ação pode levar tempo e o status do grupo será **Delete\$1Waiting** até o grupo de multicast ser excluído. Depois que um grupo de multicast entrar nesse estado, ele não poderá mudar para um dos outros estados. ## Status dos dispositivos no grupo de multicast Os dispositivos de um grupo de multicast pode ter uma das mensagens de status a seguir exibidas no Console de gerenciamento da AWS. É possível passar o mouse sobre cada mensagem de status para acessar mais informações sobre o que ela indica. + **Tentativa de pacote** Após os dispositivos terem sido associados ao grupo de multicast, o status do dispositivo será **Tentativa de pacote**. Esse status indica que o AWS IoT Core for LoRaWAN ainda não confirmou se o dispositivo é compatível com a configuração e operação do multicast. + **Pacote incompatível** Após os dispositivos terem sido associados ao grupo de multicast, o AWS IoT Core for LoRaWAN verifica se o firmware do dispositivo é capaz de configurar e operar o multicast. Se o dispositivo não possuir o pacote compatível do multicast, seu status será **Pacote incompatível**. Para solucionar o erro, verifique se o firmware do dispositivo pode configurar e operar o multicast. + **Tentativa de configuração do multicast** Se os dispositivos associados ao seu grupo de multicast forem capazes de configurar e operar o multicast, o status será **Tentativa de configuração do multicast**. Esse status representa que o dispositivo ainda não concluiu a configuração do multicast. + **Configuração do multicast concluída** O dispositivo concluiu a configuração do multicast e foi adicionado ao grupo de multicast. Esse status representa que os dispositivos estão prontos para uma sessão multicast e que mensagens de downlink pode ser enviada para esses dispositivos. O status também indica quando é possível usar o FUOTA para atualizar o firmware dos dispositivos do grupo. + **Tentativa de sessão** Uma sessão multicast foi agendada para os dispositivos no grupo de multicast. No início de uma sessão de grupo de multicast, o status do dispositivo é **Tentativa de sessão**, e as solicitações são enviadas para uma janela de distribuição de classe B ou classe C ser iniciada para a sessão. Se o tempo decorrida na configuração da sessão multicast exceder o tempo limite ou se você cancelar a sessão multicast, o status será alterado para **Configuração do multicast concluída**. + **Em sessão** Esse status representa que uma janela de distribuição de classe B ou classe C foi iniciada e que o dispositivo tem uma sessão multicast em andamento. Durante esse período, mensagens de downlink podem ser enviadas a partir do AWS IoT Core for LoRaWAN para dispositivos no grupo de multicast. Se você atualizar o horário da sessão, ele substituirá a sessão atual e o status será alterado para **Tentativa de sessão**. Quando o horário da sessão se encerra, ou ao cancelar a sessão multicast, o status é alterado para **Configuração do multicast concluída**. ## Próximas etapas Agora que você aprendeu os diferentes status de um grupo de multicast e dos dispositivos do grupo e como solucionar quaisquer problemas, como quando um dispositivo não é capaz de configurar o multicast, você pode agendar o envio de uma mensagem de downlink aos dispositivos e o grupo de multicast estará **Em sessão**. Para acessar informações sobre agendamento de mensagens de downlink, consulte [Agendar uma mensagem de downlink para enviar para os dispositivos de um grupo de multicast](lorawan-multicast-schedule-downlink.md). # 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. ## Pré-requisitos 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 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 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 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 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 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.