Giga-tronics 2400 series, 2500 series, 2408C, 2420C, 2426C Programming Manual
...
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
2400 and 2500 Series
Microwave Signal Generators
Programming Manual, Part Number 34783, Rev A, July 2009
Programming Manual
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
tronics 2400/2500 Series instruments are warranted
nd workmanship for one year from
tronics will at its option repair or replace
products that are proven defective during the warranty period.
This warranty DOES NOT cover damage resulting from improper
tronics service. There is
no implied warranty of fitness for a particular purpose, nor is
tronics liable for any consequential damages. Specification
All technical data and specifications in this publication are subject to change without prior notice and do
not represent a commitment on the part of Giga-tronics, Incorporated.
© 2009 Giga-tronics Incorporated. All rights reserved. Printed in the U.S.A.
Gigaagainst defective materials a
date of shipment. Giga-
use, nor workmanship other than Giga-
Gigaand price change privileges are reserved by Giga-tronics.
CONTACT INFORMATION
Giga-tronics, Incorporated
4650 Norris Canyon Road
San Ramon, California 94583
Telephone: 800.726.4442 (only within the United States)
925.328.4650
Fax: 925.328.4700
On the Internet: www.gigatronics.com
Warranty
Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
Regulatory Compliance Information
This product complies with the essential requirements of the following applicable European
Directives, and carries the CE mark accordingly.
89/336/EEC and 73/23/EEC EMC Directive and Low Voltage Directive
EN61010-1 (1993) Electrical Safety
EN61326-1 (1997) EMC – Emissions and Immunity
Manufacturer’s Name: Manufacturer’s Address
Giga-tronics, Incorporated 4650 Norris Canyon Road
San Ramon, California 94583
U.S.A.
Type of Equipment: Model Series Number
Microwave Signal Generator 2400 Series
2500 Series
Model Numbers:
2408C, 2420C, 2426C,
2440C
2508B, 2520B, 2526B,
2540B, 2550B
Declaration of Conformity on file. Contact Giga-tronics at the following;
Giga-tronics, Incorporated
4650 Norris Canyon Road
San Ramon, California 94583
Telephone: 800.726.4442 (only within the United States)
925.328.4650
Fax: 925.328.4700
Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
Record of changes to this Manual
Use the table below to maintain a permanent record of changes to this document. Replacement pages
will be issued as a TPCI (Technical Publication Change Instruction), and will be inserted at the front of
the binder. Remove the corresponding old pages, insert the new pages, and record the changes here. Do
the same thing with TCPI pages that are issued after you have received this manual.
TPCI Number TPCI Issue Date Date Entered Comments
Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
Table of Contents
Table of Contents...........................................................................................................................................i
Chapter 1. Safety ....................................................................................................................................1
1.1 Unsafe Operating Conditions........................................................................................................1
1.2 Safety Warnings Used in This Manual ..........................................................................................1
1.2.1 Personal Safety Alert.............................................................................................................1
1.2.2 Equipment Safety Alert.........................................................................................................1
1.2.3 Notes.....................................................................................................................................1
Chapter 2. Introduction ..........................................................................................................................3
2.1 Overview.......................................................................................................................................3
2.2 Physical Description of the 2400/2500.........................................................................................4
Chapter 3. Hardware Interfaces .............................................................................................................5
3.1 Introduction ..................................................................................................................................5
3.2 Configure the 2400/2500 Hardware Interface .............................................................................6
3.2.1 Using the Included USB Cable...............................................................................................6
3.2.2 Assign a GPIB Address to the 2400/2500..............................................................................6
3.2.3 Configure the Computer’s RS-232 for Remote Operation....................................................6
3.2.4 Configure the 2400/2500 Ethernet Connection ...................................................................7
Chapter 4. Programming Interfaces .......................................................................................................9
4.1 Introduction ..................................................................................................................................9
4.2 Select the Remote Programming Language..................................................................................9
4.3 Dynamic Link Library (DLL)..........................................................................................................10
4.3.1 Adding the DLL to Programming Projects...........................................................................10
4.3.2 Programming Examples Using the DLL ...............................................................................11
4.3.3 DLL Functions ......................................................................................................................17
4.4 SCPI Command Set......................................................................................................................96
4.4.1 SCPI Command Format .......................................................................................................96
4.4.2 SCPI Commands ..................................................................................................................97
4.5 IEEE 488.2 Common Commands...............................................................................................120
4.6 GT-12000 Native Commands ....................................................................................................122
4.6.1 GT-12000 Native Commands: CW and System.................................................................122
4.6.2 GT-12000 Native Commands: List Mode ..........................................................................123
4.6.3 GT-12000 Native Commands: Amplitude Modulation .....................................................125
4.6.4 GT-12000 Native Commands: Frequency Modulation .....................................................126
4.6.5 GT-12000 Native Commands: Phase Modulation.............................................................127
4.6.6 GT-12000 Native Commands: Pulse Modulation..............................................................128
4.7 Emulation..................................................................................................................................129
4.7.1 HP 834X Emulation Commands ........................................................................................129
Programming Manual, Part Number 34783, Rev A, July 2009 i
Giga-tronics 2400 and 2500 Series Microwave Signal Generators
4.7.2 HP 8663 Emulation Commands ........................................................................................132
4.7.3 HP 8673 Emulation Commands ........................................................................................134
4.7.4 HP 8360 Emulation Commands ........................................................................................138
4.7.5 HP 8370 Emulation Commands ........................................................................................139
4.7.6 GT900 Emulation Commands ...........................................................................................140
4.7.7 Option 55F: Wavetek 90X Emulation Commands.............................................................142
4.7.8 Systron Donner 16XX Emulation Commands....................................................................143
Chapter 5. Automation Xpress............................................................................................................149
5.1 Introduction ..............................................................................................................................149
5.1.1 Benefits of Using Automation Xpress ...............................................................................149
5.2 Install Automation Xpress.........................................................................................................150
5.3 Start Automation Xpress...........................................................................................................152
5.4 Automation Xpress GUI Description .........................................................................................154
5.4.1 Tool Bar .............................................................................................................................155
5.4.2 Indicators and RF Button...................................................................................................165
5.5 Auto Programmer .....................................................................................................................167
5.5.1 Introduction ......................................................................................................................167
5.5.2 Auto Programmer Examples.............................................................................................168
Chapter 6. Status Register System......................................................................................................171
6.1 Introduction ..............................................................................................................................171
6.2 Status Byte and Service Request Enable Registers ...................................................................173
6.3 Standard Event Status and Standard Event Status Enable Registers........................................174
6.4 Questionable Status Condition and Enable Registers...............................................................175
Chapter 7. 2400/2500 Specific Commands ........................................................................................177
Chapter 8. List Mode Operation .........................................................................................................179
Chapter 9. LabVIEW Drivers................................................................................................................181
9.1 Overview...................................................................................................................................181
9.2 LabVIEW Drivers........................................................................................................................183
9.2.1 LabVIEW Drivers for DLL Functions...................................................................................183
9.2.2 Non-DLL LabVIEW Drivers.................................................................................................187
Appendix A. Remote Error Messages....................................................................................................189
Appendix B. DLL Error Messages...........................................................................................................193
Appendix C. FM Sensitivity/Deviation RangeTable ...............................................................................197
ii Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400 and 2500 Series Microwave Signal Generators 1. Safety
Chapter 1. Safety
1.1 Unsafe Operating Conditions
If you notice any of the following conditions while operating electronics equipment, IMMEDIATELY
de-energize the equipment.
• The instrument fails to operate normally, or operates erratically.
• The power cable, receptacle, or plug on the instrument is damaged
• The instrument causes electrical shock or operates at abnormally high temperature.
• A liquid or foreign substance falls into the instrument
• The instrument generates an abnormal sound, smell, smoke, or sparking light.
If any of the above conditions occurs, contact Giga-tronics to get the instrument repaired.
WARNING
cause death or serious damage to the instrument and any equipment connected to it.
Continuing to operate the instrument with any of the above conditions could
1.2 Safety Warnings Used in This Manual
1.2.1 Personal Safety Alert
WARNING: Indicates a hazardous situation which, if not avoided, could result in
WARNING
death or serious injury.
1.2.2 Equipment Safety Alert
CAUTION
CAUTION: Indicates a situation which can damage or adversely affect the 2400 and 2500
or associated equipment.
1.2.3 Notes
Notes are denoted and used as follows:
NOTE: Highlights or amplifies an essential operating or maintenance procedure, practice,
condition or statement.
Programming Manual, Part Number 34783, Rev A, July 2009 1
1. Safety Giga-tronics 2400 and 2500 Series Microwave Signal Generators
This page is intentionally blank
2 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400 and 2500 Series Microwave Signal Generators 2. Introduction
Chapter 2. Introduction
2.1 Overview
Manual Convention:
• For simplicity, when generically referring to Giga-tronics Microwave Signal Generators in the
2400 and 2500 Series, the term “2400/2500” may be used. Specific models within either series
are referred to when necessary.
This manual describes how to program and remotely control the 2400/2500 and 2500B Series
Microwave Signal Generators for automated testing.
Giga-tronics designed the 2400/2500 for high performance and flexibility, and accordingly, there are
different ways to set up the instrument for automated testing. All methods for setting up the 2400/2500
for automated testing are described in this manual.
However, the easiest and most effective way to use the 2400/2500 for automated testing is through
Automation Xpress, an automated testing application developed by Giga-tronics that is included on the
CD-ROM that shipped with the 2400/2500.
Automation Xpress provides the fastest switching of power and frequency during automated testing.
This maximizes device throughput, keeping your testing costs as low as possible.
Features of Automation Xpress:
• 1.0 ms frequency and power switching during testing
• Eliminate the need to learn GPIB or other native language commands by using the Auto
Programming feature, which automatically records a sequence of actions and converts those
actions into program code. You can then import this code into the program environment of your
choice, such as Visual C++ or Visual Basic.
• The Xpress Auto-programming feature virtually eliminates training time by providing scripts and
sequences guaranteed for accuracy.
• Transit and execution times for single-function calls such as changing CW frequency are ten
times faster using Automation Xpress compared to standard message-based commands.
• Automation Xpress sends large amounts of data (i.e., large lists) more than 100 times faster than
SCPI commands.
Programming Manual, Part Number 34783, Rev A, July 2009 3
2. Introduction Giga-tronics 2400 and 2500 Series Microwave Signal Generators
2.2 Physical Description of the 2400/2500
If you need information about the controls, indicators, display, or any other physical aspects of the
2400/2500, refer to the Operation Manual for the series you are interested in:
2400/2500 Operation Manual part number: 34802
2500B Operation Manual part number: 34737
4 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Series Microwave Signal Generators 3. Hardware Interfaces
GPIB
RS-232
USB
LAN
Chapter 3. Hardware Interfaces
3.1 Introduction
The 2400/2500 has four connectors to choose from for connecting to a computer:
• GPIB
• LAN (Ethernet)
• RS-232
• USB
Figure 1 below shows the locations of the connectors on the 2400/2500 rear panel. Descriptions of the
connectors are given in Table 1 below.
NOTE: Your 2400/2500 may look slightly different, depending on series and model.
Figure 1. 2400/2500 Rear Panel
Table 1 2400/2500 Hardware Interfaces Description
Name Description
GPIB A 24-pin IEEE STD 488.2 connector for control of the instrument during remote
operation using GPIB.
RS-232 A DB-9 connector for control of the instrument during remote operation using
RS-232 serial communications. A USB to Serial Cable Port Adapter is included
with the 2400/2500 for controlling the instrument via the USB port on a host
computer.
USB A USB connector for control of the instrument during remote operation using
USB 2.0 (full speed) communications
Ethernet An Ethernet connector for control of the instrument during remote operation
using LAN interface communications.
Programming Manual, Part Number 34783, Rev A, July 2009 5
3. Hardware Interfaces Giga-tronics 2400/2500 Series Microwave Signal Generators
SYSTEM
3.2 Configure the 2400/2500 Hardware Interface
3.2.1 Using the Included USB Cable
A USB 2.0 Type A Male to Type B Male cable shipped with the 2400/2500, and provides you with the
simplest way to connect a computer to the 2400/2500. The cable connects between a USB port on the
computer, and the USB port on the 2400/2500.
To use this cable, you must first install Automation Xpress and the USB driver on the computer. See
Table 40 on page 150.
3.2.2 Assign a GPIB Address to the 2400/2500
To connect a computer to the 2400/2500 via GPIB, the 2400/2500 must be assigned a GPIB address. The
procedure below describes how to assign a GPIB address to a 2400/2500.
Table 2 Setup GPIB Address
Step Action
1.
On the front panel of the 2400/2500, press to display the System menus, and if the
SYSTEM 2 menu does not appear in the display, press the bottom-most interactive softkey until it
does.
2.
Enter the desired GPIB address using either the numeric keypad or .
End of Procedure
3.2.3 Configure the Computer’s RS-232 for Remote Operation
Table 3 below gives information for configuring an RS-232 port on a computer to communicate with the
2400/2500.
Table 3 RS-232 Communication Settings
Baud rate 115200
Data Bits 8
Parity None
Stop bits 1
Handshake None
6 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Series Microwave Signal Generators 3. Hardware Interfaces
SYSTEM
3.2.4 Configure the 2400/2500 Ethernet Connection
The following procedure explains how to set the DHCP, IP Address, and Subnet Mask of the 2400/2500
when using the Ethernet (LAN) connector on the rear of the 2400/2500. The instrument is identified via
Ethernet connection during remote operations using the IP address set in this procedure. Each unit on
the network must have a unique IP address.
Table 4 Configure Remote Operation Using the LAN
Step Action
1.
Press to invoke the System menus, and if the SYSTEM 4 menu does not appear in
the display, press the bottom-most interactive softkey until it does.
2. Are you going to connect the LAN using Dynamic Host Configuration Protocol (DHCP), or
configure the LAN connection manually?
If the LAN connection will be done by DHCP: go to the next step.
If the LAN connection will be configured manually: go to Step 4.
3.
Press the DHCP softkey and set DCHP to On using the keys. The instrument will try to
connect to the DCHP server and the IP address and Subnet Mask will be set automatically from
the first server that establishes communication via the LAN connection.
Go to Step 7.
NOTE: If the 2400/2500 fails to connect to the DCHP server, the unit will attempt to reconnect
again. If it fails to connect to the DCHP server a second time, the 2400/2500 will attempt to
reconnect once every hour. During this period, the IP address and subnet mask values will be
zero.
4.
Press the DHCP softkey and set DCHP to Off using the keys.
5. Press the IP Address softkey to highlight the IP Address menu item. Enter the IP address using the
numeric keypad.
NOTE: An IP address consists of four sets of three-digit numbers, separated by decimal points.
The following example demonstrates how to properly enter an IP address:
190.165.001.034
An invalid IP entry will be displayed as Invalid IP Input in the Step Size/Error Message section of
the display. Examples of invalid addresses are values greater than 255, less than zero (negative
sign), values greater than three digits per set or more or less than 4 sets of three-digit values.
6. Press the Subnet Mask softkey to highlight the Subnet Mask menu item. Enter the subnet mask
number using the sequence defined in the previous step.
7. Confirm that the server has connected to 2400/2500 by observing the Link Status menu item.
This menu item is an indicator only. No entry key functions are processed.
End of Procedure
Programming Manual, Part Number 34783, Rev A, July 2009 7
3. Hardware Interfaces Giga-tronics 2400/2500 Series Microwave Signal Generators
This page is intentionally blank
8 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
Chapter 4. Programming Interfaces
4.1 Introduction
This chapter describes the different programming interfaces and methods for remotely controlling a
2400/2500.
4.2 Select the Remote Programming Language
The 2400/2500 can communicate using a variety of languages. Every 2400/2500 is capable of
communications using the SCPI (Standard Commands for Programmable Instruments) language or any
Giga-tronics native command set. Optional Command Sets are available as well.
Table 5 below describes how to use the 2400/2500 front panel in local operating mode to select a
language from the Language Menu.
Table 5 Select the Remote Language
Step Action
1.
• If the instrument IS NOT in remote operating mode, press the LOCAL button once to invoke
the Language menus in the display.
• If the instrument IS IN remote operating mode, press the LOCAL button twice - once to take
it out of remote operating mode, then again to invoke the Language menus in the display.
2. If the desired language does not appear in the parameter area of the display, press the bottommost interactive softkey to go to the next menu. There are three screens for the Language
menus. Use the bottom softkey to go through the screens until you find the language you want
to use.
3. If the message “Option not installed” appears next to a given language in the menu area of the
display, that language is optional and not currently available in the instrument. Contact Gigatronics customer support to inquire about purchasing additional language options.
4. Once you have located the desired language, press the associated interactive softkey in the
display to select it.
End of Procedure
Programming Manual, Part Number 34783, Rev A, July 2009 9
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3 Dynamic Link Library (DLL)
A DLL is a collection of routines that can be used by applications or other DLLs. A DLL is provided on the
CD-ROM that is included with the 2400/2500 Microwave Signal Generator. When you install Automation
Xpress from the CD-ROM onto your computer, the DLL is loaded onto your computer. The routines in
the DLL can be used in Visual C++, Visual Basic, and other applications.
4.3.1 Adding the DLL to Programming Projects
The following procedures describe how to include the DLL into Visual C++ and Visual Basic projects.
4.3.1.1 Add the DLL to a Visual C++ Project
Table 6 Add the DLL to a Visual C++ Project
Step Action
1. Create a Visual C++ project.
2. Copy GT2400.dll from C:\Program Files\Giga-tronics\AX\bin into your project’s executable folder
for run time calls. (e.g. folder named “Debug”)
3. Copy GT2400.lib from C:\Program Files\Giga-tronics\AX\lib into your project.
4. Copy all files from C:\Program Files\Giga-tronics\AX\include into your project.
5. Copy the following line into your application C/C++ files:
“#include “GT2400.h”
6. Make DLL function calls as needed from any .cpp files where GT2400.h file is included.
7. Build your application.
End of Procedure
4.3.1.2 Add the DLL to a Visual Basic Project
Table 7 Add the DLL to a Visual Basic Project
Step Action
1. Create a Visual Basic project.
2. Copy GT2400.dll from C:\Program Files\Giga-tronics\AX\bin into your project’s executable folder
for run time calls.
3. Copy DLLDeclare.bas from C:\Program Files\Giga-tronics\AX\VBModule to the project folder.
4. Make DLL function calls as needed from any files in the project.
5. Build the application.
10 Programming Manual, Part Number 34783, Rev A, July 2009
End of Procedure
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.2 Programming Examples Using the DLL
4.3.2.1 CW Operation Using Visual C++
NOTE: Only bold faced code lines are unique to a specific operation mode. All other lines are supporting
lines shared by both CW and List modes.
Step Description
1.
Perform steps 1 through 5 in Table 6 on page 10 to add the DLL to a Visual C++ project.
2.
Write the following code:
#include "GT2400.h"
#include "stdio.h"
#define SUCCESS 0
//This routine sets CW frequency and power of a 2400/2500
synthesizer
//at your choice through GPIB at address 6.
void main(void)
{
STATUS status;
unsigned long instrumentHandle;
double Frequency = 1000;
double Power = 0;
status = GT2400_OpenConnection(0,6,0,&instrumentHandle);
if(status < SUCCESS )
{
char statusText[256];
GT2400_GetErrorMessage(status, statusText);
printf("Status Message %s\n",statusText);
}
status = GT2400_SetRF(instrumentHandle, 1);
printf("Frequency (MHz) =");
scanf("%lf",&Frequency);
printf("Power (dBm) =");
scanf("%lf",&Power);
status = GT2400_SetCW(instrumentHandle,Frequency,Power,0,0);
status = GT2400_CloseAllConnections();
}
3.
Build the project.
4.
Run the program.
Programming Manual, Part Number 34783, Rev A, July 2009 11
End of Example
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.2.2 Programming Example; CW Operation Using Visual Basic
Step Description
1.
Perform steps 1 through 3 of Table 7 on page 10 to create a Visual Basic project.
2.
Write the following
‘This routine sets CW frequency and power of a 2400/2500
synthesizer
‘through GPIB at address 6.
Dim status As Long
Dim instrumentHandle As Long
Dim Frequency As Double
Dim Power As Double
Dim statusText As String
statusText = Space(100)
status = GT2400_OpenConnection(0,6,0,instrumentHandle)
If status < SUCCESS Then
GT2400_GetErrorMessage(status, statusText)
MsgBox statusText
End If
status = GT2400_SetRF(instrumentHandle, 1)
Frequency = 20000 ‘MHz
Power = 10
status = GT2400_SetCW(instrumentHandle,Frequency,Power,0,0)
status = GT2400_CloseAllConnections()
3.
Build the project.
4.
Run the program.
12 Programming Manual, Part Number 34783, Rev A, July 2009
End of example
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.2.3 Programming Example; List Operation Using Visual C++
Step Description
1.
Perform steps 1 through 5 of Table 6 to create a Visual C++ project.
2. Write the following code:
#include <windows.h>
#include <stdio.h>
#include "gt2400.h"
#define SUCCESS 0
//This routine can load any list file to 2400/2500 synthesizer
//and set up repeat type and trigger type at user choice.
void main(void)
{
long status;
char listFileName[80];
char statusText[256];
unsigned long instrumentHandle;
short tmp;
status = GT2400_OpenConnection(0, 6, 0, &instrumentHandle);
if(status < SUCCESS )
{
GT2400_GetErrorMessage(status, statusText);
printf("Status Message %s\n",statusText);
}
printf("Please enter the file name to be loaded:\n ");
scanf("%s",&listFileName);
status = GT2400_LoadListFromFile(listFileName, statusText);
if ( status < SUCCESS ) //Error during loading
{
GT2400_GetErrorMessage(status, statusText);
printf("Status Message %s\n",statusText);
}
status = GT2400_DownloadList(instrumentHandle, listFileName);
printf("Enter Repeat Type (0 = single step; 1 = single sweep; 2 = continuous) =");
scanf("%d",&tmp);
status = GT2400_SetRepeatType(instrumentHandle, tmp);
printf("Enter Trigger Type (0 = External trigger; 1 = Software trigger or GET) =");
scanf("%d",&tmp);
status = GT2400_SetTriggerType(instrumentHandle, tmp);
status = GT2400_SetRF(instrumentHandle, 1);
status = GT2400_CloseAllConnections();
}
Continued next page
Programming Manual, Part Number 34783, Rev A, July 2009 13
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
Step Description
3.
Build the project.
4.
Run the program.
5.
Send trigger.
End of example
14 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.2.4 Programming Example; Generate Two Frequencies
The following example shows how to write code for generating two CW frequencies, separated by a 40
second delay.
Step Description
//This example sets two CW frequencies in sequence, separated by a 40 second delay.
1.
#include "GT2400.h"
#include "stdio.h"
#include "winbase.h"
void main(void)
{
long STATUS;
unsigned long instrumentHandle;
printf("f= 23.456789 MHz, Power = 5 dBm\n");
STATUS = GT2400_OpenConnection(0, 6, 0, &instrumentHandle);
STATUS = GT2400_SetRF(instrumentHandle, 1);
STATUS = GT2400_SetCW(instrumentHandle, 23.456789, 5);
printf("Waiting for 40 seconds....\n");
//Reserve time for frequency counter to operate correctly
Sleep(40000);
printf("f= 33.4567891 MHz, Power = 0 dBm\n");
STATUS = GT2400_SetCW(instrumentHandle, 33.4567891, 0);
STATUS = GT2400_CloseAllConnections();
}
End of example
Programming Manual, Part Number 34783, Rev A, July 2009 15
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.2.5 Programming Example: List Operation Using Visual Basic
Step Description
1. Perform step 1 through step 3 of Table 7 on page 10 to create a Visual Basic project.
2. Write following:
‘This routine can load any list file to 2400/2500 synthesizer
‘and set up repeat type and trigger type.
Dim status As Long
Dim listFileName As String
Dim statusText As String
Dim instrumentHandle As Long
statusText = Space(100)
status = GT2400_OpenConnection(0, 6, 0, instrumentHandle)
If status < SUCCESS Then
GT2400_GetErrorMessage(status, statusText)
MsgBox statusText
End If
‘Please replace C:\Temp\ListTest.txt with your list file name.
listFileName = “C:\Temp\ListTest.txt”
status = GT2400_LoadListFromFile(listFileName, listFileName)
If status < SUCCESS Then
‘Error during loading
GT2400_GetErrorMessage(status, statusText)
MsgBox statusText
End If
status = GT2400_DownloadList(instrumentHandle, listFileName)
‘Repeat Type (0 = single step; 1 = single sweep; 2 = continuous) =")
status = GT2400_SetRepeatType(instrumentHandle, 1)
‘ Trigger Type (0 = External trigger; 1 = Software trigger or GET) =")
status = GT2400_SetTriggerType(instrumentHandle, 0)
status = GT2400_SetRF(instrumentHandle, 1)
status = GT2400_CloseAllConnections()
3. Build the project.
4. Run the program.
5. Send trigger.
16 Programming Manual, Part Number 34783, Rev A, July 2009
End of example
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.3 DLL Functions
This section describes the DLL functions in detail.
Programming Manual, Part Number 34783, Rev A, July 2009 17
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.3.1 DLL Function; GT2400_FindInstruments
GT2400_FindInstruments
Purpose
Find the addresses of instruments, either through GPIB or RS232, connected to PC.
Syntax
STATUS GT2400_FindInstruments( const short connectionType,
short addresses[],
short *pCount)
Parameter Description
connectionType Input: Connection type.
0 = GPIB,
1 = RS232
2,3 = SPECIAL (NOT FOR COMMON USE)
4 = GPIB Connection via remote SERVER PC (TCP/IP)
addresses Output: Array of GPIB addresses or COM port numbers of all the Giga-tronics
instruments connected.
(Note: In case the RS232 connection interface is selected, the first element returned
in this array is the first serial port that is connected to a Giga-tronics instrument
followed by the remaining serial port numbers on the PC.)
Example 1:
There are total of 4 COM ports on a PC, and only COM port 1 is connected to a Gigatronics instrument, the returned result will be
addresses[0] = 1
addresses[1] = 2
addresses[2] = 3
addresses[3] = 4
Example 2:
There are total of 4 COM ports on a PC, and only COM port 3 is connected to a Gigatronics instrument, the returned result will be
addresses[0] = 3
addresses[1] = 4
pCount Output: Total number of instruments connected to PC through the specified
interface.
18 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.3.2 DLL Function; GT2400_OpenConnection
GT2400_OpenConnection
Purpose
Establish the communication between the PC and the 2400/2500 with the specified connection interface
and address. For an Ethernet connection, call GT2400_SetIPAddress function first to establish the
TCP/IP address of the instrument.
Syntax
STATUS GT2400_OpenConnection( const short connectionType,
const short address,
const short resetDevice
unsigned long *instrumentHandle)
Parameter Description
connectionType Input: Connection interface:
0 = GPIB
1 = RS232
2,3 = SPECIAL (NOT FOR COMMON USE)
4 = GPIB Connection via remote SERVER PC (TCP/IP) (not supported after Revision
3.3)
5 = reserved
6 = Ethernet (TCP/IP) (supported from Rev 3.3)
address Input: GPIB address number if ConnectionType = 0
or COM port number if ConnectionType = 1
Note: GPIB communication board index can be set if GPIB interface is selected. The
2 byte (SHORT) “address” contains GPIB board index and address. The most
significant byte is used to set GPIB board index and the least significant byte is used
to set GPIB address. The default GPIB board index is 0.
Example: GPIB board index = 1; GPIB address = 6
Parameter, address = 0x100 | 0x6 =
0x106 (in Hex.) or 262 (in Decimal)
resetDevice Input:
1 = Reset instrument in start up
0 = No reset
instrumentHandle Output: The unique identification of the connected instrument. This handle can be
used later to operate on multiple instruments.
Programming Manual, Part Number 34783, Rev A, July 2009 19
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.3.3 DLL Function; GT2400_CloseGPIBConnection
GT2400_CloseGPIBConnection
Purpose
Close one specific GPIB connection.
Syntax
STATUS GT2400_CloseGPIBConnection( const unsigned long instrumentHandle)
Parameter Description
instrumentHandle Input: The unique identification of the connected instrument.
20 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.3.4 DLL Function; GT2400_CloseAllConnections
GT2400_CloseAllConnections
Purpose
Close all connection. You should always call this function before you close your application to avoid
memory leak.
Syntax
STATUS GT2400_CloseAllConnections(void)
Programming Manual, Part Number 34783, Rev A, July 2009 21
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.3.5 DLL Function; GT2400_SetGPIBAddress
GT2400_SetGPIBAddress
Purpose
Set the GPIB address.
Syntax
STATUS GT2400_SetGPIBAddress( const unsigned long instrumentHandle,
const short address,
unsigned long *updatedInstrumentHandle)
Parameter Description
instrumentHandle Input: The unique identification of the instrument.
address Input: GPIB address.
updatedInstrumentHandle Output: Updated instrument handle after this function completes.
22 Programming Manual, Part Number 34783, Rev A, July 2009
Giga-tronics 2400/2500 Microwave Synthesizer Series 4. Programming Interfaces
4.3.3.6 DLL Function; GT2400_SetServerIPAddr (for Rev 3.0 and above)
GT2400_SetServerIPAddr (for Rev 3.0 and above)
Purpose
Set the TCP/IP address of remote SERVER PC. (example: 194.177.0.482)
Syntax
STATUS GT2400_SetServerIPAddr( char ipAddr[])
Parameter Description
ipAddr Input: TCP/IP address of remote SERVER PC
Programming Manual, Part Number 34783, Rev A, July 2009 23
4. Programming Interfaces Giga-tronics 2400/2500 Microwave Synthesizer Series
4.3.3.7 DLL Function; GT2400_GetIPAddress (supported from Revision 3.3)
GT2400_GetIPAddress (supported from Revision 3.3)
Purpose
Get the TCP/IP address of the instrument. (example: 194.177.0.482).
Syntax
STATUS GT2400_GetIPAddress( char ipAddr[])
Parameter Description
ipAddr Output: TCP/IP address for the instrument
24 Programming Manual, Part Number 34783, Rev A, July 2009
Loading...