Merge pull request #101 in SA/ble_examples from simplelink_cc2640r2_sdk-3.40 to master

Squashed commit of the following:

commit 056246a
Author: Marie Hernes <[email protected]>
Date:   Thu Apr 30 01:55:37 2020 -0500

    Merge pull request #100 in SA/ble_examples from feature/LPRFAPPS-1068-Port-Blood-Pressure-example-to-CC2640R2 to simplelink_cc2640r2_sdk-3.40

    Squashed commit of the following:

    commit 82a36392ed1e0cfe6dcfa83ddf823c6c1f53dc49
    Author: Marie Hernes <[email protected]>
    Date:   Thu Apr 30 08:54:24 2020 +0200

        Remove release information, clarify readme file.

    commit 18c529fba2fbba6948520325898e577102f30d89
    Author: Marie Hernes <[email protected]>
    Date:   Wed Apr 29 09:20:35 2020 +0200

        Add BP on main age.

    commit 7352c9e74b5a8dd8682c6738761290c58fb911c8
    Author: Marie Hernes <[email protected]>
    Date:   Mon Mar 9 14:18:09 2020 +0100

        version sent to testing.

    commit fe2e35ff26f64c882525717f8e78d44299aeb457
    Author: Marie Hernes <[email protected]>
    Date:   Mon Mar 9 13:11:45 2020 +0100

        Pairing and bonding works.

    commit 8227f616fb169c3e6db5844b5969dcaf6e7e7737
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 24 14:41:20 2020 +0100

        Update how the example is supposed to work.

    commit faccbf8a081e72424d6c2ab1ced1cbb5997f6716
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 10 12:46:01 2020 +0100

        Print out BP flags.

    commit 7fc0680a3de183616f22cc49b8afdbb4b0d27c6b
    Author: Marie Hernes <[email protected]>
    Date:   Fri Feb 7 14:33:26 2020 +0100

        Toggle LED with GPIO driver.

    commit 7a30a3e9761da4dfa744668756dfdde9b602a77e
    Author: Marie Hernes <[email protected]>
    Date:   Fri Feb 7 13:50:41 2020 +0100

        Project builds in CCS.

    commit b227e4607981d3f45d4736d3f0147f70ce5e190f
    Author: Marie Hernes <[email protected]>
    Date:   Wed Feb 5 08:51:14 2020 +0100

        Project imports to ccs without warning.

commit d09a25c
Author: Marie Hernes <[email protected]>
Date:   Wed Feb 5 01:22:30 2020 -0600

    Merge pull request #99 in SA/ble_examples from feature/move-simplelink_cc2640r2-to-3.40 to simplelink_cc2640r2_sdk-3.40

    Squashed commit of the following:

    commit b7a065d12d5f2a8242af7209066df5480e25a00d
    Author: Marie Hernes <[email protected]>
    Date:   Wed Feb 5 08:22:07 2020 +0100

        Max comments.

    commit 9877cc44006e3c7937643ebeb2eff69c9b8934a5
    Author: Marie Hernes <[email protected]>
    Date:   Tue Feb 4 10:42:28 2020 +0100

        Comments from Clement.

    commit 21383a0811be7fe86606933efbf63383bcd72eed
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 15:05:12 2020 +0100

        Spelling error.

    commit ec2b707d687f40de2aab3d59801d1a7fae9e0615
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 14:55:42 2020 +0100

        Documentation changes.

    commit fb53e6aa204032f1bcad9fafd5b71e58c04ef11c
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 14:50:48 2020 +0100

        IAr simple peripheral observer runs.

    commit 292e1ef642946dee47ff4963c8000e6299a40538
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 14:44:39 2020 +0100

        Added simple peripheral observer.

    commit 845fcb37c1ef3f3cd98ed1e3235cb48fe03c6712
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 14:10:41 2020 +0100

        SSSS in IAR builds and runs.

    commit db75449290795944c39f118af43ef2f579f3e73e
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 13:15:53 2020 +0100

        IAR version of SSSS builds.

    commit e2cb168a0f44d9f478582b689191d1db0a1e7053
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 13:01:34 2020 +0100

        First attempt IAR, does not run properly.

    commit e0391e0a07b8d61e1156e7be9f36d8c04cd7ff6f
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 11:12:40 2020 +0100

        CCS version of SSSS and SSSC for BLE3 builds and runs.

    commit 791a2942466b19af62105a0da90dab5c8e2483a5
    Author: Marie Hernes <[email protected]>
    Date:   Mon Feb 3 10:38:03 2020 +0100

        ble5 ssss and sssc build and work as expected.

