microchip-application-cc2650-wtp_cc2650_development/README.md

# WTP_cc2650_development

##  Device

### Device major source code path

- main code

    `E:\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_peripheral\cc26xx\app\main.c`

    `E:\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_peripheral\cc26xx\app\simple_peripheral.c`

    `E:\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_peripheral\cc26xx\app\headstage\headstage.h`

- gpio table
    
    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\boards\BOOSTXL_CC2650MA\BOOSTXL_CC2650MA.h`
    
    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\boards\CC2650_LAUNCHXL\CC2650_LAUNCHXL.h`
    
- GATT

    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\profiles\simple_profile\simple_gatt_profile.h`
    
    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\profiles\simple_profile\cc26xx\simple_gatt_profile.c`

### Memory board major source code path:
- cc2650 host_test

    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\host_test\cc26xx\app\host_test_app.c`

    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\host_test\cc26xx\app\main.c`

- cc2650 central

    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_central\cc26xx\app\main.c`

    `E:\WT_project_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_central\cc26xx\app\simple_central.c`

* * *

## How to install this project in your PC

### Prerequisite:

anti-virus software might cause some problems, disable it while installing is recommended.

### Install CCStudio

1. [code composer studio](https://www.ti.com/tool/CCSTUDIO) :
    choose the latest version (we use Version: 11.1.0.00011 Release date: 20 Dec 2021, Windows single file installer for CCS IDE) of Code Composer Studio.
    
2. unzip it
    
3. open the folder **CCS11.1.0.00011_win64** -> Open sub-folder **CCS11.1.0.00011_win64**
    
4. run installer **ccs_setup_11.1.0.00011.exe**
    
5. accept the license
    
6. install at folder `C:\ti\ccs1110`

7. select installation type: Custom installation

8. select Components: SimpleLink CC13xx and CC26xx Wireless MCUs

9. select all Debug Probes

10. finish. Wait for the install process......
    
11. select options to create desktop shortcut and launch CCStudio
    
12. at the first launch, CCStudio will ask you to select a directory as workspace. use directory `C:\Users\kimwu\workspace_ti` -> Launch

### install BLE STACK

1. [BLE STACK](https://www.ti.com/tool/BLE-STACK-ARCHIVE):
    choose **BLE-STACK-2-2-2 — BLE-STACK V2.2.2 (Support for CC2640/CC2650)** Free version.
    (a TI account is required)

2. run **ble_sdk_2_02_02_25_setup.exe**
    
3. accept the license agreement
    
4. install **the BLE-Stack SDK** at the directory `C:\ti\simplelink` -> wait for the install process......
    
5. **Setup - TI-RTOS for CC13xx and CC26xx Wireless MCUs 2.21.01.08** will jump out -> use installation directory `C:\ti` -> next

    at the same time, **ble_sdk_2_02_02_25_setup.exe** will still be running, don't close the window
    
6. wait for the install process......

7. finish
    
### First run CCStudio and setting

1.  start CCStudio, Use the default.`C:\Users\kimwu\workspace_ti` -> Launch
    
2.  Project -> Import CCS Projects -> Select search-directory `C:\ti\simplelink\ble_sdk_2_02_02_25\examples\cc2650em\simple_peripheral` -> OK -> select all discovered projects -> finish
    
4.  right click `simple_peripheral_cc2650em_app` -> Properties -> General -> Products -> double click **com.ti.rtsc.TIRTOSCC13XX_CC26XX [2.21.1.08]** -> Preferences -> refresh -> select ```"C:\ti\tirtos_cc13xx_cc26xx_2_21_01_08"``` and ```"C:\ti\xdctools_3_32_00_06_core"``` -> Install -> restart CCS

5. right click `simple_peripheral_cc2650em_app` -> Properties -> General -> Project: Compiler version -> Tool-chain: **Compiler version: TI v20.2.5LTS** -> apply amd close
    
6. right click `simple_peripheral_cc2650em_stack` -> Properties -> General -> Project: Compiler version -> Tool-chain: **Compiler version: TI v20.2.5LTS** -> apply amd close
    
7. click `simple_peripheral_cc2650em_app`, Click *build* and it's done

8. click `simple_peripheral_cc2650em_stack` Click *build* and it has error: "C:/ti/simplelink/ble_sdk_2_02_02_25/src/components/osal/src/common/osal.c", line 408: error #167: too few arguments in function call

    modify code: osal.c line:408
    return ( (unsigned char*)ltoa( l, (char *)buf) ); ->   return ( (unsigned char*)ltoa( l, (char *)buf, radix) );

    and then, click *build* and it's done
    

### clone this project

#### with Command line interface (git-bash)

1.  clone our project to E:\MCU_code\.
    
    `git clone [WTP_cc2650_development URL]`, where URL is our project url on gitlab.
2.  copy `E:\MCU_code\wtp_cc2650_development\backup\examples` to `E:\MCU_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25`

    terminal: 
    $cd /e/MCU_code/wtp_cc2650_development
    $cp -r ./backup/examples ./simplelink/ble_sdk_2_02_02_25/


    
### select project at CCS
1.  start CCStudio, Use the directory.`C:\Users\kimwu\workspace_ti_wtp_cc2650_development` -> Launch
    
2.  Project -> Import CCS Projects -> Select search-directory `E:\MCU_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\examples\cc2650em\simple_peripheral` -> OK
    
3.  select all discovered projects -> finish
    
4. right click `simple_peripheral_cc2650em_app` -> Properties -> Build-> Arm Compiler -> Include Options 
    -> change `"D:\MCU_code\wtp_cc2650_simple_func\simplelink\ble_sdk_2_02_02_25\src\examples\simple_peripheral\cc26xx\app\headstage"` 
    to `"E:\MCU_code\wtp_cc2650_development\simplelink\ble_sdk_2_02_02_25\src\examples\simple_peripheral\cc26xx\app\headstage"` 
    -> Apply and Close


### Optional

#### install git if you don't install it

- https://git-scm.com/download/win
    
- choose corresponding version for your computer from 'Git for Windows Setup'
    

#### doxygen: tool to help documenting code

- download from main page http://www.doxygen.nl/download.html
    
- according to different OS, download corresponding version.
    
- press keyboard 'ctrl' + 'shift' + 'a' to search external tool, select 'external tools-setting'
    
- add external tool by pressing '+'
    
- name this external tool in the column 'name'
    
- set the path of doxygen execute file in the column 'program'
    
- set the repository we want to generate document automatically in the column 'working directory'
    
- set hotkey of doxygen to run : 'File' -> 'Setting' -> 'Keymap' -> 'external tools'
    
- press the hotkey to run doxygen
    

### Troubleshooting

- jump a dialog with **MSVC components failed to install.
    Please install executables manually from c:/ti/ccsv8/installers before using CCS**
    
    ignore it.
    
- jumps a warning dialog of Windows Defender
    Allow the network access.
    

* * *

Copyright (c) 2021. WISTOP. Scientific.