Added BLE led management in ble library

Author: chiararuggeri

libraries/BLE/BLECentralRole.cpp

@@ -35,6 +35,8 @@
 BLECentralRole::BLECentralRole() : 
   _messageEventHandler(NULL),
 
+  _status(DISCONNECT),
+  
   _localAttributes(NULL),
   _numLocalAttributes(0),
   _remoteAttributes(NULL),
@@ -224,6 +226,10 @@ void BLECentralRole::allowMultilink(uint8_t linksNo){
   _allowedPeripherals = linksNo;
 }
 
+BLEStatus BLECentralRole::status(){
+  return _status;
+}
+
 void BLECentralRole::setBondStore(BLEBondStore& bondStore){
   this->_bondStore = bondStore;
 }
@@ -604,7 +610,7 @@ void BLECentralRole::begin(){
   }
 
   this->startScan();
-
+  this->_status = SCANNING;
 }
 
 void BLECentralRole::poll(ble_evt_t *bleEvt){
@@ -627,6 +633,7 @@ void BLECentralRole::poll(ble_evt_t *bleEvt){
             }
         break;
         case BLE_GAP_EVT_CONNECTED:
+            _status = CONNECT;
             uint8_t index;
             //save the handler in the first free location
             for(index = 0; index < _allowedPeripherals; index++)
@@ -685,6 +692,7 @@ void BLECentralRole::poll(ble_evt_t *bleEvt){
         break;
         case BLE_GAP_EVT_DISCONNECTED:
             uint8_t currentPeripheral;
+			this->_status = DISCONNECT;
             for(currentPeripheral = 0; currentPeripheral < _allowedPeripherals; currentPeripheral++)
               if(this->_connectionHandle[currentPeripheral] == bleEvt->evt.gap_evt.conn_handle)
                 break;
@@ -712,6 +720,7 @@ void BLECentralRole::poll(ble_evt_t *bleEvt){
 
         this->_remoteRequestInProgress = false;
         this->startScan();
+        this->_status = SCANNING;
         break;
 
       case BLE_GAP_EVT_CONN_PARAM_UPDATE:

libraries/BLE/BLECentralRole.h

@@ -78,6 +78,8 @@ class BLECentralRole : public BLECharacteristicValueChangeListener,
     void disconnect();
 
     void allowMultilink(uint8_t linksNo);
+	
+    BLEStatus status();
 
     void setBondStore(BLEBondStore& bondStore);
     void enableBond(BLEBondingType type = JUST_WORKS);
@@ -138,6 +140,8 @@ class BLECentralRole : public BLECharacteristicValueChangeListener,
       uint16_t valueHandle;
     };
 
+    BLEStatus                         _status;
+
     short                             _scanInterval = 0x0004;
     short                             _scanWindow   = 0x0004;
     short                             _scanTimeout  = 0;

libraries/BLE/BLEDevice.cpp

@@ -21,6 +21,7 @@ BLEDevice::BLEDevice() :
   _lesc(0),
   _io_caps(BLE_GAP_IO_CAPS_NONE),
   _passkey({0,0,0,0,0,0}),
+  _status(1),
   _userConfirm(false)
 {
 }

libraries/BLE/BLEDevice.h

@@ -119,6 +119,8 @@ class BLEDevice
     bool                          _userConfirm;
     BLEBondStore*                 _bondStore;
     BLEDeviceEventListener*       _eventListener;
+    uint8_t                       _status;
+
 };
 
 #endif

libraries/BLE/BLEPeripheral.cpp

@@ -282,6 +282,10 @@ bool BLEPeripheral::connected() {
   return this->_central;
 }
 
+BLEStatus BLEPeripheral::status(){
+  return (BLEStatus)this->_device->_status;
+}
+
 void BLEPeripheral::printBleMessage(int eventCode, int messageCode){
   if(eventCode > sizeof(this->_evt_code_to_string))
     return;

libraries/BLE/BLEPeripheral.h

@@ -62,6 +62,13 @@ enum BLEBondingType {
   LESC_CONFIRM_PASSKEY = 6
 };
 
+enum BLEStatus {
+	CONNECT = 0,
+	DISCONNECT,
+	ADVERTISING,
+	SCANNING
+};
+
 typedef void (*BLEPeripheralEventHandler)(BLECentral& central);
 typedef void (*BLEMessageEventHandler)(int eventNo, int messageCode);
 
@@ -108,6 +115,8 @@ class BLEPeripheral : public BLEDeviceEventListener,
 
     BLECentral central();
     bool connected();
+	
+    BLEStatus status();
 
     void printBleMessage(int eventCode, int messageCode);
 

libraries/BLE/examples/Central/Bonding/enterPasskeyCentral/enterPasskeyCentral.ino

@@ -8,6 +8,9 @@
    Use the complementary example showPasskey.ino in File->Examples->BLE->Peripheral->Bonding
    to test this feature.
   
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is scanning.
+   It will be on when the board is connected to a peripheral. It will be off when the board is disconnected.
+  
    This example code is in the public domain.
 */
 
@@ -27,6 +30,9 @@ BLERemoteCharacteristic          dummyRemoteCharacteristic           = BLERemote
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // add service and characteristic
   bleCentral.addRemoteAttribute(dummyRemoteService);
   bleCentral.addRemoteAttribute(dummyRemoteCharacteristic);
@@ -51,7 +57,18 @@ void setup() {
 }
 
 void loop() {
-  // Do nothing
+  // Handle BLE led
+  blinkOnScan();
+}
+
+void blinkOnScan(){
+  // retrieve the central status in order to blink only when scanning
+  if(bleCentral.status() == SCANNING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){
@@ -73,12 +90,16 @@ void bleCentralConnectHandler(BLEPeripheralPeer& peer) {
   // peer connected event handler
   Serial.print("Connected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void bleCentralDisconnectHandler(BLEPeripheralPeer& peer) {
   // peer disconnected event handler
   Serial.print("Disconnected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void writePasskey(BLEPeripheralPeer& peer) {

libraries/BLE/examples/Central/Bonding/numericComparisonCentral/numericComparisonCentral.ino

@@ -10,7 +10,10 @@
    to bond them.
    Use the complementary example numericComparison.ino in File->Examples->BLE->Peripheral->Bonding
    to test this feature.
-  
+
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is scanning.
+   It will be on when the board is connected to a peripheral. It will be off when the board is disconnected.
+   
    This example code is in the public domain.
 */
 
@@ -30,6 +33,9 @@ BLERemoteCharacteristic          dummyRemoteCharacteristic           = BLERemote
 
 void setup() {
   Serial.begin(9600);
+
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
 
   // initialize button
   pinMode(CONFIRM_BUTTON, INPUT);
@@ -58,7 +64,18 @@ void setup() {
 }
 
 void loop() {
-  // Do nothing
+  // Handle BLE led
+  blinkOnScan();
+}
+
+void blinkOnScan(){
+  // retrieve the central status in order to blink only when scanning
+  if(bleCentral.status() == SCANNING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){
@@ -80,12 +97,16 @@ void bleCentralConnectHandler(BLEPeripheralPeer& peer) {
   // peer connected event handler
   Serial.print("Connected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void bleCentralDisconnectHandler(BLEPeripheralPeer& peer) {
   // peer disconnected event handler
   Serial.print("Disconnected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void showPasskey(BLEPeripheralPeer& peer) {

libraries/BLE/examples/Central/Bonding/showPasskeyCentral/showPasskeyCentral.ino

@@ -7,6 +7,9 @@
   
    Use the complementary example enterPasskeyBond.ino in File->Examples->BLE->Peripheral->Bonding
    to test this feature.
+
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is scanning.
+   It will be on when the board is connected to a peripheral. It will be off when the board is disconnected.
   
    This example code is in the public domain.
 */
@@ -27,6 +30,9 @@ BLERemoteCharacteristic          dummyRemoteCharacteristic           = BLERemote
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // add service and characteristic
   bleCentral.addRemoteAttribute(dummyRemoteService);
   bleCentral.addRemoteAttribute(dummyRemoteCharacteristic);
@@ -51,7 +57,18 @@ void setup() {
 }
 
 void loop() {
-  // Do nothing
+  // Handle BLE led
+  blinkOnScan();
+}
+
+void blinkOnScan(){
+  // retrieve the central status in order to blink only when scanning
+  if(bleCentral.status() == SCANNING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){
@@ -73,12 +90,16 @@ void bleCentralConnectHandler(BLEPeripheralPeer& peer) {
   // peer connected event handler
   Serial.print("Connected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void bleCentralDisconnectHandler(BLEPeripheralPeer& peer) {
   // peer disconnected event handler
   Serial.print("Disconnected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void showPasskey(BLEPeripheralPeer& peer) {

libraries/BLE/examples/Central/CTSServer/CTSServer.ino

@@ -19,6 +19,9 @@
   about CTS service please refer to the Bluetooth specifications:
   https://www.bluetooth.com/specifications/gatt/viewer?attributeXmlFile=org.bluetooth.service.current_time.xml
 
+  In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is scanning.
+  It will be on when the board is connected to a peripheral. It will be off when the board is disconnected.
+  
   This example code is in the public domain.
   
 */
@@ -41,8 +44,10 @@ RTCInt rtc;  //create an RTCInt type object
 
 void setup() {
   Serial.begin(9600);
-  delay(2000);
-  Serial.println("start");
+
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   rtc.begin(TIME_H24); //init RTC in 24 hour mode
 
   //time settings
@@ -96,11 +101,17 @@ void loop() {
 
     // update characteristic value
     ctsCharacteristic.setValue((unsigned char *)time, 9);
-    
-    }
-    
+
     // update the value every second
     delay(1000);
+    
+  }    
+  else{ // if we are not connected we are scanning hence blink BLE led
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){
@@ -122,10 +133,14 @@ void bleCentralConnectHandler(BLEPeripheralPeer& peer) {
   // peer connected event handler
   Serial.print("Connected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void bleCentralDisconnectHandler(BLEPeripheralPeer& peer) {
   // peer disconnected event handler
   Serial.print("Disconnected event, peripheral: ");
   Serial.println(peer.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }

libraries/BLE/examples/Central/led_switch_client/led_switch_client.ino

@@ -15,6 +15,9 @@
   This means that a pressure of USER1 button on one board
   will cause the led's state change on the other board and
   vice versa.
+
+  In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is scanning.
+  It will be on when the board is connected to a peripheral. It will be off when the board is disconnected.
   
   This example code is in the public domain.
   
@@ -71,7 +74,10 @@ void setup() {
 
 void loop() {
   if(bleCentral.connected()){
-
+	
+	//turn on BLE led
+	digitalWrite(BLE_LED, HIGH);
+	
     bool buttonValue = digitalRead(BUTTON_PIN);
     bool buttonChanged = (buttonState != buttonValue);
 
@@ -85,6 +91,12 @@ void loop() {
       bleCentral.writeRemoteCharacteristic(remoteSwitchCharacteristic, &message, sizeof(message));
     }
   }
+    else{ // if we are not connected we are scanning hence blink BLE led
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){

libraries/BLE/examples/Central/multilink/multilink.ino

@@ -37,6 +37,10 @@ bool buttonState;
 
 void setup() {
   Serial.begin(9600);
+  
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   pinMode(LED_PIN, OUTPUT);
   pinMode(BUTTON_PIN, INPUT);
 
@@ -73,6 +77,11 @@ void setup() {
 void loop() {
   if(bleCentral.connected()){
 
+	// We are connected to at least one peripheral. turn BLE led on.
+	// Please note that until the maximum number of allowed peripheral is reached
+	// the board will be scan at the same time.
+	digitalWrite(BLE_LED, HIGH);
+
     bool buttonValue = digitalRead(BUTTON_PIN);
     bool buttonChanged = (buttonState != buttonValue);
 
@@ -86,6 +95,12 @@ void loop() {
       bleCentral.writeRemoteCharacteristic(remoteSwitchCharacteristic, &message, sizeof(message));
     }
   }
+  else{ // we are not connected to any peripheral. Signal the scan again
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){

libraries/BLE/examples/Central/scanner/scanner.ino

@@ -37,7 +37,8 @@ void setup() {
 }
 
 void loop() {
-  // put the board in standby mode to save power
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead.
   LowPower.standby();
 }
 

libraries/BLE/examples/Central/serialClient/serialClient.ino

@@ -54,8 +54,10 @@ void setup() {
 }
 
 void loop() {
-  // if a device is connected send data read from the Serial port
-  if(bleCentral.connected()){
+ // if a device is connected send data read from the Serial port
+ if(bleCentral.connected()){
+  // turn BLE led on
+  digitalWrite(BLE_LED, HIGH);
   int len = 0;
   // send the message when it reaches the maximum value (20 char)
   // or when a carriage return (\n) is pressed
@@ -77,6 +79,15 @@ void loop() {
    // send the message
    bleCentral.writeRemoteCharacteristic(remoteRxCharacteristic, message, len);
   }
+  else // if we are not connected we are scan. Move the BLE led accordingly
+	blinkOnScan();
+}
+
+void blinkOnScan(){
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
 }
 
 void receiveAdvPck(BLEPeripheralPeer& peer){
@@ -119,6 +130,9 @@ void bleCentralRemoteServicesDiscoveredHandler(BLEPeripheralPeer& peer) {
 
 
 void bleRemoteTxCharacteristicValueUpdatedHandle(BLEPeripheralPeer& peer, BLERemoteCharacteristic& characteristic) {
-  Serial.println("Remote characteristic value update handle");
-  Serial.println((char *)remoteTxCharacteristic.value());
+  // print the incoming message
+  char * message = (char *)remoteTxCharacteristic.value();
+  for(int i=0; i<remoteTxCharacteristic.valueLength(); i++)
+    Serial.print(message[i]);
+  Serial.println();
  }

libraries/BLE/examples/Peripheral/Bonding/enterPasskey/enterPasskey.ino

@@ -53,7 +53,8 @@ void setup() {
 }
 
 void loop() {
-  // put the board in low power mode
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead
   LowPower.standby();
 }
 

libraries/BLE/examples/Peripheral/Bonding/numericComparison/numericComparison.ino

@@ -10,12 +10,13 @@
    to bond them.
    Use the complementary example numericComparisonCentral.ino in File->Examples->BLE->Central->Bonding
    to test this feature.
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
   
    This example code is in the public domain.
 */
 
 #include <BLEPeripheral.h>
-#include <LowPower.h>
 
 #define CONFIRM_BUTTON    USER1_BUTTON
 
@@ -31,6 +32,9 @@ BLECharCharacteristic   dummyCharacteristic    = BLECharCharacteristic("19b10001
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // initialize button
   pinMode(CONFIRM_BUTTON, INPUT);
 
@@ -60,8 +64,18 @@ void setup() {
 }
 
 void loop() {
-  // put the board in low power mode
-  LowPower.standby();
+  // blink if the board is advertising
+  blinkOnAdv();
+}
+
+void blinkOnAdv(){
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void showPasskey(BLECentral& central) {
@@ -85,12 +99,16 @@ void blePeripheralConnectHandler(BLECentral& central) {
   // central connected event handler
   Serial.print(F("Connected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void blePeripheralDisconnectHandler(BLECentral& central) {
   // central disconnected event handler
   Serial.print(F("Disconnected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void receiveMessage(int evtCode, int messageCode){

libraries/BLE/examples/Peripheral/Bonding/showPasskey/showPasskey.ino

@@ -7,7 +7,10 @@
   
    Use the complementary example enterPasskeyCentral.ino in File->Examples->BLE->Central->Bonding
    to test this feature.  
-  
+
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
+   
    This example code is in the public domain.
 */
 
@@ -26,6 +29,9 @@ BLECharCharacteristic   dummyCharacteristic = BLECharCharacteristic("19b10001e8f
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // set advertised local name and service UUID
   blePeripheral.setLocalName("BONDExample");
   blePeripheral.setAdvertisedServiceUuid(dummyService.uuid());
@@ -53,8 +59,18 @@ void setup() {
 }
 
 void loop() {
-  // put the board in low power mode
-  LowPower.standby();
+  // blink if the board is advertising
+  blinkOnAdv();
+}
+
+void blinkOnAdv(){
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void showPasskey(BLECentral& central) {
@@ -72,12 +88,16 @@ void blePeripheralConnectHandler(BLECentral& central) {
   // central connected event handler
   Serial.print(F("Connected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void blePeripheralDisconnectHandler(BLECentral& central) {
   // central disconnected event handler
   Serial.print(F("Disconnected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void receiveMessage(int evtCode, int messageCode){

libraries/BLE/examples/Peripheral/CTSClient/CTSClient.ino

@@ -64,7 +64,8 @@ void setup() {
 }
 
 void loop() {
-  // put the board in standby mode to save power
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead
   LowPower.standby();
 }
 

libraries/BLE/examples/Peripheral/Eddystone/EddystoneUID/EddystoneUID.ino

@@ -21,6 +21,7 @@ void setup() {
 }
 
 void loop() {
-  // Put the board in low power mode
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead
   LowPower.standby();
 }

libraries/BLE/examples/Peripheral/Eddystone/EddystoneURL/EddystoneURL.ino

@@ -22,6 +22,7 @@ void setup() {
 }
 
 void loop() {
-  // Put the board in low power mode
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead
   LowPower.standby();
 }

libraries/BLE/examples/Peripheral/HID/HID_joystick_mouse/HID_joystick_mouse.ino

@@ -5,7 +5,9 @@
    This example shows the use of the HID BLE library.
    Connect a joystick to the pins A0 and A1 of the board.
    Connect the board to the phone through the phone's bluetooth settings and try to
-   move the joystick or press the USER1_BUTTON to press a key
+   move the joystick or press the USER1_BUTTON to press a key.
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
 */
 
 #include <BLEHIDPeripheral.h>
@@ -27,6 +29,9 @@ int joystickYCenter;
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+  
   pinMode(JOYSTICK_BUTTON_PIN, INPUT_PULLUP);
   buttonState = digitalRead(JOYSTICK_BUTTON_PIN);
 
@@ -50,7 +55,10 @@ void loop() {
     // central connected to peripheral
     Serial.print(F("Connected to central: "));
     Serial.println(central.address());
-
+	
+	// turn on BLE_LED when connected
+	digitalWrite(BLE_LED, HIGH);
+	
     while (central.connected()) {
       int tempButtonState = digitalRead(JOYSTICK_BUTTON_PIN);
       if (tempButtonState != buttonState) {
@@ -77,6 +85,12 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+  
+  // here we are not connected. This means we are advertising
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
 }
 
 int readJoystickAxis(int pin) {

libraries/BLE/examples/Peripheral/HID/HID_keyboard/HID_keyboard.ino

@@ -5,7 +5,9 @@
    This example shows the use of the HID BLE library.
    Connect the board to the phone through the phone's bluetooth settings,
    open a text field in the phone and try to write something in the board serial terminal.
- */
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
+*/
 
 #include <BLEHIDPeripheral.h>
 #include <BLEKeyboard.h>
@@ -18,6 +20,9 @@ BLEKeyboard bleKeyboard;
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // clear bond store data
   bleHIDPeripheral.clearBondStoreData();
 
@@ -41,6 +46,9 @@ void loop() {
     Serial.print(F("Connected to central: "));
     Serial.println(central.address());
 
+	// turn on BLE_LED when connected
+	digitalWrite(BLE_LED, HIGH);
+
     while (central.connected()) {
       if (Serial.available() > 0) {
         // read in character
@@ -57,4 +65,11 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+
+  // here we are not connected. This means we are advertising
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
+
 }

libraries/BLE/examples/Peripheral/HID/HID_keypad/HID_keypad.ino

@@ -8,6 +8,8 @@
    columns: 7, 6, 5
    Connect the board to the phone through the phone's bluetooth settings,
    open a text field in the phone and try to press a key in the keypad.
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
 */
 
 #include <BLEHIDPeripheral.h>
@@ -35,6 +37,9 @@ BLEKeyboard bleKeyboard;
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+  
   Serial.println(F("BLE HID Peripheral - clearing bond data"));
 
   // clear bond store data
@@ -58,6 +63,9 @@ void loop() {
     Serial.print(F("Connected to central: "));
     Serial.println(central.address());
 
+	// turn on BLE_LED when connected
+	digitalWrite(BLE_LED, HIGH);
+
     while (central.connected()) {
       char c = keypad.getKey();
 
@@ -71,4 +79,10 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+
+  // here we are not connected. This means we are advertising
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
 }

libraries/BLE/examples/Peripheral/HID/HID_test/HID_test.ino

@@ -5,6 +5,8 @@
    This example shows the use of the HID BLE library.
    Connect the board to the phone through the phone's bluetooth settings,
    open a serial terminal and type any characters.
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
 */
 
 #include <BLEHIDPeripheral.h>
@@ -22,6 +24,9 @@ BLESystemControl bleSystemControl;
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // clears bond data on every boot
   bleHID.clearBondStoreData();
 
@@ -50,6 +55,9 @@ void loop() {
     Serial.print(F("Connected to central: "));
     Serial.println(central.address());
 
+	// turn on BLE_LED when connected
+	digitalWrite(BLE_LED, HIGH);
+
     while (bleHID.connected()) {
       if (Serial.available() > 0) {
         Serial.read();
@@ -67,4 +75,10 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+
+  // here we are not connected. This means we are advertising
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
 }

libraries/BLE/examples/Peripheral/HID/HID_volume/HID_volume.ino

@@ -5,6 +5,8 @@
    This example implements an Apple Notification Center Service client
    For detailed information about the Apple Notification Center Service, see Apple's iOS Developer Library
    https://developer.apple.com/library/content/documentation/CoreBluetooth/Reference/AppleNotificationCenterServiceSpecification/Introduction/Introduction.html
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
 */
 
 #include <BLEPeripheral.h>
@@ -26,6 +28,8 @@ BLERemoteCharacteristic          ancsNotificationSourceCharacteristic     = BLER
 void setup() {
   Serial.begin(9600);
 
+  pinMode(BLE_LED, OUTPUT);
+  
   // clears bond data on every boot
   bleBondStore.clearData();
 
@@ -61,18 +65,35 @@ void setup() {
 
 void loop() {
   blePeripheral.poll();
+  // BLE_LED will be blinking when the board is advertising,
+  // on when the board is connected and off when it's disconnected.
+  blinkOnAdv();
+}
+
+void blinkOnAdv(){
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void blePeripheralConnectHandler(BLECentral& central) {
   // central connected event handler
   Serial.print(F("Connected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void blePeripheralDisconnectHandler(BLECentral& central) {
   // central disconnected event handler
   Serial.print(F("Disconnected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void blePeripheralBondedHandler(BLECentral& central) {

libraries/BLE/examples/Peripheral/ancs/ancs.ino

@@ -5,6 +5,9 @@
    This example shows how to read/write a characteristic to turn a LED on or off
    You can use nRFConnect app to read/write the characteristic
    https://www.nordicsemi.com/eng/Products/Nordic-mobile-Apps/nRF-Connect-for-mobile-previously-called-nRF-Master-Control-Panel
+
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
  */
 
 #include <BLEPeripheral.h>
@@ -24,6 +27,9 @@ BLECharCharacteristic    switchCharacteristic = BLECharCharacteristic("19b10001e
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // set LED pin to output mode
   pinMode(LED_PIN, OUTPUT);
 
@@ -49,6 +55,9 @@ void loop() {
     Serial.print(F("Connected to central: "));
     Serial.println(central.address());
 
+	// turn on BLE_LED when connected
+	digitalWrite(BLE_LED, HIGH);
+
     while (central.connected()) {
       // central still connected to peripheral
       if (switchCharacteristic.written()) {
@@ -67,4 +76,10 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+  
+  // here we are not connected. This means we are advertising
+  digitalWrite(BLE_LED, HIGH);
+  delay(200);
+  digitalWrite(BLE_LED, LOW);
+  delay(200);
 }

libraries/BLE/examples/Peripheral/led/led.ino

@@ -59,7 +59,8 @@ void setup() {
 }
 
 void loop() {
-  // put the board in low power mode
+  // since we want to realize a low power application we don't handle the
+  // BLE_LED in order to save power but put the board in low power mode instead
   LowPower.standby();
 }
 

libraries/BLE/examples/Peripheral/led_callback/led_callback.ino

@@ -8,7 +8,10 @@
    You can use nRFConnect app to read/write the characteristic
    https://www.nordicsemi.com/eng/Products/Nordic-mobile-Apps/nRF-Connect-for-mobile-previously-called-nRF-Master-Control-Panel
    or use another board with led_switch_client example in File->Examples->BLE->Central menu.
- */
+
+   In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
+   */
 
 #include <BLEPeripheral.h>
 
@@ -29,6 +32,9 @@ BLECharCharacteristic    buttonCharacteristic = BLECharCharacteristic("19b10012e
 void setup() {
   Serial.begin(115200);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   // set LED pin to output mode, button pin to input mode
   pinMode(LED_PIN, OUTPUT);
   pinMode(BUTTON_PIN, INPUT);
@@ -74,4 +80,14 @@ void loop() {
       digitalWrite(LED_PIN, LOW);
     }
   }
+
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
+  else // if we are not advertising, we are connected
+	digitalWrite(BLE_LED, HIGH);
 }

libraries/BLE/examples/Peripheral/led_switch/led_switch.ino

@@ -19,6 +19,9 @@ BLERemoteCharacteristic          remoteDeviceNameCharacteristic           = BLER
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   blePeripheral.setLocalName("remote-attributes");
 
   // set device name and appearance
@@ -44,18 +47,34 @@ void setup() {
 
 void loop() {
   blePeripheral.poll();
+  // blink if the board is advertising
+  blinkOnAdv();
+}
+
+void blinkOnAdv(){
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void blePeripheralConnectHandler(BLECentral& central) {
   // central connected event handler
   Serial.print(F("Connected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void blePeripheralDisconnectHandler(BLECentral& central) {
   // central disconnected event handler
   Serial.print(F("Disconnected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void blePeripheralRemoteServicesDiscoveredHandler(BLECentral& central) {

libraries/BLE/examples/Peripheral/remote_service/remote_service.ino

@@ -22,6 +22,9 @@ BLERemoteCharacteristic          remoteCharacteristic4                    = BLER
 void setup() {
   Serial.begin(9600);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   blePeripheral.setLocalName("remote-test");
 
   // set device name and appearance
@@ -53,18 +56,34 @@ void setup() {
 
 void loop() {
   blePeripheral.poll();
+  // blink if the board is advertising
+  blinkOnAdv();
+}
+
+void blinkOnAdv(){
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
 }
 
 void blePeripheralConnectHandler(BLECentral& central) {
   // central connected event handler
   Serial.print(F("Connected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED on
+  digitalWrite(BLE_LED, HIGH);
 }
 
 void blePeripheralDisconnectHandler(BLECentral& central) {
   // central disconnected event handler
   Serial.print(F("Disconnected event, central: "));
   Serial.println(central.address());
+  // turn BLE_LED off
+  digitalWrite(BLE_LED, LOW);
 }
 
 void blePeripheralRemoteServicesDiscoveredHandler(BLECentral& central) {

libraries/BLE/examples/Peripheral/remote_test/remote_test.ino

@@ -14,6 +14,9 @@
  * Please note that TX and RX characteristics use Notify and WriteWithoutResponse, so there's no guarantee
  * that the data will make it to the other end. However, under normal circumstances and reasonable signal
  * strengths everything works well.
+ *
+ * In this example BLE_LED shows the status of the board. It will blink every 200 ms when the board is advertising.
+ * It will be on when the board is connected to a central. It will be off when the board is disconnected.
  */
 
 
@@ -28,6 +31,9 @@ void setup() {
   // custom services and characteristics can be added as well
   bleSerial.setLocalName("UART");
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   Serial.begin(9600);
   bleSerial.begin();
 }
@@ -38,6 +44,16 @@ void loop() {
   forward();
   // loopback();
   // spam();
+  
+  // handle the BLE led. Blink when advertising
+  if(bleSerial.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
+  else // if we are not advertising, we are connected
+  digitalWrite(BLE_LED, HIGH);
 }
 
 

libraries/BLE/examples/Peripheral/serial/serial.ino

@@ -3,6 +3,8 @@
    Modified by Chiara Ruggeri <chiara@arduino.org>
 
    This example shows how to use the BLEPeripheral library.
+   The example also uses BLE_LED to show the status of the board. It will blink every 200 ms when the board is advertising.
+   It will be on when the board is connected to a central. It will be off when the board is disconnected.
 */
 
 #include <BLEPeripheral.h>
@@ -26,6 +28,9 @@ BLEDescriptor descriptor = BLEDescriptor("2901", "value");
 void setup() {
   Serial.begin(115200);
 
+  //initialize BLE led
+  pinMode(BLE_LED, OUTPUT);
+
   blePeripheral.setLocalName("local-name"); // optional
   blePeripheral.setAdvertisedServiceUuid(service.uuid()); // optional
 
@@ -64,4 +69,14 @@ void loop() {
     Serial.print(F("Disconnected from central: "));
     Serial.println(central.address());
   }
+  
+  // retrieve the peripheral status in order to blink only when advertising
+  if(blePeripheral.status() == ADVERTISING){
+    digitalWrite(BLE_LED, LOW);
+    delay(200);
+    digitalWrite(BLE_LED, HIGH);
+    delay(200);
+  }
+  else // if we are not advertising, we are connected
+	digitalWrite(BLE_LED, HIGH);
 }

libraries/BLE/examples/Peripheral/starter/starter.ino

@@ -116,6 +116,7 @@ hasData	KEYWORD2
 clearData	KEYWORD2
 storeData	KEYWORD2
 restoreData	KEYWORD2
+status	KEYWORD2
 
 setValueLE	KEYWORD2
 valueLE	KEYWORD2
@@ -193,3 +194,8 @@ BLEScanReceived	LITERAL1
 BLEMessage	LITERAL1
 
 BLEValueUpdated	LITERAL1
+
+ADVERTISING	LITERAL1
+SCANNING	LITERAL1
+CONNECT	LITERAL1
+DISCONNECT	LITERAL1

libraries/BLE/keywords.txt

@@ -487,6 +487,7 @@ void nRF51822::begin(unsigned char advertisementDataSize,
   }
 
   this->startAdvertising();
+  this->_status = 2;
 
 #ifdef __RFduino__
   RFduinoBLE_enabled = 1;
@@ -522,7 +523,7 @@ void nRF51822::poll(ble_evt_t *bleEvt) {
         Serial.print(F("Evt Connected "));
         Serial.println(address);
 #endif
-
+        this->_status = 0;
         this->_connectionHandle = bleEvt->evt.gap_evt.conn_handle;
 
 #if defined(NRF5) && !defined(S110)
@@ -564,6 +565,7 @@ void nRF51822::poll(ble_evt_t *bleEvt) {
 #endif
         this->_connectionHandle = BLE_CONN_HANDLE_INVALID;
         this->_txBufferCount = 0;
+        this->_status = 1;
 
         for (int i = 0; i < this->_numLocalCharacteristics; i++) {
           struct localCharacteristicInfo* localCharacteristicInfo = &this->_localCharacteristicInfo[i];
@@ -596,6 +598,7 @@ void nRF51822::poll(ble_evt_t *bleEvt) {
         this->_remoteRequestInProgress = false;
 
         this->startAdvertising();
+        this->_status = 2;
 
         break;