User manual

MAUI Oscilloscopes Remote Control and Automation Manual
WF? Response Compared to the Template
This example uses the result of the WAVEFORM? "WAVEDESC" query to show how the hexadecimal
response to a WAVEFORM? query maps to the WAVEDESC block description in the waveform template
(the response to TMPL?). Each element is numbered by raw byte and by offset, which is how it is identified
in the waveform template (which starts at byte 0), and color keyed to match the ASCII translation.
Hexadecimal ASCII Translation
Bytes Offset Color Contain
0 to 8 pink Simple beginning of a query response, translated into ASCII.
9 to 19 yellow String #9002000348, signaling the beginning of a binary block where nine
ASCII integers are used to give the length of the block (2000348 bytes).
20 to 35 0 light blue Actual beginning of the waveform: 16-character block DESCRIPTOR_NAME
string, in this case WAVEDESC.
36 to 51 16 green TEMPLATE_NAME string, translated to LECROY_2_3.
52 to 53 32 orange COMM_TYPE byte, byte (0) or word (1), in this case byte.
54 to 55 34 magenta COMM_ORDER byte, which gives the order of subsequent bytes in the file, high
byte first (0) or low byte first (1), in this case low first. All subsequent readings
of the file must use the information given by this byte.
56 to 59 36 dark blue Length in bytes of WAVEDESC block.
60 to 63 40 red Length in bytes of USERTEXT block.
64 to 67 44 olive Reserved.
68 to 97 48 grey Length in bytes of forthcoming data BLOCKS and ARRAYS.
96 to 111 76 salmon 16-character INSTRUMENT_NAME string, translated to LECROYWR640Zi.
In this way you can use the waveform template to interpret the WAVEFORM? query readout.
Tip: Be sure to get the waveform template from your oscilloscope using the TMPL? query before
beginning to make the mapping.
5-22