Agilent Technologies N3280A manual Types of Scpi Messages, Message Unit, Channel List Parameter

Page 34

4 - Introduction to Programming

Types of SCPI Messages

There are two types of SCPI messages, program and response.

♦A program message consists of one or more properly formatted SCPI commands sent from the controller to the dc source. The message, which may be sent at any time, requests the dc source to perform some action.

♦A response message consists of data in a specific SCPI format sent from the dc source to the controller. The dc source sends the message only when commanded by a program message "query."

Figure 4-2 illustrates the SCPI message structure.

Channel

Data

Keywords

Message Unit

Query Indicator

Space

VOLT : LEV 10 (@1) ; PROT ON, (@1) ; : CURR? (@1) <NL>

Keyword Separator

Message Unit Separators

Message Terminator

Root Specifier

Figure 4-2. Command Message Structure

The Message Unit

The simplest SCPI command is a single message unit consisting of a command header (or keyword) followed by a message terminator. The message unit may include a parameter after the header. The parameter can be numeric or a string.

ABORt<NL>

VOLTage 20<NL>

Channel List Parameter

The channel parameter is required to address one or more channels. It has the following syntax: (@<channel> [,<channel>][,<channel>][,<channel>])

You can also specify a range of sequential channels using the following syntax: <start_channel> : <end_channel>

For example, (@2) specifies channel 2 and (@1:3) specifies channels 1 through 3. The Agilent N3280A only supports channels 1 through 4. A maximum of 4 channels may be specified through a combination of single channels and ranges. Query and measurement channel lists are order-sensitive. Results are returned in the order they are specified in the list.

NOTE: When adding a channel list parameter to a query, you must include a space (white space) between the query indicator (?) and the channel list parameter. Otherwise error –103, Invalid separator will occur

34

Image 34

