Agilent Technologies N3280A manual Scpi Data Formats

Page 35

Introduction to Programming - 4

Headers

Headers, also referred to as keywords, are instructions recognized by the dc source. Headers may be either in the long form or the short form. In the long form, the header is completely spelled out, such as VOLTAGE, STATUS, and DELAY. In the short form, the header has only the first three or four letters, such as VOLT, STAT, and DEL.

Query Indicator

Following a header with a question mark turns it into a query (VOLTage?, VOLTage:TRIGgered?). If a query contains a parameter, place the query indicator at the end of the last header.

VOLTage:TRIGgered? MAX,(@1)

Message Unit Separator

When two or more message units are combined into a compound message, separate the units with a semicolon.

STATus:OPERation?(@1);QUEStionable?(@1)

Root Specifier

When it precedes the first header of a message unit, the colon becomes the root specifier. It tells the command parser that this is the root or the top node of the command tree.

Message Terminator

A terminator informs SCPI that it has reached the end of a message. Three permitted messages terminators are:

newline (<NL>), which is ASCII decimal 10 or hex 0A.

end or identify (<END>)

both of the above (<NL><END>).

In the examples of this guide, there is an assumed message terminator at the end of each message.

SCPI Data Formats

All data programmed to or returned from the dc source is ASCII. The data may be numerical or character string.

Numerical Data Formats

Symbol

Response Formats

 

<NR1>

Digits with an implied decimal point assumed at the right of the least-significant digit. Examples: 273

<NR2>

Digits with an explicit decimal point. Example: .0273

 

<NR3>

Digits with an explicit decimal point and an exponent. Example: 2.73E+2

 

 

Parameter Formats

 

<Nrf>

Extended format that includes <NR1>, <NR2> and <NR3>. Examples: 273 273.

2.73E2

<Nrf+>

Expanded decimal format that includes <NRf> and MIN MAX. Examples: 273

273. 2.73E2

 

MAX. MIN and MAX are the minimum and maximum limit values that are implicit in the range

 

specification for the parameter.

 

<Bool>

Boolean Data. Example: 0 1 or ON OFF

 

35

