

# Adicionar dispositivos e grupos de multicast a uma tarefa FUOTA e agendar uma sessão FUOTA
<a name="lorawan-fuota-add-devices"></a>

Depois de ter criado uma tarefa FUOTA, você pode adicionar dispositivos à tarefa para atualizar o firmware. Depois que os dispositivos forem adicionados com êxito à tarefa FUOTA, você poderá agendar uma sessão FUOTA para atualizar o firmware do dispositivo. 
+ Se você tiver um número pequeno de dispositivos, poderá adicioná-los diretamente à tarefa FUOTA.
+ Se você tiver um número grande de dispositivos para os quais quer atualizar o firmware, é possível adicionar esses dispositivos aos seus grupos de multicast e, depois, adicionar os grupos de multicast à tarefa FUOTA. Para acessar informações sobre a criação e uso de grupos de multicast, consulte [Crie grupos de multicast para enviar uma carga de downlink para vários dispositivos](lorawan-multicast-groups.md).

**nota**  
É possível adicionar dispositivos individuais ou grupos de multicast à tarefa FUOTA. Não é possível adicionar dispositivos e grupos de multicast à tarefa.

Depois que tiver adicionado os dispositivos ou grupos de multicast, você poderá iniciar uma sessão de atualização de firmware. O AWS IoT Core for LoRaWAN coleta a imagem de firmware, fragmenta as imagens e, depois, armazena os fragmentos em um formato criptografado. Os dispositivos finais coletam os fragmentos e aplicam a nova imagem de firmware. O tempo que leva para a atualização de firmware ser concluída depende do tamanho da imagem e de como as imagens foram fragmentadas. Quando a atualização de firmware for concluída, os fragmentos criptografados da imagem de firmware armazenados pelo AWS IoT Core for LoRaWAN serão excluídos. Você ainda poderá encontrar a imagem de firmware no bucket do S3.

## Pré-requisitos
<a name="lorawan-fuota-devices-prereq"></a>

Antes de adicionar dispositivos ou grupos de multicast à tarefa FUOTA, realize o seguinte.
+ Você já precisa ter criado a tarefa FUOTA e fornecido a imagem de firmware. Para ter mais informações, consulte [Criar uma tarefa FUOTA e fornecer a imagem de firmware](lorawan-fuota-create-task.md).
+ Forneça os dispositivos sem fio para os quais você deseja atualizar o firmware. Para acessar informações sobre integrar seu dispositivo, consulte [Integrar os dispositivos ao AWS IoT Core for LoRaWAN](lorawan-onboard-end-devices.md).
+ Para atualizar o firmware de vários dispositivos, é possível adicioná-los a um grupo de multicast. Para ter mais informações, consulte [Crie grupos de multicast para enviar uma carga de downlink para vários dispositivos](lorawan-multicast-groups.md).
+ Quando você integrar os dispositivos ao AWS IoT Core for LoRaWAN, especifique o parâmetro de configuração FUOTA `FPorts`. Se estiver usando um dispositivo LoRaWAN v1.0.x, também é preciso deve especificar a `GenAppKey`. Para obter mais informações sobre os parâmetros de configuração do FUOTA, consulte [Preparar dispositivos para configuração multicast e FUOTA](lorawan-prepare-devices-multicast.md).

## Adicionar dispositivos a uma tarefa FUOTA e agendar uma sessão FUOTA com o console
<a name="lorawan-fuota-devices-console"></a>

