Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Summary of Contents for Focus Microwaves ituner
- Page 1 Installation and Operation Manual Using Load Pull Explorer Version: 3.3 Updated: November 2016 iTunerX OCX version: 3.2 Compatible Firmware versions: - ProTuner4_UNI_V50 - iTuner4_UNI_V50 Focus Microwaves Inc www.focus-microwaves.com info@focus-microwaves.com Tel: 1-514-684-4554...
-
Page 2: Table Of Contents
..................4 INGLE TUNER CONNECTION TCP/IP ..................9 ULTIPLE TUNER CONNECTION CONFIGURING LOAD PULL EXPLORER ................10 ITUNER COMMAND LANGUAGE ..................12 ........................12 NTRODUCTION ......................15 ONTROL OMMANDS 4.2.1 Config command ......................15 4.2.2 Stop Command ......................16 4.2.3 Reset Command ......................17 4.2.4 Disp Command ...................... - Page 3 Manual 4.4.4 Dir Command ......................28 4.4.5 Loadcal Command ..................... 29 4.4.6 Loadfreq Command....................29 4.4.7 Freq? command ......................30 4.4.8 Adapter Command ..................... 31 4.4.9 Term Command......................31 4.4.10 TuneTo Command ...................... 32 4.4.11 TuneTo? Command ....................32 4.4.12 TuneVSWR command ....................
- Page 4 Manual 4.6.3 Compact command ....................42 4.6.4 Format command....................... 42 USING THE ITUNER WITH ITUNERX.OCX ................. 43 ....................43 EGISTERING I UNER X ..................... 44 ROGRAMMING WITH UNER ................. 45 LOCKING VERSUS NON BLOCKING CALLS ......................46 UNER ROPERTIES 5.4.1 Address Property ......................
- Page 5 Manual ......................60 UNER ALIBRATION 6.1.1 Frequency Definition ....................62 ............ 63 PLOADING ALIBRATION ATA USING XPLORER USING IUTILITY ......................65 ..........................65 ......................... 66 UNER ......................... 67 ETUP ........................ 68 PERATIONS...
-
Page 6: Introduction
Manual 1 Introduction The iTuner is an intelligent, TCP/IP capable, microwave tuner with a built in microprocessor and command language. As such, the iTuner may be operated in one of three ways: In conjunction with Focus Microwaves’ Load Pull Explorer software. -
Page 7: Ip Address Configuration And Connection
2 IP Address Configuration and Connection An iTuner is a TCP/IP device connected over Ethernet. As such, the user needs to ensure that all iTuners, as well as other TCP/IP devices, connected to the system have a unique IP address. This is accomplished by connecting each individual iTuner to the system one at a time. - Page 8 Manual Figure 2-2 3. A screen should appear with all the network adapters installed on your computer, select the one responsible for TCP/IP and select properties as depicted below: Figure 2-3 4. A screen should appear indicating different network settings. Choose to specify an IP...
-
Page 9: Single Tuner Tcp/Ip Connection
Manual Figure 2-4 5. Record the IP address entered for later use. IMPORTANT: The tuner uses a subnet mask of 255.255.0.0. Therefore the first to numbers of the IP address of the client must match the first two numbers of the IP address of the tuner. - Page 10 Manual Figure 2-5: Single Tuner Configuration Create a new TCP/IP HyperTerminal connection using the IP address of the target tuner as the host address and port 23 as shown below. Figure 2-6 To change the tuners IP address, connect to it via the new HyperTerminal connection and use...
- Page 11 Manual ********** FOCUS MICROWAVES TUNER CONTROLLER ********* iCCMT1808 SN#447 IP: 10.0.0.2 [0]Result=-1 CCMT->IP_SET 10.0.0.12 IP address saved. Reboot!!!! After performing this action verify that the configuration has been properly updated with the CONFIG? command, as shown below. If the displayed IP address is incorrect repeat the previous step.
- Page 12 Manual CCMT->CONFIG? Model: iCCMT1808 SN#: 447 MfgDate: 22/03/2004 IP: 10.0.0.12 TYPE: 0 SPEED:400 MODE: LOAD LIMITS: L1=7400 L2=2850 L3=0 L4=0 L5=0 L6=0 BACKLASH: BL1=0 BL2=0 BL3=0 BL4=0 BL5=0 BL6=0 Fmin: 800.000MHz Fmax: 18000.002MHz CrossOver: 18000.002MHz...
- Page 13 Manual Disconnect the tuner and repeat the above steps for each tuner.
-
Page 14: Multiple Tuner Tcp/Ip Connection
Manual 2.3 Multiple tuner TCP/IP connection Ensure that each tuner has a different IP address by powering up each tuner; the IP addresses will be shown on each tuner’s display window. If each tuner does not have a unique IP, connect... -
Page 15: Configuring Load Pull Explorer
Manual 3 Configuring Load Pull Explorer In order to allow the calibration and manipulation of tuners several configuration steps must be completed. These steps are as follows: The tuner(s) need to be defined in Load Pull Explorer. Select Define Tuner… in the Tools menu (Figure 3-1). - Page 16 Manual Figure 3-2 Repeat the above steps for each tuner, as necessary.
-
Page 17: Ituner Command Language
Manual 4 iTuner Command Language Using the iTuner in Load Pull Explorer is sufficient for many applications. However, some more specialized applications require independence from Load Pull Explorer, or even the whole Windows environment. For this reason the iTuner provides a raw TCP/IP interface that can be used with any socket programming language, or through any telnet client program. - Page 18 Manual...
- Page 19 Manual CCMT->********** FOCUS MICROWAVES TUNER CONTROLLER ********* ICCMT-708 SN#310 IP: 10.0.0.1 Result=-1 ID#0 CCMT->init Result=0 ID#1 CCMT->pos 1 1000 Result=1 ID#2 CCMT->JOB#2 completed CCMT->pos? POS: A1=1000 A2=0 Result=0 ID#3 CCMT->pos 3 1000 Error: Illegal Axis# [1000] Result=-1 ID#4 CCMT->status?
-
Page 20: Control Commands
Manual The above example shows a typical communication session. The tuner sends a short title message after connection has been established. We enter the ‘init’ command at the command prompt, terminated by the ENTER key. The tuner replies with:... -
Page 21: Stop Command
Manual SN#: 1 MfgDate: MAY/31/2006 IP: 10.0.0.1 TYPE: 0 MODE: LOAD TuneParam: 5 -40.00dB 2.00degr Fmin: 800MHz Fmax: 7000MHz CrossOver: 0.000MHz Axis# Motor# Init Top Steps Ctrl Limit Current Backlash 250 8000 200 7365 800mA 300 15000 500 4 10100 950mA... -
Page 22: Reset Command
Manual Firmware revision below Rev2.0.35: The tuner will be in a undefined state after the STOP command. You must call the RESET or the INIT command before sending any further movement commands. Examples: STOP 4.2.3 Reset Command Call RESET to clear all calibration data, adapter and termination definitions... -
Page 23: Help Command
Manual 4.2.5 Help Command Send the HELP command to get a listing of all commands defined in the iTuner. 4.2.6 Rev? command Return revision of firmware 4.2.7 IP_SET command Used to set the static IP address, Netmask and GateWay of tuner. -
Page 24: Init Command
Manual 3 -> vertical motor (low frequency) 4 -> harmonic probe 1 -> horizontal motor (tuning section) 2 -> vertical motor (tuning section) 3 -> horizontal motor (pre-match section) 4 -> vertical motor (pre-match section) 1 -> 3 harmonic probe 2 ->... -
Page 25: Pos Command
Manual Syntax: Init [axis] Parameter: Axis specifies axis to initialize. Use zero (0) to initialize all axis Remarks: The INIT commands starts the initialization task for all axis specified, and returns control immediately to the calling process. The time required to initialize an axis depend on the distance the probe has to travel before reaching its home position. - Page 26 Manual Return value: 0 -> syntax okay, movement started, no notification (REV<2.25) 1 -> syntax okay, movement started, notification message will be send <0 -> one of the axis has a syntax error Remarks: The POS command takes one or multiple pairs of axis/position definitions, all to be executed simultaneously.
-
Page 27: Move Command
Manual 4.3.3 Move Command Call MOVE to execute a relative movement Syntax: MOVE axis steps Parameter: axis specifies axis steps specifies number of steps to be executed, negative value are allowed Return value: 1 -> syntax okay <0 -> syntax error... -
Page 28: Opc? Command
Manual Remarks: Use the status command to monitor the status of the tuner. Initialization, positioning and tuning commands (INIT,POS,MOVE,TUNE_TO etc) start instruct the motor control electronics to start the requested movement. The tuner continues listening to and executing incoming commands even while the motors are busy. -
Page 29: Tuning Commands
4.4 Tuning Commands 4.4.1 Introduction iTuner calibration data are stored on the on-board flash memory (see chapter 6 for instructions on calibrating the tuner). Memory size is large enough to store several hundred sets of calibration data at different frequencies. Each calibration set may consist of a ‘primary’... - Page 30 Manual Two commands, ADAPTER and TERM, are available to define the s-parameter of these sections, for both the primary and all secondary frequencies. Figure 4.2 shows a typical setup where the tuner is located at the input of the DUT. In this configuration, the adapter is located between the output port of the tuner and the input at the DUT, and the termination is the source impedance seen by the tuner input.
- Page 31 Manual In case of = 0, i.e. the network connected to the output of the tuner is well matched, the LOAD loss calculation can be simplified: MODE SOURCE: loss calculation based on Available Gain definition (see figure 4.2) where Sij = s-parameter of tuner &...
-
Page 32: Tuning And Impedance Query Commands
Manual high values. Because of the limited VSWR range of the tuner, and loss in the adapter section, you may not be capable to reach you desired VSWR. The following section explains all the tuning related commands in detail. -
Page 33: Dir Command
Manual Examples: MODE LOAD Set LOAD tuning mode MODE SOURCE Set SOURCE tuning mode 4.4.4 Dir Command Call DIR to display a directory of the calibration data stored in tuner Syntax: Parameter: None Return value: Always 0 Remarks: A typical DIR reply is shown below:... -
Page 34: Loadcal Command
Manual and Ymax values. Calling LOADCAL 128 will load all three data sets. Calibration #7 and #8 also have identical ID=155, and both have the same frequency f=0.8GHz. However, cal#8 has a different type. Type=1 identifies a data for the pre-match section of the tuner (PMT only). Calling LOADCAL 0155 will load both the tuning and the pre-matching calibration data. -
Page 35: Freq? Command
Manual Remarks: The LOADFREQ command scans the directory to find calibration data with a primary frequency inside a range defined by freqMHZ±maxDelta. The first set of calibration data that fulfills the frequency definition will be loaded. Use the FREQ? to verify the actual primary frequency (and all secondary frequencies) included in the calibration data set. -
Page 36: Adapter Command
Manual 4.4.8 Adapter Command Call ADAPTER to define s-parameter of section between DUT and tuner. Magnitude values are specified in linear magnitude (not log magnitude) and phase is in degrees. Syntax: ADAPTER freqIdx s11m s11p s12m s12p s21m s21p s22m s22p... -
Page 37: Tuneto Command
Manual Examples: TERM 2 0.15 125 Defines termination for first secondary frequency 4.4.10 TuneTo Command Call TUNETO to set reflection coefficient in DUT reference plane. The tuner will move the probe to the new position. Syntax: TUNETO mag [phase]... -
Page 38: Tunevswr Command
Manual Remarks: Phase parameter is optional. If omitted, tuner only adjusts vertical axis to achieve desired magnitude. Tuneto? does not move the carriage of the tuner. Examples: Tuneto? .5 90 Returns the x and y position of the probe required to achieve the given gamma. -
Page 39: Tuneh1 Command
Manual Parameter: Magnitude Phase Phase Return value: Remarks: The TunePM command allows to set the pre-match section of a PMT to a specific reflection coefficient Examples: TUNEPM .8 180 4.4.15 TuneH1 command Call TuneH1 to set the phase of the first harmonic section of a PHT... -
Page 40: Calpoint? Command
Manual Parameter: Number of calibration point Return value: <0 -> invalid calibration point Remarks: Use this command to tune to any of the calibrated probe positions. Use the DIR command to find the number of points contained in the current calibration data set. -
Page 41: Gamma_At? Command
Manual When calling while the tuner is moving, the probe position at the time of the query is used to calculate GAMMA. Use the STATUS? Command to make sure that the tuner has completed a ‘tuning’ movement before calling GAMMA to obtain the actual reflection coefficient. -
Page 42: Vswr_At? Command
Manual <0 , no calibration loaded Remarks: See GAMMA? For detailed description Examples: VSWR? CCMT->vswr? 1000.000MHz: VSWR: 16.5611 12.48 Loss:0.20dB 2000.000MHz: VSWR: 41.2720 163.22 Loss:1.18dB 3000.000MHz: VSWR: 51.2577 -36.28 Loss:2.58dB 4.4.22 VSWR_AT? Command Call VSWR_AT? to query VSWR seen by DUT for the given probe position... -
Page 43: Spar_At? Command
Manual Remarks: The SPAR? Command returns the s-parameter at the current probe position in the mag/phase format, taking into account the ADAPTER and the tuner itself; the S-parameters are returned in the raw S11,S12,S21,S22 Examples: SPAR? 4.4.25 SPAR_AT? Command... -
Page 44: Constant Vswr Commands
A special group of commands are designed to make constant VSWR testing straightforward while taking full advantage of the iTuners’ tuning and de-embedding capabilities. The VSWR family of commands of the iTuner automatically re-adjusts the vertical probe position to keep the VSWR seen by the DUT constant during phase sweep. -
Page 45: Vswr_Auto Command
Manual A complete 360 phase sweep can be executed without having to perform a time consuming ‘return to horizontal zero’ operation during the test that may be required when the tuner reaches its physical limit or enters a non-calibrated section of its horizontal axis. -
Page 46: Vswr_Inc Command
Manual 4.5.3 VSWR_INC command Syntax: VSWR_INC degrees Parameter: degrees Return value: Remarks: Used after VSWR_INIT to increment phase by the specified amount. VSWR is kept constant while adjusting phase Examples: 4.5.4 VSWR_STEP command Same as VSWR_INC 4.5.5 VSWR_DO360 command... -
Page 47: Configuration And Maintenance Commands
Erase the calibration data corresponding to the specified ID, where calID is the identifier returned by DIR 4.6.3 Compact command Defragments the iTuner’s onboard file system 4.6.4 Format command Erases all calibration data stored on the flash memory card of the Tuner. This command takes a... -
Page 48: Using The Ituner With Itunerx.ocx
Note: A LabView example (located in: Focus \ iTuner \ iTunerActiveXDemo.vi ) of how to use the ActiveX control is also provided with the iTuner, however any ActiveX programming platform may be used. -
Page 49: Programming With Itunerx
C:\WINDOWS\system32 or C:\WINNT\system32 directory (this depends on the version of Windows). A message should appear saying that registration has succeeded. 5.2 Programming with ITunerX Like any ActiveX control, iTuner.ocx exports an interface that contains: Properties ... -
Page 50: Blocking Versus Non-Blocking Calls
For the purpose of this manual, lets assume that your tuner is represented by a variable named iTuner. This variable is now used to acces the properties and method. For instance, to access the property named Address, you would write the following code : ... -
Page 51: Itunerx Properties
Manual 5.4 iTunerX Properties 5.4.1 Address Property Property: Address Type: String 10.0.0.1 (default) Attribute: Read/Write Remarks: Used to set the IP address of the socket for communication with the tuner. Must to be called before attempting to communicate with tuner. -
Page 52: Revision Property
Manual 5.4.3 Revision Property Returns a short with the revision of the software. 5.4.4 ShowError Property Property: ShowError Type: long 0 -> ErrorMessage OFF 1-> ErrorMessage ON (default) Attribute: Write Only Remarks: An error message window will be displayed when a serious error occurs during TCP/IP communication, and execution of your application is halted until you click the OKAY button in the message window. -
Page 53: Itunerx Methods
Manual Initialize() SetGamma(double magnitude, double phase) SetVSWR(double VSWR, double phase) SetPosition(long Position, short axis) All other methods must call ‘OPC’ to halt program execution until the tuner has completed its current task. Examples: iTuner.Timeout=20 Visual Basic iTuner.SetTimeout(20);... -
Page 54: Sendcmd Method
Manual 5.5.2 SendCmd Method Method: SendCmd ( command , acknowledge ) Parameter: Command [in] String Acknowledge [out] String Return value: Result value of command (see command description in chapter 4) Remarks: Same as above ‘Send’ method, but additional parameter ‘acknowledge’... -
Page 55: Getstatus Method
Return value: 0 -> tuner is idle >0 -> tuner is busy <0 -> error Remarks: GetStatus method encapsulates the “STATUS?” command. Examples: status = iTuner.GetStatus() 5.5.5 Initialize and GetInit Method Method: Initialize( axis ) GetInit() Parameter: Axis [in] Axis nbr (use 0 for all axis) -
Page 56: Setposition And Getposition Method
Manual axis, any other value will only initialize the axis specified. GetInit encapsulates the ‘INIT?’ command. Initialize() is a blocking command (if Timeout property > 0). You can call the GetInit method in a loop, or use the OPC method to halt your application until the tuner has completed initialization. -
Page 57: Getnbcalibrations Method
The Fo frequency of the calibration in Return value: Result value of command (see command description in chapter 4) Remarks: GetCalibrationInfo encapsulates the ‘_DIR_CAL’ command and returns the information for the specified calibration index. Examples: for(int i = 0; i<NbCalibrations; i++) iTuner.GetCalibrationInfo(calIdx, &calId, &F0GHz) -
Page 58: Loadcalibration Method
Manual 5.5.9 LoadCalibration Method Method: LoadCalibration (calId) Parameter: calId [in] Calibration unique ID Return value: Result value of command (see command description in chapter 4) Remarks: LoadCalibration encapsulates the ‘LOADCAL’ command and loads the calibration specified. Examples: iTuner.LoadCalibration(calId) 5.5.10 SetAdapter and GetAdapter Method... -
Page 59: Settermination And Gettermination Method
SetAdapter sets s-parameter of section between DUT and tuner for the primary frequency. GetAdapter returns the settted s-parameter of section between DUT and tuner for the primary frequency. Examples: iTuner.SetAdapter(0.1,30,0.9,20,0.9,18,0.1,60) iTuner.GetAdapter(&s11mag, &s11phi, &s12mag, &s12phi, &s21mag, &s21phi, &s22mag, &s22phi) 5.5.11 SetTermination and GetTermination Method Method: SetTermination(magnitude, phase) GetTermination(magnitude, phase) -
Page 60: Setgamma And Getgamma Method
Manual 5.5.12 SetGamma and GetGamma Method Method: SetGamma( magnitude, phase ) GetGamma( magnitude, phase, loss) Parameter: magnitude [in][out] Magnitude of reflection coefficient phase [in][out] Phase of reflection coefficient loss [out] Loss of tuner (and adapter) in dB Return value:... -
Page 61: Setvswr And Getvswr Method
GetGammaAt encapsulates the ‘GAMMA_AT?’ command. GetGammaAt returns the reflection coefficient in the DUT reference plane for a given x and y coordinates. Examples: iTuner.GetGammaAt(1000, 5000, &mag, &phase, &loss) 5.5.14 SetVSWR and GetVSWR Method Method: SetVSWR( vswr, phase ) GetVSWR( vswr, phase, loss) -
Page 62: Getvswrat Method
GetVSWRAt encapsulates the ‘VSWR_AT?’ command. GetVSWRAt returns the reflection coefficient in the DUT reference plane for a given x and y coordinates. Examples: iTuner.GetVSWRAt(1000, 5000, &vswr, &phase, &loss) 5.5.16 GetSpar Method Method: GetSpar( s11_mag, s11_ang, s12_mag, s12_ang, s21_mag, s21_ang, s22_mag, s22_ang) -
Page 63: Getsparat Method
GetSpar returns the instantaneous s-parameter taking into account the ADAPTER and the tuner, and can be called even while the tuner is performing a movement. Examples: iTuner.GetSpar(&s11mag, &s11phi, &s12mag, &s12phi, &s21mag, &s21phi, &s22mag, &s22phi) 5.5.17 GetSparAt Method Method: GetSparAt( x,y, s11_mag, s11_ang, s12_mag, s12_ang,... -
Page 64: Getlastreply Method
Manual Examples: iTuner.GetSparAt(1000, 5000, &s11mag, &s11phi, &s12mag, &s12phi, &s21mag, &s21phi, &s22mag, &s22phi) 5.5.18 GetLastReply Method Method: GetLastReply() Parameter: none Return value: String containing reply of tuner to last command send. Remarks: Use this method to obtain a copy of the reply string send by the tuner to the last command send. -
Page 65: Adding Calibration Data
Manual 6 Adding Calibration Data Although the iTuner comes equipped with preloaded calibrations, the user may still want to recalibrate or calibrate at several specific frequencies. Load Pull Explorer must be used to produce these calibrations. The calibration must then be uploaded to the iTuner using the iUtility program (covered in section 6.2). - Page 66 Manual Figure 6-2 1. Select the Calibration type: For standalone tuner calibration use Standard Calibration. 2. Select the VNA to be used for calibration. The VNA must already be defined and configured. 3. Select the VNA averaging to be used 4.
-
Page 67: Frequency Definition
Manual 6.1.1 Frequency Definition Select Fo LIST, FREQ SWEEP or HARMONIC SWEEP and enter the required frequency information and press Create. To calibrate a list of frequencies, place a check in the checkbox. Figure 6-3 The Frequency Definition window (as depicted above) is used to define frequency lists to be used when calibrating a tuner. -
Page 68: Uploading Calibration Data Using Load Pull Explorer
Smith Chart, view the calibration data, export the calibration to a location on the hard drive (.cal), upload the calibration to the iTuner and delete calibrations. Calibration files measured using Twin.exe can be imported by selecting a tuner and pressing the Import button. - Page 69 Manual Figure 6-5...
-
Page 70: Using Iutility
Manual 7 Using iUtility While the iUtility’s primary use is to upload calibration files to the iTuner. The iUtility program has many other helpful features that are summarized in this section. 7.1 File Tab Figure 7-1 The “Directory” button is used to select the path to the calibration files. -
Page 71: Tuner Tab
The “Configuration?” button retrieves the configuration and setup information of the iTuner The “Mode” dropdown list is used to configure the tuner as either a source or load tuner. The “Speed” dropdown list is used to set the speed of the iTuner. -
Page 72: Setup Tab
The “Load Calibration” button loads the calibration whose id is selected in the right dropdown list. (Note: this operation takes a calibration from the iTuner’s internal storage and loads it into the iTuner’s memory for purposes of calculating gamma, s- parameters and loss. This operation does not upload or download calibration data to the iTuner) ... -
Page 73: Operations Tab
Manual The “Termination” section is used to set the reflection factor of the termination at the selected frequency by using the “Gamma” and “Phi” textboxes, and “Frequency” dropdown list respectively. Press the “Set” button to confirm the settings. (see above diagram) ...