Used Memory

This command returns the total memory available on the instrument, the free memory, and the memory used by the backend process in kB.

If the instrument runs into an error while retrieving system memory data, "nan,nan,nan" will be returned as the response and a "-100" (SCPI command error) will be placed in the SCPI error queue.

List Active Applications

This command queries all active applications. The response is returned as a comma delimited list of application names. The application names are the same as those returned by the INSTrument:CATalog:FULL? query or used as parameters to the INSTrument:SELect command.

If no applications are currently active, this query will return NONE.

Query Available Applications

This query returns a list of string - number pairs. The string contains the name of the available application. The immediately following NR1-formatted number is its associated application number. All response data elements are comma separated.

If no application is available, a null string followed by a zero is returned.

Memory Catalog Directory

Returns the non-recursive contents of the memory specified by the MSUS and DIRECTORY parameters. Both parameters are case sensitive.

Parameter 1: Directory. Use "/" as a directory separator. Note that this parameter should NOT be an empty string. To access the root directory, pass in "/" as the first parameter.

Parameter 2: MSUS (Use :MMEMory:CATalog:MSUSs query command to retrieve the list of available storage devices).

For example:

MMEMory:CATalog:DIRectory? "/", "USB0"

The response is formatted as follows: <total space used on MSUS>,<total space available on MSUS>,{<file entry1>},..{<file entryN>} where <file entry> is: <file or directory name>,<file type>,<file size>

<string>,<string>

Memory Catalog Msuss

Returns a list of all available mass storage devices present, formatted as follows: <Device Name 1>,<Device Name 2>,...<Device Name N>

For example, sending:

MMEMory:CATalog:MSUSs?

could return:

Internal,USB0

Default Mass Storage Directory

This command selects the default directory on the default mass storage device (see :MMEMory:MSIS) for use with MMEMory commands. The parameter is case sensitive. Use "/" as a directory separator.

For example:

MMEMory:CDIRectory "/example_folder"

The set command will fail and an error is reported if the requested directory does not exist. Note that the query command returns the name of the default directory that was previously set and the device does not check whether the directory is still present.

<string>

Copy File

This command copies the specified source file into a new file located at the specified destination location. Four parameters are required for this command:

1. Source File Location: The file path to the file to be copied.

2. Source MSUS: The mass storage device the file is located in (i.e. Internal).

3. Destination File Location: The destination file path that the file should be copied to.

4. Destination MSUS: The mass storage device that the destination file should be written to (i.e. Internal).

For example:

MMEMory:COPY "/example_file.ext", "Internal", "/example_file.ext", "USB0"

Please note that if a file already exists at the destination location or if the source file does not exist, the command will fail to execute and add an execution error into the SCPI error queue. This command will only copy files. If a directory path is passed in as a parameter, the command will fail to execute.

<string>,<string>,<string>,<string>

Create Directory

Creates a directory at the specified mass storage device. Both parameters are case sensitive.

Parameter 1: Directory. Use "/" as a directory separator.

Parameter 2: MSUS (Use :MMEMory:CATalog:MSUSs query command to retrieve the list of available storage devices)

For example:

MMEMory:CREate:DIRectory "/example_folder", "USB0"

If the intermediate directories in the path don't exist, the command will automatically create them. Common causes of the command failure are:

- The MSUS device is not present (Use :MMEMory:CATalog:MSUSs query command to retrieve the list of available storage devices)

- The total space available on MSUS device is not big enough (Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on MSUS)

<string>,<string>

File Transfer

This command imports/exports a file to/from the instrument. Data is transferred to/from the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.

This set command takes three parameters:

1. File Path: The path of the file to be written

2. Msus: The mass storage device to write the file to

3. Block Data: The data to be written to the instrument in block data format

If any directories in the file path do not exist, the instrument will automatically create the required directories. Please note that the maximum file transfer size to the instrument is 25 MB.

The ASCII header specifies the number of data bytes of the file. It looks like #AX, where A is the number of digits in X and X is the number of bytes in the <block>. The first character is the literal ascii hash '#' 043. The second character (A) is a single ascii digit '1' to '9' describing the number of bytes in the length section (X). This number is called nlength. The next nlength bytes make up an ascii string of digits '1' to '9' describing the length of the <block> data.

For example, if the first 6 bytes are #49999, then the nlength is 4. The 4 bytes of length are 9999. After that follows the <block>, which would be 9999 bytes in size.

The query command takes two parameters.

1. File Path: The path to the file to be retrieved.

2. Msus: The mass storage device to retrieve the file from.

The file is returned in block data format with an ASCII header The query command will return a #10 if the file cannot be found.

<string>,<string>,<block data>

<string>,<string>

Delete Directory

Deletes the specified directory and all its content at the specified mass storage device. The two parameters for this command are directory name and mass storage device. Both parameters are case sensitive. Use "/" as a directory separator. To delete the root folder in a specified mass storage device, enter "/" for directory name parameter.

For example:

MMEMory:DELete:DIRectory "/example_folder", "USB0"

The available mass storage devices can be retrieved by using the :MMEMory:CATalog:MSUSs command. The command will fail if the directory doesn't exist or the mass storage device is not present.

<string>,<string>

Delete File

Deletes the specified file at the specified mass storage device. The two parameters for this command are file name with relative path and mass storage device. Both parameters are case sensitive. Use "/" as a directory separator.

For example:

MMEMory:DELete:FILe "/example_folder/example_file.ext", "USB0"

The available mass storage devices can be retrieved by the :MMEMory:CATalog:MSUSs command. The command will fail if the file doesn't exist or the mass storage device is not present.

<string>,<string>

Load State

This command recalls the specified setup. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive.

Parameters:

1. Numeric Value: currently unused. Send a 0.

