User manual

Table Of Contents

Part 6: IEEE 488.2 Command Reference

TRANSFER_FILE, TRFL

Description

This command allows you to transfer files to and from storage media, or between oscilloscope and

computer. The command format is used to transfer files from the computer to storage media. The query

format is used to transfer files from storage media to computer.

Command Syntax

TRANSFER_FILE DISK,<device>,FILE,'<filepath>',#9<nnnnnnnnn><data><crc>

<device>:={HDD, USB, MICRO}

<filepath>:= legal DOS path to file

<nnnnnnnnn>:= file size in bytes (<data> size + <crc> size)

<data>:= file data (arbitrary data block)

<crc>:= reserved for 32-bit CRC plus 8-byte CRC trailer

The path name must be enclosed in single quotes. Use the full path to the directory, including the drive

letter. Be sure there are no spaces before the directory string.

Note: The hard drive selection (HDD) always points to drive D, which is the data drive on MAUI

oscilloscopes. An external USB drive is usually named drive E; check your oscilloscope file system.

The device type MICRO applies only to instruments that utilize Micro-SD card data storage, such

as WaveSurfer 3000.

Note: CRC checking is not performed by the scope, however the 8-byte CRC trailer string is

required when sending a file to the scope, and supplied when receiving a file from the scope. The

ASCII string 'ffffffff' is normally used as trailer string.

Query Syntax

TRFL? DISK,<device>,FILE,'<filepath>'

Response Format

TRFL #9nnnnnnnnn<data><crc>

Example (GPIB)

The following instruction reads the file FAVORITE.DSO from the hard drive:

CMD$=TRFL DISK,HDD,FILE,'FAVORITE.DSO' CALL IBWRT(SCOPE%,CMD$)

Related Commands