CC2650 LaunchPad User's Guide for ZigBee

Introduction

This page covers the new CC2650 LaunchPadTM (LAUNCHXL-CC2650), including new features, hardware, and how to port existing CC2630 ZigBee sample applications from the TI Z-Stack Home 1.2.2a to the LaunchPad. At just $29, the CC2650 LaunchPad is a complete development platform with an integrated XDS110 debugger that can be used to prototype ZigBee IoT applications.

Hardware

The CC2650 LaunchPad includes the following hardware features:

• External 8Mbit Serial Flash for supporting Over the Air (OAD) firmware updates
• 2x push buttons
• Entire contents of CC2650EM-7ID Evaluation module
• 2x LEDs
• 2x BoosterPack connectors
• Standardized LaunchPad form factor
• XDS110 debugger w/ external target interface

Notes

• CC2650 device and RF layout is duplicated from the CC2650EM-7ID device. Schematic inquiries should refer here for reference: http://www.ti.com/tool/cc2650em-7id-rd
• The on board XDS110 JTAG debugger supports flashing & debugging an external target, follow the instructions on this wiki for details: http://processors.wiki.ti.com/index.php/Connecting_CC2650LP_to_Ext_Target

Software

• Download Z-Stack Home 1.2.2a SDK from TI website
• Install Z-Stack Home 1.2.2a to the default folder
• Download and install the latest version of TI-RTOS for SimpleLink Wireless MCUs from here http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/mcusdk/index.html . Note: The TI-RTOS version used in this guide is 2.14.03.28
• IAR for ARM(EWARM 7.40.2) to open the projects located in the default installation directory C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\HomeAutomation

Porting Z-Stack Home 1.2.2a to the CC2650 LaunchPad

This guide uses as reference the SampleSwitch application, all other sample applications can be ported to the LaunchPad in a similar manner.

Create CC2650 LaunchPad IAR Workspace

• Copy the SampleSwitch folder loacted in C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\HomeAutomation and paste it in the Same directory
• Change the folder name to SampleSwitch_LP
• Use IAR to open the new copy of the SampleSwitch project for the LaunchPad SampleSwitch.eww located in C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\HomeAutomation\SampleSwitch_LP\CC26xx
• Choose SmartRF06 workspace as shown below

• Click Project->Edit Configurations to create a CC2650 LaunchPad Workspace shown as below

• Remove the original SmartRF06 Workspace

Add Board Related Files

• Make a copy of the folder LaunchPad from C:\ti\tirtos_simplelink_2_14_03_28\packages\ti\boards\LaunchPad and paste the folder in C:\ti\tirtos_simplelink_2_11_01_09 \packages\ti\boards
• Create a folder called LaunchPad in the following directory C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\common\CC26xx
• Navigate into the directory C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\common\CC26xx\SensorTag and make a copy of the following files:

  Board.c, Board.h, board_key.c, board_led.c, ccfg.c

• Paste the previously copied files into C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\common\CC26xx\LaunchPad
• Replace the IAR workspace board files in the project with the LaunchPad board files in C:\ti\simplelink\zstack_home_1_02_02a_44539\Projects\zstack\common\CC26xx\LaunchPad

Changing the include directories and removing unused drivers

• Go to the menu Project -> Options
• Select C/C++ Compiler in the Category section on the left and go to the Preprocessor Tab.
• In the Additional include directories section look for the following entry

 $PROJ_DIR$\..\..\..\common\CC26xx\SmartRF06

and replace it with

 $PROJ_DIR$\..\..\..\common\CC26xx\LaunchPad

• in the Defined symbols section look for TI_DRIVERS_LCD_INCLUDED and add a 'x' in front of it to disable the LCD drivers as shown in the picture below and press OK.

Modifying the Board Files

- Board.c:

• In your IAR Workspace open the file Board.c that you previously added to your launchpad project.
• Replace the code in this file with the code shown below:

<syntaxhighlight lang='c'> /** ============================================================================

*  @file       Board.c
*
*  @brief      This file is a simple gateway to include the appropriate Board.c
*              file which is located in the following directories relative to this file:
*                  - CC26XXST
*
*              The project should set the include path to Board.h.
*
*  ============================================================================
*/

/*

*   The location of this Board.h file depends on your project include path.
*   Set it correctly to point to your CC2650EM_xxx
*/

1. include <Board.h>

/*

*   This is a simple gateway to the real Board.c file
*   Based on your include path to Board.h, the corresponding Board.c will also be included
*/

1. include "ti/boards/LaunchPad/CC2650LP/Board.c"

