Agilent E1418A User Manual

Download

Agilent 75000 Series C

Agilent E1418A 8/16-Channel D/A Converter Module

User’s Manual and SCPI Programming Guide

Where to Find it - Online and Printed Information:

System installation (hardware/software)............. VXIbus Configuration Guide*

Agilent VIC (VXI installation software)*

Module conf i gur at i on and wiring....................... . This Manual

SCPI programming.............................................. This Manual

SCPI example programs...................................... This Manual

SCPI command reference ................................... This Manual

VXIplug&play programming ........ ..................... VXIplug&play Online Help

VXIplug&play example programs...................... VXIplug&play Online Help

VXIplug&play function referenc e ............. ......... VXIplug&play Online Help

Soft Front Panel information............................... VXIplug&play Online Help

VISA language information................................ Agilent VISA User’s Guide

Agilent VEE programming information ............. Agilent VEE User’s Manual

*Supplied with Agilent Command Modules, Embedded Controllers, and VXLink.

*E1418-90002*

Manual Par t N um be r: E14 18-90002

Printed in Malaysia E0706

Contents

Agilent E1418A User’s Manual

Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Safety Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

WARNINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Declaration of Conformity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

User Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 1. Module Setup and Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Using This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Module Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Ordering Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Field Kits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Terminal Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Functional Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Front Panel Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Setting the Logical Address Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Module Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Installation in a Mainframe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Terminal Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Screw-Type Terminal Module (Standard) . . . . . . . . . . . . . . . . . . . . . . 22

Wiring the Terminal Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Attaching the Terminal Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Removing the Terminal Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Terminal Module Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Option A3E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Option A3H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Option 135 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Terminal Module Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Configuring the Terminal Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

P/J Jumper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

V/I Jumper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Terminal Module Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Voltage and Current Output Connections . . . . . . . . . . . . . . . . . . . . . . 33

Combining Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Connecting an External Trigger Source . . . . . . . . . . . . . . . . . . . . . . . 35

Using the CAL Output Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Initial Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Device Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Module Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Agilent E1418A User’s Manual Contents 1

Chapter 2. Pr ogramming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Using This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Program Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Querying Module Identification and Configuration . . . . . . . . . . . . . . . . . . . . 40

Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

APPLy Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Error Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

I/O Error Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

SCPI Error Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

SOURce Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Setting the Output Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Controlling the Output Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Triggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Using *OPC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Combining Output Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Chapter 3. Agi len t E1418A SCPI Co mmand Refer e n c e . . . . . . . . . . . . . . . . . . . 59

Using This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Command Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Common Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

SCPI Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Linking Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

SCPI Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

ABORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

APPLy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

APPLyn:CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

APPLyn:VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

CALibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

CALibration:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

CALibration:CONFigure:RESistance? . . . . . . . . . . . . . . . . . . . . . . . . 68

CALibration:RESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

CALibration:STORe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

CALibration:TEST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

CALibration:VALue:RESistance . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

CALibrationn:CONFigure : CU RRe nt ? . . . . . . . . . . . . . . . . . . . . . . . . 71

CALibrationn:CONFigure : V OLT a ge? . . . . . . . . . . . . . . . . . . . . . . . . 72

CALibrationn:VALue:CURRent? . . . . . . . . . . . . . . . . . . . . . . . . . . 73

CALibrationn:VALue:VOLTage? . . . . . . . . . . . . . . . . . . . . . . . . . . 74

DIAGnostic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

DIAGnostic:CALibration:OUTPut[:MODE] . . . . . . . . . . . . . . . . . . . . 76

DIAGnostic:CALibration:OUTPut[:MODE]? . . . . . . . . . . . . . . . . . . . . 77

DIAGnostic:CONFigure? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

DIAGnostic:OUTPut:ALL[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . 78

DIAGnostic:SOURcen:FUNCtion:MODE . . . . . . . . . . . . . . . . . . . . . . 78

DIAGnostic:TRIGgered? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

INITiate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

INITiate[:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

2 Agilent E1418A User’s Manual Contents

Chapter 3. Agi len t E1418A SCPI Co mmand Refer e n c e (continued)

OUTPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

OUTPut:TTLTrgn[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

OUTPut:TTLTrgn[:STATe]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

OUTPutn[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

OUTPutn[:STATe]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude] . . . . . . . . . . . . . 85

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude]? . . . . . . . . . . . . . 86

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] . . . . . . . . . . . . . . 87

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude]? . . . . . . . . . . . . . . 88

SOURcen:FUNCtion:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

SOURcen:FUNCtion:MODE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude] . . . . . . . . . . . . . 91

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude]? . . . . . . . . . . . . . 92

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude] . . . . . . . . . . . . . . 93

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude]? . . . . . . . . . . . . . . 94

STATus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

STATus:OPERation:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . . 96

STATus:OPERation:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

STATus:OPERation:ENABle? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

