BLE 04: Scan device

This example shows how to make a scan with Bluetooth low energy and look for a specific BLE module, printing number of discovered devices and scan results.

Required Materials

1 x Waspmote 1 x Battery 1 x Bluetooth Low Energy module 1 x Bluetooth module antenna 1 x Expansion board (if socket 1 is used) 1 x SD card

Notes

- Socket 0 is used by default - EEPROM is used in this example by default. - Never unplug module while Waspmote is turned ON. - Bluetooth module antenna should be connected. - The battery must be connected in ANY example. - This example can be executed in Waspmote v12 and Waspmote v15

Code

/*
 *  ------------------ [BLE_04] - scan device ------------------- 
 *
 *  Explanation: This example shows how to make a scan with 
 *  Bluetooth low energy and look for a specific BLE module, 
 *  printing number of discovered devices and scan results. 
 *
 *  Copyright (C) 2017 Libelium Comunicaciones Distribuidas S.L.
 *  http://www.libelium.com
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 * 
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 * 
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see .
 *
 *  Version:		1.1
 *  Design:			David Gascón
 *  Implementation:	Javier Siscart
 */
 
#include <WaspBLE.h>

// Auxiliary variable
uint8_t aux = 0;
// MAC address of BLE device to find
char MAC[14] = "000780789EBF";

void setup() 
{  
  USB.println(F("BLE_04 Example"));  

  // 0. Turn BLE module ON
  BLE.ON(SOCKET0);
}


void loop() 
{
  // 1. Device scan
  USB.print("Look for device: ");
  USB.println(MAC);
  aux = BLE.scanDevice(MAC);
  if (aux == 1)
  {
    USB.println(F("Found "));
  }
  else
  {
    USB.println(F("Not found: "));
  }


  // 2. Device scan with a timeout
  USB.print("Look for device: ");
  USB.print(MAC);
  USB.println(" during 10 seconds");
  
  aux = BLE.scanDevice(MAC, 10, TX_POWER_MAX);
  if (aux == 1)
  {
    USB.println(F("Found "));
  }
  else
  {
    USB.println(F("Not found: "));
  }

}

Output

H#
BLE_04 Example
New scan...
discovered devices: 2

Printing Last inquiry saved on EEPROM:
Scan params: GAP mode=2; scan_interval=75: scan_window=64; scan_duplicate_filtering=1; TXPower=15;
Device 0; 000780789ebf; RSSI:-41; Name:
Device 1; 00078053c1b9; RSSI:-39; Name:
devices printed:2

New scan...
discovered devices: 2

Printing Last inquiry saved on EEPROM:
Scan params: GAP mode=2; scan_interval=75: scan_window=64; scan_duplicate_filtering=1; TXPower=15;
Device 0; 000780789ebf; RSSI:-40; Name:
Device 1; 00078053c1b9; RSSI:-39; Name:
devices printed:2