NAME

 E1333A − SCPI Commands Quick Reference
 

DESCRIPTION

 
The following is a SCPI command quick reference for the HP E1333A Universal Counter.  This quick reference provides:
 
 
Command Descriptions
 
Commands Not Supported
 
Commands Changed
 
Query Command Response Types
 
Overlapping Commands
 
ONSRQ Restrictions
 
The SCPI commands are to be embedded in HP Compiled SCPI commands.  For information on HP Compiled SCPI, see the HP Compiled SCPI commands in manual pages, or see the HP Compiled SCPI learning products.
 
For additional information on SCPI commands, see the VXI User’s Guide for the instrument.
 

COMMAND DESCRIPTIONS

 

Common Commands

 

*IDN?  Returns the identification string of the instrument. 
 

*RST Resets the instrument to a known state. 
 

*TST?  Self-Test, returns 0 if passes. 
 

*OPC Sets the request for OPC flag when all pending operations have completed. 
 

*OPC?  Query operation complete. Returns 1 when all pending operations have completed. 
 

*WAI Wait for complete. 
 

*CLS Clears all status registers. 
 

*ESE Enable status register bits. 
 

*ESE?  Query event status enable. 
 

*ESR?  Query and clear the event status register. 
 

*SRE Sets the service request enable register bits and corresponding serial poll status register bits to generate a service request. 
 

*SRE?  Query service request enable. 
 

*STB?  Query read status byte. 
 

*TRG Bus Trigger. 
 

*RCL Recall instrument state. 
 

*SAV Store instrument state. 
 

SCPI Commands

 

ABORt Place counter in idle state. 
 

CONFigure[<channel>]:FREQuency [<range>[,<resolution>]]
Configure counter for frequency. <channel> can be 1 to 3.  <range> can be 29.1E-3 to 100E6Hz for channels 1 and 2, 75E6 to 1E9Hz for channel 3, MIN, MAX, or AUTO.  <resolution> can be 4.2E-15 to 500 Hz, MIN, or MAX
 

CONFigure[<channel>]:PERiod [<range>[,<resolution>]]
Configure counter for period. <channel> can be 1 or 2. <range> can be 10E-9 to 3435.5, MIN, MAX, or AUTO.  <resolution> can be 1.5E-18 to .002 sec, MIN, MAX, or DEF.
 

CONFigure[<channel>]:RATio [<range>[,<resolution>]]
Configure counter for ratio. <channel> can be 1 or 2.  <range> can be 9.3E-10 to 1E9. <resolution> can be 1.35E-20 to .0156.
 

CONFigure[<channel>]:NWIDth
Configure counter for negative pulse width. <channel> can be 1 or 2.
 

CONFigure[<channel>]:PWIDth
Configure counter for positive pulse width. <channel> can be 1 or 2.
 

CONFigure[<channel>]:TINTerval
Configure counter for time interval. <channel> can be 1 or 2.
 

CONFigure[<channel>]:TOTalize
Configure counter for totalize. <channel> can be 1 or 2.
 

CONFigure[<channel>]? 
Query counter configuration. <channel> can be 1, 2, or 3. Returns a string.
 

FETCh[<channel>]? 
Place measurement in output buffer. <channel> can be 1, 2, or 3.
 

INITiate[<channel>]
Place counter in wait-for-trigger state. <channel> can be 1, 2, or 3.
 

INPut[<channel>]:ATTenuation 0 | 20 | MIN | MAX | DEF
Set <channel> 1 or 2 input attenuation.
 

INPut[<channel>]:ATTenuation? [MIN | MAX]
Query attenuation setting of <channel> 1 or 2.
 

INPut[<channel>]:COUPling AC | DC
Set <channel> 1 or 2 input couping.
 

INPut[<channel>]:COUPling? 
Query input coupling of <channel> 1 or 2.
 

INPut[<channel>]:FILTer[:LPASs][:STATe] OFF | 0 | ON | 1
Enable/disable filter. <channel> can be 1 or 2.
 

INPut[<channel>]:FILTer[:LPASs][:STATe]? 
Query if filter is enabled. <channel> can be 1 or 2. Returns OFF (0) or ON (1).
 

