Reference   Language | Libraries | Comparison | Changes

ArduinoBLE : BLE class

scanForAddress()

Description

Start scanning for BLE devices that are advertising with a particular (Bluetooth) address.

Syntax

BLE.scanForAddress(address)
BLE.scanForAddress(address, withDuplicates)

Parameters

address: (Bluetooth) address (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.scanForAddress("aa:bb:cc:ee:dd:ff");

  // …

  BLEDevice peripheral = BLE.available();

  if (peripheral) {
     // ...
  }
…
[Get Code]

See Also




Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.