ble.startAdvert()

Description

Starts advertising over BLE. This optionally takes a parameter of type BLE_Advert_Settings. These settings do not actually determine what is sent over the air, so this function is independent of ble.setAdvertName() and ble.setAdvertData() (for advanced BLE users).

Syntax

ble.startAdvert();
ble.startAdvert(&advertSettings);

Parameters

&advertSettings: Pointer to an instance of BLE_Advert_Settings. If not provided, indefinite connectable advertising with a 100ms interval that stops during connection and restarts afterwards will be used.

Returns

Status code

Example (default settings)

Indefinite connectable advertising every 100ms that restarts on connection termination.

#include <BLE.h>

void setup() {
  ble.begin();
  ble.startAdvert();
}

void loop() {
  ble.handleEvents();
}

Example (custom settings)

Indefinite nonconnectable (e.g. for a simple beacon) advertisement every 900ms. Note that the last member, the connected behavior, of advertSettings has no effect because this is nonconnectable advertising.

#include <BLE.h>

BLE_Advert_Settings advertSettings =
{
  BLE_ADV_MODE_NONCONN,
  0,
  1440, // 1440*0.625ms = 900ms
  BLE_ADV_RESTART_ON_CONN_EST
}

void setup() {
  ble.begin();
  ble.startAdvert(&advertSettings);
}

void loop() {
  ble.handleEvents();
}

Reference Home || BLE Library