commit 33b207f
Author: Clement Chaduc <[email protected]>
Date:   Tue Jan 21 02:53:50 2020 -0600

    Merge pull request #98 in SA/ble_examples from feature/simplelink_cc2640r2_sdk-3.30_LPRFAPPS-1052_simple_serial_socket_ble5 to simplelink_cc2640r2_sdk-3.30

    Squashed commit of the following:

    commit 4e3be82593e25aba0faed329199a7b1f77cc65cb
    Author: Clement Chaduc <[email protected]>
    Date:   Tue Jan 21 09:51:17 2020 +0100

        Documentation update

    commit e8124209aacbf8a6aa50098de8c7a9c630f4af3d
    Author: Clement Chaduc <[email protected]>
    Date:   Tue Jan 21 09:10:24 2020 +0100

        Modification to allow PTM and RCOSC configuration to build

    commit d28990a08f952e0c41eafcf80a566bb9e93ee826
    Author: Clement Chaduc <[email protected]>
    Date:   Mon Jan 20 14:54:04 2020 +0100

        Documentation improvements about baudrate modification

    commit 49f3d4a31fe7b9b7781a46f8861a4d03d78d03f3
    Author: Clement Chaduc <[email protected]>
    Date:   Mon Jan 20 14:33:15 2020 +0100

        Add a troubleshooting section to the readme

    commit 2b4256ef1432247f609681554d99e42dae146d7e
    Author: Clement Chaduc <[email protected]>
    Date:   Mon Jan 20 13:22:43 2020 +0100

        Modification due to PR remarks (2)

    commit d162bd9f2095d5bec7e0f894986683180d0940ab
    Author: Clement Chaduc <[email protected]>
    Date:   Fri Jan 17 16:15:52 2020 +0100

        First part of the modification asked in the PR comments

    commit 8fbfe02f3412de78ccb75e5aa80be35bae728889
    Author: Clement Chaduc <[email protected]>
    Date:   Mon Jan 13 12:49:12 2020 +0100

        Removing duplicated file

    commit 71be7c8a3aea07e7f56b1a47a8238d3acd156558
    Author: Clement Chaduc <[email protected]>
    Date:   Fri Jan 10 15:03:04 2020 +0100

        Update / adapt readme files for CC2640R2

    commit 545966a6ef498df5ed82256a42dc3e8bae7e2aa1
    Author: Clement Chaduc <[email protected]>
    Date:   Fri Jan 10 14:54:08 2020 +0100

        Update copyrights

    commit 1aa75ae434cd016bec7cd1cbf4acc3780c143dbe
    Author: Clement Chaduc <[email protected]>
    Date:   Thu Jan 9 13:43:48 2020 +0100

        Initial commit - The projects can be imported, compiled and linked by CCS

Author: gunnsdatter

README.md

