The Eddystone Observer scans for Eddystone beacons that are running the Eddystone Service example (see there for general information about Eddystone beacons). It reads the advertising packets broadcast by these beacons, and prints a human-readable version of the advertised URLs to the serial console. he canonical source for this example lives at https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_EddystoneObserver

The Eddystone Observer scans for Eddystone beacons that are running the Eddystone Service example (see there for general information about Eddystone beacons). It reads the advertising packets broadcast by these beacons, and prints a human-readable version of the advertised URLs to the serial console.

Running the application

Requirements

General hardware information is in the main readme.

This sample requires two devices - one to broadcast the beacon and one to scan for the broadcast. If you have more devices, you can use them as extra beacons.

You need a terminal program to listen to the observer's output through a serial port. You can download one, for example:

  • Tera Term for Windows.
  • CoolTerm for Mac OS X.
  • GNU Screen for Linux.

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-IDB04A1

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

  • Build the Eddystone Observer application and install it on your board as explained in the building instructions. Leave the board connected to your computer.

Checking console output

To see the application's output:

  • Check which serial port your Eddystone Observer is connected to.
  • Run a terminal program with the correct serial port and the baud rate set to 9600. For example, to use GNU Screen, run: ``screen /dev/tty.usbmodem1412 9600``.
  • The Eddystone Observer should start printing URLs of nearby Eddystone beacons to the terminal.
Committer:
mbed_official
Date:
Fri Sep 08 14:45:27 2017 +0100
Revision:
42:092c08942a29
Parent:
3:b1e385adea43
Merge pull request #102 from adbridge/master

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

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 3:b1e385adea43 1 The Eddystone Observer scans for Eddystone beacons that are running the [Eddystone Service example](https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_EddystoneService) (see there for general information about Eddystone beacons). It reads the advertising packets broadcast by these beacons, and prints a human-readable version of the advertised URLs to the serial console.
mbed_official 3:b1e385adea43 2
mbed_official 3:b1e385adea43 3 # Running the application
mbed_official 3:b1e385adea43 4
mbed_official 3:b1e385adea43 5 ## Requirements
mbed_official 3:b1e385adea43 6
mbed_official 3:b1e385adea43 7 General hardware information is in the [main readme](https://github.com/ARMmbed/mbed-os-example-ble/blob/master/README.md).
mbed_official 3:b1e385adea43 8
mbed_official 3:b1e385adea43 9 This sample requires two devices - one to [broadcast the beacon](https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_EddystoneService) and one to scan for the broadcast. If you have more devices, you can use them as extra beacons.
mbed_official 3:b1e385adea43 10
mbed_official 3:b1e385adea43 11 You need a terminal program to listen to the observer's output through a serial port. You can download one, for example:
mbed_official 3:b1e385adea43 12
mbed_official 3:b1e385adea43 13 * Tera Term for Windows.
mbed_official 3:b1e385adea43 14
mbed_official 3:b1e385adea43 15 * CoolTerm for Mac OS X.
mbed_official 3:b1e385adea43 16
mbed_official 3:b1e385adea43 17 * GNU Screen for Linux.
mbed_official 3:b1e385adea43 18
mbed_official 3:b1e385adea43 19 ## Building instructions
mbed_official 3:b1e385adea43 20
mbed_official 3:b1e385adea43 21 Building instructions for all samples are in the [main readme](https://github.com/ARMmbed/mbed-os-example-ble/blob/master/README.md).
mbed_official 3:b1e385adea43 22
mbed_official 3:b1e385adea43 23 1. Build and run the [Eddystone beacon](https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_EddystoneService) on one or more other devices.
mbed_official 3:b1e385adea43 24
mbed_official 3:b1e385adea43 25 1. Build the Eddystone Observer application and install it on your board as explained in the building instructions. Leave the board connected to your computer.
mbed_official 3:b1e385adea43 26
mbed_official 3:b1e385adea43 27 ## Checking console output
mbed_official 3:b1e385adea43 28
mbed_official 3:b1e385adea43 29 To see the application's output:
mbed_official 3:b1e385adea43 30
mbed_official 3:b1e385adea43 31 1. Check which serial port your Eddystone Observer is connected to.
mbed_official 3:b1e385adea43 32
mbed_official 3:b1e385adea43 33 1. Run a terminal program with the correct serial port and the baud rate set to 9600. For example, to use GNU Screen, run: ``screen /dev/tty.usbmodem1412 9600``.
mbed_official 3:b1e385adea43 34
mbed_official 3:b1e385adea43 35 1. The Eddystone Observer should start printing URLs of nearby Eddystone beacons to the terminal.