Agilent Technologies N5183A MXG - Manual (Page 310)

300 Agilent N518xA, E8663B, E44x8C, and E82x7D Signal Generators Programming Guide
Creating and Downloading User-Data Files
User File Data (Bit/Binary) Downloads (E4438C and E8267D)
Command Syntax Example
The following command downloads a file that contains 17 bytes:
:MEM:DATA:BIT "new_file",131,#21702%S!4&07#8g*Y9@7
Since this command is file specific (BIT), there is no need to add the file path to the file name.
After execution of this command, the signal generator creates a file in the bit directory (memory
catalog) named “new_file” that contains 27 bytes. Remember that the signal generator adds a
10- byte file header to a bit file. When the signal generator uses this file, it will recognize only 131
of the 136 bits (17 bytes) contained in the file.
For information on downloading block data, see “Downloading User Files” on page 296 .
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 291 . 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 8- 4 .
Query :MEM:DATA:BIT? <"file_name" >
Within the context of a program this query extracts the user file data. Executing the query
in a command window causes it to return the following information:
<bit_count>,<block_data> .
Query :MEM:CAT:BIT?
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">
Table 8-4 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.
Table 8-3 Bit File Type SCPI Commands
Type Command Syntax