CC2340R5 to CC2340R22 Porting Guide

This section will describe, in general terms, how to migrate a project developed for the CC2340R5 device to a CC2340R22 device running the SimpleLink Low Power F3 SDK. However, it is important to first assess the differences between both devices to make sure that the project migration is possible (See Platform Devices Comparison).

Evaluate the CC2340R22 device when only having CC2340R5 devices

To evaluate the CC2340R22 when only having a CC2340R5, you can modify the Flash size as described bellow:

  • Open the Linker command file .cmd and modify the Flash size to 256 kB.

    Listing 205. lpf3_app_freertos.cmd - Replace FLASH_SIZE value.
    1#define FLASH_SIZE   0x40000

Note

The two devices are API compatible, a project for CC2340R22 developed on CC2340R5 can be migrated (via the migration guide below) with very few modifications to be built and flashed on CC2340R22.

Migration Guide

The recommended migration path is to start with a CC2340R5 based example project from the SimpleLink Low Power F3 SDK and follow the next steps:

  1. Import the project into Code Composer Studio or you IDE of preference.

  2. Open SysConfig, go to Device View and click on SWITCH.

../../_images/DeviceView_Switch.png

Figure 265. SysConfig - Switch Device.

  1. Once the Switch Board or Device window is opened, select the CC2340R22 board, or CC2340R22 device and click on CONFIRM. Make sure to save the project changes so that the migration takes place.

../../_images/Select_R22device.png

Figure 266. SysConfig - Select CC2340R22 device.

Warning

If a new linker command file is generated after migration (named cc23x0r2.cmd in the project files) please make sure to exclude it from build (or eliminated it from the project files) so that the original lpf3_app_freertos.cmd file is used during build time.

  1. Open SysConfig and reduce the internal NVS size, under NVS → Internal Flash. For an out-of-the-box implementation of the examples, consider using 0x3C000 as the region base value.

../../_images/change_NVS_basic_ble.png

Figure 267. SysConfig - Modify NVS base region.

  1. Build the project.

Additional Steps for Off-Chip OAD and MCUBoot examples

Note

The CC2340R22 device does not support On-Chip and Dual Image OAD due to reduced Flash size.

  1. Right click on the project file and select Properties. Modify the post build steps so that the slot sizes match the ones of the CC2340R22 device.

../../_images/modify_post_build_offchip.png

Figure 268. Project Properties - Modify post build steps.

  1. For the MCUBoot project, additionaly to the device migration, modify the MCUBoot configuration inside SysConfig.

    • Enable Overwrite-only code path.

    • Enable External Flash configuration.

    • Modify the Base Address and Image Size depending on your application.

../../_images/flash_backend_size.png

Figure 269. SysConfig - MCUBoot.

  1. Build both projects.