
.. _cc2340r5_to_cc2340r5q_migration:

CC2340R52 to CC2340R52-Q 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 CC2340R52-Q device in the 
|DEVICE| family of devices.

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

-	Import the project for the |DEVICE| if not already done.

-	Open the project.syscfg file and click the `Show Device View` button at the top right shown in *Figure 1*.

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

      Figure 1

-	Click `Switch` shown in *Figure 2*.

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

      Figure 2

-	Click on `CC2340R5 Q1 Development Platform` in the *New Value* dropdown menu shown in *Figure 3*.

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

      Figure 3

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

-	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.