Instructions

ManualsBrandsTeledyne LeCroy ManualsLaboratory EquipmentTeledyne LeCroy T3VNA3200 Spectrum analyzer Tracking generator, Spectrum analyzer

Programming Guide

T3VNA1500 Vector Network Analyzer

Summary of content (82 pages)

PAGE 1
Programming Guide T3VNA1500 Vector Network Analyzer
PAGE 2
Contents 1. Programming Overview ............................................................3 1.1 Remotely Operating the Analyzer .......................................................... 3 1.2 Build Communication ............................................................................. 5 1.3 Remote Control Capabilities .................................................................. 8 2. SCPI Overview.........................................................................12 2.
PAGE 3
1. Programming Overview The Teledyne Test Tools T3VNA series vector network analyzers features LAN and USB Device interfaces. By using a computer with these interfaces, and a suitable programming language (and/or NI-VISA software), users can remotely control the analyzer based on SCPI (Standard Commands for Programmable Instruments) command set, Labview and IVI (Interchangeable Virtual Instrument), to interoperate with other programmable instruments.
PAGE 4
Figure 1-2 LAN 3.Switch on the analyzer 4.Press button on the front panel System →Interface→LAN to enter the LAN Config function menu. 5.Select the IP Config between Static and DHCP �DHCP: the DHCP server in the current network will assign the network parameters automatically (IP address, subnet mask, gate way) for the analyzer. �Static: you can set the IP address, subnet mask, gate way manually. Press Apply.
PAGE 5
1.2 Build Communication 1.2.1 Build Communication Using VISA NI-VISA includes a Run-Time Engine version and a Full version. The Run-Time Engine version provides NI device drivers such as USB-TMC, VXI, etc. The full version includes the Run-Time Engine and a software tool called NI MAX that provides a user interface to control the device. You can get NI-VISA full version from: http://www.ni.com/download/. After downloading follow the steps below to install it: a.Double click the visa_full.
PAGE 6
Set the install path, default path is “C:\Program Files\National Instruments\”, you can change it. Click Next, dialog shown as above. d.Click Next twice, in the License Agreement dialog, select the “ I accept the above 2 License Agreement(s).” ,and click Next, dialog shown as below: e.Click Next to run installation.
PAGE 7
Now the installation is complete, reboot your PC. 1.2.2 Build Communication Using Sockets/Telnet Through the LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with the vector network analyzer. VXI-11 is provided in NI-VISA, while Sockets and Telnet are commonly included in PC’s OS initially. Socket LAN is a method used to communicate with the vector network analyzer over the LAN interface using the Transmission Control Protocol/Internet Protocol (TCP/IP).
PAGE 8
1.3 Remote Control Capabilities 1.3.1 User-defined Programming Users can use SCPI commands to program and control the vector network analyzer. For details, refer to the introductions in “Programming Examples”. 1.3.2 Send SCPI Commands via NI MAX Users can control the vector network analyzer remotely by sending SCPI commands via NIMAX software. NI_MAX is National Instruments Measurement and Automation Explorer.
PAGE 9
Run NI MAX software. 1.Click “Device and interface” at the upper left corner of the software; 2.Find the “Network Devices” symbol , click “Add Network Devices”; 3.Select Manual Entry of LAN instrument, select Next, and enter the IP address as shown. Click Finish to establish the connection: NOTE: Leave the LAN Device Name BLANK or the connection will fail. 4.
PAGE 10
T3VNA1500 TCPIP0::192.168.... 192.168.55.109 192.168.55.109 T3V30XC315... T3VNA1500 “TCPIP0::192.168.55.109::inst0::INSTR” 5.Right-click on the product and select Open NI-VISA Test Panel: T3VNA1500 T3V30XC315... T3VNA1500 “TCPIP0::192.168.55.109::inst0::INSTR” 6.Click “Input/Output” option button and click “Query” option button. If everything is OK, you will see the Read operation information returned as shown below. Teledyne, T3VNA1500, T3V3XBCJC1025, 1.2.8.2\n 1.3.
PAGE 11
1.3.4 Web Control With the embedded web server, the analyzer can be controlled through LAN from a web browser* on PC and mobile terminals, without any extra driver be installed. This provides remote controlling and monitoring capabilities. Screenshot and firmware update are also supported. *Web browser with HTML5 supported such as Google Chrome or Firefox are recommended.
PAGE 12
2. SCPI Overview 2.1 Command Format SCPI commands present a hierarchical tree structure containing multiple subsystems, each of the subsystems is made up of a root keyword and several subkeywords. The command string usually starts with “:”, the keywords are separated by “:” and the followed parameter settings are separated by space. Query commands add “?” at the end of the string.
PAGE 13
In the “[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1” command, the parameters available are “OFF”, “ON”, “0” or “1”. 4.Braces { } The parameters in the braces are optional which can be ignored or set for one or more times. For example： :CALCulate:LLINe[1]|2:DATA ,{,, }, in the command, the {,, } parameters can be ignored or set for one or more times. 2.
PAGE 14
6.Discrete The parameter could only be one of the specified values and these values are discontinuous. For example: [:SENSe]:BWIDth:VIDeo:RATio The parameter could only be one of 0.001, 0.003, 0.01, 0.03, 0.1, 0.3, 1.0, 3.0, 10.0, 30.0, 100.0, 300.0, 1000.0. 2.4 Command Abbreviation The commands are not case sensitive, so you can use any of them. But if abbreviation is used, all the capital letters in the command must be written completely.
PAGE 15
3. System Commands This chapter introduces the Teledyne Test Tools T3VNA SCPI commands, include: IEEE Common Commands 3.1 System Subsystem 3.2 Instrument Subsystem 3.3 Initiate Subsystem 3.4 Sense Subsystem 3.5 Calculate Subsystem 3.6 Measurement Subsystem 3.7 Trigger Subsystem 3.8 TG Subsystem 3.9 Demod Subsystem 3.10 Memory Subsystem 3.11 3.1 IEEE Common Commands 3.1.1 Command Format Instruction Menu Example 3.1.2 Command Format Instruction Menu Example 3.1.
PAGE 16
Menu Example 3.1.4 Command Format Instruction Menu Example 3.1.5 Command Format Instruction Menu Example 3.1.6 Command Format Instruction Menu Example 3.1.7 Command Format Instruction Menu Example clearing all bits in all of the event registers. The status byte register summarizes the states of the other registers. It is also responsible for generating service requests. None *CLS Standard Event Status Enable (*ESE) *ESE *ESE? Set the bits in the standard event status enable register.
PAGE 17
3.1.8 Command Format Instruction Menu Example 3.1.9 Command Format Instruction Menu Example Status Byte Query (*STB) *STB This query is used by some instruments for a self test. None *STB Wait-to-Continue (*WAI) *WAI This command causes the instrument to wait until all pending commands are completed before executing any additional commands. There is no query form to the command. None *WAI 3.1.
PAGE 18
Parameter Type Parameter Range Return Default Menu Example String year(four digits), month(1~12), date(1~31) String None System > date&time Sets System date: :SYSTem:DATE 20050101 Gets System date: :SYSTem:DATE? 3.2.3 IP Address (:SYSTem:COMMunicate:LAN:IPADdress) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.4 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.
PAGE 19
Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.6 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.7 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.2.8 Command Format :SYSTem:COMMunicate:LAN:CONFig:APPLy :SYSTem:COMMunicate:LAN:SMASk? Sets the subnet mask according to the PC network Settings. The subnet mask will be set automatically if the IP assignment is set to DHCP.
PAGE 20
Instruction Parameter Type Parameter Range Return Default Menu Example Uses command to set analyzer to power on in default, user, or last state. Gets power on type. Enumeration DFT: Default LAST: Last USER: Custom Configuration Enumeration DFT System > Pwr/Preset > Power On SYSTem:PON:TYPE DFT 3.2.9 System Preset (:SYSTem:PRESet) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:PRESet Use this command to preset the instrument.
PAGE 21
Menu Example System > Pwr/Preset > Preset :SYSTem:PRESet:TYPE DFT 3.2.12 Factory ReSet (:SYSTem:FDEFault) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:FDEFault Sets both the measure and setting parameters to factory preset parameters. None None None None System > Pwr/Preset > Factory Reset :SYSTem:FDEFault 3.2.
PAGE 22
Range Return Default Menu Example None None None None :SYSTem:POWer:OFF 3.2.16 System Info (:SYSTem:CONFigure:SYSTem?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :SYSTem:CONFigure:SYSTem? Use this command to query the system message of the instrument. None None String None System > System Info :SYSTem:CONFigure:SYSTem? 3.3 Instrument Subsystem 3.3.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.3.
PAGE 23
Return Default Menu Example SPECtrogram: Spectrogram Monitor TOI: Third-order Intercept Point Enumeration OFF Measure :INSTrument:MEASure ACPR 3.4 Initiate Subsystem 3.4.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example Single Sweep (:INITiate[:IMMediate]) :INITiate[:IMMediate] Sets single sweep. None None None None Sweep > Single :INITiate:IMMediate 3.4.
PAGE 24
Parameter Type Parameter Range Return Default Menu Example Gets the center frequency. Float, unit: Hz, KHz, MHz, GHz 50 Hz~1.499999950 GHz Zero Span: 0~1.5 GHz Float, unit: Hz 750 MHz Frequency > Center Frequency :FREQuency:CENTer 0.2 GHz 3.5.1.2 Start Frequency ([:SENSe]:FREQuency:STARt) Command Format Instruction analyzer.
PAGE 25
Default Menu Example 150 MHz Frequency > Freq Step :FREQuency:CENTer:STEP 2 MHz 3.5.1.5 Center Frequency Step Mode ([:SENSe]:FREQuency:CENTer:STEP:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Specifies whether the step size is set automatically based on the span. Gets center frequency step mode.
PAGE 26
3.5.1.8 Full Span ([:SENSe]:FREQuency:SPAN:FULL) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:SPAN:FULL Sets the frequency span to full scale. None None None None Span > Full Span :FREQuency:SPAN:FULL 3.5.1.9 Zero Span ([:SENSe]:FREQuency:SPAN:ZERO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:FREQuency:SPAN:ZERO Sets the frequency span to zero span.
PAGE 27
Default Menu Example None Span> Zoom In :FREQuency:SPAN:HALF 3.5.1.12 Zoom Out ([:SENSe]:FREQuency:SPAN:DOUBle) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.2 [:SENSe]:FREQuency:SPAN:DOUBle Sets the frequency span to double the previous span setting. None None None None Span> Zoom Out :FREQuency:SPAN:DOUBle Auto Tune Subsection 3.5.2.1 Auto Tune ([:SENSe]:FREQuency:TUNE:IMMediate) Command Format Instruction signal.
PAGE 28
Return Default Menu Example Float, unit: dBm 0 dBm Amplitude > Ref Level :DISPlay:WINDow:TRACe:Y:RLEVel 20 DBM 3.5.3.2 Input Attenuator ([:SENSe]:POWer[:RF]:ATTenuation) Command Format Instruction analyzer. Parameter Type Parameter Range Return Default Menu Example [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation? Sets the input attenuator of the vector network Gets the input attenuator. Integer 0 dB ~ 31 dB Integer, unit: dB 20 dB Amplitude > Attenuator :POWer:ATTenuation 10 3.5.
PAGE 29
3.5.3.5 Amplitude OffSets (:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet ) Command Format Instruction :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet? Sets reference offsets. Gets reference offsets. Parameter Type Parameter Range Return Default Menu Example Float -300dB~300dB Float, unit: dB 0dB Amplitude > Ref OffSets :DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2 3.5.3.
PAGE 30
Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? This command sets the per-division display scaling for the y-axis when scale type of Y axis is set to Log. Gets Scale/Div when scale type of Y axis is set to Log. Float 1 dB ~ 10 dB Float, unit: dB 10 dB Amplitude > Scale/Div :DISPlay:WINDow:TRACe:Y:PDIVision 10 dB 3.5.3.
PAGE 31
Parameter Type Parameter Range Return Default Menu Example Gets the amplitude correction function state. None None 0|1 OFF Amplitude > Corrections > Correction1|2|3|4 :CORRection:CSET2:OFF 3.5.3.12 Set Correction Data ([:SENSe]:CORRection:CSET[1]|2|3|4:DATA) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:CORRection:CSET[1]|2|3|4:DATA [:SENSe]:CORRection:CSET[1]|2|3|4:DATA? Set correction X data 1|2|3|4 Read correction X data.
PAGE 32
Parameter Type Parameter Range Return Default Menu Example Discrete 1Hz, 3Hz, 10 Hz, 30 Hz, 100 Hz, 300 Hz, 1 KHz, 3 KHz, 10 KHz, 30 KHz, 100 KHz, 300 KHz, 1 MHz Float, unit: Hz 1 MHz BW > RBW :BWIDth 1 KHz 3.5.4.2 Resolution Bandwidth Auto Mode ([:SENSe]:BWIDth[:RESolution]:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:BWIDth[:RESolution]:AUTO? Turns on/off auto resolution bandwidth state.
PAGE 33
3.5.4.5 Video to Resolution Bandwidth Ratio ([:SENSe]:BWIDth:VIDeo:RATio) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:BWIDth:VIDeo:RATio [:SENSe]:BWIDth:VIDeo:RATio? Specifies the ratio of the video bandwidth to the resolution bandwidth. Discrete, Float 0.001, 0.003, 0.01, 0.03, 0.1, 0.3, 1.0, 3.0, 10.0, 30.0, 100.0, 300.0, 1000.0 Float 1.0 BW > VBW/RBW :BWIDth:VIDeo:RATio 30 3.5.4.
PAGE 34
Instruction Parameter Type Parameter Range Return Default Menu Example Selects the display mode for the selected trace. Enumeration WRITe: puts the trace in the normal mode, updating the data. MAXHold: displays the highest measured trace value for all the data that has been measured since the function was turned on. MINHold: displays the lowest measured trace value for all the data that has been measured since the function was turned on.
PAGE 35
Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.7 NEGative|POSitive|SAMPle|AVERage|NORMAL|QUASi [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]? Specifies the detection mode. For each trace interval (bucket), average detection displays the average of all the samples within the interval. Enumeration NEGative: Negative peak detection displays the lowest sample taken during the interval being displayed.
PAGE 36
Parameter Type Parameter Range Return Default Menu Example Integer 1 ~ 999 Integer 1 Trace > Avg Times :AVERage:TRACe1:COUNt 10 3.5.7.3 Average Restart ([:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.5.8 [:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar Restarts the trace average. This command is only available when average is on. None None None None None :AVERage:TRAC1:CLEar Sweep Subsection 3.5.8.
PAGE 37
Parameter Range Return Default Menu Example 450us ~ 1500 s Float, unit: s 312.416ms(216.288ms, 192.256ms, 168.224ms, 120.160ms) Sweep > Sweep Time :SWEep:TIME 5s 3.5.8.3 Sweep Time State ([:SENSe]:SWEep:TIME:AUTO) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:SWEep:TIME:AUTO? This command turns on/off auto sweep time state. Boolean OFF|ON|0|1 0|1 ON Sweep > Sweep Time :SWEep:TIME:AUTO ON 3.5.8.
PAGE 38
3.5.8.6 QPD Time([:SENSe]:QPD:DWELl:TIME) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:QPD:DWELl:TIME < time > [:SENSe]:QPD:DWELl:TIME? Sets QPD Time Gets QPD Time Float，unit:s、ms、us 0us ~ 10s(qusai-peak: 900us ~ 30ks) Float，unit: s 50ms Sweep > QPD Time :QPD:DWELl:TIME 10s 3.5.9 Display Subsection 3.5.9.
PAGE 39
3.5.9.3 Display Line (:DISPlay:WINDow:TRACe:Y:DLINe) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y:DLINe :DISPlay:WINDow:TRACe:Y:DLINe? Sets the amplitude value for the display line. Gets the amplitude value for the display line. Float, unit: dBm Ref Level ~ Ref Level - 100 dBm Float, unit: dBm 0 dBm Display > Display Line :DISPlay:WINDow:TRACe:Y:DLINe -10 3.6 Calculate Subsystem 3.6.1 Marker Subsection 3.6.1.
PAGE 40
3.6.1.3 Marker Mode (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE POSition|DELTa|BAND|OFF :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE? Selects the type of markers that you want to activate. Gets the type of markers. Enumeration POSition: selects a normal marker that can be positioned on a trace and from which trace information will be generated.
PAGE 41
Example :CALCulate:MARKer1:RELative:TO:MARK 3 3.6.1.6 Marker X Value (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X? This command positions the designated marker on its assigned trace at the specified trace X value. The value is in the X-axis units, which can be a frequency or time. The query returns the current X value of the designated marker.
PAGE 42
Parameter Type Parameter Range Return Default Menu Example Boolean ON|OFF|0|1 0|1 0 Marker > Marker Table :CALCulate:MARKer:TABLe ON 3.6.1.9 Marker to Start Frequency (:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START Sets the start frequency to the value of the specified marker frequency. This command is not available in zero span.
PAGE 43
Parameter Type Parameter Range Return Default Menu Example None None None None Marker > M→CF :CALCulate:MARKer1:CENTer 3.6.1.12 Marker to Center Frequency Step (:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP This command sets the center frequency step equal to the specified marker frequency. This command is not available in zero span.
PAGE 44
Parameter Range Return Default Menu Example None None None Marker > △ M→Span :CALCulate:MARKer2:DELTa:SPAN 3.6.1.15 Marker Delta to Center Frequency (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer This command sets the center frequency equal to the specified delta marker frequency.
PAGE 45
Type Parameter Range Return Default Menu Example -200.0 dBm~ 200.0 dBm Float, unit: dBm -160.0 dBm Peak > Search Config > Peak Threshold :CALCulate:MARKer:PEAK:THReshold -50 3.6.1.
PAGE 46
Example :CALCulate:MARKer1:CPEak ON 3.6.1.21 Peak Search (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum Performs a peak search based on the search mode settings.
PAGE 47
Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer:PEAK:SEARch:MODE :CALCulate:MARKer:PEAK:THReshold :CALCulate:MARKer:PEAK: EXCursion) None None None None Peak > Next Left Peak :CALCulate:MARKer1:MAXimum:LEFT 3.6.1.
PAGE 48
Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion? This command selects the marker function for the designated marker. Gets the selected marker function for the designated marker. Enumeration OFF: refers to the normal function. FCOunt: refers to the frequency counter function. NOISe: refers to the noise measurement function. NDB: refers to the N dB bandwith function. Enumeration OFF Marker Fn :CALCulate:MARK1:FUNCtion FCOunt 3.6.1.
PAGE 49
Parameter Range Return Default Menu Example None Float None Marker Fn > N dB BW :CALCulate:MARK1:BANDwidth:RESult? 3.6.1.30 N dB Bandwidth Reference Value (:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB :CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB? Sets the reference value of N dB bandwidth measurement.
PAGE 50
Return Default Menu Example None None Limit > Test :CALCulate:LLINe:TEST:STARt 3.6.2.2 Limit Test Stop (:CALCulate:LLINe:TEST:STOP) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:LLINe:TEST:STOP Sets limit test stop. None None None None Limit > Test :CALCulate:LLINe:TEST:STOP 3.6.2.
PAGE 51
Instruction Parameter Type Parameter Range Return Default Menu Example Mode sets a limit line to be either an upper or lower type limit line. An upper line will be used as the maximum allowable value when comparing with the data. Gets limit type. Enumeration UPPer|LOWer Enumeration The default setting of LINe1 is UPPer, the default setting of LINe2 is LOWer Limit > Limit1|2 Edit > Type :CALCulate:LLINe1: TYPE LOWer 3.6.2.
PAGE 52
Return Default Menu Example X-axis: Float Amplitude: Float X-axis: -1Hz Amplitude: 0 dBm Limit > Limit1|2 Edit :CALC:LLINe1:DATA 10000000,-20,20000000,-30 3.6.2.9 Add Limit Point Data (:CALCulate:LLINe[1]|2:DATA) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:LLINe[1]|2:ADD , Add limit point data X-axis: Float Amplitude: Float X-axis: 0~1.
PAGE 53
3.6.2.12 Limit X-axis Unit (:CALCulate:LLINe:CONTrol:DOMain) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME :CALCulate:LLINe:CONTrol:DOMain? Toggles the limit X-axis value between frequency and time. Gets the limit X-axis unit. Enumeration FREQuency|TIME Enumeration FREQuency Limit > Setup > X Axis :CALCulate:LLINe:CONTrol:DOMain FREQuency 3.6.2.
PAGE 54
Type Parameter Range Return Default Menu Example OFF|ON|0|1 0|1 OFF Limit > Setup > Fail to stop :CALCulate:LLINe:FAIL:STOP OFF 3.7 Measurement Subsystem 3.7.1 ACPR Subsection 3.7.1.1 Main Channel ([:SENSe]:ACPRatio:BWIDth:INTegration) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:ACPRatio:BWIDth:INTegration [:SENSe]:ACPRatio:BWIDth:INTegration? Specifies the range of integration used in calculating the power in the main channel.
PAGE 55
Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:ACPRatio:OFFSet[:FREQuency]? Sets the space value between the center frequency of main channel power and that of the adjacent channel power. Gets adjacent channel space Float, unit: Hz, KHz, MHz, GHz 100 Hz~700 MHz Float, unit: Hz 3MHz Meas > ACPR > Meas Setup > Adj Chn Space :ACPRatio:OFFSets 20 MHz 3.7.1.
PAGE 56
Return Default Menu Example Float, unit: dBm None Meas > ACPR :MEASure:ACPRatio:LOWer? 3.7.1.7 Query Upper Adjacent Channel Power (:MEASure:ACPRatio:UPPer:POWer?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:ACPRatio:UPPer:POWer? Return the upper adjacent channel power of ACPR measurement. None None Float, unit: dBm None Meas > ACPR :MEASure:ACPRatio:UPPer:POWer? 3.7.1.
PAGE 57
3.7.2.2 Channel Span ([:SENSe]:CHPower:FREQuency:SPAN:POWer) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:CHPower:FREQuency:SPAN:POWer Sets the analyzer span for the channel power measurement. Be sure the span is set larger than the integration bandwidth. None None None None Meas > Ch Power > Meas Setup > Span :CHPower:FREQuency:SPAN:POWer 3.7.2.
PAGE 58
Instruction Parameter Type Parameter Range Return Default Menu Example 3.7.3 This command returns the value of the channel power density in dBm/Hz. None None Float None Meas > Ch Power :MEASure:CHPower:DENSity? OBW Subsection 3.7.3.
PAGE 59
Parameter Type Parameter Range Return Default Menu Example span. Gets dBc value. Float 0.1~100 Float 26 Meas > Occupied BW > Meas Setup > dBc :OBWidth:XDB 3 3.7.3.4 Query OBW and Centroid (:MEASure:OBWidth?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:OBWidth? Use this command to query the occupied bandwidth and bandwidth centroid according to the method you set. None None Float, unit: Hz None Meas > Occupied BW :MEASure:OBW? 3.7.3.
PAGE 60
Default Menu Example None Meas > Occupied BW : MEASure:OBW:CENTroid? 3.7.3.7 Query Transmit Frequency Error (:MEASure:OBWidth:OBWidth:FERRor?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.7.4 :MEASure:OBWidth:OBWidth:FERRor? Uses this command to query transmit frequency error. None None Float, unit: Hz None Meas > Occupied BW :MEASure:OBWidth:OBWidth:FERRor? SubsectionT-power(T-Power) 3.7.4.
PAGE 61
3.7.4.3 T-power Stop Line ([:SENSe]:TPOWer:RLIMit) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:TPOWer:RLIMit [:SENSe]:TPOWer:RLIMit? Sets T-power stop line. Gets T-power stop line. Float, unit: s 0 ~ 1000 s Float, time unit: s 20ms Meas > T-power > Meas Setup > Stop Line :TPOWer:RLIMit 0.02 3.7.4.4 Query T-power (:MEASure:TPOWer?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.7.
PAGE 62
Parameter Type Parameter Range Return Default Menu Example 3.7.6 None None None None Meas > Spectrum Monitor > Meas Setup > Restart :SPECtrogram:RESTart Third-order Intercept Point（TOI） 3.7.6.1 Query Third-order Intercept Point result(:MEASure:TOI?) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :MEASure:TOI? Gets the result of Third-order Intercept Point None None Float None Meas > TOI :MEASure:TOI? 3.7.6.
PAGE 63
Parameter Range Return Default Menu Example IMMediate: free-run triggering. VIDeo: triggers on the video signal level. EXTernal: allows you to connect an external trigger source. Enumeration IMMediate Trigger :TRIGger:SOURce IMMediate 3.8.
PAGE 64
3.9 TG Subsystem 3.9.1 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example TG On-off (:OUTPut[:STATe]) :OUTPut[:STATe] OFF|ON|0|1 :OUTPut[:STATe]? Sets TG on-off. Gets TG state. Boolean OFF|ON|0|1 0|1 0 TG > TG :OUTPut ON 3.9.2 TG Level (:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.9.3 Command Format Instruction Parameter Type Parameter Range Return Default Menu Example 3.9.
PAGE 65
Instruction Parameter Type Parameter Range Return Default Menu Example Sets TG normalize on-off. Gets TG normalize state. Boolean OFF|ON|0|1 0|1 0 TG > Normalize > Normalize :CALCulate:NTData ON 3.9.5 TG Normalize Reference Level (:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel? Sets TG normalize reference level.
PAGE 66
Return Default Menu Example 0|1 0 TG > Normalize > Ref Trace :DISPlay:WINDow:NTTRace ON 3.10 Demod Subsystem 3.10.1 Demod Mode ([:SENSe]:DEMod) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:DEMod AM|FM|OFF [:SENSe]:DEMod? Sets demod mode. Gets demod mode. Enumeration AM|FM|OFF Enumeration OFF Demod :DEMod AM 3.10.
PAGE 67
3.10.4 Volume ([:SENSe]:DEMod:VOLume) Command Format Instruction Parameter Type Parameter Range Return Default Menu Example [:SENSe]:DEMod:VOLume [:SENSe]:DEMod:VOLume? Sets volume value. Gets volume value. Integer 0 ~ 10 Integer 6 Demod > Volume :DEMod:EPHone ON 3.11 Memory Subsystem 3.11.
PAGE 68
Parameter Type Parameter Range Return Default Menu Example String None None None File > Operate > Delete :MMEMory:DELete ABC.
PAGE 69
4. Programming Examples This chapter gives some examples for the programmer. In these examples you can see how to use the VISA or sockets, in combination with the commands have been described above to control the vector network analyzer. By following these examples, you can develop many more applications. 4.1 Examples of Using VISA 4.1.
PAGE 70
Set lib file:project---properties---Linker---Command Line---Additional Options: visa32.lib Include visa.h file: In the projectname.cpp file: #include 3、Add codes: 1)USBTMC access code: Write a function Usbtmc_test: int Usbtmc_test() { /* This code demonstrates sending synchronous read & write commands */ /* to an USB Test & Measurement Class (USBTMC) instrument using */ /* NI-VISA */ /* The example writes the "*IDN?\n" string to all the USBTMC */ /* devices connected to the system and attempts to
PAGE 71
/* Find all the USB TMC VISA resources in our system and store the number of resources in the system in numInstrs.*/ status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs, instrResourceString); if (status
PAGE 72
2)TCP/IP access code: Write a function TCP_IP_Test: int TCP_IP_Test(char *pIP) { char outputBuffer[VI_FIND_BUFLEN]; ViSessiondefaultRM, instr; ViStatusstatus; /* First we will need to open the default resource manager. */ status = viOpenDefaultRM (&defaultRM); if (status
PAGE 73
Existing Item. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add the file. This allows the VISA functions and VISA data types to be used in a program. 3、Add codes: 1)USBTMC access code: Write a function Usbtmc_test: Private Function Usbtmc_test() As Long ' This code demonstrates sending synchronous read & write commands ' to an USB Test & Measurement Class (USBTMC) instrument using ' NI-VISA ' The example writes the "*IDN?\n" string to all the USBTMC ' devices
PAGE 74
status = viFindRsrc(defaultRM, "USB?*INSTR", findList, numlnstrs, instrResourceString) If (status < VI_SUCCESS) Then resultTxt.Text = "An error occurred while finding resources." viClose (defaultRM) Usbtmc_test = status Exit Function End If ' Now we will open VISA sessions to all USB TMC instruments. ' We must use the handle from viOpenDefaultRM and we must ' also use a string that indicates which instrument to open. This ' is called the instrument descriptor.
PAGE 75
Dim count As Long ' First we will need to open the default resource manager. status = viOpenDefaultRM (defaultRM) If (status < VI_SUCCESS) Then resultTxt.Text = "Could not open a session to the VISA Resource Manager!" TCP_IP_Test = status Exit Function End If ' Now we will open a session via TCP/IP device status = viOpen(defaultRM, "TCPIP0::" + ip + "::INSTR", VI_LOAD_CONFIG, VI_NULL, instrsesn) If (status < VI_SUCCESS) Then resultTxt.
PAGE 76
modified to D:\USBTMC_TCPIP_Demo. 2、Click File>>New>>Script in the Matlab interface to create an empty M file 3、Add codes: 1)USBTMC access code : Write a function Usbtmc_test.
PAGE 77
4.1.4 Example of LabVIEW Environment:Win7 32bit system, LabVIEW 2011 The functions of this example: use the NI-VISA, to control the device with USBTMC and TCP/IP access to do a write and read. Follow the steps to complete the example: 1、Open LabVIEW, create a VI file. 2、Add controls. Right-click in the Front Panel interface, select and add VISA resource name, error in, error out and some indicators from the Controls column. 3、Open the Block Diagram interface.
PAGE 78
7、Connect them as shown in the figure below 8、Input the IP address and run the program. TCPIP0::10.11.11.109::inst0::INSTR Teledyne,T3VNA,T3V1XEAX2R0031,2.0.1.
PAGE 79
4.2 Examples of Using Sockets/Telnet 4.2.1 Example of Python Python is an interpreted programming language that lets you work quickly and is very portable. Python has a low-level networking module that provides access to the socket interface.Python scripts can be written for sockets to do a variety of test and measurement tasks. Environment:Win7 32bit system, Python v2.7.5 The functions of this example: Open a socket, sends a query, and closes the socket. It does this loop 10 times.
PAGE 80
time.sleep(.300) def main(): global remote_ip global port global count # Body: send the SCPI commands *IDN? 10 times and print the return message s = SocketConnect() for i in range(10): qStr = SocketQuery(s, b'*IDN?') print (str(count) + ":: " + str(qStr)) count = count + 1 SocketClose(s) input('Press "Enter" to exit') if __name__ == '__main__': proc = main() Run result: Welcome to the SCPI instrument ‘Teledyne T3VNA1500’ >> 0:: Teledyne,T3VNA1500,T3V1XEAX2R0030,2.0.1.
PAGE 81
�Type single SCPI commands. Press Enter to send the command. Welcome to the SCPI instrument ‘Teledyne T3VNA1500’ >> IDN? Teledyne,T3VNA1500,T3V1XEAX2R0030,2.0.1.9 >> * �To exit the telnet window click X in the upper-right corner. �To get a normal telnet prompt, press Ctrl ] (closing bracket). Welcome to Microsoft Telnet Client Escape Character is ‘CTRL+]’ Microsoft Telnet> �To get SCPI prompt again, type open 5024.
PAGE 82
ABOUT TELEDYNE TEST TOOLS Company Profile Teledyne LeCroy (US Headquarters) Teledyne LeCroy is a leading provider of oscilloscopes, protocol analyzers and related test and measurement solutions that enable companies across a wide range of industries to design and test electronic devices of all types. Since our founding in 1964, we have focused on creating products that improve productivity by helping engineers resolve design issues faster and more effectively.