Add BLE central function, debug interface and refactor peripheral

1. Add debug interface on Serial1
2. Update BLE stack and need update BLE's FW
3. Reconstruct the BLE peripheral base on V3
4. Implement the BLE Central Role base on V3
5. Implement some sketches for new BLE library
6. Add central read/write example
7. Add set advertising parameter interface
8. Add API to allow set up advertising after setup
9. Add interface to set the device name

Author: calvinatintel

README.md

@@ -53,3 +53,21 @@ them to the [support forum](https://forum.arduino.cc/index.php?board=103).
 > "How do I use this library?"
 
 > "I can't get this example sketch to work. What am I doing wrong?"
+
+# Enable debug interface on Serail1
+
+*Default disable the debug interface.
+
+If you want to enable debug trace on Serail1 to debug corelib,  follow these instructions.
+
+1. Shut down the IDE
+2. Go to Arduino15 directory
+  * Windows: `C:\Users\<user>\AppData\Roaming\Arduino15`
+  * OS X: `~/Library/Arduino15`
+  * Linux: `~/.arduino15`
+3. Modify the platform.txt
+  * Find `compiler.c.flags` and add `-DCONFIGURE_DEBUG_CORELIB_ENABLED` at the end of this line
+  * Find `compiler.cpp.flags` and add `-DCONFIGURE_DEBUG_CORELIB_ENABLED` at the end of this line
+4. Initial Serial1 in your sketch
+  * Add `Serial1.begin(115200);` in your `setup()`
+5. Adjust the output level at log_init function in log.c

cores/arduino/printk.cpp

@@ -0,0 +1,230 @@
+/*
+ * Copyright (c) 2015, Intel Corporation. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <stdarg.h>
+#include "UARTClass.h"
+
+extern "C" void printk(const char *fmt, va_list args);
+int __vsnprintf(char *dest, int size, const char *fmt, va_list args)
+{
+	int might_format = 0;
+	int len = 0;
+	char lastchar = 0;
+	bool binary_format = false;
+
+	if (!dest || !size)
+		return 0;
+
+	while (*fmt && len < size) {
+		if (!might_format) {
+			if (*fmt == '\n' && lastchar != '\r') {
+				if (len < size) {
+					lastchar = *dest++ = '\r', len++;
+					continue;
+				} else
+					break;
+			} else if (*fmt != '%') {
+				if (len < size)
+					lastchar = *dest++ = *fmt, len++;
+				else
+					break;
+			} else
+				might_format = 1;
+		} else {
+			if (*fmt == '%') {
+				if (len < size)
+					*dest++ = '%', len++;
+				else
+					break;
+				might_format = 0;
+			} else {
+				switch (*fmt) {
+				case '0':
+				case '1':
+					might_format |= 2;
+					goto still_format;
+					break;
+				case '2':
+					might_format |= 4;
+					goto still_format;
+					break;
+				case '4':
+					might_format |= 8;
+					goto still_format;
+					break;
+				case 'b':
+					binary_format = true;
+					goto still_format;
+					break;
+				case 'd':
+				case 'i':
+				case 'u':
+					if (!binary_format) {
+						unsigned long num =
+							va_arg(args,
+							       unsigned long);
+						unsigned long pos = 999999999;
+						unsigned long remainder = num;
+						int found_largest_digit = 0;
+
+						if (*fmt != 'u'
+						    && (num & (1 << 31))) {
+							if (len < size)
+								*dest++ =
+									'-',
+								len++;
+							num = (~num) + 1;
+							remainder = num;
+						}
+						while (pos >= 9) {
+							if (found_largest_digit
+							    || remainder >
+							    pos) {
+								found_largest_digit
+									= 1;
+								if (len < size)
+									*dest++
+										=
+											(
+												char)
+											((
+												 remainder
+												 / (
+													 pos
+													 +
+													 1))
+											 +
+											 48),
+									len++;
+								else
+									break;
+							}
+							remainder %= (pos + 1);
+							pos /= 10;
+						}
+						if (len < size)
+							*dest++ =
+								(char)(
+									remainder
+									+
+									48),
+							len++;
+						break;
+					}
+				case 'x':
+				case 'X':
+				case 'p': {
+					unsigned long num =
+						va_arg(args, unsigned long);
+					int sz = sizeof(num) * 2;
+
+					if (might_format & 8) {
+						sz = 4;
+					} else if (might_format & 4) {
+						sz = 2;
+					} else if (might_format & 2) {
+						sz = 1;
+					}
+					for (; sz; sz--) {
+						char nibble;
+						if (!binary_format) {
+							nibble =
+								(num >>
+								 ((sz -
+								   1) <<
+								  2) & 0xf);
+							nibble +=
+								nibble >
+								9 ? 87 : 48;
+						} else {
+							nibble =
+								(num >>
+								 ((sz -
+								   1) <<
+								  3) & 0xff);
+						}
+						if (len < size)
+							*dest++ =
+								nibble,
+							len++;
+						else
+							break;
+					}
+					break;
+				}
+				case 's': {
+					char *s = va_arg(args, char *);
+					while (*s)
+						if (len < size)
+							*dest++ =
+								*s++, len++;
+						else
+							break;
+					break;
+				}
+				case 'c': {
+					char c = va_arg(args, int);
+					if (len < size)
+						*dest++ = c, len++;
+					break;
+				}
+				default:
+					if (len < size)
+						*dest++ = '%', len++;
+					if (len < size)
+						*dest++ = *fmt, len++;
+					break;
+				}
+				might_format = 0;
+still_format:
+				(void)might_format;
+			}
+		}
+		++fmt;
+	}
+	*dest = '\0';
+	return len;
+}
+
+extern UARTClass Serial1;
+#define PRINTK_BUFSIZ 256
+void printk(const char *fmt, va_list args)
+{
+#ifdef CONFIGURE_DEBUG_CORELIB_ENABLED
+	int len = 0;
+
+    char tmp[PRINTK_BUFSIZ];
+
+    len = __vsnprintf(tmp, PRINTK_BUFSIZ, fmt, args);
+    
+    tmp[len] = '\0';
+    Serial1.println(tmp);
+#endif
+}

libraries/CurieBLE/examples/BatteryMonitor/BatteryMonitor.ino

@@ -45,7 +45,7 @@ void setup() {
 
 void loop() {
   // listen for BLE peripherals to connect:
-  BLECentral central = blePeripheral.central();
+  BLECentralHelper central = blePeripheral.central();
 
   // if a central is connected to peripheral:
   if (central) {

libraries/CurieBLE/examples/CallbackLED/CallbackLED.ino

@@ -45,19 +45,19 @@ void loop() {
   blePeripheral.poll();
 }
 
-void blePeripheralConnectHandler(BLECentral& central) {
+void blePeripheralConnectHandler(BLEHelper& central) {
   // central connected event handler
   Serial.print("Connected event, central: ");
   Serial.println(central.address());
 }
 
-void blePeripheralDisconnectHandler(BLECentral& central) {
+void blePeripheralDisconnectHandler(BLEHelper& central) {
   // central disconnected event handler
   Serial.print("Disconnected event, central: ");
   Serial.println(central.address());
 }
 
-void switchCharacteristicWritten(BLECentral& central, BLECharacteristic& characteristic) {
+void switchCharacteristicWritten(BLEHelper& central, BLECharacteristic& characteristic) {
   // central wrote new value to characteristic, update LED
   Serial.print("Characteristic event, written: ");