This repository is superseded by armmbed/mbed-os-examples-ble - which contains BLE example applications for mbed OS 2.0 and mbed OS 5.0.
This repo contains a collection of BLE example applications based on mbed OS 3 and built with yotta. Each example subdirectory contains a separate yotta module meant for building an executable.
Please browse to subdirectories for specific documentation.
To build these examples, you need to have a computer with the following software installed:
In order to use BLE in mbed OS you need one of the following hardware combinations:
The ble
yotta module provides the BLE APIs on mbed OS. The ble
module uses yotta targets and yotta
target dependencies to provide the appropriate implementation of the BLE API
for your chosen hardware combination.
A yotta target
is a supported combination of hardware board and toolchain. This means that, for any of the hardware combinations above, you will need to use or create a
yotta target that describes your configuration. The existing supported configurations
are described below.
The following targets have been tested and work with these examples:
Nordic (using the nrf51822-ble module):
ST (using the st-ble module):
To build an example:
Clone the repository containing the collection of examples:
$ git clone https://github.com/ARMmbed/ble-examples.git
Tip: If you don't have GitHub installed, you can download a zip file of the repository.
Using a command-line tool, navigate to any of the example directories, like BLE_Beacon:
$ cd ble-examples
$ cd BLE_Beacon
Set a yotta target. For example, if you have and Nordic nRF51 and the GCC toolchain:
yotta target nrf51dk-gcc
Run the build:
yotta build
To run the application on your board:
Connect your mbed board to your computer over USB. It appears as removable storage.
When you run the yotta build
command, as you did above, yotta creates a BIN or a combined HEX file in a build/<target-name>/source
directory under the example's directory. Drag and drop the file to the removable storage.
Exactly which executables are generated depends on the target that you have chosen. For Nordic Semiconductor targets, the following .hex files will be present:
<module_name>-combined.hex
is the one which can be flashed to the target.<module_name>
is an ELF binary containing symbols (useful for debugging).<module_name>.hex
contains only the application (not the SoftDevice binary) and can be used for Firmware Over the Air.If you're interested in creating BLE applications for mbed OS, or porting existing applications from mbed Classic to mbed OS, please see our Introduction to mbed BLE.