Skip to content
BLE demos using mbed OS 3 and yotta.
Branch: master
Clone or download
pan- Merge pull request #82 from ARMmbed/deprecate-repo
Deprecation warning for this repository
Latest commit f04e86c Dec 12, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
BLE_BatteryLevel Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_Beacon Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_Button Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_EddystoneObserver Improve documentation. Mar 14, 2016
BLE_EddystoneService Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_GAPButton Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_HeartRate Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_LED Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_LEDBlinker Improve BLE_LEDBlinker example. Mar 22, 2016
BLE_Thermometer Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
BLE_URIBeacon Readme updated with step by step expected visual result on the scanner. Mar 18, 2016
.gitignore EddystoneService: warn if targeting a chipset that does not have non-… Jan 12, 2016
LICENSE Initial commit Aug 10, 2015
README.md

README.md

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.

BLE Examples

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.

Getting Started

Pre-Requisites

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:

  • 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.

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.

Targets for BLE

The following targets have been tested and work with these examples:

Nordic (using the nrf51822-ble module):

  • nrf51dk-armcc
  • nrf51dk-gcc
  • mkit-gcc
  • mkit-armcc

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:

  1. 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.

  2. Using a command-line tool, navigate to any of the example directories, like BLE_Beacon:

    $ cd ble-examples
    $ cd BLE_Beacon
    
  3. Set a yotta target. For example, if you have and Nordic nRF51 and the GCC toolchain:

    yotta target nrf51dk-gcc
    
  4. Run the build:

    yotta build

To run the application on your board:

  1. Connect your mbed board to your computer over USB. It appears as removable storage.

  2. 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.

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.

You can’t perform that action at this time.