pxt-calliope/docs/reference/bluetooth/advertise-uid-buffer.md
Juri Wolf 5f7a8e5301
Updates for V4 (#197)
* update yotta defaults for 16kb devices

* refactor deprecated blocks

* updates for button events

* update button events

* update refference

* update docs

* update docs

* update button event blocks

* update docs

* update block id
2022-08-10 09:36:19 -07:00

1.4 KiB

Advertise UID Buffer

Advertises a UID via the Eddystone protocol over Bluetooth.

bluetooth.advertiseUidBuffer(pins.createBuffer(16), 7, true);

~ reminder

Deprecated

This API is deprecated. The Eddystone beacon format is no longer supported, see Google Beacon format (Deprecated).

~

~hint

Eddystone

Bluetooth beacons are used to indicate proximity to a place or object of interest. Beacons use Bluetooth advertising to broadcast a small amount of data, which can be received and acted upon by anyone in range with a suitable device and software, typically a smartphone and application.

There are various beacon message formats, which define the way Bluetooth advertising packets are used as containers for beacon data. iBeacon is Apple's beacon message format. Eddystone comes from Google.

Read more at https://lancaster-university.github.io/microbit-docs/ble/eddystone/ .

~

Parameters

  • buffer - a 16 bytes buffer containing the namespace (first 10 bytes) and instance (last 6 bytes).
  • power - a number representing the power level between 0 (short) and 7 (maximum range).
  • connectable - a boolean indicating whether or not the @boardname@ should accept connections.

See Also

stop-advertising, advertise-uid

bluetooth