Skip to content

Latest commit

 

History

History
61 lines (41 loc) · 3.29 KB

protocol-specification.md

File metadata and controls

61 lines (41 loc) · 3.29 KB

Eddystone Protocol Specification

Common Elements

Every Eddystone frame type must contain the following PDU data types:

  • The Complete List of 16-bit Service UUIDs as defined in The Bluetooth Core Specification Supplement (CSS) v5, Part A, § 1.1. The Complete List of 16-bit Service UUIDs must contain the Eddystone Service UUID of 0xFEAA. This is included to allow background scanning on iOS devices.
  • The Service Data data type, Ibid., § 1.11. The Service Data - 16 bit UUID data type must be the Eddystone Service UUID of 0xFEAA.

The specific type of Eddystone frame is encoded in the high-order four bits of the first octet in the Service Data associated with the Service UUID. Permissible values are:

Frame Type High-Order 4 bits Byte Value
UID 0000 0x00
URL 0001 0x10
TLM 0010 0x20
RESERVED 0011 0x30
RESERVED 0100 0x40

The four low-order bits are reserved for future use and must be 0000.

Note: although the core Bluetooth data type are defined in the standard as little-endian, Eddystone's multi-value bytes defined in the Service Data are all big-endian.

An example frame type may look like:

Byte offset Value Description Data Type
0 0x02 Length Flags. CSS v5, Part A, § 1.3
1 0x01 Flags data type value
2 0x06 Flags data
3 0x03 Length Complete list of 16-bit Service UUIDs. Ibid. § 1.1
4 0x03 Complete list of 16-bit Service UUIDs data type value
5 0xAA 16-bit Eddystone UUID
6 0xFE ...
7 0x?? Length Service Data. Ibid. § 1.11
8 0x16 Service Data data type value
9 0xAA 16-bit Eddystone UUID
10 0xFE ...

With subsequent bytes comprising the frame-specific Service Data.

The individual frame types are listed below.

The Eddystone-UID frame broadcasts an opaque, unique 16-byte Beacon ID composed of a 10-byte namespace and a 6-byte instance. The Beacon ID may be useful in mapping a device to a record in external storage. The namespace portion of the ID may be used to group a particular set of beacons, while the instance ID identifies individual devices in the group. The division of the ID into namespace and instance components may also be used to optimize BLE scanning strategies, e.g. by filtering only on the namespace.

The Eddystone-URL frame broadcasts a URL using a compressed encoding format in order to fit more within the limited advertisement packet.

Once decoded, the URL can be used by any client with access to the internet. For example, if an Eddystone-URL beacon were to broadcast the URL https://goo.gl/Aq18zF, then any client that received this packet could choose to visit that url.

The Eddystone-URL frame forms the backbone of the Physical Web, an effort to enable frictionless discovery of web content relating to one’s surroundings. Eddystone-URL incorporates all of the learnings from the UriBeacon format from which it evolved.

The Eddystone-TLM frame broadcasts telemetry information about the beacon itself such as battery voltage, device temperature, and counts of broadcast packets.