</syntaxhighlight>

- Board.h:

• Open the Board.h file
• Replace the code in this file with the code shown below:

<syntaxhighlight lang='c'> /** ============================================================================

*  @file       Board.h
*
*  @brief      CC2650EM Board Specific header file.
*              The project options should point to this file if this is the
*              CC2650EM you are developing code for.
*
*  The CC2650 header file should be included in an application as follows:
*  @code
*  #include <Board.h>
*  @endcode
*
*  ============================================================================
*/

1. ifndef BOARD_H
2. define BOARD_H

1. ifdef __cplusplus

extern "C" {

1. endif

/*

*   This is a simple gateway to the real Board.h file
*   Based on your include path to Board.h, the corresponding Board.c will also be included
*/

1. include "ti/boards/LaunchPad/CC2650LP/Board.h"

/* Generic Crypto instance identifiers */

1. define Board_CRYPTO CC2650_CRYPTO0

1. ifdef __cplusplus

}

1. endif
2. endif /* BOARD_H */

</syntaxhighlight> - board_key.c:

• Open the file board_key.c
• Replace all instances of Board_KEY_LEFT with Board_BTN1, and all instancesof Board_KEY_RIGHT with Board_BTN2.

- board_led.c:

• Open the file board_led.c
• Replace all instances of Board_LED1 with Board_RLED, and all instances of Board_LED2 with Board_GLED.

Modifying the Sample Application Code

-switch.c:

• Open the file switch.c from your project workspace in IAR.
• Replace the code in the function static void Switch_handleKeys(uint8_t keys) with the code below

<syntaxhighlight lang='c'> /*******************************************************************************

* @fn      Switch_handleKeys
*
* @brief   Callback service for keys
*
* @param   keys  - keys that were pressed
*
* @return  void
*/

static void Switch_handleKeys(uint8_t keys) {

   if(keys == KEY_LEFT)// LP BTN-1
   {
       // Send the Toggle command through ZCL
       Switch_sendToggle();
   }
   if(keys == KEY_RIGHT)// LP BTN-2
   {

1. if defined (ZCL_EZMODE)

       // Start EZMode Commissioning
       {
           zclEZMode_InvokeData_t ezModeData;
           // only bind on the on/off cluster
           static uint16_t clusterIDs[] =
           {   ZCL_CLUSTER_ID_GEN_ON_OFF};

           // Invoke EZ-Mode
           ezModeData.endpoint = SWITCH_EP; // endpoint on which to invoke
                                            // EZ-Mode
           if( (savedState == zstack_DevState_DEV_ZB_COORD)
               || (savedState == zstack_DevState_DEV_ROUTER)
               || (savedState == zstack_DevState_DEV_END_DEVICE) )
           {
               ezModeData.onNetwork = true;   // node is already on the
                                              // network
           }
           else
           {
               ezModeData.onNetwork = false;  // node is not yet on the
                                              // network
           }
           ezModeData.initiator = true;        // OnOffSwitch is an initiator
           ezModeData.numActiveOutClusters = 1; // active output cluster
           ezModeData.pActiveOutClusterIDs = clusterIDs;
           ezModeData.numActiveInClusters = 0; // no active input clusters
           ezModeData.pActiveInClusterIDs = NULL;
           zcl_InvokeEZMode(&ezModeData);

           LCD_WRITE_STRING("EZMode", LCD_PAGE2);
       }

1. elif defined (ZSTACK_MANUAL_START)

       Zstart_discovery();

1. endif // ZCL_EZMODE

   }

   // update the display
   Switch_updateLcdDisplay();

} </syntaxhighlight>

• Replace all instances of board_led_type_LED4 with board_led_type_LED2

Flashing and Running the SampleSwitch Firmware on the CC2650 LaunchPad

• Compile the ZStackCore and SampleSwitch two workspace
• Use IAR or SmartRF Flash Programmer2 download the image to CC2650 LanuchPad. More info about how to compile and image download,please refer section 3.1.2 in the doc <Z-Stack Home Sample Application User's Guide.pdf> located in C:\ti\simplelink\zstack_home_1_02_02a_44539\Documents.
• If using IAR to flash the LaunchPad make sure you select TI XDS110 Emulator' under the project options as shown in the image below.

• After downloading the image to CC2650 LaunchPad, press BTN-2 to start EZMode Commissioning.
• Wait until the Green LED turns ON which means that the LaunchPad successfully joined the network.
• Wait for the Green LED to turn OFF, this means that the EZMode Commissioning was successful.
• Press BTN-1 on the LaunchPad to send Light toggle command over the air.