summaryrefslogtreecommitdiff
path: root/server/ptp.rst
blob: bf74d1096e3ba1db34ea763cf434f7e126ec3171 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
Piztor Transmission Protocol v0.1
---------------------------------

- General 

  - Request

    ::
    
        +---1b---+-------?b--------+
        | OPT ID |  SPECIFIC DATA  |
        +-uchar--+-----------------+

  - Response

    ::
    
        +---1b---+------?b---------+
        | OPT ID |  SPECIFIC DATA  |
        +-uchar--+-----------------+

- Authentication 

  - Request

    :: 

        +--1b---+-----?b------+-----?b-----+
        | 0x00  |   USERNAME  |  PASSWORD  |
        +-uchar-+-------------+------------+

  - Response

    ::
    
       +--1b---+-----4b-----+
       | 0x00  | USER_TOKEN |
       +-uchar-+----uint----+

- Message Sending 

  - Request

    ::
    
        +--1b---+------4b------+------4b-----+
        | 0x01  | SENDER_TOKEN | RECEIVER_ID |
        +-uchar-+-----uint-----+----uint-----+

  - Response
        
    ::

        +--1b---+----?b----+
        | 0x01  | RESERVED |
        +-uchar-+----------+

- Location Update

  - Request

    ::
    
        +--1b---+------4b------+-----8b-----+------8b-----+
        | 0x02  | SENDER_TOKEN |  LATITUDE  |  LONGITUDE  |
        +-uchar-+-----uint-----+---double---+---double----+

  - Response

    ::

        +--1b---+----?b----+
        | 0x02  | RESERVED |
        +-uchar-+----------+

- Location Information

  - Request

    ::
    
        +--1b---+-----4b-------+------4b-----+
        | 0x03  | SENDER_TOKEN |  GROUP_ID   |
        +-uchar-+----uint------+----uint-----+

  - Response

    ::

        +--1b---+-----20b--------+-----+
        | 0x03  | LOCATION_ENTRY | ... |
        +-uchar-+----------------+-----+
        
    Location Entry:

    :: 

        +---4b----+----8b----+-----8b----+
        | USER_ID | LATITUDE | LONGITUDE |
        +--uint---+--double--+--double---+