STATus:OPERation[:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

STATus:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

STATus:QUEStionable:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . 98

STATus:QUEStionable:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

STATus:QUEStionable:ENABle? . . . . . . . . . . . . . . . . . . . . . . . . . . 99

STATus:QUEStionable[:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . 99

SYSTem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

SYSTem:ERRor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

SYSTem:VERSion? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

TEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

TEST:NUMBer? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

TEST:TST[:RESults]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

*TST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

TRIGger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

TRIGger[:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

TRIGger:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

TRIGger:SOURce? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

IEEE-488.2 Common Comma nd Quick Reference . . . . . . . . . . . . . . . . . . . . 106

Agilent E1418A Command Quick Reference . . . . . . . . . . . . . . . . . . . . . . . 107

Appendix A. Agilent E1418A Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . 111

DC Voltage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

DC Current . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

General Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Power Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Cooling Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Agilent E1418A User’s Manual Contents 3

Appendix B. A gilent E1418A Reg ister-Based Pr ogramming . . . . . . . . . . . . . . . . . 113

Addressing the Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

A16 Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

A24 Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

The Base Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Reset and Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

A16/A24 REGISTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

A24 REGISTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Manufacturer ID Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Logical Address Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Device Type Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

VXI Status/Control Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

VXI Offset Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Calibration Control Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Card Configuration Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Software Trigger Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Trigger Control Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Interrupt Status Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Isolation Status Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Channel Program Jumper Register . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Channel Trigger Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Channel Mode Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Channel Relay Control Register . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Card Control Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Main_DAC Immediate Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Main_DAC Triggered Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Offset_DAC Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Gain_DAC Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Undefined Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Channel Voltage Offset Calibration Registers . . . . . . . . . . . . . . . . . . . . 140

Channel Voltage Gain Calibration Registers . . . . . . . . . . . . . . . . . . . . . 141

Channel Current Offset Calibration Registers . . . . . . . . . . . . . . . . . . . . 142

Channel Current Gain Calibration Registers . . . . . . . . . . . . . . . . . . . . . 143

Calibration Resistor Value Registers . . . . . . . . . . . . . . . . . . . . . . . . . 144

Voltage Calibration Status Register . . . . . . . . . . . . . . . . . . . . . . . . . 144

Current Calibration Status Register . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Calibration Isolation Status Register . . . . . . . . . . . . . . . . . . . . . . . . . 146

Calibration Card Configuration Register . . . . . . . . . . . . . . . . . . . . . . . 147

Calibration Checksum Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Module Serial Number Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

4 Agilent E1418A User’s Manual Contents

Appendix C. Agilent E1418A Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . 151

Error Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Appendix D. Voltage/Current Output Adjustment . . . . . . . . . . . . . . . . . . . . . . 155

Using This Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Calibration Constants and Non-Volatile Memory . . . . . . . . . . . . . . . . . . . . 156

Equipment Required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Making Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Adjustment Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Voltage Adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Current Adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Storing the Adjustments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Return the Module to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Example Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Appendix E. Configuration and Disassembly . . . . . . . . . . . . . . . . . . . . . . . . . 167

Using This Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Checking Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Changing Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Adding 8 Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Installing Isolated/Non-I sola te d P l ug-on Modules . . . . . . . . . . . . . . . . . . 172

Troubleshoot in g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Isolating an Assembly (Self-Test) . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Assembly Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

To Exchange an Assembly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Agilent E1418A User’s Manual Contents 5

Notes

6 Agilent E1418A User’s Manual Contents

Certification

Agilent Technologies certifies that this product met its pub lished specificat ions at the time of shipment from the factory. Agilent Technologie s further certifies tha t its calibr ation measure ments are trac eable to the Unit ed States Nati onal Ins titute of Stan dards and Technology (formerly Nati onal Bureau of S tandards), to the ex tent allowed by that organizat ion’s calibrat ion facility , and to the calibration facilities of other International Standards Organization members.

Warranty

This Agilent Technologies product is warranted against defects in materials and workmanship for a period of one (1) year from date of shipment. Duration and conditions of warranty for this product may be superseded when the product is integrated into (becomes a part of) other Agilent products. During the warranty period, Agilent Technologies will, at its option , e ith er repair or r ep la ce p ro d ucts which prove to be def ec tive.

For warrant y servic e or repair, t hi s product m ust be returned to a service facility designated by Agilent Technologies. Buyer shall prepay shipping charges to Agilent and Agil ent shall pay shippi ng charge s to retur n t he product to Buy er . H ow ever, Buye r shall pay a ll shipping charges, duties, and ta xes for product s re t urned to Agil ent fr om another cou n t ry.

Agilent warrants that its software and firmware designated by Agilent for use with a product will execute its programming instructions when properly installed on that product. Agilent does not warrant that the operation of the product, or software, or firmware will be uninterrupt ed or error free .

Limitation Of Warranty

The foregoi ng warranty shall n ot apply to defects res ul ting from im pr oper or inadequate maintenance by Buye r, B uyer-suppli ed products or interfacing, unauthori zed modific ation or mis use, operat ion outs ide of the envi ronmenta l specific ations for the prod uct, or improper site preparation or mainte na nce.

The design and implementation of any circuit on this product is the sole responsibility of the Buyer. Agilent does not warrant the Bu yer ’s circuitry or malfunctions of Agilent products that result from the Buyer’s circuitry. In addition, Agilent does not warrant any damage th at occurs as a r es ul t of th e B uyer’s circu it or any defects tha t res ul t fro m Bu yer-supplie d products.

NO OTHER WARRANTY IS EXPRESSED OR I MPLIED. Agilen t SPECIFICALLY DISCLAIM S THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Exclusive Remedies

THE REMEDIES PROVIDED HEREIN ARE BUYER’S SOLE AND EXCLUSIVE RE MEDIES. Agilent SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER BASED ON CONTRACT, TORT, OR ANY OTHER LEGAL THEORY.

Notice

The information contained in this document is subject to change without notice. Agilent Technologies MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCL UDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Agilent shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. This document contains proprietar y information whi ch is protected by copy right. All rights are reserved. No part of this docume nt may be phot ocopied, rep roduced, or translat ed t o anot her l anguag e wi thout the prior w ritten consent of Agilent Technologies, Inc. Agilent assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Agilent.

U.S. Government Restricted Rights

The Software and Documentation have been developed entirely at private expense. They are delivered and licensed as "commercial computer software" as defined in DFARS 252.227- 7013 (Oct 1988), DFARS 252.211-7015 (May 1991) or DFARS 252.227-7014 (Jun

1995), as a "com mercial ite m" as defined in FAR 2.101(a), or as "Restri cted comput er software" as defi ned in FAR 52.227-19 (Jun 1987)(or any equival ent agen cy reg ulati on or contra ct cla use ), which ever i s appli cabl e. You hav e only t hose r ight s provide d for suc h Software and Documen ta t io n by t h e a pplicable FA R or DF A R S cl ause or the Agi l ent standard sof tware agree m ent for the prod uct involved.

Agilent E1418A 8/16 Channel D/A Converter Module User’s Manual

Edition 2 Rev 2

Agilent E1418A 8/16 D/A Converter Module User’s Manual 7

Printing H is tory

The Printing History shown below lists all Editions and Updates of this manual and the printing date(s). The first printing of the manual is Edition 1. The Editi on number increments b y 1 when eve r th e ma nua l is revised. Updates, wh ich ar e is sued between Editions, contain replacement pages to correct the current Edition of the manual. Updates are numbered sequentially starting with Update 1. When a new Edition is crea ted, it cont ains all the Upda te i nfor mat ion for the p revious Ed ition. E ach ne w E dition or U pdat e a lso incl udes a re vised copy of this prin ti ng history page. M an y pr oduct updat es or rev is i ons do not requ ir e manual changes and, conver sely, manu al correc tions may be done without accompanying product changes. Therefore, do not expect a one-to-one correspondence between product updates and manual updates.

Edition 1 (P ar t Num ber E1418 -90 001). . . . . . . . . . . . . . . . . . . . . . October 1995

Edition 2 (P ar t Num ber E1418 -90 002). . . . . . . . . . . . . . . . . . . . . . October 1996

Edition 2 Rev 2 (Pa rt N um ber E1418-9000 2) . . . . . . . . . . . . . . . . . . . July 2006

Safety Symbols

Instructi on manual sy mbol affixed to product. Indic ates that the user m u st refe r to the manual for specific WARNING or CAUTION informatio n to avoi d personal injury or damage to the pr oduct.

Alternating current (AC).

Direct current (DC).

Indicates t he field wir ing termina l that must be connec ted to earth gr ound before op erating the equipment—protects against electrical shock in case of fault.

Frame or chassis ground terminal—typically connects to the equipment’s metal frame.

WARNING

CAUTION

Indicate s ha zardous vol ta ges.

Calls a tt e ntion to a procedure, practi ce, or c ondition that could cause bodi l y i nj ury or death.

Calls attention to a proce dur e, practice, or con dition that could possibly cause damage to equipme nt or pe rm anent loss of dat a.

WARNINGS

The following general safety precautions must be observed during all phases of operation, service, and repair of this product. Failure to comply with these precau tions or w ith specific warnings elsewher e in this manual viol ates safe ty standard s of design, manufacture, and intended use of the product. Agilent Technologies assumes no liability for the customer’s failure to comply with these re qu i remen ts .

Ground the equipment: For Safety Class 1 equipment (equipment having a protective earth terminal), an uninterruptible safety earth

ground must be provided from t he m ains power s our ce to the product i nput wiring ter m i nals or suppli ed power cable .

DO NOT operate the p r od uct in an ex pl osive atmo sp here or in the pres ence of flammable ga ses or fume s.

For continued protection against fire, replace the line fuse(s) only with fuse(s) of the same voltage and current rating and type. DO NOT use re pai r ed fuses or sho rt-c ircuited fu se holders.

Keep away fr om live circuit s: Ope ra t in g personnel mus t not remove equi pm ent covers or s hi el ds . Pr oc edures involvi ng the remova l of covers or shields are for use by service-trained personnel only. Under certain conditions, dangerous voltages may exist even with the equipmen t switch ed off. To avoid da ngerou s elec trica l shoc k, DO NOT perform proced ures invo lvin g cover or shield re mova l unless you are qualified to do so.

DO NOT operate damaged equipment: Whenever it is possib le that the safety prote ction features built into this prod uct have been impaired, either through physical damage, excessive moisture, or any other reason, REMOVE POWER and do not use the product until safe oper at i on can be verified by service-trained personnel . If nece ss ar y, return th e product to an Agilent Technologies Sales and Ser vice Office for service and repair to ensure that safety features are maintained.

DO NOT serv ice or adjust al one: Do not at tempt inte rnal ser vice or adjus tment unles s anot her per son, ca pabl e of renderi ng first aid and resuscitatio n, is present.

DO NOT substitute parts or modify equipm ent: Because of the danger of introducing additional hazards, do not install substitute parts or perform any unauthorized modification to the product. Return the product to an Agilent Technologies Sales and Service Office for service and repair to ensure that safety features are maintained.

8 Agilent E1418A 8/16 D/A Converter Module User’s Manual

DECLARATION OF CONFORMITY

According to ISO/IEC Guide 22 and CEN/CENELEC EN 45014

Manufacturer’s Name: Manufacturer’s Address:

Agilent Technologies, Incorporated 815 – 14th St. SW Loveland, Colorado 80537 USA

Declares, that the product

Product Name: Model Number:

16 Channel 16 Bit D/A Converter E1418A, E1523A, E1524A, E1525A

Product Options: This declaration covers all options of the above product(s).

Conforms with the following European Directives:

The product herewith complies with the requirements of the Low Voltage Directive 73/23/EEC and the EMC Directive 89/336/EEC (including 93/68/EEC) and carries the CE Marking accordingly.

Conforms with the following product standards: EMC Standard

IEC 61326-1:1997+A1:1998 / EN 61326-1:1997+A1:1998 CISPR 11:1990 / EN 55011:1991 IEC 61000-4-2:1995+A1:1998 / EN 61000-4-2:1995 IEC 61000-4-3:1995 / EN 61000-4-3:1995 IEC 61000-4-4:1995 / EN 61000-4-4:1995 IEC 61000-4-5:1995 / EN 61000-4-5:1995 IEC 61000-4-6:1996 / EN 61000-4-6:1996 IEC 61000-4-11:1994 / EN 61000-4-11:1994

Canada: ICES-001:1998 Australia/New Zealand: AS/NZS 2064.1

Safety

The product was tested in a typical configuration with Agilent Technologies test systems. IEC 61010-1:1990+A1:1992+A2:1995 / EN 61010-1:1993+A2:1995

Canada: CSA C22.2 No. 1010.1:1992 UL 3111-1: 1994

Limit

Group 1 Class A 4kV CD, 8kV AD 3 V/m, 80-1000 MHz

0.5kV signal lines, 1kV power lines

0.5 kV line-line, 1 kV line-ground 3V, 0.15-80 MHz I cycle, 100% Dips: 30% 10ms; 60% 100ms Interrupt > 95%@5000ms

20 March 2003

Date

For further information, please contact your local Agilent Technologies sales office, agent or distributor.

Ray Corson

Product Regulations Program Manager

Agilent E1418A 8/16 D/A Converter Module User’s Manual 9

Notes

10 Agilent E1 41 8A 8/16 D/A Conv er te r Module User ’ s M an ua l

Notes

Agilent E1418A 8/16 D/A Converter Module User’s Manual 11

Notes

12 Agilent E1 41 8A 8/16 D/A Conv er te r Module User ’ s M an ua l

Using This Chapter

This chapter provi de s ge ne ral m odule information and tasks you must perform to install a nd pr ep are your module. A procedu re to ve rif y your installatio n is a lso gi ve n. The ch a pte r is divided into the fol lowing sections:

Chapter 1

Module Setup and In stallatio n

• Module Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 13

• Functional Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 16

• Front Panel Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 18

• Setting the Logical Address Switch. . . . . . . . . . . . . . . . . . . . Page 19

• Module Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 20

• Terminal Modul es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 22

• Wiring the Terminal Module. . . . . . . . . . . . . . . . . . . . . . . . . Page 23

• Attaching the Terminal Module. . . . . . . . . . . . . . . . . . . . . . . Page 25

• Removing the Terminal Module . . . . . . . . . . . . . . . . . . . . . . Page 26

• Terminal Modul e Options . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 27

• Terminal Modul e Conne c tors . . . . . . . . . . . . . . . . . . . . . . . . Page 30

• Configuring the Terminal Module. . . . . . . . . . . . . . . . . . . . . Page 31

• Terminal Module Connections . . . . . . . . . . . . . . . . . . . . . . . Page 33

• Initial Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 37

Module Description

The Agilent E1418A is an 8 or 16 cha nne l digital-to-ana log converter module for us e in a VXI bus C-size mainf r am e . The module is a register-base d de vic e . The module can be progra mm e d via dir e ct regis te r access or, with th e appr opriate driver, by high level comm ands. This manual describes programmi ng the module using SCPI ( Sta ndard Commands for Programmable Instruments) and the SC PI dr iver.

Each Agilent E1418A module is a uniqu e instrument havin g its own output buffer and error qu eu e. Multiple modules cannot be combin ed into a single instrument.

Each channel can be co nf igur e d to e ither voltage or cur r en t output mode. When configu red f or volt ag e ou tput, voltages in the range of -16.0 to +16.0 Volts can be set. When configured for current output, current in the range of -0.02 to + 0.0 2 Amps can be set. The channe l output mode can be programmatic a lly se t, or , can be fo rced to e ither voltage or cur r en t by mechanica l jum p e r s on the te r minal module.

Chapter 1 Module Setup and Instal lation 13

Each output ch annel is individ u a lly c onfigurable to be eit he r an isolated output or a non-isolated output. Cha nne l c onfiguration to isolate d or non-isolated is made by individual plug-on modules for each channel.

Figure 1-1 shows the module.

Figure 1-1. The E1418A 8/16-Channel D/A Converter

with Terminal Module

14 Module Setup and Installati on Cha pter 1

Orderin g Options The Agilent E1418A may be order e d from Agilent Technologies in a

variety of configura tions. As ordered, the module has the following options:

Description

E1418A 8-Channel D/A Converter with Non-Isolat ed O ut pu ts E1418A Option 001 16-Channel D/A Converter with Non-Isolated Outputs E1418A Option 002 8-Channel D/ A C onve rter with I sol ated O ut puts E1418A Option 003 16-Channel D/A Converter with Isolated Outputs

Field Ki ts The mod ule can a lso be us er c onf igured as described be ginning on page 167

of this manual. The following field expansion and configuration kits are available:

Description Use

E1523A Single Channel Isola te d

plug-on module

E1524A Expansion kit, 8-C han nel

Non-Isolated Output s

E1525A Expansion kit, 8-C han nel

Isolated Outputs

To change a single channel from non-isolated to isolat ed ou tp ut .

To add 8 additional non-isolated channels to an existi ng 8- cha nnel module.

To add 8 additional isol at ed cha nnel s t o an existing 8-channel m odule.

Terminal Modules The standard Agilent E1418A Terminal Module provides screw terminals

for connect ions. Two other ter minal optio ns a re a va ila ble with the Agilent E1418A:

– Crimp and Inser t (Option A3E) – Ribbon Cable (Option A3H) – Terminal Modul e Hou sing without a termina l module PC board or

connectors inc lude d (O pti on 135)

Chapter 1 Module Setup and Instal lation 15

Functional Description

The Agilent E1418A prov ide s gr e at flexibility in config ur at ion. This functional de sc ri ption will help you be c ome f am iliar with the v arious configurations and how the module is struc tur ed . A functi ona l block diagram is shown in Figure 1-2.

Figure 1-2 . A Funct ional Block Di a gr a m

Each channel MUST have either an isol ated or non- is olat ed pl ug- on m odu le ins talled. Channels may be co nf ig ure d

using any combinatio n of Isola te d and Non-Isolated plu g-o n mo dules.

16 Module Setup and Installati on Cha pter 1

As shown, there are four major assemblies that make up an Agilent E1418A:

– Channels 1 through 8 main board and VXIbus backplane circuitry. – Channels 9 through 16 expansion board. – Isolated or Non-isolated plug- on modules. – Terminal Module.

Channels 1–8 main board and VXIbus b ac kplane cir cuitr y.

This assembly contain s all the VXIbus interf ace an d decodin g circui t ry . Isolated and Non -Iso la te d plug-on module s fo r chan nels 1–8 connect to this assembly. The panel connectors for the terminal module are als o mounted on this assembly.

The optional Channels 9–16 expansion board is electrically connected and mechanically mounted to the main board. Isolated and Non-Isolated plug-on module s f or ch an ne ls 9–16 connect to thi s as se mbly.

Isolated or Non-isolat ed plug -on module s a re re quir e d fo r ever y c ha nne l. Eight plug-on modules mount to the main board a nd 8 plug-on module s mount to the exp an sion board. Any com bina ti on of isolated or non-isol at ed plug-on module s may be used, but ev ery c ha nne l must have a plug-on module insta lle d.

The Terminal Module shown in Figure 1-2 is the standa r d sc rew-type terminal module. This module provides screw connections for each channel output, the cal ibra tion connections, and the extern a l trigger in connecti ons. This module also contains two jumpers for each channel; one, called the P/J Jumper, to enabl e or disable VXIbus progra mm ing of the c ha nne l mode (either voltage or cu rre nt) a nd one , called the V/I Jumpe r , to se t the ch an ne l mode when the P/J Jumper is in the Jumper posi tion.

Chapter 1 Module Setup and Instal lation 17

Front Panel Connectors

Figure 1-3 shows th e connections at the f ro nt pa ne l c onne c tors of the ma in module.

Figure 1-3. E1418A Front Pan e l Connect or Pinout

18 Module Setup and Installati on Cha pter 1

Setting the Logical Address Switch

Figure 1-4 shows the logical address switch location and setting. The logical address switch factory setting is 72. Valid addresses range f rom 1 to 255.

When used with an Agilent Command Module the factory set address of decimal 72 results in a module address of 9 (72 divided by 8). The module address is used as a se co nda ry ad dr es s whe n using GPIB and a Command Module. For exam ple , the module addres s ma y be 7 09 09, whe re 7 is the GPIB interface address, 09 is the command module address, and 09 is the Agilent E1418A address .

The Agilent E1418A su pports dynamic addre ss c onfiguration. Whe n you set the logical add ress to 255, the res ourc e m an ager sets the logic a l ad dr es s programmatically.

Note When using an Agilent C-size mainframe with the Agilent E1405/E1406

Command Modules, the logical address setting must be a multiple of 8.

Figure 1-4. Setting the Logical Address

Chapter 1 Module Setup and Instal lation 19

Module Installation

To install the module:

1. Verify the position of the CAL S tor e Enab le Jump er f or your application. The Ju mpe r , as sh ippe d, is in the CAL position. In this position, a cal ibr a tion may be performe d a nd the results store d in non-volatil e m emor y. In the Secured pos ition, a calibration may be performed, but may NOT be stored in non-volatile memor y. This jumper is descri be d in more detail on page 157.

2. Verify or set the logical address switch a s shown in Figure 1-4 .

3. Install the module in a mainframe as shown in Figure 1-5.

Installat io n in a

Mainframe

The Agilent E1418A m ay be in sta lle d in any slot (exc ep t slot 0 ) in a C-si ze VXIbus mainf ram e. To install in a mainfr am e :

1. Set the extr a ction levers out. Slide the mo dule into any slot (except slot 0) until the backplan e connectors touch.

2. Seat the module by moving the levers toward each other.

3. Tighten the top a nd bottom screws to secure the mod u le in the mainframe.

Figure 1-5. Installing the E1418A in a VXIbus Mainframe

20 Module Setup and Installati on Cha pter 1

To Remove a Module: To remove a module from a mainframe:

1. Remove any te rm ina l m odules.

2. Loosen the top and bottom screws secur ing th e m odule in the mainframe.

3. Move the extraction levers away from each other. As the levers are moved, the module will detach from the ba ck pla ne co nne c tor s.

4. Slide the module out.

Note The extracti on levers will not seat and unseat the backplane connec tors on

older Agilent VXIbus ma inf r a mes a nd non-Agilent m ai nframes. You must manually seat the connectors by pushing the module into the mainframe until the front pa ne l is f lush with the front of the mainframe . The e xtr a ct ion levers may be used to guide or remove th e m odul e.

Chapter 1 Module Setup and Instal lation 21

Terminal Modules

Four terminal mo dule s a re ava ila ble for the Agilent E1418A; a screw-type, a crimp-and-inse r t type, a ribbon cable type , an d an em pty te r mi na l housing (without a PC board or c onne c tors) .

Screw-Type

Terminal Module

(Standard)

The standard te r minal module use s sc rew - type terminals to make connections. Figu re 1-6 ma y be photocopied and used for wiring layout.

Figure 1-6. Screw-Type Terminal Module Layout

22 Module Setup and Installati on Cha pter 1

Wiring the Terminal Module

Figure 1-7 shows how to open a nd wir e the E1418A te rminal module.

Figure 1-7. Wiring the E1418A Terminal Module

(

Chapter 1 Module Setup and Instal lation 23

continued on next page)

Figure 1-7. Wiring the E1418A Terminal Module

(

continued from pr evious page)

24 Module Setup and Installati on Cha pter 1

Attaching the Terminal Module

Figure 1-8 shows how to attach the E1418A terminal module.

Figure 1-8. Attaching the E1418A Terminal Module

Chapter 1 Module Setup and Instal lation 25

Removing the Terminal Module

Figure 1-9 shows how to remove the E1418A terminal module.

Figure 1-9. Removing the E1418A Terminal Module

26 Module Setup and Installati on Cha pter 1

Terminal Module Options

Besides the standa r d sc rew-type terminal mo dule , the Agile nt E1418A can be ordered with the following two options. One opt ion (A 3E) pr ovides crimp-and-in se rt con ne ct or s an d te rmina l housing. The other option (A3H) provides a ribbon cab le con ne cto r and term ina l housing.

Option A3E Agilent E1418A Option A3E can be ordered if a crim p- an d- inse rt te r minal

module is desi red. This allows you to crim p co nne c tors onto wires which are then inserted directly into the Agilent E1418A faceplate connector. Refer to the pin-out diagr am on pa ge 30 to m ak e th e connections. The crimp-and-insert connector is shown in Figure 1-10.

Note The pin numbering on the crimp-and-insert connector may not agree with the

pin numbering on the Agilent E1418’s faceplate connector. Use the pin numbering on the faceplate connector to wire the crimp-and-insert connector.

Figure 1-10. Option A3E Crimp-and-Insert Connector

Chapter 1 Module Setup and Instal lation 27

Crimp-and-Insert

Terminal Module

Accessories

The following access ories are necessary for use with crimp-and-i nsert Option A3E:

Single-C onductor and

Contact

Shielded-Twisted-Pair and

Contacts

A crimp-and-ins ert cont act is crimped onto one end of a wir e. The other end is not terminate d. Ord er Agil en t 91510A.

A crimp-and-insert contact is crimped onto each conductor at one end of a shielded-twisted-pair cable. The other end is not terminated. Order Agilent 91511A.

Jumper Wire and Contacts A crimp-and-insert contact is crimped onto each end of a single-conductor

jumper wire. Th is jumper is typically used to tie two p ins together in a single crimp-a nd- insert connecto r. Order Agilent 91512A.

Crimp-and-Insert Contacts These contacts may be crimped on to a con duc tor a nd the n inserted into a

crimp-and-in se rt con n e cto r . The crimp tool kit is required to crimp the contacts onto a conductor and remove the c onta c t fro m the c onne c tor . Order Agilent 91515A.

Crimp-a nd-Insert Tools The hand crimp tool ( pa rt number Agilent 9151 8A) is used f or crim ping

contacts onto a con duc tor . The pi n ex tr actor tool (part number Agilent 91519A) is requ ir ed for r emoving contacts fr om the crimp-and-insert connector. These products are not included with

Option A3E or with the terminal option accessories listed earlier.

28 Module Setup and Installati on Cha pter 1

Extra Crimp-and-Insert

Connectors

Option A3H The Ribbon Cable Connector Terminal Option provides a termina l housing

Note In Figure 1-12, the cen ter row of each conne c tor is not used in the ribb on

The crimp-and-ins ert c onnector is normally supplied with Opt ion A3E. Contact Agilent Technologies if additional connectors are ne ed ed . Order Agilent 91484B.

and ribbon cable connectors. The conne c tors a re designed to be used with 64-pin 0.05 inch ce n ter rib bon c a ble s (not pr ovided). Use Figure 1-1 2 to make the connec tions.

cable. The center row of bo th conne c tor s is module ground (GND).

Figure 1-1 1 . Option A3H Ribbon Ca ble C onnector

Option 135 The Terminal Mo dule Housing Option provide s a term inal housing with no

connectors of any type.

The user-supplied co nne c tor must be a DIN 41612 type C female ,

11.6 mm dimension as shown above.

Chapter 1 Module Setup and Instal lation 29

Terminal Module Connectors

Figure 1-12 shows the connections at the terminal module connectors.

Figure 1-12. E1418A Terminal Module Connector Pinout

30 Module Setup and Installati on Cha pter 1

Configuring the Terminal Module

The screw-type terminal module conta ins jumpers th at con tr ol how the Agilent E1418A ope rates. The jumpers are shipped in a sepa r at e bag wit h the terminal module. The Agilent E1418A will operate without any jumpers inst alled. You can, howe v e r , st ore the jumpers on th e te rminal module for later r econfiguration . Figur e 1-1 3 shows the jumper loca tions and example sett ings.

There are two jumpers for each channel; a P/J jumper and a V/I jumper. The two jumper s w or k toge ther.

Figure 1-13. P/J and V/I Jumpers

P/J Jum p er The P/J jumper sets the cha nne l output mode to be e ithe r Progr a m

Selectable or Jumper Selectable. When the jumper is in the program selectable position, the cha nne l output mode can b e set vi a programmin g commands. In the jumper selecta ble position, the cha nne l output mode is set via the V/I jum p e r.

V/I Jump er The V/I jumper sets the cha nne l output mode to either voltage or cur r en t

when the P/J jumper is set to the Jumper Selectable position. When the P/J jumper is se t to Pr ogram Select able, this jum per has no effect.

Notes With no jumpers installe d, the module will be in the Progr a m Se le ctable

output mode .

When the P/J Ju mper is set to th e Jumper Selec ta ble position, the ou tput mode cannot be change d with SCPI comman ds. The ou tput mode following a

*RST common com mand will be the mode set by th e V/I jumper.

Chapter 1 Module Setup and Instal lation 31

Options A3E and A3H

Terminals

The P/J jumper connection for each channel is named CH X PRGM JMPR in the connecti on dia g ra m on page 30. With no connection to this pin, the module will op e rate in the Program Se lectable mode. Shorting this pin to GND will set the Jumpe r Se le c ta ble mode for channe l X.

When CH X PRGM JMPR is shorted to GND, the CH X MODE JMPR pin (corresponding to the V/I Jumper) sets the output mode for channel X. If the pin is open, voltage output mode is se le c te d. If the pin is shorted to GND, current output mode is selected for channel X.

32 Module Setup and Installati on Cha pter 1

Terminal Module Connections

Each channel has four output lines; HI , LO, HS (Hi Sense), and LS (Low Sense). When using a channel in th e vo lta ge output mode, yo u can use the sense lines to increase accuracy or to compensate for long lead lengths. The sense leads are not used in the current output mode.

Voltage and

Current Output

Connections

Note The sense leads are internal ly disconnected for current outpu t . External

Figure 1-14 shows con ne ctions for three types of output. Channel 1 is connected in th e 2-wire voltage output mode , the se nse le ad s are not used (and the sense co nne c tions need not be ma de ). Ch an ne l 2 is c onnected in the 4-wire voltage out put mode. Use this conne c tion for the highe st vol ta ge accuracy an d to c ompensate for long lead lengths. Channel 3 is connected for current output m ode (s en se is not used for current output).

wiring may be left conne c te d to the sense outputs on the termin al module with no effect.

Figure 1-14. Typical Output Connections

Options A3E and A3H

HI, HS, LO, and LS connections a re shown on the diagram on page 30.

Terminals

Chapter 1 Module Setup and Instal lation 33

Combining

Channels

You can combine channels in series to obt ai n higher output volta ge s or in parallel to obtain higher output curren ts.

Channels in Series • All channels connected in serie s MUST be conf igur e d a s isol at ed

channels (with isola te d pl ug- on modules install ed ).

• Up to 3 channels may be combined, but the output voltage MUST

NOT exceed 42 Vdc/42 Vpeak.

Channels in Parallel • Channels may be either Isolated or Non-Isolated.

• Up to 16 channels may be combined.

Figure 1-15 shows how to combine voltage channels (in series) and current channels (in par a lle l) .

CAUTIONS All SERIES CONNECTED o ut put channels MU ST be configur e d a s

ISOLATED OUTPUTS.

When combining output voltage channels, be sure not to exceed the maximum module isolation rating of 42 Vdc or 42 Vpeak .

Figure 1-15. Combined Channels Output Connections

34 Module Setup and Installati on Cha pter 1

Connecting an

External Trigger

Source

An external trigge r input is provided on the te r minal module. Use the external trigge r to e xte r na lly synchronize multiple output s or mult iple instruments. The External Trigger uses TTL levels. The trigger occurs when the EXT TRIG n c onne c tion is pulled low fo r at lea st 1 µS. Typical connections to the external tr igger is shown in Figur e 1-16.

Options A3E and A3H

Terminals

Figure 1-16. External Trig ge r Co nne c tions

The external trigge r line is loc a ted on the upper connector and is labeled EXT TRIGn in the diagram on page 30.

Chapter 1 Module Setup and Instal lation 35

Using the C AL

Output Terminals

The CAL Outp ut Te rm ina ls provide one se t of co nne c tions that can be us ed to calibrate the output on all 16 chan nels. Calibration and adjustment procedures are desc ribe d in Appe ndix D beginning on pag e 15 5.

The CAL output terminals are available on the terminal module. There are four lines; HI, LO, HS (Hi Sense), and LS (Low Sense). Typic al CAL output termina l conne c tions are shown in Figur e 1-17.

Options A3E and A3H

Terminals

Figure 1-17. Calbus Connections

The CAL Output Terminals are located on the upper connector and are labeled CAL HI, CAL HS, CAL LO, and CAL LS in the diagram on page 30.

36 Module Setup and Installati on Cha pter 1

Initial Operation

Note This discussion applies to SCPI programm ing using the driver provided

Device Driv er The Agilent E1418A m odule is shippe d a dr iver CD. This CD contains the

This section provides a programming example to he lp ve rify co rrect m odule installation and operation. Additional programming examples and procedures are given in the next chapter.

The examples shown here use BASIC and SCPI (Standard Commands for Programmable Instruments). The ex ample a ssume s a f actory set logical address of 72 for the Agilent E1418A module and uses an Agilent Command Module for command interpretation. Examples in ANSI C a re give n in the next chapter.

with the module. The SCPI com ma nds are described in Chapter 3 of this manual. Appendix B of this manual describes direct register access.

SCPI instrument driver, VXIplug&play drivers , exa mple p rog ram s, an d Agilent VIC (VXI Installation Consultant). Follow the instructions contained on the CD to properly install the de vice dr iver.

The following example shows how to query the command module and verify that the correct device driver is installed:

10 DIM A$[256] 20 OUTPUT 70900;"DIAG:DRIV:LIST?" 30 ENTER 70900;A$ 40 PRINT A$ 50 END

In this example, the comma nd module is located on GPIB (interface address 7) and uses a primary address of 09. Responses to this example vary de pending upon the drivers loaded on your system. A typical response might look like:

E1418,E1418,A.01.00,RAM;SWITCH,SWITCHBOX,A.08.00,RAM; SYSTEM,E1405A,A.08.00,ROM;IBASIC,IBASIC,A.04.02,ROM; VOLTMTR,E1326A,A.05.00,ROM;SWITCH,SWITCHBOX,A.07.00, ROM;COUNTER,E1332A,A.04.02,ROM;COUNTER,E1333A,A.04.02, ROM;DIG_I/O,E1330A,A.04.03,ROM;D/A,E1328A,A.04.02,ROM

Verify th at the stri n g “E1418,E1418,A.01.00,” is located somewhere within the ret ur ne d str ing.

Chapter 1 Module Setup and Instal lation 37

Module

Identification

This example can be used to verify that the logical address has been correctly s et, that the module is correctly in sta lled, and that th e m odule is communicati ng with the command module. The terminal module does not need to be instal le d fo r th is e xa mple to work. This example queries the module for the identification string.

10 DIM A$[256] 20 OUTPUT 70909;"*IDN?" 30 ENTER 70909;A$ 40 PRINT A$ 50 END

The response sho uld be similar to one of the fo llowing:

HEWLETT-PACKARD,E1418A_8CH,xxxxAxxxx,A.01.00

HEWLETT-PACKARD,E1418A_16CH,xxxxAxxxx,A.01.00

The xxxxAxxxx portion of the response string is th e m odul e ser ia l num be r .

38 Module Setup and Installati on Cha pter 1

Using This Chapter

This chapter provides examples and descriptions of the most common operations using the Agilent E1418A. Use this c hapter to ga in a n ove rview of how to program the module, and to obtain programming hints. The examples shown in this chapter are in ANSI C and use SCPI commands to control the module. The SCPI commands are described in detail in Chapter 3 of this manual. SCPI usage conventions and synta x r ules are described be ginning on page 60.

This chapter is divided into the f o llowing sectio ns:

Chapter 2

Programming Examples

• Querying Module Identification and Configuration. . . . . . . . . Page 40

• APPLy Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 45

• Error Checking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 47

• SOURce Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 50

• Setting the Output Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 52

• Controlling the Output Relay. . . . . . . . . . . . . . . . . . . . . . . . . Page 53

• Triggering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 54

• Using *OPC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 56

• Combining Output Channels . . . . . . . . . . . . . . . . . . . . . . . . . Page 57

Program Exam ples Example programs in ANSI C format are included on the driver CD

supplied with the Agile nt E1418A. Most exam ple s in this chapter are included. The examples are ASCII files with the *.c extension.

Note The int data type is system dependent. These ex am ple s wer e deve loped on

a system where int is a 16-bit integer. Other syste ms may define int to be a different width.

In the examples, the Agilen t V ISA Transition Libra ry is use d f or I/O operations w ith the VXIbus. An A gilent comm an d module (Agilent E1405/E1406) is used and controlled via GPIB.

To use the Agilent VISA Transition Library (abbr e via te d a s V TL ) , in cl ude the visa.h header file.

#include visa.h

Chapter 2 Programming Examples 39

Agilent VTL function calls and da ta types typically begin with the low e r case letters vi. Output and enter are perf or med wit h fu nc tions named viPrintf and viScanf. Both these func tions require a se ssion (a VTL defined I/O func tion) to uniquel y ide ntify the devic e being controlled. In the examples , th e session has been name d dac.

Querying Module Identification and Configuration

This example w ill query the modul e for the ide ntification string and determine th e m odule configurat ion.

The module identification is obta ined usi ng the IEEE-488 Co mm an d

!Send query to the module.

*IDN?

!Enter a string.

The string returne d should be similar to one of the following:

HEWLETT-PACKARD,E1418A_8CH,xxxxAxxxxx,A.01.00

HEWLETT-PACKARD,E1418A_16CH,xxxxAxxxxx,A.01.00

The xxxxAxxxxx portion of the response strin g is the module serial number.

The module conf igur a tion is obtained using the query.

!Send query to the module.

DIAG:CONF?

DIAGnostic:CONFiguration?

*IDN?.

!Enter six integers and decode the integers.

40 Programming Examples Chapter 2

The DIAG:CONF? query returns six integers. The six integers returned contain th e module c onfig u rati on and ha ve the fo llowing mea ning.

Integer

Returned Meaning

1st Expansion Board ID in the form: 0 = present, 7 = none

(expansion board contains channels 9 through 16)

2nd Terminal Module ID in the form

0 = screw type, 7 = none or other

3rd Isolated/Non-isolated Channel status

A bit set to 0 indicates an isolated channel A bit set to 1 indicates a non-isolated channel or no plug-on module installed (DO NOT operate the module without a plug-on module) Bits 0 – 15 correspond to channels 1 – 16, respectively*

4th Channel Mode

A bit set to 0 indicates a current output channel A bit set to 1 indicates a voltage output channel Bits 0 – 15 correspond to channels 1 – 16, respectively*

5th Channel Output State

A bit set to 0 indicates the channel output relay is closed A bit set to 1 indicates the channel output relay is open Bits 0 – 15 correspond to channels 1 – 16, respectively*

6th Channel Mode Programmable State (P/J Jumper)

A bit set to 0 indicates a channel is not mode programmable A bit set to 1 indicates a channel is mode programmable Bits 0 – 15 correspond to channels 1 – 16, respectively*

* For 8-channel conf igurations, th e upper 8 bi ts of integers 3, 4, 5, and 6 are set to 1’s .

For example, if the following six integers are returned, the module has the configuration indicated.

Decimal

Integer

1st 7 No expansion board installed

2nd 7 No Terminal Module installed or

3rd -1 All channels are non-isolated. 4th -1 All channels are voltage output channels. 5th -1 All channel outputs are disabled

6th -1 All channels are output mode

Value Configuration

(Only channels 1 through 8).

unknown terminal module installed.

(all output relays are open).

programmable.

Chapter 2 Programming Examples 41

Configuration

Example

The following progra m se gm e nt de monstrates how to rea d the module identification st ring a nd the c onf iguration. The config ur ation integers are bit manipula te d using the C operator fo r bit shif ting result = result <<1 (a one bit shift to the left) .

•

/** FUNCTION PROTOTYPES **/ void main (void); void err_handler(ViSession vi, ViStatus x); /* VTL error routine */ void sys_err(ViSession resource); /* Checks for SCPI programming errors */

/** GLOBAL **/ ViStatus err; ViSession defaultRM, cmd, dac;

•

void main (void) {

int i,num_chan,result = {0},config [6]={0}; char buf[256] = { 0 };

/*** Check the module identification ***/

err=viPrintf(dac, “*IDN?\ n”); /* request id from the module */ err=viScanf(dac, “%t”, &buf); /* enter string returned */ printf (“Module is identified as a %s\n”, buf); /* print the result */

/*** Get the module configuration ***/

err=viPrintf(dac, “DIAG:CONF?\n”); /* request module configuration */ err=viScanf(dac, “%,6d”, &config); /* returns six integers */

/* Decode the first integer */

result=config[0]; /* Expansion board */ if (result < 7)

{ printf (“Module is a 16 channel device\n”); num_chan = 16; }

else

{ printf (“Module is an 8 channel device\n”); num_chan=8; }

42 Programming Examples Chapter 2

/* Decode the second integer */

result = config [1]; /* Terminal Module */ if (result > 0)

{ printf (“Module does NOT have a terminal module installed\n”); }

else

{ printf (“Module has a screw-type terminal module installed\n”); }

/* Decode the third integer */

result=config[2]; /* Isolated or non-isolated outputs */ if (num_chan < 9) result = result << 8; /* strip upper 8 bits */ for (i=num_chan;i>0;i – –)

{ if (result >= 0x8000)

{ printf (“Channel %d is configured for non-isolated output\n” ,i); }

else

{ printf(“Channel %d is configured for isolated output\n”,i);

} result = result << 1; }

/* Decode the fourth integer */

result=config[3]; /* Output Mode Voltage or Current */ if (num_chan < 9) result = result << 8; /* strip upper 8 bits */ for (i=num_chan;i>0;i – –)

{ if (result >= 0x8000)

{

printf (“Channel %d is set to voltage output mode\n”,i);

} else

{

printf(“Channel %d is set to current output mode\n”,i);

} result = result << 1; }

Chapter 2 Programming Examples 43

/* Decode the fifth integer */

result=config[4]; /* Channel relay open or closed */ if (num_chan < 9) result = result << 8; /* strip upper 8 bits */ for (i=num_chan;i>0;i – –)

{ if (result >= 0x8000)

{

printf (“Channel %d output is disabled\n”,i);

} else

{

printf(“Channel %d output is enabled\n”,i);

} result = result << 1; }

/* Decode the sixth integer */

result=config[5]; /* P/J Jumper position */ if (num_chan < 9) result = result << 8; /* strip upper 8 bits */ for (i=num_chan;i>0;i – –)

{ if (result >= 0x8000)

{

printf (“Channel %d output mode is programmable\n”,i);

} else

{

printf(“Channel %d output mode is fixed and jumper selected\n”,i);

} result = result << 1; }

•

}

44 Programming Examples Chapter 2

APPLy Output

The APPLyn subs yste m command s provide the easiest method to output voltages or curre nts.

/* Set channel 1 for 5. 0 V olt out put */

APPLy1:VOLTage 5.000

/* Channel is se t to voltage output and 5. 000 V applied */ /* Set channel 8 for 10 m A out put */

APPLy8:CURRent 0.0100

/* Channel is se t to current output and 10 m A appl ie d */

The APPLyn subs yste m outputs the vol ta ge or cur r en t spe c ifie d on the channel specified immediately. The output relay for that channel is closed. Other channel outputs and output state s are not di stur be d.

APPLyn subsyst em co mmand perform s se ve ral a c tions with a single

An command. Each

– Sets th e channel out put mode (voltage or current). – Sets the output value (volts or amps).

APPLyn command affects a single channel and:

– Enables th e ou tputs (closes the output relay).

The output channe l r em a ins e na ble d, a nd out puts the last programmed voltage or curr en t va lue , unless you take explicit action to tur n of f the output. For exampl e, if you se nd two

APPLyn comm an ds to the same

channel, the fi rs t co mmand sets an output value and c loses the output rela y. The second comm a nd c ha nge s only the output value ( sinc e the rela y is already closed).

/* Set channel 1 for 5. 0 Vo lt outp ut */

APPLy1:VOLTage 5.000

/* Channel 1 is se t to voltage output and 5. 000 V applied */ /* Now set chann el 1 for 6. 0 V ol t out put */

APPLy1:VOLTage 6.000

/* Channel 1 is se t to voltage output and 6. 000 V applied */

The commands above will set a 5.000 Volt out put on Channel 1, and the n set a 6.000 Volt output on channel 1. The ou tput relay is not affect ed by the second command.

Chapter 2 Programming Examples 45

The output can als o be disa ble d be fo re changing the mode or output value. Use the

OUTPutn comma nds to disable the out put.

/* Set channel 1 for 5. 0 V olt out put */

APPLy1:VOLTage 5.000

/* Disable the output */

OUTPut1 OFF

/* Channel 1 output relay is opene d */ /* Now, enable t he outp ut */

OUTPut1 ON

/* Channel 1 is se t to voltage output and 5. 000 V applied */ /* Disable the output */

OUTPut1 OFF

/* Now set chann el 1 for 20 mA current ou tput */

APPLy1:CURRent .0200

/* Channel 1 is se t to current output and 20 m A appl ie d */

The OUTPut subsyste m commands only affect the output relay. The programmed mode and output value for a given c ha nne l is not changed. Once the mode is set and the desired output value programme d, the output can be turned on or off as needed with the

OUTPutn[:STATe] command.

It is also possible, with the

APPLyn co mman d s , to ch ange t h e channel

output mode from volt ag e to curr e nt.

/* Set channel 1 for 5. 0 V olt out put */

APPLy1:VOLTage 5.000

/* Channel 1 is se t to voltage output and 5. 000 V applied */ /* Now set chann el 1 for 20 mA current ou tput */

APPLy1:CURRent .0200

/* Channel 1 is se t to current output and 20 m A appl ie d */

During the change from voltage to current (or current to voltage), the channel output r e la y is ope ne d. Sending a command seq ue nc e si milar to the one above perform s the f ollowing actions:

– Programs cha nne l 1 to the voltage mode and 5.000 Volts output. – Closes the cha nne l 1 output relay. – Opens the channel 1 output relay. – Programs cha nne l 1 to c u rr en t mode and 20 mA outp ut. – Closes the cha nne l 1 output relay.

46 Programming Examples Chapter 2

Error Checking

To develop programs you will need to create one or more error checking routines. For example, you will need routines to check for errors in the following opera tions:

– I/O operations to the VXIbus, an d – SCPI comma nds to the module .

I/O Error Checking I/O error ch ec ki ng is specific to th e type of I/O librar y you are using to

communicate with the VXIbus. In this ma nua l a nd on the CD, the Agilent VISA Transition Libra ry is used.

Function calls to the Agilent VISA Transition Library (VTL) typically begin with a lower case vi. For example, viPrintf is a VTL output function call. The Agilent VTL I/O function calls return a variable that can be tested for errors against the VTL variable VI_SUCCESS. In the examples, the variable err is used to trap the VTL errors and is declared as a global variable of the ViStatus type (defined in visa.h).

I/O error checking is il lust rate d in the following progr a m ex ample. The VTL error checking function is named error_handler. Errors found are reported to the standard output device.

SCPI Error

Checking

You must also check for errors reported by the SCPI driver. The SCPI driver reports errors in response to the

/* Repeat … */

SYST:ERR?

…

until no errors fou nd */

The query return s two va lues: an integer erro r code a nd a n erro r de sc ri ption string. The integer value returns +0 and the string returns “No Error” if no errors are found.

SCPI errors are reported in an error queue. The error queue is a first in, first out queue. Each response to the from the queue. Multiple SCPI errors m ay b e gener a te d by a singl e incorrect command and the error queue should be read until it reports +0, "No Error".

SYSTem:ERRor? query.

SYSTem:ERRor? query remove s one e rror

Chapter 2 Programming Examples 47

SCPI error checking is illustrated in the following program example. The SCPI error routine is name d sys_error. Errors found are reported to the standard output device.

•

/** FUNCTION PROTOTYPES **/ void main (void); void err_handler(ViSession vi, ViStatus x); /* VTL error routine */ void sy s_ e rr(ViSessi o n r e so u r ce); /* SCPI er r o r r o u ti n e */

•

/** GLOBAL **/ ViStatus err; ViSession defaultRM, cmd, dac;

•

void main (void) {

/*** Open the resource manager, command module, and dac sessions ***/ viOpenDefaultRM (&defaultRM); viOpen (defaultRM, CMD_ADDRESS, VI_NULL, VI_NULL, &cmd); viOpen(defaultRM, DAC_ADDRESS, VI_NULL, VI_NULL, &dac);

/*** Set the timeout for the dac ***/ viSetAttribute(dac, VI_ATTR_TMO_VALUE, 10000); /* 10 second timeout */

err=viPrintf(da c, “*RST\n” ); /* reset the dac */ if(err < VI_SUCCESS) err_handler(dac, err); /* VTL error check */ sys_e r r ( d a c); /* SCPI error c h e ck * /

•

}

/***VTL Error handling function ***/ void err_handler (ViSession dac, ViStatus err)

{ char buf[1024]={0}; viStatusDesc(dac,err,buf); printf(“V TL ERROR = %s\n”, buf); return; }

/***End of VTL error handler ***/

48 Programming Examples Chapter 2

•

/*** SCPI Error check ***/ void sys_err(ViSession resource)

{ char buf [1024] = {0}; int err_no; err = viPrintf (resource, “SYST:ERR?\n”); /* query error queue */ if (err < VI_SUCCESS) err_handler(resource,err); err = viScanf (resource,"%d%t",&err_no,&buf); /* get error number and string */ if (err < VI_SUCCESS) err_handler(resource,err); while (err_no != 0)

{ printf (“\nCommand Error: %d,%s\n”,err_no,buf); err = viPrintf (resource, “SYST:ERR?\n”); /* query error queue */ if (err < VI_SUCCESS) err_handler(resource,err); err = viScanf (resource,"%d%t",&err_no,&buf); /* get error number and string */ if (err < VI_SUCCESS) err_handler(resource,err); }

return; }

/*** End of SCPI error check ***/

Chapter 2 Programming Examples 49

SOURce Output

Setting an output on a channel is a thre e st ep pro cess:

– Set the channe l m ode (voltage or curre nt) – Set the channel output value (vo lts or a mps) – Enable the output ( c lose the c ha nne l output relay)

As described previously, a single

APPLyn command performs all three of

these actions. In some cases you may need more control of each step in the output process. The fol lowing commands pe r fo rm the sa me action as a

APPLyn co mman d .

single

/* Set channel 1 voltage mode */

SOURce1:FUNCtion:MODE VOLTage

/* Channel 1 is se t to voltage output */ /* Set channel 1 voltage output */

SOURce1:VOLTage 5.000

/* Channel 1 is se t to outp ut 5.000 Volts */ /* Turn on the output */

OUTPut1 ON

/* Channel 1 output is enabled */

The SOURcen subsystem co nta ins tw o type s of c ommands to set curr e nt or voltage output. The type used in the above examples has the form:

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude] <value> SOURce

n:VOLTage[:LEVel][:IMMediate][:AMPLitude] <value>

The implied commands (enclose d in brackets [ ]) are not shown in the examples. The co mmands shown ab ove immediately program the output values. The

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] <value> SOURce

SOURcen subsystem also contains commands of the form:

n:VOLTage[:LEVel]:TRIGgered[:AMPLitude] <value>

These commands are used with the trigger system to control when the outputs are applied. The trigger system is described on page 54.

50 Programming Examples Chapter 2

Like the APPLyn comm a nds, you can change the output value by sending additional

SOURcen commands doe s not open the outpu t relay.

SOURcen commands. Changing the output value with the

/* Set channel 1 voltage mode */

SOURce1:FUNCtion:MODE VOLTage

/* Set channel 1 voltage output */

SOURce1:VOLTage 5.000

/* Turn on the output */

OUTPut1 ON

/* Channel 1 output is enabled */ /* Send a new output voltage */

SOURce1:VOLTage 15.000

Changing the output mode with the SOURcen commands opens the outpu t relay.

/* Set channel 1 voltage mode */

SOURce1:FUNCtion:MODE VOLTage

/* Set channel 1 voltage output */

SOURce1:VOLTage 5.000

/* Turn on the output */

OUTPut1 ON

/* Channel 1 output is enabled and 5 v olt s appl ie d */ /* Send a new output mode */

SOURce1:FUNCtion:MODE CURRent

/* Channel 1 output is disabled */ /* Set channel 1 output current */

SOURce1:CURRent .01

/* Channel 1 is programmed for 10 mA */ /* Turn on the output */

OUTPut1 ON

/* Channel 1 output is enabled and 10 m A appl ie d */

Chapter 2 Programming Examples 51

Setting the Output Mode

The output mo de ca n be se t using comman ds in the SOURce subsyste m.

SOURcen:FUNCtion:MODE VOLTage SOURce

The mode can also be set on the terminal module with the P/J jumpers and V/I jumpers (see pa ge 3 1) . If th e m ode is se t to Jumper select able with the P/J jumper on the terminal module, the mode cannot be change d with the SCPI commands a nd the output mode is se t by the V/I jumper (als o on the terminal module, see page 31) .

For examp le , if on the termina l module, chan nel 1 P/J jumpe r is se t to Jumper Sele ct ab le and the V/I jumpe r is se t to c ur r en t mode, the following command will each generate an error:

SOURce1:FUNCtion:MODE VOLT

The error returned is:

+3012 Channel cannot be programmed to this mode, check jumper s

Appendix C, starting on page 151 contains a full list of th e erro rs tha t may be generated by the SCPI com ma nds for the Agilent E141 8A.

n:FUNCtion:MODE CURRent

52 Programming Examples Chapter 2

Controlling the Output Relay

There are three progra mm ing methods to enable the output of a channel (close the outp u t rel ay).

• The APPLyn:VOLTage <value> or APPLyn:CURRent <value>

command both pr ogr a m an output value and close the out put r e la y on a single channel.

• The OUTPutn:STATe ON comm a nd c loses the output rela y fo r a

single chan ne l. The last programmed mode and outp ut va lue r emains in effect.

• The DIAGnostic:OUTPut:ALL:STATe ON command closes all output

relays. The order of rela y closur e is not guaranteed.

There are three progra mm ing methods to disabl e th e ou tput of a channel (open the output re la y) .

• Send the OUTPutn:STATe OFF command to open a single channel

output relay witho u t c ha nging the programm ed mode or output value for that channel or affecti ng a ny other channels.

• Send *RST to program all channels to vol ta ge mode , 0 volt s output,

and open all output relays. the P/J jumper is set to Jumper Selectable.

*RST will not change the ou tput mode if

• Send the DIAGnostic:OUTPut:ALL OFF comman d to op en al l out put

relays witho ut c ha ngi ng the programm e d mode or output val ue .

The output relay will a lso be ope ne d a nd then closed by a change of output mode using the

APPLy commands.

• An APPLyn:VOLTage <value> followed by an

APPLyn:CURRent <value> command (or vice versa ) w ill open and

then close the ou tput relay.

All output relays will be opened, and left open, by the following commands.

• The SOURcen:FUNCtion:MODE VOLTage or

SOURcen:FUNCtion:MODE CURRent commands se t output mode

for a single channel and opens th e output relay for tha t ch an ne l. Other channels are not affected.

• The *RST command performs a reset and lea ve s the output relays

open on all channels (the command also programs all channels to voltage mode, 0 volts output unles s the P/J jumper is set to Jumper Selectable).

• The *TST? command performs a self-test and leaves the output

relays open on all cha nne ls. Programmed out put modes are restore d following th e se lf -te s t.

Chapter 2 Programming Examples 53

Triggering

To synchronize outputs to external events, backplane events, or software events use the

TRIGger subsystem commands. Triggering a n output from

the module inv o lve s f our ste p s:

1. Set the trigger sour ce.

2. Set one or mo re c ha nne ls f or tr igge red output.

3. Put the tr igge r system in the wait- f or -t rigge r sta te .

4. Send the trigger e vent.

TRIGger:SOURce <source> command sets the trigger source. One of

The four trigger source s can be spe c ifie d.

• VXIbus backplane trigger — one of the eight TTL trigger lines

defined in the VXIbus P2 conne c tor. The line s are na me d *TTLTRG0 through *TTLTRG7. Any one of these trigger lines may be used as a trigger sour c e.

• Software trigger — generated within the controlling program.

• Immediat e trigger — places the tr igger system in th e wa it- f or - trigge r

state and then im me di at el y tr igge rs the output.

• External Trigger — an input on the termina l mo dule ( se e page 35) .

Use this source to synchr onize the outputs to an externa l e ve nt.

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude] and

The

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] commands program a