Contents USER’S Guide Agilent Technologies Model N3280A Component Test DC SourceWarranty Information CertificationSafety Summary GeneralSafety Symbols Declaration Acoustic Noise Information Printing HistoryTable of Contents External References Types of Scpi CommandsScpi Command Completion Using Device Clear Gpib Capabilities of the DC Source Introduction to ScpiOutput Commands Scpi Programming Commands At a Glance Calibration CommandsMeasurement Commands Status CommandsCommon Commands System CommandsTrigger Commands Voltage Priority TestsRipple and Noise Tests Error Number List 103Transient Response Tests Page Safety Considerations Document OrientationRemote Programming Options and AccessoriesDescription Option DescriptionOutput Characteristics Voltage Priority OperationOutput Characteristic Current Priority Current Priority OperationMeasurement Characteristics Start of a Measurement Damage Packaging Material CleaningInspection Additional ItemsRack Mounting LocationBench Operation Do not block the fan exhaust at the rear of the unitPower Connections Connect the Power CordOutput Connections Turn the unit off before connecting any wiresOutputs 1 Ampacity and Resistance of Stranded Copper Conductors Current RatingsVoltage Drops and Lead Resistance AWG No Maximum Ampacity Resistance at 20 deg. C Free airCoaxial Guard Connections Guard Connections for Test FixturesMaintaining Stability External Trigger ConnectionsComputer Connections OVP ConsiderationsSwitch Setting Address Settings for Power Module Configuration SwitchSwitch Setting Gpib AddressFront Panel Description Procedure Checkout ProcedureExplanation Power-On Selftest Errors Selftest Error MessagesRuntime Error Messages Case of TroublePage Gpib References External ReferencesGpib Capabilities of the DC Source Scpi ReferencesIntroduction to Scpi Types of Scpi CommandsConventions Used in This Guide Using Queries Multiple Commands in a MessageIncluding Common Commands Moving Among SubsystemsMessage Unit Types of Scpi MessagesChannel List Parameter Scpi Data Formats Response Data Types Scpi Command CompletionSuffixes and Multipliers Class Suffix Unit Unit with MultiplierUsing Device Clear Outputstate ExamplePage Programming the Output Power-on InitializationIntroduction Enabling the OutputOvervoltage Protection Output ModeOutput Current Oscillation Protection Triggering Output ChangesOutput Trigger Model Enabling the Output Trigger System Setting the Voltage and Current Trigger LevelsSelecting the Output Trigger Source Generating Output Triggers Making MeasurementsAverage Measurements Power Line Cycles Measurement Samples and Time IntervalWindow Functions Triggered MeasurementsCurrent Ranges Returning All Measurement Data From the Data BufferEnabling the Measurement Trigger System Measurement Trigger ModelSelecting the Measurement Trigger Source Selecting the Sensing Function Output Settling DelayGenerating Measurement Triggers Pre-trigger and Post-trigger Data Acquisition Pre-trigger and Post-trigger AcquisitionProgramming the Status Registers DC Source Status ModelBit Configurations of Status Registers Operation Status GroupStatus Byte Register Questionable Status GroupStandard Event Status Group MSS and RQS BitsDetermining the Cause of a Service Interrupt Servicing Operation Status and Questionable Status EventsCommon Commands Subsystem CommandsProgramming Parameters Subsystem Commands Syntax Scpi Programming Commands At a GlanceSave new cal constants in non-volatile memory Sets the output voltage in voltage priority mode Mode mode, @list DELayFUNCtion Mode mode, @list VOLTage Sets the triggered output voltage in voltage priority modeSRE n Common Commands SyntaxESE n Output Programming ParametersCALibrateCURRentLIMitPOSitive CALibrateCURRentLIMitNEGative Calibration CommandsCALibrateCURRent CALibrateCURRentMEASureCALibrateDATE CALibratePASSwordCALibrateDATA CALibrateLEVelCALibrateSTATe CALibrateSAVECALibrateVOLTage FETChCURRent? FETChVOLTage? Measurement CommandsFETChARRayCURRent? FETChARRayVOLTage? Query SyntaxSENSeCURRentRANGe MEASureARRayCURRent? MEASureARRayVOLTage?MEASureCURRent? MEASureVOLTage? Enter values greater than 0.015ASENSeSWEepOFFSetPOINts SENSeFUNCtionSENSeSWEepNPLCycles Query Syntax SENSeFUNCtion? @channel listSENSeSWEepTINTerval SENSeSWEepPOINtsSENSeWINDow OUTPutOSCProtect Output CommandsOUTPut OUTPutPROTectionCLEarSOURceCURRentLIMitIMMediate SOURceCURRentLIMitTRIGgered Default SuffixSOURceCURRentIMMediate SOURceCURRentTRIGgered SOURceCURRentLIMitBWIDthSOURceDELayMODE SOURceDELaySOURceCURRentMODE SOURceCURRentLIMitMODE SOURceVOLTageIMMediate SOURceVOLTageTRIGgered SOURceFUNCtionMODESOURceVOLTageALCBWIDth Query Syntax SOURceFUNCMODE? @channel listQuery Syntax SOURceVOLTagePROTectionSTATe? @channel list SOURceVOLTageMODESOURceVOLTagePROTectionSTATe NR10 orBit Configuration of Operation Status Registers Status CommandsSTATusOPERationENABle STATusOPERationEVENt?Command Syntax STATusPRESet Parameters None Examples STATusPRESetParameters Preset Value STATusOPERationNTR STATusOPERationPTRSTATusQUEStionableCONDition? STATusQUEStionableENABleQuery Syntax STATusQUEStionableENABle? @channel list STATusQUEStionableNTR STATusQUEStionablePTRSYSTemERRor? System CommandsSYSTemVERSion? INITiateNAME Trigger CommandsABORt TRIGgerACQuireTRIGgerTRANsient TRIGgerACQuireSOURceTRIGgerTRANsientSOURce RST ValueParameters Power-On Value Examples Common CommandsCommand Syntax *CLS Parameters None Bit Configuration of Standard Event Status Enable RegisterExample Field InformationQuery Syntax *OPT? Returned Parameters Aard Power-on Value RST SettingsBit Configuration of Status Byte Register Query Syntax TST? Returned Parameters NR1Table A-1. Specifications Table A-2 Supplemental Characteristics Dimensions Output Common ModeSafety WeightFigure A-1. Output Impedance Graphs all outputs Equipment Required Performance & Verification Tests Measurement TechniquesElectronic Load Test SetupProgramming Voltage Programming and Readback Accuracy Program CommandsVoltage Priority Tests Positive Current Limit +CLAction Program Commands Negative Current Limit -CLCurrent Priority Tests Current Programming and Readback AccuracyLoad Effect Tests Voltage Priority, Constant Voltage Load EffectVoltage Priority, +Current Limit Load Effect Voltage Priority, -Current Limit Load Effect TestCurrent Priority Constant Current Test Source Effect TestsVoltage Priority, Constant Voltage Source Effect Voltage Priority, +Current Limit Source Effect Voltage Priority, -Current Limit Source EffectCurrent Priority, Constant Current Source Effect Ripple and Noise Tests Voltage Priority Ripple and NoiseTransient Response Tests Voltage Priority, Transient Recovery TimeCurrent Priority Ripple and Noise Current Priority Transient Recovery Time Figure B-2. Transient Waveform Voltage PriorityPerformance Test Equipment Form Figure B-3. Transient Waveform Current PriorityPerformance Test Record Form Performing the Calibration Procedure Enable Calibration Mode5A Range Current Measurement Calibration Negative Current Limit CalibrationPositive Current Limit Calibration 100Saving the Calibration Constants 15mA Range Current Measurement Calibration101 Table B-3. Gpib Calibration Error Messages Changing the Calibration PasswordCalibration Error Messages Error MeaningTable C-1. Error Numbers Error Number List103 Error Messages 104Error Messages C 105Page Line Voltage Selection 107Page Rear Panel Pinout Assignments Earlier Version Output ConnectorsMating Connector Part Numbers CHG-2010-J01010-KEPPage Index 111Index 112113 Scpi114 Europe Asia Pacific United States Latin AmericaCanada Australia/New Zealand JapanManual Updates