periodic update 07/27/2021 11:28 PDT

Author: robhath

doc_source/portingguide/afr-porting-kernel.md

@@ -6,7 +6,7 @@ FreeRTOS uses the FreeRTOS kernel for multitasking and inter\-task communication
 
 **Note**  
 Porting the FreeRTOS kernel to a new architecture is out of the scope of this documentation\. If you are interested in porting the FreeRTOS kernel to a new architecture, [contact the FreeRTOS engineering team](https://freertos.org/RTOS-contact-and-support.html)\.  
-For the FreeRTOS Qualification program, only existing ports are supported\. Modifications to these ports are not accepted within the Qualification program\. Only the official ports that can be downloaded from [Github](https://github.com/aws/amazon-freertos) or [Sourceforge](https://sourceforge.net/projects/freertos/) are accepted\.
+For the FreeRTOS Qualification program, only existing ports are supported\. Modifications to these ports are not accepted within the Qualification program\. Only the official ports that can be downloaded from [Github](https://github.com/aws/amazon-freertos) are accepted\.
 
 ## Prerequisites<a name="porting-prereqs-kernel"></a>
 

doc_source/portingguide/afr-porting-mqtt.md

@@ -44,8 +44,8 @@ After you set up the library in the IDE project, you need to configure other fil
 
 To officially qualify a device for FreeRTOS, you need to validate the device's ported source code with AWS IoT Device Tester\. Follow the instructions in [ Using AWS IoT Device Tester for FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/device-tester-for-freertos-ug.html) in the FreeRTOS User Guide to set up Device Tester for port validation\. To test a specific library's port, the correct test group must be enabled in the `device.json` file in the Device Tester `configs` folder\.
 
-After you set up the coreMQTT library for your device, you can start porting the OTA agent library\. See [Porting the OTA library](afr-porting-ota.md) for instructions\.
+After you set up the coreMQTT library for your device, you can start porting the OTA agent library\. See [Porting the AWS IoT over\-the\-air update library](afr-porting-ota.md) for instructions\.
 
 If your device doesn't support OTA functionality, you can start porting the Bluetooth Low Energy library\. See [Porting the Bluetooth Low Energy library](afr-porting-ble.md) for instructions\.
 
-If your device doesn't support OTA and Bluetooth Low Energy functionality, then you are finished porting and can start the FreeRTOS qualification process\. See the [FreeRTOS Qualification Guide](https://docs.aws.amazon.com/freertos/latest/qualificationguide/) for more information\.
+If your device doesn't support OTA and Bluetooth Low Energy functionality, then you are finished porting and can start the FreeRTOS qualification process\. See the [ FreeRTOS Qualification Guide](https://docs.aws.amazon.com/freertos/latest/qualificationguide/) for more information\.

doc_source/portingguide/afr-porting-ota.md

@@ -24,7 +24,7 @@ If your device does not support Wi\-Fi, you can use an ethernet connection to co
 
 1. [Configuring the coreHTTP library for testing](afr-porting-corehttp.md)
 
-1. [Porting the OTA library](afr-porting-ota.md)
+1. [Porting the AWS IoT over\-the\-air update library](afr-porting-ota.md)
 **Note**  
 Currently, a port of the FreeRTOS OTA update library is not required for qualification\.
 

doc_source/portingguide/afr-porting.md

@@ -42,9 +42,11 @@ Amazon's trademarks and trade dress may not be used in
          + [ca.config](porting-ca-config.md)
    + [Configuring the coreMQTT library for testing](afr-porting-mqtt.md)
    + [Configuring the coreHTTP library for testing](afr-porting-corehttp.md)
-   + [Porting the OTA library](afr-porting-ota.md)
+   + [Porting the AWS IoT over-the-air update library](afr-porting-ota.md)
    + [Porting the Bluetooth Low Energy library](afr-porting-ble.md)
    + [Perform Over the Air Updates using Bluetooth Low Energy](ota-updates-ble.md)
    + [Porting the common I/O libraries](freertos-porting-commonio.md)
    + [Porting the Cellular library](freertos-porting-cellular.md)
-+ [Migrating from Version 1.4.x to Version 201906.00 (and newer)](porting-migration.md)
++ [Migrating from Version 1.4.x to Version 201906.00 (and newer)](porting-migration.md)
++ [Migrating from version 1 to version 3 for OTA applications](porting-migration-ota.md)
++ [Migrating from version 1 to version 3 for OTA Pal port](porting-migration-ota-pal.md)

doc_source/portingguide/index.md

@@ -7,7 +7,7 @@ You can use the FreeRTOS Bluetooth Low Energy \(BLE\) and Over the Air Updates \
 ## Prerequisites<a name="ota-updates-ble-prereqs"></a>
 
 1. Port the Over The Air Updates agent to each microcontroller device:
-   + Follow the steps in [Porting](afr-porting-ota.md#porting-steps-ota) and [IoT device bootloader](afr-porting-ota.md#afr-bootloader)\.
+   + Follow the steps in [Platform porting](afr-porting-ota.md#porting-steps-ota) and [IoT device bootloader](afr-porting-ota.md#afr-bootloader)\.
    + After porting, follow the steps in [Testing](afr-porting-ota.md#porting-testing-ota) to verify that the OTA PAL tests pass\.
 
 1. Port the Bluetooth Low Energy library to each microcontroller:
@@ -273,8 +273,8 @@ Certificates don't have to be added when you use Amazon Cognito credentials\.
 1. Open `vendors/vendor/boards/board/aws_demos/common/config_files/aws_iot_network_config.h`\. 
    + Change `configSUPPORTED_NETWORKS` and `configENABLED_NETWORKS` to only include `AWSIOT_NETWORK_TYPE_BLE`\.
 
-1. Open `demos/include/aws_ota_codesigner_certificate.h`:
-   + Change `signingcredentialSIGNING_CERTIFICATE_PEM` to refer to the certificate to be used to sign the firmware binary file\.
+1. Open `ota_demo_config.h`:
+   + Change `otapalconfigCODE_SIGNING_CERTIFICATE` to refer to the certificate to be used to sign the firmware binary file\.
 
    The application should start up and print the demo version:
 

doc_source/portingguide/ota-updates-ble.md

@@ -1,6 +1,6 @@
 # Downloading FreeRTOS for Porting<a name="porting-download"></a>
 
-Before you begin porting FreeRTOS to your platform, you need to download FreeRTOS or clone the FreeRTOS repository from [GitHub](https://github.com/aws/amazon-freertos)\. See the [README\.md](https://github.com/aws/amazon-freertos/blob/master/README.md) file for instructions\.
+Before you begin porting FreeRTOS to your platform, you need to download FreeRTOS or clone the FreeRTOS repository from [GitHub](https://github.com/aws/amazon-freertos)\. See the [README\.md](https://github.com/aws/amazon-freertos/blob/main/README.md) file for instructions\.
 
 **Note**  
 We recommend that you clone the repository\. Cloning makes it easier for you to pick up updates to the master branch as they are pushed to the repository\.

doc_source/portingguide/porting-download.md

@@ -15,7 +15,7 @@ The FreeRTOS kernel and components are released individually and use semantic ve
 + M represents the month\.
 + N represents the release order within the designated month \(00 being the first release\)\.
 
-For example, a second release in June 2021 would be 202106\.01\. 
+For example, a second release in July 2021 would be 202107\.01\. 
 
 Previously, FreeRTOS releases used semantic versioning for major releases\. Although it has moved to date\-based versioning \(FreeRTOS 1\.4\.8 updated to FreeRTOS AWS Reference Integrations 201906\.00\), the FreeRTOS kernel and each individual FreeRTOS library still retain semantic versioning\. In semantic versioning, the version number itself \(X\.Y\.Z\) indicates whether the release is a major, minor, or point release\.  You can use the semantic version of a library to assess the scope and impact of a new release on your application\.
 
@@ -39,7 +39,7 @@ The device that you port to FreeRTOS must be a microcontroller board that meets
 + 25MHz processing speed
 + 64KB RAM
 + 128KB program memory per executable image stored on the MCU
-+ \(If [Porting the OTA library](afr-porting-ota.md)\) Two executable images stored on the MCU
++ \(If [Porting the AWS IoT over\-the\-air update library](afr-porting-ota.md)\) Two executable images stored on the MCU
 
 ### Porting older versions of FreeRTOS<a name="porting-older"></a>
 
@@ -50,6 +50,7 @@ If you are porting an older version of FreeRTOS, go to the [FreeRTOS AWS Referen
 
 |  Date  |  Documentation version for the Porting and Qualification guides  |  Change history  |  FreeRTOS version  | 
 | --- | --- | --- | --- | 
+|  July, 2021  |  [ 202107\.00](https://github.com/aws/amazon-freertos/blob/202107.00/doc/freertos_port_qual/FreeRTOS_Porting_Guide.pdf) \(Porting Guide\) [ 202107\.00](https://github.com/aws/amazon-freertos/blob/202107.00/doc/freertos_port_qual/FreeRTOS_Qualification_Guide.pdf) \(Qualification Guide\)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/freertos/latest/portingguide/porting-guide.html)  |  [202107\.00](https://github.com/aws/amazon-freertos/tree/202107.00)  | 
 |  December, 2020  |  [ 202012\.00](https://github.com/aws/amazon-freertos/blob/202012.00/doc/freertos_port_qual/FreeRTOS_Porting_Guide.pdf) \(Porting Guide\) [ 202012\.00](https://github.com/aws/amazon-freertos/blob/202012.00/doc/freertos_port_qual/FreeRTOS_Qualification_Guide.pdf) \(Qualification Guide\)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/freertos/latest/portingguide/porting-guide.html)  |  [202012\.00](https://github.com/aws/amazon-freertos/tree/202012.00)  | 
 |  November, 2020  |  [ 202011\.00](https://github.com/aws/amazon-freertos/blob/202011.00/doc/freertos_port_qual/FreeRTOS_Porting_Guide.pdf) \(Porting Guide\) [ 202011\.00](https://github.com/aws/amazon-freertos/blob/202011.00/doc/freertos_port_qual/FreeRTOS_Qualification_Guide.pdf) \(Qualification Guide\)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/freertos/latest/portingguide/porting-guide.html)  |  [202011\.00](https://github.com/aws/amazon-freertos/tree/202011.00)  | 
 |  July, 2020  |  [ 202007\.00](https://github.com/aws/amazon-freertos/blob/202007.00/doc/freertos_port_qual/FreeRTOS_Porting_Guide.pdf) \(Porting Guide\) [ 202007\.00](https://github.com/aws/amazon-freertos/blob/202007.00/doc/freertos_port_qual/FreeRTOS_Qualification_Guide.pdf) \(Qualification Guide\)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/freertos/latest/portingguide/porting-guide.html)  |  [202007\.00](https://github.com/aws/amazon-freertos/tree/202007.00)  |