channel output value when the trigger conditions are met.

INITiate:IMMediate command places the trigger system in the

The wait-for-trigger sta te. The tr igge r ev en t de pe nds upon the trigger source set.

The trigger syst em is c ommon to all channels in the mo dule . Th at is, a single trigger event triggers the output on all channels that are wa iting for the trigger. The

SOURce subsystem c onta ins comman ds to put each

channel in the wait-for-trigger state.

/* Set the trigger source for software trigger */

TRIGger:SOURce HOLD

/* Set channel s 1 and 2 fo r trig ge r ed output */

SOURce1:VOLTage:TRIGgered 1.5000 SOURce2:VOLTage:TRIGgered -2.5000

/* Close the output relays */

OUTPut1 ON OUTPut2 ON

/* Put the trigger s y s tem in t he wait -f or -t r igg er s t ate */

54 Programming Examples Chapter 2

INITiate

/* Send the trigger event */

TRIGger:IMMediate

/* Channels 1 and 2 output the progr amm e d voltages */

Note that the channels must be set f or tr igge r e d output (using the SOURce subsystem) before the trigger system is change d to the wait-for-tr igge r sta te (using the

INITiate command, the follow i ng e rror is r e por te d:

the

INITiate command). If you se nd the SOURcen commands after

+3014 Illegal while initiated

