Merge branch 'Serial' of https://github.com/ed7coyne/firebase-arduino into Serial

Author: ed7coyne

serial_protocol.md

@@ -1,7 +1,7 @@
 #Protocol:
 During the first use, or when the chiplet changes environments a “NETWORK” call is expected to initialize the wifi parameters.
 
-Every time a serial connection is established we will expect a “INIT” call after which any subsequent calls can be made, until the connection is closed. 
+Every time a serial connection is established we will expect a “BEGIN” call after which any subsequent calls can be made, until the connection is closed. 
 
 In the following examples we use $ to represent variables. For example $Host represents your firebase host.
 
@@ -10,8 +10,7 @@ All responses will be prefixed with one of the following bytes signifying the re
 ```
   + If response is ok and a raw string value.
   * If response is ok and a raw string value prefixed by count of bytes in response then new line.
-  # If response is ok and a integer value.
-  . If response is ok and a float value.
+  : If response is ok and a number, this could be float or int.
   ? If response is ok and a boolean value.
   $ If response is ok and json formatted and prefixed by count of bytes in response then new line.
   - If response is an error
@@ -32,17 +31,17 @@ Only needs to be called when the chiplet is in a new environment and needs to co
 	>> NETWORK home-guest
 	<< -UNABLE_TO_CONNECT
 
-##INIT
+##BEGIN
 Must be called after creating a Serial connection, it can take either just a host for accessing public variables or you may also provide a secret for accessing protected variables in the database.
 ###Usage
-	INIT $Host
-	INIT $Host $Secret
+	BEGIN $Host
+	BEGIN $Host $Secret
 ###Response
 	OK - Accepted initialization parameters
 ###Examples
-	>> INIT https://samplechat.firebaseio-demo.com
+	>> BEGIN https://samplechat.firebaseio-demo.com
 	<< +OK
-	>> INIT https://samplechat.firebaseio-demo.com nnz...sdf
+	>> BEGIN https://samplechat.firebaseio-demo.com nnz...sdf
 	<< +OK
 ##GET
 Fetches the value at $Path and returns it on the serial line. If $PATH points to a leaf node you will get the raw value back, if it points to an internal node you will get a JSON string with all children.
@@ -63,8 +62,7 @@ Same as GET but will either return the value in the format specified (by the for
 ###Usage
 	GET+ $PATH
 	GET* $PATH
-	GET# $PATH
-	GET. $PATH
+	GET: $PATH
 	GET? $PATH
 	GET$ $PATH
 ###Response
@@ -153,7 +151,7 @@ The event stream will continue until you send CANCEL_STREAM.
 ###Examples
 	>>STREAM /user/aturning
 	<<+PUT /last_login
-	<<#1455052043
+	<<:1455052043
 	<<+PUT /address
 	<<*24
 	<<78 High Street,