Configures and makes settings for an external device.
|
SYSTem:CONFigure:EDEVice: | ADD | CAT? | DRIVer | DTYPe | EXISts? | IOConfig | IOENable | LOAD | REMove | SAVE | STATe | TOUT
| SOURce: | DPP | MODulation | CONTrol | :STATe | TMODe | TPORt
|
Click on a red keyword to view the command details.
See Also
Learn about: Configure an External Source
Learn about: Configure a PMAR Device
Example: Configure an External Source
Example: Configure a PMAR Device
SYST:PREF:ITEM:EDEV:DPOL - Determines whether external devices remain activated or are de-activated when the VNA is Preset or when a Instrument State is recalled.
|
Applicable Models: All (Write-only) Adds an external device to the list of configured devices. This is the same as pressing New on the Select an external device dialog. Upon creation, all settings on the new device are set to the defaults. The device is not active until set using SYST:CONF:EDEV:STAT |
|
|
Parameters |
|
|
<name> |
String - Model and type of the external device. To see a list of configured external devices, use SYST:CONF:EDEV:CAT? |
|
Examples |
SYST:CONF:EDEV:ADD "myDevice" system:configure:edevice:add "myDevice" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Read-only) Returns a list of names of all configured devices. These are devices that appear in the external devices dialog. Use SENS:FOM:CAT? to report all active devices. Use Source:CAT? to report all active sources. |
|
|
Parameters |
None |
|
Example |
SYST:CONF:EDEV:CAT? system:configure:edevice:cat |
|
Return Type |
String of comma-separated devices. "Device0:Driver0, Device1:Driver1" |
|
Not applicable |
|
|
Applicable Models: All (Read-Write) Sets and returns the external device driver (model). |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
String - External device driver (model). Choose from the following: "AGPM" for all power meters. "AGPULSEGEN" for supported pulse generators. "DCSource" for all supported DC Sources "DCMeter" for all supported DC Meters |
|
Examples |
SYST:CONF:EDEV:DRIV "myDevice","AGPM" system:configure:edevice:driver "myDevice","AGESG" |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:DRIVer? <name> |
|
Return Type |
String |
|
"AGGeneric" |
|
|
Applicable Models: All (Read-Write) Sets and returns the Device Type for the external device. |
|
|
Parameters |
|
|
<name> |
String - Name of the device to modify. |
|
<type> |
String - Device type - not case sensitive. Choose from: "Source" - external source "Power Meter" - power meter "DC Meter" - DC voltmeter "DC Source" - DC power supply "Pulse Generator" - external pulse generator |
|
Examples |
SYST:CONF:EDEV:DTYP "myDevice","Power Meter" system:configure:edevice:dtype "myDevice","Source" |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:DTYPe? <name> |
|
Return Type |
String |
|
None |
|
|
Applicable Models: All (Read-only) Returns whether the named device is present on the bus for which it is configured. |
|
|
Parameters |
|
|
<string> |
Name of the external device. |
|
Example |
SYST:CONF:EDEV:EXIS? "MyPowerMeter" |
|
Return Type |
Boolean
|
|
Not applicable |
|
|
Applicable Models: All (Read-Write) Sets and return the configuration path for the specified external device. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
String - Configuration path. Any valid VISA resource shown in the IO Configuration field of the external devices dialog, enclosed in quotes. Do NOT use the ID string of a PMAR USB power sensor as the resource string. The ID string is returned by SYST:COMM:USB:PMET:CAT? |
|
Examples |
SYST:CONF:EDEV:IOC "myDevice","GPIB0::13::INSTR" system:configure:edevice:ioconfig "myDevice","GPIB0::13::INSTR" |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:IOConfig? <name> |
|
Return Type |
String |
|
" " Empty String |
|
|
Applicable Models: All (Read-Write) Enable or disable communication with an external device. When disabled (OFF), the VNA will NOT attempt to connect to the external device regardless of the instrument state command (SYST:CONF:EDEV:STATe). Therefore, no errors will be produced if the device is not connected. This command is useful for debugging and testing states when the external device is not connected. This command is unnecessary in ordinary operation (when the device is connected). |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
Boolean - Choose from: OFF or 0 - Device communication disabled ON or 1 - Device communication enabled |
|
Examples |
SYST:CONF:EDEV:IOEN "myDevice", ON system:configure:edevice:ioenable "myDevice", 0 |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:IOENable? <name> |
|
Return Type |
Boolean |
|
ON |
|
|
Applicable Models: All (Write-only) Recalls an external device configuration file from the VNA hard drive. Currently, only DC Supply and DC Meter configuration files are supported. See more DC Device commands. Use SYST:CONF:EDEV:SAVE to save a configuration file. |
|
|
Parameters |
|
|
<file> |
String - Filename of the external device configuration file. |
|
<name> |
String - Name of the external device. Currently, only DC Supply and DC Meter configuration files are supported. |
|
Examples |
SYST:CONF:EDEV:LOAD "myDevice.xml","MyDCMeter" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Write-only) Removes the specified device from the list of configured devices. If the device is a Source and both Active and I/O Enabled is checked (ON), then the RF power state is set to OFF. Learn more. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. Not case sensitive. Use SYST:CONF:EDEV:CAT? to return a list of configured devices. |
|
Examples |
SYST:CONF:EDEV:REM "myDevice" system:configure:edevice:remove "myDevice" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Write-only) Saves an external device configuration file to the VNA hard drive. Currently, only DC Supply and DC Meter configuration files are supported. See more DC Device commands. Use SYST:CONF:EDEV:LOAD to recall a configuration file. |
|
|
Parameters |
|
|
<file> |
String - Filename of the external device configuration file. |
|
<name> |
String - Name of the external device. Currently, only DC Supply and DC Meter configuration files are supported. |
|
Examples |
SYST:CONF:EDEV:SAVE "myDevice.xml","MyDCSupply" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Read-Write) Set and return the state of activation of the device. When SYST:CONF:EDEV:IOEN = ON, and this command is set to ON, the VNA will attempt communication with the external device. Send this command AFTER sending other external device settings (especially SYST:CONF:EDEV:DTYP) to avoid communicating with the device before it has been fully configured. See Also: SYST:PREF:ITEM:EDEV:DPOL - Determines whether external devices remain activated or are de-activated when the VNA is Preset or when a Instrument State is recalled. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<state> |
Boolean - Choose from: OFF or 0 - Device is NOT activated ON or 1 - Device is activated. |
|
Examples |
SYST:CONF:EDEV:STAT "myDevice", ON system:configure:edevice:state "myDevice", 0 |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:STATe? <name> |
|
Return Type |
Boolean |
|
OFF - When configured using the front panel user interface, the device is ON (activated) by default. |
|
|
Applicable Models: All (Read-Write) Set and return the time out value for the specified external device. This is the time allowed for communication with the device before an error is generated. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
Time out value in seconds. |
|
Examples |
SYST:CONF:EDEV:TOUT "myDevice",2 system:configure:edevice:tout "myDevice",5 |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:TOUT? <name> |
|
Return Type |
Numeric |
|
20 |
|
|
Applicable Models: All (Read-Write) Sets and returns the amount of time the VNA should wait after for an external source to settle before making a measurement at each data point. This setting applies to all channels that use this external source. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
Dwell time in seconds. |
|
Examples |
SYST:CONF:EDEV:SOUR:DPP "myDevice",2 system:configure:edevice:source:dpp "myDevice",.1 |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:SOURce:DPP? <name> |
|
Return Type |
Numeric |
|
3.114 e-3 |
|
|
Applicable Models: N522xB, N523xB, N524xB, M937xA, E5080A (Read-Write) Sets and reads the state of the modulation control. Modulation control must be ON to control the modulation of an external source. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<state> |
ON (or 1) Enable control of external modulation. OFF (or 0) Disable control of external modulation. Learn about these settings and about adding an external source. |
|
Examples |
SYST:CONF:EDEV:SOUR:MOD:CONT:STAT "qasmxg",1 system:configure:edevice:source:modulation:control:state "qasmxg",OFF |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:SOURce:MODulation:CONTrol:STATe? "qasmxg" |
|
OFF |
|
|
Applicable Models: All (Read-Write) Sets and returns the trigger mode for an external source. Learn more. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
Trigger Mode. Choose from: CW - Software CW mode HW - Hardware list mode |
|
Examples |
SYST:CONF:EDEV:SOUR:TMOD "myDevice",CW system:configure:edevice:source:tmode "myDevice",hw |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:SOURce:TMODe? "myDevice" |
|
Return Type |
Character |
|
Depends on Source and VNA Model |
|
|
Applicable Models: N522xB, N523xB, N524xB, M937xA, M9485A, E5080A (Read-Write) Sets and returns the VNA port through which an external source is to be triggered. |
|
|
Parameters |
|
|
<name> |
String - Name of the device. |
|
<value> |
Trigger Port. Choose from aux1 or aux2 |
|
Examples |
system:configure:edevice:source:tport "myDevice",aux1 |
|
Query Syntax |
SYSTem:CONFigure:EDEVice:SOURce:TPORt? <name> |
|
Return Type |
Character |
|
aux1 |
|