# 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).