periodic update 10/19/20 13:15 PDT

Author: robhath

doc_source/portingguide/afr-porting-ble.md

@@ -167,8 +167,10 @@ The `CMakeLists.txt` template list file under `freertos/vendors/vendor/boards/bo
 
 1. Check the test results in the UART console\.
 
-## Validation<a name="w3aac11c39c13"></a>
+## Validation<a name="ble-validation"></a>
 
 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 have ported the Bluetooth Low Energy library, you can start the FreeRTOS qualification process\. For more information, see the [FreeRTOS Qualification Guide](https://docs.aws.amazon.com/freertos/latest/qualificationguide/)\.
+After you have ported the Bluetooth Low Energy library, you can start the FreeRTOS qualification process\. For more information, see the [FreeRTOS Qualification Guide](https://docs.aws.amazon.com/freertos/latest/qualificationguide/)\.
+
+If the device supports Over the Air Updates, then you should also validate Over the Air Updates over Bluetooth Low Energy using a companion device\. For more details, see the next topic, [Perform Over the Air Updates using Bluetooth Low Energy](ota-updates-ble.md)\.

doc_source/portingguide/afr-porting-pkcs.md

@@ -43,13 +43,13 @@ To port the PKCS \#11 library, you need the following:
    + A code\-verification public key \(or a certificate that contains the code\-verification public key\) for secure bootloader and over\-the\-air \(OTA\) updates\.
    + A Just\-In\-Time provisioning certificate\.
 
-    `freertos/vendors/vendor/boards/board/ports/pkcs11/iot_pkcs11_pal.c` contains empty definitions for the PAL functions\. You must provide ports for, at minimum, the functions listed in this table:    
+    `freertos/vendors/vendor/boards/board/ports/pkcs11/core_pkcs11_pal.c` contains empty definitions for the PAL functions\. You must provide ports for, at minimum, the functions listed in this table:    
 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html)
 
 1. Add support for a cryptographically random entropy source to your port:
    + If your ports use the mbedTLS library for underlying cryptographic and TLS support, and your device has a true random number generator \(TRNG\):
 
-     1. Implement the [ `mbedtls_hardware_poll()`](https://github.com/ARMmbed/mbedtls/blob/master/include/mbedtls/entropy_poll.h#L92) function to seed the deterministic random bit generator \(DRBG\) that mbedTLS uses to produce a cryptographically random bit stream\. The `mbedtls_hardware_poll()` function is located in `freertos/vendors/vendor/boards/board/ports/pkcs11/iot_pkcs11_pal.c`\. 
+     1. Implement the [ `mbedtls_hardware_poll()`](https://github.com/ARMmbed/mbedtls/blob/master/include/mbedtls/entropy_poll.h#L92) function to seed the deterministic random bit generator \(DRBG\) that mbedTLS uses to produce a cryptographically random bit stream\. The `mbedtls_hardware_poll()` function is located in `freertos/vendors/vendor/boards/board/ports/pkcs11/core_pkcs11_pal.c`\. 
    + If your ports use the mbedTLS library for underlying cryptographic and TLS support, but your device does not have a TRNG:
 
      1. Make a copy of `freertos/libraries/3rdparty/mbedtls/include/mbedtls/config.h`, and in that copy, uncomment `MBEDTLS_ENTROPY_NV_SEED`, and comment out `MBEDTLS_ENTROPY_HARDWARE_ALT`\.
@@ -81,7 +81,7 @@ In the following steps, make sure that you add the source files to your IDE proj
 
 **To set up the PKCS \#11 library in the IDE project**
 
-1. Add the source file `freertos/vendors/vendor/boards/board/ports/pkcs11/iot_pkcs11_pal.c` to the `aws_tests` IDE project\.
+1. Add the source file `freertos/vendors/vendor/boards/board/ports/pkcs11/core_pkcs11_pal.c` to the `aws_tests` IDE project\.
 
 1. Add all of the files in the `freertos/libraries/abstractions/pkcs11` directory and its subdirectories to the `aws_tests` IDE project\.
 
@@ -109,7 +109,7 @@ afr_mcu_port(pkcs11_implementation DEPENDS AFR::pkcs11_mbedtls)
 target_sources(
     AFR::pkcs11_implementation::mcu_port
     INTERFACE
-    "${afr_ports_dir}/pkcs11/iot_pkcs11_pal.c"
+    "${afr_ports_dir}/pkcs11/core_pkcs11_pal.c"
 )
 ```
 

doc_source/portingguide/afr-porting.md

@@ -34,6 +34,10 @@ Currently, a port of the FreeRTOS OTA update library is not required for qualifi
 **Note**  
 Currently, a port of the FreeRTOS Bluetooth Low Energy library is not required for qualification\.
 
+1. [Perform Over the Air Updates using Bluetooth Low Energy](ota-updates-ble.md)
+**Note**  
+Currently AWS IoT Device Tester does not support qualification of Over the Air updates using Bluetooth Low Energy library\. A partner interested in this qualification should contact AWS through the APN \(AWS Partner Network\) team\.
+
 1. [Porting the common I/O libraries](freertos-porting-commonio.md)
 **Note**  
 Currently, a port of the FreeRTOS common I/O library is not required for qualification\.

doc_source/portingguide/index.md

@@ -44,5 +44,6 @@ Amazon's trademarks and trade dress may not be used in
    + [Configuring the HTTPS client library for testing](afr-porting-https.md)
    + [Porting the OTA 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)
 + [Migrating from Version 1.4.x to Version 201906.00 (and newer)](porting-migration.md)