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 para obter atualizações ou assine o repositório 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.

2. Considere refatorar a implementação da interface de transporte de rede para otimizar sua plataforma de hardware. As APIs abstratas, como secure sockets e APIs Wifi não são exigidas pela biblioteca coreMQTT mais recente. Consulte Interface de transporte 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
Nome	Type	Recomendações
coreHTTP	demonstrações e biblioteca	xClone ou baixe a biblioteca coreHTTP diretamente do repositório coreHTTP (submódulo se estiver usando git) na Organização do GitHub do FreeRTOS. As demonstrações do coreHTTP estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página coreHTTP.
coreMQTT	demonstrações e biblioteca	Clone ou baixe a biblioteca coreMQTT diretamente do repositório coreMQTT (submódulo se estiver usando git) na Organização do GitHub do FreeRTOS. As demonstrações do coreMQTT estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página coreMQTT.
coreMQTT Agent	demonstrações e biblioteca	Clone ou baixe a biblioteca coreMQTT Agent diretamente do repositório coreMQTT Agent (submódulo se estiver usando git) na Organização do GitHub do FreeRTOS. As demonstrações da coreMQTT Agent estão no repositório coreMQTT-Agent-Demos. Para obter mais detalhes, consulte a página coreMQTT-Agent.
device_defender_for_aws	demonstrações e biblioteca	A biblioteca do AWS IoT Device Defender está em seu repositório na organização do GitHub da AWS. Clone ou baixe-o (submódulo se estiver usando git) diretamente do repositório do AWS IoT Device Defender. As demonstrações do AWS IoT Device Defender estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página AWS IoT Device Defender.
device_shadow_for_aws	demonstrações e biblioteca	A biblioteca do AWS IoT Device Defender está em seu repositório na Organização do GitHub da AWS. Clone ou baixe-a (submódulo se estiver usando git) diretamente do repositório do AWS IoT Device Shadow. As demonstrações do AWS IoT Device Shadow estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página AWS IoT Device Defender.
jobs_for_aws	demonstrações e biblioteca	A biblioteca Trabalhos do AWS IoT está em seu repositório na Organização do GitHub da AWS. Clone ou baixe-o (submódulo se estiver usando git) diretamente do repositório do Trabalhos do AWS IoT. As demonstrações do Trabalhos do AWS IoT estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página Trabalhos do AWS IoT.
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. Clone ou baixe-a (submódulo se estiver usando git) diretamente do repositório do OTA AWS IoT. As demonstrações OTA do AWS IoT estão na distribuição primária do FreeRTOS. Para obter mais detalhes, consulte a página OTA AWS IoT.
CLI e FreeRTOS_Plus_CLI	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 para obter mais detalhes. As integrações de referência do FreeRTOS IoT em destaque nas plataformas NXP i.MX RT1060 e STM32U5 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 para saber como implementar a macro de registro em log. Consulte uma das referências de IoT apresentadas pelo FreeRTOS para ver um exemplo de execução em hardware real.
greengrass_connectivity	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.

Bibliotecas e demonstrações preteridas
Nome	Type	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, para otimizar melhor seu projeto.
dev_mode_key_provisioning	Demonstrações	As integrações de referência do FreeRTOS IoT em destaque nas plataformas NXP i.MX RT1060, STM32U5 ou ESP32-C3 fornecem exemplos de provisionamento crucial usando uma CLI.
posix	abstração e demonstração	Não recomendado para uso.
wifi_provisioning	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 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.

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.

• 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.

• lwip_osal: consulte as Integrações de Referência em destaque do FreeRTOS no i.MX RT1060 ou STM32U5 para saber como implementar o lwip_osal em sua placa/plataforma de hardware.

• d: clone (submódulo se você usa git) diretamente do repositório Mbed-TLS. 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 ou do repositório OASIS PKCS 11.

• tinycbor: clone (submódulo se você usa git) diretamente do repositório 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.

• tracealyzer_recorder: clone-o (submódulo se você usar git) diretamente do repositório de gravadores de rastreamento do trace recorder.

• unity: clone-o (submódulo se você usar git) diretamente do repositório ThrowTheSwitch/Unity.

• win_pcap : a win_pcap 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. 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.