2. File path: The file path (including file name) relative to the MSUS root directory. File extension is optional.

3. MSUS: Device to recall the file from. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.

For example:

MMEMory:LOAD:STATe 0,"/example_setup_file", "Internal"

The model of the device that the setup was created in must match the model of the device to recall in; otherwise, the recall will be rejected. The options of the device that the setup was created in must be enabled in the device to recall in; otherwise, the recall will be rejected.

<numeric_value>,<string>,<string>

Load Trace

This command recalls the specified measurement and setup. After recall all traces will have update state turned off, but sweeping will continue with the recalled setup. This means that traces will retain the recalled measurement data until the trace update state is turned on. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive.

Parameters:

1. Label: Used to specify which trace to recall. Currently, the label only supports recalling all traces. Send an empty string or "ALL" to load all traces.

2. File path: The file path (including file name) relative to the MSUS root directory. File extension is optional.

3. MSUS: Device to recall the file from. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.

For example:

MMEMory:LOAD:TRACe "ALL", "/example_measurement_file", "Internal"

The model of the device that the measurement was saved in must match the model of the device to recall in; otherwise, the recall will be rejected. The options of the device that the measurement was saved in must be enabled in the device to recall in; otherwise, the recall will be rejected.\

<string>,<string>,<string>

Default Mass Storage Device

This command selects the default device for use with MMEMory commands. The mass storage device parameter is case sensitive and must match a device returned from the :MMEMory:CATalog:MSUSs? command

For example:

MMEMory:MSIS "Internal"

<string>

Store State

This command saves the current setup to the specified file location. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive. If a file with the resolved name already exists, it will be overwritten.

Parameters:

1. Numeric Value: currently unused. Send a 0.

2. File path: The file path (including file name) relative to the MSUS root directory. File extension should not be specified.

3. MSUS: Device to save the file on. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.

For example:

MMEMory:STORe:STATe 0,"/example_setup_file", "Internal"

A common cause of the command failure is not having enough space available on MSUS to save the setup. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on MSUS.

<numeric_value>,<string>,<string>

Store Trace

This command saves the current measurement data along with the current setup to the specified file location. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive. Parameters:

1. Label: Used to specify which trace to save. Currently, the label only supports saving all traces. Send an empty string or "ALL" to store all traces.

2. File path: The file path (including file name) relative to the MSUS root directory. File extension should not be specified.

3. MSUS: Device to save the file on. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.

For example:

MMEMory:STORe:TRACe "ALL", "/example_measurement_file", "Internal"

A common cause of the command failure is not having enough space available on MSUS to save trace. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on MSUS.

<string>,<string>,<string>

Current LAN Configuration

This command queries the current ethernet configuration of the device.

System Date

This command sets and queries the system's internal calendar. Changing the system date does not affect the system time zone (if time zone is available). The three parameters for this command are <year>,<month> and <day>. The query response message shall consist of three fields separated by commas: <year>,<month>,<day>.

The year shall be entered as a four-digit number, including century and millennium information. This shall not be affected by a *RST command. Note: Some products only support the query version of this command.

<numeric_value>,<numeric_value>,<numeric_value>

Factory Default Reset

This command presets parameters in all applications as well as system settings with the exception of ethernet settings (DHCP On/Off, static IP, Static Gateway, Static Subnet) to their factory default values. Last saved settings will be deleted.

Master Default Reset

This command presets parameters in all applications as well as system settings with the exception of ethernet settings (DHCP On/Off, static IP, Static Gateway, Static Subnet) to default values. Last saved settings, log files, and user files will all be deleted.

System Error Queue

If an error occurs, the error number and message are placed in the error queue, which can be read by this query command. Errors are cleared by reading them. Error code 0, is "No error". Error codes from -100 to -199 belongs to the Command error category and sets bit 5 of the standard ESR register. Error codes from -200 to -299 belongs to the Command error category and sets bit 4 of the standard ESR register. Error codes from -400 to -499 belongs to the Query error category and sets bit 2 of the standard ESR register. Error codes from -300 to -399 and 1 to 32767 belongs to the Device-specific error and sets bit 3 of the standard ESR register.

Negative error numbers (command error, execution error, device-dependent error,query error) are standard SCPI errors. Positive error numbers are device specific errors, not standard SCPI errors. The error queue is also cleared by *CLS, *RST, and when power is turned on.

If more errors have occurred than can fit in the buffer, the last error stored in the queue (the most recent error) is replaced with -350, Queue overflow. No additional errors are stored until removing errors from the queue. If no errors have occurred when reading the error queue, the instrument responds with 0, No error.

Firmware Version

This command queries the device firmware version.

System Error Log

This command retrieves the error log. The log is encrypted and can be saved to a file and sent to Anritsu Service if required.

Query Options

This command retrieves the options that are currently set. The response is returned in "/" delimited form.

Option Configuration

This command returns a quoted string of characters readable only by Anritsu Customer Service. Only instrument configuration information is returned. No setup information is included.

Option Upgrade

This command upgrades the options of the device with a valid license key provided as a quoted string parameter. The device must be reboot immediately after this command for the installation of the new options to complete. The device must not be powered off while the command is executing. The recommended way to restart the device safely is sending the *RST command after this command.

This command might report the following error code: -200 : The command failed to complete. Detailed eror message will be provided in the response of :SYStem:ERRor[:NEXT]? command.

<string>

Preset

This command presets parameters in the current application to their factory default values.

System Time

This command sets and queries the system's internal clock. Changing the system time does not affect the system time zone (if time zone is available). The three parameters for this command are <hour>,<minute> and <second>. The query response message shall consist of three fields separated by commas: <hour>,<minute>,<second>. Note: Some products only support the query version of this command.

<numeric_value>,<numeric_value>,<numeric_value>