Command For Bit File Downloads - Keysight E4428C ESG RF Programming Manual

Line Code Description—Download User File Data
9 Send the terminating carriage (\n) as the last byte of the waveform data.
•
iwrite() writes the data "\n" to the signal generator (session identifier specified in id).
•
The third argument of iwrite(), 1, sends one byte to the signal generator.
•
The fourth argument of iwrite(), 1, is the END of file indicator, which the program uses to
terminate the data download.
To verify the user file data download, see
"Commands for Binary File Downloads" on page 336

Command for Bit File Downloads

Because the signal generator adds a 10–byte file header during a bit file download, you must use the
SCPI command shown in Table 6-7. If you FTP or copy the file for the initial download, the signal
generator does not add the 10–byte file header, and it does recognize the data in the file (no data in
the transmitted signal).
Bit files enable you to control how many bits in the file the signal generator modulates onto the
signal. Even with this file type, the signal generator requires that all data be contained within bytes.
For more information on bit files, see "Bit File Type Data" on page 324.
Table 6-7 Bit File Type SCPI Commands
Type Command Syntax
Command
:MEM:DATA:BIT <"file_name">,<bit_count>,<block_data>
This downloads the file to the signal generator.
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">
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
Keysight Signal Generators Programming Guide
Creating and Downloading User–Data Files
User File Data (Bit/Binary) Downloads (E4438C and E8267D)
"Command for Bit File Downloads" on page 335
.
and
335