Once the outputs have been triggered (using

TRIGger:IMMediate in the

previous example) the trigger system is set back to the trigger idle state. New triggered channel output values can be programmed and the trigger system put in the wait-for-trigger state. The triggering process is illustrated below.

Note Once an output is enabled and a voltage or cur r en t output, that value

remains on the output. Sending subse que nt

SOURn:CURR:TRIG comman ds w ill not change the output value unt il the

trigger event is rece ive d. The output may be disabl ed (ou tput relay opened) with the

OUTPn OFF command.

The trigger source set usi ng the TRIGger:SOURce command remains in effect until it is changed or a reset occurs. Following a reset ( trigger source is set to

HOLD.

SOURn:VOLT:TRIG or

*RST) the

Chapter 2 Programming Examples 55

Using *OPC?

As shown, the examples have made no attempt to coordinate the program execution with the Agilent E1418A module. In some cases, you may need to pause program execution until the module ha s c omple ted executing the comman d s .

The IEEE-488 common command and the module synchronized. The

*OPC? can be used to keep the program

*OPC? query returns a 1 when all

programmed oper at ions are comple te . The program can wait for the response before exe c uti ng a dditional stateme n ts. The return e d va lue is unimportant (always a 1).

/* Set channel 1 voltage mode */

SOURce1:FUNCtion:MODE VOLTage

