Update instructions and add advertised name setting function

Author: oclyke

libraries/Examples/examples/Example8_BLE_LED/BLE_example.h

@@ -57,5 +57,6 @@ void set_next_wakeup(void);
 void button_handler(wsfEventMask_t event, wsfMsgHdr_t *pMsg);
 extern void AppUiBtnTest(uint8_t btn);
 
+void setAdvName(const char* str);
 
 #endif // _BLE_EXAMPLE_H_

libraries/Examples/examples/Example8_BLE_LED/BLE_example_funcs.cpp

@@ -1,5 +1,9 @@
 #include "BLE_example.h"
 
+extern "C" void set_adv_name( const char* str );
+void setAdvName(const char* str){
+    set_adv_name( str );
+}
 
 //*****************************************************************************
 //

libraries/Examples/examples/Example8_BLE_LED/Example8_BLE_LED.ino

@@ -1,5 +1,37 @@
+/*
+  Analog to digital conversion
+  By: Owen Lyke
+  SparkFun Electronics
+  Date: Aug 27, 2019
+  License: MIT. See license file for more information but you can
+  basically do whatever you want with this code.
+
+  This example demonstrates basic BLE server (peripheral) functionality for the Apollo3 boards.
+
+  How to use this example:
+    - Install the nRF Connect app on your mobile device (must support BLE bluetooth)
+    - Make sure you select the correct board definition from Tools-->Board 
+      (it is used to determine which pin controls the LED)
+    - Compile and upload the example to your board with the Arduino "Upload" button
+    - In the nRF Connect app look for the device in the "scan" tab. 
+        (By default it is called "Artemis BLE" but you can change that below)
+    - Once the device is found click "connect"
+    - The GATT server will load with 5 services:
+      - Generic Access
+      - Generic Attribute
+      - Link Loss
+      - Immediate Alert
+      - Tx Power
+    - For this example we've hooked into the 'Immediate Alert' service. 
+        You can click on that pane and it will expand to show an "upload"  button.
+        Use the upload button to write one of three values (0x00, 0x01, or 0x02)
+    - When you send '0x00' (aka 'No alert') the LED will be set to off
+    - When you send either '0x01' or '0x02' the LED will be set to on
+*/
 #include "BLE_example.h"
 
+#define BLE_PERIPHERAL_NAME "Artemis BLE" // Up to 29 characters
+
 void setup() {
 
   #ifdef DEBUG
@@ -11,6 +43,10 @@ void setup() {
   pinMode(LED_BUILTIN, OUTPUT);
   set_led_low();
 
+  //
+  // Configure the peripheral's advertised name:
+  setAdvName(BLE_PERIPHERAL_NAME);
+
   //
   // Boot the radio.
   //

libraries/Examples/examples/Example8_BLE_LED/nus_main.c

@@ -26,6 +26,7 @@
 
 
 #include <string.h>
+#include <stdbool.h>
 #include "wsf_types.h"
 #include "bstream.h"
 #include "wsf_msg.h"
@@ -156,27 +157,51 @@ static uint8_t localIrk[] =
   Advertising Data
 **************************************************************************************************/
 
+// /*! advertising data, discoverable mode */
+// static const uint8_t tagAdvDataDisc[] =
+// {
+//   /*! flags */
+//   2,                                      /*! length */
+//   DM_ADV_TYPE_FLAGS,                      /*! AD type */
+//   DM_FLAG_LE_LIMITED_DISC |               /*! flags */
+//   DM_FLAG_LE_BREDR_NOT_SUP,
+
+//   /*! tx power */
+//   2,                                      /*! length */
+//   DM_ADV_TYPE_TX_POWER,                   /*! AD type */
+//   0,                                      /*! tx power */
+
+//   /*! device name */
+//   4,                                      /*! length */
+//   DM_ADV_TYPE_LOCAL_NAME,                 /*! AD type */
+//   'T',
+//   'a',
+//   'g'
+// };
+
 /*! advertising data, discoverable mode */
-static const uint8_t tagAdvDataDisc[] =
-{
-  /*! flags */
-  2,                                      /*! length */
-  DM_ADV_TYPE_FLAGS,                      /*! AD type */
-  DM_FLAG_LE_LIMITED_DISC |               /*! flags */
-  DM_FLAG_LE_BREDR_NOT_SUP,
-
-  /*! tx power */
-  2,                                      /*! length */
-  DM_ADV_TYPE_TX_POWER,                   /*! AD type */
-  0,                                      /*! tx power */
-
-  /*! device name */
-  4,                                      /*! length */
-  DM_ADV_TYPE_LOCAL_NAME,                 /*! AD type */
-  'T',
-  'a',
-  'g'
-};
+#define MAX_ADV_DATA_LEN 31
+uint8_t tagAdvDataDisc[MAX_ADV_DATA_LEN] = {0};
+
+void set_adv_name( const char* str ){
+  uint8_t indi = 0;
+  bool done = false;
+  do{
+    if( *(str+indi) == 0 ){
+      done = true;
+    }else{
+      tagAdvDataDisc[2+indi] = *(str+indi); // copies characters from str into the data 
+      indi++;
+      if(indi >= (MAX_ADV_DATA_LEN-2)){
+        done = true;
+      }
+    }
+  }while(!done);
+  tagAdvDataDisc[0] = 30;                     // sets the 'length' field (note: if the sum of 'length' fields does not match the size of the adv data array then there can be problems!)
+  tagAdvDataDisc[1] = DM_ADV_TYPE_LOCAL_NAME; // sets the 'type' field
+
+  // debug_printf("adv data: %s\n", str);
+}
 
 /*! scan data */
 static const uint8_t tagScanData[] =