
.. _cc2340r53_to_cc2340r53q1_migration:

CC2340R53 to CC2340R53-Q1 Migration Guide
=========================================

This is a migration guide for enabling a new SDK to operate with a new member of 
a device family. This is currently shown for the CC2340R53-Q1 device in the 
|DEVICE_LOW_PLUS_RAM_UP| family of devices.

1.  Make sure the CCS and IAR version being used is the version recommended by the SDK in use. This can be found in the release notes for the SDK.

2.  Import the project for the |DEVICE_LOW_PLUS_RAM_UP| if not already done.

3.  Open the project.syscfg file and click the `Show Device View` button at the top right.

.. _cc2340r53_to_cc2340r53q1_migration_show_device_view:
.. figure:: ./resources/sdk_7_40_cc23xxrhbxx_examples_migration_guide__show_device_view.png
    :align: center

    Open `Show Device View`

4.  Click `Switch`.
  
.. _cc2340r53_to_cc2340r53q1_migration_switch:
.. figure:: ./resources/sdk_7_40_cc23xxrhbxx_examples_migration_guide__click_switch.png
    :align: center

    Select Switch 

5.  Click on `CC2340R53 Q1 Development Platform` in the *New Value* dropdown menu.

.. _cc2340r53_to_cc2340r53q1_migration_select_q1_variant:
.. figure:: ./resources/SelectQ1Variant.png
    :align: center

    Select CC2340R53Q1 Variant

6.  Then click `Confirm` at the bottom right of the menu box.

7.  Build the project.

.. **If there are build errors:**

.. -	Right-click the error and select `Go To Resource` shown in *Figure 4*.

..   .. figure:: ./resources/sdk_7_40_cc23xxrhbxx_examples_migration_guide__go_to_resource.png
..       :align: center

..       Figure 4

..   - Through this process, there may be errors that are related to GPIO names. This can be resolved by selecting `Go To Resource`, select the specific DIO in the dropdown menu (shown as "DIO19/17 (LaunchPad LED Green)" here in *Figure 5*). This may have to be done for several resources, and we have experienced this being needed for several GPIOs and/or LEDs before.

..   .. figure:: ./resources/sdk_7_40_cc23xxrhbxx_examples_migration_guide__example_image.png
..       :align: center
      
..       Figure 5

After completing the above steps, the project should build without errors and be 
able to flash the project(s) to the target device. This will need to be done for 
all projects that need to be migrated.