2-2
Sample Programs
C Programming Examples
C Programming Examples
Listings of the C sample programs in this section include:
General Measurement Example 2-2
Service Request Example 2-9
SRQ From GPIB Device Example 2-12
Learn String Example 2-13
SICL I/O Example 2-16
National I/O Example 2-19
Multi-Database Example 2-22
GPIB Header File 2-26
General Measurement Example
In this example, the main function inclues a call to init_IO() which initializes the instrument
and interface so that the instrument can capture data and perform measurements on the
data. At the start of the program, global symbols are defined which will be used to store and
convert the digitized data to time and voltage values. In the transfer_data function, the
header string (header_str) resembles the following string when the information is stripped
off: #510225. The left-most "5" defines the number of digits that follow (10225). The example
number "10225" is the number of points in the waveform. The information is stripped off of
the header to get the number of data bytes that need to be read from the instrument. In the
convert_data function, the data values are returned as digitized samples (sometimes called
quantization levels or q-levels). These data values must be converted into voltage and time
values. In the store_csv function, the time and voltage information of the waveform is stored
in integer format, with the time stored first, followed by a comma, and the voltage stored sec-
ond.
File: init.c
/* init. c */
/*
* Command Order Example. This program demonstrates the order of commands
* suggested for operation of the Agilent 86100 analyzer via GPIB.
* This program initializes the scope, acquires data, performs
* automatic measurements, and transfers and stores the data on the
* PC as time/voltage pairs in a comma-separated file format useful
* for spreadsheet applications. It assumes a SICL INTERFACE exists