Summary of the content on the page No. 1
Programming Guide
AC Power Solutions
Agilent Models 6811B, 6812B, 6813B
6814B, 6834B, and 6843A
Agilent Part No. 5962-0889 Printed in U.S.A.
Microfiche No 6962-0890 December, 1998
Update April 2000
Summary of the content on the page No. 2
Safety Summary The beginning of the ac source User’s Guide has a Safety Summary page. Be sure you are familiar with the information on this page before programming the ac source from a controller. WARNING: ENERGY HAZARD. Ac sources can supply 425 V peak at their output. DEATH on contact may result if the output terminals or circuits connected to the output are touched when power is applied. Printing History The edition and current revision of this manual are indicated below. Reprints of this man
Summary of the content on the page No. 3
Table of Contents Safety Summary 2 Printing History 2 Table of Contents 3 1 - GENERAL INFORMATION 11 About this Guide 11 Earlier AC Source Models 11 Documentation Summary 11 External References 12 SCPI References 12 GPIB References 12 Agilent VXIplug&play Power Products Instrument Drivers 12 Supported Applications 12 System Requirements 13 Downloading and Installing the Driver 13 Accessing Online Help 13 2 - INTRODUCTION TO PROGRAMMING 15 GPIB Capabilities of the AC Source 15 GPIB Address 15 RS-
Summary of the content on the page No. 4
System Considerations 24 Assigning the GPIB Address in Programs 24 Types of DOS Drivers 24 Error Handling 25 Agilent BASIC Controllers 25 3 - LANGUAGE DICTIONARY 27 Introduction 27 Subsystem Commands 28 Calibration Subsystem Commands 29 Subsystem Syntax 29 CALibrate:CURRent:AC 29 CALibrate:CURRent:MEASure 30 CALibrate:DATA 30 CALibrate:IMPedance 30 CALibrate:LEVel 30 CALibrate:PASSword 31 CALibrate:PWM:FREQuency 31 CALibrate:PWM:RAMP 31 CALibrate:SAVE 31 CALibrate:STATe 32 CALibrate:VOLTage:AC 3
Summary of the content on the page No. 5
MEASure:CURRent:HARMonic? FETCh:CURRent:HARMonic? 44 MEASure:CURRent:HARMonic:PHASe? FETCh:CURRent:HARMonic:PHASe? 45 MEASure:CURRent:HARMonic:THD? FETCh:CURRent:HARMonic:THD? 45 MEASure:CURRent:NEUTral? FETCh:CURRent:NEUTral? 45 MEASure:CURRent:NEUTral:AC? FETCh:CURRent:NEUTral:AC? 46 MEASure:CURRent:NEUTral:ACDC? FETCh:CURRent:NEUTral:ACDC? 46 MEASure:CURRent:NEUTral:HARMonic? FETCh:CURRent:NEUTral:HARMonic? 46 MEASure:CURRent:NEUTral:HARMonic:PHASe? FETCh:CURRent:NEUTral:HARMonic:PHASe? 47 Me
Summary of the content on the page No. 6
Source Subsystem (Frequency) 65 Subsystem Syntax 65 FREQuency 65 FREQuency:MODE 65 FREQuency:SLEW 66 FREQuency:SLEW:MODE 66 FREQency:SLEW:TRIGgered 66 FREQuency:TRIGgered 67 Source Subsystem (Function) 68 Subsystem Syntax 68 FUNCtion 68 FUNCtion:MODE 69 FUNCtion:TRIGgered 69 FUNCtion:CSINusoid 70 Source Subsystem (List) 71 Subsystem Syntax 71 LIST:COUNt 72 LIST:CURRent 72 LIST:CURRent:POINts? 72 LIST:DWELl 73 LIST:DWELl:POINts? 73 LIST:FREQuency 73 LIST:FREQuency:POINts? 74 LIST:FREQuency:SLEW 7
Summary of the content on the page No. 7
Source Subsystem (Voltage) 85 Subsystem Syntax 85 VOLTage 86 VOLTage:TRIGgered 86 VOLTage:MODE 87 VOLTage:OFFSet 87 VOLTage:OFFSet:MODE 88 VOLTage:OFFSet:TRIGgered 88 VOLTage:OFFSet:SLEW 89 VOLTage:OFFSet:SLEW:MODE 89 VOLTage:OFFSet:SLEW:TRIGgered 90 VOLTage:PROTection 90 VOLTage:PROTection:STATe 90 VOLTage:RANGe 91 VOLTage:SENSe:DETector VOLTage:ALC:DETector 91 VOLTage:SENSe:SOURce VOLTage:ALC:SOURce 92 VOLTage:SLEW 92 VOLTage:SLEW:MODE 93 VOLTage:SLEW:TRIGgered 93 Status Subsystem 94 Subsystem
Summary of the content on the page No. 8
Trigger Subsystem 107 Subsystem Syntax 107 ABORt 108 INITiate:SEQuence INITiate:NAME 108 INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME 109 TRIGger 109 TRIGger:DELay 109 TRIGger:SOURce 110 TRIGger:SEQuence2:SOURce TRIGger:SYNChronize:SOURce 110 TRIGger:SEQuence2:PHASe TRIGger:SYNCHronize:PHASe 111 TRIGger:SEQuence3 TRIGger:ACQuire 111 TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce 112 TRIGger:SEQuence1:DEFine TRIGger:SEQuence2:DEFine TRIGger:SEQuence3:DEFine 112 Common Commands 113 Commo
Summary of the content on the page No. 9
Specifying a Trigger Delay 135 Synchronizing Output Changes to a Reference Phase Angle 135 Generating Output Triggers 136 Specifying a Dwell Time for Each List Point 136 Making Measurements 137 Voltage and Current Measurements 137 Power Measurements 138 Harmonic Measurements 138 Simultaneous Output Phase Measurements (Agilent 6834B only) 138 Returning Voltage and Current Data From the Data Buffer 139 Regulatory-Compliant Measurement of Quasi-Stationary Harmonics 139 Triggering Measurements 139 S
Summary of the content on the page No. 10
Function Keys 163 Entry Keys 164 E9012 Language Command Summary 164 E - IEC MODE COMMAND SUMMARY 167 Introduction 167 Using the SENSe:CURRent:ACDC:RANGe command 167 Command Syntax 168 CALCulate:INTegral:TIME 169 CALCulate:SMOothing 169 CALCulate:LIMit:UPPer 170 FORMat 171 FORMat:BORDer 172 MEASure:ARRay:CURRent:HARMonic? 173 MEASure:ARRay:VOLTage:FLUCtuations:ALL? 174 MEASure:ARRay:VOLTage:FLUCtuations:FLICker? 176 MEASure:ARRay:VOLTage:FLUCtuations:PST? 177 SENSe:CURRent:PREFerence 178 SENSe:WI
Summary of the content on the page No. 11
1 General Information About this Guide This manual contains programming information for the Agilent 6811B, 6812B, 6813B, 6814B, 6834B, 6843A AC Power Solutions. These units will be referred to as "ac sources" throughout this manual. You will find the following information in the rest of this guide: Chapter 1 Introduction to this guide. Chapter 2 Introduction to SCPI messages structure, syntax, and data formats. Chapter 3 Dictionary of SCPI commands. Chapter 4 Introduction to programming the ac s
Summary of the content on the page No. 12
1 - General Information External References SCPI References The following documents will assist you with programming in SCPI: u Beginner’s Guide to SCPI. Agilent Part No. H2325-90001. Highly recommended for anyone who has not had previous experience programming with SCPI. u Tutorial Description of the General Purpose Interface Bus. Agilent Part No. 5952-0156. Highly recommended for those not familiar with the IEEE 488.1 and 488.2 standards. To obtain a copy of the above documents, contact your l
Summary of the content on the page No. 13
General Information - 1 System Requirements The Agilent VXIplug&play Power Products instrument driver complies with the following: ñ Microsoft Windows 95 ñ Microsoft Windows NT 4.0 ñ HP VISA revision F.01.02 ñ National Instruments VISA 1.1 Downloading and Installing the Driver NOTE: Before installing the Agilent VXIplug&play instrument driver, make sure that you have one of the supported applications installed and running on your computer. 1. Access Agilent Technologies’ Web site at http://www.a
Summary of the content on the page No. 14
Summary of the content on the page No. 15
2 Introduction to Programming GPIB Capabilities of the AC Source All ac source functions except for setting the GPIB address are programmable over the GPIB. The IEEE 488.2 capabilities of the ac source are listed in the appendix A of the User’s Guide. GPIB Address The ac source operates from a GPIB address that is set from the front panel. To set the GPIB address, press the Address key on the front panel and enter the address using the Entry keys. RS-232 Capabilities of the AC Source The ac sour
Summary of the content on the page No. 16
2 - Introduction to Programming RS-232 Programming Example The following program illustrates how to program the ac source using RS-232 to set the output voltage and frequency and to read back the model number and output voltage. The program was written to run on any controller using Microsoft QBasic. NOTE: The ac source must be configured for RS232 and the same baud rate and parity as the controller. ‘ Program to write and read via RS232 ‘ Configure serial port for: ‘ 9600 baud ‘ 7 bit data ‘ 2
Summary of the content on the page No. 17
Introduction to Programming - 2 Introduction to SCPI SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling instrument functions over the GPIB. SCPI is layered on top of the hardware-portion of IEEE 488.2. The same SCPI commands and parameters control the same functions in different classes of instruments. For example, you would use the same DISPlay command to control the ac source display and the display of a SCPI-compatible multimeter. Conventions Used
Summary of the content on the page No. 18
2 - Introduction to Programming The SCPI Command Tree As previously explained, the basic SCPI communication method involves sending one or more properly formatted commands from the SCPI command tree to the instrument as program messages. The following figure shows a portion of a subsystem command tree, from which you access the commands located along the various paths (you can see the complete tree in appendix A). ROOT :OUTPut [:STATe] :COUPling :DFI [:STATe] :SOURce :PROTection :CLEar :DELay :S
Summary of the content on the page No. 19
Introduction to Programming - 2 If you now enter :CLEar, you have reached the end of the command string. The active header path remains at :CLEar. If you wished, you could have entered :CLEar;DELay 20 and it would be accepted as a compound message consisting of: OUTPut:PROTection:CLEAr and OUTPut:PROTection:DELay 20. The entire message would be: OUTPut:PROTection:CLEar;DELay 20 The message terminator after DELay 20 returns the path to the root. The Effect of Optional Headers If a command includ
Summary of the content on the page No. 20
2 - Introduction to Programming Including Common Commands You can combine common commands with system commands in the same message. Treat the common command as a message unit by separating it with a semicolon (the message unit separator). Common commands do not affect the active header path; you may insert them anywhere in the message. VOLTage:TRIGger 7.5;INITialize;*TRG OUTPut OFF;*RCL 2;OUTPut ON Using Queries Observe the following precautions with queries: u Set up the proper number of variab
