Bluetooth SIG Developer Studio Plugin for TI

Table of Contents

Texas Instruments, Inc.

Bluetooth Developer Studio Plugin Readme

TI-BDS-PLUGIN Version 1.0.10 July 6th, 2018

Getting Started

NOTE: We recommend you follow the steps outlined in the SimpleLink Academy BDS PLugin workshop to get started easily:

• CC2640R2 BLE 4.2
• CC2640R2 BLE 5
• CC26x2 BLE 5

You will need Bluetooth Developer Studio in order to use this plugin. See CHANGELOG for information about implemented features, known issues, etc.

The files in the downloaded Texas Instruments -- Embedded Profiles folder should be copied into: C:\Program Files (x86)\Bluetooth SIG\Bluetooth Developer Studio\Plugins\Texas Instruments -- Embedded Profiles\*.*

Open Bluetooth Developer Studio and create your profile. When you want to generate the code, click on TOOLS->GENERATE CODE. Note For best variable name generation, use spaces in your service and characteristic names, for examle “my cool service”, as the generated names will split on spaces.

The files that are created in the output folder selected in BDS are: Profile_Name_TI_cc2640r2sdk_M_mm/ — service_name.c per service — service_name.h per service — project_zero_bds.c, using the generated services — log.txt, replica of the BDS plugin log

For support and feedback, please visit www.ti.com/ble-forum.

Test output using TI SimpleLink CC13x2, CC26x2, CC2640R2 SDK 2.20

Required software:

• SimpleLink SDK 2.20 from www.ti.com/ble-stack.
• IAR Embedded Workbench for ARM, or Code Composer Studio v8.1

Required extras for Project Zero on CC2640R2 TI BLE-Stack 3.x:

• Find Project Zero on dev.ti.com/tirex or via Resource Explorer inside Code Composer Studio.

Using CCS

Project Zero for TI BLE-Stack 3.x on CC2640R2

• Either import the project into CCS Cloud IDE from Resource Explorer online or find the project in Resource Explorer inside CCS and import it there. Note that to import locally you must also make available offline the CC2640R2 SDK and SimpleLink Academy.

• After importing, drag+drop project_zero_bds.c and the generated service source files directly from the BDS output directory into the Application folder and select ‘Copy files’.

• Right click on the original project_zero.c file in Project Explorer and click Exclude from build. Also exclude from build the 3 services Project Zero has by default under PROFILES in the IDE: led_service.c, button_service.c and data_service.c.

• Build and program

Other projects or devices

• Only the services are exported, not the application usage. Please see the BDS guide linked at the top and the companion Custom Profile workshop in SimpleLink Academy for how to integrate services with an application.

Custom parameters for TI plugin

Some functionality is added to the plugin on top of what’s available in the Bluetooth Developer Studio GUI. This is currently only utilized by the generated ProjectZero application file.

The purpose of these custom properties is to generate application code that utilize a characteristic in a specific way.

To use these, expand the properties of a Characteristic in the BDS GUI and click on CUSTOM PROPERTIES at the bottom of this view.

Property INBUTTON

This property can be used to generate debounce logic for a pin, and after debounce set the first byte of the characteristic value to the state of the pin.

Property INPIN

This property can be used to generate code that directly connects a pin interrupt to the SetParameter API of the service, setting the first byte of the value to the state of the pin.

Property OUTPIN

This property can be used to generate code that will set the pin state when an over the air write is received for the selected characteristic. The first byte of the received data will be used to set the pin state.

Examples

Note that the value must correspond to a #define which exists globally. This can be either from the board file like Board_LED0 or a generic IO reference like IOID_21.

Property	Value
OUTPIN	Board_LED0
INBUTTON	Board_BUTTON0
INPIN	IOID_02

See also the BDS example project for Project Zero that is bundled with this plugin.

Bluetooth Developer Studio Plugin downloads

Title	Description	Size
TI-BDS-PLUGIN 1.0.10	Plugin compatible with TI CC13x2, CC26x2 and CC2640R2 SDK v2.20 and BT SIG BDS v1.1	200kb
TI-BDS-PLUGIN 1.0.9	Plugin compatible with TI CC2640R2 SDK v1.40 and BT SIG BDS v1.1	188kb
TI-BDS-PLUGIN 1.0.8	Plugin compatible with TI BLE SDKv2.2, TI SimpleLink CC2640R2 SDK and BT SIG BDS v1.1	160kb
TI-BDS-PLUGIN 1.0.7 beta	Plugin compatible with TI BLE SDKv2.2 and BT SIG BDS v1.0	79kb
TI-BDS-PLUGIN 1.0.5 beta	Plugin compatible with TI BLE SDKv2.1 and BT SIG BDS v1.0	45kb