Download X-Series Signal Generators Programming Guide

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 335.
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.
Table 6-8
Binary File Type Commands
Command
Type
For
Extraction
Command Syntax
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.
FTPa
put <file_name> /user/bin/file_name
No
extraction
:MEM:DATA "bin:file_name",<block data>
Query
:MEM:DATA? "bin:file_name"
This downloads the file to the signal generator. You cannot extract the file.
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 346.
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
Keysight EXG and MXG X-Series Signal Generators Programming Guide
343