Keysight Technologies X-Series, Programming Manual

Page: 339 / 398

Keysight CXG, EXG, and MXG X-Series Signal Generators Programming Guide 339
Creating and Downloading User–Data Files
User File Data (Bit/Binary) Downloads
Commands for Binary File Downloads
To download a user file as a binary file type means that the signal generator,
when the file is selected for use, sees all of the data contained within the file.
For more information on binary files, see “Binary File Type Data” on page 331 .
There are two ways to download the file: to be able to extract the file or not.
Each method uses a different SCPI command, which is shown in Table 6-8 .
File Name Syntax
There are three ways to format the file name, which must also include the file
path:
—
"BIN:file_name"
—
"file_name@BIN"
—
"/user/BIN/file_name"
Command Syntax Example
The following command downloads a file that contains 34 bytes:
:MEM:DATA
"BIN:new_file",#2347^%S!4&07#8g*Y9@7.?:*Ru[+@y3#_^,>l
Table 6-8 Binary File Type Commands
Command
Type
Command Syntax
For
Extraction
SCPI
:MEMory:DATA:UNPRotected "bin:file_name",<datablock>
This downloads the file to the signal generator. You can extract the file within the
context of a program.
FTP
a
put <file_name> /user/bin/file_name
No
extraction
:MEM:DATA "bin:file_name",<block data>
This downloads the file to the signal generator. You cannot extract the file.
Query
:MEM:DATA? "bin:file_name"
This returns information on the named file:
<bit_count>,<block_data>
.
Within the context of a program, this query extracts the user file, provided it was
download with the proper command.
Query
:MEM:CAT:BIN?
This lists all of the files in the bit file directory and shows the remaining non–volatile
memory:
<bytes used by bit files>,<available non-volatile
memory>,<"file_names">
a. See “FTP Procedures” on page 342 .