@@ -8,15 +8,16 @@
 * [Tools](#tools)
 * [References](#references)
 * [FAQ](docs/faq.md)
-* [Versioning BLE-Stack Projects](docs/suggested_workflow.md)
+* [Suggested Work Flow](docs/suggested_workflow.md)
 
 # Introduction
 
-These examples and demos are for **TI SimpleLink CC2640R2 SDK 3.30.00.20**
+These examples and demos are for **TI SimpleLink CC2640R2 SDK 3.40.00.10**
 
 This repository contains *Bluetooth®* Low Energy sample applications for
 Texas Instruments' SimpleLink CC2640R2 SDK. These examples have not been
-validated as production-ready.
+validated as production-ready. Services and profiles in this repository have not 
+been validated or certified.
 
 **Do not** use GitHub's bug tracking feature for support. For inquiries, see the
 [Bluetooth® low energy Forum](https://e2e.ti.com/support/wireless_connectivity/bluetooth_low_energy/f/538).
@@ -37,11 +38,25 @@ 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_cc2640r2_sdk-3.30">TI SimpleLink CC2640R2 SDK 3.30.00.20 (current)</a>
+  <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_cc2640r2_sdk-3.40">TI SimpleLink CC2640R2 SDK 3.40.00.10 (current)</a>
       </td>
       <td>
         <ul>
           <li><a href="#simple-serial-socket">Simple Serial Socket</a></li>
+          <li><a href="#simple-serial-socket">Bluetooth 5 Simple Serial Socket</li>
+          <li><a href="#simple-peripheral-observer">Simple Peripheral Observer</li>
+          <li><a href="#blood-pressure-monitor">Blood Pressure Monitor</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>
+	<a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_cc2640r2_sdk-3.30">TI SimpleLink CC2640R2 SDK 3.30.00.20</a>
+      </td>
+      <td>
+        <ul>
+          <li>Simple Serial Socket</a></li>
+          <li>Bluetooth 5 Simple Serial Socket</li>
         </ul>
       </td>
     </tr>
@@ -222,6 +237,13 @@ The numbering scheme is in the form of M.mm.pp.bb. The fields pp.bb are incremen
 as GitHub examples are released, M.mm will map a GitHub release to a SimpleLink
 SDK release.
 
+### 3.40.00.00
+Initial offering of select SimpleLink CC2640R2 SDK 3.40.00.10 examples and one 
+new example added:
+* Blood Pressure Monitor: This sample project implements the Blood Pressure 
+  profiles in a Bluetooth Low Energy peripheral device to provide an example 
+  blood pressure monitor (BPM) using simulated measurement data.
+
 ### 3.30.00.00
 Initial offering of select SimpleLink CC2640R2 SDK 3.30.00.20 examples.
 
@@ -257,15 +279,15 @@ location.
 
 By default the SimpleLink CC2640R2 SDK will install to:
 
-    C:\ti\simplelink_cc2640r2_sdk_2_20_00_49
+    C:\ti\simplelink_cc2640r2_sdk_x_xx_xx_xx
 
-If the Simplelink CC2640R2 SDK must be installed to a different location, then
+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 CC2640R2 SDK, the examples in this repository support
+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.
@@ -291,15 +313,49 @@ socket over BLE implementation.
 **Note: this example replaces the SPP over BLE example**
 
 * Simple Serial Socket Client
-    * [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)
+    * BLE 4.2
+      * [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)
+    * BLE 5.0
+      * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_client/readme.md)
+      * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_client/tirtos/ccs)
+      * [Source](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_client/src)
 * Simple Serial Socket Server
-    * [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)
+    * BLE 4.2
+      * [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)
+    * BLE 5.0
+      * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_server/readme.md)
+      * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_server/tirtos/ccs)
+      * [Source](examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_server/src)
+
+### Simple Peripheral Observer
+
+This sample project is used to add observer role to a BLE peripheral device to
+show scanning functionality in a peripheral based project.
+
+* simple\_peripheral\_observer
+    * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_peripheral_observer/readme.md)
+    * [IAR Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_peripheral_observer/tirtos/iar)
+    * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_peripheral_observer/tirtos/ccs)
+    * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_peripheral_observer/src)
+
+### Blood Pressure Monitor
+
+This sample project implements the Blood Pressure profiles in a Bluetooth low 
+energy peripheral device to provide an example blood pressure monitor (BPM) 
+using simulated measurement data. The application implements the Sensor role of 
+the blood pressure profile. The project is based on the adopted profile and 
+service specifications for blood pressure.
+
+* blood\_pressure
+    * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/blood_pressure/readme.md)
+    * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/blood_pressure/tirtos/ccs)
+    * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/blood_pressure/src)
 
 ## References
 

