Skip to content
This repository has been archived by the owner on Dec 29, 2022. It is now read-only.
/ eddystone Public archive

Specification for Eddystone, an open beacon format from Google

License

Notifications You must be signed in to change notification settings

google/eddystone

Folders and files

NameName
Last commit message
Last commit date
Jul 16, 2015
Jan 2, 2017
Apr 20, 2016
Apr 14, 2016
Aug 11, 2016
Sep 28, 2016
Apr 6, 2017
May 1, 2016
Jul 14, 2015
Jan 8, 2018
Sep 10, 2015
Jul 15, 2015
Jul 16, 2015
Dec 9, 2015
Jul 14, 2015
Apr 14, 2016
Apr 14, 2016

Eddystone

Eddystone is a protocol specification that defines a Bluetooth low energy (BLE) message format for proximity beacon messages. It describes several different frame types that may be used individually or in combinations to create beacons that can be used for a variety of applications.

Announced in April 2016, Eddystone-EID (Ephemeral ID) is a new frame type that defines a cryptographically secure method of configuring a beacon to broadcast information that only authorized people may decrypt. It includes support for a secure transmission of the TLM (Telemetry) information.

Design Goals

The design of Eddystone has been driven by several key goals:

  • Works well with Android and iOS Bluetooth developer APIs
  • Straightforward implementation on a wide range of existing BLE devices
  • Flexible architecture permitting development of new frame types
  • Fully compliant with the Bluetooth Core Specification

Protocol Specification

The common frame PDU types and the individual service data byte layouts for the Eddystone frame formats are documented in the Eddystone Protocol Specification.

Configuration Service

Eddystone defines a GATT configuration service to enable interoperability between hardware manufacturers and application developers. It allows the beacon to report its capabilities to apps, and for the beacon's broadcast data to be reconfigured. This service is also necessary for secure configuration and registration as an Eddystone-EID beacon.

Tools and Code Samples

We have a variety of tools and code samples to assist developers and implementors in working with Eddystone devices.