ArduinoBLE - scanForName()

Start scanning for BLE devices that are advertising with a particular (local) name.

Syntax

BLE.scanForName(name)
BLE.scanForName(name, withDuplicates)

Parameters

name: (local) name of device (as a String) to filter for withDuplicates: optional, defaults to false. If true, advertisements received more than once will not be filtered.

Returns

1 on success, 0 on failure.

Example


  // begin initialization
  if (!BLE.begin()) {
    Serial.println("starting BLE failed!");

    while (1);
  }

  Serial.println("BLE Central scan");

  // start scanning for peripheral
  BLE.scanForName("LED");

  

  BLEDevice peripheral = BLE.available();

  if (peripheral) {
     // ...
  }