docs/faq.md

@@ -1,12 +1,12 @@
 ## Frequently Asked Questions
 
-* [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)
+* [What if I installed the SimpleLink CC2640R2 SDK at a non default location (i.e. not at ``C:\ti\simplelink_cc2640r2_sdk_x_xx_xx_xx``)?](#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 CC2640R2 SDK at a non default location (e.g. Not at ``C:\ti\simplelink_cc2640r2_sdk_3_30_00_20``)?
+### <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_x_xx_xx_xx``)?
 
 All projects reference files from the BLE stack using environment variables, you
 can change this in your IDE's project files.

examples/rtos/CC2640R2_LAUNCHXL/ble5apps/simple_serial_socket_client/readme.md

@@ -0,0 +1,158 @@
+
+Purpose / Scope
+===============
+
+This purpose of this example is to demonstrate a simple serial socket using
+TI's Simple Stream Server profile. The example showcases a simple UART over
+BLE implementation. The project is designed to allow the actual data sink and
+source to be easily exchanged for the purpose of creating a generic simple
+stream application.
+
+Prerequisites
+=============
+
+#### Hardware Requirements
+
+Before running the demo, the user will need the following components:
+
+- 2x [CC2640R2 Launchpad](http://www.ti.com/tool/LAUNCHXL-CC2640R2)
+- 2x Micro USB cable
+
+#### Firmware Requirements
+
+- [CC2640R2 SDK](http://www.ti.com/tool/SIMPLELINK-CC2640R2-SDK)
+
+Simple Stream Server Service
+============================
+
+The simple stream service is made to implement a bi-directional data stream
+connection over the BLE protocol. The service uses a 128 bit UUID:
+F000C0C0-0451-4000-B000-00000000-0000. simple stream server service contains
+two characteristics, they are listed below.
+
+| Characteristic    | UUID                                      |
+|:-----------------:|:-----------------------------------------:|
+|DataIn             | F000C0C1-0451-4000-B000-00000000-0000     |
+|DataOut            | F000C0C2-0451-4000-B000-00000000-0000     |
+
+The `DataIn` characteristic implies data coming from client to server while
+`DataOut` is data outgoing from server to client.
+
+For more information on the service, see the Simple Serial Socket Server example readme.
+
+Simple Stream Client Profile
+============================
+
+The simple stream client profile provides an easy to use interface for
+interaction with a connected Simple Stream Server peripheral. The simple stream
+client profile is similar to the simple stream server service. Following a
+connection, the service table provided by the profile has to be populated with
+service handles before any data can be sent from the client to the server.
+
+The service table can be easily populated by utilizing the simple service
+discovery API available in the example. To see how this API is used during the
+discovery process, refer to the `SimpleSerialSocketClient_processGATTDiscEvent`
+function found inside `simple_serial_socket_client`.
+
+The profile provided APIs:
+\* SimpleStreamClient_sendData(uint16_t connHandle, void *data, uint16_t len)
+\* SimpleStreamClient_processStream()
+\* SimpleStreamClient_disconnectStream()
+\* SimpleStreamClient_enableNotifications(uint16_t connHandle)
+
+The Simple Serial Client keeps an internal FIFO list for data sent to the
+profile using `SimpleStreamClient_sendData()`. When new data is sent to the
+profile, the internal queue will be processed and as much data as possible
+will be sent to the server using write commands (no-respond).
+
+> Note: The Simple Serial Client profile relies on dynamic memory allocated and
+> will use the application ICall heap to store the queued data.
+
+If the profile is unable to send all data inside the current connection event,
+`SimpleStreamClient_processStream()` can be called in application space to
+process the internal queue again at another time.
+
+If the client disconnects from the server, the internal queue can be flushed
+by calling `SimpleStreamClient_disconnectStream()`.
+
+To receive incoming data, the client has to enable notifications. To do this,
+the `SimpleStreamClient_enableNotifications()` API can be used to enable
+notifications given the connection handle.
+
+Running the Demo
+================
+
+Running the demo is as simple and compiling and loading the code, then hooking
+up to your PC to send a receive data over UART. Please see the steps below:
+
+1. Compile and load the code
+ - Build and load LaunchPad #1 with the `simple_serial_socket_client` project
+ - Build and load LaunchPad #2 with the `simple_serial_socket_server` project
+
+2. Connect the boards to the PC terminal
+ - You can use the terminal to send data from your PC to the LaunchPad, and
+ also display the info sent from one device to another.
+ - You will need to open two instances of the terminal program, one to
+ communicate with each board.
+ - Follow the steps from our [FAQ](faq.md) to connect to the LaunchPad boards
+ - **Please note that the Simple Serial Socket project uses the default baud
+ rate of 115200**
+
+3. Power the boards individually and verify they are initialized
+ - The client will auto connect to the server by looking for an advertisement
+   containing the SSS service together with a matching manufacturer ID. The
+   manufacturer ID can be changed in both projects to allow for multiple
+   devices to run  alongside each other.
+ - Upon connecting the client and server will light the red LED. When
+   notifications has been enabled and the stream is ready for use, the green
+   LED will also be lit.
+ - At this point you can type into either terminal window and watch it being
+   echoed to the other terminal via BLE. The example has been tested using
+   PuTTY and CCS's terminal.
+
+   ![Simple Serial Socket](resources/terminal_client_server.png)
+
+4. Trouble shooting: 
+ - Verify that the RXD and TXD jumpers of each boosterpack are set correctly
+ - Try using a different terminal
+ - Verify you are using the right serial ports (see [FAQ](faq.md))
+ - Try not using an USB hub
+
+Improving UART performance for large data transfers
+===================================================
+
+#### Buffers size
+
+The default board file configures the size of the internal UART ring buffer to
+32 bytes. If the amount of data sent over UART to the device exceeds
+UART_MAX_READ_SIZE plus the size of the ring buffer, data loss is probable.
+This is due to the internal UART ring buffer wrapping before the application
+has the chance to process the previous UART buffer. To be able to handle
+larger chunks of data, the size of the ring buffer can be increased inside the
+board file.
+
+In order to modify the size of the board file, the `board.c` file found inside
+the `Startup`  folder need to be replaced with copies of the actual board
+files. This can be done by performing the following steps:
+
+- Remove the `board.c` file found inside the `Startup` folder.
+- Copy the following files from `<SDK DIR>/source/ti/ble5stack/boards/CC2640R2_LAUNCHXL` directory into the projects `Startup` folder:
+    - Board.h
+    - CC2640R2_LAUNCHXL.h
+    - CC2640R2_LAUNCHXL.c
+    - CC2640R2_LAUNCHXL_fxns.c
+
+The ring buffer size can now be changed by resizing the uartCC26XXRingBuffer
+array found inside `CC2640R2_LAUNCHXL.c`.
+
+It is also possible to modify the shared `CC2640R2_LAUNCHXL.c` file that
+`board.c` imports directly instead of coping the board files into the project.
+This is however not recommended as changes will propagate to all BLE examples in the SDK
+that depend on the shared file.
+
+#### Baud rate
+As written before, the default baud rate is set to 115200. This value can be
+modified by changing the UART parameters, especially `uartParams.baudRate`.
+The reader’s attention is drawn to the fact that changing the baud rate is
+not the recommended way of increasing throughput. In most of the cases, the
+throughput is actually limited by the BLE throughput.