summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTeddy <[email protected]>2013-08-22 19:50:32 +0800
committerTeddy <[email protected]>2013-08-22 19:50:32 +0800
commit8ce3ddb36770bf508cccd85e2129e7ab4f428c01 (patch)
tree649302dd4d36897410215a9a37d65c582d4ddcff
parent3a7a46b33cb7654ebb1a3f8f85ae4f0b8de78f88 (diff)
added protocol spec
-rw-r--r--server/ptp.rst101
1 files changed, 101 insertions, 0 deletions
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 |
+ +---------+----------+-----------+
+