Porting Guide and Migration Guides

Porting Guides

Porting guide is used to port incremental changes from the previous SDK.

Note

The F3 SDK 9.20 restructured the CC27xx folders. The older SDKs such as the F3 SDK 9.14 had the structure cc27xx, but in the F3 SDK 9.20 it changed to cc27xxx10 and cc27xxx20. As an example if migrating from F3 SDK 9.14 to F3 SDK 9.20 the following include #include source/ti/devices/cc27xx/... changes to #include source/ti/devices/cc27xxx10/.... The other method is to forgo referencing explicit device folders and instead always use the DeviceFamily_constructPath() macro:

  • #include <ti/devices/DeviceFamily.h>

  • #include DeviceFamily_constructPath(driverlib/hapi.h)

Additionally the macro with DeviceFamily changed, instead of DeviceFamily_ID == DeviceFamily_ID_CC27XX we need to change it to:

  • #if DeviceFamily_ID == DeviceFamily_ID_CC27XXX10

  • #if DeviceFamily_PARENT == DeviceFamily_PARENT_CC27XX

Migration Guides

Migration guide is used to migrate major changes, e.g. from one device to another device or from one configuration to another.

Note

Starting with the F3 SDK 8.40 introduced the RNG Health Check functionality: the RNG driver random number generation APIs will now perform an entropy check and not generate any output if the entropy is not within acceptable ranges; in such case random number generation should be re-attempted. This could cause existing implementations of RNG to not work as expected.

Listing 20. Code snippet for checking RNG
for(int i = 0; i < n; i++) //n should be set to at least 5 or 10
{
    rclStatus = RCL_AdcNoise_get_samples_blocking(localNoiseInput, RNGLPF3RF_noiseInputWordLen);

    // Initialize the RNG driver noise input pointer with global noise input array from user //
    rclStatus = RNGLPF3RF_conditionNoiseToGenerateSeed(localNoiseInput);

    if(rclStatus = 0)
    {
    //RNG driver has succeeded generating a number
    break;
    }

    else if(i == (n-1))
    {
    //error handling, report error here
    }
}