Diff: xDotBridge/README.md

Revision:

62:9751a8504c82

Parent:

61:8d9efd33cac9

Child:

67:2115a2f1b945

--- a/xDotBridge/README.md	Thu Mar 09 16:47:42 2017 -0700
+++ b/xDotBridge/README.md	Tue Mar 14 08:32:55 2017 -0600
@@ -65,6 +65,24 @@
 and data session keys.  This guarantees by design that all message sent can
 only be received and decoded by units in the pair group.
 
+### Important LoRaWAN Parameters
+For peer to peer only a subset of parameters apply.  Many are obvious such as
+power, frequency, and basic command and control.  Below are a listing of the more
+detailed parameters and our current understanding as to how they effect performance:
+
+ * Network address  - In peer to peer this acts both as a tx and rx address.  In other
+ words if all the modems are the same address messages act as broadcast.  For the
+ wireless bridge, this is used as a sort of network ID since all communication is
+ broadcast.
+ * Network session key - This is one of two encryption key.  Currently, in peer to peer
+ both are just randomly generated.
+ * Data session key - This is second of two encryption key.  Currently, in peer to peer
+ both are just randomly generated.
+
+Not applicable parameters:
+ * Network ID - Used for OTA
+ * Network Key - Used for OTA
+
 ### Brute force algorithm
 TODO
 
@@ -108,11 +126,11 @@
 ==============================================
 = 0x0A | 4 Bytes | Reserved for Frequency    =
 ==============================================
-= 0x0D | 4 Bytes | Network ID                =
+= 0x0E | 4 Bytes | Network Address           =
 ==============================================
-= 0x12 | 8 Bytes | Network Key               =
+= 0x12 | 16 Bytes | Network Session Key       =
 ==============================================
-= 0x1A | 8 Bytes | Data session Key          =
+= 0x22 | 16 Bytes | Data session Key          =
 ==============================================
 * Total of 34 Bytes
 
@@ -170,42 +188,48 @@
 # Nonvolatile Memory Map
 ## Stored by dot firmware
  * 64-bit EUI
- * Network ID
  * DLC
  * ULC
- * Enc keys
-
 
 ## Protocol Parameters
 ==============================================
 = Dot Relative Addr | Size (in Bytes) | Name =
 ==============================================
-= 0x1000 | 2 Bytes | Protocol Flag           =
+= 0x1000 | 02 Bytes | Protocol Flag          =
+==============================================
+= 0x1002 | 02 Bytes | Protocol Rev           =
 ==============================================
-= 0x1002 | 2 Bytes | Protocol Rev            =
+= 0x1004 | 04 Bytes | Reserved for Frequency =
+==============================================
+= 0x1008 | 04 Bytes | Network Address        =
 ==============================================
-= 0x1004 | 2 Bytes | Logical Address Serial  =
+= 0x1010 | 16 Bytes | Network Session Key    =
+==============================================
+= 0x1020 | 16 Bytes | Data Session Key       =
 ==============================================
-= 0x1006 | 4 Bytes | Last Message SeqNum     =
+= 0x1030 | 02 Bytes | Logical Address Serial =
 ==============================================
-Space used is 10 bytes
+= 0x1032 | 04 Bytes | Last Message SeqNum    =
+==============================================
+Space needed is 54 bytes.  Spaced used is 50 bytes
+for better word alignment.
 
 ## IO Baseboard Parameters
 ==============================================
 = Dot Relative Addr | Size (in Bytes) | Name =
 ==============================================
-= 0x2000 | 2 Bytes | Baseboard Flag          =
+= 0x1100 | 2 Bytes | Baseboard Flag          =
 ==============================================
-= 0x2002 | 2 Bytes | Baseboard Rev           =
+= 0x1102 | 2 Bytes | Baseboard Rev           =
 ==============================================
-= 0x2004 | 2 Bytes | Baseboard Serial        =
+= 0x1104 | 2 Bytes | Baseboard Serial        =
 ==============================================
-= 0x2006 | 2 Bytes | Baseboard Configuration =
+= 0x1106 | 2 Bytes | Baseboard Configuration =
 ==============================================
-= 0x2010 | 8 Bytes | PortEx0 64 bit ROM Addr =
+= 0x1110 | 8 Bytes | PortEx0 64 bit ROM Addr =
 ==============================================
-= 0x2018 | 8 Bytes | PortEx1 64 bit ROM Addr =
+= 0x1118 | 8 Bytes | PortEx1 64 bit ROM Addr =
 ==============================================
 
-Space used is 32 bytes
+Space needed is 24 bytes.  Space used is 32 bytes.