From 8ce3ddb36770bf508cccd85e2129e7ab4f428c01 Mon Sep 17 00:00:00 2001
From: Teddy <ted.sybil@gmail.com>
Date: Thu, 22 Aug 2013 19:50:32 +0800
Subject: added protocol spec

---
 server/ptp.rst | 101 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 server/ptp.rst

diff --git a/server/ptp.rst b/server/ptp.rst
new file mode 100644
index 0000000..93f03ea
--- /dev/null
+++ b/server/ptp.rst
@@ -0,0 +1,101 @@
+Piztor Transmission Protocol v0.1
+---------------------------------
+
+- General 
+
+  - Request
+
+    ::
+    
+        +---1b---+-------?b--------+
+        | OPT ID |  SPECIFIC DATA  |
+        +--------+-----------------+
+
+  - Response
+
+    ::
+    
+        +---1b---+------?b---------+
+        | OPT ID |  SPECIFIC DATA  |
+        +--------+-----------------+
+
+- Authentication 
+
+  - Request
+
+    :: 
+
+        +--1b--+-----?b------+-----?b-----+
+        | 0x00 |   USERNAME  |  PASSWORD  |
+        +------+-------------+------------+
+
+  - Response
+
+    ::
+    
+       +--1b--+-----4b-----+
+       | 0x00 | USER_TOKEN |
+       +------+------------+
+
+- Message Sending 
+
+  - Request
+
+    ::
+    
+        +--1b--+------4b------+------4b-----+
+        | 0x01 | SENDER_TOKEN | RECEIVER_ID |
+        +------+--------------+-------------+
+
+  - Response
+        
+    ::
+
+        +--1b--+----?b----+
+        | 0x01 | RESERVED |
+        +------+----------+
+
+- Location Update
+
+  - Request
+
+    ::
+    
+        +--1b--+------4b------+-----8b-----+------8b-----+
+        | 0x02 | SENDER_TOKEN |  LATITUDE  |  LONGITUDE  |
+        +------+--------------+------------+-------------+
+
+  - Response
+
+    ::
+
+        +--1b--+----?b----+
+        | 0x02 | RESERVED |
+        +------+----------+
+
+- Location Information
+
+  - Request
+
+    ::
+    
+        +--2b--+-----4b-------+------4b-----+
+        | 0x03 | SENDER_TOKEN |  GROUP_ID   |
+        +------+--------------+-------------+
+
+  - Response
+
+    ::
+
+        +--2b--+-----20b--------+-----+
+        | 0x03 | LOCATION_ENTRY | ... |
+        +------+----------------+-----+
+        
+    Location Entry:
+
+    :: 
+
+        +---4b----+----8b----+-----8b----+
+        | USER_ID | LATITUDE | LONGITUDE |
+        +---------+----------+-----------+
+
-- 
cgit v1.2.3