INPut[<channel>]:IMPedance 50 | 1E6 | MIN | MAX | DEF
Set <channel> 1 or 2 input impedance to MIN (50), MAX (1M), DEF (1M), or enter a value between 40 and 60, and .9E6 to 1.1E6.
 

INPut[<channel>]:IMPedance? [MIN | MAX]
Query impedance setting of <channel> 1 or 2.
 

MEASure[<channel>]:FREQuency? [<range>[,<resolution>]]
Make frequency measurements. <channel> can be 1, 2, or 3. <range> can be 29.1E-3 to 100E6 Hz for channels 1 or 2, 75E6 to 1E9 Hz for channel 3, MIN, MAX, or AUTO. <resolution> can be 4.2E15 to 500 Hz, MIN, or MAX.
 

MEASure[<channel>]:PERiod? [<range>[,<resolution>]]
Make period measurements. <channel> can be 1 or 2. <range> can be 10E-9 to 3435.5, MIN, MAX, or AUTO. <resolution> can be 1.5E-18 to .002 sec, MIN, MAX, or DEF.
 

MEASure[<channel>]:RATio? [<range>[,<resolution>]]
Make ratio measurements. <channel> can be 1 or 2. <range> can be 9.3E-10 to 1E9. <resolution> can be 1.35E-20 to .0156.
 

MEASure[<channel>]:NWIDth? 
Make negative pulse width measurements. <channel> can be 1 or 2.
 

MEASure[<channel>]:PWIDth? 
Make positive pulse width measurements. <channel> can be 1 or 2.
 

MEASure[<channel>]:TINTerval? 
Make time interval measurements. <channel> can be 1 or 2.
 

READ[<channel>]? 
Place counter in wait-for-trigger state; place readings in output buffer. <channel> can be 1, 2, or 3.
 

[SENSe[<channel>]:]FUNCtion[:<function>]
Select measurement function. <channel> can be 1, 2, or 3.  <function> can be FREQ, PER, RAT, TINT, PWID, NWID, or TOT.
 

[SENSe[<channel>]:]FUNCtion? 
Query measurement function. <channel> can be 1, 2, or 3. Returns FREQ, PER, TAT, TINT, PWID, NWID, or TOT.
 

[SENSe[<channel>]:]FREQuency:APERture <time | MIN | MAX | DEF>
Set gate time in seconds. <channel> can be 1 or 2. <time> can be 2mS to 65.536S.
 

[SENSe[<channel>]:]FREQuency:APERture? [MIN | MAX | DEF]
Query aperture time. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]PERiod:NPERiods <number | MIN | MAX | DEF>
Set number of periods. <channel> can be 1 or 2.  <number> can be 2 to 65536.
 

[SENSe[<channel>]:]PERiod:NPERiods? [MIN | MAX | DEF]
Query number of periods. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]RATio:NPERiods <number | MIN | MAX | DEF>
Set number of periods. <channel> can be 1 or 2.  <number> can be 64 to 6.8719E+10.
 

[SENSe[<channel>]:]RATio:NPERiods? [MIN | MAX | DEF]
Query number of periods. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]TINTerval:NPERiods <number | MIN | MAX | DEF>
Set number of periods. <channel> can be 1 or 2.  <number> can be 1 to 128 periods.
 

[SENSe[<channel>]:]TINTerval:NPERiods? [MIN | MAX | DEF]
Query number of periods. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]EVENt:LEVel <number | MIN | MAX | DEF>
Select event level. <channel> can be 1 or 2.  <number> can be -2.56V to +2.54V, MIN, MAX, or DEF.
 

[SENSe[<channel>]:]EVENt:LEVel? [MIN | MAX | DEF]
Query event level. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]EVENt:SLOPe <POSitive | NEGative>
Set event slope. <channel> can be 1 or 2.
 

[SENSe[<channel>]:]EVENt:SLOPe? 
Set event slope. <channel> can be 1 or 2. POS or NEG is returned.
 

STATus:QUEStionable:CONDition? 
Query the Questionable Condition register. Returns a decimal weighted value from 0 to 3584 indicating which bits are set true.
 

STATus:QUEStionable:ENABle <number>
Set conditions in the Questionable Status. <number> can be 1 to 32768.
 

STATus:QUEStionable:ENABle? 
Query the Questionable Enable register. Returns a decimal weighted value from 0 to 65535 indicating which bits are set true.
 