/* Set channel 1 voltage output */

SOURce1:VOLTage 5.000

/* Turn on the output */

OUTPut1 ON *OPC?

/* enter the response */

*OPC?

is used to synchronize the program with the module since program

execution waits for the response. The command may be combined using the ; as described under “Linking Commands” on page 62. For example,

/* Set channel 1 voltage mode */

SOURce1:FUNCtion:MODE VOLTage;*OPC?

/* enter the response */

56 Programming Examples Chapter 2

Combining Output Channels

As described on page 34, multiple outputs may be combined to obtain higher voltage or current outputs. A triggered output is r ecomme nded for c ombined channels. The general sequence used to control combined channels is:

1. Set the trigger sour ce.

2. Close the output relays.

3. Set the desi red output on all combined channe ls.

4. Trigger the output.

For example, when three current channels are combined in parallel as shown on page 34, the fo llowing commands ca n be use d.

/* Set the trigger s ource for exte rnal trigger */

TRIGger:SOURce EXT

/* Close the output relays */

OUTPut9 ON OUTPut10 ON OUTPut11 ON

/* Set channel s 9, 10 , an d 11 fo r trig ge r ed output */

SOURce9:CURRent:TRIGgered MAX SOURce10:CURRent:TRIGgered MAX SOURce11:CURRent:TRIGgered .0100

/* Put the trigger s y s tem in t he wait -f or -t r igg er s t ate */

INITiate

/* Wait for the trigger event */

…

/* Whe n the trig ger oc curs /*

…

output 50 mA */

When comb ining channels in pa r a lle l, for increase d cu rre nt output, channe ls may be configu red wit h ei the r isola ted or non-isolated pl ug-on modules. When combining channels in series, for increased voltage output, all combined channels MUST be configured with isolated plug-on modules.

CAUTION When combining output vol ta ge channels (series c onnections) you must

ensure that the output does not e xceed the max imum isolation rating of ±42 Vdc/42 Vpeak. Up to thr e e chan nels may be combined, but the c ontr olling program must ensure that all three channels together are NEVER set beyond ±42 Vdc.

Chapter 2 Programming Examples 57

Notes

58 Programming Examples Chapter 2

Agilent E1418A SCPI Command Reference

Using This Chapter

This chapter desc r ibes St andard Commands for Programma ble I nstr umentation (SCPI) and summarizes IEEE 488.2 Comm on ( *) Com mands applicable to the Agilent E1418A D/A Conv erter Module. This chapte r cont ai ns the following sections:

• Command Types . . . . . . . . . . . . . . . . . . . . . . . . . Page 59

• SCPI Command Reference . . . . . . . . . . . . . . . . . . . . Page 62

• ABORt Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 63

• APPLy Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 64

• CALibration Subsystem . . . . . . . . . . . . . . . . . . . . . . Page 66

• DIAGnostic Subsystem . . . . . . . . . . . . . . . . . . . . . . Page 76

• INITiate Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 80

• OUTPut Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 81

• SOURce Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 84

• STATus Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 95

• SYSTem Subsystem . . . . . . . . . . . . . . . . . . . . . . . Page 100

• TEST Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . Page 101

• TRIGger Subsystem . . . . . . . . . . . . . . . . . . . . . . . . Page 104

• IEEE 488.2 Common Comm and Quic k Reference . . . . . . . . Page 106

• Agilent E1418A Com ma nd Qui ck Refere nc e . . . . . . . . . . Page 107

Chapter 3

Command Types

Commands are sepa rat ed into two types: IEEE 488.2 Common Comm a nds a nd SCPI Co mmand s.

Common

Command

Format

The IEEE 488.2 standard defines the comm on c om mands that perform functions like reset, sel f-test, status byte query, e tc . Co mmon commands a r e four or five characters in leng th, al way s begin with the aste ri sk cha ract er (*), and may include one or more paramet ers. The com man d keyword is separ ated from the first parameter by a space character. Common commands are not documented, except in a general manner, in this manua l. Some example s of co mmon commands are:

*RST *ESR 32 *STB?

Chapter 3 Agilent E1418A SCPI Command Reference 59

SCPI Command Format

SCPI commands pe r f or m func tions like sett ing outputs, que ry ing instrument sta te s, or retrieving data. The command structure is a hierarchical structure that usually consists of a top leve l ( or roo t) com ma nd, one or more lowe r le ve l co mmands, and their paramete rs. The fo llowing example shows pa r t of a typ ical subsystem:

SOURcen:

FUNCtion:

MODE <CURRent | VOLTage>

Command

Separator

Abbrev ia t ed and

Short Commands

SOURce

range of 1 to 16), command, an d

A colon (:) always separa te s one co mm an d from the next lower le ve l co mm an d. This is illustr a te d as fol low s:

Colons separa te the ro ot c ommand from the se c ond le ve l ( SOURcen:F UNCtion) and the second from third level (

The command synt ax shows most commands as a mix of upper and lower c ase letters. The up pe r ca se let te rs indicate an abbreviated spelling for the comma nd. For shorter program lines, send only the ab br ev ia te d fo rm. For bette r program readability use the entire command. The instrument will accept either the abbreviated form or the entire command.

For example, if the command reference syntax shows the command

TRIG and TRIGGER are both accepta ble fo rms. Other forms of TRIGger, such as TRIGG or TRIGGE will generate an error.

n: is the root comm a nd ( w he re n is re pla c ed b y the ch an ne l number in the

FUNCtion: is a second leve l command, MODE is a third level

<CURRent | VOLTage> is an input parameter.

SOURcen:FUNCtion:MODE VOLT

FUNCtion:MODE), and so forth.

TRIGger, then

The instrument does not distinguish between upper case and lower case characters. Therefore

Command keywor ds c a n be entere d in their full form, as shown above, or can be entered in their short form. In this manual, the entry required in short form commands is always capitalized. The short form is generally used for examples in this manual.

TRIGGER, trigger, and TrigGeR are all acceptable.

60 Agilent E1418A SCPI Command Reference Chapter 3

Implied

Commands

Implied comm an ds a ppe a r in squa r e bra c ke ts ([ ]) in the comm and syntax. (Note that the brackets are not part of the command and are not sent to the instrument.) Suppose you send a seco nd level comm an d but do not send the pre c ed ing im plied command. In this case, the instrument ass ume s you intend to use the implied command and it r e sponds as if you had sent it. Examine this exc e rp t from the

STATus subsystem shown below:

STATus:

OPERation

[:EVENt]?

The third level c om ma nd, EVENt, is implied. T o rea d the va lue of the Event Register, you can use either:

STATus:OPERation?

Parameters

STATus:OPERation:EVENt?

Paramete r s are enclosed in gre a te r th an/less than sy mbols (< >) in the c ommand syntax. When more than on e para me te r is a llow e d, the pa r am e te rs are sep arated by a vertical line ( | ).

Parameter Types. The followi n g table co ntai n s expla na ti o ns and exampl es of parameter ty pe s you might see later in this chapter. Param et ers must always be separated from the keywords by a space.

Parameter Type Explanations and Exam pl es

Numeric Accepts all commonly used decima l repr esentations of

Boolean Represents a single binary condition that is eit her

Discrete Selects from a finite number of va lu es. These parameters

numbers includin g opt i onal si gns , de ci ma l poin ts , an d scientific notat i on.

123, 123E2, -123, -1.23E2, .123, 1.23E -2, 1.23000E-01. Special cases include MIN, MAX, and DEF.

true or false. ON, OFF, 1, 0.

use mnemonics to represent each valid setting. An example is the SOURce

command where the < CURRent or VOLTage.

n:FUNCtion:MODE <mode>

mode> parameter can be eit her

Optional Parameters. Parameters shown within sq ua re br ack et s ([ ]) are optional parameters. (N ote tha t the br a ck et s are not pa r t of the co mm and and are not sent to the instrument .) If you do not specify a va lue fo r an optional parame te r , the inst r umen t c hooses a default value.

Chapter 3 Agilent E1418A SCPI Command Reference 61

Linking

Commands

Linking IEEE 488.2 Common Commands with SCPI Commands. Use a semicolon between the commands. For example:

*RST;APPLy2:VOLT 10 or INIT:IMM;*IDN?

Linking Multiple SCPI Commands. Use both a semicolon and a co lon be twe e n the commands. For example:

SOURce2:FUNCtion:MODE VOLT;:SOURce2:VOLTage 10

SCPI Command Reference

The following sections describe the Standa r d Co mmands for Programmable Instruments (SCPI) co mm an ds f or the Agile nt E1418A D/A Converter M odule. Commands are listed alphabetically by subsystem and within each subsystem. A command gui de is printe d in the top margin of each page. The g uide indicates the current subsystem on that page.

62 Agilent E1418A SCPI Command Reference Chapter 3

The ABORt subsystem disab les the tr igge r system and places the tri gge r sy ste m in the trigger idl e st at e.

Subsystem Syntax ABORt

Parameters None.

Comments • Following this com ma nd, the trig ge r sy ste m is in the idle state . Se nding an

INITiate command after ABORt returns the trigger system to the wait-for -t ri gger

state.

• Triggering is described in more de ta il on pa ge 54.

ABORt

• Related Commands: INITiate[:IMMediate]

Chapter 3 Agilent E1418A SCPI Command Reference 63

APPLy

The APPLy subsystem enables and outputs a current or voltage on the spe cified channel.

Subsystem Syntax APPLyn

:CURRent <value | MIN | MAX | DEF> :VOLTage <

APPLyn:CURRent

APPLyn:CURRent <value | MIN | MAX | DEF> outputs a curr e nt on the specified

channel, n.

Parameters

APPLy

value | MIN | MAX | DEF>

Parameter

Name

APPLy

value> numeric (float 32) or

Parameter

Type

keyword 1 to 8 or 1 to 16 1

-0.02 Amps to +0.02 A m ps or

discrete

Comments • In the keyword, APPLyn, th e valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter can range from -0. 02 to +0.02 Amps. MIN sets -0.02 Amps output. MAX sets +0.02 Amps output. DEF sets 0 Amps output.

• This command is affected by the state of the P/J jumper for this channel on the

terminal module. To use the

–

the P/J jumper must be set to program selectable or, if set to jumper selectable,

– the V/I jumpe r m ust be se t to the curren t mode.

These jumpers are de sc ribe d on pa ge 31.

APPLyn:CURRent command:

Range of

Values

MIN | MAX | D E F

Default

• Equivalent C o m m a nds: SOURcen:FUNCtion:MODE CURR,

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude], OUTPutn[:STATe] ON

