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:
- yotta. Please note that yotta has its own set of dependencies, listed in the installation instructions.
- ARM GCC toolchain.
- A serial terminal emulator (e.g. screen, pySerial, cu).
- If the OS used is Windows, the serial driver of the board has to be correctly installed.
- For boards with mbed interface firmware the installation instructions are located (here)[https://developer.mbed.org/handbook/Windows-serial-configuration]
- For nrf51-based board with a J-Link interface please install the J-Link software and documentation pack available (here)[https://www.segger.com/jlink-software.html]
In order to use BLE in mbed OS you need one of the following hardware combinations:
- A Nordic nRF51-based board such as nrf51dk or mkit.
- A supported target, such as the NUCLEO-F411RE, with a BLE shield or an external BLE peripheral, such as an ST shield.
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.
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.
Targets for BLE
The following targets have been tested and work with these examples:
Nordic (using the nrf51822-ble module):
ST (using the st-ble module):
- st-nucleo-f401re-st-ble-gcc (a NUCLEO-F411RE board with an ST BLE shield)
Building and testing the examples
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:
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 buildcommand, as you did above, yotta creates a BIN or a combined HEX file in a
build/<target-name>/sourcedirectory 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.hexis the one which can be flashed to the target.
<module_name>is an ELF binary containing symbols (useful for debugging).
<module_name>.hexcontains only the application (not the SoftDevice binary) and can be used for Firmware Over the Air.
Creating or porting your own BLE applications in mbed OS
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.