Agilent Technologies Infiniium 8000A, Programmer'S Reference Manual

Page: 854 / 934

30-32
Waveform Commands
DATA? Example for Digital Channels
/******************************************************************************
* Function name: SetupDataTransfer
* Parameters: double lTime which is the time value of the first
* waveform memory location of data.
* double rTime which is the time value of the last
* waveform memory location of data.
* Return value: Number of bytes of waveform data to read.
* Description: This routine sets up the waveform data transfer and gets
* the number of bytes to be read. The beginning of data
* starts with the # character followed by a number which
* tells how many bytes to read for the integer which is the
* total number of data bytes that are being transfered.
* Following this is the waveform data. For example, if 1024
* bytes of waveform data is being transfered then this
* information will be as follows:
* #41024 <1024 data bytes>
********************************************************************************
********/
unsigned long SetupDataTransfer( double lTime, double rTime )
{
unsigned long BytesToRead;
char header_str[8];
char cData;
unsigned long BytesRead;
int Size;
char Range[100];
/* Find the index value of the first data memory location */
Start = Round((lTime - xOrg)/xInc);
if (Start < 1) {
Start = 1;
}
/* Find the number of data bytes that you want */
Size = Round((rTime - lTime)/xInc);
sprintf( Range, ":WAVeform:DATA? %d,%d", Start, Size);
WriteIO( Range ); /* Request waveform data */
/* Find the # character */
do {
ReadByte( &cData, 1L );
} while ( cData != '#' );