Keysight E4428C ESG RF Programming Manual page 361

Command Syntax
:MEMory:DATA:PRAM:FILE:BLOCk <"file_name">,<blockdata>
The following sections explain how to format the SCPI command for downloading block data:
• Command Syntax Example
• Command Syntax in a Program Routine
Command Syntax Example
This example conceptually describes how to format a block data download command (#ABC represents
the block data):
:MEMory:DATA:PRAM:FILE:BLOCk <"file_name">,#ABC
the file name as it will appear in the signal generator
<"file_name">
# indicates the start of the block data
the number of decimal digits present in B
A
a decimal number specifying the number of data bytes to follow in C
B
C the PRAM file data in bytes
:MEMory:DATA:PRAM:FILE:BLOCk "my_file",#324012%S!4&07#8g*Y9@7...
the PRAM file name as it will appear in the signal generator's WFM1 memory
my_file
catalog
indicates the start of the block data
#
3 B has three decimal digits
240 bytes of data to follow in C
240
12%S!4&07#8g*Y9@7... the ASCII representation of some of the block data (binary data)
downloaded to the signal generator, however not all ASCII values are printable
In actual use, the block data is not part of the command line as shown above, but instead resides in
a binary file on the PC/UNIX. When the program executes the SCPI command, the command line
notifies the signal generator that it is going to receive block data of the stated size, and to place the
file in the signal generator file directory with the indicated name. Immediately following the
command execution, the program downloads the binary file to the signal generator. This is shown in
the following section, "Command Syntax in a Program Routine"
Command Syntax in a Program Routine
This section demonstrates the use of the download SPCI command within the confines of a C++
program routine. The following code sends the SCPI command and downloads a 240 byte PRAM file
to the signal generator's WFM1 (waveform) memory catalog. This program assumes that there is a
char array, databuffer, that contains the 240 bytes of PRAM data and that the variable numbytes
stores the length of the array.
Keysight Signal Generators Programming Guide
Pattern RAM (PRAM) Data Downloads (E4438C and E8267D)
B
file_name A
Creating and Downloading User–Data Files
C
353