Agilent Technologies E1563A 2-Channel Digitizer E1564A 4-Channel Digitizer User’s Manual Manual Part Number: E1563-90004 Printed in U.S.A.
Contents E1563A/E1564A Digitizers User’s Manual Front Matter....................................................................................................................... 9 Agilent Technologies Warranty Statement ................................................................... 9 U.S. Government Restricted Rights ............................................................................. 9 Documentation History....................................................................................
Chapter 3 - Digitizers Command Reference ................................................................ 45 Using This Chapter .................................................................................................... 45 Command Types ........................................................................................................ 45 SCPI Command Reference........................................................................................ 47 ABORt ......................................
INPut .......................................................................................................................... 75 INPut:FILTer[:LPASs]:FREQ ............................................................................... 75 INPut:FILTer[:LPASs]:FREQ? ............................................................................. 75 INPut:FILTer[:LPASs][:STATe] ............................................................................. 76 INPut:FILTer[:LPASs][:STATe]? .......................
SYSTem ..................................................................................................................... 97 SYSTem:ERRor? ................................................................................................ 97 SYSTem:VERSion? ............................................................................................ 97 TEST .......................................................................................................................... 98 TEST:ERRor? ...............
CVTable Channel 4 Register ............................................................................ 131 Samples Taken High Byte Register .................................................................. 131 Samples Taken Low Word Register ................................................................. 131 Calibration Flash ROM Address Register ......................................................... 131 Calibration Flash ROM Data Register .............................................................
Appendix E - Digitizers Adjustments ......................................................................... 163 Introduction .............................................................................................................. 163 Closed-Cover Electronic Calibration ................................................................. 163 Calibration Intervals .......................................................................................... 163 Adjustment Procedures..........................
AGILENT TECHNOLOGIES WARRANTY STATEMENT AGILENT PRODUCT: E1563A 2-Channel Digitizer and E1564A 4-Channel Digitizer DURATION OF WARRANTY: 3 years 1. Agilent Technologies warrants Agilent hardware, accessories and supplies against defects in materials and workmanship for the period specified above. If Agilent receives notice of such defects during the warranty period, Agilent will, at its option, either repair or replace products which prove to be defective.
Documentation History All Editions and Updates of this manual and their creation date are listed below. The first Edition of the manual is Edition 1. The Edition number increments by 1 whenever the manual is revised. Updates, which are issued between Editions, contain replacement pages to correct or add additional information to the current Edition of the manual. Whenever a new Edition is created, it will contain all of the Update information for the previous Edition.
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. S.W. Loveland, CO 80537 USA Declares, that the product Product Name: Model Number: Product Options: 2-Channel and 4-Channel Digitizers E1563A/E1564A This declaration covers all options of the above product(s).
Notes: 12
Chapter 1 Configuring the Digitizer Modules Using This Chapter This chapter provides guidelines to configure the E1563A and E1564A modules and to verify successful installation. Chapter contents are: • Digitizers Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 • Warnings and Cautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 • Configuring the Digitizers . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 • User Cabling Connections . . . . . . . . .
All channels sample simultaneously. The sample can be from an internal clock derived from the internal time base or it can come from an external source. Triggering can be set up for several sources with programmable pre and post trigger reading counts. External time base, trigger and sample inputs are provided on the front panel “D” subminiature connector.
Front Panel Indicators Failed LED: Illuminates momentarily during digitizer power-on. Access LED: Illuminates when the backplane is communicating with the digitizer. Error LED: Illuminates only when an error is present in the digitizer’s driver error queue. The error can result from improperly executing a command or the digitizer being unable to pass self-test or calibration. Sample LED: Illuminates while the digitizer samples the input for a measurement.
Front Panel Indicators Failed LED: Illuminates momentarily during digitizer power-on. Access LED: Illuminates when the backplane is communicating with the digitizer. Error LED: Illuminates only when an error is present in the digitizer’s driver error queue. The error can result from improperly executing a command or the digitizer being unable to pass self-test or calibration. Sample LED: Illuminates while the digitizer samples the input for a measurement.
Warnings and Cautions WARNING DANGEROUS VOLTAGES. The E1563A and E1564A Digitizers are capable of measuring voltages up to 256V maximum. Voltage levels above the levels specified for accessible connectors or cable ends could cause bodily injury or death to an operator. Special precautions must be adhered to (discussed below) when applying voltages in excess of 60 Vdc, 30 Vac rms or 42.4 Vac peak for a continuous, complex waveform. WARNING MODULE CONNECTORS MUST NOT BE OPERATOR-ACCESSABLE.
CAUTION OVERVOLTAGE PROTECTION. To prevent equipment damage, do not connect this equipment to mains or to any signal directly derived from mains. Short-term temporary overvoltages must be limited to 500V or less. To prevent equipment damage in case of an overvoltage condition, do not connect this equipment to any voltage source which can deliver greater than 2A at 500V in the case of a fault. If such a fault condition is possible, insert a 2A fuse in the input line. CAUTION CLEANING THE MODULE.
Configuring the Digitizers This section gives guidelines to configure the digitizers, including: • Adding RAM to the Module • Setting the Logical Address Switch • Setting the Interrupt Line • Installing the Digitizer in a Mainframe Adding RAM to the Module You can increase the size of RAM on your Digitizer module by purchasing PC SIMM memory and installing it on the module after you remove the standard 4 Mbyte SIMM shipped with your digitizer.
RAM Installation Procedure 1 Disconnect any field wiring from the module and remove power from the mainframe before proceeding. 2 Remove the module from the mainframe and remove the top shield from the module. 3 Remove the 4 Mbyte SIMM from the PC board by first spreading the tabs at the ends of the SIMM connector. Store this SIMM in an anti-static bag and save this part. NOTE It is important that you retain the 4 Mbyte SIMM you remove from the Digitizer.
Setting the Logical Address Switch The E1563A and E1564A Digitizers are shipped from the factory with logical address 40. Valid logical address are from 1 to 254 for static configuration (the address you set on the switch) and address 255 for dynamic configuration. The E1563A and E1564A do not support dynamic configuration of the address. If you install more than one digitizer, each module must have a different logical address.
Installing the Digitizer in a Mainframe 1 The E1563A or E1564A Digitizer can be installed in any slot (except slot 0) in a C-size VXIbus mainframe. See Figure 1-5 for the procedure to install the Digitizer in a mainframe. Set the extraction levers out. 2 Slide the E1563/E1564 into any slot (except slot 0) until the backplane connectors touch. Extraction Levers 3 4 Seat the digitizer into the mainframe by pushing in the extraction levers.
User Cabling Considerations This section gives guidelines to select and configure user-supplied cables for connection to the Input Terminals and to the External Trigger Input/Calibration Bus Output Terminals. Input Terminal Port Connector Cables E1563A Digitizer. The E1563A Digitizer front panel includes two Switchcraft® EN3™ Mini Weathertight Connectors (female) (CH-1 and CH-2). See Figure 1-1. Mating Switchcraft® Cord Connectors (male) are supplied with the module.
Trigger Input Port Cables The user must supply a standard cable to the External Trigger Input port (E1563A) or to the External Trigger Input/Calibration Bus Output port (E1564A). E1563A Digitizer. The E1563A front panel contains a 9-pin D-subminiature connector with the pin-outs and associated SCPI commands shown in Figure 1-6 (do not make any connections to the top two pins). TRIGger:SOURce EXT ROSCillator:SOURce EXT SAMPle:SOURce EXT Figure 1-6. E1563A External Trigger Input Port E1564A Digitizer.
Digitizer Input Model Figure 1-8 shows the input model for the digitizer. Maximum voltage between Low and Guard is 5V. Exceeding this limitation will not damage your digitizer but will generate invalid data for any measurement taken. In general, 3-Wire cabling is recommended, but 2-Wire cabling is supported for some switching applications. Figure 1-8. Digitizer Input Model Three-Wire Connections This section shows two examples of connecting the input using a three-wire connection.
. Figure 1-10. Example: Three-Wire Connections (Voltage Measurements) Two-Wire Connections When Low and Guard are connected together at the digitizer’s input on a low-voltage range (4V and below), the injected current is directed to flow through the source impedance (in a floating source) and the resultant voltage drop will introduce a measurement error. The resultant voltage drop through the source impedance can be a significant error on low-voltage ranges where the voltage of interest is small.
Differential Source + 50 + 50 25 KHz From Switching Supply Add 100 pF capacitor if low-level 25 kHz noise from injected current is present. 100 pF I Injected Figure 1-12. Example: Two-Wire Connections (Differential Source) Cable Connector Assembly This section gives guidelines to connect user-supplied cables to the cable connector supplied with the E1563A and E1564A Digitizers. See "Terminal Port Connector Cables" for recommended user-supplied cables.
Step 3 Solder conductors to pins. CAUTION AVOID EXCESSIVE HEAT. Excessive heat on the connector terminals can cause damage to the connector. Step 4 Assemble the connector. A. Align coupling ring’s tabs with cable connector’s side notches and push the coupling ring onto the cable connector. B. Push the cable clamp housing forward until it locks into the connector body and snap the two clamps into their compartments to secure the cable. C.
Cable Connector Coupling Ring Step 5 Cable Clamp Housing Boot Mate the cable connector to the User Input Terminal Port. 1 Hold the cable connector by the rubber boot and align the notched key slot with the key on the left side of the instrument’s front panel connector. Insert the cable connector just enough to encounter insertion resistance and stay in place.
Initial Operation To program the E1563A or E1564A Digitizer using Standard Commands for Programmable Instruments (SCPI), you must select the interface address and SCPI commands to be used. Information about using SCPI commands is presented in Chapter 3. Programming a digitizer using SCPI requires that you select the controller language (C, C++, BASIC, Visual Basic, etc.), interface address and SCPI commands to be used.
/* Set the timeout value to 10 seconds. */ viSetAttribute (digitizer, VI_ATTR_TMO_VALUE, 10000); /* Reset the module. */ err = viPrintf(digitizer, “*RST\n”); if (err
Notes: 32 Configuring the Digitizer Modules Chapter 1
Chapter 2 Using the Digitizers Using this Chapter This chapter gives guidelines to use the E1563A and E1564A Digitizers, including: • Digitizers Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 • Triggering the Digitizers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 • Digitizers Application Examples . . . . . . . . . . . . . . . . . . . . . . . .
Channel Block Diagram Figure 2-2 is a block diagram of an individual channel and the interconnections between channels. The sample signal goes to all channels. The commands beneath the diagram show the SCPI commands used to program each section of a channel. In this case, all the commands are written for channel 4. See Chapter 3 for a full description of the commands illustrated here.
Pre-Trigger/ Post-Trigger Block Diagram Figure 2-3 illustrates relationship of pre-trigger readings and post-trigger readings with the trigger event. See Chapter 3 for a full description of the commands illustrated here. Figure 2-3. Pre-Trigger/Post-Trigger Block Diagram Power-on/Reset States Table 2-1 describes all power-on and reset states for the digitizer. The reset state after executing *RST is the same as the power-on state. Table 2-1. Power-on and Reset States.
Table 2-1. Power-on and Reset States.
Triggering the Digitizers This section describes digitizer triggering, including: • Trigger Sources • Using Internal Triggering • Using External Triggering • Master/Slave Operation Trigger Sources Triggering digitizer readings across all input channels is accomplished with one or both of the two trigger sources (TRIGger:SOURce1 and TRIGger:SOURce2). The trigger event can be different for each source. For example, SOURce1 can be EXT and SOURce2 can be TTLT0.
Figure 2-4. Trigger Level Compare Circuit Operation Using External Triggering You can provide an external trigger common to all channels. The external trigger connection is on the digitizer’s External Trigger Input D-subminiature connector “Trig” pin. You set this input as the trigger source for all channels using TRIGger:SOURce EXT. Use TRIGger:SLOPe POSitive | NEGative to set which signal edge will trigger.
TRIGger:MODE MASTer configures a module as a master. The eight TTL trigger lines (TTLT0-TTLT7) on the VXI backplane allow four different pairings as shown in Table 2-2 (MASTer0 - SLAVe0, MASTer2 - SLAVe2, MASTer4 - SLAVe4 and MASTer6 - SLAVe6). NOTE You must select an unused set of TTL trigger lines for the master-slave coupling when determining which master mode to set. Do not use a TTLT line already used by SAMPle:SOURce or TRIGger:SOURce.
The trigger source from the master can be set with TRIG:SOURce1,2 IMM | INT1-4 | EXT | TTLT. MODE MASTer Sample Signal MASTer0 TTLT2-7 | INT1-4 | EXT MASTer2 TTLT0,1,4-7 | INT1-4 | EXT MASTer4 TTLT0-3,6-7 | INT1-4 | EXT MASTer6 TTLT0-5 | INT1-4 | EXT TRIG:MODE MASTer0 drives the TTL lines as if OUTPut:TTLT0: SOURceSAMPle and OUTPut:TTLT1:SOURce TRIGger had been set. The master module generates the sample signal from which all modules (master and slaves) initiate a measurement.
The trigger source from the slave can be set with TRIG:SOURce2 IMM | INT1-4 | EXT | TTLT. MODE SLAVe Sample Signal SLAVe0 TTLT0 SLAVe2 TTLT2 SLAVe4 TTLT4 SLAVe6 TTLT6 SLAVe0 sets the TTLT0 line as if it were SAMP:SOUR TTLT0 and sets the TTLT1 line as if it were TRIG:SOUR1 TTLT1. However, SAMP:SOUR? or TRIG:SOUR? will not return these settings. These lines are dedicated for synchronization between the modules in the master-slave mode.
Digitizers Application Examples This section contains example programs that demonstrate some E1563A or E1564A Digitizer applications. The examples list only the SCPI commands required to perform the application. You can use these examples to help you develop programs for your specific application Introduction Programming Requirements Example programs are provided on the VXIplug&play media that have been compiled and tested using Microsoft® Visual C++™ Version 1.51 for the C programs.
Making Digitizer Measurements Example: Sampling Using Immediate Triggering This section provides three examples that show ways to make digitizer measurements and to retrieve data. The three programs are: • Example: Sampling Using Immediate Triggering • Example: Triggering Using Internal Level Trigger • Example: Triggering Using External Triggering This example uses an IMMediate trigger to begin the sampling measurements on two channels and to retrieve the interleaved readings from FIFO memory.
Example: Triggering Using External Triggering This example use an external trigger input at the External Trigger Input (D-connector) “Trig” input to trigger readings. Resetting the module sets the data format to ASCii, sample source to TIMer and trigger source to IMMediate. The sample interval and the trigger source are changed from the reset setting. Resetting the module also sets the trigger level to 0V and the trigger slope to positive.
Chapter 3 Digitizers Command Reference Using This Chapter This chapter describes the Standard Commands for Programmable Instruments (SCPI) and IEEE 488.2 Common (*) commands applicable to the E1563A and E1564A Digitizers. This chapter contains the following sections: • Command Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45 • SCPI Command Reference . . . . . . . . . . . . . . . . . . . . . . . . . . .47 • IEEE 488.2 Common Commands Reference . . . . . . . . . . . . .
CALCulate is the root command, LIMit is a second level command, FAIL?, LOWer and UPPer are third level commands and DATA, DATA?, STATe and STATe? are fourth level commands. Command Separator Abbreviated Commands A colon (:) always separates one command from the next lower level command, such as CALCulate:LIMit:FAIL? Colons separate the root command from the second level command (CALCulate:LIMit) and the second level from the third level (LIMit:FAIL?).
Discrete Selects from a finite number of values. These parameters use mnemonics to represent each valid setting. An example is the TRIGger:SOURce
ABORt This command aborts a measurement in progress or stops a measurement being made continuously. The command is ignored without error if a measurement is not in progress. This command also aborts a calibration in progress and will set the CAL:STATe to OFF. Subsystem Syntax Comments ABORt Determining Readings Taken Before ABORt: Use DATA:COUNt? to determine how many readings were taken before ABORt was received.
CALCulate The CALCulate subsystem enables the limit checking of measured data.
CALCulate:LIMit:LOWer:DATA CALCulate[]:LIMit:LOWer:DATA | MIN | MAX sets the lower limit value you want to test against. CALC:LIMit:FAIL? will return a “1” following the measurement (and prior to the next measurement) if the input signal fell below the specified lower limit value and if LIM:LOW:STATe is ON. A “0” is returned if the limit was not exceeded.
CALCulate:LIMit:LOWer[:STATe] CALCulate[]:LIMit:LOWer[:STATe] OFF | 0 | ON | 1 enables the lower limit checking for the specified channel. Use :LIMit:LOWer: DATA to set the actual limit value to be tested against. This command returns the voltage level measured and the detection mode. A returned value of “0” indicates the specified channel is disabled for lower limit checking. “1” returned indicates the specified channel is enabled and will detect signals below the specified lower limit.
Parameters Comments Name Type Range of Values Default Value value numeric -254 to +252 volts Maximum Allowed Values: The maximum allowed depends on the range setting. An error will occur if you try to set a level that exceeds the range setting. Changing the range after setting the limit value will change the limit value. The percent of full scale is kept constant. Allowable maximum values for the upper limit by range and the associated resolution follow. Range 0.0625 0.250 1.00 4.00 16.
Upper Limit Enable Error: An error will be generated if you have TRIG:SOURce set to INT1-4 and the internal input is the same as the channel you are attempting to enable the upper limit testing. For example, assume TRIG:SOUR INT2 is set. The trigger level from channel 2 is the trigger event that is the internal trigger input. CALC:LIMit:UPPer:STATe ON is attempting to use this signal for limit testing and creates a settings conflict.
CALibration The CALibration subsystem allows you to calibrate the digitizer.
CALibration DAC Errors: There is no calibration DAC output for the 64 volt and 256 volt ranges. See the CALibration:GAIN command for more information about the calibration of these two ranges. An error will occur if the voltage value specified is greater than that allowed for the present range setting. You must set the desired range prior to setting the calibration DAC voltage. Executable when initiated: NO Coupled Command: NO Reset (*RST) Condition: 0.
Comments Steps Before Executing a Gain Calibration: The following steps must be completed prior to executing a gain calibration: 1 Set the digitizer to the desired range and filter on the channel you want to calibrate with VOLTage[]:RANGe and INPut[]:FILTer:FREQ and :FILTer:STATe ON|OFF. 2 Enable calibration with CALibration:STATe ON and specify the calibration source with CALibration:SOURce. 3 Specify a calibration value for the channel you are calibrating.
Maximum Voltages for Each Range: The absolute maximum voltages for each range are shown in the next table. The values are approximately 98% of full scale. Voltage Range Max DC Voltage (absolute value) 0.0625 0.061256409 0.2500 0.245025635 1.0000 0.980102539 4.0000 3.920410156 16.0000 15.68164062 64.0000 not used 256.0000 not used Specifying Parameters: Optional parameters that are left blank are filled from left to right.
Executable when initiated: NO Coupled Command: NO Reset (*RST) Condition: EXTernal CALibration:SOURce? CALibration:SOURce? queries which calibration source is set. This setting is shared by all channels. Returns “INT” for INTernal or “EXT” for EXTernal. CALibration:STATe CALibration:STATe ON | 1 | OFF | 0 enables the calibration of the instrument. Many instrument operations are not allowed when this state is ON and will result in an error “Illegal while calibrating”.
CALibration:STORe CALibration:STORe writes the calibration constants to non-volatile RAM after calibration has been completed. NOTE The FLASH and CAL CONSTANTS switches must be set to the “Write Enable” positions before calibration constants are stored in RAM. Executable when initiated: NO Coupled Command: NO Reset (*RST) Condition: None CALibration:VALue CALibration:VALue specifies the voltage value actually applied to the channel for calibration.
Voltage Range Max DC Voltage (absolute value) 0.0625 0.061256409 0.2500 0.245025635 1.0000 0.980102539 4.0000 3.920410156 16.0000 15.00 64.0000 not used 256.0000 not used Executable when initiated: NO Coupled Command: NO Reset (*RST) Condition: All channels set to 0.0 volts CALibration:VALue? CALibration:VALue? queries the present setting of the calibration voltage.
Using Optional Parameters: Optional parameters that are left blank are filled from left to right. Therefore, it is necessary to use the syntax DEFault to note that a particular parameter is to use the default value. For example, to specify a sample rate other than the default, you must declare DEFault for the parameter or the parameter value you intended will be used to fill in the parameter. The command for channel 1 would appear as: CAL:ZERO1 DEF,.002.
Steps Before Executing a Zero Calibration: The following steps must be completed prior to executing a zero calibration. Errors result if these steps are not performed before CAL:ZERO:ALL?. 1 Set CAL:STATe ON to allow calibration to occur. 2 Set the digitizer to the desired filter on the channel you want to calibrate with INPut[]:FILTer:FREQ and :FILTer:STATe ON|OFF. Optional Parameters: Optional parameters that are left blank are filled from left to right.
DIAGnostic The DIAGnostic subsystem contains several commands that were developed to test the instrument at the factory. Some of these commands may prove useful for isolating problems or for use in special applications.
DIAGnostic:DAC:OFFSet DIAGnostic:DAC:OFFSet[] writes the specified voltage value to the calibration offset DAC of the specified channel when the DAC:GAIN command is sent. This offset voltage value is not used unless a DAC:GAIN is sent to the calibration gain DAC. This command is a factory diagnostic routine. Parameters Comments Name Type Range of Values Default Value voltage numeric -2.5 to +2.
DIAGnostic:DAC:SOURce DIAGnostic:DAC:SOURce outputs the specified voltage from the internal calibration source DAC onto the calibration pins (CAL -H and CAL-L) of the front panel Calibration Bus Output connector. This command is a factory diagnostic routine. Parameters Comments Name Type Range of Values Default Value voltage numeric -15.0 to +15.0 none Input Relay Operation: The channel’s input relay remains open until it is closed by INPut:STATe ON by a reset of the instrument.
DIAGnostic:INTerrupt:LINE DIAGnostic:INTerrupt:LINE 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 sets the interrupt line to be used. Specifying the “0” parameter disables all interrupts. NOTE Comments The STATus subsystem will not work if interrupts are disabled (STATus: OPERation and STATus:QUEStionable). Use DIAG:STATus? to disable interrupts. Power-On Setting: Power-on default setting is interrupt line “1”.
Parameters Comments Name Type Range of Values Default Value size numeric 4E6, 8E6, 16E6, 32E6, 64E6 and 128E6 none Using the Parameter: The parameter will accept a value in excess of the industry notation value of 4M, 8M, 16M, etc. (e.g., 4E6, 8E6, 16E6, etc.) up to the actual size. See DIAGnostic:MEMory:SIZE?. DIAGnostic:MEMory:SIZE? DIAGnostic:MEMory:SIZE? queries the RAM size value in calibration memory.
reg_number 0 1 2 3 4** 5** 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Register Description (base + register offset) Manufacturer ID Register (base + 0016) Device Type Register (base + 0216) Status/Control Register (base + 0416) Offset Register (base + 0616) FIFO High Word Register (base + 0816) FIFO Low Word Register (base + 0A16) Interrupt Control Register (base + 0C16) Interrupt Sources Register (base + 0E16) CVTable Channel 1 Register (base + 1016) CVTable Channel 2 Reg
DIAGnostic:POKE DIAGnostic:POKE , places the specified value in the specified register. Parameters Name Comments Type Range of Values Default Value reg_number numeric 2-4, 14-16, 18-31 none data numeric -32768 to +32767 (signed integer) 0 to 65535 (unsigned integer) none Writing to Registers: See Appendix B for register bit definitions.You can write to the following digitizer registers using the register number.
DIAGnostic:SHORt DIAGnostic:SHORt[] ON | 1 | OFF | 0 connects an internal short across the input of the specified channel when the “ON” or “1” parameter is used. The internal short is enabled by “ON” or “1” and disabled by “OFF” or “0”. Comments Short Remains in Effect Until Disabled: The short remains in effect until a reset or until it is disabled with DIAG:SHORt[] OFF.
Comments Command Returns Status Information: This command returns a binary-weighted number representing the bit pattern of the register and, therefore, the status of the above instrument events.
FORMat The FORMat command subsystem is used to specify the output format of the readings from the E1563A and E1564A Digitizers. Subsystem Syntax FORMat [:DATA] ASCii | PACKed | REAL [:DATA]? FORMat[:DATA] FORMat[:DATA] ASCii | PACKed | REAL specifies the output format for measurement data. Comments PACKed Format: PACKed,16 format is signed 16 bits (16-bit integers).
INITiate The INITiate subsystem controls the initiation of the trigger system and prepares the Digitizer to take voltage measurements. Once a trigger is received from the programmed source (TRIGger:SOURce), measurements begin on all channels. Normally, all measurement setup (setting measurement ranges, sample count and trigger sources, etc.) should be done before this command is sent. Sending this command will cause the Digitizer to begin the measurement process.
You can also detect when measurements are complete by monitoring the “measurement complete” bit (bit 9) of the STATus:OPERation:CONDition register in the STATus system (see the STATus subsystem). *WAI, *OPC and *OPC? will all be fulfilled immediately after INIT is processed, not when the measurements are complete.
INPut The INPut command subsystem controls characteristics of the input signal, including ON/OFF state and low-pass filtering. The command defaults to channel 1 if you do not specify a channel in the command syntax (e.g., INP ON is same as INP1 ON). Subsystem Syntax INPut[] :FILTer[:LPASs]:FREQ 1.
INPut:FILTer[:LPASs][:STATe] INPut[]:FILTer[:LPASs][:STATe] ON | 1 | OFF | 0 enables or disables the low-pass filter on the specified channel. Comments Executable Command: NO Coupled Command: NO Reset (*RST) Condition: Filter OFF INPut:FILTer[:LPASs][:STATe]? INPut[]:FILTer[:LPASs][:STATe]? queries the specified channel to determine if the low-pass filter is enabled or disabled. A return value of “0” indicates the filter is OFF and “1” indicates the filter is ON.
OUTPut The OUTPut command subsystem sets the source of output pulses for the specified TTL Trigger line (TTLT0-TTLT7) and enables or disables the output. Subsystem Syntax OUTPut :TTLT:SOURce TRIGger | SAMPle | BOTH :TTLT:SOURce? :TTLT[:STATe] ON | 1 | OFF | 0 :TTLT[:STATe]? OUTput:TTLT:SOURce OUTPut:TTLT:SOURce TRIG | SAMP | BOTH sets the source of output pulses for the specified TTL Trigger line. can have the value 0 through 7 (TTLT0 - TTLT7).
OUTPut:TTLT[:STATe] OUTPut:TTLT[:STATe] ON | 1 | OFF | 0 enables or disables the specified TTL Trigger line for outputting the source set by OUTPut:TTLT: SOURce. can have the value 0 through 7 (TTLT0 - TTLT7). Comments Resource Conflicts: Resource conflicts will occur if either the trigger or sample source is already using a TTL line you attempt to enable as an OUTPut line. The OUTPut TTLT line will not be enabled and a “Settings Conflict” error will occur.
SAMPle The SAMPle command subsystem sets the number of samples to be taken for each trigger. It also sets the number of samples to be taken prior to the trigger and the source of the sample signal and its slope. When the sample source is TIMer, you can set the sample interval.
Comments Maximum Samples: The total number of readings is limited to at most 16,777,215 for the 4-channel E1564A Digitizer and 33,554,431 for the 2-channel E1563A Digitizer, depending on the amount of memory on the card. The following describes the limits with the different memory options. If a number greater than the maximum is set, the digitizer goes to continuous mode and SAMPle:COUNt? returns 0.
Comments Using the Parameter: must be a positive number and not greater than the sample count -1. This count specifies the portion of the total SAMPle:COUNt that will be sampled prior to the trigger. A trigger is ignored if it occurs before the pretrigger count is met. Sampling Operation: If the specified number of pretrigger samples () have been taken and a trigger has not yet occurred, the digitizer continues to sample the input signal.
SAMPle:SLOPe SAMPle:SLOPe POS | 1 | NEG | 0 sets the slope of the sample signal (the active edge, rising or falling, of the sample signal). The slope setting is common to all channels. Comments Sample Source Must be EXTernal: This command is effective only when the sample source is EXTernal. The slope is set but will be ignored if the sample source is a source other than EXTernal.
Parameters Comments Name Type Point of Source Default HOLD discrete SAMPle[:IMMediate] none TIMer discrete Uses specified SAMPle:TIMer as sample rate none TTLT0-7 discrete VXIbus TTL trigger lines none EXTernal discrete “Sample” pin on D-sub connector none Sample Slopes and Periods: A rising or falling edge for the sample slope can be specified if the source is set to EXTernal (see SAMPle:SLOPe).
SAMPle:TIMer SAMPle:TIMer | MIN | MAX sets the time interval for each sample event when the sample source is TIMer. Measurements are made on the input signal at this rate. This interval is common to all channels for sample source TIMer. Parameters Name Type Range of Values Default Value interval numeric 1.25E-6 to 0.8 (in multiples of the reference oscillator period*. Default TIMer period is 1.3E-6 seconds) 1.
[SENSe:] The SENSe command subsystem is used to change low-level parameters such as voltage range, sweep and sweep offset points and to set the reference oscillator source and frequency. It is also used to obtain measurement data from the module.
Comments NOTE Readings Returned in Interleaved Configuration: The readings are returned in an array in an interleaved configuration. That is, the array contains the first reading from each specified channel followed by the second reading from each specified channel. The readings are in channel number order starting with the lowest to highest specified channel in the channel list.
[SENSe:]DATA:ALL? [SENSe:]DATA:ALL? returns voltage formatted data from each active channel. Parameters Name Type Range of Values Default Value rdgs_per_ channel numeric 1 to 32M* (E1563A) 1 to 16M* (E1564A) none *(memory size in bytes)/(nbr of channels * 2) = 128M/4 or 128M/8 (MAX) Comments NOTE Readings Returned: The readings are returned in an array in an interleaved configuration. That is, the array contains the first reading from channel 1, channel 2, etc.
IEEE-488.2 Headers: Both PACKed and REAL formats return data preceded by the IEEE-488.2 definite length arbitrary block header.
REAL Format Data: Data are returned as real numbers when the data format is set to REAL (see FORMat[:DATA] REAL). The data are returned in voltage units and no scaling conversion is required as with the PACKed format. Readings are in an interleaved configuration. IEEE-488.2 Headers: Both PACKed and REAL formats return data preceded by the IEEE-488.2 definite length arbitrary block header.
[SENSe:]ROSCillator:SOURCe [SENSe:]ROSCillator:SOURce INTernal | EXTernal specifies the timebase source. The default timebase is the INTernal timebase which uses the VXI CLK10, 10 MHz reference. The EXTernal input is the TTL “Time Base” input pin on the front panel External Trigger Input (D-subminiature connector) (right pin column, bottom pin).
[SENSe:]SWEep:OFFSet:POINts [SENSe:]SWEep:OFFSet:POINts | MIN | MAX sets the number of sweep offset points. must be a negative number. Comments This command is the same as SAMPle:PRETrigger:COUNt, except the sign on is negative here, whereas it is positive for pretrigger count and is included for SCPI compatibility. [SENSe:]SWEep:OFFSet:POINts? [SENSe:]SWEep:OFFSet:POINts? [MIN | MAX] returns the sweep offset points.
[SENSe:]VOLTage[][:DC]:RANGe [SENSe:]VOLTage[][:DC]:RANGe changes the range on the specified channel. There are seven different ranges. If the range specified falls between two of the instrument’s ranges, the range is set to the next higher range setting. The command defaults to channel 1 if no channel is specified. Comments Comments Crossover Points: Crossover points for range changes are: Voltage Range Resolution 0.0625 0.2500 1.0000 4.0000 16.0000 64.0000 256.0000 .
STATus The STATus subsystem reports the bit values of the Operation Data/Signal Register and Questionable Data/Signal Register. It also allows you to unmask the bits you want reported from the Standard Event Register and to read the summary bits from the Status Byte Register. The Operation Data/Signal Register and Questionable Data/Signal Register groups consist of a condition register, an event register and an enable register. STATus:OPERation and STATus:QUEStionable control and query these registers.
Digitizers Command Reference Chapter 3
OPERation Status Register The OPERation Status register indicates operational status as follows: Bit # Status Byte Register NOTE Standard Event Status Register Description 0 CAL:STATe ON (calibration in progress) 5 waiting for trigger 8 pretrigger count is met 9 measurement complete The OPR Operational Status bit, RQS Request for Service bit, ESB Standard Event Status Summary bit, MAV Message Available Summary bit and QUE QUEStionable Status Summary bit in the Status Byte Register (bits 7, 6,
STATus:OPERation[:EVENt]? STATus:OPERation[:EVENt]? returns a decimal-weighted number representing the bits set in the OPERation Status Event Register. This command clears all bits in the Event Register when executed. STATus:PRESet STATus:PRESet affects only the OPERation Status Enable Register and the QUEStionable Status Enable Register by setting all Enable Register bits to 0. It does not affect the Status Byte Register or the Standard Event Status Register.
SYSTem The SYSTem command subsystem returns error numbers and their associated messages from the error queue. You can also query the SCPI version for this instrument. Subsystem Syntax SYSTem :ERRor? :VERSion? SYSTem:ERRor? SYSTem:ERRor? returns the error numbers and corresponding error messages in the error queue. See Appendix C for a listing of the error numbers, messages and descriptions.
TEST The TEST command subsystem allows you to run a self-test and returns information about self-test errors and results from the *TST? command. Subsystem Syntax TEST :ERRor? :NUMBer? , :TST[:RESults]? TEST:ERRor? TEST:ERRor? returns a binary coded decimal (BCD) number and a string giving details about the error associated with the test number returned by the *TST? command or the array of errors returned by the TEST:TST[:RESults]? command.
Comments Test Descriptions: This table summarizes the available self-tests for the digitizers.
test_number Description 32 Channel 2: 4V range filter ON, offset noise test 33* Channel 3: 4V range filter ON, offset noise test 34* Channel 4: 4V range filter ON, offset noise test 35 Channel 1: 16V range filter OFF, offset noise test 36 Channel 2: 16V range filter OFF, offset noise test 37* Channel 3: 16V range filter OFF, offset noise test 38* Channel 4: 16V range filter OFF, offset noise test 39 Channel 1: 16V range filter ON, offset noise test 40 Channel 2: 16V range filter ON, offse
test_number Description 65* Channel 3: Gain DAC test 66* Channel 4: Gain DAC test 67* Channel 1: 62 mV uncalibrated gain 68* Channel 2: 62 mV uncalibrated gain 69* Channel 3: 62 mV uncalibrated gain 70* Channel 4: 62 mV uncalibrated gain 71* Channel 1: 0.25V uncalibrated gain 72* Channel 2: 0.25V uncalibrated gain 73* Channel 3: 0.25V uncalibrated gain 74* Channel 4: 0.
Self-Test Error Definitions: A failed self-test will return a number other than zero. The binary value of that number defines the failure mode. More than one failure mode may result from one self-test. The failure modes are defined in the following sections for each type of self-test.
Uncalibrated Gain Test (self-test numbers 67-94)(E1564A Digitizer) BCD weight Failure mode 1 The max-to-min span is 0.0. 2 Gain span is too large. 4 Gain mean is too low. 8 Gain mean is too high. 16 Gain standard deviation is too large. 32 Gain is out of limits. TEST:TST[:RESults]? TEST:TST[:RESults]? returns an array of integers that result from the self-test command *TST?. A response of “0” indicates there is no error.
TRIGger The TRIGger command subsystem controls the behavior of the trigger system.
Comments Changing Ranges: The present range setting will determine the maximum and minimum values that can be entered without error. Changing range will keep the level at the same percentage of the new range. For example, if level is set to 2.0 on the 4V range, the level is set to 8.0 if you change to the 16V range (50% of full range). Setting Levels: Changing ranges will change an existing level to the same percent of full scale on the new range. For example, if an 8.
TTLT pairs to SLAVe modules MASTer MODE SLAVe MODE Sample line Trigger line MASTer0 SLAVe0 TTLT0 TTLT1 MASTer2 SLAVe2 TTLT2 TTLT3 MASTer4 SLAVe4 TTLT4 TTLT5 MASTer6 SLAVe6 TTLT6 TTLT7 Executable when initiated: YES Coupled command: NO Reset (*RST) condition: NORMal mode TRIGger:MODE? TRIGger:MODE? queries the trigger mode setting. Returns NORMal, MASTer or SLAVe.
TRIGger:SLOPe[]? TRIGger:SLOPe[]? queries the present setting for the slope of the trigger signal for the trigger source (1 or 2) specified. Trigger slope for source number 1 is returned if is not designated. Trigger slope applies only for TRIG:LEVel when the trigger source is INTernal or EXTernal. The command returns “POS” or “NEG”.
TRIGger:SOURce INTernal: TRIGger:SOURce INTernal1-2 (E1563A) or TRIGger:SOURce:INTernal1-4 (E1564A) triggers a reading when the level specified by TRIG:LEVel is met. The TRIG:SLOPe setting determines whether the trigger occurs when the signal rises above (POSitive) or falls below (NEGative) the specified level on that channel.
IEEE 488.2 Common Commands Quick Reference This table lists, by functional group, the IEEE 488.2 Common (*) Commands that can be executed by the E1563A and E1564A Digitizers. However, commands are listed alphabetically in the following reference. Examples are shown in the reference when the command has parameters or returns a non-trivial response. Otherwise, the command string is as shown in the table. For additional information, see IEEE Standard 488.2-1987.
*CLS *CLS clears the Standard Event Status Register, the OPERation Status Register, the QUEStionable Signal Register, and the Error Queue. This clears the corresponding summary bits (bits 3, 5 and 7) in the Status Byte Register. *CLS does not affect the enable unmasks of any of the Status Registers.
*ESR? *ESR? returns the value of the Standard Event Status Register. The register is then cleared (all bits 0). Comments Executable when initiated: YES Coupled command: NO Reset (*RST) condition: none Power-On condition: register is cleared *IDN? *IDN? returns identification information for the E1563A and E1564A Digitizers. The response consists of four fields: HEWLETT-PACKARD, E1563A, 0, A.01.00 HEWLETT-PACKARD, E1564A, 0, A.01.
Executable when initiated: YES Coupled command: NO Related commands: *OPC?, *WAI Reset (*RST) condition: none *OPC? *OPC? causes the E1563A and E1564A Digitizers to wait for all pending operations to complete. A single ASCII “1” is then placed in the output queue. Comments INIT vs. OPC?: The INIT command is considered complete when the measurement is started. *OPC? will return “1” once INIT is processed and measurements start but the instrument may not be finished taking all readings initiated.
*SRE and *SRE? *SRE specifies which bits of the Status Byte Register are enabled (unmasked) to generate an IEEE-488.1 service request. Event and summary bits are always set and cleared in the Status Byte Register regardless of the value. A "1" in a bit position enables service request generation when the corresponding Status Byte Register bit is set and a “0” disables it. For example, *SRE 16 enables a service request on Message Available bit (bit 4).
*TST? *TST? causes the E1563A and E1564A Digitizers to execute an internal self-test and returns the number of the first failed test. Comments *TST? Responses: A zero response indicates the self-test passed. Any non-zero response indicates the test failed. Input the failed test number into the TEST:ERR? command. The returned values from this command will be the result code and a string. See Appendix C for information on interpreting the result code and string.
SCPI Commands Quick Reference This table summarizes SCPI commands for the E1563A and E1564A Digitizers.
Command Description INITiate [:IMMediate] :CONTinuous ON | 1 | OFF | 0 :CONTinuous? Initiate a measurement now Initiate measurements continuously Query continuous state INPut[] :FILTer[:LPASs]:FREQ 1.5K | 6K | 25K | 100K (4-chan) :FILTer[:LPASs]:FREQ? :FILTer[:LPASs][:STATe] ON | 1 | OFF | 0 :FILTer[:LPASs][:STATe]? [:STATe] ON | 1 | OFF | 0 [:STATe]? Set the input filter and enable/disable input E1564A only. E1563A has fixed 25K.
Command Description STATus :OPERation:CONDition? :OPERation[:EVENt]? :OPERation:ENABle :OPERation:ENABle? :PRESet :QUEStionable:CONDition? :QUEStionable[:EVENt]? :QUEStionableENABle :QUEStionable:ENABle? Read OPER:CONDition register Read OPER:EVENt register Unmask operation register bits Read OPER:ENABle register PRESet the status registers Read OPER:CONDition register Read OPER:EVENt register Unmask questionable register bits Read OPER:EVENt register SYSTem :ERRor? :VERSion? Read sys
Notes: 118 Digitizers Command Reference Chapter 3
Appendix A Digitizers Specifications General Number of channels: E1563A: 2 channels E1564A: 4 channels Selectable input filters (2-pole Bessel): E1563A (per channel): 25 kHz E1564A (per channel): 1.5kHz, 6 kHz, 25 kHz, 100 kHz Timing: Bandwidth:>400 kHz for all ranges Resolution: 14 bits (including sign) Sample rates: 1 Sa/s to 800 kSa/s Integral Non-linearity (all ranges): 2.5 LSB Built-in DSP: No Alias protection: Oversample Time base resolution: 0.
Notes: 120 Digitizers Specifications Appendix A
Appendix B Register-Based Programming About This Appendix This appendix contains the information you can use for register-based programming of the E1563A and E1564A Digitizers. The contents include: • Register Programming vs. SCPI Programming . . . . . . . . . . .121 • Addressing the Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . .121 • Register Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124 • Programming Examples . . . . . . . . . . . . . . . . . . . . . .
The Base Address When reading or writing to a switch register, a hexadecimal or decimal register address is specified. This address consists of a base address plus a register offset. The base address used in register-based programming depends on whether the A16 address space is outside or inside the E1406 Command Module. Figure B-1 shows the register address location within A16 as it might be mapped by an embedded controller. Figure B-2 shows the location of A16 address space in the E1406 Command Module.
Register Offset The register offset is the register’s location in the block of 64 address bytes. For example, the digitizer’s Status Register has an offset of 0416.
Register Descriptions There are twenty WRITE and thirty-one READ registers on the digitizer. This section contains a description of the registers followed by a bit map of the registers in sequential address order. Undefined register bits appear as "0" when the register is read, and have no effect when written to.
READ Registers You can read the following digitizer registers: Description Appendix B Address Manufacturer ID Register base + 0016 Device Type Register base + 0216 Status/Control Register base + 0416 Offset Register base + 0616 FIFO High Word Register base + 0816 FIFO Low Word Register base + 0A16 Interrupt Control Register base + 0C16 Interrupt Sources Register base + 0E16 CVTable Channel 1 Register base + 1016 CVTable Channel 2 Register base + 1216 CVTable Channel 3 Register base
Description ID Register base + 0016 Read 15 14 Device Class 1 1 Address Trigger Control/Source Register base + 3C16 Sample Control/Source Register base + 3E16 Reading the ID register returns FFF16 in the least significant bits to indicate the manufacturer is Hewlett-Packard and the module is an A16 registerbased device.
: *WRITE BITS (Status/Control Register) bit 0 R Writing a "1" to this bit resets the digitizer to the power-on state. You must set bit 0 back to a logical "0" before resuming normal operations of the module. bit 1 S “1” inhibits sysfail, “0” does not inhibit sysfail. bit 6 E “1” disables error reporting LED, “0” enables error reporting LED (front panel). bit 7 F “1” disables Flash ROM “write”, “0” enables Flash ROM “write”.
A24 Offset Register The offset of the module in A24 space is set by the upper eight bits (15-8) of this register. The lower eight bits (7-0) of this register are zero. base + 0616 15 14 13 12 11 10 9 8 Write* A23 A22 A21 A20 A19 A18 A17 A16 Read** A24 Offset 7 6 5 4 3 2 1 0 0 0 0 undefined 0 0 0 0 0 *WRITE BITS (A24 Offset Register) bits 8-15 A16-A23 These bits set the offset of the module in A24 space.
base + 0816 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 Read base + 0A16 0 LSB 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 Read 0 LSB Interrupt Control Register The interrupt level and the interrupt source are controlled by the interrupt control register. There are several sources of interrupt. A logical OR is performed on the enabled sources to determine if an IRQ should be pulled.
Interrupt Source Register Eight events can be enabled to interrupt the digitizer. These events are listed in the above Interrupt Control Register definition for bits 8 through 15. The Interrupt Source Register contains the latched version (bits 8-15) and the unlatched version (bits 0-7) of these sources. The value of a source is latched high when the source has a low-to-high transition.
CVTable Channel 3 Register base + 1416 15 Read MSB 14 13 This register holds the last value of the 2’s complement data stored in FIFO for channel 3. Data is 14 bits with the LSB at bit 2. 12 CVTable Channel 4 Register base + 1616 15 Read MSB 14 13 11 10 9 8 7 6 5 4 3 2 1 0 LSB 0 0 This register holds the last value of the 2’s complement data stored in FIFO for channel 4. Data is 14 bits with the LSB at bit 2.
Calibration Flash ROM Data Register This register holds the data of the calibration flash ROM that is used for the calibration constants. The upper eight bits return “0” when this register is read. Note the bit pattern 01010 for bits 15-11 in the upper byte. A write to Flash ROM is aborted if this pattern is not present.
Range, Filter, and Channel 1, 2 Connect Register 14 13 Each channel has an 8-bit byte that controls the input signal range, filter cutoff and the relay that connects the channel to the front panel connector. The fastest way to change range, filter or the connect relay is to write a 32-bit word to the register. After every write to this register the bus is held off 10 ms until the range, filter and relay information is sent to the isolated channel.
: WRITE/READ BITS (Range, Filter and Channel 3/4 Connect Register) bits 0-2 and 8-10 Gain Code These bits set the gain of the input channel by the codes shown below: 000 = 62.5 mV range 001 = 0.25V range 010 = 1.0V range 011 = 4.0V range 100 = 16V range 101 = 64V range 110 = 256V range (also 111 = 256V range) bits 3 and 11 short3, short4 These bits connect an internal short to the channel inputs when the bit is “1”. When it is “0”, bits 7 & 15 connect the channel to the input or the calibration bus.
Trigger/Interrupt Level Channel 2 Register This register provides 8-bit data corrected for offset and gain in 2’s complement format. : base + 2A16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write* MSB-D7 D6 D5 D4 D3 D2 D1 D0 0 0 0 0 0 0 0 GL Read** MSB-D7 D6 D5 D4 D3 D2 D1 D0 0 0 0 0 0 0 0 GL *WRITE/**READ BITS (Trigger/Interrupt Level Channel 2 Register) bit 0 GL Greater than or Less than; “0” = >, “1” = <. bits 15-8 D7-D0 data bits.
Trigger/Interrupt Level Channel 4 Register This register provides 8-bit data corrected for offset and gain in 2’s complement format. : base + 2E16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write* MSB-D7 D6 D5 D4 D3 D2 D1 D0 0 0 0 0 0 0 0 GL Read** MSB-D7 D6 D5 D4 D3 D2 D1 D0 0 0 0 0 0 0 0 GL *WRITE/**READ BITS (Trigger/Interrupt Level Channel 4 Register) bit 0 GL Greater than or Less than; “0” = >, “1” = <. bits 15-8 D7-D0 data bits.
Pre-Trigger Count Low Word Register This register holds the low word (2 bytes) for the pre-trigger count.i base + 3616 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write C15 C14 C13 C12 C11 C10 C9 C8 C7 C6 C5 C4 C3 C2 C1 C0 Read C15 C14 C13 C12 C11 C10 C9 C8 C7 C6 C5 C4 C3 C2 C1 C0 Sample Count High Byte Register base + 3816 15 14 13 Sample count is the total number of readings to be taken including the pre-trigger readings. The minimum value is 1.
: *WRITE BITS (Trigger Source Register) and **READ BITS (Trigger Control Register) bits 0-2 TTL_n 000 = TTLT0, 001 = TTLT1, 010 = TTLT2, ... , 011 = TTLT6, 111 = TTLT7. bit 3 IN/OUT TTLTn line is: 0 = IN, 1 = OUT. bit 4 EN_TTL 0 = disable TTLTn, 1 = enable TTLTn bit 5 SLAVE 0 = not a slave module, 1 = slave module. bit 6 MASTER 0 = not a master module, 1 = master module. bit 7 SOFT TRIG software trigger: 0 = IMMediate disabled, 1 = IMMediate enabled.
*WRITE BITS (Sample Source Register) and **READ BITS (Sample Control Register) bit 7 SOFT SAMPLE software sample: 0 = IMMediate disabled, 1 = IMMediate enabled. bit 8 POS_NEG External sample slope: 0 = NEG, 1 = POS. bit 9 EX_SAMPLE 1 = EXTernal sample is an external source you must input on the “Sample” pin on the front panel D-subminiature connector. 0 = EXTernal sample disabled. bit 12 ABORT 1 = aborts measurement and flushes all reading data in all memory.
Programming Examples The following C language example programs were developed on an embedded computer using Agilent VISA I/O calls.You can also use a PC connected via GPIB to an E1406A slot 0 Command Module. The command module provides direct access to the VXI backplane. NOTE If you use the E1406A with SCPI commands, use the E1563A/E1564A SCPI driver which you installed in the E1406A firmware and register programming is not necessary. Chapter 3 describes the SCPI commands for the digitizers driver.
Beginning of Program /* This program resets the E1563A/E1564A, reads the ID Register, the Device */ /* Type Register, the Status Register, makes measurements and retrieves data*/ /* Programmed with MS Visual C++ version 2.0 using Agilent VISA I/O calls. */ #include #include #include #include #include
Read Status Register /**************** read the digitizer's status register **************/ err=ViIn16(digitizer,VI_A16_SPACE,0x04,&stat_reg); if (err
/* E1564A only for channels 3 and 4 -------------- */ err=ViIn16(digitizer,VI_A16_SPACE,0x14,&cvt_reg); if (err
/* write a “1” to the reset bit then set the bit back to “0” */ err=ViOut16(digitizer,VI_A16_SPACE,0x04,1); if (err
Appendix C Digitizers Error Messages This appendix describe the types of errors the E1563A and E1564A report: Execution Errors, Self-Test Errors and Calibration Errors. Execution Errors Number Title Description -101 Invalid character An invalid character was found in the command string. You may have inserted a character such as #, $, or % in the command header or within a parameter. Example: INP:FILT:FREQ#6E3 -102 Syntax error Invalid syntax was found in the command string.
Number Title Description -123 Numeric overflow A numeric parameter was found whose exponent was larger than 32,000. Example: SAMP:COUN 1E34000 -124 Too many digits A numeric parameter was found whose mantissa contained more than 255 digits, excluding leading zeroes. -128 Numeric data not allowed A numeric parameter was found but a character string was expected. Check the list of parameters to verify you have used a correct parameter type.
Number Title Description -221 Settings conflict You tried to set a pretrigger count that exceeds the sample count -1. Or, you enabled one of the internal triggers as the source for a particular channel such as channel 2 (TRIG:SOUR INT2) and then tried to enable one of the limit checking features on channel 2 (CALC2:LIM:UPP:STAT ON). -222 Data out of range A numeric parameter value is outside the valid range for the command.
Number Title Description -440 Query UNTERMINATED after indefinite response The *IDN? command must be the last query command within a command string. Example: *IDN?;:SYST:VERS? 300 Not yet implemented NOT USED 1000 Illegal when initiated Many commands are not allowed to execute when the instrument is busy taking a measurement - this error will occur if that is the case. 1001 Illegal while calibrating Many commands are not allowed to execute when the instrument is in calibration mode.
Self-Test Errors The self-test command (*TST?) will return a non-zero number if self-test fails. Self-test error descriptions are retrieved using the TEST:ERRor? command. Use the number returned by self-test as the to obtain the description of the failure. Calibration Errors Zero Calibration CAL:ZERO[]:ALL? returns a non-zero number if zero calibration fails.
Notes: 150 Digitizers Error Messages Appendix C
Appendix D Digitizers Verification Tests Introduction This appendix provides information on functional and performance verification of the E1563A 2-Channel Digitizer and E1564A 4-Channel Digitizer. Types of Tests You can perform performance verification tests at two different levels depending on need: • Functional Verification Test - A series of internal verification tests (self-tests) that give a high confidence that the digitzer is operational. The self-tests take less than 20 seconds to complete.
Test Conditions All test procedures should comply with the following test conditions: • Ambient temperature of the test area is between 18°C and 28°C and stable to within ±1°C. • Ambient relative humidity of the test area is <80%. • Must have a one hour warm-up with all input signals removed before verification or adjustment. • Use only copper connections to minimize thermal offset voltages.
Functional Verification Test The procedure in this section is used to quickly verify that the digitizer is functioning. This test should be performed any time the user wants to verify that the digitizer is connected properly and is responding to basic commands. Functional Test Procedure This test verifies that the digitizer is communicating with the command module, external controller, and/or external terminal by accepting the *TST? common command and performing a digitizer self-test.
Performance Verification Tests The procedures in this section are used to test the electrical performance of the digitizer using the specifications in Appendix A as the performance standards. The Performance Verification Tests are recommended as acceptance tests when the instrument is first received. The performance verification tests should be repeated at each calibration interval following acceptance.
Noise Verification Test This procedure is used to check the noise performance of the E1563A or E1564A Digitizer. The digitizer’s internal short is applied to the H (HI) and L (LO) input terminals of the channel being tested using the DIAG:SHORt ON command. 1 Check the "Test Conditions" section at the beginning of this appendix. 2 Execute DIAG:SHOR1 ON to enable the internal short across the H and L terminals of channel 1. 3 Set a sample interval of 25 msec by executing SAMP:TIM 25e-6.
Gain Verification Test The gain verification tests check the positive and negative full scale gain on each range for each channel. An external DCV source provides the input and the digitizer’s "L" terminal is connected to the "G" terminal connecting LO to GUARD. The input voltage is slightly less than full scale to avoid overloading the range. 1 Set the digitizer as follows: Reset the digitizer: *RST (sets FILT OFF) Set channel 1 to the 62 mV range: VOLT1:RANG 62E-3 2 Set the DC Standard output to 55 mV.
Filter Bandwidth Verification Test This test checks the filter input bandwidth for the 25 kHz filter on the E1563A or each of the four filters (1.5 kHz, 6 kHz, 25 kHz and 100 kHz) on the E1564A. The test This test uses an external source connected to the HI and LO Input terminals and has the "L" terminal connected to the "G" terminal. The digitizer is set to the 1V range for all tests. 1 Set the digitizer as follows: Reset the digitizer: RST Set all channels to 1V range: VOLT1:RANG 1; VOLT2:RANG 1; etc.
Performance Test Record The Performance Test Record for the E1563A and E1564A digitizers is a form you can copy and use to record performance test results for the digitizers. This form shows the digitizer accuracy limits, the measurement uncertainty from the source and the test accuracy ratio (TAR). NOTE Digitizer Accuracy The accuracy, measurement uncertainty and TAR values shown on the Performance Test Record are valid ONLY for the specific test conditions, test equipment and assumptions described.
E1563A/E1564A Digitizers Performance Test Record General Information Date: _____________________________________ Report No:______________________________ Test Facility:_______________________________ Tested By:______________________________ Address:__________________________________ Phone:_________________________________ City and State:_____________________________ FAX:___________________________________ ZIP:______________________________________ e-mail:_________________________________ Test Cond
Date___________________ PERFORMANCE TEST RECORD H E1563A 2-Channel Digitizer H E1564A 4-Channel Digitizer CHANNEL: Test Input Digitizer Range Low Limit H1 H2 Measured Reading H3 H4 High Limit Meas Uncert Test Accuracy Ratio Zero Offset Test 0 62 mV -.000020 .000020 N/A N/A 0 250 mV -.000078 .000078 N/A N/A 0 1V -.000300 .000300 N/A N/A 0 4V -.001200 .001200 N/A N/A 0 16V -.021000 .021000 N/A N/A 0 64V -.028000 .028000 N/A N/A 0 256V -.079000 .
Test Input Digitizer Range Low Limit Measured Reading High Limit Meas Uncert Test Accuracy Ratio Gain Test (continued) 15V 16V 14.9739 V 15.0261 V .000083 >10:1 -15V 16V -15.0261 V -14.9739 V .000083 >10:1 60V 64V 59.9516 V 60.0484 V .00046 >10:1 -60V 64V -60.0484 V -59.9516 V .00046 >10:1 100V 256V 99.887 V 100.113 V .0007 >10:1 -100V 256V -100.113 V -99.887 V .
Notes: 162 Digitizers Verification Tests Appendix D
Appendix E Digitizers Adjustments Introduction This appendix contains procedures for adjusting the calibration constants in the E1563A and E1564A digitizer. See "Calibration Interval" for recommendations on time intervals. NOTE You must set the module’s "FLASH" and "CALIBRATION CONSTANTS" switches to the "Write Enable" position before you perform any adjustment. This allows modified calibration constants to be stored in memory when you execute CAL:STORe.
Adjustment Procedures WARNING Adjustment Conditions Do not perform any of the following adjustments unless you are a qualified, service-trained technician, and have read the WARNINGS and CAUTIONS in this manual. Adjustment procedures should be performed in the order shown in this manual. See Table D-1, Recommended Test Equipment, for test equipment requirements.
CAUTION ABORTING AN ADJUSTMENT IN PROGRESS. Sometimes it becomes necessary to abort an adjustment once the procedure has been initiated. Issuing a remote interface device clear command will abort the adjustment in progress. Never turn off mainframe power while the digitizer is making an adjustment. If power is removed during a zero adjustment, ALL calibration memory may be lost. If power is removed during any gain adjustment, calibration memory for the function being adjusted may be lost.
E1563A Gain Adjustment NOTE The zero adjustment procedure MUST have been recently performed prior to beginning any gain adjustment procedure. Zero adjustment should be performed one time followed by the other gain adjustments. Each range in the gain adjustment procedure for each channel takes less than 5 seconds to complete. 1 Reset the E1563A Digitizer by executing *RST. 2 Set the DC Standard output to 55 mV for the first gain adjustment.
E1564A Gain Adjustment NOTE The zero adjustment procedure MUST have been recently performed prior to beginning any gain adjustment procedure. Zero adjustment should be performed one time followed by the other gain adjustments. Each range in the gain adjustment procedure for each channel takes less than 5 seconds to complete The E1564A 4-Channel Digitizer has an internal DAC that outputs to a calibration bus on the front panel Calibration Bus Output (D-connector).
3 Prepare the E1564A for calibration: • Set the channel’s range: VOLT:RANG • Set the calibration source to internal: CAL:SOUR INT • Set the CAL DAC output voltage:CAL:DAC:VOLT (see Table E-2 for settings and CAL DAC setting) 4 Note the voltmeter reading from the calibration bus output.
Index E1563A/E1564A Digitizers User’s Manual A A24 Offset register, 128 abbreviated commands, 46 ABORt subsystem, 48 accuracy, digitizers, 158 addressing registers, 121 adjustment procedures, 164 adjustments, digitizers, 163 B base address, 122 C cabling considerations, 23 CALCulate subsystem CALCulate:LIMit:FAIL?, 49 CALCulate:LIMit:LOWer:DATA, 50 CALCulate:LIMit:LOWer:DATA?, 50 CALCulate:LIMit:LOWer[:STATe], 51 CALCulate:LIMit:LOWer[:STATe]?, 51 CALCulate:LIMit:UPPer:DATA, 51 CALCulate:LIMit:UPPer:DATA
D (continued) digitizers accuracy, 158 adding RAM, 19 addressing registers, 121 adjustment procedures, 164 adjustments, 163 application examples, 42 base address, 122 block diagram, 33 cable connector assembly, 27 cabling considerations, 23 calibration, 163 calibration bus output port, 24 Calibration Flash ROM Address register, 131 Calibration Flash ROM Data register, 132 calibration intervals, 163 Calibration Source register, 132 channel block diagram, 34 command types, 45 configuring, 19 CVTable Channel 1
E E1563A gain adjustment, 166 E1564A gain adjustment, 167 error messages, 145 calibration errors, 149 execution errors, 145 self-test errors, 149 examples Digitizer Self-Test, 153 Initial Operation, 30 Master Module Configuration, 39 Sampling Using Immediate Triggering, 43 Slave Module Configuration, 40 Three-Wire Connections (Bridge), 25 Three-Wire Connections (Voltage Measure), 26 Triggering Using External Triggering, 44 Triggering Using Internal Level Trigger, 43 Two-Wire Connections (Coaxial Cable), 26
R (continued) register offset, 123 register-based programming, 121 registers A24 Offset, 128 addressing, 121 base address, 122 Calibration Flash ROM Address, 131 Calibration Flash ROM Data, 132 Calibration Source, 132 CVTable Channel 1, 130 CVTable Channel 2, 130 CVTable Channel 3, 131 CVTable Channel 4, 131 description, 124 Device Type, 126 FIFO High Word/Low Word, 128 ID register, 126 Interrupt Control, 129 Interrupt Source, 130 Offset and Cache Count, 128 Pre-Trigger Count High Word, 136 Pre-Trigger Coun
S (continued) V STATus subsystem (cont’d) STATus:QUEStionable:CONDition?, 96 STATus:QUEStionable:ENABle, 96 STATus:QUEStionable:ENABle?, 96 STATus:QUEStionable[:EVENt]?, 96 SYSTem subsystem SYSTem:ERRor?, 97 SYSTem:VERSion?, 97 W WARNINGS, 10 Warnings, 17 warranty statement, 9 WRITE registers, 124 Z T Test Accuracy Ratio (TAR), 158 test equipment, recommended, 151 TEST subsystem TEST:ERRor?, 98 TEST:NUMBer?, 98 TEST:TST[:RESults]?, 103 Trigger/Interrupt Level Channel 1 register, Trigger/Interrupt Level