•

*RST Condition:

– If the P/J jumpe r is se t to pr ogra m se le c ta b le :

output mode is set to voltage, 0 volt s output, outp ut r elay open.

– If the P/J jumpe r is se t to jumper selecta ble:

output mode is set by the V/I jumper, 0 volts or amps, output relay open.

64 Agilent E1418A SCPI Command Reference Chapter 3

APPLyn:VOLTage

Parameters

APPLy

APPLyn:VOLTage <value | MIN | MAX | DEF > outputs a voltage on the specified

channel, n.

Parameter

Name

APPLy

n keyword 1 to 8 or 1 to 16 1

value>

Parameter

Type

numeric (float 32) or

discrete

-16 V to +16 V or MIN | MAX | DEF 0

Comments • In the keyword, APPLyn, th e valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter can range from -16 Vol ts to +16 Volts. MIN sets -16 Volts output. MAX sets +16 Volts output. DEF sets 0 Volts output.

• This command is affected by the state of the program jumper on the terminal

module for this channel. To use the

– the P/J jumper must be set to program selectable or, if set to jumper selectable, – the V/I jumpe r m ust be se t to the voltage mode.

This jumper is described on page 31.

APPLyn:VOLT command:

Range of

Values

Default

• Equivalent C o m m a nds: SOURcen:FUNCtion:MODE VOLT,

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude], OUTPutn[:STATe] ON

•

*RST Condition:

– If the P/J jumpe r is se t to pr ogra m se le c ta b le :

output mode is set to voltage, 0 volt s output, outp ut r elay open.

– If the P/J jumpe r is se t to jumper selecta ble:

output mode is set by the V/I jumper, 0 volts or amps, output relay open.

Chapter 3 Agilent E1418A SCPI Command Reference 65

CALibration

The CALibration commands are use d dur ing periodic cal ibra tion of the module. Calibration is des crib ed in Appe ndix D of this manual, beginning on page 155. You

should review Appendix D before using any of these commands.

Subsystem Syntax CALibration

:CONDition? :CONFigure

:RESistance? :RESet :STORe :TEST? :VALue

:RESistance <

CALibration

:CONFigure

:CURRent?

:VOLTage? :VALue

:CURRent? <

:VOLTage? <

CALibration

value>

66 Agilent E1418A SCPI Command Reference Chapter 3

CALibration:CONDition?

CALibration:CONDition? queries the module type and calibration status. The

query returns four 16- bit un signed integers.

Parameters Returns: four unsigned 16-bit integer s (u int 16) .

Comments • The integers return ed indic a te the module configur a tion and status at th e last

calibration, not the current conf iguration of the module. The first and sec ond integers retur ne d f ro m thi s que r y can be c ompared to the first a nd third integer s returned from the configuration ha s c ha nge d since the last ca libr a tion.

CALibration

DIAGnostic:CONFigure? query to determine if the module

Integer

Returned

1 Expansion Board ID in the form:

0 = present, 7 = none (expansion board contains channels 9–16)

2 2nd 16-bit value indicates how th e chan nel s ar e conf igur ed ( is olat ed

or non-isolated). A bit set to 0 indicates an isolated channel, a bit set to 1 indicates a non- i solat ed channel. Bits 0–15 correspond to channels 1–16 , respectively.

3 3rd 16-bit value indica te s th e cur ren t ca librat i on stat us f or each

channel. A bit set to 0 indicates the chan nel is not calib rated for current, a bit set to 1 i ndicat es the channel has been calibrated fo r current. Bits 0– 15 cor re spon d to channels 1–16, respe ctiv ely.

4 4th 16-bit value indicat es t he vol t age cal ib ration st at us for each

channel. A bit set to 0 indicates the chan nel is not calib rated for voltage, a bit se t to 1 indi cat es the channel has been cali bra ted fo r voltage. Bits 0– 15 cor re spond to channels 1–16 , respectively.

Meaning

Chapter 3 Agilent E1418A SCPI Command Reference 67

CALibration

CALibration:CONFigure:RESistance?

CALibration:CONFigure:RESistance? configures the modu le to pe rfo rm

calibration of th e internal calibration resistor and returns a readiness of the module.

Parameters Returns: signed 16-bit integer (in t16). 1 = read y, 0 = not rea dy.

Comments • The internal calibration r e sistor should be calibrated before calibrating the

channels in current mode.

• This query configures the module for a 4-wire resistance measurement at the CAL

output termina ls w he n the c al ibr a tion point is set to

DIAGnostic:CALibration:OUTPut[:MODE] CALBus command).

• This query may also be u se d to se t a n external calib ration resisto r value when

calibrati n g at each chan ne l outp ut.

0 or 1 indicating the

