Page 43
The /m and /z parameters provide simply-formatted versions of output from the read program that are
convenient for further processing with your own programs.
It is possible to redirect the output of the read program to a file using its /o parameter. In this case, any event
/ error waveforms in the input file are stored to separate waveform files and the report file is annotated with the
waveform filenames. It is not advisable to use the operating system’s redirection mechanism (’>’), because any
waveforms in the input file will be drawn to the screen without a convenient mechanism to match them to a
position in the redirected output file.
9.3.1. Example Output from the read Program
The following brief output from the read program shows the content of a number of 4-byte SpaceWire packets,
together with time-tags of the first byte in each packet and the corresponding end-of-packet token. The data rate
reported, 40.0 Mbits/sec, is the user data rate; this will have been transmitted across SpaceWire at 50.0
Mbits/sec with 2 bits of protocol overhead per byte [the parity bit and the data / control flag].
9.3.2. Plug-ins for the read Program
The usual function of a plug-in is to examine a received packet and, if it is recognised, to interpret it for display.
A plug-in file is provided for the read program to provide interpretation of the SpaceWire RMAP protocol:
ProtocolRxRMAP.class
This plug-in may be invoked using the /p parameter to the read program:
java -jar read.jar <filename> /p RMAP
//-4Links.READ (v16:20111125/v33:20110920) run by test-user on 2011-12-07 11:57:37 Z
(GB)
//- msr-test.msr
//- PC time at start of recording was 2011-12-06 20:24:33
//- NOTE: This may not be the time of the first shown activity.
ss ms us ns� Flow Activity
1511.775 083 132 0s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1511.775 083 932 0s (SOP + 0.800us) ˜40.0 Mb/s
1512.775 227 117 3s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1512.775 227 917 3s (SOP + 0.800us) ˜40.0 Mb/s
1513.775 390 618 7s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1513.775 391 418 7s (SOP + 0.800us) ˜40.0 Mb/s
1514.775 543 714 7s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1514.775 544 514 7s (SOP + 0.800us) ˜40.0 Mb/s
1515.775 687 852 0s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1515.775 688 652 0s (SOP + 0.800us) ˜40.0 Mb/s
1516.775 837 594 7s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1516.775 838 394 7s (SOP + 0.800us) ˜40.0 Mb/s
1517.775 984 288 0s 1-->2 Data @0000 43 44 45 46
1-->2 EOP at 1517.775 985 088 0s (SOP + 0.800us) ˜40.0 Mb/s