Getting Started with the SaBLE-x-R2

This SaBLE-x-R2 Board File Package is specifically for v2.30.00.28 of the TI SIMPLELINK-CC2640R2 SDK. In particular, it is setup to ensure that the simple_peripheral sample app will work on the SaBLE-x-R2. If you need to use the other sample apps in the SDK, please refer to "The Files" section below and apply the same changes to the app you plan to use.

Required SW and HW Tools

  1. Sable-X-R2 Dev Kit (Part Nunber: 450-0184 or 450-0185)
  2. SDK v2.30.00.28: http://www.ti.com/tool/download/SIMPLELINK-CC2640R2-SDK
  3. Code Composer Studio: http://processors.wiki.ti.com/index.php/Download_CCS
  4. JTAG Programmer: For example LAUNCHXL-CC2640R2 http://www.ti.com/tool/LAUNCHXL-CC2640R2
  5. Serial Terminal: RealTerm (https://sourceforge.net/projects/realterm/) is recommended so that the CTS and RTS pins can be cleared. The dev kit uses flow control (i.e. CTS & RTS) to control Reset. If you use a Serial Terminal that doesn't allow you to clear CTS and RTS (e.g. Tera Term, Putty), the module will be held in Reset.
  6. BLE Scanner: download from App or Play Store

Steps

  1. Install all the SW from above list. It's recommended that you install the SDK in C:\TI folder.
  2. Create a folder named SABLE-X-R2_DEV_BOARD in C:\TI\simplelink_cc2640r2_sdk_2_30_00_28\examples\rtos
  3. Copy C:\TI\simplelink_cc2640r2_sdk_2_30_00_28\examples\rtos\CC2640R2_LAUNCHXL\ble5stack folder into C:\TI\simplelink_cc2640r2_sdk_2_30_00_28\examples\rtos\SABLE-X-R2_DEV_BOARD\
  4. Extract the SaBLE-x-R2 Board File Package (i.e. SaBLE-x-R2-BoardFilePkgForSDK2.30.00.28.zip) into C:\TI\simplelink_cc2640r2_sdk_2_30_00_28. This will add new files and replace some existing files in the SDK.
  5. Launch Code Composer Studio, create a workspace and import the simple_peripheral project from C:\TI\simplelink_cc2640r2_sdk_2_30_00_28\examples\rtos\SABLE-X-R2_DEV_BOARD\ble5stack\simple_peripheral
  6. Build the project
  7. Flash build into SaBLE-x-R2 dev kit and run program
  8. Connect with BLE Scanner
  9. If using Real Term, connect to USB port of SaBLE-x-R2 dev kit. Set to 115200, N, 8, 1. Set display to Ansi. RTS and CTS pins MUST be cleared. To clear, click the Pins tab and then click Clear CTS and RTS. You may have to use the Windows Device Manager to determine the port number.

The Files

When the zip file is extracted into the SDK, it will add several files and modify some existing files in the SDK.

The SaBLE-x-R2 module contains the CC2640R2F 5x5 mm RHB package with 15 GPIOs. The RF frontend is configured as differential output with external bias.

The files in this board file package, and following the steps in this guide will include the correct defines in software to ensure correct operation of the SaBLE-x-R2 with the 5x5 chipset.

All TI examples in the SDK are setup to use the larger 7x7 mm package that has more GPIO pins. When writing your own board file please make sure to #define CC2650EM5XD and remove #define CC2650EM7ID.

The Added Files

The added files are located in the following folders:

  1. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\boards\SABLEXR2_DEV_BOARD
  2. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\target\sablexr2_module

The Modified Files

  1. C:\TI\SDK2.30.00.00.28\examples\rtos\SABLE-X-R2_DEV_BOARD\ble5stack\simple_peripheral\src\ccfg_app_ble.c

    To ensure the user can still bootload the module with the UART bootloader, ccfg_app_ble.c is replaced with Laird's version of ccfg_app_ble.c

  2. C:\TI\SDK2.30.00.00.28\examples\rtos\SABLE-X-R2_DEV_BOARD\ble5stack\simple_peripheral\tirtos\ccs\defines\ble5_simple_peripheral_cc2640r2lp_app_FlashROM_StackLibrary.opt

    Line 4 modified. Replaced -DCC2640R2_LAUNCHXL with -DSABLEXR2_DEV_BOARD

  3. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\target\board.c

    Added lines 72 and 73. Added compile option for SABLEXR2_DEV_BOARD

  4. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\target\board.h

    Added ines 71 and 72. Added compile option for SABLEXR2_DEV_BOARD

  5. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\icall\app\ble_user_config.c

    Modified to set Tx Power to 12. See lines 82 to 86. This translates to 5dBm, the max power for the SaBLE-x-R2

  6. C:\TI\SDK2.30.00.00.28\source\ti\ble5stack\common\cc26xx\board_key.c

    The following lines were modified: 104, 141, 157 and 199. Added || defined(SABLEXR2_DEV_BOARD)