..  README
    Newest guides at the top. Previous one-time guides go into Previous Migration
    Guides section. The nice thing here is that you just need to move the guide.
    Also, these guide are intended to be static one-time snapshots. No effort
    will be made to re-purpose each porting guide for the next release.


Porting Guide and Migration Guides
==================================

..  TODO
    Porting from RF Driver (CC13xx/CC26xx) to Radio 
    Control Layer (CC23xx)

Porting Guides
--------------

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

.. toctree::
    :maxdepth: 1

..
    ti_rtos_to_device_sdk

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:: 
    The F3 SDK 8.40 introduces 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.

.. code-block:: 
    :caption: 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
        }
    }

Device migration guides
^^^^^^^^^^^^^^^^^^^^^^^

.. toctree::
    :titlesonly:
                                                                                                                                                                                                                                                 
    proprf_cc26x2_to_cc23xx.rst
    migration-cc2340r5_cc2340r21.rst
    migration-cc2340r5_cc2340r22.rst
    /cc23xx/cc2340r53-migration-guide.rst

Other migration guides
^^^^^^^^^^^^^^^^^^^^^^

.. toctree::
    :titlesonly:
    
    rflib_to_rcl.rst
    /cc23xx/uart_to_uart2.rst
    /cc23xx/gpio-porting-guide-cc23xx.rst