Para adicionar dispositivos ou grupos de multicast e agendar uma sessão FUOTA com o console, acesse a guia [Tarefas FUOTA](https://console.aws.amazon.com/iot/home#/wireless/fuotaTasks) do console. Depois, selecione a tarefa FUOTA à qual deseja adicionar dispositivos e execute a atualização de firmware.

**Adicionar dispositivos e grupos de multicast**

1. É possível adicionar dispositivos individuais ou grupos de multicast à sua tarefa FUOTA. Entretanto, não é possível adicionar dispositivos individuais e grupos de multicast à mesma tarefa FUOTA. Para adicionar dispositivos com o console, faça o seguinte.

   1. Nos **Detalhes da tarefa FUOTA**, selecione **Adicionar dispositivo**.

   1. Selecione a banda de frequência ou a **RFRegion** dos dispositivos adicionados à tarefa. Esse valor deve corresponder à **RFRegion** escolhida para a tarefa FUOTA.

   1. Escolha se deseja adicionar dispositivos individuais ou grupos de multicast à tarefa.
      + Para adicionar dispositivos individuais, selecione **Adicionar dispositivos individuais** e informe o ID do dispositivo de cada dispositivo que deseja adicionar à tarefa FUOTA.
      + Para adicionar grupos de multicast, selecione **Adicionar grupos de multicast** e adicione os grupos de multicast à tarefa. É possível filtrar os grupos de multicast que você deseja adicionar à tarefa usando o perfil ou as tags do dispositivo. Ao filtrar por perfil de dispositivo, é possível escolher grupos de multicast com dispositivos que tenham um perfil com **Compatível com Classe B** ou **Compatível com Classe C** habilitado.

1. 

**Agendar uma sessão FUOTA**

   Depois que seus dispositivos ou grupos de multicast forem adicionados com êxito, você poderá agendar uma sessão FUOTA. Para agendar uma sessão, realize o seguinte.

   1. Selecione a tarefa FUOTA para a qual você deseja atualizar o firmware do dispositivo e, depois, selecione **Agendar sessão FUOTA**.

   1. Especifique uma **Data de início** e uma **Hora de início** para a sessão FUOTA. Certifique-se de que a hora de início esteja 30 minutos ou mais à frente do horário presente.

## Adicionar dispositivos a uma tarefa FUOTA e agendar uma sessão FUOTA com a API
<a name="lorawan-fuota-devices-api"></a>

É possível usar a API do AWS IoT Wireless ou a CLI para adicionar dispositivos sem fio ou grupos de multicast à sua tarefa FUOTA. Depois, você pode agendar uma sessão FUOTA. 

1. 

**Adicionar dispositivos e grupos de multicast**

   É possível associar dispositivos sem fio ou grupos de multicast a uma tarefa FUOTA.
   + Para associar dispositivos individuais a uma tarefa FUOTA, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithFuotaTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-fuota-task.html) da CLI e forneça o `WirelessDeviceID` como entrada.

     ```
     aws iotwireless associate-wireless-device-with-fuota-task \
         --id "01a23cde-5678-4a5b-ab1d-33456808ecb2"
         --wireless-device-id "ab0c23d3-b001-45ef-6a01-2bc3de4f5333"
     ```
   + Para associar grupos de multicast a uma tarefa FUOTA, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateMulticastGroupWithFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateMulticastGroupWithFuotaTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-multicast-group-with-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-multicast-group-with-fuota-task.html) da CLI e forneça o `MulticastGroupID` como entrada.

     ```
     aws iotwireless associate-multicast-group-with-FUOTA-task \
         --id 01a23cde-5678-4a5b-ab1d-33456808ecb2"
         --multicast-group-id
     ```

   Após associar os dispositivos sem fio ou grupo de multicast a uma tarefa FUOTA, use as operações de API ou comandos de CLI a seguir para listar os dispositivos ou grupos de multicast ou para desassociá-los da tarefa.
   + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromFuotaTask.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-fuota-task.html) 
   + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateMulticastGroupFromFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateMulticastGroupFromFuotaTask.html) ou [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-multicast-group-from-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-multicast-group-from-fuota-task.html) 
   + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html) 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) 
   + [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups.html) 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) 
**nota**  
A API:  
`ListWirelessDevices` pode listar dispositivos sem fio em geral, e dispositivos associados a um grupo de multicast, quando `MulticastGroupID` é usado como filtro. A API lista os dispositivos sem fio que estão associados a uma tarefa FUOTA quando o `FuotaTaskID` é usado como filtro.
`ListMulticastGroups` pode listar grupos de multicast em geral, e grupos de multicast associados a uma tarefa FUOTA, quando o `FuotaTaskID` é usado como filtro.

1. 

**Agendar uma sessão FUOTA**

   Depois que os dispositivos ou grupos de multicast forem adicionados com êxito à tarefa FUOTA, você poderá iniciar uma sessão FUOTA para atualizar o firmware do dispositivo. A nova hora de início do evento deve estar 30 minutos ou mais à frente do horário presente. Para agendar uma sessão FUOTA usando a API ou a CLI, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartFuotaTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-fuota-task.html) da CLI.

   Após iniciar uma sessão FUOTA, não será mais possível adicionar dispositivos ou grupos de multicast à tarefa. É possível obter informações sobre o status de uma sessão FUOTA usando a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GettFuotaTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GettFuotaTask.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-fuota-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-fuota-task.html) da CLI.