Add BLE central function, debug interface and refactor peripheral

-Add debug interface on Serial1
-Update BLE stack and need update BLE's FW
-Reconstruct the BLE peripheral base on V3
-Implement the BLE Central Role base on V3
-Implement some sketches for new BLE library
-Add central read/write example
-Add set advertising parameter interface
-Add API to allow set up advertising after setup
-Add interface to set the device name

Author: sgbihu

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/Arduino.h

@@ -43,8 +43,6 @@ extern "C"{
 #define clockCyclesToMicroseconds(a) ( ((a) * 1000L) / (SYSTEM_CORE_CLOCK / 1000L) )
 #define microsecondsToClockCycles(a) ( (a) * (SYSTEM_CORE_CLOCK / 1000000L) )
 
-#define digitalPinToInterrupt(P)   ( P )
-
 void yield(void);
 
 /* sketch */

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: ");