TexasInstruments-Sandbox
diff --git a/‎.gitignore‎
Lines changed: 0 additions & 1 deletion b/‎.gitignore‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎README.md‎
Lines changed: 60 additions & 77 deletions b/‎README.md‎
Lines changed: 60 additions & 77 deletions
diff --git a/‎docs/faq.md‎
Lines changed: 50 additions & 24 deletions b/‎docs/faq.md‎
Lines changed: 50 additions & 24 deletions
diff --git a/‎docs/suggested_workflow.md‎
Lines changed: 3 additions & 3 deletions b/‎docs/suggested_workflow.md‎
Lines changed: 3 additions & 3 deletions
@@ -10,7 +10,6 @@
 **/config/src
 **/tirtos/src
 **/tirtos/iar/config/
-**/Tools/src
 *.dep
 *.log
 *.ewt
 
@@ -12,20 +12,21 @@
 
 # Introduction
 
-These examples and demos are for **TI SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67**
+These examples and demos are for **TI SimpleLink CC2640R2 SDK 3.30.00.20**
 
-This repository contains *Bluetooth&reg;* 5 sample applications for
-Texas Instruments' SimpleLink CC13x2 / CC26x2 SDK. These examples have not been
+This repository contains *Bluetooth&reg;* Low Energy sample applications for
+Texas Instruments' SimpleLink CC2640R2 SDK. These examples have not been
 validated as production-ready.
 
 **Do not** use GitHub's bug tracking feature for support. For inquiries, see the
 [Bluetooth&reg; low energy Forum](https://e2e.ti.com/support/wireless_connectivity/bluetooth_low_energy/f/538).
 
 To use the examples and tools in this repository, please download and install
-the [SimpleLink CC13x2 / CC26x2 SDK](http://www.ti.com/tool/SIMPLELINK-CC13X2-26X2-SDK) **first**, and if
-necessary [buy an CC26X2](http://www.ti.com/tool/LAUNCHXL-CC26X2R1) or [CC1352](http://www.ti.com/tool/LAUNCHXL-CC1352R1) evaluation kit.
+the [SimpleLink CC2640R2 SDK](http://www.ti.com/ble-stack) **first**, and if
+necessary [buy an evaluation kit](http://www.ti.com/tool/launchxl-cc2640r2).
 
 If you have any questions please refer to the [FAQ page](docs/faq.md).
+
 For examples for other SDK versions and platforms, see table below.
 
 <table>
@@ -36,7 +37,17 @@ For examples for other SDK versions and platforms, see table below.
     </tr>
     <tr>
       <td>
-        <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-3.20">TI SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67 (current)</a>
+	<a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_cc2640r2_sdk-3.30">TI SimpleLink CC2640R2 SDK 3.30.00.20 (current)</a>
+      </td>
+      <td>
+        <ul>
+          <li><a href="#simple-serial-socket">Simple Serial Socket</a></li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-3.20">TI SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67</a>
       </td>
       <td>
         <ul>
@@ -100,11 +111,11 @@ For examples for other SDK versions and platforms, see table below.
       </td>
       <td>
         <ul>
-          <li>Simple Serial Socket</li>
-          <li>Micro BLE Stack Broadcaster Observer</li>
-          <li>Bidirectional Audio</li>
-          <li>Simple Peripheral Observer</li>
-          <li>Apple Notification Center Service</li>
+          <li><a href="#simple-serial-socket">Simple Serial Socket</a></li>
+          <li><a href="#micro-ble-stack-broadcaster-observer">Micro BLE Stack Broadcaster Observer</li>
+          <li><a href="#bidirectional-audio">Bidirectional Audio</li>
+          <li><a href="#simple-peripheral-observer">Simple Peripheral Observer</li>
+          <li><a href="#apple-notification-center-service">Apple Notification Center Service</li>
         </ul>
       </td>
     </tr>
@@ -201,25 +212,37 @@ Older releases can be accessed by checking out/downloading their corresponding
 branch. For more information on supported examples
 please consult the readme.md of the desired branch/release.
 
+For for more information about different SDK components, please consult the
+BLE-stack User's Guide.
+
 ## Change Log
 
 Note: The version numbers below are related to GitHub ble_examples releases.
 The numbering scheme is in the form of M.mm.pp.bb. The fields pp.bb are incremented
 as GitHub examples are released, M.mm will map a GitHub release to a SimpleLink
 SDK release.
 
+### 3.30.00.00
+Initial offering of select SimpleLink CC2640R2 SDK 3.30.00.20 examples.
+
 ### 3.20.00.00
-Initial offering of SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67 examples, 
-supporting the rev. E of the SimpleLinkCC26x2 and CC13x2 MCUs.
+Initial offering of SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67 examples supporting 
+the rev. E of the SimpleLinkCC26x2 and CC13x2 MCUs.
 
 ### 2.40.00.00
 Initial offering of SimpleLink CC13x2 / CC26x2 SDK 2.40.00.81 examples.
 
+### 2.20.00.00
+New examples added.
+* BLE-Stack:  Simple Serial Socket Server/Client added
+
+**SPP over BLE is now deprecated and replaced by Simple Serial Socket**
+
 ## Installation
 
 This repository can be cloned and tracked using Git. For instructions on how to
-clone a repository from GitHub please refer to this guide:
-[Clone from GitHub](https://help.github.com/articles/cloning-a-repository/)
+clone a repository from Github please refer to this guide:
+[Clone from Github](https://help.github.com/articles/cloning-a-repository/)
 
 For users who are unfamiliar with Git, there is the option of downloading the
 contents of the repository as a zip file. See instructions below.
@@ -229,20 +252,23 @@ contents of the repository as a zip file. See instructions below.
 1. Zip folder will appear in your Downloads folder
 
 This repository can be cloned/download anywhere on your computer. There is a
-dependency between this repository and the SimpleLink CC26x2 SDK install
+dependency between this repository and the SimpleLink CC2640R2 SDK install
 location.
 
-By default the SimpleLink CC13x2 / CC26x2 SDK will install to ``C:\ti\``
+By default the SimpleLink CC2640R2 SDK will install to:
+
+    C:\ti\simplelink_cc2640r2_sdk_2_20_00_49
 
-If the SimpleLink CC13x2 / CC26x2 SDK must be installed to a different location, 
-then see the [FAQ page](docs/faq.md) for IDE specific instructions for changing
+If the Simplelink CC2640R2 SDK must be installed to a different location, then
+see the [FAQ page](docs/faq.md) for IDE specific instructions for changing
 environment variables.
 
 ## Required Tools
 
-Similar to the SimpleLink CC13x2 / CC26x2 SDK, the examples in this repository 
-support the CCS and IAR toolchains. Please pay careful attention to versions of 
-these tools, please refer to the release notes for supported versions.
+Similar to the Simplelink CC2640R2 SDK, the examples in this repository support
+the CCS and IAR toolchains. Please refer to the release notes for the supported
+versions of each toolcahin. Using a non supported version is
+untested and may result in unexpected behavior.
 
 For more information on toolchain setup, please refer to our
 [FAQ page](docs/faq.md).
@@ -264,69 +290,26 @@ socket over BLE implementation.
 
 **Note: this example replaces the SPP over BLE example**
 
-#### For CC1352R
-
-* Simple Serial Socket Client
-    * [Documentation](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_client/readme.md)
-    * [IAR Project Files](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_client/tirtos/iar)
-    * [CCS Project Files](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_client/tirtos/ccs)
-    * [Source](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_client/src)
-* Simple Serial Socket Server
-    * [Documentation](examples/rtosCC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_server/readme.md)
-    * [IAR Project Files](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_server/tirtos/iar)
-    * [CCS Project Files](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_server/tirtos/ccs)
-    * [Source](examples/rtos/CC1352R1_LAUNCHXL/ble5apps/simple_serial_socket_server/src)
-
-#### For CC26x2R
-
 * Simple Serial Socket Client
-    * [Documentation](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_client/readme.md)
-    * [IAR Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_client/tirtos/iar)
-    * [CCS Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_client/tirtos/ccs)
-    * [Source](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_client/src)
+    * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/readme.md)
+    * [IAR Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/tirtos/iar)
+    * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/tirtos/ccs)
+    * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/src)
 * Simple Serial Socket Server
-    * [Documentation](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_server/readme.md)
-    * [IAR Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_server/tirtos/iar)
-    * [CCS Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_server/tirtos/ccs)
-    * [Source](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/simple_serial_socket_server/src)
-
-### Bluetooth 5 Throughput Demo
-
-Showcase a high (near theoretical max) data throughput over Bluetooth 5. The demo
-can be run with two CC26x2 Launchpads, or one CC26x2 Launchpad and one smartphone
-with the Simplelink Starter app.
-
-* throughput\_peripheral
-    * [Documentation](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_peripheral/readme.md)
-    * [CCS Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_peripheral/tirtos/ccs)
-    * [Source](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_peripheral/src)
-* throughput\_central
-    * [Documentation](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_central/readme.md)
-    * [CCS Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_central/tirtos/ccs)
-    * [Source](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/throughput_central/src)
-
-### Tree Structure Network
-
-Set up a tree structure network using tiers of star network. This network format 
-can be used to set up a network with up to 47 devices. The same application is used 
-for the founding node (grandpa node), the middle nodes (father nodes) and the 
-children nodes.
-
-* tree_structure_network
-    * [Documentation](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/tree_structure_network/readme.md)
-    * [CCS Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/tree_structure_network/tirtos/ccs)
-    * [IAR Project Files](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/tree_structure_network/tirtos/iar)
-    * [Source](examples/rtos/CC26X2R1_LAUNCHXL/ble5apps/tree_structure_network/src)
+    * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/readme.md)
+    * [IAR Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/tirtos/iar)
+    * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/tirtos/ccs)
+    * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/src)
 
 ## References
 
 The following reference pages may be helpful during general Bluetooth Low
-Energy development. New users of the SimpleLink CC26x2 platform and Bluetooth
-5 development are encouraged to read the
-[BLE5-Stack User's Guide](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC13x2%2026x2%20SDK%2FDocuments%2FBLE5-Stack%2FBLE5-Stack%20User's%20Guide).
+Energy development.
+Users developing Bluetooth applications are encouraged to read the
+[BLE-Stack User's Guide](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FDocuments%2FBLE-Stack%2FBLE-Stack%20User's%20Guide).
 
 As an additional resource, users are encouraged to complete the
-[SimpleLink Academy](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC13x2%2026x2%20SDK%2FSimpleLink%20Academy)
+[SimpleLink Academy](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FSimpleLink%20Academy)
 training.
 
 Other resources can be found below:
 
@@ -1,20 +1,31 @@
 ## Frequently Asked Questions
 
-* [What if I installed the SimpleLink CC13X2 / CC26x2 SDK at a non default location (e.g. Not at ``C:\ti\``)?](#what-if-i-installed-the-simplelink-cc13x2-26x2-sdk-at-a-non-default-location-eg-not-at-cti)
-* [How can I setup my toolchain for use with the ble\_examples repo?](#how-can-i-setup-my-toolchain-for-use-with-the-ble_examples-repo)
-* [I am using a LaunchPad device, how can I view display data?](#i-am-using-a-launchpad-device-how-can-i-view-display-data)
+* [What if I installed the SimpleLink CC2640R2 SDK at a non default location (i.e. not at ``C:\ti\simplelink_cc2640r2_sdk_3_30_00_20``)?](#default)
+* [Why am I getting an error when I am trying to run a Python script from the /tools folder?](#python)
+* [How can I setup my toolchain for use with the ble\_examples repo?](#toolchain)
+* [I am using a LaunchPad device, how can I view display data?](#display)
 ---
 
-### <a name="default"></a>What if I installed the SimpleLink CC13X2 / CC26x2 SDK at a non default location (e.g. Not at ``C:\ti\``)?
+### <a name="default"></a>What if I installed the SimpleLink CC2640R2 SDK at a non default location (e.g. Not at ``C:\ti\simplelink_cc2640r2_sdk_3_30_00_20``)?
 
 All projects reference files from the BLE stack using environment variables, you
-can change this in your IDE's project files. 
+can change this in your IDE's project files.
 
-Alternatively, you can make a symlink in the default location pointing to your 
-custom location. E.g., if you have cloned this repo to ``C:\git\`` you can use 
-the following command:
+**CCS**
+
+No changes to the project is necessary. You just need to ensure that Code
+Composer Studio was able to discover the SimpleLink CC2640R2 SDK in the
+available *RTSC Products* tab. See the
+[BLE-Stack User's Guide](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FDocuments%2FBLE-Stack%2FBLE-Stack%20User's%20Guide)
+for more details.
+
+
+**IAR**
 
-``mklink /d ble_examples-simplelink_cc13x2_26x2_sdk-3.20 C:\git\ble_examples``
+1. Navigate to the sample project directory within the repo and open the
+   `.custom_argvars` file.
+1. Update the value of ``SIMPLELINK_CORE_SDK_INSTALL_DIR`` to point to your
+   custom installation directory where you installed the SimpleLink CC2640R2 SDK.
 
 ---
 ### <a name="versioning"></a>How should I keep my application based on a TI BLE-Stack SDK under version control?
@@ -27,33 +38,48 @@ You can read more here: [Version Control](suggested_workflow.md)
 
 ---
 
+### <a name="python"></a>Why am I getting an error when I am trying to run a Python script from the /tools folder?
+
+Likely your Python environment is not installed correctly. Please check the
+following debug steps:
+
+1. All scripts in the tools folder use Python 2.7, ensure that you have this
+   version installed to `C:\Python27`
+1. Python scripts can be invoked using `python <script_name>.py` this requires
+   adding Python to your environment variables.
+   * Add ``C:\Python27`` to the `PATH` variable within your Windows environment
+     variables, see
+     [windows env vars](https://www.java.com/en/download/help/path.xml) for more
+     info.
+1. If you can run the script successfully but get a runtime error, you likely
+   don't have the necessary python modules installed.
+  * Python modules can be found by looking at the `import` statements at the top
+    of the `.py` file. You can install Python modules using the Python package
+    manager, pip.
+  - Install Pip by following
+    [these steps](http://stackoverflow.com/questions/4750806/how-do-i-install-pip-on-windows).
+    The section "Python 2 ≤ 2.7.8 and Python 3 ≤ 3.3" will be most helpful.
+
+---
+
 ### <a name="toolchain"></a>How can I setup my toolchain for use with the ble\_examples repo?
 
 **CCS**
 
-1. Import the project to your CCS workspace
-2. Open Project -> Properties -> General -> Products and select the 3.20.00.68 
-   version of SimpleLink CC13x2 26x2 SDK.
-3. Build and flash the example project.
-
+For BLE-Stack examples, see the *Developing with CCS* section of the
+[BLE-Stack User's Guide](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FDocuments%2FBLE-Stack%2FBLE-Stack%20User's%20Guide).
 **IAR**
 
-1. Open IAR, if there is any active workspace close it.
-2. Open Tools -> Configure Custom Argvars -> Global and make sure no groups are 
-   active (if they are you can disable or delete them with the buttons on the 
-   left side). Import ``ble_examples.custom_argvars`` from ``ble_examples\tools\iar``. 
-3. Close the Configure Custom Argvars view. Open the ``.template.eww`` file with 
-   the Open Workspace option.
-4. When asked to select a folder for the workspace, make sure to select an empty 
-   folder.
-5. Build and flash the example project.
+For BLE-Stack examples, see the *Developing with IAR* section of the
+[BLE-Stack User's Guide](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FDocuments%2FBLE-Stack%2FBLE-Stack%20User's%20Guide).
 
 ---
 
 ### <a name="display"></a>I am using a LaunchPad device, how can I view display data?
+
 LaunchPad projects are already set up to use the tidriver Display. For more
 information about the Display driver please see the Display.h driver
-documentation in the SimpleLink CC13X2 / CC26x2 SDK (`docs/tidrivers/tidriversAPI.html`)
+documentation in the SimpleLink CC2640R2 SDK (`docs/tidrivers/tidriversAPI.html`)
 
 To setup your PC to receive this data please follow the steps below:
 
 
@@ -98,7 +98,7 @@ on what files should be modified by the developer, and how to best do so.
 The TI SimpleLink SDK should be treated as a Read Only (RO) dependency that is
 required to build the customer application. At the start of a development cycle,
 the developer should start with a given TI SimpleLink SDK and based on the
-guidance in the protocol stack user guide (i.e. ble5stack-users-guide) select a
+guidance in the protocol stack user guide (i.e. blestack-users-guide) select a
 sample application from the SDK as a base for their development.
 
 At this time the customer should copy the **application software** and **board**
@@ -178,8 +178,8 @@ merge their changes with those from the latest SimpleLink SDK release.
 
 *This is a critical step as there may have been useful bug-fixes or changes in
 the files that improve performance* The customer should evaluate these changes
-and determine whether or not to incorporate them into their code base.
-(manual step)
+and determine whether or not to incorporate them into their code base (manual 
+step).
 
 ### Workspace concepts