STATus:QUEStionable[:EVENt]? 
Query the Questionable Event register. Returns a decimal weighted value from 0 to 3584 indicating which bits are set true.
 

SYSTem:ERRor? 
Return error number/message from error queue.
 

TRIGger[:IMMediate]
Trigger immediately.
 

TRIGger:SOURce <BUS | HOLD | IMM>
Specify trigger source. BUS uses *TRG, HOLD suspends triggering, and IMM triggers continuous.
 

TRIGger:SOURce? 
Query trigger source. BUS, HOLD, or IMM is returned.
 
 

COMMANDS NOT SUPPORTED

 
C-SCPI does not support the commands listed.  However, these commands are still supported in the Command Module version.
 
Macro commands not supported: MEM:DEL:MACR, *DMC, *RMC, *GMC, *PMC, *LMC, and *EMC
  Monitor commands not supported:  DISP:MON:STAT and DISP:MON:CHAN
 

COMMANDS CHANGED

 
The commands listed are different than in the Command Module version.
 
ABORT can abort a measurement in progress in the background (when cscpi_overlap ON).  This wasn’t possible in the Command Module version because it was not possible to parse the next command until the measurement was complete.
 

QUERY COMMAND RESPONSE TYPES

 
All but the following queries will return an integer.
 

*IDN?  quoted string
 

SENS:FUNC?  quoted string
 

SENS:FREQ:APER?  double
 
 

SENS:PER:NPER?  double
 

SENS:RAT:NPER?  double
 

SENS:TINT:NPER?  double
 

SENS:EVEN:LEV?  double
 

SENS:EVEN:SLOP?  string
 

SYST:ERR?  integer, quoted string
 

SYST:VERS?  quoted string
 

INP:ATT?  double
 

INP:COUP?  string
 

INP:IMP?  double
 

TRIG:SOUR?  string
 

CONF?  quoted string
 

FETC?  double
 

READ?  double
 

MEAS:FREQ?  double
 

MEAS:PER?  double
 

MEAS:RAT?  double
 

MEAS:TINT?  double
 

MEAS:PWID?  double
 

MEAS:NWID?  double
 

OVERLAPPING COMMANDS

 
The following commands continue execution (some by interrupt service routines) after the command function returns to the user program (when cscpi_overlap ON):
 
*RST
 
*TRG
 
INIT
 
INP:ATT
 
INP:COUP
 
INP:FILT
 
INP:IMP
 
SENS:EVEN:LEV
 
TRIG
 
Commands may be sent to other instruments while the counter driver is finishing one of these commands.
 
The *OPC?, *WAI or *OPC commands may be used to read when the overlapping command has totally finished.
 
Commands which can run overlapped with overlapping commands:
 
If an overlapping command has been started and another command is sent to the same instrument, the second command will usually block, waiting for the previous command to finish, before executing. The following commands are the exceptions, they will run overlapped with an overlapping command:
 
*CLS
 
*OPC (If previous command was an input conditioning command, will block)
 
ABORT (abort measurement in progress)
 
If an overlapping command has been started and a query is sent to the same instrument, the query will usually run overlapped with the previous command.
 
The following are the exceptions, they will block, waiting for the previous command to finish prior to executing:
 
CONF?
 
FETC?
 
READ?
 
MEAS:FREQ?
 
MEAS:PER?
 
MEAS:RAT?
 
MEAS:TINT?
 
MEAS:PWID?
 
MEAS:NWID?
 
*TST?
 
*OPC? (by definition)
 
 

ONSRQ RESTRICTIONS

 
In general, an SRQ function should not send any commands to a counter while sending commands to that instrument from the main (foreground) program.
 
The following may NOT be used in an SRQ function which executes as an interrupt routine (because the execution routines wait for an interrupt):
 
cscpi_overlap OFF:
 
*RST
 
*TST?
 
*TRG
 
INIT
 
TRIG
 
MEAS:xxxx?
 
READ?
 
cscpi_overlap ON:
 
*RST
 
*TST?
 
MEAS:xxxx?
 
READ?
 
If enabled, the following may cause an SRQ function to be executed from an interrupt routine:
 
cscpi_overlap ON:
 
any overlapping command followed by *OPC measurement with questionable data/overflow
 

  —  December 08, 1992