rajarajan elango / Mbed OS mbed-os-example-ble-Thermometer

Tested and connected with nRF Control panel in android device

readme.md@81:921892507e54, 2019-09-19 (annotated)

Committer:
mbed_official
Date:
Thu Sep 19 18:01:32 2019 +0100
Revision:
81:921892507e54
Parent:
71:0a748641901e 
Merge pull request #249 from apalmieriGH/master



Update readme for BLE_HeartRate and BLE_Thermometer

.

Commit copied from https://github.com/ARMmbed/mbed-os-example-ble

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 2:cc8349878a7d 1 # Thermometer
mbed_official 2:cc8349878a7d 2
mbed_official 2:cc8349878a7d 3 This example uses the [Health Thermometer Profile](https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.health_thermometer.xml) to send thermometer information:
mbed_official 2:cc8349878a7d 4
mbed_official 2:cc8349878a7d 5 1. Sensor location: thermometer placement on the body. The default value in this application is the ear (``LOCATION_EAR``). The [characteristic description](https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_type.xml) shows the other possible values.
mbed_official 2:cc8349878a7d 6
mbed_official 2:cc8349878a7d 7 1. Temperature: the initial temperature is 39.6, and it's incremented by 0.1 every half second. It resets to 39.6 when it reaches 43.0.
mbed_official 2:cc8349878a7d 8
mbed_official 2:cc8349878a7d 9 For more information see:
mbed_official 2:cc8349878a7d 10
mbed_official 71:0a748641901e 11 * [Health Thermometer Service](https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.health_thermometer.xml): GATT profile details.
mbed_official 2:cc8349878a7d 12
mbed_official 2:cc8349878a7d 13 * [Temperature Measurement](https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_measurement.xml): GATT characteristic details for temperature measurement.
mbed_official 2:cc8349878a7d 14
mbed_official 2:cc8349878a7d 15 * [Temperature Type](https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_type.xml): GATT characteristic details for temperature type (sensor location).
mbed_official 2:cc8349878a7d 16
mbed_official 2:cc8349878a7d 17 # Running the application
mbed_official 2:cc8349878a7d 18
mbed_official 2:cc8349878a7d 19 ## Requirements
mbed_official 2:cc8349878a7d 20
mbed_official 81:921892507e54 21 The sample application can be seen on any BLE scanner on a smartphone. If you don't have a scanner on your phone, please install the BLE Profiles App by ST:
mbed_official 81:921892507e54 22
mbed_official 81:921892507e54 23 - [ST BLE Profile](https://play.google.com/store/apps/details?id=com.stm.bluetoothlevalidation) for Android.
mbed_official 81:921892507e54 24
mbed_official 81:921892507e54 25 Alternatively, you can install:
mbed_official 2:cc8349878a7d 26
mbed_official 2:cc8349878a7d 27 - [nRF Master Control Panel](https://play.google.com/store/apps/details?id=no.nordicsemi.android.mcp) for Android.
mbed_official 2:cc8349878a7d 28
mbed_official 2:cc8349878a7d 29 - [LightBlue](https://itunes.apple.com/gb/app/lightblue-bluetooth-low-energy/id557428110?mt=8) for iPhone.
mbed_official 2:cc8349878a7d 30
mbed_official 2:cc8349878a7d 31 Hardware requirements are in the [main readme](https://github.com/ARMmbed/mbed-os-example-ble/blob/master/README.md).
mbed_official 2:cc8349878a7d 32
mbed_official 2:cc8349878a7d 33 ## Building instructions
mbed_official 2:cc8349878a7d 34
mbed_official 2:cc8349878a7d 35 Building instructions for all mbed OS samples are in the [main readme](https://github.com/ARMmbed/mbed-os-example-ble/blob/master/README.md).
mbed_official 2:cc8349878a7d 36
mbed_official 2:cc8349878a7d 37 ## Checking for success
mbed_official 2:cc8349878a7d 38
mbed_official 81:921892507e54 39 **Note:** Screens captures depicted below show what is expected from this example if the scanner used is *ST BLE Profile* version 2.0.0 or *nRF Master Control Panel* version 4.0.5. If you encounter any difficulties consider trying another scanner or another version of nRF Master Control Panel. Alternative scanners may require reference to their manuals.
mbed_official 2:cc8349878a7d 40
mbed_official 2:cc8349878a7d 41 1. Build the application and install it on your board as explained in the building instructions.
mbed_official 2:cc8349878a7d 42
mbed_official 2:cc8349878a7d 43 1. Open the BLE scanner on your phone.
mbed_official 2:cc8349878a7d 44
mbed_official 2:cc8349878a7d 45 1. Start a scan.
mbed_official 2:cc8349878a7d 46
mbed_official 81:921892507e54 47 ![](img/start_scan_ble_profile.png)
mbed_official 81:921892507e54 48
mbed_official 81:921892507e54 49 **figure 1.a** How to start scan using ST BLE Profile 2.0.0
mbed_official 81:921892507e54 50
mbed_official 2:cc8349878a7d 51 ![](img/start_scan.png)
mbed_official 2:cc8349878a7d 52
mbed_official 81:921892507e54 53 **figure 1.b** How to start scan using nRF Master Control Panel 4.0.5
mbed_official 81:921892507e54 54
mbed_official 81:921892507e54 55 1. Find your device; it should be named *Therm
mbed_official 2:cc8349878a7d 56
mbed_official 81:921892507e54 57 ![](img/scan_results_ble_profile.png)
mbed_official 81:921892507e54 58
mbed_official 81:921892507e54 59 **figure 2.a** Scan results using ST BLE Profile 2.0.0
mbed_official 2:cc8349878a7d 60
mbed_official 2:cc8349878a7d 61 ![](img/scan_results.png)
mbed_official 2:cc8349878a7d 62
mbed_official 81:921892507e54 63 **figure 2.b** Scan results using nRF Master Control Panel 4.0.5
mbed_official 2:cc8349878a7d 64
mbed_official 2:cc8349878a7d 65 1. Establish a connection with your device.
mbed_official 2:cc8349878a7d 66
mbed_official 81:921892507e54 67 ![](img/connection_ble_profile.png)
mbed_official 81:921892507e54 68
mbed_official 81:921892507e54 69 **figure 3.a** How to establish a connection using ST BLE Profile 2.0.0
mbed_official 81:921892507e54 70
mbed_official 2:cc8349878a7d 71 ![](img/connection.png)
mbed_official 2:cc8349878a7d 72
mbed_official 81:921892507e54 73 **figure 3.b** How to establish a connection using Master Control Panel 4.0.5
mbed_official 2:cc8349878a7d 74
mbed_official 2:cc8349878a7d 75
mbed_official 2:cc8349878a7d 76 1. Discover the services and the characteristics on the device. The *Health Thermometer* service has the UUID `0x1809` and includes the *Temperature Measurement* characteristic which has the UUID `0x2A1C`.
mbed_official 2:cc8349878a7d 77
mbed_official 81:921892507e54 78 ![](img/discovery_ble_profile.png)
mbed_official 81:921892507e54 79
mbed_official 81:921892507e54 80 **figure 4.a** Representation of the Heart Rate service using ST BLE Profile 2.0.0
mbed_official 81:921892507e54 81
mbed_official 2:cc8349878a7d 82 ![](img/discovery.png)
mbed_official 2:cc8349878a7d 83
mbed_official 81:921892507e54 84 **figure 4.b** Representation of the Heart Rate service using Master Control Panel 4.0.5
mbed_official 2:cc8349878a7d 85
mbed_official 2:cc8349878a7d 86
mbed_official 2:cc8349878a7d 87 1. Register for the notifications sent by the *Temperature Measurement* characteristic.
mbed_official 2:cc8349878a7d 88
mbed_official 81:921892507e54 89 ![](img/register_to_notifications_ble_profile.png)
mbed_official 81:921892507e54 90
mbed_official 81:921892507e54 91 **figure 5.a** How to register to notifications using ST BLE Profile 2.0.0
mbed_official 81:921892507e54 92
mbed_official 2:cc8349878a7d 93 ![](img/register_to_notifications.png)
mbed_official 2:cc8349878a7d 94
mbed_official 81:921892507e54 95 **figure 5.b** How to register to notifications using Master Control Panel 4.0.5
mbed_official 2:cc8349878a7d 96
mbed_official 2:cc8349878a7d 97
mbed_official 81:921892507e54 98 1. You should see the temperature value change every two seconds (ST BLE Profile) or every half second (Master Control Panel).<br/>For ST BLE Profile, it begins at 36.0, goes up to 43.0 (in steps of 1), resets to 36.0 and so on.
mbed_official 81:921892507e54 99
mbed_official 81:921892507e54 100 ![](img/notifications_ble_profile.png)
mbed_official 81:921892507e54 101
mbed_official 81:921892507e54 102 **figure 6.a** Notifications view using ST BLE Profile 2.0.0
mbed_official 81:921892507e54 103
mbed_official 81:921892507e54 104 For Master Control Panel, it begins at 39.6, goes up to 43.0 (in steps of 0.1), resets to 39.6 and so on.
mbed_official 2:cc8349878a7d 105
mbed_official 2:cc8349878a7d 106 ![](img/notifications.png)
mbed_official 2:cc8349878a7d 107
mbed_official 81:921892507e54 108 **figure 6.b** Notifications view using Master Control Panel 4.0.5
mbed_official 2:cc8349878a7d 109
mbed_official 2:cc8349878a7d 110