Agilent Technologies E4440A User Manual

336 Chapter 5
Programming Fundamentals
Programming in C Using the VTL
Programming Fundamentals
Example Program
This example program queries a GPIB device for an identification
string and prints the results. Note that you must change the address.
/*idn.c - program filename */
#include "visa.h"
#include <stdio.h>
void main ()
{
/*Open session to GPIB device at address 18 */
ViOpenDefaultRM (&defaultRM);
ViOpen (defaultRM, GPIB0::18::INSTR", VI_NULL,
VI_NULL, &vi);
/*Initialize device */
viPrintf (vi, "*RST\n");
/*Send an *IDN? string to the device */
printf (vi, "*IDN?\n");
/*Read results */
viScanf (vi, "%t", &buf);
/*Print results */
printf ("Instrument identification string: %s\n", buf);
/* Close sessions */
viClose (vi);
viClose (defaultRM);
}
Including the VISA Declarations File
For C and C++ programs, you must include the visa.h header file at
the beginning of every file that contains VTL function calls:
#include "visa.h"
This header file contains the VISA function prototypes and the
definitions for all VISA constants and error codes. The visa.h header
file includes the visatype.h header file.
The visatype.h header file defines most of the VISA types. The VISA
types are used throughout VTL to specify data types used in the
functions. For example, the viOpenDefaultRM function requires a
pointer to a parameter of type ViSession. If you find ViSession in the
visatype.h header file, you will find that ViSession is eventually
typed as an unsigned long.

Agilent Technologies E4440A Specifications

General

Brand	Agilent Technologies
Model	E4440A
Category	Measuring Instruments
Language	English

Summary

2. Instrument Functions: A - L

2.1 AMPLITUDE / Y Scale

Controls display of amplitude data, including reference level and scaling.

2.7 FREQUENCY / Channel

2.8 Input/Output

3. Instrument Functions: M - O

3.1 Marker

Controls marker functions for measuring trace data points.

3.4 MEASURE (Spectrum Analysis Mode)

Provides access to measurement setup and configuration options.

3.6 MODE and Mode Setup

4. Instrument Functions: P - Z

4.1 Peak Search

Locates and analyzes peaks on the trace based on defined parameters.

4.2 Preset

4.5 Save

Saves analyzer states, traces, and screen data to storage.

4.7 SPAN / X Scale

Adjusts the displayed frequency range and X-axis scale.

4.8 SWEEP

Controls sweep time and mode for signal acquisition.

4.9 System

5. Programming Fundamentals

SCPI Language Basics

Introduces the SCPI programming language, keywords, syntax, and parameters.

Improving Measurement Speed

Provides techniques to optimize program execution and measurement speed.

Programming Command Compatibility Across Model Numbers and Across Modes

Using the LAN to Control the Instrument

Explains how to control the instrument using LAN connectivity.

Programming in C Using the VTL

6. Using the STATus System

Using the Status Registers

Common Using the STATus System IEEE Commands

STATus Subsystem

Explains the SCPI-defined instrument-status reporting structures and registers.

7. Menu Maps: Spectrum Analysis

FREQUENCY Channel Key (See page 143)

Input/Output Key (See page 151)

Marker Key (See page 167)

Details the menu structure for controlling marker functions on the trace.

Marker --> Key (See page 185)

Marker Fctn Key (See page 179)

MODE Key (See page 195)

Peak Search Key (See page 203)

Shows the menu flow for performing peak searches on trace data.

Preset Key (See page 211)

Print Setup Key (See page 215)

SPAN X Scale Key (See page 227)

Details the menu structure for adjusting span and X-axis scale.

Sweep Key (See page 231)

Shows the menu paths for controlling sweep time and mode.

System Key, 1 of 4 (See page 241)

Trace/View Key (See page 277)

Trig Key (See page 281)

Details the menu paths for setting trigger conditions for sweeps and measurements.