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á.
# Guia de migração do repositório Github do Amazon FreeRTOS
Se você tem um projeto FreeRTOS existente baseado no repositório Amazon FreeRTOS que está preterido, siga estas etapas:
1. Mantenha-se atualizado com as correções de segurança mais recentes e disponíveis ao público. Consulte a página de bibliotecas [LTS do FreeRTOS](https://www.freertos.org/lts-libraries.html) para obter atualizações ou assine o repositório [FreeRTOS-LTS](https://github.com/FreeRTOS/FreeRTOS-LTS) no GitHub para receber os patches mais recentes do LTS com correções de bugs críticos e de segurança. Você pode baixar ou clonar os patches de LTS mais recentes do FreeRTOS necessários diretamente dos repositórios individuais do GitHub.
1. Considere refatorar a implementação da interface de transporte de rede para otimizar sua plataforma de hardware. As APIs abstratas, como [secure sockets](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) e [APIs Wifi](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html) não são exigidas pela biblioteca [coreMQTT](https://www.freertos.org/mqtt/index.html) mais recente. Consulte [Interface de transporte](https://www.freertos.org/network-interface.html) para obter mais detalhes.
## Apêndice
A tabela a seguir fornece recomendações para todos os projetos de demonstração, bibliotecas herdadas e APIs abstratas no repositório do Amazon FreeRTOS.
**Bibliotecas e demonstrações migradas**
| Name | Tipo | Recomendações |
| --- | --- | --- |
| **coreHTTP** | demonstrações e biblioteca | xClone ou baixe a biblioteca coreHTTP diretamente do repositório [coreHTTP](https://github.com/FreeRTOS/coreHTTP) (submódulo se estiver usando git) na [Organização do GitHub do FreeRTOS](https://github.com/FreeRTOS). As demonstrações do coreHTTP estão na distribuição [primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator). Para obter mais detalhes, consulte a [página coreHTTP](https://www.freertos.org/http/index.html). |
| coreMQTT | demonstrações e biblioteca | Clone ou baixe a biblioteca coreMQTT diretamente do repositório [coreMQTT](https://github.com/FreeRTOS/coreMQTT) (submódulo se estiver usando git) na [Organização do GitHub do FreeRTOS](https://github.com/FreeRTOS). As demonstrações do coreMQTT estão na distribuição [primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreMQTT_Windows_Simulator). Para obter mais detalhes, consulte a [página coreMQTT](https://www.freertos.org/mqtt/index.html). |
| coreMQTT Agent | demonstrações e biblioteca | Clone ou baixe a biblioteca coreMQTT Agent diretamente do repositório [coreMQTT Agent](https://github.com/FreeRTOS/coreMQTT-Agent) (submódulo se estiver usando git) na [Organização do GitHub do FreeRTOS](https://github.com/FreeRTOS). As demonstrações da coreMQTT Agent estão no repositório [coreMQTT-Agent-Demos](https://github.com/FreeRTOS/coreMQTT-Agent-Demos). Para obter mais detalhes, consulte a [página coreMQTT-Agent](https://www.freertos.org/mqtt-agent/index.html). |
| device\$1defender\$1for\$1aws | demonstrações e biblioteca | A biblioteca do AWS IoT Device Defender está em seu repositório na organização do [GitHub da AWS](https://github.com/AWS). Clone ou baixe-o (submódulo se estiver usando git) diretamente do repositório do [AWS IoT Device Defender](https://github.com/aws/Device-Defender-for-AWS-IoT-embedded-sdk). As demonstrações do AWS IoT Device Defender estão na [distribuição primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Defender_Windows_Simulator/Device_Defender_Demo). Para obter mais detalhes, consulte a [página AWS IoT Device Defender](https://www.freertos.org/iot-device-defender/index.html). |
| device\$1shadow\$1for\$1aws | demonstrações e biblioteca | A biblioteca do AWS IoT Device Defender está em seu repositório na [Organização do GitHub da AWS](https://github.com/AWS). Clone ou baixe-a (submódulo se estiver usando git) diretamente do repositório do [AWS IoT Device Shadow](https://github.com/aws/Device-Shadow-for-AWS-IoT-embedded-sdk). As demonstrações do AWS IoT Device Shadow estão na [distribuição primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Shadow_Windows_Simulator). Para obter mais detalhes, consulte a [página AWS IoT Device Defender](https://www.freertos.org/iot-device-shadow/index.html). |
| jobs\$1for\$1aws | demonstrações e biblioteca | A biblioteca Trabalhos do AWS IoT está em seu repositório na [Organização do GitHub da AWS](https://github.com/AWS). Clone ou baixe-o (submódulo se estiver usando git) diretamente do repositório do [ Trabalhos do AWS IoT](https://github.com/aws/Jobs-for-AWS-IoT-embedded-sdk). As demonstrações do Trabalhos do AWS IoT estão na [ distribuição primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Jobs_Windows_Simulator/Jobs_Demo). Para obter mais detalhes, consulte a [página Trabalhos do AWS IoT](https://www.freertos.org/iot-jobs/index.html). |
| OTA | demonstrações e biblioteca | A biblioteca de atualização sem fios do AWS IoT está em seu repositório na [Organização do GitHub da AWS.](https://github.com/AWS) Clone ou baixe-a (submódulo se estiver usando git) diretamente do repositório do [ OTA AWS IoT](https://github.com/aws/ota-for-aws-iot-embedded-sdk). As demonstrações OTA do AWS IoT estão na [ distribuição primária do FreeRTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Ota_Windows_Simulator). Para obter mais detalhes, consulte a [página OTA AWS IoT](https://www.freertos.org/ota/index.html). |
| CLI e FreeRTOS\$1Plus\$1CLI | demonstrações e biblioteca | Há um exemplo de CLI em execução no WinSIM. Consulte a página da [Interface de Linha de Comando do FreeRTOS Plus](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_CLI/FreeRTOS_Plus_Command_Line_Interface.html) para obter mais detalhes. As integrações de referência do FreeRTOS IoT em destaque nas plataformas [NXP i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) e [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) também fornecem exemplos de CLI em hardware real. |
| registro em log | Macro | Há implementações da macro de registro em log para plataformas de hardware específicas usadas por algumas das bibliotecas do FreeRTOS. Consulte a [página de registro em log](https://www.freertos.org/logging.html) para saber como implementar a macro de registro em log. Consulte [uma das referências de IoT apresentadas pelo FreeRTOS](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/logging) para ver um exemplo de execução em hardware real. |
| greengrass\$1connectivity | Demonstração | [Migração em andamento] Esse projeto de demonstração considerou que a conectividade na nuvem estava disponível antes da conexão com um dispositivo do AWS IoT Greengrass. Um novo projeto que demonstra a capacidade local de autenticação e descoberta está em desenvolvimento. Espere que o novo projeto de demonstração seja publicado em breve na [Organização do GitHub do FreeRTOS](https://github.com/FreeRTOS). |
**Bibliotecas e demonstrações preteridas**
| Name | Tipo | Recomendações |
| --- | --- | --- |
| BLE | demonstrações e biblioteca | A biblioteca BLE do FreeRTOS implementa o protocolo MQTT de proprietário e oferece suporte à publicação e assinatura de tópicos do MQTT por Bluetooth Low Energy (BLE) por meio de um dispositivo de proxy, como um celular. Isso não é mais obrigatório. Use sua própria pilha BLE ou uma opção de terceiros, como o [NiMBLE](https://mynewt.apache.org/latest/network/), para otimizar melhor seu projeto. |
| dev\$1mode\$1key\$1provisioning | Demonstrações | As integrações de referência do FreeRTOS IoT em destaque nas plataformas [ NXP i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c), [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c) ou [ESP32-C3](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md) fornecem exemplos de provisionamento crucial usando uma CLI. |
| posix | abstração e demonstração | Não recomendado para uso. |
| wifi\$1provisioning | exemplo | Este exemplo demonstrou como provisionar credenciais WiFi em um dispositivo usando a biblioteca BLE do Amazon FreeRTOS. Consulte a referência de IoT em destaque do FreeRTOS na plataforma [ESP32C3](https://github.com/FreeRTOS/iot-reference-esp32c3) para obter um exemplo de provisionamento WiFi via BLE. |
| APIs abstratas herdadas | código | Essas são APIs criadas para fornecer uma interface abstrata para várias pilhas de software, módulos de conectividade e plataformas MCU de terceiros de vários fornecedores. Por exemplo, existem interfaces para abstração de WiFi, soquetes seguros e assim por diante. Há suporte para eles no repositório Amazon-FreeRTOS e isso está na pasta `/libraries/abstractions/`. Essas APIs não são necessárias ao usar as [bibliotecas LTS do FreeRTOS](https://www.freertos.org/lts-libraries.html). |
As bibliotecas e demonstrações na tabela acima não receberão patches de segurança ou correções de bugs.
**Bibliotecas de terceiros**
Quando as demonstrações no Amazon-FreeRTOS usam bibliotecas de terceiros, recomendamos que você as submodule diretamente de seus repositórios de terceiros.
+ **CMock**: clone (submódulo se você usa git) diretamente do repositório [Cmock](https://github.com/ThrowTheSwitch/CMock).
+ **jsmn**: não recomendado e não há mais suporte para ela.
+ **lwip**: clone (submódulo se você usa git) diretamente do repositório [lwip-tcpip](https://github.com/lwip-tcpip/lwip).
+ **lwip\$1osal**: consulte as Integrações de Referência em destaque do FreeRTOS no [i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) ou [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5) para saber como implementar o lwip\$1osal em sua placa/plataforma de hardware.
+ **d**: clone (submódulo se você usa git) diretamente do repositório [Mbed-TLS](https://github.com/Mbed-TLS/mbedtls). A configuração e os utilitários do mbedtls podem ser reutilizados; nesse caso, faça uma cópia local.
+ **pkcs11**: clone-o (submódulo se você usar git) diretamente da biblioteca [corePKCS11](https://github.com/FreeRTOS/corePKCS11) ou do repositório [OASIS PKCS 11](https://github.com/oasis-tcs/pkcs11).
+ **tinycbor**: clone (submódulo se você usa git) diretamente do repositório [tinycbor](https://github.com/intel/tinycbor).
+ **tinycrypt**: recomendamos que você use aceleradores de criptografia da sua plataforma MCU, se disponíveis. Se você quiser continuar usando o tinycrypt, clone-o (submódulo se você usar git) diretamente do repositório [tinycrypt](https://github.com/intel/tinycrypt).
+ **tracealyzer\$1recorder**: clone-o (submódulo se você usar git) diretamente do repositório de gravadores de rastreamento do [trace recorder](https://github.com/percepio/TraceRecorderSource).
+ **unity**: clone-o (submódulo se você usar git) diretamente do repositório [ThrowTheSwitch/Unity](https://github.com/ThrowTheSwitch/Unity).
+ **win\$1pcap** : a win\$1pcap não é mais mantida. Recomendamos que você use libslirp, libpcap (posix) ou npcap.
**Testes de portabilidade e testes de integração**
Todos os testes da pasta `/tests` necessários para validar a integração das bibliotecas do FreeRTOS foram migrados para o repositório [FreeRTOS-Libraries-Integration-Tests.](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) Eles podem ser usados para testar a implementação do PAL e a integração da biblioteca. Os mesmos testes são usados pelo AWS IoT Device Tester (IDT) para o [Programa de qualificação de dispositivos da AWS para FreeRTOS](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afr-qualification.html).