:MEASure:EYE:USER:CFILe

Meas. mode:
Eye
Waveform type:
NRZ
PAM4
Flex Apps:
FlexDCA
FlexRT

Command Syntax

:MEASure:EYE:USER{1:8}:CFILe <filename>

<filename> is the configuration file (*.xml, *.m, *.py, *.exe).

Description

Defines a user measurement. This command's filename argument specifies either a configuration file (*.xml) or a script file (*.m, *.py, or *.exe) that is used to crate an Eye mode user measurement. Which file type should you use?

  • Configuration File: A configuration file is an XML file (*.xml) that points to the actual script (*.m, *.py, or *.exe). The configuration file allows you to specify your script, label your measurement, initialize unique script variables, or specify dependent FlexDCA measurements. This is the preferred method of defining your user measurement. Refer to Creating the XML File in FlexDCA's User's Help for information on creating a user operator XML file.
  • Script File: You can directly specify a Matlab (*.m) or Python (*.py) or *.exe to define the measurement. This method is simpler to implement but does not provide the advantages available when specifying an XML configuration file.

Use the :MEASure:EYE:USER parent command to turn on the measurement and return the measured value.

To remove a user measurement, use the :MEASure:EYE:USER{1:8}:CFILe:CLEar command.

To create a TDR mode user measurement, use the :MEASure:TDR:USER:CFILe command. To create a Oscilloscope mode user measurement, use the :MEASure:OSCilloscope:USER:CFILe command.

Security Restrictions

Starting with FlexDCA revision A.07.90, file I/O security for user measurements was increased to no longer allow you to specify XML configuration files (*.xml) or script files (*.m, *.py, or *.exe) that are located on a network share drive. These files must reside on a local drive. If you use N1010A FlexDCA on a PC and you use Window's OneDrive, you cannot access XML or script files on OneDrive.

Sending a file name argument that specifies a network share drive results in –258, Media protected. error code.

Requires FlexDCA revision A.05.00 and above. FlexDCA revision A.07.90 increases file I/O security.