CALB (following a *RST or

• This query is used together with the CALibration:VALue:RESistance command to

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

• Related Commands: CALibration:VALue:RESistance

CALibration:RESet

CALibration:RESet reloads, for mo dule use , the calibration cons ta nts stored in

non-volatil e m em or y.

Parameters • None.

Comments • This command, with respect to th e ca libr a tion constant s, perf o rms the same action

• At power-on, or following this co m ma nd, c al ibra tion constants store d in

calibrate the cu rrent calibration resi sto r.

for additional information about this comm and.

as power-on.

non-volatile memory are loaded into the module where they are used during output operations.

• If the trigger system is waiting for a trigg er whe n thi s co mmand is received,

an error is generated.

• This command opens all output relays.

• Related Commands: CALibration:STORe

68 Agilent E1418A SCPI Command Reference Chapter 3

CALibration:STORe

CALibration:STORe loads the stored non- volatile memo ry calibration c onstants

with the calibration constants c ur rently in use by the module.

Parameters None.

Comments • This command sets the calibration const ants in non-volati le me mor y if the CA L

• At power-on, calibration constants stored in non-volatile memo ry are loaded into

• When this command is received, the checksum is verified using the constants

CALibration

Store Enable Ju mpe r is pr ope r ly se t ( se e pag e 15 7) . Non- volatile mem or y ha s finite life, based upon the number of write s. Use thi s co mm an d spa r ingly.

the module wher e th ey are use d during output oper ations.

currently in use by the module. If the checksum does not verify, the non-volatile memory is not upda te d a nd a n err or is ge ne r ated .

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

• Related Commands: CALibration:RESet

CALibration:TEST?

CALibration:TEST? pe rforms an internal ro ugh c he c k of the calibration of each

channel and ret ur ns a n inte ge r indicating the cha nne l c al ibra tion condition. Calibration is checked to appr oximately ± 2%.

Parameters Returns: unsigned 16-bit integer ( uint16).

Comments • Following the complet ion of this query all outp uts a r e disa ble d a nd se t to 0 Volts

• This query returns a 16-bit inte ge r indic a ting the calibration status of each cha nne l.

– Bits set to 0 indic a te no calibration errors were fou nd. – Bits set to 1 in dic a te a cha nnel with que stionable calibr at ion. – Bits 0–15 correspond to channels 1–16, r es pe ctive ly.

for additional information about this comm and.

or 0 Amps based on the ch an ne l mode.

• If the trigger system is waiting for a trigg er whe n thi s co mmand is received, a n

error is generate d.

Chapter 3 Agilent E1418A SCPI Command Reference 69

CALibration

CALibration:VALue:RESistance

CALibration:VALue:RESistance <value> enters a new measured value to be used

as the internal c al ibr a tion resistor consta nt by the module .

Parameters

Parameter

Name

value> numeric (float 32) Must be > 0 ohms none

Parameter

Type

Range of

Values

Default

Comments • The new calibration co nsta nt is used by the module but not stored in non- volatile

memory.

• This command is used toge ther with the CALibration:CONFigure:RESistance?

query to calibra te the internal cur ren t ca libration resistor.

• The internal calibration re sistor should be calibrated before calibrating cha nne ls in

current mode. When calibrating at the CAL connections and using the internal calibration resis tor , the val ue nee d only be entered once to calibrate al l ch an ne ls.

• If using an external resistor to calibrate current mode , you must calibrate at each

channel output. External resistances in the range of 50 Ω to 500 Ω are recommended.

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

for additional information about this comm and.

• Related Commands: CALibration:STORe, CALibration:CONFigure:RESistance?

70 Agilent E1418A SCPI Command Reference Chapter 3

CALibrationn:CONFig ure:CURRent?

CALibrationn:CONFigure:CURRent? configures the cha nne l f or cu rre nt mode

calibrati on and retu rn s a

Parameters

Parameter

Name

CALibration

Returns: an unsigned 16-bit integer (uint16). 1 = ready, 0 = not read y.

Comments • In the keyword, CALibrationn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This command is used toge ther with the CALibrationn:VALue:CURRent? <value>

query to perform cu rrent mode calibration .

0 or 1 to indicate the ch annel’s readiness for calibra tion.

Parameter

Type

keyword 1 to 8 or 1 to 16 1

Range of

Values

CALibration

Default

• The calibration is perf or me d e ither at the CAL output termin al s or at an individual

channel. The choi ce is m ade using the

DIAGnostic:CALibration:OUTPut[:MODE]

command.

– When the DIAG:CAL:OUTP:MODE CALBus command (also the reset state)

is used, the out p ut relay routes the calibrat ion curr en t to the CAL outpu t terminals (an d ope ns a ll c ha nne l output termina ls) .

– When the DIAG:CAL:OUTP:MODE CHANnel command is used, the output relay

routes the calibration current to the channel terminals (the CAL terminals are not connected).

DIAG:CAL:OUTP:MODE command must be se nt to the module befor e the

The

CALibrationn:CONFigure:CURRent? query.

• This query will generate an error if the tri gger syste m is waiting for a trigger event

when this comm and is received.

• This query returns a 0 to indicate tha t the channel is not r ead y for calibration, and

1 to indicate the channel is ready for calibration.

• This query is affected by the state of th e program jumper f or this ch a nne l on the

terminal module. To use thi s co mmand:

– the P/J jumper must be set to program selectable or, if set to jumper selectable, – the V/I jumpe r mu st be se t to the current mod e. The jumpers are describe d on

page 31.

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

for additional information about this comm and.

• Related Commands: CALibrationn:VALue:CURRent?,

DIAGnostic:CALibration:OUTPut[:MODE]

Chapter 3 Agilent E1418A SCPI Command Reference 71

CALibration

CALibrationn:CONFigure:VOLTage?

CALibrationn:CONFigure:VOLTage? configures the channel for voltage mode

calibrati on and retu rn s a

Parameters

0 or 1 to indicate the ch annel’s readiness for calibra tion.

Parameter

Name

CALibration

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Range of

Values

Returns: an unsigned 16-bit integer (uint16). 1 = ready, 0 = not read y.

Comments • In the keyword, CALibrationn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This command is used toge ther with the CALibrationn:VALue:VOLTage? query to

perform voltag e mode calibration.

• The calibration is perf or me d e ither at the CAL output termin al s or at an individual

channel. The choi ce is m ade using the command.

– When the DIAG:CAL:OUTP:MODE CALBus command (also the reset state)

is used, the output relay routes the calibration voltage to the CAL output terminals (an d ope ns a ll c ha nne l output termina ls) .

– When the command DIAG:CAL:OUTP:MODE CHANnel is used, the output

relay routes the calibration voltage to the c hannel terminals (the CAL terminals are not connected).

DIAGnostic:CALibration:OUTPut[:MODE]

Default

DIAGnostic:CALibration:OUTPut[:MODE] command must be sen t to the

The module before the

• This query will generate an error if the tri gger syste m is waiting for a trigger event

CALibrationn:CONFigure:VOLTage? query.

when this comm and is received.

• This query returns a 0 to indicate tha t the channel is not r ead y for calibration,

1 to indicate the channel is ready for calibration.

and a

• This command is affected by the state of the program jumper for this channel on

the terminal module. To use this co mmand:

– the P/J jumper must be set to program selectable or, if set to jumper selectable, – the V/I jumpe r m ust be se t to the voltage mode.

The jumpers are desc ri be d on page 31.

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

for additional information about this comm and.

• Related Commands: CALibrationn:VALue:VOLTage?,

DIAGnostic:CALibration:OUTPut[:MODE]

72 Agilent E1418A SCPI Command Reference Chapter 3

CALibrationn:VALue:CURRent?

CALibrationn:VALue:CURRent? <value> enters a measured c a libr a tion value

and returns a value indicating the present state of the current calibration process.

Parameters

CALibration

Parameter

Name

CALibration

value>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

numeric (float 32) 0. 0 t o 6. 0 V none

Range of

Values

Returns: unsigned 16-bit integer (uint 16) .

Comments • In the keyword, CALibrationn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This command is used toge ther with the CALibrationn:CONFigure:CURRent?

query to perform vol ta ge mode c alibra tion. Following the CALn:CONF:CURR? query, this com ma n d is used repetitively until the return value indic a tes that the cali b r a tion is c omplete.

• The <value> parameter is the measured output voltage. A minimum of

9 measurement s must be taken to cali brat e a ch an ne l fo r cur r en t mode output (a maximum of 50 me a sur e men t s ma y be required).

• This query returns one of the following values :

Return

Value

0 Calibration is complete.

New constants are in RAM.

1 More measurement s are needed.

2 Calibration is complete.

New constants are in RAM.

Resistance is not cal ibrated.

3 More Measurement s ar e needed.

Resistance is not cal ibrated.

5 Calibration abo rted.

Meaning

Resistance is cal i bra te d.

Default

Chapter 3 Agilent E1418A SCPI Command Reference 73

CALibration

• A returned value of 5 (calibration abor te d) is gi ve n if eithe r:

a. The command is r ece ive d whe n the module is in volt ag e ca libr a tion or

resistance cali br at ion m ode , or

b. The calibr at ion in process has ent ere d more than 50 val ues without a

successful ca libr a tion.

• If the internal calibration resistor is not calibrated, the c hannel is not marked as

calibrated following the completion of calibration (see the

CALibration:CONDition?

query). The new calibration constants are used, however.

• When the channel cu rre n t c a libr a tion is comple te d, the new calibra tion constant s

are used by the module, but not st ored in non-volatile me mory.

• If a calibration is inte rrupted before c ompletion (th at is, by another comm and

being received), no constants will be changed.

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

for additional information about this comm and.

• Related Commands: CALibration:STORe, CALibrationn:CONFigure:CURRent?

CALibrationn:VALue:VOLTage?

CALibrationn:VALue:VOLTage? <value> enters a measured calibration value and

returns a value indicating the present state of the voltage calibration process.

Parameters

Parameter

Name

CALibration

value> numeric (float 32) 0 to 19.2 V none

Returns: unsigned 16-bit integer (uint 16) .

Comments • In the keyword, CALibrationn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This command is used together with the CALibrationn:CONFigure:VOLTage? query

to perform voltage mode calibration. Following the command is used repetitively until the return value indicates that the calibration is complete.

Parameter

Type

keyword 1 to 8 or 1 to 16 1

Range of

Values

CALn:CONF:VOLT? query, this

Default

• The <value> parameter is the measured output voltage. A minimum of

9 measurement s must be taken to calibr at e a volt ag e ou tput channel (a maximum of 50 me a sur e men t s ma y be required).

74 Agilent E1418A SCPI Command Reference Chapter 3

CALibration

• This query returns one of the following values :

Return

Value

0 Calibration is complet e.

New constants ar e in RAM. 1 More measurements ar e needed. 5 Calibration aborted .

• A return value of 5 (calibration aborte d) is gi ve n if eithe r:

a. The command is r ece ive d whe n the module is in cu rre nt c a libr a tion or

resistance cali br at ion m ode , or

b. The calibr at ion in process has ent ere d more than 50 val ues without a

successful ca libr a tion.

• When the channel voltage calibra tion is comple te d, the n ew c a libration consta nt s

are used by the module, but not st ored in non-volatile me mory.

• If a voltage calibration is inte rr upte d be f or e com ple tion (that is, by another

command being received), no constants are changed.

Meaning

• Refer to Appendix D, “Voltage/Current Output Adjustment”, starting on page 155,

for additional information about this comm and.

• Related Commands: CALibration:STORe, CALibrationn:CONFigure:VOLTage?

Chapter 3 Agilent E1418A SCPI Command Reference 75

DIAGnostic

The DIAGnostic subsystem contains commands used to check the module configuration, enable or disable al l outputs simulta ne ously, change a ch annel’s mode without ope ning and closing the output relay, and c he c k the sta te of the trigge r on all channels .

Subsystem Syntax DIAGnostic

:CALibration

:OUTPut

:CONFigure? :OUTPut

:ALL

:SOURce

:FUNCtion

:TRIGgered?

[:MODE] < [:MODE]?

[:STATe] <

:MODE <

DIAGnostic

path>

state>

mode>

DIAGnostic:CALibration:OUTPut[:MODE]

DIAGnostic:CALibration:OUTPut[:MODE] <path> sets the voltage calibration

path for the module to either the CAL output terminals or at each output channel.

Parameters

Parameter

Name

path> discrete CALBus or CHANnel none

Comments • The typical calibration mode f or the module is through the CAL out put te r mi n als.

Following output terminals (and this command is not needed).

• This command with the CHANnel parameter, sets calibration to be performed at

each channel’s output terminals ( a nd so includes the cha nne l output relay contacts).

• This command must be sent bef or e any CALibrationn:CONFigure:VOLTage? or CALibrationn:CONFigure:CURRent? query.

• *RST State: Calibration paths set to us e the CAL outpu t term ina ls.

*RST or power-on, the def a ult c a libr a tion mode is through the CAL

Parameter

Type

Range of

Values

Default

76 Agilent E1418A SCPI Command Reference Chapter 3

DIAGnostic:CALibration:OUTPut[:MODE]?

DIAGnostic:CALibration:OUTPut[:MODE]? queries th e volta ge calibration path

for the module.

Parameters Returns: string.

Comments • The returned string will be one of CALB or CHAN.

DIAGnostic:CONFigure?

DIAGnostic:CONFigure? returns six 16-bit wor ds indicating the prese nt se ttings of

the module.

Parameters Returns: six unsigned 16-bit inte ge r s (u int16).

Comments • This query returns six 16-bit words with the following meanings:

DIAGnostic

Integer

Returned

1st Expansion Board ID in the form: 0 = present, 7 = none

(expansion board contains channels 9–16).

2nd Ter minal Module ID in the form:

0 = screw type, 7 = none or oth er.

3rd Isolated/N on- Isol at ed Channel Status

A bit set to 0 indicates an iso la te d chan nel .

A bit set to 1 indicates a non- isol ated channel or no plug-on m odul e

installed (DO NO T oper at e t he m odule w it hout a plug- on m odule).

Bits 0–15 corres pond to channels 1–16, re spec tively*.

4th Channel Mode

A bit set to 0 indicate s a cur ren t ou tp ut channel. A bit set to 1 indicate s a vol tage output channel .

Bits 0–15 corres pond to channels 1–16, re spec tively*.

5th Channel Output Sta te

A bit set to 0 indicates t he channel output relay i s closed.

A bit set to 1 indicate s th e channel output rela y is open.

Bits 0–15 corres pond to channels 1–16, re spec tively*.

6th Channel Mode Programm abl e St at e (P/J Jumper)

A bit set to 0 indicate s a channel is not programm abl e.

A bit set to 1 indicate s a channel is programmabl e.

Bits 0–15 corres pond to channels 1–16, re spec tively*.

* For 8 channel conf i gur ations, the uppe r 8 bi t s of integers 3, 4, 5, and 6 are set to 1’s.

Meaning

Chapter 3 Agilent E1418A SCPI Command Reference 77

DIAGnostic

DIAGnostic:OUT P ut:ALL[:STATe]

DIAGnostic:OUTPut:ALL[:STATe] <state> opens or clo se s all channel outpu t

relays at once.

Parameters

Parameter

Name

state> boolean OFF | ON | 0 | 1 0

Parameter

Type

Comments • This command performs the same functi on a s the OUTPutn[:STATe] command,

but enables or di sa ble s a ll out puts simultane ously.

• Related Commands: OUTPutn[:STATe]

DIAGnostic:SOURcen:FUNCtion:MODE

DIAGnostic:SOURcen:FUNCtion:MODE <mode> change s the output mode of th e

channel without disabling the ch an ne l output.

Parameters

Parameter

Name

SOURce

n keyword 1 to 8 or 1 to 16 1

mode>

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

Parameter

Type

discrete CURRent or VOLTage none

Range of

Values

Range of

Values

Default

• Use this command with caution. The output voltage or current is not

predictab le during the mo d e c hange and tra nsients will occ ur .

• This command performs the same function as the SOURcen:FUNCtion:MODE

command, but does not disable the output during the mode change. This command can reduc e the se ttling time requi red to disable and en a ble the outputs.

• Following a mode change with this comma nd, the appropriate calibration c onstants

are used, the channel mode is c hanged, and the output is set to either 0 V or 0 A.

• This command will generate an error if the trigger system is waiting for a trigger

event when this command is received.

• This command is affected by the state of the P/J jumper on the term ina l m odule.

If the P/J jumpe r is not se t to Program Sele c ta ble , this comma nd will generat e an error. This jumper is de scri be d on pa ge 31.

• Related Commands: SOURcen:FUNCtion:MODE

78 Agilent E1418A SCPI Command Reference Chapter 3

DIAGnostic:TRIGgered?

DIAGnostic:TRIGgered? returns a 16-bit word indi cati ng the c ur rent trigger status

of the module.

Parameters Returns: unsigned 16-bit integer ( uint16).

Comments • This query returns a 16-bit word indic a ting the trigger sta tus of ea ch channel.

– A bit is set to 0 to indicate the cha nne l is not waitin g fo r a tr igge r . – A bit is set to 1 to indicate the cha nne l is in the wait-fo r-tr igger state. – Bits 0–15 correspond to channels 1–16, r es pe ctive ly.

• Related Commands: TRIGger:SOURce

DIAGnostic

Chapter 3 Agilent E1418A SCPI Command Reference 79

INITiate

The INITiate subsystem chan ges the trigger state fr om idle to wait-f or-trigger .

Subsystem Syntax INITiate

[:IMMediate]

INITiate[:IMMediate]

Changes the trigger system from the idle sta te to the wait-for- tr igge r sta te .

Parameters None.

INITiate

Comments • If this command is rece ive d a nd the trigger sy ste m is not idle, an erro r is

generated.

• If this command is received and no channels are waiting for a trigger event, an

error is generate d.

• Triggering is described in more de ta il on pa ge 54.

• Related Commands: TRIGger:SOURce, SOURcen:VOLTage:TRIGgered,

SOURcen:CURRent:TRIGgered, ABORt

80 Agilent E1418A SCPI Command Reference Chapter 3

The OUTPut subsyste m provides com ma nds to open or close the output relay on each channel and to enable the m odule to output the selected trigger sour c e on one of the VXIbus TTL trigger lines.

Subsystem Syntax OUTPut

:TTLTrg

OUTPut

[:STATe] <state> [:STATe]?

OUTPut:TTLTrgn[:STATe]

OUTPut

[:STATe] <state> [:STATe]?

OUTPut:TTLTrgn[:STATe] <state> specifies which VXIbus TTLTRG line is

enabled to so ur ce a VXIbus trigger whe n the module is trigg ere d.

Parameters

Parameter

Name

TTLTrg

n keyword 0 to 7 none

state>

Parameter

Type

boolean OFF | ON | 0 | 1 0

Range of

Values

Default

Comments • VXIbus TTLTRG lines are numbered from 0 to 7. Only one line can be enabled

at a time.

• If a different line is already enabled when this command is received, a settings

conflict erro r is repor te d.

• This command sources a trigge r from the module. The TRIGger:SOURce TTLTn

command programs the modul e to accept triggers from the VXIbus TTLTRG lines. The module can be programmed to both accept and source triggers on the VXIbus TTLTRG lines but the source TTLTRG line and the accepted TTLTRG line must be diff e rent.

• This command should be sent before the TRIGger:SOURce TTLTn command.

• *RST Condit ion: All lines di sa ble d.

• Related Commands: TRIGger:SOURce TTLTn, OUTPut:TTLTn[:STATe]?

Chapter 3 Agilent E1418A SCPI Command Reference 81

OUTPut

OUTPut:TTLTrgn[:STATe]?

OUTPut:TTLTrgn[:STATe]? queries if the specified VXIbus TTLTRG line is set to

be a source of trigger from the module.

Parameters

Comments • This query returns a 1 if the specified VXIbus TTLTRG line is enabled as a

OUTPutn[:STATe]

Parameters

Parameter

Name

TTLTrg

n keyword 0 to 7 none

Parameter

Type

Range of

Values

Returns: unsigned 16-bit integer (uint 16) .

trigger source . Thi s que r y returns a

0 if the specified VXIbus TTLTRG line is

disabled as a trigger source.

• Related Commands: OUTPut:TTLTn[:STATe]

OUTPutn[:STATe] <state> opens or closes the specified channel output relay.

Parameter

Name

OUTPut

state>

Parameter

Type

keyword 1 to 8 or 1 to 16 none

boolean OFF | ON | 0 | 1 none

Range of

Values

Default

Comments • In the keyword, OUTPutn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This command sets the output state of individua l c ha nne l output relays. Use the

DIAGnostic:OUTPut:ALL[:STATe] command to set all channels with a single

command.

• *RST Condit ion: All output relays open.

• Related Commands: OUTPutn[:STATe]?, DIAGnostic:OUTPut:ALL[:STATe]

82 Agilent E1418A SCPI Command Reference Chapter 3

OUTPutn[:STATe]?

OUTPutn[:STATe]? queries the state of the specified channel output relay and

returns a

Parameters

OUTPut

0 or 1.

Parameter

Name

OUTPut

n keyword 1 to 8 or 1 to 16 none

Parameter

Type

Returns: unsigned 16-bit integer (uint 16) .

Comments • In the keyword, OUTPutn, the valid range of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The quer y retu rns a 0 if the specified channel output relay is open. The query

returns a

• Related Commands: OUTPutn[:STATe]

1 if the specified channel output relay is closed.

Range of

Values

Default

Chapter 3 Agilent E1418A SCPI Command Reference 83

SOURce

The SOURce subsystem pro vide s co m ma nds used to output a voltage or current at each channel.

Subsystem Syntax SOURcen

:CURRent

:FUNCtion

:VOLTage

[:LEVel]

[:IMMediate]

[:AMPLitude] < [:AMPLitude]?

:TRIGgered

[:AMPLitude] < [:AMPLitude]?

:MODE < :MODE?

[:LEVel]

[:IMMediate]

[:AMPLitude] < [:AMPLitude]?

:TRIGgered

[:AMPLitude] < [:AMPLitude]?

SOURce

value | MIN | MAX | DEF>

mode>

value | MIN | MAX | DEF>

84 Agilent E1418A SCPI Command Reference Chapter 3

SOURcen:CURRent[:LEVe l][:IMMediate][:AMPLitude]

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude] <value | MIN | MAX | DEF>

immediately outputs the current se t in value at channel n when the output relay is closed.

Parameters

SOURce

Parameter

Name

SOURce

value>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

numeric (float 32) or

discrete

-0.02 Amps to +0.02 A m ps or MIN | MAX | D E F

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter is a floating poin t 32-bit number in th e ra nge of -0. 02 A

to +0.02 A.

MIN sets -0.02 Amps. MAX sets +0.02 Amps. DEF sets 0 Amps.

• This command immediat el y pr ogra ms the specified c ur ren t on c ha nne l n. The

output state of the c ha nne l must be enable d fo r th e cur ren t to a ppe a r at the out put terminals.

• If the channel is in the voltage mode when this command is received, an error is

generated.

Range of

Values

Default

• Related Commands: SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude]?,

SOURcen:FUNCtion:MODE CURRent, OUTPutn[:STATe]

Chapter 3 Agilent E1418A SCPI Command Reference 85

SOURce

SOURcen:CURRent[:LEVe l][:IMMediate][:AMPLitude]?

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude]? [<MIN | MAX | DEF>

queries the last ou tput value written by

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude].

