

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Serviço do gerenciador de atualização OTA
<a name="ota-manager"></a>

O serviço over-the-air (OTA) Update Manager fornece uma maneira de:
+ Crie uma atualização OTA e os recursos que ela usa, incluindo um AWS IoT trabalho, um AWS IoT stream e assinatura de código.
+ Obtenha informações sobre uma atualização OTA. 
+ Liste todas as atualizações do OTA associadas à sua AWS conta.
+ Excluir uma atualização OTA.

Uma atualização OTA é uma estrutura de dados mantida pelo serviço do gerenciador de atualização OTA. Ela contém:
+ Um ID de atualização OTA.
+ Uma descrição opcional da atualização OTA.
+ Uma lista de dispositivos a serem atualizados (*destinos*)
+ O tipo de atualização OTA: CONTINUOUS ou SNAPSHOT. Consulte a seção [Trabalhos](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) do * Guia do desenvolvedor do AWS IoT * para obter uma discussão sobre o tipo de atualização que você precisa.
+ O protocolo usado para executar a atualização OTA: [MQTT], [HTTP] ou [MQTT, HTTP]. Quando você especifica MQTT e HTTP, a configuração do dispositivo determina o protocolo usado.
+ Uma lista de arquivos a serem enviados aos dispositivos de destino.
+ A função do IAM que concede AWS IoT acesso ao Amazon S3, aos AWS IoT trabalhos e aos recursos de assinatura de AWS código para criar um trabalho de atualização do OTA.
+ Uma lista opcional de pares de nome/valor definida pelo usuário.

As atualizações OTA foram projetadas para atualizar o firmware do dispositivo, mas você pode usá-las para enviar os arquivos que desejar para um ou mais dispositivos registrados AWS IoT. Quando você envia atualizações de firmware over-the-air, recomendamos que você as assine digitalmente para que os dispositivos que as recebem possam verificar se não foram adulteradas no caminho.

Você pode enviar imagens de firmware atualizadas usando o protocolo HTTP ou MQTT, dependendo das configurações que você escolher. Você pode assinar s atualizações de firmware com o [Code Signing para FreeRTOS](https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html) ou usar as próprias ferramentas de assinatura de código.

Para ter mais controle sobre o processo, você pode usar a [ CreateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateStream.html)API para criar um stream ao enviar atualizações pelo MQTT. Em alguns casos, você pode modificar o [código](https://github.com/aws/amazon-freertos/tree/202012.00/libraries/freertos_plus/aws/ota/src) do agente do FreeRTOS para ajustar o tamanho dos blocos que você envia e recebe.

Ao criar uma atualização OTA, o serviço gerenciador OTA cria um [trabalho da AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) para notificar os dispositivos de que uma atualização está disponível. O agente OTA do FreeRTOS é executado em seus dispositivos e detecta mensagens de atualização. Quando uma atualização está disponível, ele solicita a imagem de atualização de firmware por HTTP ou MQTT e armazena os arquivos localmente. Ele verifica a assinatura digital dos arquivos obtidos por download e, se for válida, instala a atualização do firmware. Se não estiver usando o FreeRTOS, será necessário implementar o próprio agente OTA para detectar e fazer download das atualizações e realizar operações de instalação.