Changes between Version 1 and Version 2 of Wave_Server_Protocol_Doc


Ignore:
Timestamp:
01/19/12 21:28:09 (8 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Wave_Server_Protocol_Doc

    v1 v2  
    1212Currently Supported Flags: 
    1313 
    14  -      R - All requested data is right of the tank (after the tank). 
     14-      R - All requested data is right of the tank (after the tank). 
    1515 
    16  -      L - All requested data is left of the tank (before the tank). 
     16-      L - All requested data is left of the tank (before the tank). 
    1717 
    18  -      G - All requested data is in a gap in the tank. 
     18-      G - All requested data is in a gap in the tank. 
    1919 
    20  -      B - The Client's request was bad. It contained incorrect syntax. 
     20-      B - The Client's request was bad. It contained incorrect syntax. 
    2121 
    22  -      C - The tank from which the client requested data is corrupt. (Data may or may not be available for other time intervals in the tank. WARNING! This flag indicates that the tank is corrupt, this means data from other time intervals may be inaccurate) 
     22-      C - The tank from which the client requested data is corrupt. (Data may or may not be available for other time intervals in the tank. WARNING! This flag indicates that the tank is corrupt, this means data from other time intervals may be inaccurate) 
    2323 
    24  -      N - The requested channel(tank) was not found in this wave_server. 
     24-      N - The requested channel(tank) was not found in this wave_server. 
    2525 
    26  -      U - An unknown error occurred. 
     26-      U - An unknown error occurred. 
    2727 
    2828 * <datatype> is two character code ala CSS. Only supports i2, i4, s2, and s4. i for Intel; s for Sparc. 2 meaning two-bytes per integer, 4 ... 
     
    5050 
    5151\n 
    52  
    53   
     52[[BR]] 
     53[[BR]] 
    5454 
    5555'''MENUPIN:''' <request id> <pin#> 
     
    5858 
    5959<request id> <pin#> <s><c><n><l> <starttime> <endtime> <datatype> <\n> 
    60  
    61   
     60[[BR]] 
     61 [[BR]] 
    6262 
    6363'''MENUSCNL:''' <request id> <s><c><n><l> 
     
    6666 
    6767<request id> <pin#> <s><c><n><l> <starttime> <endtime> <datatype> <\n> 
    68  
    69   
     68[[BR]] 
     69[[BR]] 
    7070 
    7171'''GETPIN:''' <request id> <pin#> <starttime> <endtime> <fill-value> 
     
    7878 
    7979<\n> {the samples are ASCII} 
    80  
    81   
     80[[BR]] 
     81[[BR]]  
    8282 
    8383If the requested time is older than anything in the tank, the reply is: <request id> <pin#> <s><c><n><l> FL <datatype> <oldest time in tank> <sampling rate> \n for the case when the requested interval is younger than anything in the tank, the reply is <request id> <pin#> <s><c><n><l> 
    8484 
    8585FR <datatype> <youngest time in tank> <sampling rate> \n 
    86  
    87   
     86[[BR]] 
     87[[BR]]  
    8888 
    8989NOTE: the GETPIN request has never worked in wave_serverV. As pin numbers fade into the distance, it is unlikely that this request will ever be supported. 
     
    9696 
    9797sample(1) sample(2)... sample(nsamples) <\n> 
    98  
    99   
     98[[BR]] 
     99[[BR]] 
    100100 
    101101  
     
    104104 
    105105Returns trace data in the original binary form in which it was put into the tank (as a TRACEBUF2 packet). Whole messages will be supplied, so that the actual starttime may be older than requested, and the end time may be younger than requested. The reply is part ASCII, terminated by a "\n", followed by binary messages: 
    106  
    107   
     106[[BR]] 
     107[[BR]] 
    108108 
    109109<request id> <pin#> <s><c><n><l> F <datatype> <starttime> <endtime> 
     
    112112 
    113113<trace_buf msg> ... <trace_buf msg> 
    114  
    115   
     114[[BR]] 
     115[[BR]]  
    116116 
    117117If the requested time is older than anything in the tank, the reply is: 
    118118 
    119119<request id> <pin#> <s><c><n><l> FL <datatype> <oldest time in tank> <\n> 
    120  
    121   
     120[[BR]] 
     121[[BR]]  
    122122 
    123123For the case when the requested interval is younger than anything in the tank, the reply is: 
    124124 
    125125<request id> <pin#> <s><c><n><l> FR <datatype> <youngest time in tank> <\n> 
    126  
    127   
     126[[BR]][[BR]] 
    128127 
    129128For the case when the requested interval falls completely in a gap, the reply is: