Home

E8481A 2-Wire 4x32 Relay Matrix Switch Module User`s Manual

1. J1 J2 on TO on E CATTTTTTTTTTTTTTTTTTTTTUTTTTTTTTI FS D 8 SU e uL Gis 8 8 galo 8888 8888 8888 888 8 Hp ores gees mr o EA 3S amp B P 910 E E og 8888 8888 a TN ROWA1 ROWA2 ROWA3 ROWBO ROWB1 ROWB2 ROWB3 aS N Tun Note RowB 0 3 connectors are used only Dual 4x16 configuration Chapter 2 Figure 2 5 SMB Terminal Module Configuring the Module 23 Wiring a Terminal Module The following illustrations show how to connect field wiring to the screw to the relay matrix switch module 1 Remove Clear Cover type or SMB type terminal module and how to attach the terminal module gt A Release Screws B Press Tab Forward and Relase 2 Remove and Retain Wiring Exit Panel N Remove 1 of the 3 wire exit panels Insert wire into terminal P 2 N 3 Make Connections Grn Use Wire Screw Type a Size 20 26 AWG P Align wire SMB connector Tighten screw Attach it to the connector firmly J f s Replace Wiring Exit Panel Cut required holes in panels for wire exit Keep wiring exit panel hole as small as possibl
2. a Writing to the reserved bits x will cause no action We recommend writing 1 to these bits b Reading from the reserved bits x will return as 1 Do not rely on these value for card operation Reading the When reading the status control register the following bits are of Status Control Register importance Self test Passed bit 2 Used to inform the user of the self test status 1 in this field indicates the module has successfully passed its self test and 0 indicates that the module is either executing or has failed its self test Interrupt Status bit 6 Used to inform the user of the interrupt status 0 indicates that the interrupt is enabled and 1 indicates that the interrupt is disabled The interrupt generated after a channel has been closed can be disabled 102 Register Based Programming Appendix B Busy bit 7 Used to inform the user of a busy condition 0 indicates that the module is busy and 1 indicates that the module is not busy Each relay requires about 1 ms execution time during which time the module is busy Modid Select bit 14 0 in this bit indicates that the module is selected by a high state on the P2 MODID line and 1 indicates it is not selected via the P2 MODID line As an example if a read of the Status Register base 04 returns FFBF 1111111110111111 it indicates that the module is not busy bit 7 2 1 and the interrupt is enable
3. base 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 3C Write Pattern Number 0 510 Read The recall operation consists of a series of data fetching from the specified NVRAM space then expanding and putting these data into the corresponding Relay Control Registers The module will set the BUSY bit of the Status Control Register to 0 during the whole operation and set the BUSY bit to 1 after all the relays are stable 110 Register Based Programming Appendix B Appendix C Error Messages Table C 1 lists the error messages associated with the E8481A Matrix Switch module when programmed with SCPI commands See the appropriate mainframe manual for a complete list of error messages Table C 1 Error Messages Number Error Message Potential Cause s 211 Trigger ignored Trigger received when scan not enabled Trigger received after scan complete Trigger too fast 213 INIT Ignored Attempting to execute an INIT command when a scan is already in progress 224 Illegal parameter value Attempting to execute a command with a parameter not applicable to the command 310 System error Too many characters in the channel list expression 1500 External trigger source Assigning an external trigger source to a switchbox when the already allocated trigger source has already been assigned to another switchbox 2000 Invalid card number Addressing a module
4. Selecting a specific module to be monitored Use the DISPlay MONitor CARD command to send the card number for the switchbox to be monitored Selecting the present module to be monitored Use the DISPlay MONitor CARD AUTO command to select the last module addressed by a switching command for example ROUTe CLOSe RST conditions DISPlay MONitor CARD AUTO Selecting Module 2 in a Switchbox for Monitoring DISPlay MONitor CARD 2 Select module 2 in a switchbox to be monitored DISPlay MONitor CARD 62 Command Reference DISPlay MONitor CARD queries the setting of the DISPlay MONitor CARD command and returns the module in a switchbox being monitored Chapter 4 DISPlay MONitor STATe Parameters Comments NOTE Example DISPlay MONitor STATe lt mode gt turns the monitor mode ON or OFF When monitor mode is on the RS 232 terminal display presents an array of values indicating the open close state of channels on the module The display is dynamically updated each time a channel is opened or closed Name Type Range of Values Default Value lt mode gt boolean ON OFF 1 0 OFF 0 Monitoring Switchbox Channels DISPlay MONitor STATe ON or DISPlay MONitor STATe 1 turns the monitor mode on to show the channel state of the selected module DISPlay MONitor STATe OFF or DISPlay MONitor STATe 0 turns the monitor mode off Typing in another command on the
5. Set module to function as dual 4x16 matrixes errStatus viPrintf E8481A ROUT FUNC 1 DUAL4X16 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query the function mode set for the module errStatus viQueryf E8481A ROUT FUNC 1 n t func if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf The module is set to function as s n func Close the module instrument session errStatus viClose E8481A if Vl SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Using the Matrix Module 31 Switching Channels Close the resource manager session errStatus viClose viRM if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Use CLOSe channel list to close one or more matrix channels and use OPEN channel list to open the channel s The channel list has the form ssrrcc for a single channel ssrrcc ssrrcc for multiple channels ssrrcc ssrrcc for sequential channels Ossrrcc ssrrcc ssrrcec ssrrcc for groups of sequential channels or any combination of the above where ss card number 01 99 rr row number 00 03 and cc column number 00 31 The following example programs were written in HTBasic and Visual C C programming
6. 112 64 2 080 768 1536 2 087 936 200000 000000 1F0000 Ragister a Offset Description E1406 Address Map 3C Fattem Recall Register 3A NVRAM Data Register 2 38 NVRAM Address Register 200000 KN e e ee E 3 e 200000 e A24 Fegister 2E Felay Control Fegister 16 Address Address 2C Felay Control Fegister 15 Space Space 1FCO00 D Rn 12 Relay Control Register 2 ee eae 1o 10 Felay Control Register 1 e e e e e Base Address 1FC000 Logical Address 64 0C Intenupt Slection Pegister or 04 Satus Control Register 2 080 768 Logical Address 64 B 02 Device Type Ragister 00 ID Fegister Register Address Base Address Register Offset h Figure B 2 Registers within Command Module s A16 Address Space Numbers with a subscripted h are in hexadecimal format Numbers without the subscripted h are in decimal Appendix B format Register Based Programming 99 Reg ister Offset register offset is the register s location in the block of 64 address bytes For example the module s Status Control Register has an offset of 04 When you write a command to this register the offset is added to the base address to form the register address 04 DC04 1FDC00 04 IFDC04 or decimal 56 320 4 56 324 2 087 936 4 2 087 940 100 Register Based
7. 83 STATu s OPER ton ENABle tere ether tet reo eet 83 STATus OPERation ENABle eterne tenen 83 STATus OPERation EVENt ccccccccccccesssececceesesssseeecceceessaeeeeecesensseaeeeeees 84 tee Tee Ee hese 84 S YS Temas ust tee ee 85 SYSTem CDEScriptionD iet eter feet ett hte ettet e terit eite de 85 SYS Ferm ette ei el Co dut 85 SY 5 Tem C EYBe 7 5 certae One e RI 86 SYS Tem BR ROE tO SET MeO A A 86 SYS Tem VERSION nutu ero adores ee E EE RE cate aves 87 TIRIGS8E ies 88 TRIGeer IMMedrate 2 tee ro e eret ertet ettet etre 88 TRIGZe SOURCE meg IE ETHER EE niin dite etnies 89 TRIG SEE SOURCE e rate e ise bete e atti cep ade i erue 90 SCPI Command Quick Reference i enne 9 IEEE 488 2 Common Command Reference ssesssssseeeeenee nennen 93 Appendix A ES8481A Specifications ssccccsesicectesscessssussieasssensescnassesdcsoseesseossencecsscssassssesnasencsdeecssetessess 95 Appendix B Register Based Programming sscsssccsssscsssssssssssssscsssscssssccesssssssssssssssssssssesesssseees 97 About This AppendiX ep e E e eo eret i dete 97 Register Addressing eue eee E ee a e Re geret lat 97 Base Address deeem out etaed atte estet tree eae ditis 97 Register Offset uie eoe RR eet 100 Regist
8. Relay Control Registers You can set the interrupt level of the module by writing to Interrupt Level Bits bits 0 2 of the register Writing bits 2 0 with 001 010 011 100 101 110 or 111 will set the interrupt level equal to interrupt level 1 through 7 The highest interrupt level is 7 and the lowest level is 1 default value Changing the interrupt priority level is not recommended DO NOT change it unless specially instructed to do so Refer to the E1406A Command Module User s Manual for more details Reading the register will return the current interrupt level of the module The returned value 001 010 011 100 101 110 or 111 in Bits 2 0 corresponds to interrupt level 1 through 7 There are sixteen relay control registers used to control the 128 channels of the matrix module They are Relay Control Register for Channels 0000 0007 base 104 Relay Control Register for Channels 0008 0015 base 124 Relay Control Register for Channels 0100 0107 base 144 Relay Control Register for Channels 0108 0115 base 164 Relay Control Register for Channels 0200 0207 base 184 Relay Control Register for Channels 0208 0215 base 1A Relay Control Register for Channels 0300 0307 base 1C Relay Control Register for Channels 0308 0315 base 1E4 Relay Control Register for Channels 0016 0023 base 204 Relay Control Register for Channels 0024 0031 base 224 Relay Control Register for
9. Single 4x32 Matrix or Dual 4x16 matrixes Form A Non latching Reed 1x10 2 21 A Q 5 V 0 1A Q 45V 13W 0 1 mm 1 1 Liter sec for 10 C rise 0 55 C 65 RH 0 40 C INPUT CHARACTERISTICS Maximum Voltage Maximum Transient Impulse Maximum Current Terminal to Terminal Per Channel non inductive 42 Vdc 30 Vac rms 500 V peak 0 5 A dc 0 5 A ac peak Maximum Power Per Channel resistive load 5 VA ac Per Module resistive load 40 VA ac DC ISOLATION PERFORMANCE Closed Channel Resistance Per channel lt 2 Q initial Isolation resistance lt 40 C 65 RH 1080 between any two points single module 25 C 40 RH 21090 Thermal Offset Per Channel lt 50 uV continued on the next page Appendix A E8481A Specifications 95 Table 4 1 E8481A Specifications ITEMS SPECIFICATIONS AC ISOLATION PERFORMANCE 4x32 Configuration 2 25 50 Q lt 40 C 65 RH Closed Channel Capacitance Bandwidth 3dB Crosstalk Within a Card Channel Channel with 50Q termination Hi to Lo Hi to Chassis Lo to Chassis 4 x 32 Configuration 100 KHz lt 5 MHz lt 50 MHz lt 160 pF lt 160 pF lt 550 pF 50 MHz lt 65 dB lt 50 dB lt 27 dB AC ISOLATION PERFORMANCE Dual 4x16 Configuration 2 25 50 Q lt 40 C 65 RH Closed Channel Capacitance Bandwidth 3dB Crosstalk Within a Card
10. Pattern Recall Register 110 Relay Control Registers 107 Status Control Register 102 Recalling and Saving States 50 Register based Programming 97 Registers addressing 97 base address 97 description 101 Device Type 102 Interrupt Selection 104 Manufacturer Identification 102 NVRAM Address 109 NVRAM Control 107 NVRAM Data 109 offset 100 Pattern Recall 110 Relay Control 104 Status Control 102 Relay Control Registers 104 removing module from a mainframe 20 removing terminal block from the matrix 26 Reset Conditions 28 restricted rights statement 7 ROUTe CLOSe 70 ROUTe CLOSe 71 ROUTe FUNCtion 72 ROUTe FUNCtion 72 ROUTe OPEN 73 ROUTe OPEN 73 ROUTe PATTern ACTivate 74 ROUTe PATTern ACTivate 75 ROUTe PATTern CLOSe 75 ROUTe PATTern CLOSe 76 ROUTe PATTern NUMBer 77 ROUTe PATTern NUMBer 77 ROUTe PATTern OPEN 78 ROUTe PATTern OPEN 79 ROUTe SCAN 80 ROUTt subsystem 70 80 116 Agilent E8481A User s Manual Index S safety symbols 8 Scan Complete Bit 81 Scanning Channels 37 Using Trig In Out Ports 37 Using TTL Trigger 42 SCPI Command Format 53 SCPI Command Quick Reference 91 SCPI Command Reference 55 91 ROUTe subsystem 70 80 ROUTe CLOSe 70 ROUTe CLOSe 71 ROUTe FUNCtion 72 ROUTe FUNCtion 72 ROUTe OPEN 73 ROUTe OPEN 73 ROUTe PATTern ACTivate 74 ROUTe PATTern ACTivate 75 ROUTe PA
11. channel list and an INITiate IMMediate command must be executed before TRIGger IMMediate will execute BUS or HOLD Source Remains If selected the TRIGger SOURce BUS or TRIGger SOURce HOLD commands remain in effect after triggering a switchbox with the TRIGger IMMediate command Related Commands INITiate ROUTe SCAN TRIGger SOURce Advancing Scan Using TRIGger Command This example uses the TRIGger command to advance the scan of a single module switchbox from channel 10000 through 10003 Since TRIGger SOURce HOLD is set the scan is advanced one channel each time TRIGger is executed TRIG SOUR HOLD Set trigger source to HOLD SCAN 10000 10003 Define channel list to be scanned INIT Start scanning cycle close channel 100 loop statement Start count loop TRIG Advance scan to next channel increment loop Increment loop count Chapter 4 TRIGger SOURce Parameters Comments Chapter 4 TRIGger SOURce source specifies the trigger source to advance the channel list during scanning Name Type Parameter Description BUS discrete TRG or GET or TRIGger IMMediate command ECLTrgn numeric ECL Trigger bus line 0 1 EXTernal discrete Trig In port HOLD discrete Hold Triggering until receiving TRG command IMMediate discrete Immediate Triggering TTLTrgn numeric TTL Trigger bus line 0 7 Enabling the Trigger Source The TRIGger SOURce command only selects the tr
12. ee EA 1412 Multimeter Module E E8481A Opt 105 Terminal Module Trigger E a es ELO VM RowA OH B UL Complete RowA 01 B B B gt J B8 On g B HI n l amp Bo 8 B E Tg B g 8 gt h pg 52 a ig d LE og FS TTLTrg 1 Ir E E8481A Matrix Module Figure 3 2 Scanning Using TTL Trigger Bus Lines 42 Using the Matrix Module Chapter 3 Programming with Chapter 3 HTBasic Figure 3 2 shows how to connect the matrix module to the E1412A multimeter module The connections shown with dotted lines are not actual hardware connections These connections indicate how the E1406A firmware operates to accomplish the triggering For this example Row 00 High and Low of the E8481A matrix module is connected to the multimeter s High and Low The columns are then scanned and different DUTS are switched in for a measurement This example program was written in HTBasic programming language It configures the multimeter E1412A for DC voltage measurements sets the matrix module to scan channels on row 00 columns 00 through 15 The E1412A multimeter has a GPIB address of 70903 and the matrix module has a logical address of 112 GPIB address of 70914 10 DIM Rdgs 1 16 Dimension a variable to Store readings 20 OUTPUT 70903 RST CLS Reset the dmm and clear its Status r
13. 103 Agilent E8481A User s Manual Index 117 Notes 118 Agilent E8481A User s Manual Index Manual Part Number E8481 90001 Printed in U S A E0912 Agilent Technologies e ET 200 a eos
14. RELays Do diagnostic to find the specific error s TEST EEPRom card num Check the integrity checksum of EEPROM on the specified module DISPlay MONitor CARD card num AUTO Select a module in a switchbox to be monitored MONitor CARD Query which module is set by above command MONitor STATe mode Set the monitor state on or off MONitor STATe Query the monitor state setting INITiate CONTinuous ON OFF Enables disables continuous scanning CONTinuous Query continuous scan state IMMediate Starts a scanning cycle OUTPut ECLTrgn STATe ON OFF 1 0 Enable disable the specified ECL trigger line pulse ECLTrgn STATe Query the specified ECL trigger line state EXTernal STATe ON OFF 1 0 Enable disable the Trig Out port on the command module EXTernal STATe Query the Trig Out port enable state TTLTrgn STATe ON OFF 1 0 Enable disable the specified TTL trigger line pulse TTLTrgn STATe Query the specified TTL trigger line state ROUTe CLOSe channel list Close channel s CLOSe channel list Query channel s closed FUNCtion card num mode Set the module function mode single 4x32 matrix or dual 4x16 maitres FUNCtion card num Query the current function mode of the specified module OPEN channel list Open channel s OPEN channel list Query channel s opened PATTern ACTivate card num patt num Load the specified pattern into re
15. SPOLL 70914 150 PRINT Waiting for scan to complete 160 END WHILE 170 SPOLL 70914 128 returned indicates scan has completed 180 PRINT Scan complete spoll l 190 END Using the Matrix Module 47 Example Using the Scan Complete Bit C C 48 Using the Matrix Module include lt visa h gt include lt stdio h gt include lt stdlib h gt Interface logical address is 112 module secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session int scan Scan Complete Bit Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Set timeout value for the module viSetAttribute E8481A VI VALUE 1000000 Reset the module and clear its status registers errStatus viPrintf E8481A RST CLS n if Vl SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Enable the Scan Complete Bit errStatus viPr
16. a SORES Logical Address 113 Eon o E Card Number 03 Fy F Ge Se i Matrix Switch Module al a BEES Logical Address 114 o C3 TOSS Note Physical placement of the module in the logical address order is not required but is recommended N D Figure 1 2 Card Numbers in a Multiple modules Switchbox 14 Getting Started Chapter 1 Channel Number Initial Operation Example Closing a Channel HTBasic Example Closing a Channel C C Chapter 1 The channel number rrcc of the channel list identifies which relay on the selected module will be addressed The channel numbers are row number rr 00 03 two digits column number cc 00 31 two digits For example CLOS 10214 will close channel relays on row 02 column 14 of an E8481A module Use the following example programs to perform the initial operation on the E8481A module To run the programs an Agilent E1406A command module is required Also you must download the E8481A SCPI driver into the E1406A command module and have the Agilent SICL Library the VISA extensions and an Agilent 82350 GPIB card installed and properly configured in your PC In the examples the computer interfaces to the mainframe via GPIB The GPIB interface select code is 7 the GPIB primary address is 09 and the E8481A module is at logical address 112 secondary address 112 8 14 Refer to the Agilent E1406A Command Module User s G
17. return errStatus Get readings from multimeter errStatus viQueryf E1412A FETC W 16lf readings SUCCESS gt errStatus printf ERROR viQueryf returned 0x x n errStatus return errStatus Display measurement results for loop 0 loop lt 16 loop printf Reading d is lf n loop readings loop Close the E8481A instrument session errStatus viClose E84814 if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 Close the multimeter instrument session errStatus viClose E1412A if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Chapter 3 Using the Scan Complete Bit Example Using the Scan Complete Bit Chapter 3 HTBasic You can use the Scan Complete bit bit 8 in the Operation Status Register in the command module of a switchbox to determine when a scanning cycle completes no other bits in the register apply to the switchbox Bit 8 has a decimal value of 256 and you can read it directly with the STATus OPERation EVENt command See Page 84 in Chapter 4 for more information When enabled by the STAT OPER ENAB 256 command the Scan Complete bit will be reported as bit 7 of
18. CH0303 7 CH0315 14 CH0313 CH0312 1 CH0310 CH0309 CH0308 8 CH0023 CH0022 CH0021 CH0020 CH0016 CH0017 CH0018 CH0019 9 CH0031 CH0030 CH0029 CH0028 CH0027 CH0026 CH0025 CH0024 10 CH0123 CH0122 CHO121 CH0120 CHO116 CHO117 CH0118 CH0119 11 CH0131 CH0130 CH0129 CH0128 CH0127 CH0126 CH0125 CH0124 12 CH0223 CH0222 CH0221 CH0220 CH0216 CH0217 CH0218 CH0219 13 CH0231 CH0230 CH0229 CH0228 CH0227 CH0226 CH0225 CH0224 14 CH0323 CH0322 CH0321 CH0320 CH0316 CH0317 CH0318 CH0319 15 CH0331 CH0330 CH0329 CH0328 CH0327 CH0326 CH0325 CH0324 108 Register Based Programming Appendix B There are three registers used to access the 8 kB NVRAM They are e Address Register base 38 e Data Register base 3A Pattern Recall Register base 3 NVRAM Address NVRAM Address Register is at offset address 384 It is used to specify Register the address space in the NVRAM to be accessed Refer to Table B 2 for the description of the addresses This register can also be read back base 38 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write 0000 1FFF Read NVRAM Data Register NVRAM Data Register is at offset address 3A It is used to set the state pattern The data written to this register will be stored into the corre
19. CONTinuous ROUTe SCAN TRIGger Stopping a Scan with ABORt This example stops a continuous scan in progress TRIG SOUR BUS BUS is trigger source ON Set continuous scanning SCAN 10000 10003 Set channel list to be scanned INIT Start scan close channel 10000 ABOR Abort scan in progress Chapter 4 ARM Subsystem Syntax ARM COUNt Parameters Comments Example Chapter 4 The ARM subsystem selects the number of scanning cycles 1 to 32 767 for each INITiate command ARM COUNt number MIN MAX COUNt MIN MAX ARM COUNt number MIN MAX allows scanning cycles to occur a multiple of times 1 to 32 767 with one INITiate command when INITiate CONTinuous OFF 0 is set MIN sets 1 cycle and MAX sets 32 767 cycles Name Type Range of Values Default Value number numeric 1 32 767 MIN MAX 1 Number of Scans Use only values between 1 to 32767 MIN or MAX for the number of scanning cycles Related Commands ABORt INITiate IMMediate INITiate CONTinuous RST Condition ARM COUNt 1 Setting Ten Scanning Cycles This example sets the relay matrix to scan channels 10000 through 10003 for ten times ARM COUN 10 Set 10 scanning cycles SCAN 10000 10003 Scan channels 10000 to 10003 INIT Start scan close channel 10000 Command Reference 57 ARM COUNt Parameters Comments Example 58 Command Reference ARM COU
20. Module include lt stdio h gt include lt stdlib h gt C C Module logical address is 112 secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session char id string 256 ID string char m desp 256 Module description char m type 256 Module type Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Reset the matrix module and clear the status registers errStatus viPrintf E8481A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query the module ID string errStatus viQueryf E8481A IDN n t id string if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf ID is s n id_string Query the module description errStatus viQueryf E8481A SYST CDES 1 n t m_desp if VI SUCCESS gt errStatus printf ERROR viQuer
21. NC COL 22L COL 23L ROWB 1H NC ROWB 2H COL 24L COL 25L NC COL 26L NC COL 27L NC COL 28L NC COL 29L NC COL 30L NC COL 31L ROWB 3H Group B B Pint gt n n Pin32 o Figure 2 3 Agilent E8481A Matrix Switch Connectors Pinout Configuring the Module ROWB 0L COL 16H COL 17H NC COL 18H NC COL 19H NC COL 20H NC COL 21H NC COL 22H COL 23H ROWB 1L NC ROWB 2L COL 24H COL 25H NC COL 26H NC COL 27H NC COL 28L NC COL 29H NC COL 30H NC COL 31H ROWB 3L C Pint u Pin32 0 NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC 21 Screw Type Figure 2 4 shows the Option 106 screw type terminal module connectors Terminal Module and associated row column designators Mating to the J1 and J2 connectors on the front panel of the E8481A J1 J2 a A aS TTT peleepeeee eejleeleelee Paeaeaeq HL HL AVE HL H EL HL H L LOG OE H
22. Reference 69 ROUTe The ROUTe command subsystem controls switching and scanning operations for the matrix switch modules in a switchbox It is also used to control the 8 kB NVRAM on the PC board of the module where up to 511 state patterns can be stored Subsystem Syntax ROUTe CLOSe channel list CLOSe channel list FUNCtion card num mode FUNCtion card num OPEN channel list OPEN channel list PATTern ACTivate card num pattern num ACTivate card num CLOSe channel list CLOSe channel list NUMBer card num pattern num NUMBer card num OPEN channel list OPEN channel list SCAN channel list ROUTe CLOSe 70 ROUTe CLOSe channel list closes the channels specified in the channel list The channel list is in the form of ssrrcec where ss card number 01 99 Ir matrix row number and cc matrix column number Parameters Name Type Range of Values Items numeric 01 99 card ss channel list numeric 00 03 row rr numeric 00 31 column cc Comments Closing Channels To close a single channel use CLOS ssrrcc multiple channels use CLOS ssrrcc ssrrcc sequential channels use CLOS ssrrcc ssrrcc groups of sequential channels use CLOS ssrrcc ssrrcc ssrrcc ssrrcc or any combination of the above Closure order for multiple channels with a sing
23. SOUR EXT SCPI also allows several commands within the same subsystem to be linked with a semicolon For example ROUT CLOS 100 ROUT CLOS 9100 P Or ROUT CLOS 9100 CLOS 99100 SCPI Command Reference Chapter 4 This section describes the Standard Commands for Programmable Instruments SCPI reference commands for the Matrix Switch module Commands are listed alphabetically by subsystem and also within each subsystem Command Reference 55 ABORt Subsystem Syntax Comments Example 56 Command Reference The ABORt command stops a scan in progress when the scan is enabled via the interface and the trigger source is either TRIGger SOURce BUS or TRIGger SOURce HOLD ABORt ABORt Actions The ABORt command terminates the scan and invalidates the current channel list When the ABORt command is executed the last channel closed during scanning remains in the closed position Affect on Scan Complete Status Bit Aborting a scan will not set the scan complete status bit Stopping Scan Enabled Via Interface When a scan is enabled via an interface and the trigger source is neither HOLD nor BUS an interface clear command CLEAR 7 or viClear function in VISA can be used to stop the scan When the scan is enabled via the interface and TRIGger SOURce BUS or HOLD is set you can use ABORt command to stop the scan Restarting a Scan Use the INIT command to restart the scan Related Commands ARM INITiate
24. SUCCESS Using State Patterns to Switch Channels NOTE Example Using a State Pattern to Switch Channels HTBasic 34 Using the Matrix Module To improve the switching throughput an 8 kB non volatile RAM is provided on the module allowing to store up to 511 state patterns for all 128 channels Then you can operate the channel relays with the stored pattern whenever you required In this way switching all 128 channels is almost as fast as switching a single channel The following example programs were written in HTBasic and Visual C C languages respectively Each uses a state pattern to operate the channel relays They first reset the module to open all channels of the module then set channels state in a pattern including select a pattern number open all channels in the pattern then close some of the channels in the pattern After having finished the pattern setting you can use the saved pattern to operate the channels whenever you require For the related SCPI commands used in these examples see ROUTe PATTern subsystem on Page 74 of this manual If you want to learn more about the pattern structure in the NVRAM see NVRAM Control Registers on page 107 of this manual Before setting querying channels open closed state in a pattern you must use PATT NUMB command to select a pattern first 10 DIM Ch PatStat bO Ch Stat bO Err num 256 Dimension three string variables 20 OUTPUT 70914 R
25. TRIGger IMMediate SOURce BUS SOURce EXTernal SOURce HOLD SOURce IMMediate SOURce TTLTrgn SOURce Causes a trigger to occur Trigger source is TRG Trigger source is Trig In port on the E1406A Hold off triggering Trigger source is the internal triggers Trigger is the VXIbus TTL trigger bus line n 0 7 Query scan trigger source 92 Command Reference Chapter 4 IEEE 488 2 Common Command Reference The following table lists the IEEE 488 2 Common Commands that can be accepted by the matrix module Command Command Description CLS Clears all status registers see STATus OPERation EVENt and clears the error queue ESE unmask Enable Standard Event ESE Enable Standard Event Query ESR Standard Event Register Query IDN Instrument ID Query returns identification string of the module OPC Operation Complete OPC Operation Complete Query RCL numeric state Recalls the instrument state saved by SAV You must reconfigure the scan list RST Resets the module Opens all channels and invalidates current channel list for scanning Sets ARM COUN 1 TRIG SOUR IMM and INIT CONT OFF SAV numeric state Stores the instrument state but does not save the scan list SRE register value Service request enable enables status register bits SRE Service request enable query STB Read statu
26. a reasonable time to repair or replace any product to a condition as warranted customer will be entitled to a refund of the purchase price upon prompt return of the product 4 Agilent products may contain remanufactured parts equivalent to new in performance or may have been subject to incidental use 5 The warranty period begins on the date of delivery or on the date of installation if installed by Agilent If customer schedules or delays Agilent installation more than 30 days after delivery warranty begins on the 31st day from delivery 6 Warranty does not apply to defects resulting from a improper or inadequate maintenance or calibration b software interfacing parts or supplies not supplied by Agilent c unauthorized modification or misuse d operation outside of the published environmental specifications for the product or e improper site preparation or maintenance 7 TO THE EXTENT ALLOWED BY LOCAL LAW THE ABOVE WARRANTIES ARE EXCLUSIVE AND NO OTHER WARRANTY OR CONDITION WHETHER WRITTEN OR ORAL IS EXPRESSED OR IMPLIED AND AGILENT SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OR CONDITIONS OF MERCHANTABILITY SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE 8 Agilent will be liable for damage to tangible property per incident up to the greater of 300 000 or the actual amount paid for the product that is the subject of the claim and for damages for bodily injury or death to the extent that all such damages are det
27. configures the multimeter for DC voltage measurements sets the matrix module to scan channels on row 00 columns 00 through 15 include lt visa h gt include lt stdio h gt include lt stdlib h gt Interface logical address is 112 module secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR Interface address for E1412 Multimeter define MULTI ADDR GPIBO 9 3 INSTR int main ViStatus errStatus ViSession viRM ViSession E8481A ViSession E1412A Status from each VISA call Resource manager session Module session Multimeter session Se SSS int loop char opc_int 21 double readings 16 loop counter OPC variable Reading storage SY SD Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the matrix module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Open the multimeter instrument session errStatus viOpen viRM MULTI_ADDR VI NULL VI NULL amp E14124 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Set timeout value for multimeter and matrix module viSetAttribute E1412A VI
28. continuous scanning of channels 10000 through 10003 of a single module switchbox Since TRIGger SOURce IMMediate default is set use an interface clear command such as CLEAR 7 to stop the scan INIT CONT ON Enable continuous scanning SCAN 10000 10003 Set channel list to be scanned INIT Start scan close channel 10000 64 Command Reference Chapter 4 INITiate CONTinuous Example INITiate CONTinuous queries the scanning state With continuous scanning enabled the command returns 1 ON With continuous scanning disabled the command returns 0 OFF Querying Continuous Scanning State INIT CONT ON Enable continuous scanning INIT CONT Query continuous scanning state It returns 1 ON INITiate IMMediate Chapter 4 Comments Example INITiate IMMediate starts the scanning process and closes the first channel in the channel list Successive triggers from the source specified by the TRIGger SOURce command advances the scan through the channel list Starting the Scanning Cycle The INITiate IMMediate command starts scanning by closing the first channel in the channel list Each trigger received advances the scan to the next channel in the channel list An invalid channel list generates an error see ROUTe SCAN on Page 80 Stopping Scanning Cycles Refer to the ABORt command Related Commands ABORt ARM COUNt INITiate CONTinuous TRIGger TRIGger SOURce Enabling a Single Scan Thi
29. matrixes See Function Modes on page 12 for more information As shown in Figure 1 1 two 2 wire 4x16 matrixes Group A amp Group B are implemented on the E8481A module PC board which contains 128 2 wire nodes or crosspoints Each crosspoint in the matrix uses two Form A non latching relays to switch both High H and Low L signals By closing or opening the appropriate channel relays the row is connected to or disconnected from the column Multiple switch relays can be closed at a time allowing any combination of rows connected to columns Since the relays are nonlatching the channel relays are all open during power up power down or following a reset Getting Started 11 Row 03 Row 02 Row 01 Row 00 Group A Column 00 15 Group B Column 16 31 A 7 Row 03 0300 0301 HR m 0305 0308 0307 MN 0310 0311 0314 031 MON 326 0327 0321 MU 0331 Ped ast ooi osid SER 0321 eae Row 02 0200 0201 HR m aie 0207 0208 0209 0210 0211 0214 021 SE aie Row 0 1 0100 0101 dad rid 0107 0108 0109 0110 0111 0114 011 ea fo ata 0227 022 ME obs 0231 021 des dd du Tm 0116 0117 0118 0119 HUE alodus 0126 0121 012 0131 9999 0000 0001 000 ood ood a 0008 0007 Am um 0010 0011 0014 ootd oot 001s oid 0017 rcm m RETE IR 0027 002 0024 0031 coo C01 C02 C04 5 07 C08
30. or or Frame re ground CAUTION condition that could possibly cause damage to CONDECIS TO E GUIDEDE ene a equipment or permanent loss of data WARNINGS The following general safety precautions must be observed during all phases of operation service and repair of this product Failure to comply with these precautions or with specific warnings elsewhere in this manual violates safety standards of design manufacture and intended use of the product Agilent Technologies assumes no liability for the customer s failure to comply with these requirements Ground the equipment For Safety Class 1 equipment equipment having a protective earth terminal an uninterruptible safety earth ground must be provided from the mains power source to the product input wiring terminals or supplied power cable DO NOT operate the product in an explosive atmosphere or in the presence of flammable gases or fumes For continued protection against fire replace the line fuse s only with fuse s of the same voltage and current rating and type DO NOT use repaired fuses or short circuited fuse holders Keep away from live circuits Operating personnel must not remove equipment covers or shields Procedures involving the removal of covers or shields are for use by service trained personnel only Under certain conditions dangerous voltages may exist even with the equipment switched off To avoid dangerous electrical shock DO NOT perform procedu
31. the Status Byte Register Use the GPIB Serial Poll or the IEEE 488 2 Common Command STB to read the Status Byte Register When bit 7 of the Status Register is enabled by the SRE 128 Common Command to assert a GPIB Service Request SRQ you can interrupt the computer when the Scan Complete bit is set after a scanning cycle completes This allows the computer to do other operations while the scanning cycle is in progress The following example programs were written in HTBasic and Visual C C programming language respectively It monitors bit 7 of the Status Byte Register to determine when the scanning cycle is complete The computer interfaces with the E1406A command module over GPIB The GPIB select code is 7 the GPIB primary address is 09 and the GPIB secondary address is 14 10 OUTPUT 70914 RST CLS Reset and clear the matrix 20 OUTPUT 70914 STATUS OPER ENABLE 256 Enable Scan Complete Bit 30 OUTPUT 70914 TRIG SOUR IMM Set the matrix for internal triggering 40 OUTPUT 70914 SCAN 10000 10015 Set up channel list to scan 50 OUTPUT 70914 OPC Wait for operation complete 60 ENTER 70914 A 70 PRINT 70914 OPC 80 OUTPUT 70914 STB Query status byte register 90 ENTER 70914 A 100 PRINT Switch Status A 110 OUTPUT 70914 INIT Start scan cycle and close the channel 10000 120 20 130 WHILE I 20 Stay in loop until value returned from the command SPOLL 70914 140 1
32. the matrix module observe anti static techniques whenever removing or installing a module or whenever working on a module Configuring the Module 17 Setting the Logical Address The logical address switch LADDR factory setting is 112 Valid address values are from 1 to 255 Refer to Figure 2 1 for the address switch position and setting information NOTE The address switch selected value must be a multiple of 8 if the module is the first module in a switchbox used with a VXIbus command module and being instructed by SCPI commands 4 bs TE LR d 4 die cues J Logical Address a lt Switch Location Pi 64 32 16 112 0 1 01234567 OO Tt CO C t logical Address 112 e JDB V Figure 2 1 Setting the Logical Address Switch 18 Configuring the Module Chapter 2 Setting the Interrupt Priority Chapter 2 NOTE The E8481A module generates an interrupt after a channel has been closed These interrupts are sent to and acknowledgments are received from the command module Agilent E1406A via the VXIbus backplane interrupt lines For most applications the default interrupt priority line should not have to be changed This is because the VXIbus interrupt lines have the same priority and int
33. to VXI backplane interrupt lines 1 through 7 When power on or reset the module the default interrupt line is 1 Querying Module s Interrupt Line DIAG INT LIN 1 1 Set the interrupt line of module 1 to line 1 DIAG INT LIN 1 Query the module s interrupt line DIAGnostic TEST RELays Comments WARNING Example DIAGnostic TEST RELays causes the instrument to perform a self test which includes writing to and reading from all relay registers and verifying the correct values A failure may indicate a potential hardware problem Returned Value Returns 0 if all tests passed otherwise the card fails Error Codes If the card fails the returned value is in the form 100 card number error code Error codes are Internal driver error 2 VXI bus time out 3 Card ID register incorrect 5 Card data register incorrect 10 Card did not interrupt 11 Card busy time incorrect 40 Relay register read and written data don t match Disconnect any connections to the module when performing this function Perform Diagnostic Test to Check Error s DIAG TEST Returned 0 indicates that the system has passed the self test otherwise the system has an error 60 Command Reference Chapter 4 DIAGnostic TEST SEEProm Parameters Comments Chapter 4 Example DIAGnostic TEST SEEProm lt card_numbers checks the integrity checksum of the serial EEPROM on the module Return value of 0 if n
34. 004 or decimal 49 152 112 64 49 152 7168 56 320 h C000 A16 Address Space 0000 h Base Address C000 Logical Address 64 or 49 152 Logical Address 64 Register Address Base Address Register Offset Description Pattem Recall Fegister NVRAM Data Register NVRAM Address Register e e e e Register 2E Relay Control Register 16 padres ac Space C000 49 152 12 10 Relay Control Register 1 e e e e e ID Fegister Figure B 1 Registers within A16 Address Space Numbers with a subscripted h are in hexadecimal format Numbers without the subscripted h are in decimal format 98 Register Based Programming Appendix B A16 Address Space When the A16 address space is inside the Agilent E1406A command Inside the Command module Figure B 2 the module s base address is computed as Module or Mainframe 1FC0004 LADDR 404 or decimal 2 080 768 LADDR 64 where 1 FC000 2 080 768 is the starting location of the register addresses LADDR is the module s logical address and 64 40 is the number of address bytes per register based device Again the module s factory set logical address is 112 70 If this address is not changed the module will have a base address of 1FC000 70 405 2 1FC000 1C00 1IFDCO00j or decimal 2 080 768
35. 09 CH0108 Read Relay Control Register for Channels 0200 0207 base 18 base 18 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0207 CH0206 CH0205 CH0204 CH0200 CH0201 CH0202 CH0203 Read Relay Control Register for Channels 0208 0215 base 1A base 1A Write CH0215 CH0214 CH0213 CH0212 CH0211 CH0210 CH0209 CH0208 Read Relay Control Register for Channels 0300 0307 base 1C base 1C 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0307 CH0306 CHO0305 CH0304 CHO0300 CH0301 CH0302 CH0303 Read Appendix B Register Based Programming 105 Relay Control Register for Channels 0308 0315 base 1E base 1E 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0315 CH0314 CH0313 CH0312 CHO0311 CH0310 CHO0309 CHO0308 Read Relay Control Register for Channels 0016 0023 base 20 base 20 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0023 CH0022 CH0021 CH0020 CH0016 CH0017 CH0018 CH0019 Read Relay Control Register for Channels 0024 0031 base 22 base 22 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0031 C
36. 1 10201 Open relays on row 01 column 01 and on row 02 column 01 of the module ROUTe JOPEN channel list returns the current state of the channel s queried The channel list is in the form of ssrrcc The command returns 1 if channel s are open or returns 0 if channel s are closed If a list of channels is queried a comma delineated list of O or 1 values is returned in the same order of the channel list Query is Software Readback The ROUTe OPEN command returns the current software state of the channel s specified It does not account for relay hardware failures Channel list Definition See ROUTe OPEN command on page 73 for the channel list definition Command Reference 73 NOTE A maximum of 128 channels be queried at one time Therefore if you want to query more than 128 channels you must enter the query data in two separate commands Example Querying Channel Open States This example opens channels 10101 and 10201 of a single module switchbox and queries channel 10201 state Since channel 10201 is programmed to be open 1 is returned OPEN 10101 10201 Open relays on row 01 column 01 and on row 02 column O1 of the module OPEN 10201 Query channel open state ROUTe PATTern ACTivate ROUTe PATTern ACTivate lt card_num gt lt pattern_num gt is used to operate the channel relays with the specified state pattern previously stored in the non volatile RAM NVRAM of the mo
37. 1 99 rr matrix row number and cc matrix column number Name Type Range of Values Items numeric 01 99 card ss channel list numeric 00 03 row rr numeric 00 31 column cc Defining Scan List When ROUTe SCAN is executed the channel list is checked for valid card and channel numbers An error is generated for an invalid channel list Scanning Channels To scan a single channel use SCAN ssrrcc multiple channels use SCAN ssrrcc ssrrcc sequential channels use SCAN ssrrcc ssrrcc groups of sequential channels use SCAN ssrrcc ssrrcc ssrrcc ssrrcc or any combination of the above Scanning Operation When a valid channel list is defined INITiate IMMediate begins the scan and closes the first channel in the channel list Successive triggers from the source specified by TRIGger SOURce advance the scan through the channel list At the end of the scan the last trigger opens the last channel Stopping Scan See ABORt command on page 56 Related Commands TRIGger TRIGger SOURce RST Condition All channels are open Scanning Channels Using External Triggers This example uses external triggering TRIG SOUR EXT to scan channels 10000 through 10003 of a single module switchbox The trigger source to advance the scan is the input to the Trig In on the E1406A command module When INIT is executed the scan is started and channel 0000 is closed Then each trigg
38. 15 Example Closing a Channel eee 15 Example Closing a Channel 15 Chapter 2 Configuring the Module s ssiccieccdscsccsssccsssessetectecncssencesoassssechonvcocodcsacsegessevoesseanedesseseesess 17 About Lhis Chapter ia ree eie e Here EE EHE shea EUER ete ER 17 Warnines and Cautions e oit eee is taba en ot eti e Ee 17 Setting the Logical Address uiid os eoi tacui 18 Setting the Interrupt Priority esses eene 19 Installing the Matrix Switch Module in a Mainframe eee 20 Connecting User RTL ea ferta a ta Le 21 Connectors Pinot nep et a ete iari p Rede e epe 21 Screw Type Terminal Module eene 22 SMB Type Terminal Module eese essent tenente 23 Wiring a Terminal Module BE nennen enne 24 Attaching a Terminal Module to the Matrix Module 26 Chapter 3 Using the Matrix Module e eere ceres ee ee eee eee etta estan seen sete an tees ease ennen se 27 About This Chapters echte Pie e D eL Pe ct t EHE e etn 27 Power On and Reset Conditions eese 28 Module Identification tee rettet let deg Ie tee tite teet Ce eta Ce Pa te ate 28 Example Identifying Module HTBasic eee 28 Example Identifying Module C C eee 29 Setting Module Fu
39. 26 Available Terminal Modules 21 Base Address 97 Block Diagram simplified schematic 12 Boolean Command Parameter 54 language example programs closing a single channel 15 closing multiple channels 33 identifying the module 29 scanning channels using Trig In Out ports 39 scanning channels with TTL trigger 44 setting module function mode 31 system configuration 27 using scan complete bit 48 using state pattern 35 Card Number 14 Channel addresses 13 number 15 closing channels 15 32 34 Command Format common 53 SCPI 53 Command Module A16 address space inside the 99 A16 address space outside the 98 programming with 27 Command Reference IEEE 488 2 Common 93 SCPI 55 91 Commands ROUTt subsystem 70 80 abbreviated 54 ABORt 56 ARM subsystem 57 58 DIAGnostic subsystem 59 61 DISPlay subsystem 62 63 IEEE 488 2 common 93 implied 54 INITiate subsystem 64 65 linking Common Commands with SCPI 55 linking multiple SCPI commands 55 OUTPut subsystem 66 69 parameter types 54 separator 53 STATus subsystem 81 84 SYSTem subsystem 85 87 TRIGger subsystem 88 90 types of 53 Variable 54 Common Commands CLS 93 ESE 93 ESE 93 ESR 93 IDN 93 OPC 93 OPC 93 RCL 93 RST 93 SAV 93 SRE 93 SRE 93 STB 93 TRG 93 TST 93 WAI 93 format 53 Quick Reference 93 Agilent E8481A User s Manu
40. 4x16 matrixes Name Type Range of Values Default Value 01 99 N A lt card_num gt numeric Related Commands ROUTe FUNCtion Querying Module Function Mode This example configures the module 1 as a 4x32 Matrix then queries the setting FUNC 1 SINGLE4X32 FUNC 1 Configure module 1 as a 4x32 Matrix SINGLE4X32 returned indicates the module functions as an 4x32 matrix Chapter 4 ROUTe OPEN Parameters ROUTe OPEN Chapter 4 Comments Example Comments ROUTe OPEN channel list opens the channels specified in the channel list The channel list is in the form of Gssrrcc where ss card number 01 99 rr matrix row number and cc matrix column number Name Type Range of Values Items numeric 01 99 card ss channel list numeric 00 03 row rr numeric 00 31 column cc Opening Channels To open a single channel use OPEN ssrrcc multiple channels use OPEN ssrrcc ssrrcc sequential channels use OPEN ssrrcc ssrrcc groups of sequential channels use OPEN ssrrcc ssrrcc ssrrcc ssrrcc or any combination of the above Opening order for multiple channels with a single command is not guaranteed Related Commands ROUTe CLOSe ROUTe JOPEN RST Condition All channels are open Opening Multiple Channels This example opens channels 10101 and 10201 of a single module switchbox OPEN 1010
41. 6 0323 2Ch R W base 2C Relay Control Register CH 0324 0331 2E R W base 2E NVRAM Address Register 384 R W base 384 NVRAM Data Register 3A R W base 3A Pattern Recall Register 3C R W base 3C Appendix B Register Based Programming 101 NOTE Undefined register bits shown as x in the Tables return as 1 when the register is read and have no effect when written to ID Reg ister The Manufacturer Identification Register is at offset address 004 Reading the register returns FFFF indicating the manufacturer is Agilent Technologies and the module is an A16 register based device base 00 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write Manufacturer ID returns FFFF in Agilent Technologies 16 only register based card Device Type The Device Type Register is at offset address 02 Reading the register Reg ister returns 02D1 indicating that the device is an E8481A module base 02 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write Read 0201 Status Control The Status Control Register is at offset address 044 It is used to control the Regi ster module and inform the user of its status base 04 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write 2 X IRQ E D x S Reset Read P x MS x B IRQ E D x 1 P x
42. Agilent Technologies E8481A 2 Wire 4x32 Relay Matrix Switch Module User s Manual ES Agilent Technologies Manual Part Number E8481 90001 Printed in Malaysia E0912 NOTICE In August 2014 Agilent Technologies former Test and Measurement business became Keysight Technologies This document is provided as a courtesy but is no longer kept current and thus will contain historical references to Agilent For more information goto www keysight com KEYSIGHT TECHNOLOGIES Contents Agilent E8481A User s Manual AGILENT TECHNOLOGIES WARRANTY STATEMENT eer 7 NEWSTIN HE 8 WARNINGS ated t ier RERO ad 8 Declaration of Conformity cee 9 1 Getting Started retten tete neenon eate Fes Cere paa engen ee signo Veo eese Sosse s brava apio Ue ea aeos 11 About This Chapter tette pet e etre tede a 11 Agilent E8481A Module Description eese ene nnne 11 simplified Schematle i eite eI eee a pee te e E REI E e get 11 Function utn ee eee le eiae globes 12 Typical Configuration 12 Instrument Definition c e he e treten Hee ete Hei 13 Programming the 8 p e de ed ee eec ero 13 Specifying SCPI Commands eese enne 13 Channel Addtesses nda m Sein ee Aare ento 13 Initial Oper tion sis ede eh deeded he n Decade
43. C09 C10 C11 C12 C13 C14 C15 C16 C17 C18 C19 C20 C21 C22 C23 C24 C25 C26 C27 C28 C29 C30 C31 Row 00 d CHO0005 z 2097 pu E 3 Figure 1 1 Agilent E8481A Simplified Schematic Function Modes NOTE NOTE Typical Configuration 12 Getting Started When shipped from the factory the E8481A is configured as a 4x32 2 wire Matrix Switch module All columns 00 31 are switched to rows 00 03 of Group with 50 MHz bandwidth By disconnecting the rows of the Group and the Group B with SCPI command ROUTe FUNCtion the module can be reconfigured as two independent 4x16 matrixes In such case columns 00 15 are switched to rows 00 03 of Group A and columns 16 31 are switched to rows 00 03 of Group B with bandwidth up to 70 MHz For more information about the related SCPI commands see ROUTe FUNCtion on page 72 of this manual You can also change the function mode by directly writing to the NVRAM Data Register of the module see Setting Module Function Mode on page 109 of this manual for details At power up down or reset the module will not change the function mode set for it unless another ROUTe FUNCtion command is executed to change the mode DO NOT make connections on the rows 00 03 connectors of Group B when in the 4x32 configuration These connectors are used only when in the Dual 4x16 configuration For a Standard Commands for Programmable I
44. Channel Channel with 50Q termination Hi to Lo Hi to Chassis Lo to Chassis 4 x 16 Configuration lt 100 KHz lt 5 MHz lt 50 MHz lt 100 pF lt 100 pF lt 300 pF 70 MHz lt 65 dB lt 50 dB lt 27 dB a 10 mA 1 Vdc resistive load b When more than 8 crosspoints are closed add 0 34 W per crosspoint to the specified power dissipation 13 W and 0 027 liter sec to the air flow 1 1 Liter sec 96 8481 Specifications Appendix A Appendix B Register Based Programming About This Appendix The Agilent E8481A 4x32 2 wire Matrix Switch module is a register based product which does not support the VXIbus word serial protocol When a SCPI command is sent to the matrix the instrument driver resident in the Agilent E1406A command module parses the command and programs the matrix at the register level Register based programming is a series of reads and writes directly to the module registers This increases throughput speed since it eliminates command parsing and allows the use of an embedded controller Also register programming provides an avenue for users to control a VXI module with an alternate VXI controller device and eliminate the need for using an E1406A command module This appendix contains the information you need for register based programming The contents include Register Addressing susan sa eee 97 Registers Description 101 Register Add
45. Channels 0116 0123 base 244 Relay Control Register for Channels 0124 0131 base 264 Relay Control Register for Channels 0216 0223 base 284 Relay Control Register for Channels 0224 0231 base 2 Relay Control Register for Channels 0316 0323 base 2C Relay Control Register for Channels 0324 0331 base 2E The Relay Control Registers bit definitions are listed as below 104 Register Based Programming Appendix B Relay Control Register for Channels 0000 0007 base 10 base 10 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0007 CH0006 CH0005 CH0004 CH0000 CH0001 CH0002 CH0003 Read Relay Control Register for Channels 0008 0015 base 12 base 12 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0015 CH0014 CH0013 CH0012 CH0011 CH0010 CH0009 CH0008 Read Relay Control Register for Channels 0100 0107 base 14 base 144 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0107 CH0106 CH0105 CH0104 CH0100 CH0101 CH0102 CH0103 Read Relay Control Register for Channels 0108 0115 base 16 base 164 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0115 CH0114 CH0113 CH0112 CH0111 CH0110 CH01
46. H0030 CH0029 CH0028 CH0027 CH0026 CH0025 CH0024 Read Relay Control Register for Channels 0116 0123 base 24 base 24 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0123 CH0122 CH0121 CH0120 CH0116 CH0117 CH0118 CH0119 Read Relay Control Register for Channels 0124 0131 base 26 base 26 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CHO0131 CH0130 CH0129 CH0128 CH0127 CH0126 CH0125 CH0124 Read Relay Control Register for Channels 0216 0223 base 28 base 28 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0223 CH0222 CH0221 CH0220 CH0216 CH0217 CH0218 CH0219 Read Relay Control Register for Channels 0224 0231 base 2A base 2A 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0231 CH0230 CH0229 CH0228 CH0227 CH0226 CH0225 CH0224 Read 106 Register Based Programming Appendix B Relay Control Register for Channels 0316 0323 base 2C base 2 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0323 CH0322 CH0321 CH0320 CH0316 CH0317 CH0318 CH0319 Read Relay Control Register for Channels 0324 0331 base 2E base 2E 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write CH0331 CH0330 CH0329 CH0328 CH0327 CH0326 CH0325 CH0324 Read NVRAM Control Registers Appendix B NOTE All these relay control registers are readable writable R W registers The numbers sh
47. L NC COL 3L NC COL 4L NC COL 5L NC COL 6L COL 7L ROWA 1H NC ROWA 2H COL 8L COL 9L NC COL 10L NC COL iiL NC COL 12L NC COL 13L NC COL 14L NC COL 15L ROWA 3H Group A Pint gt 0 Pin32 0 ROWA OL COL 0H COL 1H NC COL 2H NC COL 3H NC COL 4H NC COL 5H NC COL 6H COL 7H ROWA 1L NC ROWA 2L COL 8H COL 9H NC COL 10H NC COL 11H NC COL 12L NC COL 13H NC COL 14H NC COL 15H ROWA 3L Pint gt o Pin32 gt NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC NC A Pint gt 0 MENER a G j 2 WIRE 4X32 Pin1 o migi MATRIX v a Te e eT n eee eee a E eee eee i Group J1 0 eee eee eee E a eee a eee eee eee ec 2 m a ABC A Pin1 Pnt ABC w wee I eee 1 7 eee eee eee n GroupB 4 eee eee a MM J2 N eee Pin32 a eee eee eee eee eee eee eee eee eee j L Chapter 2 A Pint gt 1 n n M Ping2 ROWB OH COL 16L COL 17L NC COL 18L NC COL 19L NC COL 20L NC COL 21L
48. Module 1 for Editing PATT NUMB 1 1 Select Pattern 1 of Module 1 to store channels state ROUTe PATTern NUMBer ROUTe PATTern NUMBer card num returns the current pattern number set by PATT NUMB The returned value should be between 0 and 510 See Page 107 of this manual for more details on the pattern structure in the module s NVRAM Parameters Name Type Range of Values Default value card num numeric 1 99 N A Comments Related Commands ROUTe PATTern NUMBer Example Querying Which Pattern is Selected for Editing This example selects state pattern 10 in the NVRAM of module 1 for editing then queries the setting PATT NUMB 1 10 Select pattern 10 of the module 1 to be written to PATT NUMB 1 10 is returned Chapter 4 Command Reference 77 ROUTe PATTern OPEN NOTE Parameters Comments Example ROUTe PATTern OPEN channel list is used to set the specified channel s to the open state in the state pattern of the module s NVRAM Before setting you must use PATT NUMB command to select a pattern number 0 510 This command does not really open the specified channel relays To operate channel relays with the stored state pattern use PATT ACT command For more information about the state patterns in the see Page 107 of this manual The channel_list is in the form of ssrrcc where ss card number 01 99 rr matrix row number and cc matrix co
49. Nt lt MIN MAX gt returns the current number of scanning cycles set by ARM COUNt The current number of scan cycles is returned when MIN or MAX parameter is not specified With MIN or MAX as a parameter 1 is returned for the MIN parameter or 32767 is returned for the MAX parameter regardless of the ARM COUNt value set Name Type Range of Values Default Value lt MIN MAX gt numeric MIN 1 MAX 32 767 current cycles Related Commands INITiate IMMediate Querying Number of Scanning Cycles This example sets 10 scanning cycles then queries the setting ARM COUN 10 Set 10 scanning cycles per INIT command ARM COUN Query number of scanning cycles Chapter 4 DIAGnostic The DIAGnostic subsystem is used to control the module s interrupt capability including disabling the interrupt selecting an interrupt line In addition some potential failure may be identified with this subsystem Subsystem Syntax DIAGnostic INTerrupt LINE card numbers line number LINE card number TEST RELays SEEProm card number DIAGnostic INTerrupt LINe DIAGnostic INTerrupt LINe card number line number sets the interrupt line of the specified module The card number specifies which E8481A in a multiple module switchbox is being referred to The line number can be 1 through 7 corresponding to VXI backplane interrupt lines 1 through 7 NOTE Changing the i
50. Programming Appendix B Registers Description The E8481A Matrix Switch module contains 23 registers as shown in Table B 1 You can write to the writable W registers and read from the readable R registers This section contains a description of the registers followed by a bit map of the registers in sequential address order Table B 1 Module Registers Registers Addr Offset R W Register Address Manufacturer ID Register 00 R base 00 Device Type Register 024 R base 02 Status Control Register 04 R W base 04 Interrupt Selection Register 0C R W base 0C Relay Control Register CH 0000 0007 10 R W base 10 Relay Control Register CH 0008 0015 12 R W base 12 Relay Control Register CH 0100 0107 14 R W base 14 Relay Control Register CH 0108 0115 16 R W base 16 Relay Control Register CH 0200 0207 18 R W base 18 Relay Control Register CH 0208 0215 1A R W base 1A Relay Control Register CH 0300 0307 1C R W base 1C Relay Control Register CH 0308 0315 1E R W base 1E Relay Control Register CH 0016 0023 20 R W base 20 Relay Control Register CH 0024 0031 22h R W base 22 Relay Control Register CH 0116 0123 24 R W base 24 Relay Control Register CH 0124 0131 26 R W base 264 Relay Control Register CH 0216 0223 28 R W base 28 Relay Control Register CH 0224 0231 2Ap R W base 2A Relay Control Register CH 031
51. R VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Reset the module errStatus viPrintf E8481A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query closure state of channel 0002 after a reset errStatus viQueryf E8481A ROUT CLOS 10002 n t ch_stat if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf After reset chan 10002 state is s n ch stat Close channel 0002 of card 1 errStatus viPrintf E8481A CLOS 10002 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query closure state of channel 0002 errStatus viQueryf E8481A ROUT CLOS 10002 n t ch_stat if VI SUCCESS gt errStatus printf ERROR viQueryf returned 0x x n errStatus return errStatus printf Now channel 10002 state is s n ch_stat Using the Matrix Module 33 Close the module instrument session errStatus viClose E8481A if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 return VI
52. RS 232 terminal will cause the DISPlay MONitor STATe to automatically be set to OFF 0 Use of the OFF parameter is useful only if the command is issued over the GPIB interface Selecting the Module to be Monitored Use the DISPlay MONitor CARD command to select the module Monitor Mode for the E8481A When monitoring mode is turned on the hexadecimal numbers sixteen 16 bits representing all channel states will be displayed at the bottom of the terminal These numbers correspond to the contents of the sixteen Relay Control Registers from base 12 to base 2E see Relay Control Registers on page 104 for more information Each channel uses two bits The bits that are 11 represent the related channel is closed The bits that are 00 indicate the related channel is open For example the display below shows that relays at row 0 columns 0 1 row 1 columns 6 7 and row 3 columns 16 31 are closed OOFO 0000 0000 F000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 FFFF FFFF RST Condition DISPlay MONitor STATe OFF 0 Enabling the Monitor Mode for Module 2 DISP MON CARD 2 Select module 2 to be monitored DISP MON ON Turn on monitor mode DISPlay MONitor STATe Chapter 4 DISPlay MONitor STATe queries the monitor mode state whether it is set to ON or OFF Command Reference 63 INITiate The INITiate command subsystem selects continuous scanning cycles and starts the scanning cycle S
53. ST CLS Reset the module and clear Status registers 30 OUTPUT 70914 PATT NUMB 1 10 Select pattern 10 of module 1 40 OUTPUT 70914 PATT OPEN 210000 10331 Set all 128 channels in pattern 10 to the open state Chapter 3 Example Using a State Pattern to Switch Channels Chapter 3 C C 50 OUTPUT 70914 PATT CLOS 10000 10101 10202 Set channels 10000 10101 and 10202 to the closure state in pattern 10 60 OUTPUT 70914 PATT CLOS 10000 10101 10202 Query to verify the settings in pattern 10 70 ENTER 70914 Ch_PatStat Enter the result into the variable 80 PRINT The channel states in Pattern 10 Ch_PatStat 1 1 1 should be displayed 90 OUTPUT 70914 ROUT CLOS 10000 10101 10202 Query to verify the actual state of these channels 100 ENTER 70914 Ch Stat Enter the result into Ch Stat 110 PRINT Channel States Stat 0 0 0 should be displayed 120 OUTPUT 70914 PATT ACT 1 10 Recall pattern 10 to operate all channels of module 1 130 OUTPUT 70914 ROUT CLOS 10000 10101 10202 Query to verify the closure state of these channels 140 ENTER 70914 Ch_Stat Enter the result into the variable 150 PRINT Channel States Ch_Stat 1 1 1 should be displayed 160 OUTPUT 70914 SYST ERR Check for a system error 170 ENTER 70914 Err_num Enter the error into Err num 180 PRINT Error Err num Print error if any 190 END include l
54. T 70914 CLOS 910001 Verify that the channel is closed 60 ENTER 70914 A 70 IF A21 THEN 80 OUTPUT 70903 MEAS VOLT DC When channel is closed make the measurement 90 ENTER 70903 Meas value 100 PRINT Meas value Print the measured value 110 ELSE 120 PRINT CHANNEL DID NOT CLOSE 130 END IF 140 END Chapter 3 Using the Matrix Module 51 Notes 52 Using the Matrix Module Chapter 3 Chapter 4 Command Reference Using This Chapter This chapter describes Standard Commands for Programmable Instruments SCPI and summarizes IEEE 488 2 Common commands applicable to the module See the Agilent E1406A Command Module User s Manual for additional information on SCPI and common commands This chapter contains the following sections Command 53 SCPI Command Reference 55 SCPI Command Quick 91 IEEE 488 2 Common Command Reference 93 Command Types Common Command Format SCPI Command Format Command Separator Chapter 4 Commands are separated into two types IEEE 488 2 Common Commands and SCPI Commands The IEEE 488 2 standard defines the common commands that perform functions such as reset self test status byte query and so on Common commands are four or five characters in length always begin with an asterisk and may include one or more parameters The com
55. TTern CLOSe 75 ROUTe PATTern CLOSe 76 ROUTe PATTern NUMBer 77 ROUTe PATTern NUMBer 77 ROUTe PATTern OPEN 78 ROUTe PATTern OPEN 79 ROUTe SCAN 80 ABORt 56 ARM subsystem 57 58 ARM COUNt 57 ARM COUNt 58 DIAGnostic INTerrupt LINe 59 DIAGnostic INTerrupt LINe 60 DIAGnostic TEST SEEProm 61 DIAGnostic TEST RELays 60 DIAGnostics subsystem 59 61 DISPlay subsystem 62 63 DISPlay MONitor CARD 62 DISPlay MONitor CARD 62 DISPlay MONitor STATe 63 DISPlay MONitor STATe 63 INITiate subsystem 64 65 INITiate CONTinuous 64 INITiate CONTinuous 65 INITiate IMMediate 65 OUTPut subsystem 66 69 OUTPut ECLTrgn STATe 66 OUTPut ECLTrgn STATe 67 OUTPut TTLTrgn STATe 68 OUTPut TTLTrgn STATe 69 OUTPut EXTernal STATe 67 OUTPut EXTernal STATe 68 S continued SCPI Command Reference continued STATus subsystem 81 84 STATus OPERation CONDition 83 STATus OPERation ENABle 83 STATus OPERation ENABle 83 STATus OPERation EVENt 84 STATus PRESet 84 SYSTem subsystem 85 87 SYSTem CDEScription 85 SYSTem CPON 85 SYSTem CTYPe 86 SYSTem ERRor 86 SYSTem VERSion 87 TRIGger subsystem 88 90 TRIGger SOURce 89 TRIGger SOURce 90 TRIGger IMMediate 88 Separator command 53 Single module Switchbox 14 Specifications 95 State Patterns using to switch channels 34 STATus subsystem 81 84 Status System Register Bloc
56. VALUE 1000000 viSetAttribute E8481A VI VALUE 1000000 Reset the multimeter clear status system errStatus viPrintf E1412A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus 44 Using the Matrix Module Chapter 3 Chapter 3 Configure multimeter for DCV measurements 12 V max min resolution errStatus viPrintf E1412A CONF VOLT 12 MIN n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set multimeter to be triggered by TTL Trigger Line 0 errStatus viPrintf E1412A TRIG SOUR TTLTO n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Enable the dmm pulses TTL trigger line I on measurement complete errStatus viPrintf E1412A OUTP TTLT1 ON n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set trigger delay time to I ms trigger count to 16 errStatus viPrintf E1412A TRIG DEL 0 001 COUN 16 SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Pause until multimeter is ready errStatus viQueryf E1412A OPC n t opc int SUCCESS gt errStatus print ERROR viQueryf returned errStatus return errStatus nitia
57. al Index 113 C continued Configuration function mode 12 30 72 109 interrupt priority 19 logical address 18 Connecting Terminal Module to the Matrix 26 User Inputs 21 Connectors Pinout diagram 21 Screw Type Terminal 22 SMB Type Terminal 23 D declaration of conformity 9 Description general information 11 Detecting Error Conditions 51 Device Type Register 102 DIAGnostic subsystem 59 61 DIAGnostic INTerrupt LINe 59 DIAGnostic INTerrupt LINe 60 DIAGnostic TEST SEEProm 61 DIAGnostic TEST RELay 60 Disable continuous scanning 64 ECL Trigger Bus Line 66 interrupts 59 103 Trig Out port 67 TTL Trigger Bus Line 68 Discrete Command Parameter 54 DISPlay subsystem 62 63 DISPlay MONitor CARD 62 DISPlay MONitor CARD 62 DISPlay MONitor STATe 63 DISPlay MONitor STATe 63 documentation history 8 E ECL Trigger query state of 67 setting 66 Enable continuous scanning 64 ECL Trigger Bus Line 66 interrupts 59 103 Trig Out port 67 TTL Trigger Bus Line 68 Error example program 51 messages list of 111 numbers list of 111 querying 86 Event Register 84 Examples Closing a Single Channel 15 Closing Multiple Channels 32 Identifying Module 28 Querying Errors 51 Saving and Recalling Instrument State 50 Scanning Channels Using Trig In Out Ports 37 Scanning Channels Using TTL Trigger 42 Setting module function mode 30 Synchronizing the Instruments 51 U
58. and While the trigger is in use by the SWITCH driver no other drivers operating on the E1406A command module will have access to that particular trigger source Likewise other drivers may consume trigger resources which may deny access to a particular trigger by the SWITCH driver Command Reference 89 Example Example When Trigger Source is HOLD You can use TRIGger IMMediate command to advance the scan when TRIGger SOURce HOLD is selected Trig Out Port Shared by Switchboxes See the OUTPut on page 66 for more information Related Commands ABORT ROUTe SCAN OUTPut RST Condition TRIGger SOURce IMMediate Scanning Using External Triggers This example uses external triggering TRIG SOUR EXT to scan channels 10000 through 10003 of a single module switchbox The trigger source to advance the scan is the input to the Trig In on the E1406A command module When INIT is executed the scan is started and channel 0000 is closed Then each trigger received at the Trig In port advances the scan to the next channel TRIG SOUR EXT Set trigger source to external SCAN 10000 10003 Set channel list to be scanned INIT Start scanning cycle and close channel 10000 trigger externally Advance scan to next channel Scanning Using Bus Triggers This example uses bus triggering TRIG SOUR BUS to scan channels 10000 through 10003 of a single module switchbox The trigger source to advance the scan is the TRG
59. ation ENABle unmask command allows only bit 8 to generate a summary bit The decimal value for bit 8 is 256 The decimal values are also used in the inverse manner to determine which bits are set from the total value returned by an EVENt or CONDition query The relay matrix module driver exploits only bit 8 of Operation Status Register This bit is called the scan complete bit which is set whenever a scan operation completes Since completion of a scan operation is an event in time you will find that bit 8 will never appear set when STATus OPERation CONDition is queried However you can find bit 8 set with the STATus OPERation EVENt query command Chapter 4 Command Reference 81 NOTE Queue tionable Data ge Available SRQ Interface Bus Service Request Standard Event Register ESR ro ESE unmask 1 ESE Status Byte Register Automatically Set at Power On 0 lt i gt e Power On Conditions User Request 1 2 5 Command Error 4 2 4 s Automatically Set by TTT Execution Error 4 3 lt 8 gt DN DA Device Dependent Erro
60. ation of Conformity link Notes Chapter 1 Getting Started About This Chapter This chapter describes the Agilent E8481A 2 wire 4x32 Matrix module contains information on how to program it using SCPI Standard Commands for Programmable Instruments commands and provides an example program to check initial operation Chapter contents are Agilent E8481A Module Description 11 Instrument Definition 13 Programming the Matrix 13 Initial Operation 15 Agilent E8481A Module Description Chapter 1 Simplified Schematic The Agilent E8481A 4x32 2 wire Matrix Switch module is a VXIbus C Size register based product which can operate in a C Size V XIbus mainframe It offers highly flexible switching for testing devices allowing multiple test instruments connected to multiple test points on a device or to multiple devices It is ideal for switching signals to the oscilloscopes counters and signal sources in the test systems To improve the switching throughput an 8 kB non volatile RAM is provided on the module allowing to store up to 511 state patterns for all 128 channels of the module See Page 107 of this manual for more information on the module s NVRAM and state patterns structure In addition to a single 2 wire 4x32 matrix the E8481A can be easily reconfigured as two independent 2 wire 4x16
61. atus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Reset the module errStatus viPrintf E8481A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Close channel 0002 errStatus viPrintf E8481A CLOS 10002 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query state of channel 0002 errStatus viQueryf E8481A ROUT CLOS 10002 n t state if Vl SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf Channel State is s n state Close the module instrument session errStatus viClose E8481A if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Chapter 1 Chapter 2 Configuring the Module About This Chapter This chapter shows how to configure the Mat
62. canning Command parameters are set to the default conditions as shown below Table 3 1 E8481A Default Conditions for Power on and Reset Parameter Default Description ARM COUNt 1 Number of scanning cycles is 1 TRIGger SOURce IMM Advances through a scanning list automatically INITiate CONTinuous OFF Continuous scanning is disabled OUTPut ECLTrgn STATe OFF Trigger output from ECL trigger line is disabled OUTPut EXTernal STATe OFF Trigger output from Trig Out port is disabled OUTPut TTLTrgn STATe OFF Trigger output from TTL trigger line is disabled Module Identificati Example Identifying Module HTBasic 28 Using the Matrix Module on The following example programs use the RST CLS IDN SYST CTYP and SYST CDES commands to reset and identify the Matrix module 10 DIM 50 50 50 Dimension three string variables to fifty characters 20 OUTPUT 70914 RST CLS Reset the module and clear Status registers 30 OUTPUT 70914 IDN Query module identification 40 ENTER 70914 A Enter the result into A 50 OUTPUT 70914 SYST CDES 1 Query for module description 60 ENTER 70914 B Enter the result into B 70 OUTPUT 70914 SYST CTYP 1 Query for module type 80 ENTER 70914 C Enter the result into C 90 PRINT A B C Print the contents of the 100 END variable A B and C Chapter 3 Example include lt visa h gt Identifying
63. card in a switchbox that is not part of the switchbox 2001 Invalid channel number Attempting to address a channel of a module in a switchbox that is not supported by the module e g channel 99 of matrix module 2006 Command not supported Sending a command to a module card in a switchbox that is on this card unsupported by the module 2008 Scan list not initialized Executing an INIT command without a channel list defined 2009 Too many channels in Attempting to address more channels than available in the channel list switchbox 2011 Empty channel list Channel lists contain no valid channels 2012 Invalid Channel Range Invalid channel s specified in SCAN lt channel_list gt command Attempting to begin scanning when no valid channel list is defined 2600 Function not supported Sending a command to a module card in a switchbox that is on this card not supported by the module or switchbox 2601 Missing parameter Sending a command requiring a channel list without the channel_list Appendix C Error Messages 111 Notes 112 Error Messages Appendix C Index A A16 Address Space 97 99 inside command module 99 outside command module 98 Abbreviated SCPI Commands 54 ABORt Command 56 Address A16 address space 97 base address 97 channel address 13 logical 18 98 99 register address 97 secondary 13 27 ARM subsystem 57 58 ARM COUNt 57 ARM COUNt 58 Attaching Terminal Module to the Matrix
64. ceptable forms Other forms of TRIGger such as TRIGG or TRIGGE will generate an error You may use upper or lower case letters Therefore TRIGGER trigger and TrigGeR are all acceptable Implied Implied commands are those which appear in square brackets in the command Commands syntax Note that the brackets are not part of the command and are not sent to the instrument Suppose you send a second level command but do not send the preceding implied command In this case the instrument assumes you intend to use the implied command and it responds as if you had sent it Examine the partial ROUTe subsystem shown below ROUTe CLOSe channel list The root command ROUTe is an implied command To make a query about channel s present status you can send either of the following command statements ROUT CLOS channel list or CLOS channel list Variable Some commands have what appears to be a variable syntax For example mman Co ands OUTPut TTLTrgn In this command the is replaced by a number range from to 7 No space is left between the command and the number because the number is part of the command syntax instead of a parameter Parameters Parameter Types The following table contains explanations and examples of parameter types you might see later in this chapter Parameter Type Explanations and Examples Numeric Accepts all commonly used decimal representations of number including optional si
65. command as set with TRIGger SOURce BUS When INIT is executed the scan is started and channel 10000 is closed Then each TRG command advances the scan to the next channel TRIG SOUR BUS Set trigger source to bus SCAN 10000 10003 Set channel list to be scanned INIT Start scanning cycle and close channel 10000 loop statement Loop to scan all channels TRG Advance scan to next channel Increment loop Increment loop count TRIGger SOURce Example 90 Command Reference TRIGger SOURce returns the current trigger source for the switchbox Command returns BUS EXT HOLD IMM ECLTO 1 or TTLTO 7 for sources BUS EXTernal HOLD IMMediate ECLTrgn or TTLTrgn respectively Querying Trigger Source This example sets external triggering and queries the trigger source Since external triggering is set TRIG SOUR returns EXT TRIG SOUR EXT Set external trigger source TRIG SOUR Query trigger source Chapter 4 SCPI Command Quick Reference The following table summarizes the SCPI commands for the E8481A Module Command Description ABORt ABORt Abort a scan in progress ARM COUNt number MIN MAX Multiple scans per INIT command COUNt MIN MAX Query number of scans DIAGnostic INTerrupt LINe card num line num Set an interrupt line for the specified module INTerrupt LINe card num Query the interrupt line of the specified module TEST
66. d bit 6 0 Writing to the When writing to the status control register the following bits are of Status Control Register importance Soft Reset bit 0 Writing a 1 to this bit will force the module to reset all channels open NOTE When writing to the registers it is necessary to write 0 to bit O after the reset has been performed before any other commands can be programmed and executed SCPI commands take care of this automatically Sysfail Inhibit bit 1 Writing a 1 to this bit will disable the module from driving the SYSFAIL line all channels open The Slot 0 module can detect the failed module via this line nterrupt Enable Disable bit 6 Writing a 1 to this bit will disable the module from sending an interrupt request generated by operating relays Writing a 0 to this bit will enable the module s interrupt capability NOTE Typically interrupts are only disabled to peek poke a module Refer to your command module s operating manual before disabling the interrupt Appendix B Register Based Programming 103 Interrupt Selection Register The Interrupt Selection Register is at offset address OC It is used to set the interrupt level of the module and inform the user of the current interrupt level of the module base 0C 12 11 10 9 8 7 6 5 4 3 2 1 0 Write x Interrupt Level Read x Interrupt Level NOTE
67. d TTLTrg4 will become the active output Related Commands ROUTe SCAN TRIGger SOURce RST Condition OUTPut EXTernal STATe OFF port disabled Example Enabling Trig Out Port OUTP ON Enable Trig Out port to output pulse after each scanned channel is closed OUTPut EXTernal STATe OUTPut EXTernal STATe queries the present state of the Trig Out port on the E1406A command module The command returns 1 if the port is enabled or 0 if disabled Example Querying Trig Out Port State OUTP ON Enable Trig Out port for pulse output OUTP Query port enable state OUTPut TTLTrgn STATe OUTPut TTLTrgn STATe mode selects and enables which TTL Trigger bus line 0 to 7 will output a trigger when a channel is closed during a scan This command is also used to disable a selected TTL Trigger bus line 1 specifies the TTL Trigger bus line 0 to 7 and mode enables ON or 1 or disables OFF or 0 the specified TTL Trigger bus line Parameters Name Type Range of Values Default Value n numeric 0to7 N A mode boolean ON OFF 1 0 OFF 0 Comments Enabling TTL Trigger Bus When enabled a pulse is output from the selected TTL Trigger bus line 0 to 7 after each channel is closed during a scan If disabled a pulse is not output from the selected TTL Trigger bus line after channel closures The output is a negative going pulse TTL Trigger Bus Line Shared by Switchbo
68. dule It can also return the types and descriptions of modules in a switchbox SYSTem CDEScription card number CPON card number ALL CTYPe card number ERRor VERSion SYSTem CDEScription Parameters Comments Example SYSTem CPON Parameters Comments Chapter 4 SYSTem CDEScription card numbers returns the description of a selected module in a switchbox Name Type Range of Values Default Value card number numeric 1 99 N A Module Description The SYSTem CDEScription card number command returns Dual Wire 4 x 32 Matrix Switch Reading the Description of Module 1 SYST CDES 1 Return the description of module 1 SYSTem CPON card number ALL resets the selected module or multiple modules in a switchbox Name Type Range of Values Default Value card number numeric 1 99 or ALL N A Module Power on State The power on state of the module is all channels relays open Note that SYSTem CPON ALL and RST opens all channels of all modules in a switchbox while SYSTem CPON lt number gt opens the channels in only the module specified in the command Command Reference 85 Example Setting Module 1 to its Power on State SYST CPON 1 Set module 1 to its power on state All channels are open SYSTem CTYPe SYSTem CTYPe lt card_number gt returns the module type of a selected module in a switchbox Paramete
69. dule See Page 107 of this manual for more details of the state patterns in the NVRAM Parameters Name Type Range of Values Default value lt card_num gt numeric 01 99 N A lt pattern_num gt numeric 0 510 N A Comments This command consists of a series of data fetching from the specified address space then expanding and putting these data into the corresponding Relay Control Registers The module will set the BUSY bit of the Status Control Register to 1 during the whole operation and set the BUSY bit to 0 after all the relays are stable Using this command for switching Switching all 128 channels of the module is almost as fast as switching a single channel Related Commands ROUTe PATTern OPEN ROUTe PATTern CLOSe ROUTe PATTern ACTivate Example Using State Pattern to Switch Channels This example recalls the previously stored Pattern 10 to operate channel relays of module 1 PATT ACT 1 10 Recall state pattern 10 to operate channel relays of the module 1 74 Command Reference Chapter 4 ROUTe PATTern ACTivate Parameters Comments Example ROUTe PATTern ACTivate lt card num gt returns the pattern number set by the PATTern ACTivate command The returned value should be between 0 and 510 See Page 107 of this manual for more details on the pattern structure in the NVRAM of the module Name Type Range of Values Default value lt card_num gt num
70. dule you must specify the appropriate SCPI command and matrix channel addresses Table 1 1 Commands lists the most commonly used commands Refer to Chapter 4 of this manual for a complete list of SCPI commands used for the matrix switch module Table 1 1 Commonly Used SCPI Commands SCPI Commands Commands Description CLOSe lt channel_list gt Closes the relay s specified OPEN lt channel_list gt Opens the relay s specified SCAN lt channel_list gt Closes a set of relays one at a time Channel Addresses Only valid channel addresses can be included in a channel_list For the E8481A the channel address has the form of ssrrcc where ss card number 01 99 rr row number of the matrix 00 03 cc column number of the matrix 00 31 To specify a channel_list use the form of ssrrcc for a single channel ssrrcc ssrrcc for multiple channels Chapter 1 Getting Started 13 ssrrcc ssrrcc for sequential channels Ossrrcc ssrrcc ssrrec ssrrcc for groups of sequential channels or any combination of the above NOTE Only valid channels can be accessed in a channel list or channel range Channel numbers can be entered in the channel list in any random order However the channel range must be from a lower channel number to a higher channel number For example CLOS 10000 10312 is acceptable but CLOS 10312 10000 generates an error Card Number The card number ss of the chann
71. e Ny Figure 2 6 Wiring a Terminal Module continued on next page 24 Configuring the Module Chapter 2 X 6 Replace Clear Cover A Hook in the top cover tabs onto the fixture B Press down and tighten screws Er 7 Attach the Terminal Module to the Matrix see Figure 2 7 for more information Extraction Levers Use a small Screwdriver to release the two extraction levels E8481A Module k 9 Push the Levers Lock the Terminal Module onto the Matrix Module A N Extraction S VR Notes Be sure the wires make good connections on the terminal modules DO NOT make connections on the RowB 0 through RowB 3 connectors when in 4x32 mode To remove the terminal module from the E8481A use a small screwdriver to release the two extraction levels and push both evels out simultaneously to free it from the E8481A Matrix Module Chapter 2 Figure 2 6 Wiring a Terminal Module Configuring the Module 25 Attaching Figure 2 7 shows how to attach a terminal module to the E8481A Relay Terminal Module to Matrix Switch module the Matrix Module D Extend the Extraction Levels on the Terminal Module Extraction Lever Use a small screwdriver to release the two extrac
72. e lt stdio h gt include lt stdlib h gt Interface logical address is 112 Matrix secondary address is 14 define INSTR_ADDR GPIBO 9 14 INSTR interface address for 34401A Multimeter define MULTI ADDR GPIBO 22 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session ViSession dmm Multimeter session int loop loop counter int opc_int OPC variable double readings 16 Reading storage Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the matrix module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Open the multimeter instrument session errStatus viOpen viRM MULTI_ADDR VI NULL VI NULL amp dmm SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Using the Matrix Module 39 40 Using the Matrix Module Set timeout value for multimeter and matrix module viSetAttribute dmm VI_ATTR_TMO_VALUE 1000000 viSetAttribute E8481A VI VALUE 1000000 Reset the multimeter and clear its status registers errStat
73. e 83 STATus OPERation EVENt Comments Example STATus PRESet 84 Command Reference STATus OPERation EVENt returns which bits in the Event Register Operation Status Group are set The Event Register indicates when there has been a time related instrument event Setting Bit 8 of the Operation Status Register Bit 8 scan complete is set to 1 after a scanning cycle completes Bit 8 returns to 0 after sending the STATus OPERation EVENt command Returned Data after sending the STATus OPERation EVENt Command The command returns 256 if bit 8 of the Operation Status Register is set to 1 The command returns 0 if bit 8 of the Operation Status Register is set to 0 Event Register Cleared Reading the Event Register with the STATus OPERation EVENt command clears it Aborting a Scan Aborting a scan will leave bit 8 set to 0 Related Commands ROUTe SCAN Reading Operation Status Register After a Scanning Cycle STAT OPER Return the bit values of the Operation Status Register 256 returned shows bit 8 is set to 1 0 shows bit S is set to 0 STATus PRESet affects only the Enable Register by setting all Enable Register bits to 0 It does not affect either the status byte or the standard event status PRESet does not clear any of the Event Registers Chapter 4 SYSTem Subsystem Syntax The SYSTem subsystem returns the error numbers and error messages in the error queue of a matrix mo
74. egisters 30 OUTPUT 70914 RST CLS Reset the matrix module and clear its status registers 40 OUTPUT 70903 CONF VOLT 12 MIN Set the dmm for DCV measurement 12 V max min resolution 50 OUTPUT 70903 OUTP TTLT1 STAT ON Set the dmm pulses TTL trigger line I on measurement complete 60 OUTPUT 70903 TRIG SOUR TTLTO Set the dmm to be triggered by TTL trigger line 0 70 OUTPUT 70903 TRIG DEL 0 01 Set the dmm trigger delay time to 10 ms 80 OUTPUT 70903 TRIG COUN 16 Set the dmm trigger count to16 90 OUTPUT 70903 OPC Check to see if dmm ready 100 ENTER 70903 Check 110 OUTPUT 70903 INIT Set the dmm to the wait for trigger state 120 OUTPUT 70914 DUTP TTLTO STAT ON Set the matrix pulses TTL trigger line 0 on channel closed 130 OUTPUT 70914 TRIG SOUR TTLT1 Set the matrix to be triggered by TTL Trigger line 1 140 OUTPUT 70914 SCAN 10000 10015 Define channel list row 00 columns 00 15 to be scanned 150 OUTPUT 70914 INIT Initialize scan and close channel 10000 160 OUTPUT 70903 FETCH Read measurement results from the dmm 170 ENTER 70903 Rdgs Enter measurement results 180 PRINT Rdgs Display measurement results 190 END Using the Matrix Module 43 Programming with C C following program was written and tested in Microsoft Visual C using the VISA extensions but should compile under any standard ANSI C compiler This example
75. el list identifies which module within a switchbox will be addressed The card number assigned depends on the switch configuration used Leading zeroes can be ignored for the card number Single module Switchbox In a single module switchbox configuration the card number is always 01 Multiple module Switchbox In a multiple module switchbox configuration modules are set to successive logical addresses The module with the lowest logical address is always card number 01 The module with the next successive logical address is card number 02 and so on Figure 1 2 illustrates the card numbers and logical addresses of a typical multiple module switchbox installed in an Agilent C Size mainframe with an Agilent command module d Multiple Module Switchbox Card Numbers FEE a Card Number 01 gg Matrix Switch Module Command Logical Address 112 Module I e FH Secondary Address 14 5 0 e o mit i aa o Card Number 02 2 gin Ie Mo eh Matrix Switch Module
76. er received at the Trig In port advances the scan to the next channel TRIG SOUR EXT Set trigger source to external SCAN 10000 10003 Set channel list to be scanned INIT Start scanning cycle and close channel 10000 trigger externally Advance scan to next channel Chapter 4 STATus The STATus subsystem reports the bit values of the Operation Status 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 Subsystem Syntax STATus OPERation CONDiition ENABle unmask ENABIe EVENt PRESet The STATus system contains four registers that is they reside in a SCPI driver not in the hardware two of which are under IEEE 488 2 control the Standard Event Status Register ESE and the Status Byte Register STB The Operational Status bit OPR Service Request bit RQS Standard Event Summary bit ESB Message Available bit MAV and Questionable Data bit QUE in the Status Byte Register bits 7 6 5 4 and 3 respectively can be queried with the STB command Use the ESE command to query the unmask value for the Standard Event Status Register the bits you want logically OR d into the summary bit The registers are queried using decimal weighted bit values The decimal equivalents for bits 0 through 15 are included in Figure 4 1 on page 82 A numeric value of 256 executed in a STATus OPER
77. eric 01 99 N A Related Commands ROUTe PATTern ACTivate Querying Which Pattern is Activated This example uses state pattern 10 to operate all channels of the module 1 then verify which pattern is being loaded PATT ACT 1 10 Recall pattern 10 data to operate channel relays of the module 1 PATT ACT 1 Query which pattern is being loaded 10 is returned ROUTe PATTern CLOSe NOTE Parameters Chapter 4 ROUTe PATTern CLOSe channel list is used to set the specified channel s to the closed state in the state pattern of the module s NVRAM Before setting you must use PATT NUMB command to select a pattern number 0 510 for storing This command does not really close the specified channel relays To operate channel relays with the stored state pattern use PATT ACT command For more information about the state patterns in the NVRAM see Page 107 of this manual The channel list is in the form of ssrrcc where ss card number 01 99 rr matrix row number and cc matrix column number This command only changes the specified channels state in the selected pattern and does not affect other channel states of the pattern Once the channel states are stored in a pattern they will not change at power on or reset As a consequence the user should be aware of the pattern s previous value when editing Name Type Range of Values Items numeric 01 99 card ss channel list numeric 00 03 row
78. ermined by a court of competent jurisdiction to have been directly caused by a defective Agilent product 9 TO THE EXTENT ALLOWED BY LOCAL LAW THE REMEDIES IN THIS WARRANTY STATEMENT ARE CUSTOMER S SOLE AND EXLUSIVE REMEDIES EXCEPT AS INDICATED ABOVE IN NO EVENT WILL AGILENT OR ITS SUPPLIERS BE LIABLE FOR LOSS OF DATA OR FOR DIRECT SPECIAL INCIDENTAL CONSEQUENTIAL INCLUDING LOST PROFIT OR DATA OR OTHER DAMAGE WHETHER BASED IN CONTRACT TORT OR OTHERWISE FOR CONSUMER TRANSACTIONS IN AUSTRALIA AND NEW ZEALAND THE WARRANTY TERMS CONTAINED IN THIS STATEMENT EXCEPT TO THE EXTENT LAWFULLY PERMITTED DO NOT EXCLUDE RESTRICT OR MODIFY AND ARE IN ADDITION TO THE MANDATORY STATUTORY RIGHTS APPLICABLE TO THE SALE OF THIS PRODUCT TO YOU U S Government Restricted Rights The Software and Documentation have been developed entirely at private expense They are delivered and licensed as commercial computer software as defined in DFARS 252 227 7013 Oct 1988 DFARS 252 211 7015 May 1991 or DFARS 252 227 7014 Jun 1995 as a commercial item as defined in FAR 2 101 a or as Restricted computer software as defined in FAR 52 227 19 Jun 1987 or any equivalent agency regulation or contract clause whichever is applicable You have only those rights provided for such Software and Documentation by the applicable FAR or DFARS clause or the Agilent standard software agreement for the product involved Agilent Technologies E8481A 2 W
79. errupt priority is established by installing modules in slots numerically closest to the command module Thus slot 1 has a higher priority than slot 2 slot 2 has a higher priority than slot 3 etc By default the interrupt priority level is Level 1 It can be set to any one of the VXI backplane lines 1 7 corresponding to Levels 1 7 either by sending SCPI or directly writing to the Interrupt Selection Register Level 1 is the lowest priority and Level 7 is the highest priority The interrupt can also be disabled at power up after a SYSRESET or by sending SCPI or directly writing to the Status Control Register See Page 59 of this manual for more details of the related SCPI commands For more information about register writing see Register Based Programming on page 97 of this manual Changing the interrupt priority level is not recommended DO NOT change it unless specially instructed to do so Refer to the E1406A Command Module User s Manual for more details Configuring the Module 19 Installing the Matrix Switch Module in a Mainframe The Agilent E8481A may be installed in any slot except slot 0 in a C size VXIbus mainframe Refer to Figure 2 2 to install the module in a mainframe Fes 3 1 Set the extraction levers out 2 Slide the module into any slot except slot 0 until the backplane connectors touch Extraction Levers 2 3 Seat the module into the
80. ers Description en tree ER Pt tete tee ere Pte eie eas 101 IDE NTUEU S EI cS 102 DEVICE eee 102 Status Control Register a Ee E aE Ea A 102 Interrupt Selection Register eese rene 104 Relay Control Registers 5 pae Here ei a 104 Control Registers eese nennen nennen nnne 107 Appendix C Error MESSAGES REA TEE em 111 AGILENT TECHNOLOGIES WARRANTY STATEMENT AGILENT PRODUCT E8481A 2 wire 4x32 Relay Matrix Switch Module 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 Replacement products may be either new or like new 2 Agilent warrants that Agilent software will not fail to execute its programming instructions for the period specified above due to defects in material and workmanship when properly installed and used If Agilent receives notice of such defects during the warranty period Agilent will replace software media which does not execute its programming instructions due to such defects 3 Agilent does not warrant that the operation of Agilent products will be interrupted or error free If Agilent is unable within
81. gisters to operate relays PATTern ACTivate card num Query which pattern is loaded into the register currently PATTern CLOSe channel list Set the channels to the closed states in the selected pattern PATTern CLOSe channel list Query the specified channels state stored in the selected pattern PATTern NUMBer card num patt num Select a pattern number to store channels state PATTern NUMBer card num Query which pattern is selected to store channels state currently PATTern OPEN channel list Set channels to the open state in the selected pattern PATTern OPEN channel list Query the specified channels state stored in the selected pattern SCAN channel list Define channels to be scanned STATus OPERation CONDition Returns contents of the Operation Condition Register OPERation ENABle unmask Enables events in the Operation Event Register to be reported OPERation ENABle Returns the unmask value set by the ENABle command OPERation EVENt Returns the contents of the Operation Event Register PRESet Sets all Enable Register bits to 0 SYSTem CDEScription number Returns description of module CPON number ALL CTYPe number ERRor VERSion Open all channels on the specified module s Returns the module type Returns error number message in the error queue Returns the version of the SCPI standard Chapter 4 Command Reference 91 Command Description
82. gns decimal points and scientific notation 123 123E2 123 1 23E2 123 1 23E 2 1 23000E 01 Special cases include MINimum MAXimum and DEFault Boolean Represents a single binary condition that is either true or false ON OFF 1 0 Discrete Selects from a finite number of values These parameters use mnemonics to represent each valid setting An example is the TRIGger SOURce source command where source can be BUS EXT HOLD or IMM 54 Command Reference Chapter 4 Linking Commands Optional Parameters Parameters shown within square brackets are optional parameters Note that the brackets are not part of the command and are not sent to the instrument If you do not specify a value for an optional parameter the instrument uses the default value For example consider the ARM COUNt lt MIN MAX gt command If you send the command without specifying a parameter the present ARM COUNt setting is returned If you send the MIN parameter the command returns the minimum count available If you send the MAX parameter the command returns the maximum count available Be sure to place a space between the command and the parameter Linking IEEE 488 2 Common Commands with SCPI Commands Use a semicolon between the commands For example RST CLOS 100 or TRIG SOUR BUS TRG Linking Multiple SCPI Commands Use both a semicolon and a colon between the commands For example ARM COUN1 TRIG
83. grammed to be closed 1 1 is returned CLOS 10101 10201 Close relays on row 01 column 01 and on row 02 column O1 of the module CLOS 10101 10201 Query channels closure state Chapter 4 Command Reference 71 Parameters Comments Example Parameters Comments Example 72 Command Reference ROUTe FUNCtion ROUTe FUNCtion card num mode configures the specified module either as a 4x32 matrix or as two independent 4x16 matrixes The E8481A module is configured as a 4x32 matrix module at the factory Name Type Range of Values Default Value card num numeric 01 99 N A mode Discrete SINGLE4X32 DUAL4X16 SINGLE4X32 Using the Command The module remains in the specified function mode at power up down or after a reset Executing ROUTe FUNCtion command to change the mode After Changing Function Mode Once the function mode is changed all channel relays on the module will be open Related Commands ROUTe FUNCtion Configuring Module Function Mode This example configures the module 1 to function as two independent 4x16 matrixes FUNC 1 DUAL4X16 Configure module 1 as two independent 4x16 matrixes ROUTe FUNCtion ROUTe FUNCtion card num returns the current function mode of the specified module SINGLE4X32 returned indicates the module is configured as a 4x32 Matrix and DUAL4X16 indicates the module is configured as two independent
84. igger source The INITiate IMMediate command enables the trigger source The trigger source must be selected with TRIGger SOURce command before executing the INIT command Using Bus Triggers To trigger the switchbox with TRIGger SOURce BUS selected use the IEEE 488 2 common command TRG or the GPIB Group Execute Trigger GET command or SCPI command TRIGger IMMediate One Trigger Input Selected at a Time Only one input ECLTrg0 or 1 TTLTrgO 1 2 3 4 5 6 or 7 or EXTernal can be selected at one time Enabling a different trigger source will automatically disable the active input For example if TTLTrg1 is the active input and TTLTrg4 is enabled TTLTrg1 will become disabled and TTLTrg4 will become the active input Using TTL or ECL Trigger Bus Inputs These triggers are from the VXI backplane trigger lines ECL 0 1 and TTL 0 7 These may be used to trigger the SWITCH driver from other VXI instruments Using External Trigger Inputs With TRIGger SOURce EXTernal selected only one switchbox at a time can use the external trigger input at the E1406A Trig In port The trigger input is assigned to the first switchbox requesting the external trigger source with a TRIGger SOURce EXTernal command Assigning EXTernal TTLTrgn and ECLTrgn Trigger Inputs After using TRIGger SOURce EXT TTLTn ECLTn the selected trigger source remains assigned to the SWITCH driver until it is relinquished through use of the TRIG SOUR BUS HOLD comm
85. imension a string variable 10 twenty characters Function Mode 20 OUTPUT 70914 RST CLS Reset the module and clear HTBasic status registers 30 OUTPUT 70914 ROUT FUNC 1 DUAL4X16 Set the module as dual 4x16 matrixes 40 OUTPUT 70914 ROUT FUNC 1 Query the function mode 50 ENTER 70914 Func Enter the result into Func 60 PRINT A DUALAX16 will be displayed 70 END 30 Using the Matrix Module Chapter 3 Example Setting Function Mode Chapter 3 C C include lt visa h gt include lt stdio h gt include lt stdlib h gt Module logical address is 112 secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session char func 20 Function mode Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Reset the module errStatus viPrintf E8481A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus
86. ing the Instruments 51 All example programs in this chapter were developed on an external PC using HTBasic or Visual C C as the programming language They are tested with the following system configuration An E1406A command module and an E8481A Matrix module are installed in the mainframe The computer is connected to the E1406A command module via GPIB interface The GPIB select code is 7 the GPIB primary address is 09 and the E8481A module is at logical address 112 secondary address 112 8 z 14 The E8481A SCPI driver had been downloaded into the E1406A command module The SICL Library the VISA extensions and an Agilent 82350 GPIB card had been installed and properly configured in the computer Refer to the Agilent E1406A Command Module User s Guide for more addressing information For more details on the related SCPI commands used in this chapter see Chapter 4 of this manual NOTE Do not do register writes if you are controlling the module by a high level driver such as SCPI or VXIplug amp play This is because the driver will not know the module state and an interrupt may occur causing the driver and or command module to fail Chapter 3 Using the Matrix Module 27 Power On and Reset Conditions At power on or following a reset RST command all channels of the module are open The RST command also invalidates the current scan list that is you must specify a new scan list for s
87. intf E8481A STAT OPER ENAB 256 SUCCESS gt errStatus print ERROR viPrintf returned errStatus return errStatus Set trigger source to IMMediate for internal triggering errStatus viPrintf E8481A TRIG SOUR IMM n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Specify a channel list for scanning errStatus viPrintf E8481A SCAN 10000 10005 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Chapter 3 Start scan and close channel 10000 errStatus viPrintf E8481A INIT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Stay in loop until scan complete for errStatus viQueryf E8481A STB n 96d amp scan printf Waiting for scan to complete if scan amp 0x80 break printf Scan has completed Close the module instrument session errStatus viClose E84814 if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Querying the Matrix Module Chapter 3 All query commands end with a The data is sent to the outpu
88. inuous ee ia 65 INTPEatel IMMeduiate iro eee reete rie eund 65 ncaa aia saa SENDTES Ro ee 66 OUTPut ECLTtren S PATe eta tt lee Geen een ee 66 OUTPut ECETtrgn STATE rt eR 67 OUTPut EXTernal STATe esee nennen 67 OUTPutEEXTernal ESTATE 2 rtr erento 68 OUTPut FTIETren STATS ener eee ed 68 OUTPUT TET rene STATS cocci t Cre Peter ete Pet enun 69 ROU Te 5 td ete d RE tea eer E E EAT TEST 70 ROUTEN OS EE ook etna 70 ROUTe 3CEOSe retin rites eset tette eH LG 71 ROUTe EUNGLOT iiti tercie eot eoe ete er er err eh 72 ROU Ter PUNCHON ives 72 ROUTe OPEN iei ir teer e ett uen i e eee 73 ROUTe OBEN heo pee mee i gre ede i 73 ROUTe PATTerrn AGTivV te teet tele eet 74 ROUTe PATTern ACTiyv te ee eerte rette e reet trees 75 ROUT PAT Tern CEOSE erbe ern tere tor ede 75 ROUTe PATTern CDLOSe reete einen en 76 ROUTe PATTern NUMDBSGr a eter eee Ree TT ROUTe PA TTern NUMDBGE ic iiti etre erectio tret TT ROU Tes PAT Tern neuve re 78 ROUTe PATT rn OPEN eire ee ea Pie ee PERS 79 ROUTE SCAN teet ete eb ee b eet ree tete er eodd eines 80 S TAG Sz e ee e S 81 STATus OPERation CONDition
89. ire 4x32 Relay Matrix Switch Module User s Manual Edition 1 Copyright O 2001 Agilent Technologies Inc All rights reserved 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 Each new Edition or Update also includes a revised copy of this documentation history page EditionzE i Corb pen en bach ESSO E Bae ee RW March 2001 Edition Tj Rey ares ex e TERRY September 2012 Safety Symbols Instruction manual symbol affixed to product Indicates that the user must refer to Ny Alternating current AC the manual for specific WARNING or CAUTION information to avoid personal Di DC injury or damage to the product irect current DC Warning Risk of electrical shock Indicates the field wiring terminal that must be connected to earth ground before operating the equipment protects against electrical shock in case of fault Calls attention to a procedure practice or condition that could cause bodily injury or death WARNING Calls attention to a procedure practice
90. is queried a comma delineated list of 0 or 1 values is returned in the same order of the channel list See Page 107 of this manual for more details on the pattern structure in the module s NVRAM Channel list definition See ROUTe PATT CLOSe for its definition A maximum of 128 channels can be queried at one time Therefore if you want to query more than 128 channels you must enter the query data in two separate commands Querying Channels Closure State Stored in Pattern 1 This example sets channels 10101 and 10201 to the closure state in state pattern 1 then queries the setting PATT NUMB 1 1 Select Pattern 1 of Module 1 to be written to PATT CLOS 10101 10201 Set the channels 10101 and 10201 to closure state in pattern 1 PATT CLOS 10101 10201 1 1 will be returned Chapter 4 ROUTe PATTern NUMBer ROUTe PATTern NUMBer card num pattern num selects a state pattern in the module s NVRAM to store the channels state See Page 107 of this manual for more details on the pattern structure in the module s NVRAM Parameters Name Type Range of Values Default value card num numeric 01 99 N A pattern num numeric 0 510 0 Comments Using This Commands This command is often used before setting channel states in a state pattern with PATT CLOS or PATT OPEN command Related Commands ROUTe PATT CLOSe ROUTe PATT OPEN Example Selecting Pattern 1 in the NVRAM of
91. ists the address space for each pattern in the NVRAM The bits definition of each pattern is shown in Table B 3 and the numbers shown in the table indicate the corresponding channel numbers of the module The pattern definition is based on the Relay Control Registers base 10 to base 2Ej The contents of a Relay Control Register one word corresponds to one byte data in a pattern Register Based Programming 107 Table B 2 Patterns Address in NVRAM Addresses in NVRAM Description 0000 O00F For storing Pattern 0 data 0010 001F For storing Pattern 1 data 1FEO 1FEF For storing Pattern 510 data 1FFOp 1FFE Reserved 1FFF For storing the module configuration mode 4x 32 matrix or two independent 4x16 matrixes Table B 3 Bits Map of a Pattern Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 0 CH0007 CH0006 CH0005 CH0004 CH0000 CH0001 CH0002 CH0003 1 CH0015 CH0014 CH0013 CH0012 CH0011 CH0010 CH0009 CH0008 2 CH0107 CH0106 CH0105 CH0104 CH0100 CH0101 CH0102 CH0103 3 CH0115 CHO114 CHO113 CHO112 CHO111 CHO110 CH0109 CH0108 4 CH0207 CH0206 CH0205 CH0204 CH0200 CH0201 CH0202 CH0203 5 CH0215 CH0214 213 CH0212 CH0211 CH0210 CH0209 CH0208 6 CH0307 CHO306 CH0305 CH0304 CH0300 CH0301 CH0302
92. k Diagram 82 Operation Status Register 81 Standard Event Status Register 81 Status Byte Register 81 Status Control Register 102 STATus OPERation CONDition 83 STATus OPERation ENABle 83 STATus OPERation ENABle 83 STATus OPERation EVENt 84 STATus PRESet 84 Subsystems SCPI Commands ROUTe 70 80 ABORt 56 ARM 57 58 DIAGnostic 59 61 DISPlay 62 63 INITiate 64 65 OUTPut 66 69 STATus 81 84 SYSTem 85 87 TRIGger 88 90 Switchbox multiple module 14 single module 14 switching channels 15 32 34 Synchronizing the Instruments 51 SYSTem subsystem 85 87 SYSTem CDEScription 85 SYSTem CPON 85 SYSTem CTYPe 86 SYSTem ERRor 86 SYSTem VERSion 87 T Terminal Module attaching to the matrix 26 Option 105 23 Option 106 22 options 21 removing from the matrix 26 screw type 22 SMB type 23 wiring 24 trigger sources 89 TRIGger subsystem 88 90 TRIGger SOURce 89 TRIGger SOURce 90 TRIGger IMMediate 88 TTL Trigger query state of 69 setting 68 Types command parameters 54 commands 53 error 111 U Using the Scan Complete Bit 47 V Variable Commands 54 WARNINGS 8 warranty statement 7 Wiring Terminal Modules 24 Writable Registers 101 Writing to Interrupt Selection Register 104 NVRAM Address Register 109 NVRAM Data Register 109 Pattern Recall Register 110 Relay Control Registers 107 Status Control Register
93. languages They will show how to close open channels then query their state The result is returned to the computer and displayed 1 2 channel closed 0 channel open Example Closing 10 Multiple Channels HTBasic 30 40 50 60 80 32 Using the Matrix Module DIM A 20 Dimension a string variable to twenty characters OUTPUT 70914 RST CLS Reset the module and clear status registers OUTPUT 70914 ROUT CLOS 10003 10102 Close channels 10003 and 10102 OUTPUT 70914 ROUT OPEN 10003 Open channel 10003 OUTPUT 70914 ROUT CLOS 10003 10102 Query closure state of channels 10003 and 10102 ENTER 70914 A Enter the result into A PRINT A 0 1 will be displayed END Chapter 3 Example Closing Multiple Channels Chapter 3 C C include lt visa h gt include lt stdio h gt include lt stdlib h gt Module logical address is 112 secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session char ch stat 10 Channel state Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Open the module instrument session errStatus viOpen viRM INSTR ADD
94. le command is not guaranteed Use sequential CLOSe commands when needed NOTE Channel numbers in the channel list can be in any random order Command Reference Chapter 4 Related Commands ROUTe OPEN ROUTe CLOSe RST Condition All channels are open Example Closing Multiple Channels This example closes channels 10101 and 10201 of a single module switchbox CLOS 10101 10201 Close relays on row 01 column 01 and row 02 column O1 of the module ROUTe CLOSe ROUTe CLOSe channel list returns the current state of the channel s queried The channel list is in the form of Gssrrcc The command returns 1 if the channel is closed or returns 0 if the channel is open If a list of channels is queried a comma delineated list of 0 or 1 values is returned in the same order of the channel list Comments Query is Software Readback The ROUTe CLOSe command returns the current software state of the channel s specified It does not account for relay hardware failures Channel list Definition See ROUTe CLOSe on page 70 for the channel list definition NOTE A maximum of 128 channels can be queried at one time Therefore if you want to query more than 128 channels you must enter the query data in two separate commands Example Querying Channel Closure States This example closes channels 10101 and 10201 of a single module switchbox and queries channel closure Since the channels are pro
95. lize multimeter wait for trigger errStatus viPrintf E1412A INIT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Reset the matrix module clear the status registers errStatus viPrintf E8481A RST CLS n if Vl SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set the matrix pulses TTL Trigger line 0 on channel closed errStatus viPrintf E8481A OUTP TTLTO ON n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set the matrix to be triggered by TTL Trigger line 1 errStatus viPrintf E8481A TRIG SOUR TTLT1 n SUCCESS gt errStatus Using the Matrix Module 45 46 Using the Matrix Module printf ERROR viPrintf returned errStatus return errStatus Set up a scan list errStatus viPrintf E8481A SCAN 10000 10015 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Pause until ready errStatus viQueryf E8481A t opc int SUCCESS gt errStatus printf ERROR viQueryf returned 0x x n errStatus return errStatus Start scan and close channel 10000 errStatus viPrintf E8481A INIT n SUCCESS gt errStatus print ERROR viPrintf returned errStatus
96. lowing SYSTem ERRor command returns 0 No error To clear all error numbers messages in the queue execute the CLS command 86 Command Reference Chapter 4 Maximum Error Numbers Messages in the Error Queue The queue holds a maximum of 30 error numbers messages for each switchbox Ifthe queue overflows the last error number message in the queue is replaced by 350 Too many errors The least recent oldest error numbers messages remain in the queue and the most recent are discarded Example Reading the Error Queue SYST ERR Query the error queue SYSTem VERSion SYSTem VERSion returns the version of the SCPI standard to which this instrument complies Comments SCPI Version This command always returns a decimal value 1990 0 where 1990 is the year and 0 is the revision number within that year Example Reading SCPI Version SYST VERS Read the version of the SCPI standard Chapter 4 Command Reference 87 TRIGger Subsystem Syntax The TRIGger subsystem controls the triggering operation of the matrix switch modules in a switchbox TRIGger IMMediate SOURce source SOURce TRIGger IMMediate Comments Example 88 Command Reference TRIGger IMMediate causes a trigger event to occur when the defined trigger source is TRIGger SOURce BUS or TRIGger SOURce HOLD This can be used to trigger a suspended scan operation Executing This Command A channel list must be defined with ROUTe SCAN
97. lumn number This command only changes the specified channels state in the selected pattern and does not affect other channel states of the pattern Once the channel states are stored in a pattern they will not change at power on or reset As a consequence the user should be aware of the pattern s previous value when editing Name Type Range of Values Items numeric card ss lt channel_list gt numeric row rr numeric column cc Specifying channels to be stored as the open state in NVRAM pattern Use PATT OPEN Use PATT OPEN Use PATT OPEN Use PATT OPEN channels or any combination of the above ssrrcc for a single channel ssrrcc ssrrcc for multiple channels ssrrcc ssrrcc for sequential channels ssrrcc ssrrcc ssrrcc ssrrcc for groups of sequential This command only changes the specified channel states stored in the state pattern of the It does not really open the specified channel relays Use PATT ACT command to operate channel relays with the stored state pattern Related Commands ROUTe PATT ACT ROUTe PATT NUMB RST Condition All channels are open Setting Channels to Open States in Pattern 1 This example sets channels 10101 and 10201 to the open state in state pattern 1 PATT NUMB 1 1 Select Pattern 1 of Module 1 to be edited PATT OPEN 10101 10201 Set channels 10101 and 10201 to the open states in pattern 1 78 Command Refere
98. mainframe by pushing in the extraction levers f N 4 Tighten the top and bottom screws 2 to secure the module to the mainframe D 08 S 2 SI g ND amp Lx e l6 2 88 NI E DY ES S m d ay QW cS To remove the module from the mainframe reverse the procedure Figure 2 2 Installing the Matrix Switch Module in a VXIbus Mainframe 20 Configuring the Module Chapter 2 Connecting User Inputs Connectors Pinout The Agilent E8481A Matrix Switch module is not supplied with terminal modules which must be ordered separately Two types of terminal modules are available for the Agilent E8481A Matrix Switch module Order Option 106 if a screw type terminal module is desired If an SMB terminal module is desired order Option 105 User inputs to the matrix switch module are made via the Row and Column terminal connectors on these terminal modules The following sections provide the detailed information on the module s connectors pinout the screw type terminal module and the SMB terminal module as well as on how to connect field wiring to the terminal module Figure 2 3 shows the front panel of the Agilent E8481A and the connectors pinout which mates to the terminal module ROWA OH COL 0L COL 1L NC COL 2
99. mand keyword is separated from the first parameter by a space character Some examples of common commands are shown below RST ESR lt unmask gt STB The SCPI commands perform functions like closing opening switches making measurements querying instrument states or retrieving data A subsystem command structure is a hierarchical structure that usually consists of a top level or root command one or more lower level commands and their parameters The following example shows part of a typical subsystem ROUTe CLOSe channel list SCAN channel list ROUTe is the root command CLOSe and SCAN are the second level commands with channel list as a parameter A colon always separates one command from the next lower level command as shown below ROUTe SCAN channel list Colons separate the root command from the second level command ROUTe SCAN If a third level existed the second level is also separated from the third level by a colon Command Reference 53 Abbreviated The command syntax shows most commands as a mixture of upper and lower case Commands letters The upper case letters indicate the abbreviated spelling for the command For shorter program lines send the abbreviated form For better program readability you may send the entire command The instrument will accept either the abbreviated form or the entire command For example if the command syntax shows TRIGger then TRIG and TRIGGER are both ac
100. nce Chapter 4 ROUTe PATTern OPEN Chapter 4 Comments NOTE Example ROUTe PATTern OPEN channel list returns the state of the specified channel s stored in the state pattern of the module s NVRAM You must use PATT NUMB command to select a pattern to be queried first The command returns 1 if the channel state in the NVRAM pattern is open or returns 0 if closed If a list of channels is queried a comma delineated list of 0 or 1 values is returned in the same order of the channel list For more information about the state patterns in the module s NVRAM see Page 107 of this manual Channel list Definition See ROUTe PATT OPEN for its definition A maximum of 128 channels can be queried at one time Therefore if you want to query more than 128 channels you must enter the query data in two separate commands Querying Channel Open States Stored in NVRAM Pattern This example sets channels 10101 and 10201 to the open state in Pattern 1 then queries the setting PATT NUMB 1 1 Select Pattern 1 of Module 1 to store channels state PATT OPEN 10101 10201 Set channels 10101 and 10201 to the open state in pattern 1 PATT OPEN 10101 10201 1 1 will be returned Command Reference 79 ROUTe SCAN Parameters Comments Example 80 Command Reference ROUTe SCAN channel list defines the channels to be scanned The channel list is in the form of ssrrcc where ss card number 0
101. nction Mode ecesesssssseceseceeeeeeeeseceseceseseneseaeesaecsaeceeeeeeeesesenaes 30 Example Setting Function Mode eee 30 Example Setting Function Mode 31 Switching Channels i nope le e ane epe 32 Example Closing Multiple Channels HTBasic eee 32 Example Closing Multiple Channels 33 Using State Patterns to Switch Channels eere 34 Example Using a State Pattern to Switch Channels HTBasic 34 Example Using a State Pattern to Switch Channels 35 scanning Channels e testet tectorio ate 37 Example Scanning Channels Using Trig In Out Ports sess 37 Example Scanning Channels Using TTL Trigger eee 42 Using the Scan Complete enne 47 Example Using the Scan Complete Bit HTBasic 47 Example Using the Scan Complete Bit eee 48 Querying the Matrix 49 Recalling and Saving States dida end ir VEEE Er e eee 50 Example Saving and Recalling Instrument State HTBasic 50 Detecting Error ConditioDs ine ertet eie e eerte Deren cogens 51 Example Querying Errors HTBasic eene 51 Synchronizing the Instruments essere enne e
102. nstruments SCPI environment one or more E8481A modules can be configured as a switchbox instrument For a switchbox instrument all modules within the instrument can be addressed using a single interface address Chapter 1 Instrument Definition The plug in modules installed in an Agilent mainframe or used with an Agilent command module are treated as independent instruments each having a unique secondary GPIB address Each instrument is also assigned a dedicated error queue input and output buffers status registers and if applicable dedicated mainframe command module memory space for readings or data An instrument may be composed of a single plug in module such as a counter or multiple plug in modules for a switchbox or scanning multimeter instrument Programming the Module To program the module using SCPI commands you must select the controller language interface address and SCPI commands to be used See the C Size VXIbus System Configuration Guide for detailed interface addressing and controller language information For uses in other systems or mainframes see the appropriate manuals For more details of SCPI commands applicable to the module refer to Chapter 4 of this manual NOTE This section only discusses SCPI programming The module can also be programmed by writing directly to its registers See Appendix B for details on register programming Spec ifying SCPI To address specific channels within an E8481A mo
103. ntente enne 51 Example Synchronizing the Instruments HTBasic esee 51 Chapter 4 Command Reference cote nene a tiim Ue epi tO P QURE NENS ESSEN SUE UNDE 53 Using This Chapter ngu edem e ee aee o tied 53 Command Lypes cs ite e d e tite te tete tete thee 53 Common Command Format eese nennen 53 SCPI Command Formats e ie dct dri ee eral trae opea 53 Lanking Commands ee PH Mn ie oue 55 SCPI Command e pee I ee ed Pepsi Ime ooo e Re 55 INBORt utet ee estem titii ceti eee od ete 56 ARM toe conie n Be tee ei RAE DENNES 57 ARM COUNU Me 57 ARM COUN etico tio en e tp ete Ree HERRERA 58 DIAGHROSUC roten iret te E Te etre OUT Ep HR Po rete veia 59 DIAGnostic INTerrupt LEINe vas ure eee set e OR anna 59 DIAGnostc INTerr pt EINe iniit deri teneo ien 60 DIAGnostic TEST RELays saadanne 60 bIAGnostic VEST SEEPrOm Lire tote edente ete n eerte eres 61 I BYS ES EN utet tenerum tte Oe ORE HEN HERR ei i HET ahaa EE EUER E SEE 62 DISPlay MONItoE CARD S titii nti seeks etie dee oH E De Rte 62 DISPlay MONitor CARD i ueteri npe 62 DISPlay MONItor S TA Te enne entente a 63 DISPIay MONItOr S TATe eene t terrere 63 IN Hbri S 64 INITiate CON TinuoUs e tree teret tete et ree ere eter er pner perdere d 64 INT Tate CON L
104. nterrupt priority level is not recommended DO NOT change it unless specially instructed to do so Refer to the E1406A Command Module User s Manual for more details Parameters Name Type Range of Values Default Value card number numeric 1 99 N A line number numeric 0 7 1 Comments Disable Interrupt Setting line number 0 will disable the module s interrupt capability Select an Interrupt Line The line number can be 1 through 7 corresponding to VXI backplane interrupt lines 1 7 Only one value can be set at one time The default value is 1 lowest interrupt level Related Commands DIAGnostic INTerrupt LINe Example Setting Interrupt Line 1 for Module 1 DIAG INT LIN 1 1 Set the interrupt line of module 1 to line 1 Chapter 4 Command Reference 59 DIAGnostic INTerrupt LINe Parameters Comments Example DIAGnostic INTerrupt LINe card numbers queries the module s VXI backplane interrupt line and the returned value is one of 1 2 3 4 5 6 7 which corresponds to the module s interrupt lines 1 7 The returned value being 0 indicates that the module s interrupt is disabled The card number specifies which E8481A in a multiple module switchbox is being referred to Name Type Range of Values Default Value card number numeric 1 99 N A Return value of 0 indicates that the module s interrupt is disabled Return values of 1 7 correspond
105. o error Otherwise return value of 1 Name Type Range of Values Default value card number numeric 1 99 N A Related Commands SYST CTYPE card number Checking EEPROM Checksum on Module 1 DIAG TEST SEEProm 1 Return 0 if no error Command Reference 61 DISPlay Subsystem Syntax The DISPlay subsystem monitors the channel state of the selected module in a switchbox This subsystem operates with an Agilent E1406A command module when a display terminal is connected With an RS 232 terminal connected to the E1406A command module s RS 232 port these commands control the display on the terminal and would in most cases be typed directly from the terminal keyboard It is possible however to send these commands over the GPIB interface and control the terminal s display In this case care must be taken that the instrument receiving the DISPlay command is the same one that is currently selected on the terminal otherwise the GPIB command will have no visible affect DISPlay MONItor CARD number AUTO CARD STATe lt mode gt STATe DISPlay MONitor CARD Parameters Comments Example DISPlay MONitor CARD number AUTO selects the module in a switchbox to be monitored when the monitor mode is enabled Use the DISPlay MONitor STATe command to enable or disable the monitor mode Name Type Range of Values Default Value number AUTO numeric 1 99 AUTO AUTO
106. oo Ab CH Q COLO COL2 COL4 COL6 COL9 COL11 COL13 COL15 COL16 COL18 COL20 COL22 COL25 COL27 COL29 COL31 poleepecee eejleeleeleec H L H E H L H L HO LH E HE HL H EL H E Hot HOL OR Le E COL3 COL5 COL7 COL8 COL10 COL12 COL14 COL17 COL19 COL21 COL23 COL24 COL26 COL28 COL30 eq pg ee ee HE HL HL HL HL HL Wu or HL ROWAO ROWA1 ROWA2 ROWA3 ROWBO ROWB1 ROWB2 ROWB3 N Note RowB 0 3 connectors are used only in Dual 4x16 configuration cr Figure 2 4 Screw Type Terminal Module 22 Configuring the Module Chapter 2 SMB Type Terminal Module module via SMB cables Figure 2 5 shows the Option 105 SMB type terminal module connectors and associated row column designators This SMB terminal module provides a convenient way to connect the field wiring to the matrix switch Mating to the J1 and J2 connectors on the front panel of the E8481A E
107. oop readings loop Close the E8481A instrument session errStatus viClose E8481A if VI_SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Using the Matrix Module 41 Example Scanning Channels Using TTL Trigger Close the multimeter instrument session errStatus viClose dmm if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS This example uses E1406A command module s TTL Trigger Bus Lines to synchronize matrix channel closures with a system multimeter Agilent E1412A See Figure 3 2 for typical user connections For measurement synchronization E1406A s TTL Trigger Bus Line 0 is used by the matrix module to trigger the multimeter to perform a measurement E1406A s TTL trigger bus line 1 is used by the multimeter to advance the matrix scan r A 1 l 1 les va 1406 i Command Module 1 1 _ i 2 i i TTLTrg 0 1 L E oo L 1 1 L TTLTrg 1 Part of VXIbus 2 gy p 0000 og B 225 m ETE ME E
108. own in the register maps indicate the channel numbers of the module Writing to these Relay Control Registers base 10 to base 2Eg allows you to open or close the relay channels Reading these registers returns the current state of the relay channels Each channel uses two bits for controlling the HI and LOW relays of the channel Writing 11 to these bits will close the related channel and writing 00 will open the channel Writing 01 or 10 to these bits will cause wrong operation on the related channel For example to close the relays on Row 0 Column 12 write 11 to bits 8 amp 9 of the register base 124 Reading the Relay Control Registers returns a hexadecimal number The bits that are 11 represent the related channel is closed The bits that are 00 indicate the related channel relay is open Reading the channel bit indicates to get the state of the relay driver circuit only It cannot detect a defective relay When power on or reset the matrix all the channel relays are open and when you read from these registers all the bits are zero There is an 8 kB non volatile RAM on the PC board of the module where up to 511 channel patterns can be stored Each pattern includes all 128 channels state of the module requiring 16 bytes 128 bits continuous NVRAM space to store The bit that is 1 represents the related channel is closed The bit that is 0 represents the related channel is open Table B 2 l
109. pace 98 99 installing matrix 20 Matrix attaching terminal module 26 Card Number 14 channel addresses 13 connectors pinout 21 description 11 front panel 21 function Mode 12 logical address 18 98 99 schematic simplified 11 specification 95 Module Identification 28 Multiple module Switchbox 14 N Non continuous Scanning 64 non volatile RAM 11 34 107 Numeric Command Parameter 54 NVRAM Control Registers 107 O Offset register 100 opening channels 15 32 34 Operation Status Register 81 Scan Complete Bit 81 Option 105 23 Option 106 22 Optional Command Parameter 55 OUTPut subsystem 66 69 OUTPut ECLTrgn STATe 66 OUTPut ECLTrgn STATe 67 OUTPut TTLTrgn STATe 68 OUTPut TTLTrgn STATe 69 OUTPut EXTernal STATe 67 OUTPut EXTernal STATe 68 P Parameters boolean 54 discrete 54 numeric 54 optional 55 types of SCPI 54 Patterns addresses map in NVRAM 108 Bits Map of a Pattern 108 Registers NVRAM Address Register 109 NVRAM Data Register 109 Pattern Recall Register 110 switching channels with 34 Programming examples 27 Register based 97 with SCPI commands 13 Q Querying commands 49 Quick Reference Common Command 93 SCPI Command 91 Agilent E8481A User s Manual Index 115 R Readable Registers 101 Reading Device Type Register 102 ID Register 102 Interrupt Selection Register 104 NVRAM Address Register 109 NVRAM Data Register 109
110. r 4 lt 16 gt 0 lt i gt Query Error 5 lt 32 gt 1 lt 2 gt Request Control 4 6 lt 64 gt N 2 lt 4 gt Set by Operation Complete T 7 lt 128 gt ON BE 3 lt B gt Related Commands EV EN MAV 4 lt 16 gt are OPC and WAI SB 5 System RQS 6 Controller OPR 7 CRIMES Interface Bus SRQ Line SRQ Other Operation Status Register STATus OPERation CONDition E SRQ Other STATus OPERation EVENt Instrument pue 0 1 2 Summary unmask examples 3 Bi e ee 4 unmask 5 Register decimal a bit weight 6 np 7 il ok Scan Complete 4 8 Operation Complete 7 lt 128 gt 4 ESB 10 ESE 61 unmasks standard event register bits 0 1 2 3 4 and 5 ESE 128 only unmasks bit 7 12 4936 SRE 128 unmasks the OPR bit operation in 13 8192 the status byte register This is effective 14 16384 only if the STAT OPER ENAB 256 command 15 32768 is executed C EV EN STAT OPER ENAB 256 unmasks the Scan Complete bit Figure 4 1 E8481A Status System Register Diagram 82 Command Reference Chapter 4 STATus OPERation CONDition STATus OPERation CONDition returns the state of the Condition Register in the Operation Status Group The state represents conditions which are part of the instrument s operation The module s driver does not set bit 8 in this register see STATus OPERation EVENt STATus OPERation ENABle Parameters Comments Example STATu
111. res involving cover or shield removal unless you are qualified to do so DO NOT operate damaged equipment Whenever it is possible that the safety protection features built into this product have been impaired either through physical damage excessive moisture or any other reason REMOVE POWER and do not use the product until safe operation can be verified by service trained personnel If necessary return the product to Agilent for service and repair to ensure that safety features are maintained DO NOT service or adjust alone Do not attempt internal service or adjustment unless another person capable of rendering first aid and resuscitation is present DO NOT substitute parts or modify equipment Because of the danger of introducing additional hazards do not install substitute parts or perform any unauthorized modification to the product Return the product to Agilent for service and repair to ensure that safety features are maintained Declaration of Conformity Declarations of Conformity for this product and for other Agilent products may be downloaded from the Internet There are two methods to obtain the Declaration of Conformity Go to http regulations corporate agilent com DoC search htm You can then search by product number to find the latest Declaration of Conformity Alternately you can go to the product web page www agilent com find E8481A click on the Document Library tab then scroll down until you find the Declar
112. ressing Base Address Appendix B Register addresses for register based devices are located in the upper 25 of VXI A16 address space Every VXI device up to 256 devices is allocated a 32 word 64 byte block of addresses Figure B 1 on page 98 shows the register address location within A16 as it might be mapped by an embedded controller Figure B 2 on page 99 shows the location of A16 address space in the E1406A command module When you are reading from or writing to a register of the module a hexadecimal or decimal register address needs to be specified This address consists of a base address plus a register offset Register Address Base Address Register Offset The base address used in register based programming depends on whether the A16 address space is outside or inside the E1406A command module Register Based Programming 97 A16 Address Space Outside the Command Module When the E1406A command module is not part of your VXIbus system Figure B 1 the module s base address is computed as C000 LADDR 40 or decimal 49 152 LADDR 64 where C000 49 152 is the starting location of the VXI A16 addresses LADDR is the module s logical address and 64 40 is the number of address bytes per register based module For example the module s factory set logical address is 112 704 If this address is not changed the module will have a base address of C000 704 40 C000 1C00 DC
113. returns 1 since the line is enabled OUTP ECLT1 STAT 1 Enable ECL Trigger bus line 1 OUTP ECLT1 Query bus enable state OUTPut EXTernal STATe Parameters Comments Chapter 4 OUTPut EXTernal STATe modes enables or disables the Trig Out port on the E1406A command module to output a trigger when a channel is closed during a scan OUTPut EXTernal STATe ON 1 enables the port OUTPut EXTernal STATe OFF 0 disables the port Name Type Range of Values Default Value mode boolean ON OFF 1 0 OFF 0 Enabling Trig Out Port When enabled a pulse is output from the Trig Out port each time a channel is closed during scanning If disabled a pulse is not output from the port after channel closures Output Pulse The pulse is 5 V negative going pulse Trig Out Port Shared by Switchboxes Only one switchbox configuration can use the selected trigger at a time When enabled the Trig Out port may is pulsed by the switchbox each time a scanned channel is closed To disable the output for a specific switchbox send the OUTP OFF or 0 command for that switchbox Command Reference 67 One Output Selected at a Time Only one output ECLTrgn TTLTrgn or EXTernal can be enabled at one time Enabling a different output source will automatically disable the active output For example if TTLTrg1 is the active output and TTLTrg4 is enabled TTLTrg1 will become disabled an
114. rix Switch module for use in a VXIbus mainframe install it in a mainframe and connect external wiring to the matrix module Chapter contents include e Warnings and 17 Setting the Logical Address 18 Setting the Interrupt 19 Installing the Matrix Switch Module in a Mainframe 20 Connectors 21 Screw Type Terminal 22 SMB Type Terminal Module 23 Wiring a Terminal Module 24 Attaching a Terminal Module to the Matrix 26 Warnings and Cautions Chapter 2 WARNING Caution SHOCK HAZARD Only qualified service trained personnel who are aware of the hazards involved should install configure or remove the Matrix switch module Remove all power sources from the mainframe and installed modules before installing or removing a module MAXIMUM INPUTS The maximum voltage that can be applied to any terminal is 42 Vdc or 30 V ac rms The maximum current that can be applied to any terminal is 0 5 A dc or ac peak The maximum power that can be applied to any terminal is 5 W or 5 VA resistive Exceeding any limit may damage the Matrix Switch module STATIC ELECTRICITY Static electricity is a major cause of component failure To prevent damage to the electrical components in
115. rr numeric 00 31 column cc Command Reference 75 Comments Example Specifying channels to be stored as open state in NVRAM pattern Use PATT CLOSe Use PATT CLOSe Use PATT CLOSe Use PATT CLOSe channels or any combination of the above ssrrcc for a single channel ssrrcc ssrrcc for multiple channels ssrrcc ssrrcc for sequential channels ssrrcc ssrrcc ssrrcc ssrrcc for groups of sequential This command changes specified channel states stored state pattern ofthe NVRAM It does not really close the specified channel relays Use PATT ACT command to operate channel relays with the stored state pattern Related Commands ROUTe PATT ACT ROUTe PATT NUMB Setting Channels to the Closed States in Pattern 1 This example sets channels 10101 and 10201 to the closed state in Pattern 1 PATT NUMB 1 1 Select State Pattern 1 of Module 1 for editing PATT CLOS 10101 10201 Set channels 10101 and 10201 to the closure state in pattern 1 ROUTe PATTern CLOSe Comments NOTE Example 76 Command Reference ROUTe PATTern CLOSe channel list returns the state of the specified channel s stored in the state pattern of the module s NVRAM You must use PATT NUMB command to select a pattern to be queried first The command returns 1 if the channel state in the NVRAM pattern is closed or returns 0 if open If a list of channels
116. rr_number gt lt err_message gt where lt err_number gt is an integer ranging from 32768 to 32767 and the lt err_message gt is a short description of the error and the maximum string length is 255 characters The following example program was written in HTBasic programming language It attempts an illegal channel closure for the E8481A matrix module then polls for the error message 10 DIM Err_num 256 Dimension a string variable 20 OUTPUT 70914 CLOS 10500 Try to close an illegal channel 30 OUTPUT 70914 SYST ERR Check for a system error 40 ENTER 70914 Err_num Enter the error into Err num 50 PRINT Error Err_num Print error 2001 Invalid channel number 60 END Synchronizing the Instruments Example Synchronizing the Instruments HTBasic This section shows how to synchronize a matrix module with other instruments when making measurements In the following example the matrix module switches a signal to a multimeter then verifies that the switching is complete before the multimeter begins a measurement This example program was written in HTBasic language Assuming the multimeter E1412A has the GPIB address of 70903 and the matrix module has a logical address of 112 GPIB address of 70914 10 OUTPUT 70914 RST Reset the module 20 OUTPUT 70914 CLOS 10001 Close a channel 30 OUTPUT 70914 OPC Wait for operation complete 40 ENTER 70914 OPC value 50 OUTPU
117. rs Name Type Range of Values Default Value lt card_number gt numeric 1 99 N A Comments Agilent E8481A Module Model Number Sending this command returns HEWLETT PACKARD E8481A lt 10 digit number gt A 11 01 where the lt 10 digit number gt is the module s serial number and A 11 01 is an example of the module revision code number NOTE The lt 10 digit number returns 0 zero if the checksum of the serial EEPROM on the module has error The checksum of the EEPROM on the module is always checked each time the SYST CTYP lt number gt command is executed Refer to DIAGnostic TEST SEEProm command on page 61 for details Related Commands DIAG TEST SEEProm lt card_number gt Example Reading the Model Number of Module 1 SYST CTYP 1 Return the model number of module 1 SYSTem ERRor SYSTem ERRor returns the error numbers and corresponding error messages in the error queue of a matrix module See Appendix C for a listing of the module error numbers and messages Comments Error Numbers Messages in the Error Queue Each error generated by a matrix module stores an error number and corresponding error message in the error queue The error message can be up to 255 characters long Clearing the Error Queue An error number message is removed from the queue each time the SYSTem ERRor command is sent The errors are cleared first in first out When the queue is empty each fol
118. s 1 16 Dimension a variable to store readings 20 OUTPUT 722 RST CLS Reset the dmm and clear its status registers 30 OUTPUT 70914 RST CLS Reset the matrix module and clear its status registers 40 OUTPUT 722 CONF VOLT DC 12 Set the dmm for DCV measurement 12 V maximum 50 OUTPUT 722 TRIG SOUR EXT Set the dmm trigger source to EXTernal triggering 60 OUTPUT 722 TRIG COUN 16 Set the dmm trigger count to16 70 OUTPUT 722 INIT Set the dmm to the wait for trigger state 80 WAIT 1 Wait for 1 second 90 OUTPUT 70914 OUTP ON Set the matrix output pulses on E1406A Trig Out port when channel closed 100 OUTPUT 70914 TRIG SOUR EXT Set the matrix trigger source to external triggering 38 Using the Matrix Module Chapter 3 Programming with C C Chapter 3 110 OUTPUT 70914 SCAN 10000 10015 Define channel list row 00 columns 00 15 for scanning 120 OUTPUT 70914 INIT Start scan and close channel 10000 130 OUTPUT 722 FETCH Read measurement results from the dmm 140 ENTER 722 Rdgs Enter measurement results 150 PRINT Rdgs Display measurement results 160 END The following program was written and tested in Microsoft Visual C using the VISA extensions but should compile under any standard ANSI C compiler This example configures the external multimeter Agilent 34401A to scan making DC voltage measurements include lt visa h gt includ
119. s OPERation ENABle unmask sets an enable mask to allow events recorded in the Event Register Operation Status Group to send a summary bit to the Status Byte Register bit 7 For the matrix module when bit 8 in the Operation Status Register is set to 1 and that bit is enabled by the STATus OPERation ENABle 256 command bit 7 in the Status Byte Register is set to 1 Name Type Range of Values Default Value unmask numeric 0 65 535 N A Setting Bit 7 of the Status Byte Register STATus OPERation ENABle 256 sets bit 7 of the Status Byte Register to 1 after bit 8 of the Operation Status Register is set to 1 Related Commands ROUTe SCAN Enabling Operation Status Register Bit 8 STAT OPER ENAB 256 Enable bit 8 of the Operation Status Register to be reported to bit 7 OPR in the Status Byte Register STATus OPERation ENABle Chapter 4 Comments Example STATus OPERation ENABle returns which bits in the Event Register Operation Status Group are unmasked Output Format Returns a decimal weighted value from 0 to 65 535 indicating which bits are set to true Maximum Value Returned The value returned is the value set by the STAT OPER ENAB lt unmask gt command However the maximum decimal weighted value used in this module is 256 bit 8 set to true Querying the Operation Status Enable Register STAT OPER ENAB Query the Operation Status Enable Register Command Referenc
120. s byte query TRG Triggers the module to advance the scan when scan is enabled and trigger source is TRIGger SOURce BUS TST Self test Executes an internal self test and returns only the first error encountered Does not return multiple errors The following is a list of responses you can obtain where cc is the card number with the leading zero deleted 0 if self test passes cc01 for firmware error cc02 for bus error problem communicating with the module cc03 for incorrect ID information read back from the module s ID register cc05 for hardware and firmware have different values Possibly a hardware fault or an outside entity is register programming the E8481A cc10 if an interrupt was expected but not received cc11 if the busy bit was not held for a sufficient amount of time WAI Wait to Complete Chapter 4 Command Reference 93 Notes 94 Command Reference Chapter 4 Table 4 1 E8481A Specifications Appendix A E8481A Specifications ITEMS SPECIFICATIONS GENERAL CHARACTERISTICS Module Size Device Type Total Channels Relays Type Typical Relay Life Power Requirements Watts slot Cooling slot Operating Temperature Operating Humidity At Rated Load Peak Module Current Dynamic Module Current With 8 Crosspoints Closed P With 8 Crosspoints Closed P C Size 1 Slot Register based A16 slave only P1 and P2 Connectors
121. s example enables a single scan of channels 1000 through 10003 of a single module switchbox The trigger source to advance the scan is immediate internal triggering set with TRIGger SOURcelMMediate default SCAN 10000 10003 Set channels to be scanned INIT Start scan close channel 10000 Command Reference 65 OUTPut Subsystem Syntax The OUTPut command subsystem selects the source of the output trigger generated when a channel is closed during a scan The selected output can be enabled disabled or queried The three available outputs are ECLTrg TTLTrg trigger buses and the Trig Out port on the command module s front panel Agilent E1406A OUTPut ECLTIgn ECLTrg0 or ECLTrg1 STATe mode STATe EXTernal STATe mode STATe TTLTrgn TTLTrgO through TTLTrg7 STATe mode STATe OUTPut ECLTrgn STATe Parameters Comments 66 Command Reference OUTPut ECLTrgn STATe mode selects and enables which ECL Trigger bus line 0 and 1 will output a trigger when a channel is closed during a scan This is also used to disable a selected ECL Trigger bus line specifies the ECL Trigger bus line 0 or 1 and mode enables ON or 1 or disables OFF or 0 the specified ECL Trigger bus line Name Type Range of Values Default Value n numeric 0 or 1 N A mode boolean 0 1 OFF ON OFF 0 Enabling ECL Trigger Bus When enabled a trigger pulse i
122. s output from the selected ECL Trigger bus line 0 or 1 each time a channel is closed during a scan The output is a negative going pulse ECL Trigger Bus Line Shared by Switchboxes Only one switchbox configuration can use the selected trigger at a time When enabled the selected ECL Trigger bus line 0 or 1 is pulsed by the switchbox each time a scanned channel is closed To disable the output for a specific switchbox send the OUTPut ECLTrgn OFF or 0 command for that switchbox One Output Selected at a Time Only one output ECLTrgn TTLTrgn or EXTernal can be enabled at one time Enabling a different output source will automatically disable the active output For example if ECLTrg0 is the active output and ECLTrg1 is enabled ECLTrgO will become disabled and ECLTrg1 will become the active output Chapter 4 Example Related Commands ROUTe SCAN TRIGger SOURce OUTPut ECLTrgn STATe RST Condition OUTPut ECLTrgn STATe OFF disabled Enabling ECL Trigger Bus Line 0 OUTP ECLTO STAT 1 Enable ECL Trigger bus line 0 to output pulse after each scanned channel is closed OUTPut ECLTrgn STATe Example OUTPut ECLTrgn STATe queries the state of the specified ECL Trigger bus line The command returns 1 if the specified ECL Trg bus line is enabled or 0 if it is disabled Querying ECL Trigger Bus Enable State This example enables ECL Trigger bus line 1 and queries the enable state The OUTPut ECLTrgn command
123. sing State Pattern to Switch Channels 34 Using the Scan Complete Bit 47 External Trig In Out 37 89 F Field Wiring 24 Format common command 53 SCPI command 53 Front Panel connectors pinout 21 Function Mode command for querying 72 command for setting 72 example programs 30 factory setting 12 register based setting 109 G Group Execute Trigger GET 89 H HTBasic language example programs closing a single channel 15 closing multiple channels 32 identifying the module 28 querying system errors 51 saving and recalling instrument state 50 scanning channels using Trig In Out ports 38 scanning channels with TTL trigger 43 setting module function mode 30 synchronizing instruments 51 system configuration 27 using scan complete bit 47 using state pattern 34 114 Agilent E8481A User s Manual Index ID Register 102 IEEE 488 2 Common Command Reference 93 Implied Commands 54 Initial Operation 15 INITiate subsystem 64 65 INITiate CONTinuous 64 INITiate CONTinuous 65 INITiate IMMediate 65 Installing module in a mainframe 20 Instrument Definition 13 Instruments synchronizing 51 interface address 12 Interrupt disabling 59 103 enabling 59 103 priority level 19 104 Interrupt Selection Register 104 L LADDR 98 99 Linking Commands 55 Logical Address factory setting 18 98 99 register based 98 99 setting 18 98 99 switch location 18 Mainframe A16 address s
124. sponding location specified by Address Register base 38 Reading this register returns the data stored in the NVRAM location specified by Address Register base 38 base 3A 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 Write Reserved 0 FF Read Before writing data to this register make sure the address space has been set to the desired number in the NVRAM Address Register base 38 Refer to Table B 2 for more details on the addresses description Setting State Pattern Setting a state pattern consists of sixteen writing to this register Also the desired address number must be specified in the Address Register base 385 before each data is written to the NVRAM Data Register See Table B 3 for the bits definition of a pattern Setting Module Function Mode When 1FFF is specified in the Address Register base 38 writing a 1 to the Data Register will set the module as an 4x32 matrix and writing a 0 will set the module as two independent 4x16 matrixes By default the module is configured as an 4x32 matrix Appendix B Register Based Programming 109 Pattern Recall Register The Pattern Recall Register is at offset address 3Cp Writing to this register is used to specify a pattern number to be recalled The valid value is between 0 and 510 This register can also be read back
125. t buffer where you can retrieve it into your computer to obtain the specific information of the module The following lists some of the query commands often used See Chapter 4 for more details of the related commands Channel closed CLOS Channel open OPEN Function Mode FUNC Channel closed in Pattern PATT CLOS Channel open in Pattern PATT OPEN Pattern number PATT NUMB Pattern activated PATT ACT Module Description SYST CDES Module Type SYST CTYP System error SYST ERR Using the Matrix Module 49 Recalling and Saving States Example Saving and Recalling Instrument State HTBasic 50 Using the Matrix Module The SAV numeric state command saves the current instrument state Up to 10 states can be stored by specifying the numeric state parameter as an integer O through 9 The settings saved by this command are as follows Channel relays states open or closed ARM COUNt TRIGger SOURce OUTPut STATe INITiate CONTinuous The RCL numeric state command recalls a previously saved state specified by the numeric state parameter If no SAV was previously executed for the numeric state the matrix module will configure to its power on reset state refer to Table 3 1 The following HTBasic program shows how to save and recall the matrix switch states It first closes channels 10000 through 10015 then saves current channel states to the state 5 After reset the module to open all channels of
126. t visa h gt include lt stdio h gt include lt stdlib h gt Module logical address is 112 secondary address is 14 define INSTR_ADDR GPIBO 9 14 INSTR int main ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session char pstat 256 Channel state in pattern char cstat 256 Channel state Open the default resource manager errStatus viOpenDefaultRM amp viRM SUCCESS gt errStatus printf ERROR viOpenDefaultRM returned 0x x n errStatus return errStatus Using the Matrix Module 35 36 Using the Matrix Module Open the module instrument session errStatus viOpen viRM INSTR ADDR VI NULL VI NULL amp E84814 SUCCESS gt errStatus printf ERROR viOpen returned 0x x n errStatus return errStatus Reset the module errStatus viPrintf E8481A RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Select pattern 10 on module 1 for storing states errStatus viPrintf E8481A PATT NUMB 1 10 n if VI SUCCESS gt errStatus print ERROR viPrintf returned errStatus return errStatus Open all channels in pattern 10 errStatus viPrintf E8481A PATT OPEN 10000 10331 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus re
127. tat Close the module instrument session errStatus viClose E8481A if Vl SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Scanning Channels For the E8481A Matrix Switch module scanning channels consists of closing a set of channels one at a time You can scan any combination of channels for a single module or a multiple module switchbox Single multiple or continuous scanning modes are available Use TRIGger SOURce command to specify the source to advance the scan Use OUTPut subsystem commands to select the E1406A command module Trig Out port or ECL Trigger bus lines 0 1 or TTL Trigger bus lines 0 7 Use ARM COUNt number to set multiple continuous scans from 1 to 32 767 scans Use INITiate CONTinuous ON to set continuous scanning See Chapter 4 of this manual for information about these SCPI commands Exam ple Scanning This example uses E1406A command module s Trig In and Trig Out ports to synchronize the matrix module channel closures with an external Channels Using measurement multimeter Agilent 34401A See Figure 3 1 for typical user Trig In Out Ports connections For measurement synchronization E1406A s Trig Out port connected to the 34401A multimeter s E
128. the module then recall the stored state 5 and verify whether the channels are set to the saved state channels 10000 through 10015 are closed 10 DIM A 100 Dimensiona string variables to 30 characters 20 OUTPUT 70914 RST CLS Reset the module and clear status registers 30 OUTPUT 70914 CLOS 10000 10015 Close channel relays on row 0 column 00 15 of the matrix module 40 OUTPUT 70914 SAV 5 Save all channel states as numeric state 5 50 OUTPUT 70914 RST CLS Reset the module and clear status register 60 OUTPUT 70914 CLOS 910000 10031 Query to see what channel relays are closed on Row 0 70 ENTER 70914 A 80 PRINT Channels Closed A Display the closed channels 90 OUTPUT 70914 RCL 5 Recall the state 5 100 OUTPUT 70914 CLOS 10000 10031 Query to see what channel relays are closed on Row 0 110 ENTER 70914 A 120 PRINT Channels Closed A Print Is for the first 16 channels that are closed and 0s for the remaining 16 channels 130 END Chapter 3 Detecting Error Conditions Example Querying Errors HTBasic The SYSTem ERRor command queries the instrument s error queue for error conditions If no error occurs the matrix module responds with 0 No error If errors do occur the module will respond with the first one in its error queue Subsequent queries continue to read the error queue until it is empty The response takes the following form lt e
129. tion levers E8481A Module Extraction Lever 2 Align the terminal module connectors to the E8481A module connectors Apply gentle pressure to attach the terminal module to the relay matrix module 4 Push the extraction levers to lock the terminal module onto the E8481A module a Extraction Levers To remove the terminal module from the E8481A use a small screwdriver to release the two extraction levers and push both levers out simultaneously to free it from the E8481A module Figure 2 7 Attach a Terminal Module to the E8481 Matrix Module 26 Configuring the Module Chapter 2 Chapter 3 Using the Matrix Module About This Chapter This chapter uses typical examples to show how to use the E8481A Matrix module Chapter contents are Power On and Reset Conditions 28 Module 1 28 Setting Module Function Mode 30 Switching 32 Using State Patterns to Switch Channels 34 Scanning Channels Using Trig In Out Ports 37 Scanning Channels Using TTL Trigger 42 Using the Scan Complete 47 Querying the Matrix Module 49 Recalling and Saving 50 Detecting Error 51 Synchroniz
130. turn errStatus Close channels 0000 0101 and 0202 in pattern 10 errStatus viPrintf E8481A PATT CLOS 10000 10101 10202 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query channels 0000 0101 and 0202 state in pattern 10 errStatus viQueryf E8481A PATT CLOS 10000 10101 10202 n t pstat SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Query the actual states of channels 0000 0101 0202 0 0 0 should be displayed errStatus viQueryf E8481A ROUT CLOS 10000 10101 10202 n t cstat if VI SUCCESS gt errStatus printf ERROR viQueryf returned 0x x n errStatus return errStatus printf Before recall pattern channel state is s n cstat Recall pattern 10 to operate relays on module 1 errStatus viPrintf E8481A PATT ACT 1 10 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Chapter 3 Verify whether channels 0000 0101 0202 are really closed 1 1 should be displayed after recalling the pattern errStatus viQueryf E8481A ROUT CLOS 10000 10101 10202 n t cstat if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf After recall pattern channel state is s n cs
131. tus Chapter 3 Chapter 3 Set matrix trigger source to EXTernal errStatus viPrintf E8481A TRIG SOUR EXT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set up a scan list errStatus viPrintf E8481A SCAN 10000 10015 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Pause until ready errStatus viQueryf E8481A OPC n t opc int if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus Start scan and close channel 10000 errStatus viPrintf E8481A INIT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Wait for scan to complete errStatus viPrintf E8481A STAT OPER ENAB 256 if VI SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus for errStatus viQueryf E8481A STB n 26d amp opc int if opc int amp 0x80 break printf Scan has completed Get readings from the multimeter errStatus viQueryf dmm FETC n 16lf readings SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus Display the measurement results for loop 0 loop lt 16 loop printf Reading d is lf n l
132. ubsystem Syntax INITiate CONTinuous lt mode gt CONTinuous IMMediate INITiate CONTinuous INITiate CONTinuous mode enables or disables continuous scanning cycles for the matrix Parameters Name Type Range of Values Default Value lt mode gt boolean ON OFF 1 0 OFF 0 Comments Continuous Scanning Operation Continuous scanning is enabled with the INITiate CONTinuous ON INITiate CONTinuous 1 command Sending the INITiate IMMediate command closes the first channel in the channel list Each trigger from the trigger source specified by the TRIGger SOURce command advances the scan through the channel list A trigger at the end of the channel list closes the first channel in the channel list and the scan cycle repeats Noncontinuous Scanning Operation Noncontinuous scanning is enabled with the INITiate CONTinuous OFF or INITiate CONTinuous 0 command Sending the INITiate IMMediate command closes the first channel in the channel list Each trigger from the trigger source specified by the TRIGger SOURce command advances the scan through the channel list A trigger at the end of the channel list opens the last channel in the list and the scanning cycle stops Stopping Continuous Scan Refer to the ABORt command on Page 56 Related Commands ABORt ARM COUNTt INITiate IMMediate TRIGger SOURce RST Condition INITiate CONTinuous OFF 0 Example Enabling Continuous Scanning This example enables
133. uide for more addressing information For more details on the related SCPI commands used in the examples see Chapter 4 of this manual This example program was written in HTBasic programming language The program closes channel 0002 then queries its state The result is returned to the computer and displayed 1 channel closed 0 channel open 10 DIM Ch Stat 20 Dimension a variable 20 OUTPUT 70914 RST Resets the module 30 OUTPUT 70914 CLOS 10002 Close channel 10002 40 OUTPUT 70914 CLOS 10002 Query channel 10002 closed State 50 ENTER 70914 Ch Stat Enter results into Ch stat 60 PRINT Ch Stat Display results 1 should be returned 70 END This example program was developed and tested in Microsoft Visual C 6 0 but should compile under any standard ANSI C compiler The program closes channel 0002 then queries its state The result is returned to the computer and displayed 1 channel closed 0 channel open include visa h include lt stdio h gt include lt stdlib h gt Module logical address is 112 secondary address is 14 define INSTR_ADDR GPIBO0 9 14 INSTR Getting Started 15 int main 16 Getting Started ViStatus errStatus Status from each VISA call ViSession viRM Resource manager session ViSession E8481A Module session char state 10 Channel state Open the default resource manager errSt
134. us viPrintf dmm RST CLS n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Configure dmm for DCV measurements 12V maximum errStatus viPrintf dmm CONF VOLT DC 12 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set multimeter trigger source to EXTernal errStatus viPrintf dmm TRIG SOUR EXT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Set multimeter trigger count to 16 errStatus viPrintf dmm TRIG COUN 16 n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Initialize multimeter wait for triggering errStatus viPrintf dmm INIT n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Wait for I second _51 1000 Reset matrix module and clear its status registers errStatus viPrintf E8481A RST CLS n if VI SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errStatus Enable matrix module output pulses on E1406A Trig Out port when a channel is closed errStatus viPrintf E8481A OUTP ON n SUCCESS gt errStatus printf ERROR viPrintf returned errStatus return errSta
135. xes Only one switchbox configuration can use the selected trigger at a time When enabled the selected TTL Trigger bus line 0 to 7 is pulsed by the switchbox each time a scanned channel is closed To disable the output for a specific switchbox send the OUTPut TTLTrgn OFF or 0 command for that switchbox 68 Command Reference Chapter 4 Example One Output Selected at a Time Only one output ECLTrgn TTLTrgn or EXTernal can be enabled at one time Enabling a different output source will automatically disable the active output For example if TTLTrg1 is the active output and TTLTrg4 is enabled TTLTrg1 will become disabled and TTLTrg4 will become the active output Related Commands ROUTe SCAN TRIGger SOURce OUTPut TTLTrgn STATe RST Condition OUTPut TTLTrgn STATe OFF disabled Enabling TTL Trigger Bus Line 7 OUTP TTLT7 STAT 1 Enable TTL Trigger bus line 7 to output pulse after each scanned channel is closed OUTPut TTL Trgn STATe Chapter 4 Example OUTPut TTLTrgn STATe queries the present state of the specified TTL Trigger bus line The command returns 1 if the specified TTL Trg bus line is enabled or 0 if disabled Querying TTL Trigger Bus Line Enable State This example enables TTL Trigger bus line 7 and queries the enable state The OUTPut TTLTrgn command returns 1 since the port is enabled OUTP TTLT7 STAT 1 Enable TTL Trigger bus line 7 OUTP TTLT7 Query bus enable state Command
136. xternal Trigger port is used by the matrix module to trigger the multimeter to perform a measurement E1406A s Trig In port connected to the 34401A multimeter s Voltmeter Complete port is used by the multimeter to advance the matrix scan Chapter 3 Using the Matrix Module 37 For this example Row 00 High and Low of the E8481A matrix module is connected to the multimeter s High and Low The columns 00 through 15 are then scanned and different Device Under Test DUTs are switched in for a measurement E1406A Command Module 5V ov Trig In Trig Out zi 85 7 q y eC 66 00 8 Es T 9 X m N g 5 FEST EA 2e EET f lt 8 pna ra o E8481A Matrix Module M p Mg Ea Be ma C RowA00H__ Agilent 34401A Multimeter from rear view E8481A Opt 106 Terminal Module Figure 3 1 Scanning Channels using Trig In out Ports Programming with The following HTBasic program sets up the external multimeter Agilent HTBasic 34401A to scan making DC voltage measurements The Matrix module has a logical address 112 secondary address 14 and the external multimeter has an address of 722 10 DIM Rdg
137. yf returned errStatus return errStatus printf Module Description is s n m_desp Chapter 3 Using the Matrix Module 29 Query the module type errStatus viQueryf E8481A SYST CTYP 1 n t m type if VI SUCCESS gt errStatus printf ERROR viQueryf returned errStatus return errStatus printf Module Type is s n m_type Close the module instrument session errStatus viClose E8481A if VI SUCCESS gt errStatus printf ERROR viClose returned 0x x n errStatus return 0 Close the resource manager session errStatus viClose viRM if Vl SUCCESS gt errStatus print ERROR viClose returned 0x x n errStatus return 0 return VI SUCCESS Setting Module Function Mode When shipped from the factory the E8481A is configured as a 4x32 matrix module The E8481A matrix module can also be set to function as two independent 4x16 matrixes Use the FUNC card num mode command to set the module to the desired function mode The following example programs were written in HTBasic and Visual C C programming languages They will set the E8481A to function as two independent 4x16 matrixes then query the setting The result is returned to the computer and displayed SINGLE4X32 indicates the module functioned as a 4x32 Matrix DUAL4X16 indicates the module functioned as two independent 4x16 matrixes Example Setting 10 DIM Func 20 D

E8481A 2-Wire 4x32 Relay Matrix Switch Module User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents