Cmd_query_osci_screen, Cmd_query_osci_screen_ex – GBS Elektronik MCA-527 Firmware Commands User Manual
Page 51

Description of the MCA527 Firmware Commands
Name
CMD_QUERY_OSCI_SCREEN
Compatibility
New MCA527 command.
Execution right
Necessary if the resolution index that is set with CMD_SET_OSCI_TRIGGER is larger than 0.
Description
The command reads the data for the oscilloscope screen.
p:
-1 or the previously returned position
Format
integer
integer
long
integer
integer
Parameter
Preamble
command
p
0
end flag
Byte string (HEX)
A5
5A
12
01
p
l
...
...
p
h
00
00
B9
9B
Result data array
Byte offset 0
Start position of the received data
unsigned long
Byte offset 4
Start position of the subsequent data
unsigned long
Byte offset 8
Data
unsigned short [500]
Byte offset 1008
Command flag and parameters
8 bytes
Byte offset 1016
Checksum
unsigned short
Remarks
The oscilloscope mode is described in document: “MCA527 Oscilloscope Mode”.
Name
CMD_QUERY_OSCI_SCREEN_EX
Compatibility
New MCA527 command.
Execution right
Necessary if flags are set.
Description
The command reads the data for the oscilloscope screen.
Flags:
Bit 0:
convolve data with trigger filter
Bit 1:
convolve data with main filter
Format
integer
integer
integer
integer
integer
integer
Parameter
Preamble
command
flags
0
0
end flag
Byte string (HEX)
A5
5A
29
01
flags
l
flags
h
00
00
00
00
B9
9B
Result data array
Byte offset 0
Start position of the received data
unsigned long
Byte offset 4
Data
unsigned short [720]
Byte offset 1404
Command flag and parameters
8 bytes
Byte offset 1412
Checksum
unsigned short
Remarks
This command has been added to extend the features of the oscilloscope. Corresponding to the
flags, the MCA527 convolves the data with the corresponding filters. The results can be
subsequently read with the commands CMD_QUERY_OSCI_TRIGGER_FILTER_RESULTS and
CMD_QUERY_OSCI_MAIN_FILTER_RESULTS.
The command is only usable if the resolution index that is set with CMD_SET_OSCI_TRIGGER is
not larger than 0.
The oscilloscope mode is described in document: “MCA527 Oscilloscope Mode”.
51