Parameters

Parameter

Name

SOURce

<MI N | MAX | D E F> discrete (option al) MIN | MAX | DEF none

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Returns: 32-bit floating point numb er ( floa t 32) .

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• If no parameter is given, thi s que r y returns the source curr e nt se t on c ha nne l n by

the last value returned is the value last programmed on that channel, not an actual measurement of th e har dwa re ou tput value.

• If a parameter is giv en ,

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude] command. The

MIN returns -0.02 Amps. MAX returns +0.02 Amps. DEF returns 0 Amps.

Range of

Values

Default

• This command generates an err or if channe l n is in the voltage output mode .

• Related Commands: SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude],

SOURcen:FUNCtion:MODE CURRent

86 Agilent E1418A SCPI Command Reference Chapter 3

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude]

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] <value | MIN | MAX | DEF>

outputs the current set in value at chann el n when the trigger conditions are satisfied and the output relay is closed. Use this command to synchronize multiple channel outputs.

Parameters

SOURce

Parameter

Name

SOURce

value>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

numeric (float 32) or

discrete

-0.02 Amps to +0.02 A m ps or MIN | MAX | D E F

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter is a floating poin t 32-bit number in th e ra nge of -0. 02 A

to +0.02 A.

MIN sets -0.02 Amps. MAX sets +0.02 Amps. DEF sets 0 Amps.

• This command sets channel n to output the current specified following a valid

trigger condition. Following thi s co mmand, the trigge r syste m must be enabled using an for additional information.

INITiate comm and. See the T RIGger sub syst em disc ussion on page 54

Range of

Values

Default

• If the module is in a wait-f o r-t ri gge r sta te (INIT has been received) when this

command is re ceived, an error is ge ne r a te d.

• The output state of the channel must be enabled and the trigger event satisfied for

the current to appear at the output termin als.

• If the channel is in the voltage mode when this command is received, an error is

generated.

• Related Commands: SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude]?,

SOURcen:FUNCtion:MODE CURRent, OUTPutn[:STATe]

Chapter 3 Agilent E1418A SCPI Command Reference 87

SOURce

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude]?

SOURcen:CURRent[:LEVel]:TRIGgered][:AMPLitude]? [<MIN | MAX | DEF>

queries the last va lue written by ei the r

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] or SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude].

Parameters

Parameter

Name

SOURce

<MI N | M AX | D EF> discrete (option al) MIN | MAX | DEF none

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Returns: 32-bit floating point numb er ( floa t 32) .

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• If no parameter is given, thi s que r y returns the last va lue se t on c ha nne l n by the

last

SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude] or

SOURcen:CURRent[:LEVel][:IMMediate][:AMPLitude] command. The value

returned is the value last programmed on that channel, not an actual measurement of the hardware outp ut va lue .

• If a parameter is giv en ,

MIN returns -0.02 Amps. MAX returns +0.02 Amps. DEF returns 0 Amps.

Range of

Values

Default

• This command generates an err or if channe l n is in the voltage output mode .

• Related Commands: SOURcen:CURRent[:LEVel]:TRIGgered[:AMPLitude],

SOURcen:FUNCtion:MODE CURRent

88 Agilent E1418A SCPI Command Reference Chapter 3

SOURcen:FUNCtion:MODE

SOURcen:FUNCtion:MODE <mode> configures channel n for either current or

voltage output.

Parameters

SOURce

Parameter

Name

SOURce

mode>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

discrete CURRent or VOLTage none

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• Following this command, th e ou tput is disabled and set to eithe r 0 A or 0 V.

• If the module is in the wait-for-trigger state when this command is received, an

error is generated.

• This command is affected by the state of the P/J jumper for this channel on the

terminal module. If the P/J jumper is not set to program se lectable this c ommand will return an error. This jumper is describe d on pa ge 31.

• *RST Condit ion:

– If the P/J jumpe r is se t to pr ogra m se le c ta b le :

output mode is set to voltage, 0 volt s output, outp ut r elay open.

Range of

Values

Default

– If the P/J jumpe r is se t to jumper selecta ble:

output mode is set by the V/I jumper, 0 volts or amps, output relay open.

• Related Commands: SOURcen:FUNCtion:MODE?, SOURcen:CURRent…

commands, SOURcen:VOLTage… commands

Chapter 3 Agilent E1418A SCPI Command Reference 89

SOURce

SOURcen:FUNCtion:MODE?

SOURcen:FUNCtion:MODE? queries channel n fo r cur r en t or volta ge output

mode. The query returns a string.

Parameters

Parameter

Name

SOURce

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Returns: string.

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• This query returns CURR or VOLT.

• Related Commands: SOURcen:FUNCtion:MODE

Range of

Values

Default

90 Agilent E1418A SCPI Command Reference Chapter 3

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude]

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude] <value | MIN | MAX | DEF>

immediately outputs the voltage set in value at channel n when the output relay is closed.

Parameters

SOURce

Parameter

Name

SOURce

value>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

numeric (float 32) or

discrete

-16 V to +16 V or MIN | MAX | D E F

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter is a floating poin t 32- bit number in th e range of -16 Vo lts

to +16 Volts.

MIN sets -16 Volts. MAX sets +16 Volts. DEF sets 0 Volts.

• This command immediat el y pr ogra ms the specified voltage on cha nne l n. The

output relay for th at channel must be clos ed for the vol ta ge to ap pe ar a t the output terminals.

• This command generates an err or if channe l n is in the current ou tput mode.

Range of

Values

Default

• Related Commands: SOURcen:FUNCtion:MODE VOLTage,

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude]?, OUTPutn[:STATe]

Chapter 3 Agilent E1418A SCPI Command Reference 91

SOURce

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude]?

SOURcen:VOLTage [:L EV e l][ :IM Med i a te][:AMPLitu de]? [<MIN | MAX | DEF>

queries the last ou tput value written by

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude].

Parameters

Parameter

Name

SOURce

<MI N | MAX | D EF> discrete (optional) MIN | MAX | DEF none

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Returns: 32-bit floating point numb er ( floa t 32) .

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• If no parameter is given, thi s que r y returns the last va lue se t on c ha nne l n wit h the

last

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude] command. The value

returned is the value last programmed on that channel, not an actual measurement of the hardware outp ut va lue .

• If a parameter is giv en ,

MIN returns -16.000. MAX returns +16.000. DEF returns 0.0000.

Range of

Values

Default

• This command generates an err or if channe l n is in the current ou tput mode.

• Related Commands: SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude],

SOURcen:FUNCtion:MODE VOLTage

92 Agilent E1418A SCPI Command Reference Chapter 3

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude]

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude] <va l ue | MIN | MAX | DEF>

outputs the voltage set in value at chann el n w he n the trigger c onditions a re sa tisfied and the channel output relay is closed. Use this command to synchronize multiple channel outputs.

Parameters

SOURce

Parameter

Name

SOURce

value>

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

numeric (float 32) or

discrete

-16 V to +16 V or MIN | MAX | D E F

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• The <value> parameter is a floating poin t 32- bit number in th e range of -16 Vo lts

to +16 Volts.

MIN sets -16 Volts. MAX sets +16 Volts. DEF sets 0 Volts.

• This command sets channel n to output the voltage spe cifi ed fol lowing a valid

trigger condition. Following thi s co mmand, the trigge r syste m must be enabled using an additional in fo rm a tion.

INITiate comm and. See the T RIGger sub syst em disc ussion, page 54, f or

Range of

Values

Default

• The channel output relay must be closed for the voltage to appear at the output

terminals.

• If the module is in a wait-f o r-t ri gge r sta te (INIT has been received) when this

command is re ceived, an error is ge ne r a te d.

• If the channel is in the current mode when this command is received, an error is

generated.

• Related Commands: SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude]?,

SOURcen:FUNCtion:MODE VOLTage

Chapter 3 Agilent E1418A SCPI Command Reference 93

SOURce

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude]?

SOURcen:VOLTage [:L EV e l]: TRI G ger ed ][:AMPLitu d e]? [<MIN | MAX | DEF>

queries the late st va lue written by either

SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude] or SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude].

Parameters

Parameter

Name

SOURce

<MI N | MAX | D EF> discrete (optional) MIN | MAX | DEF none

n keyword 1 to 8 or 1 to 16 1

Parameter

Type

Returns: 32-bit floating point numb er ( floa t 32) .

Comments • In the keyword, SOURcen, the valid rang e of n is:

1 to 8 for E1418A, E1418A Option 002 1 to 16 for E1418A Option 001, E1418A Option 003.

Values of n outside these rang es will ge ne rat e an e rror.

• If no parameter is given, thi s que r y returns the last va lue se t on c ha nne l n by the

SOURcen:VOLTage[:LEVel][:IMMediate][:AMPLitude] or SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude] command. The value

returned is the value last programmed on that channel, not an actual measurement of the hardware outp ut va lue .

• If a parameter is giv en ,

MIN returns -16.000. MAX returns +16.000. DEF returns 0.000.

Range of

Values

Default

• This command generates an err or if channe l n is in the current ou tput mode.

• Related Commands: SOURcen:VOLTage[:LEVel]:TRIGgered[:AMPLitude],

SOURcen:FUNCtion:MODE VOLTage

94 Agilent E1418A SCPI Command Reference Chapter 3

The STATus subsystem con tro ls the SCPI-define d O pe r a tion and Questionable Status Registers and the Standard Event Register. Each is comprised of a Condi tion Register, an Event Register, and an Enable mask. The SCPI Status System is shown in the figure below.

Subsystem Syntax STATus

:OPERation

:CONDition? :ENABle < :ENABle?

[:EVENt]? :PRESet :QUEStionable

:CONDition?

:ENABle <

:ENABle?

[:EVENt]?

STATus

mask>

Chapter 3 Agilent E1418A SCPI Command Reference 95

STATus

STATus:OPERation:CONDition?

STATus:OPERation:CONDition? returns the conten ts of the Ope rati on St at us

Condition Reg iste r. Reading the registe r doe s not affect its conten ts .

Parameters Returns: 16-bit signed integer (in t16).

Comments • Bit 0 of this registe r (d ecimal 1) is the Ca librating bit . This bit is set when:

– the CALibration:CONFigure:RESistance?, CALibrationn:CONFigure:VOLTage?,

CALibrationn:CONFigure:CURRent? command has been received a nd,

– measurements with the corres ponding CALibration:VALue:RESistance,

CALibrationn:VALue:VOLTage?, or CALibrationn:VALue:CURRent? commands

are not co m p lete.

• *RST Condit ion: clears all co nditions.

• *CLS and STATus:PRESet do not affect bit s in the St at us Ope r ation Condition

STATus:OPERation:ENABle

STATus:OPERation:ENABle <mask> specifies wh i ch bits of the Oper at iona l

Status Event Register are OR’d together to create the Operational Status bit (bit 7) in the Summa ry Re gister of the Status Byte.

Parameters

Parameter

Name

mask> numeric (int16) or

Comments • Only bit 0 (decimal 0) is used or de fi ne d in the Ope rat ion Register. Bit 0 is

defined as the Ca librating bit. A 1 in this bit indica te s the module is currently in the calibration mode .

• The non-decimal numeric forms are the #H, #Q, or #B formats specified by

IEEE-488.2.

• *RST clears all conditions.

• *CLS and STATus:PRESet do not affect bit s in the Ope r at ion S tatus Condition

Parameter

Type

non-d ecimal numeric

Range of

Values

-32768 to +32767 or #H00 00 t o #HFFFF none

Default

96 Agilent E1418A SCPI Command Reference Chapter 3

STATus:OPERation:ENABle?

STATus:OPERation:ENABle? returns the val ue of the mask set fo r the Operation

Status Register .

Parameters Returns: 16-bit signed integer (in t16).

STATus:OPERation[:EVENt]?

STATus:OPERation[:EVENt]? returns the value of the c ontents of the Op era tion

Status Event Register. Reading the register clears all bits in the register.

Parameters Returns: 16-bit signed integer (in t16).

Comments • Bit 0 of this register (decimal 1) is the only defined bit in this registe r .

• This bit is set if the CALibration:CONFigure:RESistance?, CALibrationn:CONFigure:VOLTage?, or CALibrationn:CONFigure:CURRent?

command has been received and the calibration process is not yet complete.

STATus

STATus:PRESet

• *RST Condit ion: no effect.

• *CLS clears the contents of the Operation Status Register.

• STATus:PRESet does not affect the contents of the Operation Status Register, but

does disable reporting the Summary bit to th e Sta tus B y te Register.

STATus:PRESet presets all Enable Registers to 0 (z ero). The command has no

effect on Condition or Eve nt R eg iste r s.

Chapter 3 Agilent E1418A SCPI Command Reference 97

STATus

STATus:QUEStionable:CONDition?

STATus:QUEStionable:CONDition? returns the value of the Questionable Stat us

Condition Reg ister . Reading the register doe s not aff ect it s contents. Since only two bits are used in the Agile nt E1418A and both thos e bits a re de fine d to be events, this comm and alway s retu rns

Parameters Returns: 16-bit signed integer (in t16).

Comments • Bit 8 of this register (d ecim a l 256) indicates the calibration condition. Bit 9 of

this register (de c im al 512) indicates the trigger-ignore d event.

• *RST Condit ion: clears all co nditions.

• *CLS and STATus:PRESet do not affect bits in the Questionable St at us Condition

STATus:QUEStionable:ENABle

0 and is included for compatibility purposes.

STATus:QUEStionable:ENABle <mask> specifies whic h bits of the Questionabl e

Event Registe r are O R’ d together to create the Questionable Data bit ( bit 3) in the Status Byte Sum ma ry Re gister.

Parameters

Parameter

Name

mask>

Parameter

Type

numeric (int16) or

non-d ecimal numeric

Range of

Values

-32768 to +32767 or #H00 00 t o #HFFFF none

Comments • Only bits 8 and 9 of the Questiona ble Dat a Reg iste r are use d or de fine d. Bit 8

indicates a questionable calibr a tion and bit 9 indic a te s a trigger was ignor ed .

• Either bit 8 or bit 9 can be used to generate an SRQ interrupt. Use the *SRE <mask>

common command to set the enable mask for the Status Byte Reg ister to incl ude the Questionable Data bit (bit 3) in the Request for Se rvic e bit ( bit 6) . T he r equest f o r Service bit (bit 6) is used to generate the SRQ interrupt.

• The non-decimal numeric forms are the #H, #Q, or #B formats specified by

IEEE-488.2.

• *RST clears all conditions.

Default

• *CLS and STATus:PRESet do not affect bits in the Questionable St at us Condition

98 Agilent E1418A SCPI Command Reference Chapter 3

Agilent E1418A User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual