This application shows how to use GAP to transmit a simple value to disconnected peer listening for advertisement every time that a value is updated. The canonical source for this example lives at: https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_GAPButton

Button count over GAP

This application shows how to use GAP to transmit a simple value to disconnected peer listening for advertisement every time that a value is updated:

  • The value is a count of how many times a button on the device was pressed (the code actually monitors the button's releases, not press downs).
  • We transmit the value in the SERVICE_DATA field of the advertising payload.

Running the application

Requirements

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 :

- nRF Master Control Panel for Android.

- LightBlue for iPhone.

Hardware requirements are in the main readme.

Building instructions

Building with mbed CLI

If you'd like to use mbed CLI to build this, then you should refer to the main readme. The instructions here relate to using the developer.mbed.org Online Compiler

In order to build this example in the mbed Online Compiler, first import the example using the ‘Import’ button on the right hand side.

Next, select a platform to build for. This must either be a platform that supports BLE, for example the NRF51-DK, or one of the following:

List of platforms supporting Bluetooth Low Energy

Or you must also add a piece of hardware and the supporting library that includes a Bluetooth Low Energy driver for that hardware, for example the K64F or NUCLEO_F401RE with the X-NUCLEO-IDB05A1

List of components supporting Bluetooth Low Energy.

Once you have selected your platform, compile the example and drag and drop the resulting binary onto your board.

For general instructions on using the mbed Online Compiler, please see the mbed Handbook

Checking for success

Note: Screens captures depicted below show what is expected from this example if the scanner used is 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.

  • Build the application and install it on your board as explained in the building instructions.
  • Open the BLE scanner on your phone.
  • Start a scan.

https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/raw-file/8f898b781de2/img/start_scan.png

figure 1 How to start scan using nRF Master Control Panel 4.0.5.

  • Find your device; it should be named `GAPButton`; and look at the advertisement broadcasted by your device (there is no need to connect to your device).

https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/raw-file/8f898b781de2/img/discovery.png

figure 2 Scan results using nRF Master Control Panel 4.0.5.

  • The Service Data field of the advertisement packet broadcasted by your device reflects the button press count. The starting value is 0.

https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/raw-file/8f898b781de2/img/initial_state.png

figure 3 Initial state of the button using nRF Master Control Panel 4.0.5.

  • Press the button on the device.

https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/raw-file/8f898b781de2/img/first_press.png

figure 3 State after 1 button press using nRF Master Control Panel 4.0.5.

  • The Service Data field value of the advertisement packet should change every time you press the button.

https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-GAPButton/raw-file/8f898b781de2/img/result.png

figure 3 State after 6 button press using nRF Master Control Panel 4.0.5.

Note

Since broadcasting is not reliable and your phone may scan intermittently, it is possible that your phone will miss button updates.

Changes

RevisionDateWhoCommit message
85:c66873cfddb4 15 months ago mbed_official Merge pull request #268 from trowbridgec/add-ep-agora default tip
84:07091894cd00 17 months ago mbed_official Merge pull request #252 from donatieng/mbed_os_update
83:5f43cd2a93e6 20 months ago mbed_official Merge pull request #230 from LMESTM/NUCLEO_WB55RG_readme
82:1d8560f645a3 22 months ago mbed_official Updating mbed-os to mbed-os-5.11.5
81:a1027ad5aed4 22 months ago mbed_official Merge pull request #217 from adbridge/master
80:4bdf0dd70a52 23 months ago mbed_official Updating mbed-os to mbed-os-5.11.2
79:6460d4c1b03a 2019-01-14 mbed_official Merge pull request #207 from adbridge/master
78:3f848aa75a8a 2019-01-14 mbed_official Merge pull request #208 from ARMmbed/mbed-os-5.11.0-oob
77:49aa083ab86d 2018-12-14 mbed_official Updating mbed-os to mbed-os-5.10.4
76:816112f271b8 2018-11-16 mbed_official Merge pull request #192 from paul-szczepanek-arm/update-libs
75:755edfe92edb 2018-11-07 mbed_official Merge pull request #189 from ARMmbed/donatieng-patch-1
74:5f07c82211e5 2018-10-22 mbed_official Merge pull request #187 from cmonr/master
73:4a446673b384 2018-09-26 mbed_official Merge pull request #183 from ARMmbed/mbed-os-5.10.0-oob
72:89208d8c67a2 2018-09-04 mbed_official Merge pull request #173 from pan-/use-cordio
71:038bc22898fb 2018-08-29 mbed_official Merge pull request #172 from 0xc0170/master
70:579a3e2ca9b5 2018-08-23 mbed_official Updating mbed-os to mbed-os-5.9.5
69:235cef9b8d60 2018-08-08 mbed_official Merge pull request #168 from cmonr/master
68:1f4296f23d88 2018-07-18 mbed_official Merge pull request #166 from cmonr/master
67:464f5b492e35 2018-07-06 mbed_official Merge pull request #163 from adbridge/master
66:be98e38e598c 2018-06-22 mbed_official Merge pull request #160 from adbridge/master
65:d927cb89f35b 2018-06-20 mbed_official Merge pull request #159 from ARMmbed/mbed-os-5.9.0-oob
64:7848e0088f94 2018-06-11 mbed_official Merge pull request #158 from adbridge/master
63:0dd6262093d9 2018-06-05 mbed_official Merge pull request #151 from paul-szczepanek-arm/privacy
62:fd993361c886 2018-04-04 mbed_official Merge pull request #141 from adbridge/master
61:1ffd455d931d 2018-04-04 mbed_official Merge pull request #142 from ARMmbed/mbed-os-5.8.0-oob
60:001107e7c90b 2018-03-23 mbed_official Merge pull request #139 from cmonr/master
59:136540807fac 2018-03-23 mbed_official Merge pull request #137 from adbridge/master
58:54ef49a5c9cf 2018-02-13 mbed_official Merge pull request #135 from adbridge/master
57:f134e0e666a8 2018-02-01 mbed_official BLE_Button: Add MTB_UBLOX_NINA_B1 config
56:5dc8297b04e9 2018-01-31 mbed_official Merge pull request #134 from cmonr/master
55:874d6f0aa3ef 2018-01-17 mbed_official Merge pull request #133 from adbridge/master
54:7be26b7eade9 2018-01-09 mbed_official Merge pull request #129 from adbridge/master
53:03155ea93ef7 2018-01-08 mbed_official Merge pull request #132 from pan-/remove-mbedignore
52:d168cec728b7 2017-12-20 mbed_official Merge pull request #126 from ARMmbed/mbed-os-5.7.0-oob
51:b2bb5563f994 2017-12-05 mbed_official Merge pull request #119 from adbridge/master
50:67f029b725a4 2017-11-23 mbed_official Merge pull request #115 from adbridge/master
49:d5f97ad1a359 2017-11-07 mbed_official Merge pull request #113 from adbridge/master
48:91d4934948e2 2017-11-03 mbed_official Merge pull request #110 from 0xc0170/master
47:70f571463f31 2017-11-01 mbed_official Merge pull request #112 from marcbonnici/master
46:9b386b659844 2017-10-11 mbed_official Merge pull request #108 from adbridge/master
45:d42c148d41f2 2017-09-29 mbed_official Merge pull request #106 from 0xc0170/master
44:55f5da77e102 2017-09-20 mbed_official Merge pull request #103 from ARMmbed/5.6_sanity
43:63b7eadfbcad 2017-09-08 mbed_official Merge pull request #102 from adbridge/master
42:3fe3ce7dd726 2017-08-08 mbed_official Merge pull request #100 from 0xc0170/master
41:5d7d704433f1 2017-07-28 mbed_official Merge pull request #99 from bcostm/add_disco_l475vg
40:0f3fe53a08cc 2017-07-19 mbed_official Merge pull request #97 from 0xc0170/master
39:4857e9637fa0 2017-07-19 mbed_official Merge pull request #98 from apalmieriGH/master
38:96780edf66c3 2017-07-11 mbed_official Merge pull request #93 from adbridge/master
37:cc38b28a3446 2017-06-22 mbed_official Merge pull request #89 from adbridge/master
36:202897a5fca0 2017-06-22 mbed_official Merge pull request #90 from apalmieriGH/master
35:dad435ee6e57 2017-06-20 mbed_official Merge pull request #88 from adbridge/master
34:c99398622773 2017-06-15 mbed_official Merge pull request #83 from apalmieriGH/master
33:ef9272cc1f82 2017-06-08 mbed_official Merge pull request #82 from adbridge/master
32:020d8a8b4675 2017-05-25 mbed_official Merge pull request #81 from adbridge/master
31:603c9a634e46 2017-05-10 mbed_official Merge pull request #79 from adbridge/master
30:217bfc94a9b7 2017-05-10 mbed_official Merge pull request #78 from ashok-rao/master
29:35ac362b9fd0 2017-05-09 mbed_official Merge pull request #77 from 0xc0170/master
28:dbf974af4a3e 2017-04-05 mbed_official Merge pull request #70 from 0xc0170/master
27:cd6398a10545 2017-04-05 mbed_official Merge pull request #72 from pan-/update_bluenrg_ref
26:4f030a98c41e 2017-04-05 mbed_official Merge pull request #71 from pan-/fix_bluenrg_reference