Example: BLE Beacon - Eddystone URL and extend documentation

[VojtechBartoska]

Board

any

Device Description

N/A

Hardware Configuration

N/A

Version

v2.0.6

IDE Name

Arduino IDE

Operating System

N/A

Flash frequency

N/A

PSRAM enabled

yes

Upload speed

N/A

Description

Fix the example, improve documentation.

Sketch

N/A

Debug Message

N/A

Other Steps to Reproduce

No response

I have checked existing issues, online documentation and the Troubleshooting Guide

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[PilnyTomas]

The documentation does not provide information on possibility of adding device name. Also This post says that there is no room for beacon name. And there is a nice picture displaying all the possibilities of Eddystone.

The example BLE_EddystoneURL_Beacon sends Frame 642E6769657365636B652E746B0A0955524C426561636F6E which translates to string

d.giesecke.tk
	URLBeacon

Note that 0x0A09 which is \n\t followed by the device name. So there might have been some addition to the standard, but I could not find it anywhere.
The device name is setup in the example here and here.
The only way to pick up this example is with an android app iBeacon & Eddystone Scanner
The example BLE_Beacon_Scanner is not able to detect the beacon.

Conclusion - either beacon on scanner needs fixing. Also it would be nice to find if there was any extension to Eddystone format which allows using device name.

P.S. It is difficult to RTFM when there is on FM!

[PilnyTomas]

Another thing that we need to do is extend the documentation because the function description which reads Set the raw data for the beacon record. is entirely pointless!!!

arduino-esp32/libraries/BLE/src/BLEEddystoneTLM.cpp

Line 112 in 9676ef5

* Set the raw data for the beacon record.

[SuGlider]

Commits:
c9bf68d
aa5486b

Shall fix the Eddystone URL example.