Image 35
Contents Agilent Technologies Model N3280A Component Test DC Source USER’S GuideCertification Warranty InformationGeneral Safety SummarySafety Symbols Declaration Printing History Acoustic Noise InformationTable of Contents Gpib Capabilities of the DC Source Introduction to Scpi Types of Scpi CommandsScpi Command Completion Using Device Clear External ReferencesStatus Commands Scpi Programming Commands At a Glance Calibration CommandsMeasurement Commands Output CommandsVoltage Priority Tests System CommandsTrigger Commands Common CommandsTransient Response Tests Error Number List 103Ripple and Noise Tests Page Document Orientation Safety ConsiderationsOption Description Options and AccessoriesDescription Remote ProgrammingVoltage Priority Operation Output CharacteristicsCurrent Priority Operation Output Characteristic Current PriorityMeasurement Characteristics Start of a Measurement Additional Items CleaningInspection Damage Packaging MaterialDo not block the fan exhaust at the rear of the unit LocationBench Operation Rack MountingConnect the Power Cord Power ConnectionsOutputs 1 Turn the unit off before connecting any wiresOutput Connections AWG No Maximum Ampacity Resistance at 20 deg. C Free air Current RatingsVoltage Drops and Lead Resistance Ampacity and Resistance of Stranded Copper ConductorsGuard Connections for Test Fixtures Coaxial Guard ConnectionsOVP Considerations External Trigger ConnectionsComputer Connections Maintaining StabilityGpib Address Settings for Power Module Configuration SwitchSwitch Setting Switch Setting AddressFront Panel Description Explanation Checkout ProcedureProcedure Case of Trouble Selftest Error MessagesRuntime Error Messages Power-On Selftest ErrorsPage Scpi References External ReferencesGpib Capabilities of the DC Source Gpib ReferencesConventions Used in This Guide Types of Scpi CommandsIntroduction to Scpi Moving Among Subsystems Multiple Commands in a MessageIncluding Common Commands Using QueriesChannel List Parameter Types of Scpi MessagesMessage Unit Scpi Data Formats Class Suffix Unit Unit with Multiplier Scpi Command CompletionSuffixes and Multipliers Response Data TypesOutputstate Example Using Device ClearPage Enabling the Output Power-on InitializationIntroduction Programming the OutputOutput Current Output ModeOvervoltage Protection Output Trigger Model Triggering Output ChangesOscillation Protection Selecting the Output Trigger Source Setting the Voltage and Current Trigger LevelsEnabling the Output Trigger System Average Measurements Making MeasurementsGenerating Output Triggers Measurement Samples and Time Interval Power Line CyclesReturning All Measurement Data From the Data Buffer Triggered MeasurementsCurrent Ranges Window FunctionsSelecting the Measurement Trigger Source Measurement Trigger ModelEnabling the Measurement Trigger System Generating Measurement Triggers Output Settling DelaySelecting the Sensing Function Pre-trigger and Post-trigger Acquisition Pre-trigger and Post-trigger Data AcquisitionDC Source Status Model Programming the Status RegistersOperation Status Group Bit Configurations of Status RegistersMSS and RQS Bits Questionable Status GroupStandard Event Status Group Status Byte RegisterServicing Operation Status and Questionable Status Events Determining the Cause of a Service InterruptProgramming Parameters Subsystem CommandsCommon Commands Save new cal constants in non-volatile memory Scpi Programming Commands At a GlanceSubsystem Commands Syntax Sets the triggered output voltage in voltage priority mode Mode mode, @list DELayFUNCtion Mode mode, @list VOLTage Sets the output voltage in voltage priority modeOutput Programming Parameters Common Commands SyntaxESE n SRE nCALibrateCURRentMEASure Calibration CommandsCALibrateCURRent CALibrateCURRentLIMitPOSitive CALibrateCURRentLIMitNEGativeCALibrateLEVel CALibratePASSwordCALibrateDATA CALibrateDATECALibrateVOLTage CALibrateSAVECALibrateSTATe Query Syntax Measurement CommandsFETChARRayCURRent? FETChARRayVOLTage? FETChCURRent? FETChVOLTage?Enter values greater than 0.015A MEASureARRayCURRent? MEASureARRayVOLTage?MEASureCURRent? MEASureVOLTage? SENSeCURRentRANGeQuery Syntax SENSeFUNCtion? @channel list SENSeFUNCtionSENSeSWEepNPLCycles SENSeSWEepOFFSetPOINtsSENSeWINDow SENSeSWEepPOINtsSENSeSWEepTINTerval OUTPutPROTectionCLEar Output CommandsOUTPut OUTPutOSCProtectSOURceCURRentLIMitBWIDth Default SuffixSOURceCURRentIMMediate SOURceCURRentTRIGgered SOURceCURRentLIMitIMMediate SOURceCURRentLIMitTRIGgeredSOURceCURRentMODE SOURceCURRentLIMitMODE SOURceDELaySOURceDELayMODE Query Syntax SOURceFUNCMODE? @channel list SOURceFUNCtionMODESOURceVOLTageALCBWIDth SOURceVOLTageIMMediate SOURceVOLTageTRIGgeredNR10 or SOURceVOLTageMODESOURceVOLTagePROTectionSTATe Query Syntax SOURceVOLTagePROTectionSTATe? @channel listSTATusOPERationEVENt? Status CommandsSTATusOPERationENABle Bit Configuration of Operation Status RegistersSTATusOPERationNTR STATusOPERationPTR STATusPRESetParameters Preset Value Command Syntax STATusPRESet Parameters None ExamplesSTATusQUEStionableNTR STATusQUEStionablePTR STATusQUEStionableENABleQuery Syntax STATusQUEStionableENABle? @channel list STATusQUEStionableCONDition?SYSTemVERSion? System CommandsSYSTemERRor? TRIGgerACQuire Trigger CommandsABORt INITiateNAMERST Value TRIGgerACQuireSOURceTRIGgerTRANsientSOURce TRIGgerTRANsientBit Configuration of Standard Event Status Enable Register Common CommandsCommand Syntax *CLS Parameters None Parameters Power-On Value ExamplesQuery Syntax *OPT? Returned Parameters Aard Field InformationExample RST Settings Power-on ValueQuery Syntax TST? Returned Parameters NR1 Bit Configuration of Status Byte RegisterTable A-1. Specifications Table A-2 Supplemental Characteristics Weight Output Common ModeSafety DimensionsFigure A-1. Output Impedance Graphs all outputs Equipment Required Measurement Techniques Performance & Verification TestsProgramming Test SetupElectronic Load Positive Current Limit +CL Program CommandsVoltage Priority Tests Voltage Programming and Readback AccuracyNegative Current Limit -CL Action Program CommandsCurrent Programming and Readback Accuracy Current Priority TestsVoltage Priority, Constant Voltage Load Effect Load Effect TestsVoltage Priority, -Current Limit Load Effect Test Voltage Priority, +Current Limit Load EffectVoltage Priority, Constant Voltage Source Effect Source Effect TestsCurrent Priority Constant Current Test Voltage Priority, -Current Limit Source Effect Voltage Priority, +Current Limit Source EffectCurrent Priority, Constant Current Source Effect Voltage Priority Ripple and Noise Ripple and Noise TestsCurrent Priority Ripple and Noise Voltage Priority, Transient Recovery TimeTransient Response Tests Figure B-2. Transient Waveform Voltage Priority Current Priority Transient Recovery TimeFigure B-3. Transient Waveform Current Priority Performance Test Equipment FormPerformance Test Record Form Enable Calibration Mode Performing the Calibration Procedure100 Negative Current Limit CalibrationPositive Current Limit Calibration 5A Range Current Measurement Calibration101 15mA Range Current Measurement CalibrationSaving the Calibration Constants Error Meaning Changing the Calibration PasswordCalibration Error Messages Table B-3. Gpib Calibration Error Messages103 Error Number ListTable C-1. Error Numbers 104 Error Messages105 Error Messages CPage 107 Line Voltage SelectionPage CHG-2010-J01010-KEP Earlier Version Output ConnectorsMating Connector Part Numbers Rear Panel Pinout AssignmentsPage 111 Index112 IndexScpi 113114 Japan United States Latin AmericaCanada Australia/New Zealand Europe Asia PacificManual Updates