Home

Artisan Technology Group is your source for quality new and

1. C C S M 0 O O3 aaa ro AUX INPUT AN ole e RS 232 C RS 232 C gt 0 C lt output AUX OUTPUT CH4 CH5 S EVENT Connector Figure 1 6 RS 232 C port This data generator is designed as DCE device You may connect it up to 15 meters 50 feet from a DTE device using a straight through male to female cable However if the other device is instead configured as a DCE device you will need a special adapter or null modem cable for local DCE to DCE communications Refer to the wiring examples in the Figure 1 8 for the proper signal connections between devices NOTE In this data generator only TxD RxD DTR CTS pins and Signal Ground are available DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started 9 PIN D SHELL 25 PIN D SHELL Ql 1 elo O 1 2 Receive Data RxD 3 O o 2 lt l O 2 3 Transmit Data TxD 2 O Oo 4 slo O 3 4 Data Terminal Ready DTR 20 O O 4 wh O 4 5 Signal Ground 7 O ols O 5 8 Clearto Send CTS 5 O ol a a O S E Q i 5 O 10 O O 11 O O 12 O 13 NOTE TxD RxD DTR CTS and Ground lines are only available in the data generator Figure 1 7 Pin assignments of 9 pin and 25 pin D type shell connector Pin Pin Pin Pin own A Ww
2. DATA SUBSequence ADD DATA SUBSequence CLEAr DATA SUBSequence DEFine DATA SUBSequence DELete ALL DATA SUBSequence DELete lt SName gt lt Line Number gt lt SName gt lt String gt where lt String gt is a sub sequence name surrounded in double or single C quotes lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be deleted DATA SUBSEQUENCE DELETE SUB2 7 deletes the line 7 sub sequence step named SUB2 DATA SUBSequence DELete ALL Group Related Commands Syntax Arguments 2 44 The DATA SUBSequence DELete ALL command deletes the specified sub sequence definitions DATA DATA SUBSequence ADD DATA SUBSequence CLEAr DATA SUBSequence DEFine DATA SUBSequence DELete DATA SUBSequence DELete ALL lt SName gt lt SName gt lt String gt where lt String gt is a sub sequence name surrounded in double or single C quotes DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples DATA SUBSEQUENCE DELETE ALL SUB1 deletes the sub sequence definition named SUB1 DATA SUBSequence REPeat Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The DATA SUBSequence REPeat command sets the sub sequence step repeat count The DATA SUBSequence REPeat query r
3. Syntax Arguments Responses Examples DG2030 Programmer Manual OUTPUT ILEVEL 300mV sets the high impedance control input threshold level to 300 mV The PSC common command controls the automatic power on clearing of the ESER Event Status Enable Register the SRER Service Request Enable Register and DESER Device Event Status Enable Register These registers are used in the status and event reporting system The PSC common query returns status of the power on status clear flag Other DESE ESE FACTory SRE PSC lt Power On Status Clear gt PSC lt Power On Status Clear gt lt NR1 gt where lt NR1 gt is a decimal integer that must range from 32767 to 32767 the value of which determines whether power on clearing occurs as follows Zero value sets the power on status clear flag to FALSE When this flag is set FALSE the values of the DESER the SESR and the ESER are restored at power on With these values restored the instrument can assert SRQ after powering on Nonzero value sets the power on status clear flag to TRUE When this flag is set TRUE all the bits in the DESER are set and are reset in the SESR and ESER This action prevents the instrument from asserting any SRQs after powering on 1 the power on status clear flag is currently set to TRUE 0 the power on status clear flag is currently set to FALSE PSC 1 sets the power on status flag to TRUE PSC might return 0 to indicate
4. cc x x e eee 2 16 Table 2 13 SYSTEM commands ce x x e eee 2 16 Table 2 14 TRIGGER commands x x e x e ee 2 17 Table 2 15 Other commands cc ss see 2 17 Table 3 1 SESR bit functions cece cece ew ee rere eee 3 2 Table 3 2 SBR bit functions e x lt e cece cece eee ee ee renee 3 3 Table 3 3 Definition of event codes sss eee ee 3 9 Table 3 4 Normal condition ss s s s cece eee c cece ee eees 3 10 Table 3 5 Command errors CME Bit 5 cccccecccccece 3 10 Table 3 6 Execution errors EXE Bit 4 lt s sss sese 3 12 Table 3 7 Internal device errors DDE Bit 3 ccceeeee 3 14 Table 3 8 System event and query errors ecc eee eceees 3 14 Table 3 9 Warnings EXE Bit 4 2 cc ccc cee cc cee eee eens 3 15 Table 3 10 Device dependent command execution errors 3 15 Table 3 11 Extended device specific errors sss s s e x s e x e e x e 3 17 Table A 1 The DG2020 Character Set 0 cece eee eeee A 1 Table A 2 ASCII amp GPIB Code Chart 0 cece eens A 2 Table C 1 GPIB interface function implementation C 1 Table C 2 GPIB interface messages ccceccecsceeees C 2 Table D 1 Factory initialized settings cess eeeeee D 1 iv DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Preface This is the
5. A rtisan Artisan Technology Group is your source for quality TecmoogyGroup new and certified used pre owned equipment FAST SHIPPING AND SERVICE CENTER REPAIRS WE BUY USED EQUIPMENT DELIVERY Experienced engineers and technicians on staff Sell your excess underutilized and idle used equipment TENS OF THOUSANDS OF at our full service in house repair center We also offer credit for buy backs and trade ins IN STOCK ITEMS www artisantg com WeBuyEquipment 7 EQUIPMENT DEMOS HUNDREDS OF InstraV ea REMOTE INSPECTION LOOKING FOR MORE INFORMATION MANUFACTURERS Remotely inspect equipment before purchasing with Visit us on the web at www artisantg com 7 for more our interactive website at www instraview com information on price quotations drivers technical LEASING MONTHLY specifications manuals and documentation RENTALS ITAR CERTIFIED SER Ds Contact us 888 88 SOURCE sales artisantg com www artisantg com Programmer Manual Tektronix 7 DG2030 Data Generator 071 0057 50 This document applies to firmware version 1 00 and above www tektronix com Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Copyright Tektronix Inc All rights reserved Tektronix products are covered by U S and foreign patents issued and pending Information in this publication supercedes that in all previously published material Specifications and price change priv
6. Arguments lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set ON orl sets the event jump to on OFF or 0 sets the event jump to off Responses DATA SEQUENCE EVJ lt Line Number gt 1 0 Examples DATA SEQUENCE EVJ 8 0N sets the event jump state for the line 8 sequence step to on 2 38 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SEQuence EVJTO Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The DATA SEQuence EVJTO command sets the sequence step event jump destination The DATA SEQuence EVJTO query returns the event jump destination set for the sequence step DATA DATA SEQuence EVJ DATA SEQuence LOOP DATA SEQuence REPeat DATA SEQuence TWAIT DATA SEQuence EVJTO lt Line Number gt lt Target gt DATA SEQuence EVJT0 lt Line Number gt lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set lt Target gt lt NR1 gt where lt NR1 gt is the line number of the jump destination sequence step DATA SEQUENCE EVJTO lt Line Number gt lt Target gt DATA SEQUENCE EVJTO 5 0 sets the line 5 sequence step event jump destination to line 0 2 39 Artisan Technology Group Quality Instrumentation Guaranteed 888 88
7. DATA BLOCK DEFine Set or query the block definitions DATA BLOCK DE Let e Delete a block definition DATA BLOCk DELete ALL Delete all block definitions DATA BLOCk REName Change a block name DATA BLOCk SIZe Change or query the size of a block DATA GROUp ADD Add a group definition DATA GROUp BIT Change or query a groups bit structure DATA GROUp DEFine Set or query the group definitions DATA GROUp DELete Delete a group definition DATA GROUp DELete ALL Delete all group definitions DATA GROUp NAME Query the name of a group DATA GROUp REName Change a group name DATA MSIZe Set or query the pattern data memory size DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups Table 2 4 DATA commands Cont Header Description DATA PATTern BIT Set or query individual pattern data bits DATA PATTern WORD Set or query pattern data in word units DATA SEQuence ADD Add a sequence step DATA SEQuence DEFine Set or query the sequence definitions DATA SEQuence DELete Delete a sequence step DATA SEQuence DELete ALL Delete all sequence definitions DATA SEQuence EVJ Set or query the event jump on off state DATA SEQuence EVJT0 Set or query the event jump destination DATA SEQuence LOOP Set or query the infinite loop on off state DATA SEQuence REPeat Set or query
8. Perform self test DISPLAY Commands Use these commands to execute functions associated with front panel keys buttons and knobs adjust the screen brightness and perform other display related functions Table 2 7 DISPLAY commands Header Description DISPlay Query settings made with display group commands DISPlay BRIGhtness Set brightness of screen DISPlay CLOCk Set or query the date and time display state DISPlay DIMmer Set or query the state of the display dimmer function DISPlay ENABle Set or query the display on off state DISPlay MENU Query all menu display related information DISPlay MENU NAME Set the menu selection state DISPlay MENU NAME Query the menu selection state DISPlay MENU STATe Set or query the menu display on off state DISPlay WINDow TEXT CLEar DISPlay WINDow TEXT DATA Erase the message display area Set or query the contents of the message display area DG2030 Programmer Manual 2 13 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups HARDCOPY Commands Use these commands to start and stop for hardcopy operation and select port and its outputting format Table 2 8 HARDCOPY commands Header Description HCOPy Query all hardcopy related information HCOPy ABORt Stop the current hardcopy operation HCOPy DATA Create and send hardcopy data HCOPy FORMat
9. The OPC common command causes bit 0 in the SESR Standard Event Status Register to be set and the operation complete message to be issued when all pending operations are finished The OPC query waits until all pending operations are finished and returns a 1 ASCII character Other WAI OPC OPC None HCOPY PORT DISK HCOPY START OPC causes the SESR bit 0 to be set and the operation complete message to be issued on the completion of hardcopy The OPT common query returns the implemented options of the data generator Other None OPT None lt Option gt lt Option gt where 0 indicates no option CH4 CH7 indicates the option 01 4 additional output channels DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples OPT might return CH4 CH7 to indicate that the option 01 is installed in the instrument OUTPut The OUTPUT query returns all the setting state rerated to the channel and clock output Group OUTPUT Related Commands DATA Syntax OUTPut Arguments None Examples OUTPUT might return OUTPUT ELEVEL 0 5 TLEVEL 0 5 CHO HIGH 0 500 LOW 0 500 DELAY 0 00E 0 9 INHIBIT O ASSIGN O RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH1 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT O ASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 sOUTPUT CH2 HIGH 0 500 LOW 0 500
10. 2 34 DATA SEQuence ADD 2 35 DATA SEQuence DEFine 2 36 DATA SEQuence DELete 2 37 DATA SEQuence DELete ALL 2 37 DATA SEQuence EVJ 2 38 DATA SEQuence EVJTO 2 39 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation DATA SEQuence LOOP 2 40 DATA SEQuence REPeat 2 40 DATA SEQuence TWAIT 2 41 DATA SUBSequence ADD 2 42 DATA SUBSequence CLEAr 2 42 DATA SUBSequence DEFine 2 43 DATA SUBSequence DELete 2 44 DATA SUBSequence DELete ALL 2 44 DATA SUBSequence REPeat 2 45 DATA UPDate 2 46 DATA 2 22 DATA BLOCk ADD 2 23 DATA BLOCk DEFine 2 24 DATA BLOCk DELete 2 25 DATA BLOCk DELete ALL 2 25 DATA BLOCk REName 2 26 DATA BLOCKk SIZe 2 26 DATA GROUp ADD 2 27 DATA GROUp BIT 2 28 DATA GROUp DEFine 2 29 DATA GROUp DELete 2 30 DATA GROUp DELete ALL 2 30 DATA GROUp NAME 2 30 DATA GROUp REName 2 31 DATA MSIZe 2 32 DATA PATTern BIT 2 32 DATA PATTern WORD 2 34 DATA SEQuence ADD 2 35 DATA SEQuence DEFine 2 36 DATA SEQuence DELete 2 37 DATA SEQuence DELete ALL 2 37 DATA SEQuence EVJ 2 38 DATA SEQuence EVJTO 2 39 DATA SEQuence LOOP 2 40 DATA SEQuence REPeat 2 40 DATA SEQuence TWAIT 2 41 DATA SUBSequence ADD 2 42 DATA SUBSequence CLEAr 2 42 DATA SUBSequence DEFine 2 43 DATA SUBSequence DELete 2 44 DATA SUBSequence DELete ALL 2 44 DATA SUBSequence REPeat 2 45 DATA UPDate 2 46 Debug commands DEBug 2 46 DEBug SNOop 2 47 DEBug SNOop DELAy 2 48 DEBug SNOop DELAy TI
11. Group DATA Related Commands DATA GROUp ADD DATA GROUp BIT DATA GROUp DELete DATA GROUp DELete ALL DATA GROUp NAME DATA GROUp REN ame Syntax DATA GROUp DEFine lt Groupblock gt DATA GROUp DEFine Arguments lt Groupblock gt lt blockheader gt lt Group gt lt LF gt lt Group gt lt LF gt lt Group gt Arbitrary block data for the group definition where lt blockheader gt lt byte count digit gt lt byte count gt lt Group gt lt AName gt lt AMSB gt lt ALSB gt The lt AName gt lt AMSB gt and lt ALSB gt fields are ASCII character strings that specify the following information lt AName gt group name lt AMSB gt group s high order bit lt ALSB gt group s low order bit lt LF gt lt ASCII line feed code 10 gt Responses DATA GROUP DEFINE lt Groupblock gt where lt Groupb1ock gt is a data block with the same format as the argument Examples DATA GROUp DEFine 238GROUPO1 7 0 lt LF gt GROUPO2 11 8 lt LF gt GROUPO3 15 12 defines the three groups GROUPO1 GROUPO2 and GROUPO3 DG2030 Programmer Manual 2 29 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA GROUp DELete Group Related Commands Syntax Arguments Examples The DATA GROUp DELete command deletes the specified group DATA DATA GROUp ADD DATA GROUp BIT DATA GROUp DEF ine DATA GROUp DELete
12. MMEMory DELete NAME MMEMory DELete ALL None MMEMORY DELETE ALL deletes all files and empty subdirectories in the current directory DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory DELete NAME Group Related Commands Syntax Arguments Examples MMEMory FREE Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The MMEMory DELete NAME command deletes the file or subdirectory with the specified path name However non empty subdirectories are not deleted MEMORY MMEMory DELete ALL MMEMory DELete NAME lt Path Name gt lt Path Name gt lt string gt where lt string gt is the path name of the file or subdirectory to be deleted MMEMORY DELETE NOMORE PDA deletes the file NOMORE PDA in the current directory The MMEMory FREE query returns used size and unused size of the mass memory This query is equivalent to the MMEMory FREE ALL query MEMORY None MMEMory FREE None MMEMORY FREE lt Used Size gt lt Unused Size gt where lt Used Size gt lt NR1 gt and lt Unused Size gt lt NRI1 gt MMEMORY FREE might return MMEMORY FREE 104584 1352704 2 77 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory INI
13. OUTPut CH lt n gt FAL1 VALid lt n gt 0 to 7 None OUTPUT CH lt n gt FALL VALID lt NR3 gt 0 1 1 valid O invalid OUTPUT CHO FALL VALID might return OUTPUT CHO FALL VALID 1 0E 9 1 OUTPut CH lt n gt HIGH Group Related Commands Syntax Arguments Responses 2 90 The OUTPut CH lt n gt HIGH command sets the high level output voltage for the specified channel The OUTPut CH lt n gt HIGH query returns the high level output voltage setting for the specified channel OUTPUT OUTPut CH lt n gt LOW OUTPut CH lt n gt HIGH lt Volt gt OUTPut CH lt n gt HIGH lt n gt 0 to 7 lt Volt gt lt NR2 gt lt Unit gt where lt NR2 gt combined with lt Unit gt specifies a high level voltage and lt Unit gt V mV for volt or millivolt OUTPUT CH lt n gt HIGH lt NR2 gt DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples OUTPUT CH2 HIGH 1V sets the channel 2 high level output voltage to 1 V OUTPut CH lt n gt INHibit The OUTPut CH lt n gt INHibit command sets the control method for the output impedance of the specified channel The OUTPut CH lt n gt INHibit query returns the control method currently used for the output impedance of the channel specified in the header Group OUTPUT Related Commands None Syntax QUTPut CH lt n
14. The following three commands are recognized as identical HEADER ON or header on or header On Abbreviation Any header argument or reserved word that is sent to the data generator can be abbreviated The minimum required spelling is shown in upper case throughout the subsection Command Groups beginning on page 2 11 The command TRIGger SLOPe POSitive can be rewritten in either of the following forms TRIGGER SLOPE POSITIVE or TRIG SLOP POS 2 10 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups This subsection describes the organization of the DG2030 Data Generator command as a number of functional groups See subsection Command Descriptions on page 2 19 for a complete description of each command in alphabetical order Throughout this section the parenthesized question symbol follows the command header to indicate that both a command and query form of the command can be used Command Summaries Tables 2 4 through 2 15 list the command that are part of the 11 functional groups DATA Commands Use these commands to define blocks groups and sequences to set up pattern data and to set which sequence controls become valid when the run mode is set to Enhanced Table 2 4 DATA commands Header Description DATA Query the settings related to pattern data DATA BLOCK ADD Add a block definition
15. cd sample d copy a data Sample Program Functions and Usage Getbit 4 6 This section describes the functions of the sample programs and their use Words set in italics are abstract parameters that must be replaced with actual character strings This program reads out bit pattern data from DG2030 data memory in bit units and displays that data on the screen The bit number 0 to 7 to be read out is specified as command line arguments If multiple arguments are specified separated by spaces the bit data is displayed in the specified order This command has the following syntax getbit bit_number bit_number Bit data is read out from the whole range of memory data set up in the DG2030 that is data is read out from address 0 to the maximum address The program displays the memory size the starting address always 0 and the bit number parameters and then the bit data for those parameters The parameters are displayed starting with a number sign character each on its own line The bit data is expressed as a sequence of the characters 0 and 1 representing those bit values The listing below shows the output from reading out bits 3 and 2 when the memory size is 90 size 90 start 0 bit 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 0 0 0 1 0 0 0 1 1 1 1 1 1 0 0 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 1 1 1 1 0 0 0 0 bit 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
16. putblk DG2030 Programmer Manual Reads out bit patterns from the DG2030 data memory in bit units and displays that data on the screen Since standard output is used for data display the output can be redirected to a file for storage This is an example of a program that reads out bit pattern data This program is provided in both C and BASIC versions Transfers bit units pattern data stored in a file by the getbit program described above to DG2030 data memory This is an example of a program that writes bit pattern data Reads out bit patterns from the DG2030 memory in word units and displays that data on the screen Since standard output is used for data display the output can be redirected to a file for storage This is an example of a program that reads out bit pattern data Transfers word units pattern data stored in a file by the getword program described above to DG2030 data memory This is an example of a program that writes bit pattern data Sets up a block definition section in the DG2030 data memory using data from a file prepared in advance This program presents an example of the use of the block definition command 4 1 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples putgrp putseq putsub intcom Sets up a group definition section in the DG2030 data memory using data from a file prepared in advance This program presents an exampl
17. 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Since the result is displayed on standard output the data can be saved by redirecting the output to a file This file can be used as an input to the putbit program described below Putbit This program sends bit pattern data to the DG2030 data memory in bit units Data input is from a file in a unique format This command has the following syntax with the input data file name being specified as a parameter putbit filename The contents of the input file must express the data length start address and bit number parameters as well as the bit data itself in ASCII text Each parameter must appear on a separate line and start with a number sign character Bit data is expressed as a sequence of the characters 1 and 0 representing the bit values This format is the same format as that produced by redirecting the output of the getbit program The file patbit dat is a sample data file in this format Input format checking has been dispensed with to make this sample program easier to understand This program may not operate correctly if the format of the input file is not correct Getword This program reads out bit pattern data from DG20
18. ALL DATA GROUp NAME DATA GROUp REN ame DATA GROUp DELete lt Name gt lt Name gt lt string gt where lt string gt is the name of the group to delete DATA GROUP DELETE GROUPO2 deletes the group with the name GROUPO2 DATA GROUp DELete ALL Group Related Commands Syntax Arguments DATA GROUp NAME Group 2 30 The DATA GROUp DELete ALL command deletes all group definitions DATA DATA GROUp ADD DATA GROUp BIT DATA GROUp DEFine DATA GROUp DE Lete DATA GROUp NAME DATA GROUp REName DATA GROUp DELete ALL None The DATA GROUp NAME query returns the name of the group that includes the specified bit DATA DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Related Commands DATA GROUp ADD DATA GROUp BIT DATA GROUp DEFine DATA GROUp DE Lete DATA GROUp DELete ALL DATA GROUp REName Syntax DATA GROUp NAME lt Bit gt Arguments lt Bit gt lt NR1 gt where lt NR1 gt is the number of the bit to be queried 0 to 7 Responses DATA GROUP NAME lt Bit gt lt Name gt where lt Bit gt lt NR1 gt a bit number 0 to 37 lt Name gt lt string gt the group name Examples DATA GROUp NAME lt 6 gt might return DATA GROUP NAME 6 GROUPO02 which indicates that the name of the group that includes the DATA6 bit is GROUPO2 DATA GROUp REName
19. Appendix C Interface Specification e e x cece eee eens C 1 Interface FUNCHONS ece ZE Hcp ee i ee PO d RAT ele C l Interface Messages s Xd aR Nd aa d aR sede beled nace bated bent es C 2 Appendix D Factory Initialization Settings D 1 Glossary amp Index GOSS ceranae sone TR TET opis TR aris aU ETTR T A vend Ta ose Glossary 1 VTA OK casero aye 5 0cii e osha 4 4 4 a wrerdare ore eti Eke ard Wa wee arenas aa Index 1 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Table of Contents List of Figures Figure 1 1 Functional layers in GPIB system 64 1 1 Figure 1 2 GPIB connector e x e c cece cece cee cece eee 1 3 Figure 1 3 GPIb system configurations cece eens 1 4 Figure 1 4 GPIB parameter settings cece eee eens 1 5 Figure 1 5 RS 232 C point to point connection 1 6 Figure 1 6 RS 232 C port cece cece RRR RRR RRR srs 1 7 Figure 1 7 Pin assignments of 9 pin and 25 pin D type shell connector x x e e eee e cece eee 1 8 Figure 1 8 Typical RS 232 C cable wiring requirements 1 8 Figure 1 9 RS 232 C parameter settings ce ee eeeee 1 9 Figure 2 1 Command and query structure flowchart 2 2 Figure 2 2 ABSTouch arguments and associated controls 2 20 Figure 2 3 GPIB Retrieving Respon
20. DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH3 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH4 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH5 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH6 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CH7 HIGH 0 500 LOW 0 500 DELAY 0 00E 09 INHIBIT 0 sASSIGN 1 RISE 0 00E 9 FALL 0 00E 9 DESKEW 0 00E 09 OUTPUT CHCLK HIGH 0 500 LOW 0 500 INHIBIT O RISE 0 00E 9 FALL 0 00E 9 OUTPUT DEFINE 2470 0 0 lt LF gt 1 1 0 lt LF gt 2 2 0 lt LF gt 3 3 0 lt LF gt 4 4 0 lt LF gt 5 5 0 lt LF gt 6 6 0 lt LF gt 7 7 0 DG2030 Programmer Manual 2 85 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt ASSIGn 2 Group Related Commands Syntax Arguments Responses Examples The OUTPut CH lt n gt ASSTGn command assigns a data bit to the specified channel The OUTPut CH lt n gt ASSIGn query returns the data bit assigned to the specified channel A bit number of 1 is returned if no data bit is assigned to the channel OUTPUT OUTPut CH lt n gt RELEase OUTPut DEFine OUTPut CH lt n gt ASSIGn lt Bit gt OUT
21. Definition of event codes Event code Event class ranges Descriptions No Events 0 1 No event nor status Reserved 2 99 unused Command Errors 100 199 Command errors Execution Errors 200 299 Command execution errors Device Specific Errors 300 399 Internal device errors Hardware errors Query Errors 400 499 System event and query errors Execution Warnings 500 599 Execution warnings Reserved 600 1999 unused Extended Execution Errors 2000 2999 Device dependent command execution errors Extended 3000 3999 Device dependent device errors Device Specific Errors Reserved 4000 unused DG2030 Programmer Manual 3 9 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages 3 10 Table 3 4 lists the message when the system has no events nor status to report These have no associated SESR bit Table 3 4 Normal condition Code Description 0 No events to report queue empty 1 No events to report new events pending ESR Table 3 5 lists the error messages generated due to improper command syntax In this case check that the command is properly formed and that it follows the syntax Table 3 5 Command errors CME Bit 5 Code Description 100 Command error 101 Invalid character 102 Syntax error 103 Invalid separator 104 Data type error 105 GET not allowed 106 Invalid program data separator 108 Parameter not allowed 109 Mis
22. FREQUENCY lt NRf gt HZ SOURCE OSCILLATOR INTERNAL FREQUENCY 100MHZ sets the internal clock oscillator frequency to 100 MHz 2 107 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions SOURCce OSCillator INTernal PLLlock Group Related Commands Syntax Arguments Responses Examples The SOURce 0SCillator INTernal PLL ock command sets whether or not the internal clock oscillator is phase synchronized by PLL operation with the reference oscillator The SOURce 0SCillator INTernal PLLlock query returns whether or not the internal clock oscillator is phase synchronized by PLL operation with the reference oscillator SOURCE SOURce 0SCillator SOURce 0SCillator EXTernal FREQuency SOURce 0SCillator INTernal FREQuency SOURce 0SCillator SOURce SOURce 0SCillator INTernal PLLlock ON OFF 1 0 SOURce 0SCillator INTernal PLLlock ON or 1 The phase is synchronized PLL on OFF or 0 The phase is not synchronized PLL off SOURCE OSCILLATOR INTERNAL PLLLOCK 1 0 SOURCE OSCILLATOR INTERNAL PLLLOCK ON synchronizes the internal clock oscillator with the reference oscillator SOURCce OSCillator SOURCe Group Related Commands Syntax 2 108 The SOURce 0SCillator SOURce command sets whether the internal clock oscillator or an external clock input signal is used as the clock signal source Th
23. IMPEDANCE LOW LEVEL 1 400 SLOPE POSITIVE SOURCE INTERNAL INTERVAL TIME 1 0us STATE 1 DG2030 Programmer Manual 2 115 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions TRIGger IMPedance Group Related Commands Syntax Arguments Examples TRIGger INTERVal Group Related Commands Syntax Arguments Responses Examples 2 116 The TRIGger IMPedance command selects high impedance 1 kQ or low impedance 50 Q for the external trigger input connector The TRIGger IMPed ance query returns currently selected impedance TRIGGER TRIGger LEVel TRIGger SLOPe TRIGger SOURce TRIGger IMPedance HIGH LOW TRIGger IMPedance HIGH selects high impedance kQ LOW selects low impedance 50 Q TRIGGER IMPEDANCE LOW selects low impedance The TRIGger INTERVal query returns the interval time and the state of the internal trigger TRIGGER TRIGger INTERVal STATe TRIGger INTERVal TIME TRIGger INTERVal None TRIGGER INTERVAL TIME lt Time gt s STATE 1 0 TRIGGER INTERVAL might returns TRIGGER INTERVAL TIME 1 0MS STATE 1 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions TRIGger INTERVal STATe 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programme
24. PN oon A Ww PP oon A O PN oon A PNP 9 pin DCE to 9 pin DTE 9 pin DCE to 9 pin DCE Pin Pin Pin Pin 2 3 3 5 n CO gt lt 7 Ka 20 8 7 i ee 9 pin DCE to 25 pin DTE 9 pin DCE to 25 pin DCE own A Ww PP NOTE When using software flow control the CTS DTR lines do not need to be connected Figure 1 8 Typical RS 232 C cable wiring requirements 1 8 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started Setting the RS 232 Parameters Serial Menu DG2030 Programmer Manual To set the RS 232 C parameters perform the following steps Remote Port s Press the UTILITY button in the MENU column to the right of the screen The UTILITY menu appears above the bottom menu buttons Press the System bottom menu button to display the System menu See Figure 1 9 Select the Baudrate item from the Serial menu using the up and down arrow buttons Here select the data transfer rate using the left and right arrow buttons The rate can be set to 300 600 1200 2400 4800 9600 or 19200 baud Select the Data Bits item from the Serial menu using the up and down arrow buttons Then use the left and right arrow buttons to select the data bit length for each character The bit length can be set to either 7 or 8 bits Select the Parity item from the Serial menu using the up and down arrow button
25. SRER bits are set in binary bit according to the decimal number SRE 48 sets the SRER to 48 binary 00110000 which sets the ESB and MAV bits SRE might return 32 which indicates that the SRER contains the binary number 00100000 2 109 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions STARt Group Related Commands Syntax Arguments Examples STB Group Related Commands Syntax Arguments Responses Examples 2 110 The STARt command sets the instrument to the start state If the run mode is set to repeat or step pattern data or sequence output starts If the run mode is set to single then the instrument goes to the trigger wait state Other RUNNing STOP TRG STARt None START sets the instrument to the start state The STB common query returns the value of the SBR Status Byte Register Bit 6 of the SBR is read as a MSS Master Status Summary bit Refer to Section 3 Status and Events for more details on the SBR Other CLS DESE ESE ESR EVENT EVMsg EVQty SRE STB None lt NR1 gt which is a decimal number STB might return 96 which indicates that the SBR contains the binary number 01100000 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions STOP Group Related
26. Set or query output format of hardcopy HCOPy PORT Set or query output port of hardcopy HCOPy START Start a hardcopy operation MEMORY Commands Use these commands to control all floppy disk and file operations Table 2 9 MEMORY commands Header Description MMEMory CATalog ALL Query disk file and directory information MMEMory CATalog ORDer Set or query the display order for disk file and directory information MMEMory CDIRectory Set or query the current working directory MMEMory COPY Copy a disk file MMEMory DELete ALL Delete all files and directories on the disk MMEMory DELete NAME Delete the specified file or directory on the disk MMEMory FREE Query disk memory usage MMEMory INITialize Format a disk MMEMory LOAD Read data from a disk file MMEMory LOCK Set or query the disk file lock state MMEMory MDIRectory Make a new directory on the disk MMEMory RDIRectory Remove a directory on the disk MMEMory REName Change the name of a disk file or directory MMEMory SAVE Write data to a disk file 2 14 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups MODE Commands Table 2 10 MODE commands Header MODE MODE STATe Use these commands to set the run and update modes Description Query the states related to pattern generation Set or query the run mode for pattern generation MODE UPDate Set or
27. Summary bit when obtained from STB query Summarizes the ESB and MAV bits in the SBR In other words that status is present and enabled in the SESR or a message is available at the Output Queue or both 5 The ESB Event Status Bit Shows that status is enabled and present in the SESR 4 The MAV Message Available bit Shows that output is available in the Output Queue 3 0 Not used Must be set to zero for data generator operation 1 When operating over the RS 232 C interface you can read the contents of the SBR using the STB query However this bit ESB is the only SBR bit of any signifi cance to RS 232 C operation DG2030 Programmer Manual 3 3 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting Enable Registers You use the DESER Device Event Status Enable Register the ESER Event Status Enable Register and the SRER Service Request Enable Register to select which events are reported to the Status Registers and the Event Queue Each of these Enable Registers acts as a filter to a Status Register the DESER also acts as a filter to the Event Queue and can allow or prevent information from being recorded in the register or queue Each bit in an Enable Register corresponds to a bit in the Status Register it controls In order for an event to be reported to its bit in the Status Register the corresponding bit in the Enable
28. TRIGger SLOPe POSITIVE TRIGger SOURce EXTERNAL DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix D Factory Initialization Settings Table D 1 Factory initialized settings Cont Header Default settings Other commands DESE 256 ESE 0 HEADer 1 LOCk NONE PSC 1 SRE 0 VERBose 1 DG2030 Programmer Manual D 3 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix D Factory Initialization Settings D 4 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com T ns Glossary ASCII Acronym for the American Standard Code for Information Interchange Controllers transmit commands to the instrument using ASCII character encoding Address A 7 bit code that identifies an instrument on the communication bus The instrument must have a unique address for the controller to recognize and transmit commands to it BNF Backus Naur Form A standard notation system for command syntax diagrams The syntax diagrams in this manual use BNF notation Controller A computer or other device that sends commands to and accepts responses from the digitizing oscilloscope EOI A mnemonic referring to the control line End or Identify on the GPIB interface bus One of the two possible end of message ter
29. The DATA GROUp REName command changes the name of a group Group DATA Related Commands Syntax Arguments Examples DG2030 Programmer Manual DATA GROUp ADD DATA GROUp BIT DATA GROUp DEFine DATA GROUp DE Lete DATA GROUp DELete ALL DATA GROUp NAME DATA GROUp REName lt From groupname gt lt To groupname gt lt From groupname gt lt string gt where lt string gt is the name of the group before it is renamed lt To groupname gt lt string gt where lt string gt is the name of the group after it is renamed DATA GROUP RENAME GROUPO3 GROUPO4 changes the name of the group GROUPO3 to be GROUP04 2 31 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA MSIZe 2 Group Related Commands Syntax Arguments Responses DATA PATTern BIT Group Related Commands Syntax 2 32 The DATA MSIZe command sets the bit pattern section memory area size The DATA MSIZe query returns the bit pattern section memory area setting DATA None DATA MSIZe lt Memory Size gt DATA MSIZe lt Memory Size gt lt NRI gt where lt NR1 gt is the number that expresses the memory size in words DATA MSIZE lt Memory Size gt The DATA PATTern BIT command sets the data memory bit pattern section Data is given in bit units The DATA PATTern BIT query returns the contents of the data memory bit
30. and front panel controlled functions except the ON STBY function the edit function and the GPIB and RS 232 C parameter setup functions can be performed through the GPIB or the RS 232 C interface using the programming command set described in Section 2 The GPIB interface conforms to ANSI IEEE Std 488 1 1987 which specifies the hardware interface its basic functional protocol and a set of interface messages codes that control the interface functions This instrument also conforms to ANSI TIEEE Std 488 2 1987 which specifies Codes Formats Protocols and Common Commands to support the system application The functional layers of the GPIB system are shown in Figure 1 1 BUS Device specific Messages gt i Common Commands and Queries Syntax and Data Structures Fona INTFC D C B A A B C D lt System Component x gt System Component y gt Specified IEEE 488 2 IEEE 488 1 IEEE 488 2 Specified by Standard Standard Standard by Device Device A Interface Function Layer B Message Communication Function Layer C Common System Function Layer D Device Function Layer Figure 1 1 Functional layers in GPIB system Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started Choosing an Interface The RS 232 C interface which was established by the Elec
31. as a parameter putseq filename The contents of the input file must express the block name the repeat count the line number of the event jump destination the trigger wait on off setting the event jump on off setting and the infinite loop on off setting in ASCII with one step per line This format corresponds to the parameter block supplied to the DATA SEQUENCE DEFINE command with the delimiter codes replaced by the newline code used in normal text files The first line in this file corresponds to sequence line number 0 and each following line to the sequence line number incremented by 1 See the seqdef dat sample data file Input format checking has been dispensed with to make this sample program easier to understand This program may not operate correctly if the format of the input file is not correct In particular note that commas are used to delimit the parameters in this input file and that spaces may not be inserted Putsub This program sends subsequence definition data to the DG2030 data memory Data input is from a file in a unique format This command has the following syntax with the input data file name being specified as a parameter putsub filename The contents of the input file must express the block name and the repeat count in ASCII with one step per line This format corresponds to the parameter block supplied to the DATA SUBSEQUENCE DEFINE command with the delimiter codes replaced by the newline code used in nor
32. as the external controller the response message will be displayed on the CRT immediately after the query command is typed in Unlike the GPIB interface if an RS 232 C interface is used response messages will never be deleted even if query commands are sent one after another DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com I Status and Event Reporting Registers Status Registers DG2030 Programmer Manual This section describes how the DG2030 Data Generator reports its status and internal events for both the GPIB and RS 232 C interfaces It describes the elements that comprise the status and events reporting system and explains how status and events are handled The status and event reporting system reports certain significant events that occur within the data generator It is made up of five registers plus two queues Four of the registers and one of the queues are compatible with IEEE Std 488 2 1987 the other register and queue are specific to Tektronix The registers fall into two functional groups R Status registers which store information about the status of data generator They include the Standard Event Status Register SESR and the Status Byte Register SBR R Enable registers which determine whether certain events are reported to the Status Registers and the Event Queue They include the Device Event Status Enable Register DESER th
33. be a query If neither symbol follows the command it can only be used as a command The ABSTouch command performs the same action that actuating the correspond ing front panel key button or knob would do DISPLAY None ABSTouch BOTTOM1 BOTTOM6 BOTTOM7 BOTTOM2 BOTTOM3 BOTTOM4 BOTTOMS SIDE SIDE2 SIDE3 SIDE4 SIDES CLEARMenu SETUp EDIT APPLication UTILity CURSor EXECute UParrow DOWNarrow LEFTarrow RIGHtarrow KNOBLeft KNOBRight RUN STEp ZERo ONE TWO THREe FOUR FIVe SIX SEVen EIGHt NINe POINt A MINUs B HZ S V C KHZ MS MV D MHZ US E NS F DELete ENTer HARDcopy MANual Sending any of the arguments that are shown in Figure 2 2 is the equivalent of operating a front panel control Which argument corresponds to which control is shown in Figure 2 2 Sending an argument corresponding to a front panel button is the same as pressing that button once if the argument sent corresponds to a knob it is the same as rotating the knob clockwise or counterclockwise by 45 of a turn 2 19 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions CU
34. com Command Descriptions Examples WAI Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual VERBOSE ON sets long header for query responses VERBOSE might return VERBOSE 1 which indicates that the long response header is currently selected The WAI common command prevents the data generator from executing any further commands or queries until all pending operations are completed Other OPC WAI None WAI prevents the execution of any commands or queries until all pending operations complete 2 123 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions 2 124 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com IT E Retrieving Response Messages The method used for retrieving response messages differs depending on whether a GPIB interface or an RS 232 C interface is used Figures 2 3 and 2 4 give an overview of these methods Controller DG2030 Data Generator Query Command execution controller Queuing Retrieve operation Output Output queue queue controller Response message Figure 2 3 GPIB Retrieving Response Messages Controller DG2030 Data Generator Query Command execution controller Output Output buffer Response message Figur
35. current working directory path MEMORY MMEMory MDIRectory MMEMory CDIRectory lt Directory Path gt MMEMory CDIRectory lt Directory Path gt lt string gt where lt string gt is the name of the new current working directory MMEMORY CDIRECTORY lt Directory Path gt MMEMORY CDIRECTORY DG WORK3 changes the current working directory to DG WORK3 2 75 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory COPY Group Related Commands Syntax Arguments Examples MMEMory DELete ALL Group Related Commands Syntax Arguments Examples 2 76 The MMEMory COPY command copies a file on the disk and creates a new file If the copy destination file already exists an error is issued and the existing file is not overwritten MEMORY MMEMory DELete ALL MMEMory DELete NAME MMEMory COPY lt From path gt lt To path gt lt From path gt lt string gt where lt string gt is the path name of the source file lt To path gt lt string gt where lt string gt is the path name of the destination file MMEMORY COPY MYDATA PDA MYWORK PDA copies the file MYDATA PDA in the current directory and creates a new file MYWORK PDA in the current directory The MMEMory DELete ALL command deletes all files and subdirectories in the current directory However non empty subdirectories are not deleted MEMORY
36. data is given in word units The DATA PATTern WORD query returns the contents of the data memory bit pattern section Group DATA Related Commands DATA PATTern BIT Syntax DATA PATTern WORD lt Address gt lt Length gt lt Data gt DATA PATTern WORD lt Address gt lt Length gt Arguments lt Address gt lt NR1 gt where lt NR1 gt is a start address 0 to 262143 lt Length gt lt NR1 gt data length 1 to 262144 lt Data gt lt block gt arbitrary block data for the bit pattern section Example where the data length is 50 2 5 0 lt byte 1 gt lt byte 2 gt lt byte 50 gt Number of digits lt byte 1 gt Number of bytes bit 7 0 Each word 8 bits of the bit pattern data is expressed as each byte The most significant bit MSB of each byte is correspond to bit 7 The data block is formed by iterating this method for each word in order starting with the start address Responses DATA PATTERN WORD lt Address gt lt Length gt lt Data gt 2 34 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SEQuence ADD The DATA SEQuence ADD command adds a sequence step Group DATA Related Commands _ DATA SEQuence DEFine DATA SEQuence DELete DATA SEQuence DE Lete ALL Syntax DATA SEQuence ADD lt LineN gt lt Name gt lt Repeat gt lt To gt lt WaitE gt lt Jump
37. from the remote interface in the CRT screen message area If commands are connected by semicolons each message is displayed for the time specified with the DEBug SNOop DELAy TIME command The display format is as follows Control codes lt code decimal display gt e g LF is displayed as lt 10 gt Alphanumerics and symbols lt code ASCII display gt e g A is displayed as A Message termination lt PMT gt Interface messages lt DCL gt and lt GET gt Others are displayed as lt code decimal display gt Block data 0 Any data other than one of the above lt code decimal display gt e g a code value of 80 hexadecimal would be displayed as lt 128 gt DEBUG DEBug DEBug SNOop DEBug SNOop DELAy DEBug SNOop TIME DEBug SNOop STATe ON OFF lt NR1 gt DEBug SNOop STATe ON or nonzero value enables the debugging function OFF or zero value clears the debugging function DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Responses Examples DESE Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual 1 the debugging function is currently set 0 the debugging function is currently cleared DEBUG SNOOP STATE ON enables the debugging function The DESE command sets the bits of the DESER Device E
38. in ASCII The DATA BLOCk DEFine query returns the whole block definition section DATA DATA BLOCK ADD DATA BLOCK DELete DATA BLOCK DEL ete ALL DATA BLOCk REName DATA BLOCk SIZe DATA BLOCk DEFine lt Blockinfo gt DATA BLOCk DEFine lt Blockinfo gt lt blockheader gt lt B1 kdef gt lt LF gt lt B1 kdef gt lt LF gt lt Blkdef gt Arbitrary block data for the block definition where lt blockheader gt lt byte count digit gt lt byte count gt lt Bl kdef gt lt APosition gt lt AName gt lt Aposition gt is the block starting position specified in ASCII Note that the starting position of the first block must be zero and lt AName gt is the block name specified in ASCII lt LF gt lt ASCII line feed code dec 10 gt DATA BLOCk DEFINE lt Blockinfo gt where lt Blockinfo gt is a data block in the same format as the argument DATA BLOCk DEFine 2320 BLOCKO lt LF gt 512 BLOCK1 lt LF gt 1024 BLOCK2 defines three blocks BLOCKO0 BLOCK1 and BLOCK2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA BLOCk DELete Group Related Commands Syntax Arguments Examples The DATA BLOCK DELete command deletes the specified block Note that the first block cannot be deleted DATA DATA BLOCK ADD DATA BLOCK DEFine DATA BLOCK DEL ete ALL DATA BLOCKk RENam
39. pattern data and block group sequence and setup information stored in the internal memory into a disk file in DG2030 Data Generator format MEMORY MMEMory LOAD MMEMory SAVE lt Path Name gt lt Path Name gt lt string gt where lt string gt is the path name of the file MMEMORY SAVE NEWDATA PDA saves all the information in internal memory to the file NEWDATA PDA in the current working directory 2 81 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MODE Group Related Commands Syntax Arguments Responses Examples MODE STATe 2 Group Related Commands Syntax Arguments 2 82 The MODE query returns all the setting states related to the pattern generation mode MODE MODE STATe MODE UPDate MODE None MODE STATE REPEAT SINGLE STEP ENHANCED UPDATE AUTO MANUAL MODE might return MODE STATE REPEAT UPDATE AUTO Here the run mode is set to repeat and the output pattern update method is set to automatic See the items on the MODE STATe and MODE UPDate commands The MODE STATe command sets the run mode for pattern generation The MODE STATe query returns the pattern generation run mode setting MODE MODE MODE STATe REPeat SINGle STEp ENHanced MODE STATe REPeat Pattern data output is repeated SINGle Pattern data output is performed exactly once STE
40. pattern section DATA DATA PATTern WORD DATA PATTern BIT lt Bit Position gt lt Address gt lt Length gt lt Data gt DATA PATTern BIT lt Bit Position gt lt Address gt lt Length gt DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses DG2030 Programmer Manual lt Bit Position gt lt NR1 gt bit position 0 to 7 lt Address gt lt NR1 gt start address 0 to 262143 lt Length gt lt NR1 gt data length 1 to 262144 lt Data gt lt block gt arbitrary block data for the bit pattern section Example where the data length is 128 3128 lt bit 1 gt lt bit 2 gt lt bit 128 gt Number of digits lt bit N gt 110 Number of bits The value of the data bit at the specified address is specified with the ASCII character for 0 or 1 Data bits for the specified data length are stored in address order with all bits expressed similarly in ASCII The number of bytes in the block header will be equal to the length of the specified data DATA PATTERN BIT lt Bit Position gt lt Address gt lt Length gt lt Data gt 2 33 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA PATTern WORD 2 The DATA PATTern WORD command sets the data memory bit pattern section The
41. sequence step DATA DATA SUBSequence DEFine DATA SUBSequence DELete DATA SUBSequence DELete ALL DATA SUBSequence ADD lt Sname gt lt LineN gt lt Name gt lt Repeat gt lt Sname gt lt String gt where lt string gt is a sub sequence name surrounded in double or single C quotes lt LineN gt lt NR1 gt where lt NR1 gt is a sub sequence step number lt Name gt lt String gt where lt string gt is a block name surrounded in double or single C quotes lt Repeat gt lt NR1 gt where lt NR1 gt is a repeat count 1 to 65536 DATA SUBSEQUENCE ADD SUB1 2 BLOCK3 10 adds a sub sequence step that consists of the block named BLOCK3 at the sub sequence line number 2 position in the sub sequence named SUB 1 DATA SUBSequence CLEAr Group Related Commands Syntax Arguments 2 42 The DATA SUBSequence CLEAr command clears all sub sequence definitions DATA DATA SUBSequence ADD DATA SUBSequence DEFine DATA SUBSequence DELete DATA SUBSequence DELete ALL DATA SUBSequence DELete CLEAr None DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SUBSequence DEFine The DATA SUBSequence DEE ne command sets up all of the sub sequence definition section information in ASCII The DATA SUBSquence DEFine query returns all of the sub sequence def
42. sets the hard copy output destination to a file on the floppy disk 2 69 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions HCOPy STARt Group Related Commands Syntax Arguments Examples HEADer Group Related Commands Syntax Arguments Responses 2 70 The HCOPy STARt command starts hardcopy output HARDCOPY HCOPy ABORt HCOPy STARt None HCOPY START starts hardcopy output The HEADer command enables or disables the command header responses to all queries except IEEE Std 488 2 common commands The HEADer query returns the status indicating whether the command header responses are enabled or not Other VERBose HEADer ON OFF lt NR1 gt HEADer ON or nonzero value enables the command header responses OFF or zero value disables the command header responses 1 command header responses are currently enabled 0 command header responses are currently disabled DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual HEADER OFF disables the command header responses HEADER might return 1 which indicates command headers are currently enabled for return in query responses The ID qu
43. to set the SRER Use the SRE query to read it The RQS bit remains set to one until either the Status Byte Register is read with a Serial Poll or the MSS bit changes back to a zero 7 5 4 3 2 1 ESB MAV Figure 3 5 The Service Request Enable Register SRER Queues The status and event reporting system contains two queues the Event Queue and the Output Queue The Event Queue which is used when operating with either the GPIB and RS 232 C interface while the Output Queue is used only when operating over the GPIB interface Instead of using an output queue an output buffer buffers query response messages for immediate transfer to the data transmission line for RS 232 C operation Output Queue The Output Queue is a FIFO First In First Out queue that hold response messages while until they are requested When a message is put in the queue the MAV bit of the Status Byte Register SBR is set The Output Queue empties each time the data generator receives a new command or query Therefore the controller must read the output queue before it sends the next command or query command or it will lose responses to earlier queries If a command or query command is given without taking it out an error results and the Output Queue is emptied Event Queue The Event Queue is a FIFO queue which can hold up to 20 data generator gener ated events When the number of events exceeds 20 the 20 event is replaced by the event code 350 Qu
44. 10 lists status messages that are specific to the data generator These messages appear when a operation starts ends or is in process These messages have no associated SESR bit Table 3 10 Device dependent command execution errors Code Description 2000 File error 2001 Directory not empty 2002 Too many files 2003 File locked 2004 File already exists 2005 File already opened 2006 Invalid file type 2007 File type mismatch 2008 Internal memory full 2009 Invalid file format 2010 Comment error 2012 Invalid data in comment string 2020 Pattern data error 2021 To much pattern data 2022 Pattern data byte count error 2023 Pattern data load error 2024 Internal pattern memory full 2025 Invalid pattern size 2026 Invalid pattern data 2030 Sequence error 2032 Too much sequence data 2033 Invalid sequence repeat count Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages 3 16 Table 3 10 Device dependent command execution errors Cont Code 2034 Description Invalid sequence syntax 2035 Sequence load error 2036 2037 2038 2039 Internal sequence memory full No sequence Invalid sequence number Sequence incomplete 2040 2041 2042 2050 Data error Invalid data syntax Invalid data value Time error 2051 2052 2060 Invalid time syntax Invalid time value Invalid group name 2061 Group n
45. 2 56 The DISPlay BRIGhtness command adjusts the brightness of the screen the DISPlay BRIGhtness query returns the current brightness setting DISPLAY DISPlay DISPlay BRIGhtness lt Value gt DISPlay BRIGhtness lt Value gt lt NRf gt where lt NRf gt is a real number ranging from 0 to 1 DISPLAY BRIGHTNESS 0 7 sets screen brightness to 70 of maximum intensity The DISPlay CLOCk command sets whether or not the data and time are displayed The DISPlay CLOCk query returns whether or not the data and time are displayed DISPLAY DISPlay DISPlay CLOCk ON OFF 1 0 DISPlay CLOCk ON or 1 sets the data generator to display the date and time OFF or 0 sets the data generator to not display the date and time DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Responses Examples DISPlay DIMmer 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual 1 Date and time is currently displayed 0 Date and time is currently not displayed DISPLAY CLOCK ON sets the data generator to display the date and time The DISPlay DIMmer command sets whether or not the screen dimmer function operates The DISPlay DIMmer query returns the on off state of the screen dimmer function When the dimmer function is on if no front panel controls are used for abo
46. 23 35 33 51 43 67 53 83 63 99 73 115 4 spc 24 DCL 44 LAM 64 LA20 104 TM 124 TA20 164 SA20 0100 EOT DC4 4 D T t 4 4 14 20 24 36 34 52 44 68 54 84 74 116 5 PPC 25 PPU 45 LAS 65 LA21 105 TAS 125 TA21 165 SA21 0101 ENQ NAK 5 E U u 5 5 15 2 25 37 35 53 45 69 55 85 75 117 6 26 46 LA6 66 LA22 106 TA6 126 TA22 166 SA22 0110 ACK SYN amp 6 F V V 6 6 16 22 26 38 36 54 46 70 56 86 76 118 7 27 47 LA7 67 LA23 107 TA7 127 TA23 167 SA23 011i BEL ETB 7 G W W 7 7 417 23 27 39 37 55 47 HB 57 87 77 119 10 GET 30 SPE 50 Las 70 LA24 110 Tas 130 TA24 170 SA24 1000 BS CAN 8 H X X 8 8 18 24 28 40 38 56 48 72 58 88 78 120 11 TCT 31 SPD 51 Lag 71 LA25 111 Tag 131 TA25 171 SA25 1001 HT EM 9 l Y y 9 9 19 25 29 41 39 57 49 73 59 89 79 121 12 32 52 LA10 72 LA26 112 Taio 132 TA26 172 SA26 1010 LF SUB k 2 J Z Z A 10 1A 26 2A 42 3A 58 4A 74 5A 90 7A 122 13 33 53 Lait 73 LA27 113 Tait 133 TA27 173 SA27 1011 VT ESC K B 11 1B 27 2B 43 3B 59 4B 75 5B 91 7B 123 14 34 54 LA12 74 LA28 114 TA12 134 TA28 174 SA28 1100 FF FS s lt L i C 12 1C 28 2c 44 3C 60 4c 76 5C 92 7C 124 15 35 55 LA13 75 LA29 115 TA13 135 TA29 175 SA29 1101 CR GS M D 13 1D 29 2D 45 3D 61 4D 77 5D 93 7D 125 16 36 56 LA14 76 LA30 116 TA14 136 TA30 176 SA30 1110 so RS s gt N E 14 1E 30 2E 46
47. 30 GPIB commands the program s internal built in commands and redirection commands can be used as intcom commands These commands are described in detail below GPIB commands All commands and queries defined in this manual may be used If a question mark character appears in the input character string the command is interpreted as a query command The program waits for the DG2030 response automatically extracts that response and displays it on the screen If an error occurs the program extracts the event code and event message from the event queue and displays them on the screen m Built in commands Intcom supports the following built in commands exec filename Reads in commands from a file one line at a time and executes them through the end of the file This allows a sequence of commands to be prepared in advance and used as a batch file This differs from standard input redirection described below in that the contents of the file are first interpreted by this program s command processing routine The result is that while the built in commands and the redirection commands can be used GPIB commands that include binary data and newline codes cannot be used help Displays command descriptions on the screen resets Returns the registers used by the event and status reporting system to the standard state set up by this program If the set values of the GPIB commands registers such as DESE and ESE are changed this comm
48. 30 data memory in word units and displays that data on the screen The start address for the read and the number of words are specified as command line arguments in decimal separated by a space This command has the following syntax getword address length The program displays the memory size and the starting address parameters and then the bit pattern data for those parameters The parameters are displayed starting with a number sign character each on its own line The bit pattern data is displayed as 8 bit words of 1 bytes each with each byte displayed in hexadecimal The bytes of each word are displayed on a single line starting with the most significant byte The listing below shows the output for reading out the words from addresses 0 to 90 size 90 start U 00 00 00 00 00 00 00 00 00 08 08 00 00 00 00 00 00 00 00 0c T 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Since the result is displayed on standard output the data can be saved by redirecting the output to a file This file can be used as an input to the putword program described below DG2030 Programmer Manual 4 7 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Putword Putgrp Putblik 4 8 This program sends bit pattern data to the DG2030 data memory in word units Data input is from a file in a unique format This command has the following syntax with the input data file
49. 3005 Internal divider error Internal EEPROM init error Internal EEPROM write error Internal EEPROM read error 3006 DG2030 Programmer Manual Internal FPGA configration error Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages 3 18 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com IT S Programming Examples This section presents sample programs that show specific examples of techniques for controlling the DG2030 over a GPIB interface The sample programs are stored on the floppy disk labeled Software Library included with the DG2030 Since this manual does not include a listing of these programs you may want to reference those files while reading this manual The majority of these programs are provided in C versions and thus can be used in the Microsoft Visual C environment Some of the programs are also provided in Quick BASIC or LabVIEW versions SONY Tektronix holds the copyright to the programs described in this section These programs may be copied distributed or modified for testing research and development purposes However SONY Tektronix assumes no responsibility or liability for any loss or damage that is caused due to the use of these programs in their original form or in any modified form Overview of the Sample Programs getbit putbit getword putword
50. 3E 62 4E 78 5E 94 7E 126 17 37 57 LAR 77 UNL 117 TME 137 UNT 177 1111 SI US l 0 RUBOUT F 15 1F 31 2F 47 lar 63 4F 79 5F 95 DEL ADDRESSED UNIVERSAL LISTEN TALK SECONDARY ADDRESSES COMMANDS COMMANDS ADDRESSES ADDRESSES OR COMMANDS KEY aS PPZ GPIB code with ATN asserted oe ene ENQ lt ASCII character A hex gt 5 Seen IEEE STD 488 1 1987 ISO STD 646 2973 A 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com IT ans Appendix B Reserved Words The words in the following list are reserved words for use with the DG2030 Data Generator CLS DATE IMMediate REPeat ESE DEBug IMPedance RESUIt ESR DEFine INHibit RISE IDN DELAy INITialize RUNNing OPC DELete INTernal SAVE OPT DESE INTERVal SECurity M DESKew LEVel SELect oo a LOAD SEQuence STB DISPlay oe Se Mu ce 10w Si WAI EVENT MDIRectory SOURce ABORI S MENU STARt ABSTouch EVJTO one al ADD EVMsg ALL EVQty MSIZe SUBSequence ALLEv EXTernal NAME SYSTem ASSIGn FACTory ORDer TEXT BIT FALL OSCillator TIME BLOCk FORMat OUTPut TRIGger BRIGhtness FREE PATTern TWAIT CATalog FREQuency PLLlock UNLock CDIRectory GROUp PORT UPDate CH lt n gt HCOPy PPAUse UPTime CLEAr HEADer RANge VALid CLOCK HIGH RDIRectory VERBose COPY ID RELEase WINDow DATA ILEVel REName WORD DG2030 Programmer Manual B 1 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE w
51. Arguments Decimal Numeric Unit and SI Prefix In a command or query one or more arguments follow the command header The argument sometimes called program data is a quantity quality restriction or limit associated with the command or query header Depending on the command or query header given the argument is one of the following types R Decimal Numeric R String R Arbitrary Block The data generator defines a decimal numeric argument as one expressed in one of three numeric representations NR1 NR2 or NR3 This definition complies with that found in ANSI IEEE Std 488 2 1987 Any commands that use arguments in any of the the first three notations can use a fourth notation NRf for Numerical Representation flexible The four formats are shown in Table 2 2 Table 2 2 Decimal Numeric Notation NR1 implicit point integer 1 8 2 10 20 explicit point unscaled 1 2 23 5 0 15 fixed point NR3 explicit point scaled floating point 1E 2 3 36E 2 1 02E 3 NRf numeric representation flexible any of 1 23 5 1 02E 3 NR1 NR2 and NR3 may be used NR2 As just implied you can use NRf notation for arguments in your programs for any commands that this manual lists as using any of NR1 NR2 or NR3 notation in its arguments Be aware however that query response will still be in the format specified in the command For example if the command description is DESE lt NR1 gt you can substitute NR2 or NR3
52. BIT lt parameters gt In case of BASIC programs 1 Inthe MS DOS prompt window move to the directory in which you have copied the sample BASIC files from the floppy disk in the procedures described in Making Copy on page 4 4 Select a name that does not duplicate an existing name in the file system cd c DGSAMPLE 20A QBASIC 2 Next copy the necessary files associated with the GPIB drivers This procedure assumes that the National Instruments drivers are installed in the c at gpib directory copy c at gpib qbasic qbdecl bas copy c at gpib qbasic qbib obj 3 Compile the sample programs using the batch file makeexe bat 4 If following the above procedures did not result in the compilation complet ing correctly check that there is adequate free space on the hard disk and that the compiler is installed correctly In particular check that the path setting is correct DG2030 Programmer Manual 4 5 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Installing the Sample Data Create an appropriate directory on the hard disk Select a name that does not duplicate an existing file or directory name in the file system This procedure uses the directory sample_d This procedure assumes that the hard drive is drive c that the floppy drive is drive a and that the current directory is an appropriate directory on the hard disk mkdir sample _d
53. BLOCK4 The DATA BLOCK SIZe command changes the size of a data block The DATA BLOCk SIZe query returns the size of the specified block DATA DATA BLOCK ADD DATA BLOCK DEFine DATA BLOCK DELete DATA BLOCk DELete ALL DATA BLOCK REN ame DATA BLOCk SIZe lt Name gt lt Size gt DATA BLOCk SIZe lt Name gt lt Name gt lt string gt where lt string gt is a block name lt Size gt lt NR1 gt where lt NR1 gt is a new block size DATA BLOCK SIZE lt Name gt lt Size gt DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples DATA GROUp ADD Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual DATA BLOCK SIZE BLOCK1 512 changes the block size of the block BLOCK1 to 512 The DATA GROUp ADD command adds a group DATA DATA GROUp BIT DATA GROUp DEFine DATA GROUp DELete DATA GROUp DELete ALL DATA GROUp NAME DATA GROUp REN ame DATA GROUp ADD lt Name gt lt MSB gt lt LSB gt lt Name gt lt string gt where lt string gt is the name of the group to be added lt MSB gt lt NR1 gt where MSB is the Most Significant Bit where lt NR1 gt is the high order bit for the group lt LSB gt lt NR1 gt where LSB is the Least Significant bit where lt NR1 gt is the low order bit for the group DATA GROUP ADD GROUP
54. C 2 lists the GPIB Universal and Addressed commands that the DG2030 Data Generator implements A brief description of each function follows the table Table C 2 GPIB interface messages Interface message Implemented Device Clear DC Yes Local Lockout LLO Yes Serial Poll Disable SPD Yes Serial Poll Enable SPE Yes Parallel Poll Unconfigure PPU No Go To Local GTL Yes Selected Device Clear SDC Yes Group Execute Trigger GET Yes C 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix C Interface Specification Table C 2 GPIB interface messages Cont Interface message Implemented Take Control TCT No Parallel Poll Configure PPC No R Device Clear DCL Clears initializes all devices on the bus that have a device clear function whether the controller has addressed them or not Local Lockout LLO Disables the return to local function m Serial Poll Enable SPE Puts all devices on the bus that have a service request function into the serial poll enabled state In this state each device sends the controller its status byte instead of the its normal output after the device receives its talk address on the data lines This function may be used to determine which device sent a service request R Serial Poll Disable SPD Changes all devices on the bus from the serial poll state to the normal opera
55. Commands Syntax Arguments Examples SYSTem DATE 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The STOP command stops pattern data or sequence output If the run mode is set to single the trigger wait state is cancelled Other RUNNing STARt TRG STOP None STOP stops pattern data or sequence output The SYSTem DATE command sets the internal clock date The SYSTem DATE query returns the internal clock date SYSTEM SYSTem TIME SYSTem DATE lt Year gt lt Month gt lt Day gt SYSTem DATE lt Year gt lt NR1 gt the year lt Month gt lt NR1 gt the month lt Day gt lt NR1 gt the day SYSTEM DATE lt Year gt lt Month gt lt Day gt SYSTEM DATE 97 7 7 sets the date 2 111 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions SYSTem PPAUse Group Related Commands Syntax Arguments Responses Examples The SYSTem PPAUSe command sets whether or not the instrument goes to the operator key input wait state power up pause when an error is detected by the power up diagnostics or no output pod is connected The SYSTem PPAUSe query returns the power up pause setting on or off SYSTEM None SYSTem PPAUse ON OFF 1 0 SYSTem PPAUse ON or 1 enables the power up pause OFF or 0 disables the power up pause S
56. E gt lt LoopE gt Arguments lt LineN gt lt NR1 gt where lt NR1 gt is a sequence step number lt Name gt lt string gt where lt string gt is a block name surrounded in double or single C quotes lt Repeat gt lt NR1 gt where lt NR1 gt is a repeat count 1 to 65536 lt To gt lt NR1 gt where lt NR1 gt is a event jump destination line number lt WaitE gt ON OFF 1 0 trigger wait on off state lt JumpE gt ON OFF 1 0 event jump on off state lt LoopE gt ON OFF 1 0 infinite loop on off Examples DATA SEQUENCE ADD 4 BLOCK3 16 0 0 1 1 adds a sequence step that consists of the block named BLOCK3 at the sequence line number 4 position When this sequence is executed in enhanced mode BLOCK3 will be executed repeatedly since the infinite loop setting is set on However since event jump is also set on the instrument will jump to sequence line number 0 if an external event occurs In run modes other than enhanced mode BLOCK3 will be executed 16 times and then control will switch to the next line number DG2030 Programmer Manual 2 35 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SEQuence DEFine Group Related Commands Syntax Arguments Responses Examples 2 36 The DATA SEQuence DEFine command sets up all of the sequence definition section information
57. Execution errors 3 15 3 17 Execution warning 3 15 F FACTory 2 65 Factory Initialization D 1 G GPIB Compared to the RS 232 C 1 2 Connector 1 3 Description of 1 1 Function Layers 1 1 Installation 1 3 Installation restrictions 1 4 interface functions C interface messages C 2 Setting parameters for 1 5 Standard conformed to 1 1 System configurations 1 4 H Hardcopy commands HCOPy 2 66 HCOPy ABORt 2 67 HCOPy DATA 2 67 HCOPy FORMat 2 68 HCOPy PORT 2 69 HCOPy STARt 2 70 HCOPy 2 66 HCOPy ABORt 2 67 HCOPy DATA 2 67 HCOPy FORMat 2 68 HCOPy PORT 2 69 HCOPy STARt 2 70 HEADer 2 70 DG2030 Programmer Manual Guaranteed 888 88 SOURCE www artisantg com Index ID 2 71 IDN 2 72 L LOCK 2 72 Memory commands MMEMory CATalog ORDer 2 74 MEMory CATalog ALL 2 74 MEMory CDIRectory 2 75 MEMory COPY 2 76 MEMory DELete ALL 2 76 MEMory DELete NAME 2 77 MEMory FREE 2 77 MEMory INITialize 2 78 MEMory LOAD 2 78 MEMory LOCK 2 79 MEMory MDIRectory 2 80 MEMory RDIRectory 2 80 MEMory REName 2 81 MEMory SAVE 2 81 Message Handling 3 1 Messages Error 3 9 Event 3 9 MEMory CATalog ORDer 2 74 MEMory CATalog ALL 2 74 MEMory CDIRectory 2 75 MEMory COPY 2 76 MEMory DELete ALL 2 76 MEMory DELete NAME 2 77 MEMory FREE 2 77 MEMory INITialize 2 78 MEMory LOAD 2 78 MEMory LOCK 2 79 MEMory MDIRectory 2 80 MEMory RDIRectory 2 80
58. FINE 217UNNAMED 1 DATA SEQUENCE DEFINE 271BLOCK_1 1 0 1 0 0 lt LF gt BLOCK 2 1 0 0 1 0 lt LF gt BLOCK 3 1 0 0 0 0 lt LF gt BLOCK 4 1 0 0 0 DATA GROUP DEFINE 279 DATA7 7 7 lt LF gt DATA6 6 6 lt LF gt DATA5 5 5 lt LF gt DATA4 4 4 lt LF gt DATA3 3 3 lt LF gt DATA2 2 2 lt LF gt DATA1 1 1 lt LF gt DATA0 0 0 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA BLOCk ADD Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual The DATA BLOCk ADD command adds a block This results in one new block being defined in the block definition section DATA DATA BLOCk DEFine DATA BLOCK DELete DATA BLOCk DELete ALL DATA BLOCk REName DATA BLOCk SIZe DATA BLOCK ADD lt Position gt lt Name gt lt Position gt lt NR1 gt where lt NR1 gt is the start position of the added block lt Name gt lt string gt where lt string gt is the name of the added block DATA BLOCK ADD 512 BLOCK1 adds a block starting at address 512 named BLOCK1 2 23 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA BLOCk DEFine Group Related Commands Syntax Arguments Responses Examples 2 24 The DATA BLOCK DEFine command sets up the information for the whole block definition section
59. ME 2 49 DEBug SNOop STATe 2 50 Index 1 Guaranteed 888 88 SOURCE www artisantg com Index DEBug 2 46 DEBug SNOop 2 47 DEBug SNOop DELAy 2 48 DEBug SNOop DELAy TIME 2 49 DEBug SNOop STATe 2 50 Default Settings D 1 Description GPIB 1 1 RS 232 C 1 2 DESE 2 51 DESE command 3 4 DESER register 3 4 Diagnostic commands DIAGnostic 2 52 DIAGnostic RESUIt 2 53 DIAGnostic SELect 2 54 DIAGnostic STATe 2 54 DIAGnostic 2 52 DIAGnostic RESUIt 2 53 DIAGnostic SELect 2 54 DIAGnostic STATe 2 54 Display commands ABSTouch 2 19 DISPlay 2 55 DISPlay BRIGhtness 2 56 DISPlay CLOCk 2 56 DISPlay DIMmer 2 57 DISPlay ENABle 2 58 DISPlay MENU 2 58 DISPlay MENU NAME 2 59 DISPlay MENU NAME 2 60 DISPlay MENU STATe 2 60 DISPlay WINDow TEXT CLEar 2 61 DISPlay WINDow TEXT DATA 2 62 DISPlay 2 55 DISPlay BRIGhtness 2 56 DISPlay CLOCKk 2 56 DISPlay DIMmer 2 57 DISPlay ENABle 2 58 DISPlay MENU 2 58 DISPlay MENU NAME 2 59 DISPlay MENU NAME 2 60 DISPlay MENU STATe 2 60 DISPlay WINDow TEXT CLEar 2 61 DISPlay WINDow TEXT DATA 2 62 E Enable Registers Defined 3 1 3 4 Error No events 3 10 Error Messages Listed 3 9 ESE 2 62 3 4 Index 2 Artisan Technology Group Quality Instrumentation ESER register 3 4 ESR 2 63 ESR query 3 1 Event handling 3 1 Event Queue 3 5 EVENT 2 64 EVMsg 2 64 EV Qty 2 65 Execution Errors 3 12 3 14
60. MEMory REName 2 81 MMEMory SAVE 2 81 MODE 2 82 Mode commands MODE 2 82 MODE STATe 2 82 MODE UPDate 2 83 MODE STATe 2 82 MODE UPDate 2 83 SSsssS55e55555 SSSSSSESS5S58585855 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation 0 OPC 2 84 OPT 2 84 Other Commands CAL 2 21 Other commands CLS 2 22 ESE 2 62 ESR 2 63 IDN 2 72 OPC 2 84 OPT 2 84 PSC 2 103 RST 2 104 SRE 2 109 STB 2 110 TRG 2 114 TST 2 120 WAT 2 123 ALLEv 2 20 DESE 2 51 EVENT 2 64 EVMsg 2 64 EVQty 2 65 FACTory 2 65 HEADer 2 70 ID 2 71 LOCK 2 72 RUNNing 2 104 STARt 2 110 STOP 2 111 UNLock 2 121 UPTime 2 122 VERBose 2 122 OUTPUT commands OUTPut 2 85 Output commands OUTPut CH lt n gt ASSIGn 2 86 OUTPut CH lt n gt DELAy 2 86 OUTPut CH lt n gt DES Kew 2 87 OUTPut CH lt n gt DESKew RESET 2 88 OUTPut CH lt n gt FALI 2 88 OUTPut CH lt n gt FALI RANge 2 89 OUTPut CH lt n gt FALI VALid 2 90 OUTPut CH lt n gt HIGH 2 90 OUTPut CH lt n gt INHibit 2 91 OUTPut CH lt n gt LOW 2 92 OUTPut CH lt n gt RELEase 2 92 OUTPut CH lt n gt RISe 2 93 OUTPut CH lt n gt RISe RANge 2 94 OUTPut CH lt n gt RISe VALid 2 94 OUTPut CHCLK FALI 2 95 OUTPut CHCLK FALI RANge 2 96 Index 3 Guaranteed 888 88 SOURCE www artisantg com Index OUTPut CHCLK FAL I VALid 2 96 OUTPut CHCLK HIGH 2 97 OUTPut CHCLK LOW 2 98 O
61. MENU DISPlay MENU NAME DISPlay MENU STATe ON OFF 1 0 DISPlay MENU STATe ON or 1 OFF or 0 Menus are displayed Menus are not displayed DISPLAY MENU STATE 1 0 DISPLAY MENU STATE ON sets the instrument to display menus on the screen DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DISPlay WINDow TEXT CLEar Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual The DISPlay WINDow TEXT CLEar command clears the message display area on the screen DISPLAY DISPlay DISPlay WINDow TEST L DATA DISPlay WINDow TEXT CLEar None DISPLAY WINDOW TEXT CLEAR clears the message display area 2 61 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DISPlay WINDow TEXT DATA Group Related Commands ESE 2 2 62 Syntax Arguments Responses Examples Group The DISPlay WINDow TEXT L DATA command sends a message to be displayed in the screen message display area The sent message is displayed immediately The DISPlay WINDow TEXT DATA query returns the contents of the input screen message NOTE The contents of the message display area scrolls automatically To fully update the display contents first clear the message displa
62. NKJET TIFF PORT DISK GPIB RS232C where BMP the Windows monochrome file format EPSOn the format used by 9 pin and 24 pin dot matrix printers in ESC P graphics mode EPSMono the encapsulated Postscript format monochrome image file format THINkjet the format used by HP inkjet printers TIFF the TIFF format HCOPY might return HCOPY FORMAT TIFF PORT DISK In this case the instrument outputs hardcopy data to file on the floppy disk in the TIFF format DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions HCOPy ABORt Group Related Commands Syntax Arguments Examples HCOPy DATA Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The HCOPy ABORt command aborts hardcopy output HARDCOPY HCOPy STARt HCOPy ABORt None HCOPY ABORT aborts hardcopy output The HCOPy DATA query outputs the hard copy data to the output queue However note that this command has no effect on and is not affected by the hard copy output port setting HARDCOPY HCOPy PORT HCOPy DATA None HCOPY DATA lt Image gt where lt Image gt lt block gt the hardcopy image data block HCOPY DATA outputs hard copy data to the output queue 2 67 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www art
63. NOop DELAY TIME 0 2 DEBug SNOop STATe 0 DIAGNOSTIC commands DIAG SELect ALL DISPLAY commands DISPlay BRIGhtness 0 7 DISPlay CLOCk 0 DISPlay DIMmer 0 DISPlay ENABle 1 DISPlay MENU NAME EDIT DISPlay MENU STATe 1 HARDCOPY commands HCOPy FORMat BMP HCOPy PORT DISK MEMORY commands MMEMory CATalog ORDer NAME1 MODE commands MODE STATe REPEAT MODE UPDate AUTO Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix D Factory Initialization Settings Table D 1 Factory initialized settings Cont Header Default settings OUTPUT commands OUTPut ELEVel 1 4 V OUTPut ILEVel 1 4 V OUTPut CH lt n gt DELAy 0 0 ns OUTPut CH lt n gt DESKew 0 0 ns OUTPut CH lt n gt FAL FAST OUTPut CH lt n gt HIGH 1 5 V OUTPut CH lt n gt INHibit 0 OUTPut CH lt n gt LOW 0 0 V OUTPut CH lt n gt RISe FAST OUTPut CHCLK FAL FAST OUTPut CHCLK HIGH 1 5 V OUTPut CHCLK LOW 0 0 V OUTPut CHCLK RISe FAST SOURCE commands SOURce 0SCillator EXTernal FREQuency 1 0E 8 Hz SOURce 0SCillator INTernal FRE 1 0E 8 Hz Quency SOURce 0SCillator INTernal PLLlock INTERNAL SOURce 0SCillator SOURce 1 SOURce POD lt s gt EVENT ENAB1e 1 SYSTEM commands SYSTem PPAUse 1 SYSTem SECurity STATe 0 TRIGGER commands TRIGger IMPedance HIGH TRIGger INTERVal STATe OFF TRIGger INTERVal TIME 10 0 s TRIGger LEVel 1 4 V
64. NT ENABLE ON enables the EVENT input 2 105 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions SOURCce 0SCillator Group Related Commands Syntax Arguments Responses Examples The SOURce 0SCillator query returns all the settings states related to clock signals SOURCE SOURce 0SCillator EXTernal FREQuency SOURce 0SCillator INTernal FREQuency SOURce 0SCillator INTernal PLLlock SOURce 0SCillator SOURce SOURce 0SCillator None SOURCE OSCILLATOR SOURCE INTERNAL EXTERNAL EXTERNAL FREQUENCY lt NR3 gt HZ SOURCE OSCILLATOR INTERNAL FREQUENCY lt NR3 gt HZ PLLLOCK 1 0 SOURce 0SCillator might return SOURCE OSCILLATOR SOURCE INTERNAL EXTERNAL FREQUENCY 1 000E 8HZ SOURCE OSCILLATOR INTERNAL FREQUENCY 2 000E 8HZ PLLLOCK 1 SOURCce OSCillator EXTernal FREQuency Group Related Commands Syntax 2 106 The SOURce 0SCil lator EXT erna FREQuency command enters the frequency of the externally supplied clock signal The SOURce 0SCillator EXTer nal FREQuency query returns the externally supplied clock signal frequency setting SOURCE SOURce 0SCillator SOURce 0SCillator INTernal FREQuency SOURce 0SCillator INTernal PLLlock SOURce 0SCillator SOURce SOURce 0SCil lator EXTernal FREQuency lt Frequency gt SOURce 0SCillator EXTernal FREQuency DG2030 Pro
65. O1 3 0 adds a group that consists of 4 bits DATAO to DATA3 and has the name GROUPO1 2 27 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA GROUp BIT The DATA GROUp BIT command changes the bit configuration of a group The DATA GROUp BIT query returns the set bit configuration Group DATA Related Commands DATA GROUp ADD DATA GROUp DEFine DATA GROUp DELete DATA GROUp DELete ALL DATA GROUp NAME DATA GROUp REN ame Syntax DATA GROUp BIT lt Name gt lt MSB gt lt LSB gt DATA GROUp BIT lt Name gt Arguments lt Name gt lt string gt where the name of the group to be changed or queried lt MSB gt lt NR1 gt where lt NR1 gt is the high order bit for the group lt LSB gt lt NR1 gt where lt NR1 gt is the low order bit for the group Responses _ DATA GROUP BIT lt Name gt lt MSB gt lt LSB gt Examples DATA GROUP BIT GROUPO2 7 4 changes the bit configuration for the group named GROUPO2 to be DATA4 to DATA7 2 28 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA GROUp DEFine 2 The DATA GROUp DEFine command sets up the information for the whole group definition section in ASCII The DATA GROUp DEFine query returns the information for the whole group definition section
66. OCK2 SIZE BLOCK1 512 The following examples have been shortened incorrectly and cause errors DATA BLOCK DELETE BLOCK2 DATA GROUP DELETE GROUP4 DATA BLOCK ADD 512 BLOCK3 GROUP DELETE GROUP4 DATA BLOCK DELETE BLOCK2 MSIZE 16384 Query Responses The query causes the data generator to return information about its status or settings A few queries also initiate an operation action before returning information for instance the TST query performs the self test If the programmer has enabled headers to be returned with query responses the data generator formats a query response like the equivalent set command header followed by its argument s When headers are turned off for query responses only the values are returned Table 2 3 shows the difference in query responses Table 2 3 Header in query responses Query Header On Header Off DATA MSIZE DATA MSIZE 16384 16384 DIAGNOSTIC SELECT DIAGNOSTIC SELECT PMEMORY PMEMORY DG2030 Programmer Manual 2 9 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax Use the command HEADER ON when you want the header returned along with the information You can save such a response and send it back as a set command later Use HEADER OFF when you want only the information back Other General Command Conventions Upper and Lower Case The instrument accepts upper lower or mixed case alphabetic messages
67. Programmer Manual for the DG2030 Data Generator This manual provides information on operating the instrument over a General Purpose Interface Bus GPIB interface or an RS 232 C interface This manual provides the following information Related Manuals Getting Started describes how to connect and set up for remote operation Syntax and Commands defines the command syntax and processing conventions and describes each command in the data generator command set Status and Events explains the status information and event messages reported by the data generator Appendices contains various topics of use to the programmer Glossary and Index contains a glossary of common terms and an index to this manual Other documentation for the data generator includes DG2030 Programmer Manual The DG2030 User Manual Tektronix part number 071 0059 XX describes the operation of the instrument The DG2030 Service Manual Tektronix part number 071 0058 XX provides information for maintaining and servicing the Data Generator Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Preface vi DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started DG2030 Programmer Manual The Data Generator has two interfaces for remote operation the GPIB interface and the RS 232 C interface All menu controlled
68. Put CH lt n gt ASSIGn lt n gt 0 to 7 lt Bit gt lt NR1 gt where lt NR1 gt is a data bit number 0 to 7 L OUTPUT CH lt n gt ASSIGN lt Bit gt OUTPUT CH1 ASSIGN 3 assigns data bit D03 to channel 1 OUTPut CH lt n gt DELAy Group Related Commands Syntax 2 86 The OUTPut CH lt n gt DELAy command sets the delay time for the specified channel The OUTPut CH lt n gt DELAy query returns the delay time setting for the specified channel OUTPUT None OUTPut CH lt n gt DELAy lt Time gt OUTPut CH lt n gt DELAy lt n gt 0 to 7 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples lt Time gt lt NR2 gt lt unit gt where lt NR2 gt combined with lt unit gt specifies a time and lt unit gt s ms us ns for seconds milliseconds microseconds or nanoseconds L OUTPUT CH lt n gt DELAY lt NR3 gt OUTPUT CHO DELAY 10ns sets the delay time for channel 0 to 10ns OUTPut CH lt n gt DESKew Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The OUTPut CH lt n gt DESKew command sets the deskew value for the specified channel The OUTPut CH lt n gt DESKew query returns the deskew value setting for the specified channel OUTPUT OUTPut CH lt n gt DESKe
69. Queue sets the MAV bit in the SBR to one R Ifthe control bit for that event is also set in the ESER the ESB bit of SBR becomes set also 2 When either bit of SBR has been set to 1 and the corresponding control bit of SRER is also set the MSS bit of SBR becomes set and a service request is generated for use with GPIB interface operation As noted earlier the RS 232 C interface does not use the output queue therefore the MAV bit would not become set in the sequence just described Rather response messages are sent to the output buffer for immediately transfer to the external controller on the output line Message transfer is automatic and it is not necessary to use commands to retrieve these messages 3 6 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting Device Events Device Event Status Enable Register set with DESE read with DESE KOSE ai 7 6 5 4 3 2 1 0 Standard Event Status Register read and clear with ESR clear with CLS PON URQ CME EXE DDE ave RAC OPC amp Output T O Queue f7 tet s 4 3fte2tir1tf o avi Standard Event Status Enable Register set BYTE with ESR clear with CLS Queue not empty Status Byte Register read with serial poll or Seni STB clear with CLS ervice Request pe 08 TRT TT Gen
70. RSor DOWNarrow EXECute KNOBLeft LEFTarrow UParrow RIGHtarrow KNOBRight P 5 N S O D RUN N COD HARDcopy STEp gt MANual Cl lt SIDE 1 fo 0 SETUp C gt aL SIDE 2 coir IIo 5 SIDE 2 APPLication E S TT lt SIDE 4 S UTILity EOD SLOS IR SIDE 5 EN Ox CLEARM F Ns E CO l CO lOO OOO enu 8 MHZ US S YT 7 8 9 sY E BOTTOM 1 BOTTOM7 SEVen EIGH NINe gt C iC C A p z ETA KHZ MS MV FOR Fe Ssx Ol OO Ka 1 2 3 kHzims jrr Lea ONE TWO THRES K DIC C TC ae DELete ZER gt C DCO Y COn ENTer VE POINt MINUs HZ S V Figure 2 2 ABSTouch arguments and associated controls Examples ABSTOUCH SETUP displays the same setup menu that is displayed by pressing the front panel button SETUP in the MENU column on the front panel ALLEv The ALLEv query dequeues all event codes and their corresponding event messages Use the ESR query to make events available for dequeuing using ALLEv query Group Other Related Commands CLS DESE ESE ESR EVENT EVMsg EVQty SRE STB Syntax ALLEv 2 20 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples CAL Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual None ALLEV lt event code gt lt event message second messag
71. RVal 2 116 TRIGger INTERVal STATe 2 117 TRIGger INTERVal TIME 2 118 TRIGger LEVel 2 118 TRIGger SLOpe 2 119 TRIGger SOURCce 2 120 TST 2 120 U UNLock 2 121 UPTime 2 122 V VERBose 2 122 W WAT 2 123 Where to find other information iii Index 5 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Index Index 6 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com A rtisan Artisan Technology Group is your source for quality TecmoogyGroup new and certified used pre owned equipment FAST SHIPPING AND SERVICE CENTER REPAIRS WE BUY USED EQUIPMENT DELIVERY Experienced engineers and technicians on staff Sell your excess underutilized and idle used equipment TENS OF THOUSANDS OF at our full service in house repair center We also offer credit for buy backs and trade ins IN STOCK ITEMS www artisantg com WeBuyEquipment 7 EQUIPMENT DEMOS HUNDREDS OF InstraV ea REMOTE INSPECTION LOOKING FOR MORE INFORMATION MANUFACTURERS Remotely inspect equipment before purchasing with Visit us on the web at www artisantg com 7 for more our interactive website at www instraview com information on price quotations drivers technical LEASING MONTHLY specifications manuals and documentation RENTALS ITAR CERTIFIED SER Ds Contact us 888 88 SOURCE sales artisantg com ww
72. Register must be set to one If the bit in the Enable Register is set to zero the event is not recorded Various commands set the bits in the Enable Registers The Enable Registers and the commands used to set them are described below The Device Event Status Enable Register DESER Shown in Figure 3 3 This register controls which events of those shown are reported to the SESR and the Event Queue The bits in the DESER correspond to those in the SESR as was described earlier Use the DESE command to enable and disable the bits in the DESER Use the DESE query to read the DESER 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3 3 The Device Event Status Enable Register DESER The Event Status Enable Register ESER Shown in Figure 3 4 It controls which events of those shown are allowed to be summarized by the Event Status Bit ESB in the SBR Use the ESE command to set the bits in the ESER Use the ESE query to read it 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3 4 The Event Status Enable Register ESER DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting The Service Request Enable Register SRER Shown in Figure 3 5 It controls which bits in the SBR generate a Service Request and are summarized by the Master Status Summary MSS bit Use the SRE command
73. SOURCE www artisantg com Command Descriptions DATA SEQuence LOOP Group Related Commands Syntax Arguments Responses Examples The DATA SEQuence LOOP command sets the sequence step infinite loop state to on or off The DATA SEQuence LOOP query returns the sequence step infinite loop on off state DATA DATA SEQuence EVJ DATA SEQuence EVJTO DATA SEQuence REPeat DATA SEQuence TWAIT DATA SEQuence LOOP lt Line Number gt ON OFF 1 0 DATA SEQuence LOOP lt Line Number gt lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set ON orl sets the infinite loop state to on OFF or 0 sets the infinite loop state to off DATA SEQUENCE LOOP lt Line Number gt 1 0 DATA SEQUENCE LOOP 9 0FF sets the infinite loop state for the line 9 sequence step to off DATA SEQuence REPeat Group Related Commands 2 40 The DATA SEQuence REPeat command sets the sequence step repeat count The DATA SEQuence REPeat query returns the repeat count set for the sequence step DATA DATA SEQuence EVJ DATA SEQuence EVJTO DATA SEQuence LOOP DATA SEQuence TWAIT DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Syntax Arguments Responses Examples DATA SEQuence REPeat lt Line Number gt lt Times gt DATA SEQuenc
74. T Reset this data generator RUNNing Query whether the instrument is currently outputting a pattern or sequence SRE Set or query SRER STARt Start pattern or sequence output STB Query SBR STOP Stop pattern or sequence output TRG Generate the triggering event TST Perform self test UNLock Unlock allow local control using the front panel controls UPTime Query the elapsed time since power on VERBose Set or query short or long response headers WAI Hold off all commands until all pending operations Artisan Technology Group Quality Instrumentation complete DG2030 Programmer Manual Guaranteed 888 88 SOURCE www artisantg com IT as Command Descriptions ABSTouch Group Related Commands Syntax Arguments DG2030 Programmer Manual This subsection lists each command and query in the DG2030 Data Generator command set alphabetically Each command entry includes its command description and command group its related commands if any its syntax and its arguments Each entry also includes one or more usage examples This subsection fully spells out headers mnemonics and arguments with the minimal spelling shown in upper case For example to use the abbreviated version of the DISPlay BRIGhtness command just type DISP BRIG The symbol follows the command header of those commands that can be used as either a command or a query The symbol follows those commands that can only
75. Tialize Group Related Commands Syntax Arguments Examples MMEMory LOAD Group Related Commands 2 78 The MMEMory INITialize command formats a floppy disk The format type is specified by the argument MEMORY None MMEMory INITialize DD1 DD2 HD1 HD2 HD3 You can select from the following formats Argument Description DD1 2DD 720 KB 80 tracks 9 sectors track 512 bytes sector Format for IBM PC 2DD and Toshiba J3100 2DD DD2 2DD 640 KB 80 tracks 8 sectors track 512 bytes sector Format for NEC PC 9800 2DD HD1 2HD 1 232 MB 77 tracks 15 sectors track 1 024 bytes sector Format for NEC PC 9800 2HD HD2 2HD 1 200 MB 80 tracks 15 sectors track 512 bytes sector Format for Toshiba J3100 2HD HD3 2HD 1 440 MB 80 tracks 18 sectors track 512 bytes sector Format for IBM PC 2HD MMEMORY INITIALIZE HD3 formats a floppy disk for IBM PC 2HD The MMEMory LOAD command loads in pattern data and block group sequence and setup information in DG2030 Data Generator format into the instrument s internal memory from a disk file MEMORY MMEMory SAVE DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Syntax Arguments Examples MMEMory LOCK Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual MMEMory LOAD lt File Na
76. UTPut CH lt n gt RELEase OUTPut DEFine lt Assigninfo gt OUTPut DEFine DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples DG2030 Programmer Manual lt Assigninfo gt lt blockheader gt lt Assign gt lt LF gt lt Assign lt LF gt lt As sign arbitrary block data that defines the pod channel assignments where lt blockheader gt lt byte count digit gt lt byte count gt lt Assign gt lt AChannel gt lt ABit gt lt AHoldE gt The lt AChannel gt lt ABit gt and lt AHoldE gt items are ASCII character strings that express the following information lt AChannel gt channel number 0 to 7 lt ABi t gt data bit number 0 to 7 lt AHol dE gt high impedance control selection 0 no control 1 channel 0 control 2 external input signal 3 logical or of the channel 0 signal and the external input signal See the OUTPut CH lt n gt INHibit command lt LF gt lt ASCII line feed code 10 gt OUTPUT DEFINE lt Assigninfo gt where lt Assigninfo gt is an arbitrary data block with the same format as the argument OUTPut DEFine 2170 4 1 lt LF gt 1 5 2 lt LF gt 2 7 0 assigns the pod A channels as follows when executed Channel 0 Bit 4 high impedance state controlled by the channel 0 signal Channel 1 Bit 5 high impedance state controlled by a
77. UTPut CHCLK RISe 2 98 OUTPut CHCLK RISe RANge 2 99 OUTPut CHCLK RISe VALid 2 100 OUTPut DEFine 2 100 OUTPut ELEVel 2 102 OUTPut ILEVel 2 102 Output Queue 3 5 OUTPut 2 85 OUTPut CH lt n gt ASSIGn 2 86 OUTPut CH lt n gt DELAy 2 86 OUTPut CH lt n gt DES Kew 2 87 OUTPut CH lt n gt DESKew RESET 2 88 OUTPut CH lt n gt FALI 2 88 OUTPut CH lt n gt FALI RANge 2 89 OUTPut CH lt n gt FALI VALid 2 90 OUTPut CH lt n gt HIGH 2 90 OUTPut CH lt n gt INHibit 2 91 OUTPut CH lt n gt LOW 2 92 OUTPut CH lt n gt RELEase 2 92 OUTPut CH lt n gt RISe 2 93 OUTPut CH lt n gt RISe RANge 2 94 OUTPut CH lt n gt RISe VALid 2 94 OUTPut CHCLK FALI 2 95 OUTPut CHCLK FALI RANge 2 96 OUTPut CHCLK FALI VALid 2 96 OUTPut CHCLK HIGH 2 97 OUTPut CHCLK LOW 2 98 OUTPut CHCLK RISe 2 98 OUTPut CHCLK RISe RANge 2 99 OUTPut CHCLK RISe VALid 2 100 OUTPut DFFine 2 100 OUTPut ELEVel 2 102 OUTPut ILEVel 2 102 p Programming Examples 4 1 PSC 2 103 Q Query Structure of 2 2 Queue Event 3 5 Output 3 5 Index 4 Artisan Technology Group Quality Instrumentation R Register DESER 3 4 ESER 3 4 SESR 3 1 SRER 3 5 Registers Status 3 1 Reserved words B 1 RS 232 C Cable wiring 1 8 Common connectors for 1 6 Compared to the GPIB 1 2 Connector location 1 7 Connector pin assignments 1 8 Description of 1 2 Installation 1 6 Setting Parameters of 1 9 RST 2 104 RUNNing 2 104 S Ser
78. W command sets the low level output voltage for the clock output The OUTPut CHCLK LOW query returns the low level output voltage setting for the clock output OUTPUT OUTPut CHCLK HIGH OUTPut CHCLK LOW lt Volt gt OUTPut CHCLK LOW lt Volt gt lt NR2 gt lt Unit gt where lt NR2 gt combined with lt Unit gt specifies a low level voltage and lt Unit gt V mV for volt or millivolt OUTPUT CHCLK LOW lt NR2 gt OUTPUT CHCLK LOW 1V sets the low level output voltage for the clock output to 1 V OUTPut CHCLK RISe Group Related Commands Syntax Arguments Responses 2 98 The OUTPut CHCLK RISe command sets the rise time for the clock output The OUTPut CHCLK RISe query returns rise time setting for the clock output If FAST or 0 is used in the argument the rise time become as fast as possible OUTPUT OUTPut CHCLK RISe RANge OUTPut CHCLK RISe VALid OUTPut CHCLK RISe lt Time gt OUTPut CHCLK RISe lt Time gt lt NR2 gt lt Unit gt FAST lt Unit gt s ms us ns OUTPUT CHCLK RISE lt NR3 gt DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples OUTPUT CHCLK RISE Ins sets the rise time for the clock output to Ins OUTPut CHCLK RISe RANge The OUTPut CHCLK RISe RANge query returns the valid range of the rise time setting for the cloc
79. Y TIME 0 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DEBug SNOop DELAy TIME 2 Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual The DEBug SNOop DELAy TIME command sets the display time for commands in a sequence of commands that are connected by semicolons The DEBug SNOop DELAy TIME query returns the display time for commands in a sequence of commands connected by semicolons DEBUG DEBug DEBug SNOop DEBug SNOop DELAy DEBug SNOop STATe DEBug SNOop DELAy TIME lt Time gt DEBug SNOop DELAy TIME lt Time gt lt NR2 gt lt unit gt where lt NR2 gt combined with lt unit gt specifies a time in the range 0 0 s to 10 0 s in steps of 0 1 s and lt unit gt s ms us for seconds milliseconds or microseconds DEBUG SNOOP DELAY TIME 0 5 sets the command display time to 0 5 seconds 2 49 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DEBug SNOop STATe 2 50 Group Related Commands Syntax Arguments The DEBug SNOop STATe command sets and clears the remote command debugging function The DEBug SNOop STATe query returns the currently specified state of the remote command debugging function The debugging function displays messages input
80. YSTEM PPAUSE 1 0 SYSTEM PPAUSE ON turns power up pause on SYSTem SECurity IMMediate Group Related Commands Syntax 2 112 The SYSTem SECurity IMMediate command sets all internal settings to the factory setting state the same state that results when the FACTory command is executed and completely erases all data Bit patterns groups blocks and sequences are included in the erased data The GPIB and RS 232 C settings and the data and time settings are not reset SYSTEM FACTory RST SYSTem SECurity IMMediate DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments None SYSTem SECurity STATe Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The SYSTem SECurity STATe command sets security to on or off The SYSTem SECurity STATe query returns whether the security setting is on or off When the security setting is changed from on to off the contents of internal memory are completely erased The security on off setting is not changed by executing the FACTory command SYSTEM SYSTem SECurity IMMediate SYSTem SECurity STATe ON OFF 1 0 SYSTem SECurity STATe ON or 1 sets the security state to on OFF or 0 sets the security state to off SYSTEM SECURITY STATE 1 0 gt SYSTEM SECURITY STATE ON sets the securit
81. ader Mnemonic gt lt Header Mnemonic gt lt Argument gt lt Argument gt such as MMEMORY INITIALIZE HD1 or SYSTEM SECURITY STATE ON Compound Query Header A command that contains multiple header mnemonics followed by a question mark Its message format is lt Header Mnemonic gt lt Header Mnemonic gt lt Argument gt lt Argument gt such as DIAGNOSTIC RESULT or DATA BLOCK SIZE BLOCK1 2 7 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax Common Command Header A command that precedes its header mnemonic with an asterisk Its message format is lt Header Mnemonic gt lt Argument gt lt Argument gt such as RST The common commands are defined by IEEE Std 488 2 and are common to all devices which support IEEE Std 488 2 on the GPIB bus Common Query Header A command that precedes its header mnemonic with an asterisk and follows it with a question mark Its message format is lt Header Mnemonic gt lt Argument gt lt Argument gt such as IDN The common commands are defined by IEEE Std 488 2 and are common to all devices which support the IEEE Std 488 2 on the GPIB bus Concatenating Commands BLOCK Most of the compound command headers are in a tree structure The tree structure of an example command is diagrammed below Note that the top of the structure al
82. ame is empty 2062 2063 2064 2065 Same name already exists Too much group Group name not found Group number is not found 2066 Invalid group data 2067 2070 2071 Invalid group syntax Invalid block position To much block 2072 2073 2074 2075 2076 Block already exists Block is not found Illegal block name Illegal block size Block name already exists 2077 2078 2079 Block is not defined Too much block data Invalid block syntax 2080 Import error 2081 2082 Code table syntax error Too much table data DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages Table 3 10 Device dependent command execution errors Cont Code Description 2100 Hardcopy error 2101 Hardcopy busy 2102 Hardcopy timeout error 2103 Sub sequence error 2132 Too much sub sequence data 2133 Invalid sub sequence repeat count 2134 Invalid sub sequence syntax 2135 Sub sequence load error 2136 Internal sub sequence memory full 2137 No sub sequence 2138 Sub sequence line is not found 2139 Sub sequence incomplete 2140 Too many sub sequence 2141 Sub sequence name error 2200 Message error Table 3 11 lists device error messages that are specific to the device Table 3 11 Extended device specific errors Code 3001 Description RS 232 C input buffer overflow 3002 3003 3004
83. and because of that event the data generator needs attention from the operator CME Command Error Indicates that an error occurred while the data generator was parsing a command or query Command error messages are listed in Table 3 5 on page 3 10 EXE Execution Error Indicates that an error occurred while the data generator was executing a command or query An execution error occurs for either of the following reasons m A value designated for the argument is out of the range allowed by the data generator is not valid for the command or is incorrect in some other sense m Execution took place improperly under conditions different from those which should have been requested Execution error messages are listed in Table 3 6 on page 3 12 DDE Device Dependent Error Indicates that a device specific error occurred Device error messages are listed in Table 3 7 on page 3 14 QYE Query Error Indicates that an error occurred upon attempting to read the output queue Such an error occurs for one of the following two reasons An attempt was made to retrieve a message from the output queue even through it is empty or pending Output queue message was cleared while it was being retrieved from the output queue 0 LSB 3 2 RQC Request Control The data generator does not use this bit Request Control RQC is used to show that an instrument has requested to transfer bus control back to the controller This is t
84. and should be used as soon as possible to return their values to the standard values DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples DG2030 Programmer Manual view filename Outputs the contents of the file specified by filename to standard output i e displays the file on the screen Executes the immediately preceding command once again R Redirection commands The following commands can be used to switch standard input or standard output to a file and thus realize communications between the DG2030 and a file or files lt filename gt filename gt gt filename Sends the contents of the file specified by filename to the DG2030 directly without modification This allows a sequence of commands to be prepared in advance and used as a batch file In particular only this command can be used to send GPIB commands that include binary data blocks to the DG2030 Intercepts the data output to standard output and outputs it to the file specified by filename If the file already exists it is overwritten If the file does not exist a new file is created Intercepts the data output to standard output and outputs it to the file specified by filename in the same way as the gt command However if the file already exists it does not overwrite the file but rather appends the new data at the end of the file Artisan T
85. at consists of the two blocks BLOCK and BLOCK2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SEQuence DELete The DATA SEQuence DELete command deletes the specified sequence step Group DATA Related Commands DATA SEQuence ADD DATA SEQuence DEFine DATA SEQuence DEL ete ALL Syntax DATA SEQuence DELete lt Line Number gt Arguments lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be deleted Examples DATA SEQUENCE DELETE 3 deletes the line 3 sequence step DATA SEQuence DELete ALL The DATA SEQuence DELete ALL command deletes all sequence definitions Group DATA Related Commands DATA SEQuence ADD DATA SEQuence DEFine DATA SEQuence DELete Syntax DATA SEQuence DELete ALL Arguments None DG2030 Programmer Manual 2 37 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SEQuence EVJ 2 The DATA SEQuence EVJ command sets the sequence step event jump to on or off The DATA SEQuence EVJ query returns the sequence step event jump on off state Group DATA Related Commands DATA SEQuence EVJTO DATA SEQuence LOOP DATA SEQuence REPeat DATA SEQuence TWAIT Syntax DATA SEQuence EVJ lt Line Number gt ON OFF 1 0 DATA SEQuence EVJ lt Line Number gt
86. at which the trigger event is generated The TRIGger LEVel query returns the level currently set TRIGGER TRIGger IMPedance TRIGger SLOPe TRIGger SOURce TRIGger LEVel lt Level gt TRIGger LEVel lt Level gt lt NR2 gt lt unit gt where lt unit gt V mV with a range of 5 0 V to 5 0 V in 0 1 V steps DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples TRIGger SLOpe Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual TRIGGER LEVEL 200mV sets the level to 200 mV The TRIGger SLOpe command selects the rising or falling edge of the external signal which generates the trigger event The TRIGger SLOPe query returns status indicating which slope is currently selected TRIGGER TRIGger IMPedance TRIGger LEVel TRIGger SOURce TRIGger SLOPe POSitive NEGative TRIGger SLOPe POSitive selects rising edge NEGative selects falling edge TRIGGER SLOPE POSITIVE selects rising edge for trigger 2 119 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions TRIGger SOURCe Group Related Commands Syntax Arguments Examples TST Group Related Commands Syntax Arguments 2 120 The TRIGger SOURce command selects internal or external for the
87. cimal integer sent ESE 177 sets the ESER to 177 binary 10110001 which sets the PON CME EXE and OPC bits ESE might return 176 which indicates that the ESER contains the binary number 11010000 The ESR common query returns the contents of SESR Standard Event Status Register used in the status and events reporting system Refer to Section 3 Status and Events for more information about ESR or SESR Other CLS DESE ESE EVENT EVMsg EVQty SRE STB ESR None ESR might return 181 which indicates that the SESR contains the binary number 10110101 2 63 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions EVENT Group Related Commands Syntax Arguments Examples EVMsg Group Related Commands Syntax Arguments Examples 2 64 The EVENT query dequeues the event code of the event that has been in the Event Queue the longest out of all available events Use the ESR query to make the events available for dequeuing using EVENT Refer to Section 3 Status and Events Other CLS DESE ESE ESR EVMsg EVQty SRE STB EVENT None EVENT might return EVENT 113 The EVMsg query dequeues the event code and event message of the event that has been in the Event Queue the longest out of all available events Use the ESR query to make the events available for dequeuing using EVMsg Fo
88. circuit PLL operating state Set or query the clock signal internal external selection SYSTEM Commands Use these commands to set system parameters such as system data and time or security setting Table 2 13 SYSTEM commands Header SYSTem DATE SYSTem PPAUse SYSTem SECurity IMMediate Description Set or query system data lt year month day gt Set or query the setting for system operation when a self diagnostics detects an error Delete all settings and data DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups Table 2 13 SYSTEM commands Cont Header Description SYSTem SECurity STATe Set or query the security on off state SYSTem TIME Set or query system time lt hour minute second gt TRIGGER Commands Use these commands to set the trigger conditions for the internal and external trigger source Table 2 14 TRIGGER commands Header Description TRIGger Query all current trigger related settings TRIGger IMPedance Set or query the impedance presented to the the external trigger signal TRIGger INTERVal 7 Query the internal trigger settings TRIGger INTERVal STATe Set or query the internal trigger state TRIGger INTERVal TIME Set or query the internal trigger interval time TRIGger LEVel Set or query the level of the external trigger signal that generates the trigg
89. cution error 201 Invalid while in local 202 Settings lost due to RTL 203 Command protected 210 Trigger error 211 Trigger ignored 212 Armed ignored 213 Init ignored 214 Trigger deadlock 215 ARM deadlock 220 Parameter error 221 Settings conflict 222 Data out of range 223 Too much data 224 Illegal parameter value 225 Parameter under range 226 Parameter over range 227 Parameter rounded 230 Data corrupt or stale 231 Data questionable 240 Hardware error 241 Hardware missing 250 Mass storage error 251 Missing mass storage 252 Missing media 253 Corrupt media 254 Media full 255 Directory full 256 File name not found 257 File name error DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages DG2030 Programmer Manual Table 3 6 Execution errors EXE Bit 4 Cont Code Description 258 Media protected 260 Expression error 261 Math error in expression 262 Expression syntax error 263 Expression execution error 270 Macro error 271 Macro syntax 272 Macro execution error 273 Illegal macro label 274 Macro parameter error 275 Macro definition too long 276 Macro recursion error 277 Macro redefinition not allowed 278 Macro header not found 280 Program error 281 Cannot create program 282 Illegal program name 283 Illegal variable name 284 Program currently running 285 Program syntax error 286 Prog
90. e DATA BLOCk SIZe DATA BLOCk DELete lt Name gt lt Name gt lt string gt where lt string gt is the name of the block to be deleted DATA BLOCK DELETE BLOCK2 deletes the block with the name BLOCK2 DATA BLOCk DELete ALL Group Related Commands Syntax Arguments DG2030 Programmer Manual The DATA BLOCK DELete ALL command deletes all blocks After this command is executed the whole memory area consists of one block with the name NO NAME DATA DATA BLOCK ADD DATA BLOCK DEFine DATA BLOCK DELete DATA BLOCKk REName DATA BLOCk SIZe DATA BLOCk DELete ALL None 2 25 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA BLOCk REName Group Related Commands Syntax Arguments Examples DATA BLOCk SiZe Group Related Commands Syntax Arguments Responses 2 26 The DATA BLOCK REName command changes the name of a data block DATA DATA BLOCK ADD DATA BLOCK DEFine DATA BLOCK DELete DATA BLOCk DELete ALL DATA BLOCk SIZe DATA BLOCk REName lt From blockname gt lt To blockname gt lt From blockname gt lt string gt where lt string gt is the name of the block before it is renamed lt To blockname gt lt string gt where lt string gt is the name of the block after it is renamed DATA BLOCK RENAME BLOCK3 BLOCK4 changes the name of BLOCK3 to
91. e SOURce 0SCillator SOURce query returns whether the internal clock oscillator or an external clock input signal is used as the clock signal source SOURCE SOURce 0SCillator SOURce 0SCillator EXTernal FREQuency SOURce 0SCillator INTernal FREQuency SOURce 0SCillator INTernal PLLlock SOURce 0SCillator SOURce INTernal EXTernal SOURce 0SCil lator SOURce DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples SRE Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual INTernal use the internal clock source EXTernal use an external clock source connected to the external clock input SOURCE OSCILLATOR SOURCE INTERNAL EXTERNAL SOURCE OSCILLATOR SOURCE INTERNAL sets the internal clock oscillator to be used as the clock signal source The SRE common command sets the bits of the SRER Service Request Enable Register The SRE common query returns the contents of SRER The power on default for the SRER is all bits reset if the power on status flag is TRUE If this flag is set to FALSE the SRER maintains its value through a power cycle Other CLS DESE ESE ESR EVENT EVMsg EVQty STB SRE lt Bit Value gt SRE lt Bit Value gt lt NR1 gt where the argument must be decimal number from 0 to 255 The
92. e 2 4 RS 232 C Retrieving Response Messages DG2030 Programmer Manual 2 125 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Retrieving Response Messages 2 126 Figure 2 3 shows the response message retrieval operation when a GPIB interface is used When a query command is sent from the external controller the data generator puts the response message for the query on the output queue This response message cannot be retrieved unless the user performs a retrieval operation through the external controller If there is a response message queued in the output queue and another query command is sent from the external controller before a retrieval operation for the earlier message is performed the data generator will delete the queued response message and put the response message for the more recently sent query command in the output queue The SBR status byte register MAV bit can be used to check the response message queuing state See Section 3 Status and Events for more information on the output queue SBR and control methods Figure 2 4 shows the response message retrieval operation when an RS 232 C interface is used When a query command is sent from the external controller the data generator immediately sends the response message to the external controller through an output buffer As a result when either a dumb terminal or a terminal emulator program running on a PC is used
93. e Event Status Enable Register ESER and the Service Request Enable Register SRER The Standard Event Status Register SESR and the Status Byte Register SBR record certain types of events that may occur while the data generator is in use IEEE Std 488 2 1987 defines these registers Each bit in a Status Register records a particular type of event such as an execution error or service request When an event of a given type occurs the data generator sets the bit that represents that type of event to a value of one You can disable bits so that they ignore events and remain at zero See the Enable Registers section on page 3 4 Reading the status registers tells you what types of events have occurred The Standard Event Status Register SESR The SESR shown in Figure 3 1 records eight types of events that can occur within the data generator Use the ESR query to read the SESR register Reading the register clears the bits of the register so that the register can accumulate information about new events 3 1 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting 7 6 5 4 3 2 1 0 PON URQ CME EXE DDE QYE RQC OPC Figure 3 1 The Standard Event Status SESR Table 3 1 SESR bit functions Bit 7 MSB Function PON Power On Indicates that the data generator was powered on 6 URQ User Request Indicates an event occurred
94. e REPeat lt Line Number gt lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set lt Times gt lt NR1 gt where lt NR1 gt is a repeat count 1 to 65536 DATA SEQUENCE REPEAT lt Line Number gt lt Times gt DATA SEQUENCE REPEAT 5 8 sets the line 5 sequence step repeat count to 8 DATA SEQuence TWAIT 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The DATA SEQuence TWAIT command sets the sequence step trigger wait state to on or off The DATA SEQuence TWAIT query returns the sequence step trigger wait on off state DATA DATA SEQuence EVJ DATA SEQuence EVJTO DATA SEQuence LOOP DATA SEQuence REPeat DATA SEQuence TWAIT lt Line Number gt ON OFF 1 0 DATA SEQuence TWAIT lt Line Number gt lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set ON orl sets the trigger wait state to on OFF or 0 sets the trigger wait state to off DATA SEQUENCE TWAIT lt Line Number gt 1 0 DATA SEQUENCE TWAIT 5 0N sets the line 5 sequence step trigger wait state to on 2 41 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SUBSequence ADD Group Related Commands Syntax Arguments Examples The DATA SUBSequence ADD command adds a sub
95. e SH function controls the initiation and termina tion of the transfer of data bytes C i Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix C Interface Specification Interface Messages Listener L Allows a device to receive device dependent data over the interface This capability exists only when the device is addressed to listen This function uses a one byte address Talker T Allows a device to send device dependent data over the interface This capability exists only when the device is addressed to talk The function uses a one byte address Device Clear DC Allows a device to be cleared or initialized either individually or as part of a group of devices Remote Local RL Allows a device to select between two sources for operating control This function determines whether input information from the front panel controls local or GPIB commands remote control the data generator Service Request SR Allows a device to request service from the controller Controller C Allows a device with the capability to send the device address universal commands and addressed commands to other device over the interface to do so Electrical Interface E Identifies the type of the electrical interface The notation E1 indicates the electrical interface uses open collector drivers while E2 indicates the electrical interface uses three state drivers Table
96. e gt lt event code gt lt event message second message gt ALLEV might return the string ALLEV 113 Undefined header unrecognized command QUT ELEV 420 Query UNTERMINATED The CAL common command excutes self calibration on the data generator and returns its result This command is only used for clock calibration Other None CAL None lt Resul t gt lt Result gt lt NR1 gt where lt NR1 gt is one of following values 0 terminated without error 800 clock calibration failed CAL excutes the self caliblation and returns its result 2 21 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions CLS Group Related Commands Syntax Examples DATA Group Related Commands Syntax Examples 2 22 The CLS common command clears SESR Standard Event Status Register the SBR Status Byte Register and the Event Queue which are used in the data generator status and event reporting system For more details refer to Section 3 Status and Events Other DESE ESE ESR EVENT EVMsg EVQty SRE STB CLS CLS clears the SESR the SBR and the Event Queue The DATA query returns the setting states related to the pattern data DATA OUTPut DATA DATA might return DATA MSIZE378 BLOCK DEFINE 2440 BLOCK_1 lt LF gt 99 BLOCK 2 lt LF gt 189 BLOCK 3 lt LF gt 288 BLOCK_4 DATA SUBSEQUENCE DE
97. e of the use of the group definition command Sets up a sequence definition section in the DG2030 data memory using data from a file prepared in advance This program presents an example of the use of the sequence definition command Sets up a subsequence definition section in the DG2030 data memory using data from a file prepared in advance This program presents an example of the use of the subsequence definition command Supports interactive GPIB command and message exchange with the DG2030 This program allows the operator to easily confirm the actual operation of the GPIB commands This program also serves as an example of the communica tions protocols used between the DG2030 and the GPIB interface Required Execution Environment These programs run on an IBM PC AT compatible personal computer that has a National Instruments Inc GPIB interface installed The C sample programs run in the MS DOS prompt window and require a Windows 95 operating system and the National Instruments Inc GPIB95 driver software The BASIC sample programs require a MS DOS version 5 0 or later and the National Instruments Inc AT GPIB driver software In addition Microsoft Visual C Quick BASIC 4 5 or LabVIEW is required to compile and run the sample programs You should provide an environment that meets these conditions and install the respective software according to their manuals DG2030 Programmer Manual Artisan Technology Group Quality Instrum
98. easier to understand This program may not operate correctly if the format of the input file is not correct In particular note that commas are used to delimit the parameters in this input file and that spaces may not be inserted This program sends block definition data to the DG2030 data memory Data input is from a file in a unique format This command has the following syntax with the input data file name being specified as a parameter putblk filename The contents of the input file must express the block name and the block starting address in ASCII with one block per line This format corresponds to the parameter block supplied to the DATA BLOCK DEFINE command with the delimiter codes replaced by the newline code used in normal text files See the blkdef dat sample data file DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Input format checking has been dispensed with to make this sample program easier to understand This program may not operate correctly if the format of the input file is not correct In particular note that commas are used to delimit the parameters in this input file and that spaces may not be inserted Putseq This program sends sequence definition data to the DG2030 data memory Data input is from a file in a unique format This command has the following syntax with the input data file name being specified
99. echnology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples 4 12 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com eee e Appendix A Character Charts Table A 1 The DG2020 Character Set 7 0 32 48 80 112 q 22 38 70 86 102 118 2 I ee tel 7 23 39 55 71 87 103 119 p IT a a a a 72 88 120 9 5 41 57 73 89 105 121 10 42 74 122 11 27 43 75 91 107 123 C lt L 13 29 45 7 93 125 ar DG2030 Programmer Manual A 1 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix A Character Charts Table A 2 ASCII amp GPIB Code Chart B7 1 B6 1 B5 1 BITS NUMBERS B4 B3 B2 B1 CONTROL SYMBOLS UPPER CASE LOWER CASE 0 20 40 LAO 60 LA16 100 TAO 120 TA16 140 SA0 160 SA16 0000 NUL DLE SP 0 P p 0 o 10 16 20 32 30 48 40 64 50 80 60 96 70 112 1 GTL 21 LLO 41 LAI 61 LA17 101 TAM 121 TA17 141 SA1 161 SA17 0001 SOH DC1 1 A Q a q 1 IB RI 17 24 33 31 49 41 65 51 81 61 97 71 113 2 22 42 LA2 62 LA18 102 TA2 122 Tais 142 SA2 162 SA18 0010 STX DC2 w 2 B R b r 2 2 12 18 22 34 32 50 42 66 52 82 62 98 72 114 3 23 43 LA3 63 LA19 103 TA3 123 Taig 143 SA3 163 SA19 0011 ETX DC3 3 C S c s 3 3 13 19
100. ectory MMEMORY MDIRECTORY WORK4 creates the new directory WORK4 in the current working directory The MMEMory RDIRectory command removes a subdirectory If a file exist in the subderectory this command will not be performed MEMORY MMEMory CDIRectory MMEMory MDIRectory MMEMory RDIRectory lt Directory Path gt lt Directory Path gt lt string gt where lt string gt is the name of the directory to be removed MMEMORY RDIRECTORY WORK4 removes the directory WORK4 in the current working directory DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory REName Group Related Commands Syntax Arguments Examples MMEMory SAVE Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual The MMEMory REName command changes the name of the specified file A file that is locked using the MMEMory LOCK command cannot be renamed MEMORY MMEMory COPY MMEMory REName lt From filename gt lt To filename gt lt From filename gt lt string gt where lt string gt is the name of the file to be changed lt To filename gt lt string gt where lt string gt is the name of the file after it is changed MMEMORY RENAME COUNT1 PDA COUNT2 PDA changes the name of the file COUNT1 PDA in the current working directory to COUNT2 PDA The MMEMory SAVE command saves the
101. ee 2 9 Other General Command Conventions 00 ce cee eee eee eee 2 10 Command GroupS ccc ec ccc cece er tosi nesso Teiss 2 11 Command Summaries 0 dA K eee cee Ra K RRR ARN s 2 11 Command Descriptions sss ss s s x s s cece cece cece cece eee 2 19 Retrieving Response Messages cc cece cec eee cecececes 2 125 Status and Event Reporting Status and Event Reporting ss s s s e e x lt e x lt cece cece ee ee eee eee 3 1 REISES eru 3s sn0k ss EEEE pbb EEA ges lO eS eG E 3 1 QUEUES 4 shat eee U8 4 Eee be Oh BE Loe Reda RER ATR ESS inn 3 5 Processing SEQUENCE 44 54 685 40 ceed bes Sona RRR RET ES Dee RTE 3 6 Messages iso 5 0 oh See a locus but iw elo E E ow weave wang aun aerate Re eee 3 9 Programming Examples DG2030 Programmer Manual Programming Examples x x e e cece cece cece rere ceeee 4 1 Overview of the Sample Programs e e eee eee eee 4 1 Required Execution Environment gea R R R T 0 00 00 0 eee eee eee ee 4 2 Floppy Disk Files fis oc C N o Tag nee cous SEWER CS EE aE S 4 3 Installing and Compiling the Programs 0 0 0 0 02s eee 4 4 Sample Program Functions and Usage 00 0 0 e eee eee eee 4 6 l Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Table of Contents Appendices Appendix A Character Charts KR R eee RE ae A 1 Appendix B Reserved Words sese eee B 1
102. entation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Floppy Disk Files The floppy disk contains the following files The README TXT file stored in the floppy disk also provides you the detailed information MSVC Directory Filename getbit c Description The getbit C source file putbit c getword c putword c putblk c The putbit C source file The getword C source file The ptword C source file The putb1k C source file putgrp c The putgrp C source file putseq c putsub c intcom c The putseq C source file The putsub C source file The intcomC source file gpiblib c QBASIC Directory Filename getbit bas putbit bas makeexe bat The GPIB library used with the above programs Description The getbit BASIC source file The putbit BASIC source file The batch file used to compile these programs with Quick BASIC DATA Directory Each of the sample programs uses its own unique input or output format Several sample files with examples of those formats are stored on the floppy disk in this directory These files are all ASCII text files and can be viewed and edited with a text editor Filename patbit dat Description Output file for the getbit sample program or input file for putbi t patword dat Output file for the getword sample program or input file for putword bikdef dat grpdef dat seqdef dat subdef dat Input file for the putb1k sample progra
103. eration Service Request Enable Register set with SRE clear with SRE Figure 3 6 Status and event handling process overview DG2030 Programmer Manual 3 7 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting 3 8 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com TT Es Messages Tables 3 3 through 3 11 list the status and event messages used in the GPIB RS 232 C status and event reporting system You use the ESR query to make the messages available for dequeuing you use the EVENT EVMsg and ALLEv queries to dequeue and return the messages The messages return as follows m The EVENT query command returns the event code only When using these query commands use the ESR query to make the events available for return m The EVMsg and ALLEv queries return both the event code and event message in the following format lt event code gt lt event message secondary message gt Most messages returned have both an event message followed by a semicolon and a second message which contains more detailed information Although these secondary messages are not listed in this manual you can use the EVMsg and ALLEv queries to display them Table 3 3 lists the definition of event codes Table 3 3
104. ering event TRIGger SLOPe Set or query the slope of the external signal that generates a triggering event TRIGger SOURce Set or query trigger source Other Commands This group is a collection of commands that cannot be classified in any other group Table 2 15 Other commands Header Description ABSTouch Perform the function corresponding to the front panel control selected ALLEv Dequeue all events from Event Queue CAL Perform calibration and query its resalt CLS Clear SESR SBR and Event Queue DESE Set and query DESER ESE Set and query ESER ESR Query SESR DG2030 Programmer Manual 2 17 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups 2 18 Table 2 15 Other commands Cont Header Description EVENT Dequeue event from Event Queue EVMsg Dequeue event from Event Queue EVQty Query number of event on Event Queue FACTory Reset all settings to defaults HEADer Allow or suppress the return of the control header in response messages ID Query ID information about the data generator IDN Query ID information about the data generator LOCk Query lock or unlock local control using the front panel controls OPC Generate or return the operation complete message OPT Query which options are implemented for this data generator PSC Set or query power on status clear flag RS
105. ery returns the ID information of the data generator Other IDN ID None ID lt Manufacturer gt lt Model gt lt Firmware Level gt where lt Manufacturer gt SONY_TEK lt Model gt DG2030 lt Firmware Level gt CF lt Code and Format Version gt and FV lt Firmware Version gt ID returns SONY _TEK DG2030 CF 91 1CN FV 1 00 2 71 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions IDN Group Related Commands LOCK 2 72 Syntax Arguments Responses Examples The IDN common query returns the ID information of the data generator Other ID IDN None lt Manufacturer gt lt Model gt lt Serial Number gt lt Firmware Level gt where lt Manufacturer gt SONY TEK lt Model gt DG2030 lt Serial Number gt 0 lt Firmware Level gt CF lt Code and Format Version gt lt sp gt FV lt Firmware Version gt and lt sp gt Space IDN might return SONY TEK DG2030 0 CF 91 1CN FV 1 00 The LOCk command enables or disables the knob and all front panel buttons except the ON STBY button The LOCk query returns a status indicating whether the knob and the buttons are locked or not These data generators do not switch between remote control and local control modes but rather allow simultaneous setting from an external controller and from the front panel Use this command t
106. eturns the repeat count set for the sub sequence step DATA None DATA SUBSequence REPeat lt SName gt lt Line Number gt lt Times gt DATA SUBSequence REPeat lt SName gt lt Line Number gt lt SName gt lt String gt where lt String gt is a sub sequence name surrounded in double or single C quotes lt Line Numbers lt NR1 gt where lt NR1 gt is the line number of the sequence step to be set lt Times gt lt NR1 gt where lt NR1 gt is a repeat count 1 to 65536 DATA SUBSEQUENCE REPEAT lt SName gt lt Line Number gt lt Times gt DATA SUBSEQUENCE REPEAT SUB1 5 8 sets the line 5 sequence step repeat count in the sub sequence named SUB1 to 8 2 45 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA UPDate Group Related Commands Syntax Arguments DEBug Group Related Commands Syntax Arguments Responses Examples 2 46 The DATA UPDate command transfers the contents of data memory to pattern generation memory so that the output reflects the most recent data This command is only valid when the mode is set to manual mode The processing performed by this command is executed automatically if any data changes when the instrument is in automatic mode DATA None DATA UPDate None The DEBug query returns all current settings for the remote command debugging function T
107. eue overflow To read out from the Event Queue do the following steps 1 Send ESR To read out the contents of SESR When the contents of SESR are read out SESR is cleared allowing you to take out events from the Event Queue DG2030 Programmer Manual 3 5 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting 2 Send one of the following queries ALLEv To read out and returns all events made available by ESR Returns both the event code and message text EVENT To read out and return the oldest event of those made available by ESR Returns only the event code m EVMsg To read out and return the oldest event of those made available by ESR Returns both the event code and message text Reading the SESR erases any events that were made available by previous ESR reads but that were not read from the Event Queue Events that occur after an ESR read are put in the Event Queue but are not available until ESR is used again Processing Sequence Figure 3 6 shows the status and event processing flow 1 An event occurs which causes the DESR to be checked Based on the state of the DESR the following actions occur R Ifthe control bit for that event is set in the DESER the SESR bit that corresponds to this event becomes set to 1 m The set control bit lets the event be placed into the Event Queue Placing the event in the Event
108. f the screen The UTILITY menu appears above the bottom menu buttons 2 Press the System bottom menu button to display the System menu See Figure 1 4 3 Select the Configure item from the GPIB menu using the up and down arrow buttons Set the GPIB operating mode using the left and right arrow buttons R Talk Listen Sets the communications mode to talk listen m Talk Only Sets the communications mode to talk only which is used for hardcopy output R Off Bus Logically disconnect the data generator from GPIB system NOTE The data generator accepts as a terminator either the software LF Line Feed sent as the last data byte or the hardware EOI with the EOI line asserted concurrently with the last data byte sent 4 Select the Address item from the GPIB menu using the up and down arrow buttons Then use the rotary knob to set the primary address to a value in the range 0 to 30 5 Select the Remote Port item using the up and down arrow buttons and additionally highlight GPIB using the left and right arrow buttons This selects the GPIB as the remote interface Remote Port System GPIB M GPIB Configure gn Address Reset to Factory Serial Baudrate Data Bits Security Stop Bits Immediate D 3 Handshake Power up Pause Date Time Figure 1 4 GPIB parameter settings DG2030 Programmer Manual 1 5 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE ww
109. fferentiated with colons white space commas or semicolons Colon Typically delimits the compound command header MMEMORY DELETE ALL SOURCE OSCILLATOR SOURCE White Space Typically delimits command query headers from the argument DIAGNOSTIC SELECT ALL SYSTEM DATE 1997 7 7 DIAGNOSTIC SELECT and SYSTEM DATE are the command headers and ALL and 1997 7 7 are the arguments Comma Typically delimits between multiple arguments In the above example a comma delimits the multiple arguments 1997 7 and 7 Semicolon Typically delimits between multiple commands or multiple program message units For more information about using the semicolon refer to Concatenating Commands on page 2 8 White space which is used to delimit certain syntactic elements in a command is defined in the data generator as a single ASCII encoded byte in the range ASCII 0 32 decimal This range consists of the standard ASCII characters exclusively except for ASCII 10 which is the Line Feed LF or New Line NL character The Line Feed LF character or the New Line NL character ASCII 10 and all characters in the range of ASCII 127 255 are defined as special characters These characters are used in arbitrary block arguments only using these characters in other parts of any command yields unpredictable results Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax
110. ge OUTPut CHCLK FAL1 VALid Query clock output fall time and its validity OUTPut CHCLK HIGH Set or query clock output high level output voltage DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups Table 2 11 OUTPUT commands Cont Header OUTPut CHCLK LOW Description Set or query clock output low level output voltage OUTPut CHCLK RISe Set or query clock output rise time OUTPut CHCLK RISe RANge OUTPut CHCLK RISe VALid OUTPut DEFine Query clock output rise time valid range Query clock output rise time and its validity Set or query channel data bit assignments OUTPut ELEVel Set or query the event input level OUTPut ILEVel Set or query the inhibit input level SOURCE Commands Use these commands to select the clock signal source set the clock frequency and enable or disable the event input Table 2 12 SOURCE commands Header SOURce EVENT ENAB1e Description Query enable or disable the event input SOURce 0SCillator SOURce 0SCillator EXTernal FREQuency SOURce 0SCillator INTernal FREQuency Query all clock signal settings Set or query the external clock frequency Set or query the internal clock frequency SOURce 0SCillator INTernal PLLlock SOURce 0SCillator SOURce Set or query the internal clock oscillator
111. grammer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples lt Frequency gt lt NR3 gt lt Unit gt where lt NR3 gt is a decimal number that combines with lt Unit gt to have a range of 10 00E 3 400 0E 6Hz and lt Unit gt Hz kHz MHz for hertz kilohertz or megahertz SOURCE OSCILLATOR EXTERNAL FREQUENCY lt NRf gt HZ SOURCE OSCILLATOR EXTERNAL FREQUENCY 10 0MHZ sets the external clock signal frequency input setting to 10 MHz SOURce OSCillator INTernal FREQuency Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The SOURce 0SCillator INTernal FREQuency command sets the frequency of the internal clock oscillator The SOURce 0SCillator INTernal FRE Quency query returns the internal clock oscillator frequency setting SOURCE SOURce 0SCillator SOURce 0SCillator EXTernal FREQuency SOURce 0SCillator INTernal PLLlock SOURce 0SCillator SOURce SOURce 0SCillator INTernal FREQuency lt Frequency gt SOURce 0SCillator INTernal FREQuency lt Frequency gt lt NR3 gt lt Unit gt where lt NR3 gt is a decimal number that combines with lt Unit gt to have a range of 10 00E 3 400 0E 6Hz and lt Unit gt Hz kHz MHz for hertz kilohertz or megahertz SOURCE OSCILLATOR INTERNAL
112. gt INHibit OFF INTernal EXTernal BOTH 0 1 2 3 OUTPut CH lt n gt INHibit lt n gt 0 to 7 Arguments OFF 0 No output impedance control INTernal 1 The output impedance is controlled by the pod s channel 0 signal EXTernal 2 The output impedance is controlled by an external input signal INH BOTH 3 The output impedance is controlled by the logical OR of the pod s channel 0 signal and an external input signal INH Responses OUTPUT POD lt s gt CH lt n gt INHIBIT 0 1 2 3 Examples OUTPUT CH3 INHIBIT EXTERNAL sets the output impedance of channel 3 to be controlled by an external input signal INH DG2030 Programmer Manual 2 91 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt LOW Group Related Commands Syntax Arguments Responses Examples The OUTPut CH lt n gt LOW command sets the low level output voltage for the specified channel The OUTPut CH lt n gt LOW query returns the low level output voltage setting for the specified channel OUTPUT OUTPut CH lt n gt HIGH OUTPut CH lt n gt LOW lt Volt gt OUTPut CH lt n gt LOW lt n gt 0 to 7 lt Volt gt lt NR2 gt lt Unit gt where lt NR2 gt combined with lt Unit gt specifies a low level voltage and lt Unit gt V mV for volt or millivolt OUTPUT CH lt n gt LOW
113. he usage prescribed by the IEEE Std 488 1 OPC Operation Complete Indicates that the operation is complete This bit is set when all pending operations complete following a OPC command DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Status and Event Reporting The Status Byte Register SBR Shown in Figure 3 2 this register records whether output is available in the Output Queue whether the data generator requests service and whether the SESR has recorded any events Use a Serial Poll or the STB query to read the contents of the SBR The bits in the SBR are set and cleared depending on the contents of the SESR the Event Status Enable Register ESER and the Output Queue When you use a Serial Poll to obtain the SBR bit 6 is the RQS bit When you use the STB query to obtain the SBR bit 6 is the MSS bit Reading the SBR does not clear the bits including the MSS bit 6 RQS 5 4 2 ESB MAV Figure 3 2 The Status Byte Register SBR 7 Table 3 2 SBR bit functions Bit Function 7 MSB Not used Must be set to zero for data generator operation 6 The RQS Request Service bit when obtained from a serial poll Shows that the data generator requests service from the GPIB controller that is the SRQ line is asserted on the GPIB This bit is cleared when the serial poll completes 6 The MSS Master Status
114. his query is equivalent to the DEBug SNOop query DEBUG DEBug SNOop DEBug SNOop DELAy TIME DEBug SNOop STAT e DEBug None See Examples DEBUG might return DEBUG SNOOP STATE 0 DELAY TIME 0 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DEBug SNOop Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The DEBug SNOop query returns all current settings for the remote command debugging function This query is equivalent to the DEBug query DEBUG DEBug DEBug SNOop DELAy TIME DEBug SNOop STATe DEBug SNOop None See Examples DEBUG SNOOP might return DEBUG SNOOP STATE 0 DELAY TIME 0 2 2 47 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DEBug SNOop DELAy Group Related Commands Syntax Arguments Responses Examples 2 48 The DEBug SNOop DELAy query returns the display time for commands in a sequence of commands connected by semicolons This query is equivalent to the DEBug SNOop DELAy TIME query DEBUG DEBug DEBug SNOop DEBug SNOop DELAy TIME DEBug SNOop STATe DEBug SNOop DELAy None DEBUG SNOOP DELAY lt Delay Time gt where lt Delay Time gt lt NR2 gt DEBUG SNOOP DELAY might return DEBUG SNOOP DELA
115. ial poll 3 3 SESR register 3 1 Source commands SOURce EVENT ENABIle 2 105 SOURce OSCillator EXTernal FREQuency 2 106 SOURce OSCillator SOURCce 2 108 SOURce OSCillator INTernal FREQuency 2 107 SOURce OSCillator INTernal PLLlock 2 108 SOURce OSCillator 2 106 SOURce EVENT ENABIle 2 105 SOURce OSCillator EXTernal FREQuency 2 106 SOURce OSCillator SOURce 2 108 SOURce OSCillator INTernal FREQuency 2 107 SOURce OSCillator NTernal PLLlock 2 108 SOURce OSCillator 2 106 SRE 2 109 SRE command 3 5 SRER register 3 5 STArt 2 110 Status 3 1 Status and error commands DESE 3 4 ESE 3 4 ESR 3 1 SRE 3 5 DG2030 Programmer Manual Guaranteed 888 88 SOURCE www artisantg com Index STB 3 3 Status and events processing of 3 6 Status Registers Defined 3 1 STB 2 110 STB query 3 3 STOP 2 111 System commands SYSTem DATE 2 111 SYSTem PPAUse 2 112 SYSTem SECurity MMediate 2 112 SYSTem SECurity STATe 2 113 SYSTem TIME 2 114 System events 3 14 SYSTem DATE 2 111 SYSTem PPA Use 2 112 SYSTem SECurity MMediate 2 112 SYSTem SECurity STATe 2 113 SYSTem TIME 2 114 T TRG 2 114 TRIGer 2 115 Trigger commands TRIGger 2 115 TRIGger IMPedance 2 116 TRIGger INTERVal 2 116 TRIGger INTERVal STATe 2 117 DG2030 Programmer Manual TRIGger INTERVal TIME 2 118 TRIGger LEVel 2 118 TRIGger SLOpe 2 119 TRIGger SOURCce 2 120 TRIGger IMPedance 2 116 TRIGger INTE
116. ileges reserved Tektronix Inc P O Box 500 Beaverton OR 97077 TEKTRONIX and TEK are registered trademarks of Tektronix Inc Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com IC AEE Table of Contents Getting Started Command Syntax Prefa KETE EA see ARRE EAER ER AER Te Y Getting Started sea 6 Ra R RR RRR RRR RR TE AR RE EDE EEES 1 1 Choosing an Interface 0 a RKR 2 R d R N R cece tenes 1 2 Installing for GPIB Communication 0 0 0 0 cece eee eee 1 3 Installing for RS 232 C Communication 000 00 e eee eee eee 1 6 Command Synt x soos 5 64 6 iias Giese a 6 wie gina a wie ore EEn a aE 2 1 Command Notation 0 0 0 0 eee cence eens 2 1 Program and Response Messages preninte etnii eee KR 2 1 Command and Query Structure 0 2 E E RE E E eee 2 2 Character Encoding ic02ccs en hdtl wl Khost Redd eA eee EP edd 2 2 Syntactic Delimiters ca c iic ons ee kanki ani wa eee plane be Nae He Maree takes 2 3 White Space e c42c20 eaii eked wine t ned lat he neh ate he hes 2 3 Special Characters lt 5 ch cis8 ide hadi beet ee EOLA eee Me ELT add 2 3 ATSUMOCNUS 5 644 hacen hdc wield oa AEE S Vad ee Seed engke asie Name Reva ee 2 4 Header sbospenras emai nw nid thd Bape tn bustd abl atae Atkin ee Bate Rabe ne Glee 2 6 Concatenating Commands 0 0 0 eee eee cnet eens 2 8 Query RESPONSES 33 555 ec sence nish nen bt node tweed nb amb es b
117. ime gt lt NR2 gt lt Unit gt FAST lt Unit gt s ms us ns OUTPUT CH lt n gt FALL lt NR3 gt OUTPUT CH1 FALL Ins sets the fall time for channel to Ins DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt FALI RANge The OUTPut CH lt n gt FAL1 RANge query returns the valid range of the fall time setting for the specified channel Group OUTPUT Related Commands OUTPut CH lt n gt FAL1 OUTPut CH lt n gt FAL1 VALid Syntax OUTPut CH lt n gt FAL1 RANge lt n gt 0 to 7 Arguments None Responses OUTPUT CH lt n gt FALL RANGE lt min gt lt max gt lt min gt lt NR3 gt where lt NR3 gt is the minimum acceptable value lt max gt lt NR3 gt where lt NR3 gt is the maximum acceptable value Examples OUTPUT CHO FALL RANGE might return OUTPUT CH0 FALL RANGE 2 0E 9 7 0E 9 DG2030 Programmer Manual 2 89 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt FALI VALid Group Related Commands Syntax Arguments Responses Examples The OUTPut CH lt n gt FAL1 VALid command returns the fall time setting for the specified cahnnel and wether the setting value is valid or not OUTPUT OUTPut CH lt n gt FAL1 OUTPut CH lt n gt FAL1 RANge
118. in ASCII The DATA SEQuence DEFine query returns all of the sequence definition section information DATA DATA SEQuence ADD DATA SEQuence DELete DATA SEQuence DELete ALL DATA SEQuence DEFine lt Sequence Block gt DATA SEQuence DEFine lt Sequence Block gt lt blockheader gt lt Step gt lt LF gt lt Step gt lt LF gt lt Step gt Arbitrary block data for the sequence definition where lt blockheader gt lt byte count digit gt lt byte count gt lt Step gt lt AName gt lt ARepeat gt lt ATo gt lt AWaitE gt lt AJumpE gt lt ALoopE gt The items in lt Step gt are ASCII character strings that express the following information lt AName gt the block name with no quotation marks lt ARepeat gt repeat count 1 to 65536 lt ATo gt event jump destination line number lt AWaitE gt trigger wait on off state ON 1 ON OFF 0 OFF lt AJumpE gt event jump on off state ON 1 ON OFF 0 OFF lt ALoopE gt infinite loop on off ON 1 ON OFF 0 OFF lt LF gt lt ASCII line feed code 10 gt DATA SEQUENCE DEFINE lt Sequence Block gt where lt Sequence Block gt is a data block with the same format as the argument However note that rather than the ON and OFF keywords only 0 and 1 are used for the lt AWaitE gt lt AJumpE gt and lt ALoopE gt items DATA SEQuence DEFine 235BLOCK1 16 0 1 0 0 lt LF gt BLOCK2 32 0 0 1 1 defines a two step sequence th
119. inition section information Group DATA Related Commands DATA SUBSequence ADD DATA SUBSequence CLEAr DATA SUBSequence DELete DATA SUBSequence DELete ALL Syntax DATA SUBSequence DEFine lt Subseq Block gt DATA SUBSequence DEFine Arguments lt Subseq Block gt lt blockhead er gt lt SName gt lt Step gt lt Step gt lt LF gt lt SName gt lt Step gt lt Step gt Arbitrary block data for the sequence definition where lt Step gt lt AName gt lt ARepeat gt The items in lt Step gt are ASCII character strings that express the following information lt SName gt the sub sequence name with no quotation marks lt AName gt the block name with no quotation marks lt ARepeat gt repeat count 1 to 65536 lt LF gt lt ASCII line feed code 10 gt Responses DATA SUBSEQUENCE DEFINE lt Subseq Block gt where lt Subseq Block gt is a data block with the same format as the argument Examples DATA SUBSEQUENCE DEFINE 233SUB1 B1 16 B2 32 lt LF gt SUB2 B3 2 B4 3 defines a two step sub sequence that consists of the two sub sequences SUB1 and SUB2 DG2030 Programmer Manual 2 43 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DATA SUBSequence DELete Group Related Commands Syntax Arguments Examples The DATA SUBSequence DEL ete command deletes the specified sub sequence step DATA
120. ions of the data generator from an external controller This section describes the syntax and communication rules for using these commands to operate the data generator Command Notation The command syntax is in extended BNF Backus Naur Form notation The extended BNF symbols used in the command set are shown in the following table Table 2 1 BNF symbols and meanings Symbol Meaning lt gt Indicates a defined element Delimits Exclusive OR elements Delimits a group of elements one of which the programmer must select Delimits an optional element that the programmer may omit Delimits an optional element that the programmer may omit or may repeat one or more times tre Indicates that the left member is defined as shown by the the right member Program and Response Messages Programs created or placed in an external controller are transferred to the data generator as a program message A program message is a sequence of zero or more program message units delimited by the program message unit delimiter the semicolon A program message unit is a set command or query command The data generator performs a function or changes a setting or mode when it receives a set command when it receives a query command it returns measurement data settings status codes and or status messages The data generator transfers these response messages to the external controller DG2030 Programmer Manual 2 1 Artisan Technol
121. isantg com Command Descriptions HCOPy FORMat Group Related Commands Syntax Arguments Responses Examples 2 68 The HCOPy FORMat command sets the hard copy output format The HCOPy FORMat query returns the currently specified hard copy output format HARDCOPY HCOPy HCOPy FORMAT BMP EPSOn EPSMono THINkjet TIFF HCOPy FORMAT BMP the Windows monochrome file format EPSOn the format used by 9 pin and 24 pin dot matrix printers in ESC P graphics mode EPSMono the encapsulated Postscript format monochrome image file format THINkjet the format used by HP inkjet printers TIFF the TIFF format HCOPY FORMAT BMP EPSON EPSMONO THINKJET TIFF HCOPY FORMAT TIFF sets the data generator to output hard copy in the TIFF format DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions HCOPy PORT 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The HCOPy PORT command sets the hard copy output port The HCOPy PORT query returns the currently specified hard copy output port HARDCOPY HCOPy HCOPy PORT DISK GPIB RS232c HCOPy PORT DISK outputs to a file on the floppy disk GPIB outputs to the GPIB port RS232c outputs to the RS 232C port HCOPy PORT DISK GPIB RS232c HCOPY PORT DISK
122. k output Group OUTPUT Related Commands OUTPut CHCLK RISe OUTPut CHCLK RISe VALid Syntax OUTPut CHCLK RISe RANge Arguments None Responses OUTPUT CHCLK RISE RANGE lt min gt lt max gt lt min gt lt NR3 gt where lt NR3 gt is the minimum acceptable value lt max gt lt NR3 gt where lt NR3 gt is the maximum acceptable value Examples OUTPUT CHCLK RISE RANGE might return QUTPUT CHCLK RISE RANGE 2 0E 9 7 0E 9 DG2030 Programmer Manual 2 99 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CHCLK RISe VALid Group Related Commands Syntax Arguments Responses Examples OUTPut DEFine Group Related Commands Syntax 2 100 The OUTPut CHCLK RISe VALid command returns the rise time setting for the clock output and wether the setting value is valid or not OUTPUT OUTPut CHCLK RISe OUTPut CHCLK RISe RANge OUTPut CHCLK RISe VALid None L OUTPUT CHCLK RISE VALID lt NR3 gt 0 1 1 valid O invalid OUTPUT CHCLK RISE VALID might return OUTPUT CHCLK RISE VALID 1 0E 9 1 The OUTPut DEFine command assigns data bits to all the channels specified in the header The data bit assignment is cleared for any data bit not specified in the argument The OUTPut DEFine query returns the data bits assigned to the channels specified in the header OUTPUT OUTPut CH lt n gt ASSIGn O
123. le Size gt lt NR1 gt and lt Time Stamp gt lt string gt NOTE A file size of 0 is returned for subdirectories MMEMory CATalog ORDer Group Related Commands Syntax 2 74 The MMEMory CATalog ORDer command sets the display order for file informa tion in disk directory listings The MMEMory CATalog ORDer query returns the display order for file information in disk directory listings MEMORY MMEMory CATalog ALL 7 MMEMory CATalog ORDer NAME1 NAME2 TIME1 TIME2 MMEMory CATalog ORDer DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Responses Examples NAME1 orders the display according to the ASCII collating sequence of the file names NAME2 orders the display in the reverse order of the NAME order TIME1 orders the display with older Date and Time files first TIME2 orders the display with more recent Date and Time files first MMEMORY CATALOG ORDER NAME1 NAME2 TIME1 TIME2 MMEMORY CATALOG ORDER NAME1 sets the order of file information recorded in disk directory listings to alphabeti cal order by file name MMEMory CDiRectory Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The MMEMory CDIRectory command changes the current working directory The MMEMory CDIRectory query returns the
124. lt NR2 gt OUTPUT CH4 LOW 1V sets channel 7 low level output voltage to 1 V OUTPut CH lt n gt RELEase Group Related Commands Syntax Arguments Examples 2 92 The OUTPut CH lt n gt RELEase command clears the data bit assignment for the specified channel OUTPUT OUTPut CH lt n gt ASSIGn OUTPut DEFine OUTPut CH lt n gt RELEase lt n gt 0 to 7 None OUTPUT CH3 RELEASE clears data bit assignment for channel 3 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt RISe 2 Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The OUTPut CH lt n gt RISe command sets the rise time for the specififd channel The OUTPut CH lt n gt RISe query returns rise time setting for the specified channel If FAST or 0 is used in the argument the rise time become as fast as possible OUTPUT OUTPut CH lt n gt RISe RANge OUTPut CH lt n gt RISe VALid OUTPut CH lt n gt RISe lt Time gt OUTPut CH lt n gt RISe lt n gt 0 to 7 lt Time gt lt NR2 gt lt Unit gt FAST lt Unit gt s ms us ns OUTPUT CH lt n gt RISE lt NR3 gt OUTPUT CH1 RISE Ins sets the rise time for channel 1 to Ins 2 93 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www a
125. m Input file for the putgrp sample program Input file for the putseq sample program Input file for the put sub sample program DG2030 Programmer Manual 4 3 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples Installing and Compiling the Programs Making Copy Compiling the Source Codes Executable programs must be created by compiling the source files provided on the floppy disk The programs are compiled after copying the source files to the hard disk To prevent any possibility of damaging the original during these operations it is recommended that you first make a copy of the floppy disk store the original in a safe place and use the copy for the following procedures Create a directory on the hard disk in which you install all of the sample programs This procedure assumes that the hard drive is drive c and the floppy drive is drive a In the DOS prompt window type the following commands mkdir c DGSAMPLE 20A Copy the folders and files in the floppy disk with the directory tree structure kept intact You can simply do this operation by drag and drop method in the Windows 95 Explorer window 1 Click Drive A floppy icon to display the files in the floppy disk 2 Select Select All from the File menu Alternatively you can make this operation by pressing Control A keys on the keyboard 3 Drag the selected files in the floppy t
126. mal text files The first line in this file corresponds to subsequence line number 0 and each following line to the subsequence line number incremented by 1 See the subdef dat sample data file Input format checking has been dispensed with to make this sample program easier to understand This program may not operate correctly if the format of the input file is not correct In particular note that commas are used to delimit the parameters in this input file and that spaces may not be inserted Intcom This program implements interactive communication between an external controller and the DG2030 That is it transmits GPIB commands entered from the keyboard to the DG2030 and displays messages returned from the DG2030 DG2030 Programmer Manual 4 9 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples 4 10 on the screen The command has the following syntax in which the argument specifies the device name registered in the GPIB driver system The device dev is used as the default if the argument is omitted intcom device When this program is started it displays its own prompt and waits for input When a command is entered it executes the processing for that command and then returns to the command wait state It iterates this sequence until the termination command is entered The prompt indicates the GPIB device name as shown below devl gt gt The DG20
127. me gt lt File Name gt lt string gt where lt string gt is the name of the file to be loaded MMEMORY LOAD MYDATA PDA loads all information from the file MYDATA PDA in the current directory into the instrument s internal memory The MMEMory LOCK command sets and clears file locks When a file is locked it cannot be deleted or written to The MMEMory LOCK query returns whether or not the file is locked MEMORY None MMEMory LOCK lt Path Name gt ON OFF 1 0 MMEMory LOCK lt Path Name gt lt Path Name gt lt string gt where lt string gt is the name of the file to be locked or unlocked ON or 1 locks the file OFF or 0 unlocks the file 0 the file is not locked 1 the file is locked MMEMORY LOCK COUNT1 PDA ON locks the file COUNT1 PDA in the current directory 2 79 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory MDiRectory Group Related Commands Syntax Arguments Examples MMEMory RDIRectory Group Related Commands Syntax Arguments Examples 2 80 The MMEMory MDIRectory command creates a new subdirectory The command is invalid if a directory with the specified name already exists MEMORY MMEMory CDIRectory MMEMory RDIRectory MMEMory MDIRectory lt Directory Path gt lt Directory Path gt lt string gt where lt string gt is the name or path of the new dir
128. minators EOM A generic acronym referring to the end of message terminator The end of message terminator can be either an EOI or the ASCII code for line feed LF GPIB Acronym for General Purpose Interface Bus the common name for the communications interface system defined in IEEE Std 488 IEEE Acronym for the Institute for Electrical and Electronic Engineers QuickC A computer language distributed by Microsoft that is based on C DG2030 Programmer Manual Glossary 1 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Glossary Glossary 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Index A ABSTouch 2 19 ALLEv 2 20 ASCII code and character charts A 1 Backus Naur Form 2 1 C CAL 2 21 Characters ASCII chart A 1 CLS 2 22 Command BNF notation 2 1 Structure of 2 2 Syntax 2 1 2 19 Command errors 3 10 Commands words reserved for B 1 D DATA commands DATA 2 22 Data commands DATA BLOCk ADD 2 23 DATA BLOCk DEFine 2 24 DATA BLOCk DELete 2 25 DATA BLOCk DELete ALL 2 25 DATA BLOCk REName 2 26 DATA BLOCKk SIZe 2 26 DATA GROUp ADD 2 27 DATA GROUp BIT 2 28 DATA GROUp DEFine 2 29 DATA GROUp DELete 2 30 DATA GROUp DELete ALL 2 30 DATA GROUp NAME 2 30 DATA GROUp REName 2 31 DATA MSIZe 2 32 DATA PATTern BIT 2 32 DATA PATTern WORD
129. n external input signal Channel 2 Bit 7 no high impedance control Other channels Assignments cleared 2 101 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut ELEVel 2 Group Related Commands Syntax Arguments Responses Examples OUTPut ILEVel 2 Group Related Commands Syntax Arguments Responses 2 102 The OUTPut ELEVel command sets the event input threshold level The OUTPut ELEVel query returns the event input threshold level setting OUTPUT None OUTPut ELEVel lt Volt gt OUTPut ELEVel 7 lt Volt gt lt NR2 gt lt Unit gt where lt Unit gt V mV with a range of 5 0 V to 5 0 V in 0 1 V steps OUTPUT ELEVEL lt NR2 gt OUTPUT E LEVEL 500mV sets the event input threshold level to 500 mV The OUTPut ILEVel command sets the high impedance control input inhibit input threshold level The OUTPut ILEVel query returns the high impedance control input threshold level setting OUTPUT OUTPut ILEVel lt Volt gt OUTPut ILEVel lt Volt gt lt NR2 gt lt Unit gt where lt Unit gt V mV with a range of 5 0 V to 5 0 V in 0 1 V steps OUTPUT ILEVEL lt NR2 gt DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples PSC Group Related Commands
130. name being specified as a parameter putword filename The contents of the input file must express the data length and start address parameters as well as the bit pattern data itself in ASCII text Each parameter must appear on a separate line and start with a number sign character The bit pattern data is expressed as 8 bit words of 1 bytes each starting with the most significant byte with each byte expressed in hexadecimal A newline character is required for each data word This format is the same format as that produced by redirecting the output of the getword program See the patword dat sample data file Input format checking has been dispensed with to make this sample program easier to understand This program may not operate correctly if the format of the input file is not correct This program sends group definition data to the DG2030 data memory Data input is from a file in a unique format This command has the following syntax with the input data file name being specified as a parameter putgrp filename The contents of the input file must express the group name the group s highest and lowest bit numbers in ASCII with one group per line This format corre sponds to the parameter block supplied to the DATA GROUP DEFINE command with the delimiter codes replaced by the newline code used in normal text files See the grpdef dat sample data file Input format checking has been dispensed with to make this sample program
131. nates If all of the self test routines are selected using the DIAGnostic SELect command self testing continues with execution of the next self test routine Group DIAGNOSTIC Related Commands DJ AGnostic SELect DIAGnostic RESU1t Syntax DIAGnostic STATe EXECute 2 54 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Arguments Examples DISPlay Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual EXECute Performs the self test using the selected routine DIAGNOSTIC SELECT ALL STATE EXECUTE RESULT executes all of the self test routines After all self test routines finish the results of the self tests are returned The DISPlay query returns all the settings set using the display commands DISPLAY None DISPlay None Returns the settings as a sequence of commands suitable for sending as set commands later to restore a setup See Examples DISPLAY might return DISPLAY BRIGHTNESS 0 7 CLOCK 0 DIMMER 1 ENABLE 1 MENU NAME SETUP STATE 1 DISPLAY WINDOW TEXT DATA 2 55 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DISPlay BRIGhtness Group Related Commands Syntax Arguments Examples DISPlay CLOCk 2 Group Related Commands Syntax Arguments
132. nic represents a header node or a header subfunction The command or query header comprises one or more header mnemonics that are delimited with the colon The channel can be specified by using the OUTPut CH lt n gt header mnemonic in commands and query commands The term lt n gt is a number between 0 and 7 that expresses the specified channel Commands and queries can be structured into six basic forms R Simple command header R Simple query header R Compound command header R Compound query header m Common command header R Common query header DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax DG2030 Programmer Manual Figure 2 1 on page 2 2 shows the syntax for all possible structures and each of the six basic forms are explained below Simple Command Header A command that contains only one header mnemonic It may also contain one or more arguments Its message format is lt Header Mnemonic gt lt Argument gt lt Argument gt such as START or STOP Simple Query Header A command that contains only one header mnemonic followed by a question mark Its message format is lt Header Mnemonic gt lt Argument gt lt Argument gt such as HCOPY or TRIGGER Compound Command Header A command that contains multiple header mnemonics plus argument s Its message format is lt He
133. o lock the functions of the front panel buttons and knobs to disable front panel operations during operation from an external controller or during external controller software execution DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual NOTE When the front panel control operations are locked out by the LOCk command the instrument displays the character string FP LOCKED at the upper right of the screen Other UNLock LOCk ALL NONe LOCK ALL disables the front panel buttons and the knob except the ON STBY button NONe enables the front panel buttons and the knob LOCk ALL disables the front panel buttons and the knob 2 73 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions MMEMory CATalog ALL Group Related Commands Syntax Arguments Responses The MMEMory CATalog ALL query returns a list of all files and directories in the current directory on the floppy disk MEMORY MMEMory CATalog ORDer MMEMory CATalog ALL 7 None MMEMORY CATALOG ALL lt File Entry gt lt File Entry gt where lt File Entry gt lt File Name gt lt File Size gt lt Time Stamp gt lt File Name gt lt string gt lt Fi
134. o the new directory created in step 1 Do the following procedures to compile the sample program source code The procedures are different depending on the source code type C or BASIC In case of C programs 1 You need the National Instrument GPIB library file to use the sample program source codes The library is assumed to be resided in the following default path c GPIB95 LANGINT C When you have a different environment change the default path setting defined in the project file or to make the directory as required 2 To compile the C sample source codes you need Microsoft Developer Studio Select File from the Open Workspace menu in the Microsoft Developer When the compiler environment has been installed properly you can just click the project workspace file in the Explorer window to compile the sample program source code DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Programming Examples For example R Double click the C DGSAMPLE 20A GETBIT GETBIT MDP file icon in the Explorer window to open the getbit sample program The Developer Studio will automatically be invoked and the project workspace will be opened R Select Build from the Build menu to compile the sample program source code 3 Execute the compiled programs in the MS DOS prompt window Type the following commands for example cd c DGSAMPLE 20A GETBIT GET
135. ogy Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax Command and Query Structure Character Encoding Commands are either set commands or query commands usually just called commands and queries in this manual Most commands have both a set form and query form The query form of a command is the same as the set form except that the query form ends with a question mark Figure 2 1 shows a flowchart of the structure of the commands and queries The structure of the header is described in detail in Header on page 2 6 Command Q L Head Query eader Q Te Header Mnemonic Command Figure 2 1 Command and query structure flowchart The program can be described using the American Standard Code for Informa tion Interchange ASCII character encoding This seven bit ASCII code is used for the majority of syntactic elements and semantic definitions In special cases an eight bit ASCII Code is allowed in the arbitrary block arguments described on page 2 6 The ASCII code character set table is found in Appendix A DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax Syntactic Delimiters White Space Special Characters DG2030 Programmer Manual Syntactic elements in a program message unit are delimited di
136. onal double quote character ahead of the double quote character in the string For example the string serial number B010000 would be defined as serial number BO10000 Single quotation marks can also be used instead of double quotation marks For instance serial number BO10000 String constants may be of any length up to the memory limits of the instrument in which the message is parsed DG2030 Programmer Manual 2 5 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax Arbitrary Block Header Header Mnemonic Channel Representation Header Structure 2 6 An arbitrary block argument is defined as lt byte count digit gt lt byte count gt lt contiguous eight bit data byte gt or lt contiguous eight bit data byte lt terminator gt where lt byte count digit gt a nonzero digit in the range ASCH 1 9 that defines the number of digits bytes in the lt byte count gt field lt byte count gt any number of digits in the range ASCII 0 9 that define how many bytes are in the lt contiguous 8 bit data byte gt field lt contiguous 8 bit data byte gt a lt byte count gt number of 8 bit bytes in the range ASCII 0 255 that define the message Each byte defines one character lt terminator gt a software LF followed by a hardware EOI For example 16AB4ZLT lt LF gt lt amp E0I gt The header mnemo
137. outines ALL all routines CPU CPU unit check routine DISPlay display unit check routine FPANe front panel control unit check routine CLOCk clock unit check routine TRIGger trigger unit test routine PMEMory pattern memory check routine SMEMory sequence memory check routine and where lt Result gt lt NR1 gt is one of following responses 0 terminated without error 100 detected an error in the CPU unit 200 detected an error in the display unit 300 detected an error in the front panel unit 400 detected an error in the clock unit 500 detected an error in the trigger unit 600 detected an error in the sequence memory 700 detected an error in the pattern memory NOTE The DG2030 Data Generator does not respond to any commands or queries issued during Self Test DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples DiAGnostic RESUIt Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual DIAGNOSTIC might return DIAGNOSTIC SELECT ALL RESULT 0 The DIAGnostic RESUIt query returns the results of self test execution DIAGNOSTIC DIAGnostic SELect DIAGnostic STATe DIAGnostic RESU1t None DIAGNOSTIC RESULT lt Result gt lt Result gt lt Result gt lt NR1 gt where lt NR1 gt is one of following values 0 terminated without error 100 de
138. p Pattern data is output not according to the internal clock but rather by a clock signal created by the STEP key ENHanced Pattern data is output according to the defined sequence DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Responses Examples MODE UPDate Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual MODE STATE REPEAT SINGLE STEP ENHANCED MODE STATE SINGLE sets the run mode to single The MODE UPDate command sets the output pattern update method used when data related to pattern generation is changed The MODE UPDate query returns the output pattern update method used when data related to pattern generation is changed MODE MODE MODE UPDate AUTO MANual MODE UPDate AUTO Pattern output reflects changes each time the data is changed in any way MANual Pattern output is not changed when data is changed until an update forcing command is received MODE UPDATE AUTO MANUAL MODE UPDATE AUTO sets the output pattern update method to AUTO 2 83 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OPC Group Related Commands Syntax Arguments Examples OPT Group Related Commands Syntax Arguments Responses 2 84
139. ptions Examples DISPlay MENU might return DISPLAY MENU NAME SETUP STATE 1 DISPlay MENUJ NAME The DISPlay MENU NAME command selects the menu to be displayed on the screen Group DISPLAY Related Commands DISPlay DISPlay MENU DISPlay MENU NAME Syntax DISPlay MENU NAME SETUp EDIT APPLication UTILity Arguments SETUp displays the setup menu EDIT displays the edit menu APPLication displays the application menu UTILity displays the utility menu Examples DISPLAY MENU NAME UTILITY selects the UTILITY menu DG2030 Programmer Manual 2 59 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DISPlay MENU NAME Group Related Commands Syntax Arguments Responses Examples The DISPlay MENU NAME query returns the type of the selected menu DISPLAY DISPlay DISPlay MENU DISPlay MENU L NAME DISPlay MENU NAME None DISPLAY MENU NAME SETUP EDIT APPLICATION UTILITY DISPlay MENU NAME might return DISPLAY MENU NAME EDIT DISPlay MENU STATe Group Related Commands Syntax Arguments Responses Examples 2 60 The DISPlay MENU STATe command sets whether or not menus are displayed on the screen The DISPlay MENU STATE query returns whether or not menus are displayed on the screen This command is equivalent to the DISPlay ENABle command DISPLAY DISPlay DISPlay ENABle DISPlay
140. query the data update mode OUTPUT Commands Use these commands to set all the settings related to the output channels and clock The lt n gt terms in the header mnemonic are used to specify the channel in these commands Table 2 11 OUTPUT commands Header Description OUTPut Query the settings related to the output channels and clock OUTPut CH lt n gt ASSIGn Set or query channel data bit assignments OUTPut CH lt n gt DELAy Set or query channel delay times OUTPut CH lt n gt DESKew Set or query channel deskew value OUTPut CH lt n gt DESKEew RESET Reset channel deskew value OUTPut CH lt n gt FAL Set or query channel fall time OUTPut CH lt n gt FAL1 RANge Query channel fall time valid range OUTPut CH lt n gt FAL1 VALid Query channel fall time and its validity OUTPut CH lt n gt HIGH Set or query channel high level output voltage OUTPut CH lt n gt INHibit Set or query channel high impedance control method OUTPut CH lt n gt LOW Set or query channel low level output voltage OUTPut CH lt n gt RELEase Clear channel data bit assignments OUTPut CH lt n gt RISe Set or query channel rise time OUTPut CH lt n gt RISe RANge Query cahnnel rise time valid range OUTPut CH lt n gt RISe VALid Query channel rise time and its validity OUTPut CHCLK FAL Set or query clock output fall time OUTPut CHCLK FAL1 RANge Query clock output fall time vakid ran
141. r Manual The TRIGger INTERVal STATe command sets the internal trigger to on or off The TRIGger INTERVal STATe query returns whether the internal trigger is on or off TRIGGER TRIGger INTERVal TRIGger INTERVal TIME TRIGger INTERVal STATe ON OFF 0 1 TRIGger INTERval STATe ON or 1 sets the internal trigger to on OFF or 0 sets the internal trigger to off TRIGGER INTERVAL STATE 1 0 TRIGGER INTERVAL STATE ON sets the internal trigger to on 2 117 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions TRIGger INTERVal TIME 2 Group Related Commands Syntax Arguments Responses Examples TRIGger LEVel Group Related Commands Syntax Arguments 2 118 The TRIGger INTERVal TIME command sets the interval time for the internal trigger The TRIGger INTERVal TIME query returns the interval time for the internal trigger This setting is available even if the trigger source setting is external TRIGGER TRIGger INTERVal TRIGger INTERVal STATe TRIGger INTERVal TIME lt Time gt TRIGger INTERVal TIME lt Time gt lt NR2 gt lt Unit gt where lt Unit gt s ms us ns with a range of 1 0 us to 10 0 s TRIGGER INTERVAL time lt NR3 gt TRIGGER INTERVAL TIME 1US sets the interval time to 1 us The TRIGger LEVel command sets the level on the external trigger
142. r more details refer to Section 3 Status and Events Other CLS DESE ESE ESR EVENT EVQty SRE STB EVMsg None EVMSG might return EVMSG 420 Query UNTERMINATED DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions EVQty Group Related Commands Syntax Arguments Examples FACTory Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual The EVQty query returns the number of events currently in the Event Queue If no event is being queued 0 is returned Other CLS DESE ESE ESR EVMsg EVENT SRE STB EVQty None sEVQty might return EVQTY 5 The FACTory command resets the data generator to its factory default settings and purges all stored settings See Appendix D page D 1 for a list of the factory settings Other RST SECUre FACTory None FACTORY resets the data generator to its factory default settings 2 65 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions HCOPy Group Related Commands Syntax Arguments Responses Examples 2 66 The HCOPy query returns the set image data format and output port for hardcopy output HARDCOPY HCOPy FORMat HCOPy PORT HCOPy None HCOPY FORMAT BMP EPSON EPSMONO THI
143. ram run time error 3 13 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages Table 3 7 lists the internal errors that can occur during operation of the data generator These errors may indicate that the data generator needs repair Table 3 7 Internal device errors DDE Bit 3 Code 300 Description Device specific error 310 311 312 313 314 System error Memory error PUD memory lost Calibration memory lost Save recall memory lost 315 330 350 Configuration memory lost Self test failed Queue overflow does not affect the DDE bit Table 3 8 lists the system event messages These messages are generated when ever certain system conditions occur Table 3 8 System event and query errors Code Description 401 Power on 402 Operation complete 403 User request 404 Power fail 405 Request control 410 Query INTERRUPTED 420 Query UNTERMINATED 430 Query DEADLOCKED 440 Query UNTERMINATED after indefinite response 3 14 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages DG2030 Programmer Manual Table 3 9 lists warning messages that do not interrupt the flow of com mand execution These messages warn you that you may get unexpected results Table 3 9 Warnings EXE Bit 4 Code Description 500 Execution warning Table 3
144. rtisantg com Command Descriptions OUTPut CH lt n gt RiSe RANge Group Related Commands Syntax Arguments Responses Examples The OUTPut CH lt n gt RISe RANge query returns the valid range of the rise time setting for the specified channel OUTPUT OUTPut CH lt n gt RISe OUTPut CH lt n gt RISe VALid OUTPut CH lt n gt RISe RANge lt n gt 0 to 7 None OUTPUT CH lt n gt RISE RANGE lt min gt lt max gt lt min gt lt NR3 gt where lt NR3 gt is the minimum acceptable value lt max gt lt NR3 gt where lt NR3 gt is the maximum acceptable value OUTPUT CHO RISE RANGE might return OQUTPUT CHO RISE RANGE 2 0E 9 7 0E 9 OUTPut CH lt n gt RiSe VALid Group Related Commands Syntax Arguments 2 94 The OUTPut CH lt n gt RISe VALid command returns the rise time setting for the specified cahnnel and wether the setting value is valid or not OUTPUT OUTPut CH lt n gt RISe OUTPut CH lt n gt RISe RANge OUTPut CH lt n gt RISe VALid lt n gt 0 to 7 None DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Responses Examples OUTPUT CH lt n gt RISE VALID lt NR3 gt 0 1 1 valid O invalid OUTPUT CHO RISE VALID might return OUTPUT CHO RISE VALID 1 0E 9 1 OUTPut CHCLK FALI Group Related Commands Syntax Argumen
145. s Then use the left and right arrow buttons to set the error check bit for each character The error bit can be set to None Even or Odd parity Select the Stop Bits item from the Serial menu using the up and down arrow buttons Then use the left and right arrow buttons to select the number of stop bits sent after each character The number of stop bits can be set to either 1 or 2 Select the Handshake item from the Serial menu using the up and down arrow buttons Then use the left and right arrow buttons to select the method of controlling the flow of data between devices The data flow method can be set to Hard DTR CTS Soft XON XOFF and Off no flow control Select the Remote Port item using the up and down arrow buttons and additionally highlight RS232C using the left and right arrow buttons This selects the RS 232 C interface as the remote interface System Reset to Factory GPIB Configure Address Baudrate Data Bits Parity Stop Bits Handshake Power up Pause Serial Security Immediate Date Time Figure 1 9 RS 232 C parameter settings Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started 1 10 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com I ny Command Syntax The DG2030 provides a large set of commands to control the operations and funct
146. se Messages 2 125 Figure 2 4 RS 232 C Retrieving Response Messages 2 125 Figure 3 1 The Standard Event Status SESR 0 3 2 Figure 3 2 The Status Byte Register SBR ece cence 3 3 Figure 3 3 The Device Event Status Enable Register DESER 3 4 Figure 3 4 The Event Status Enable Register ESER 3 4 Figure 3 5 The Service Request Enable Register SRER 3 5 Figure 3 6 Status and event handling process overview 3 7 DG2030 Programmer Manual iii Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Table of Contents List of Tables Table 1 1 GPIB and RS 232 C comparison eeee0 1 2 Table 2 1 BNF symbols and meanings eceeceeceees 2 1 Table 2 2 Decimal Numeric Notation cccceceeeeees 2 4 Table 2 3 Header in query responses x x cee eee ce cece 2 9 Table 2 4 DATA commands ccc s e eee 2 11 Table 2 5 DEBUG Commands ccccececcscecceees 2 12 Table 2 6 DIAGNOSTIC commands eee ee 2 13 Table 2 7 DISPLAY commands cccceccccscscceces 2 13 Table 2 8 HARDCOPY commands ceeeeeeeeeeee 2 14 Table 2 9 MEMORY commands ce cece e ee 2 14 Table 2 10 MODE commands cece eee eee 2 15 Table 2 11 OUTPUT commands e x x eee 2 15 Table 2 12 SOURCE commands
147. sed to string from a second to a third and so on until all devices in the system are connected A star setup is one where one end of all the GPIB cables in the system are attached to one device Refer to Figure 1 3 for these GPIB system configurations DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started a Star Configuration 7 Linear Configuration HIIG Combination of Star and Linear Configurations SY Figure 1 3 GPlb system configurations Restrictions Consider the following restrictions when distributing instruments on the GPIB bus 1 No more than 15 total devices including the controller can be included on a signal bus 2 In order to maintain the electrical characteristics of the bus one device load must be connected for every two meters of cable most often each device represents one device load to the bus 3 The total cable length cumulative must not exceed 66 feet 20 meters 4 Atleast two thirds of the device loads must be powered on 1 4 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started Setting the GPIB To set the GPIB parameters proceed as follows Parameters Press the UTILITY button in the MENU column to the right o
148. sing parameter 110 Command header error 111 Header separator error 112 Program mnemonic too long 113 Undefined header 114 Header suffix out of range 118 Query not allowed 120 Numeric data error 121 Invalid character in number 123 Exponent too large 124 Too many digits 128 Numeric data not allowed 130 Suffix error DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages DG2030 Programmer Manual Table 3 5 Command errors CME Bit 5 Cont Code Description 131 Invalid suffix 134 Suffix too long 138 Suffix not allowed 140 Character data error 141 Invalid character data 144 Character data too long 148 Character data not allowed 150 String data error 151 Invalid string data 152 String data too long 158 String data not allowed 160 Block data error 161 Invalid block data 168 Block data not allowed 170 Expression error 171 Invalid expression 178 Expression data not allowed 180 Macro error 181 Invalid outside macro definition 183 Invalid inside macro definition 184 Macro parameter error Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Messages 3 12 Table 3 6 lists the execution errors that are detected during execution of a command Table 3 6 Execution errors EXE Bit 4 Code Description 200 Exe
149. t errors were detected in the display unit The UNLock command enables all front panel buttons and knob This command is equivalent to the command LOCk NONe Other LOCk UNLOCK ALL ALL enables the front panel buttons and knob UNLOCk ALL enables the front panel buttons and knob 2 121 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions UPTime Group Related Commands Syntax Arguments Examples VERBose Group Related Commands Syntax Arguments Responses 2 122 The UPTIme query returns the time elapsed since the data generator was powered on Other None UPTime None UPTIME 7 016 indicates the instrument has been powered on for 7 016 hours The VERBose command selects the long headers or the short headers to be returned with response messages Longer response headers enhance readability for other programmers shorter response headers provide faster bus transfer speed Other HEADer VERBose ON OFF lt NR1 gt VERBose ON or nonzero value selects long response header OFF or zero value selects short response header Responses are decimal numbers lt NR1 gt and are defined as follows 1 Long header is currently selected 0 Short header is currently selected DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg
150. tected an error in the CPU unit 200 detected an error in the display unit 300 detected an error in the front panel unit 400 detected an error in the clock unit 500 detected an error in the trigger unit 600 detected an error in the sequence memory 700 detected an error in the pattern memory DIAGNOSTIC RESULT might return DIAGNOSTIC RESULT 200 2 53 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DIAGnostic SELect The DIAGnostic SELect command selects the self test routine The DIAGnos tic SELect query returns the currently selected routine The DIAGnos tic STATe command executes the routine Group DIAGNOSTIC Related Commands DI AGnostic STATe DIAGnostic RESULt Syntax DIAGnostic SELect ALL CPU DISPlay FPANel CLOCk TRIGger SMEMory PMEMory DIAGnostic SELect Arguments ALL checks all routines that follow CPU checks the CPU unit DISPlay checks the display unit FPANe checks the front panel control unit CLOCk checks the clock unit TRIGger checks the trigger unit SMEMory checks the sequence memory PMEMory checks the pattern memory Examples DIAGNOSTIC SELECT CPU STATE EXECUTE executes the CPU self test routine DIAGnostic STATe The DIAGnostic STATe command executes the self test routine s selected with the DIAGnostic SELect command If an error is detected during execution the routine that detected the error termi
151. that the power on status clear flag is currently set to FALSE 2 103 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions RST Group Related Commands Syntax Arguments Examples RUNNing Group Related Commands Syntax Arguments Responses Examples 2 104 The RST common command resets this data generator to the default state default values are listed in Appendix D Other FACTory SECUre RST None RST resets the instrument The RUNNing query returns status that indicates whether or not pattern data or a sequence is being output Other STARt STOP RUNNing None 1 pattern data or a sequence is being output 0 nothing is being output RUNNING might return RUNNING 1 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions SOURce EVENT ENABle Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The SOURce EVENT ENAB1e command enables or disables the EVENT input The SOURce EVENT ENAB1e query returns whether or not the EVENT input is enabled SOURCE None SOURCe EVENT ENABle ON OFF 1 0 SOURCe EVENT ENAB1e ON or 1 enables the EVENT input OFF or 0 disables the EVENT input SOURCE EVENT ENABLE 1 0 SOURCE EVE
152. the repeat count of a sequence step DATA SEQuence TWAIT Set or query the trigger wait on off state DATA SUBSequence ADD Add a sub sequence step DATA SEBSequence CLEAr Delete all sub sequence definitions DATA SUBSequence DEFine Set or query the sub sequence definitions DATA SUBSequence DELete Delete a sub sequence step DATA SUBSequence DELete ALL Delete a sub sequence definition DATA SUBSequence REPeat Set or query the repeat count of a sub se quence step DATA UPDate Forcibly update the pattern and other data DEBUG Commands Table 2 5 DEBUG Commands Header DEBug DEBug SNOop Use these commands to set all settings for debugging Description Query all settings for debugging Query all settings for debugging DEBug SNOop DELAy DEBug SNOop DELAy TIME DEBug SNOop STATe Query delay time for debugging Set or query delay time for debugging Turn on or off for debugging DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Groups DIAGNOSTIC Commands classified by function Table 2 6 DIAGNOSTIC commands Header DIAGnostic Use these commands to select and execute the self test routines which are Description Query all current settings related to self test DIAGnostic RESU1t DIAGnostic SELect DIAGnostic STATe Query self test result Set or query self test routine
153. ting state Go To Local GTL Causes the listen addressed device to switch from remote to local front panel control m Select Device Clear SDC Clears or initializes all listen addressed devices R Group Execute Trigger GET Triggers all applicable devices and causes them to initiate their programmed actions m Take Control TCT Allows controller in charge to pass control of the bus to another controller on the bus R Parallel Poll Configure PPC Causes the listen addressed device to respond to the secondary commands Parallel Poll Enable PPE and Parallel Poll Disable PPD which are placed on the bus following the PPC command PPE enables a device with parallel poll capability to respond on a particular data line PPD disables the device from responding to the parallel poll DG2030 Programmer Manual C 3 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Appendix C Interface Specification C 4 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com DG2030 Programmer Manual E Appendix D Factory Initialization Settings The following table lists the commands affected by a factory initialization and their factory initialization settings Table D 1 Factory initialized settings Header Default settings DATA commands DATA MSIZe 1000 DEBUG commands DEBug S
154. trigger signal source The TRIGger SOURCe query returns curently selected trigger signal source TRIGGER TRIGger IMPedance TRIGger LEVel TRIGger SLOPe TRIGger SOURce EXTernal INTernal TRIGger SOURce EXTernal selects external trigger INTernal selects internal trigger TRIGGER SOURCE EXTERNAL selects external trigger The TST common query performs the self test and returns the results If an error is detected during self test execution stop immediately This command takes up to 90 seconds to run the self test and the data generator will not respond to any commands and queries while it runs Other DIAGnostic RESUI1t DIAGnostic SELect DIAGnostic STATe TST None DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Responses Examples UNLock Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual lt Resul t gt where lt Result gt lt NR1 gt and lt NR1 gt is one of following arguments 0 Terminated without error 100 Detected an error in the CPU unit 200 Detected an error in the display unit 300 Detected an error in the front panel unit 400 Detected an error in the clock unit 500 Detected an error in the trigger unit 600 Detected an error in the sequence memory 700 Detected an error in the pattern memory TST might return 200 to indicate tha
155. tronic Industries Association EIA provides a common basis of serial communication between devices that exchange data This interface has long been used on terminals modems printers and other devices The RS 232 C interface that the data generator provides also uses most of the same codes formats protocols and common commands as are used with the GPIB interface ANSI IEEE Std 488 2 1987 Your system hardware may let you choose which interface to use with your system if so you should consider the advantages and disadvantages of each interface For example the GPIB interface is an eight bit parallel bus and therefore it offers high speed data transfers and multiple instrument control In contrast the RS 232 C interface is a slower serial data bus for single instrument control but it is easy to connect to and can be used with a low cost controller Table 1 1 compares the GPIB and RS 232 C interface Table 1 1 GPIB and RS 232 C comparison Operating attribute GPIB RS 232 C Cable ANSI IEEE Std 488 9 wire DCE Data flow control Hardware 3 wire handshake Flagging soft XON XOFF hard DTR CTS Data format 8 bit parallel 8 bit serial Interface control Operator low level control None message Interface messages Most ANSI IEEE Std 488 Device clear via ASCII break signal Interrupts reported Service requests Status and event code status and event code no service requests Message termination Hardware EOI software LF or Sof
156. ts Responses Examples DG2030 Programmer Manual The OUTPut CHCLK FAL command sets the fall time for the clock output The OUTPut CHCLK FAL1 query returns fall time setting for the clock output If FAST or 0 is used in the argument the fall time become as fast as possible OUTPUT OUTPut CHCLK FAL1 RANge OUTPut CHCLK FAL1 VALid OUTPut CHCLK FAL lt Time gt OUTPut CHCLK FAL1 lt Time gt lt NR2 gt lt Unit gt FAST lt Unit gt s ms us ns OUTPUT CHCLK FALL lt NR3 gt OUTPUT CHCLK FALL ins sets the fall time for the clock output to Ins 2 95 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CHCLK FALI RANge Group Related Commands Syntax Arguments Responses Examples The OUTPut CHCLK FAL1 RANge query returns the valid range of the fall time setting for the clock output OUTPUT OUTPut CHCLK FAL1 OUTPut CHCLK FAL1 VALid OUTPut CHCLK FAL1 RANge None L OUTPUT CHCLK FALL RANGE lt min gt lt max gt lt min gt lt NR3 gt where lt NR3 gt is the minimum acceptable value lt max gt lt NR3 gt where lt NR3 gt is the maximum acceptable value OUTPUT CHCLK FALL RANGE might return OQUTPUT CHCLK FALL RANGE 2 0E 9 7 0E 9 OUTPut CHCLK FALI VALid Group Related Commands Syntax Arguments Responses 2 96 The OUTPut CHCLK FAL1 VALid command re
157. turns the fall time setting for the specified cahnnel and wether the setting value is valid or not OUTPUT OUTPut CHCLK FAL1 OUTPut CHCLK FAL1 RANge OUTPut CHCLK FAL1 VALid None L OUTPUT CHCLK FALL VALID lt NR3 gt 0 1 1 valid O invalid DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Examples OUTPUT CHCLK FALL VALID might return OUTPUT CHCLK FALL VALID 1 0E 9 1 OUTPut CHCLK HIGH Group Related Commands Syntax Arguments Responses Examples DG2030 Programmer Manual The OUTPut CHCLK HIGH command sets the high level output voltage for the clock output The OUTPut CHCLK HIGH query returns the high level output voltage setting for the clock output OUTPUT OUTPut CHCLK LOW OUTPut CHCLK HIGH lt Volt gt OUTPut CHCLK HIGH lt Volt gt lt NR2 gt lt Unit gt where lt NR2 gt combined with lt Unit gt specifies a high level voltage and lt Unit gt V mV for volt or millivolt OUTPUT CHCLK HIGH lt NR2 gt OUTPUT CHCLK HIGH 1V sets the high level output voltage for the clock output to 1 V 2 97 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CHCLK LOW Group Related Commands Syntax Arguments Responses Examples The OUTPut CHCLK LO
158. tware CR LF or CR and Receive both LF Message termination Hardware EOI and software Software LF Transmit LF Timing Asynchronous Asynchronous Transmission path length lt 2 meters between devices lt 15 meters lt 20 meters total cabling for GPIB system Speed 200 Kbytes sec 19 200 bits sec System environment Multiple devices lt 15 Single terminal point to point connection DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started Installing for GPIB Communication With the power off connect a GPIB cable from the GPIB controller to the ANSI IEEE Std 488 port GPIB connector on the rear panel of the data generator see Figure 1 2 For example when using an MS DOS compatible controller connect the GPIB cable between the National Instrument PC2A GPIB board and the data generator GPIB connector IO OQ S IEEE STD 488 PORT GPIB Connector gt 00 L 7 RS 232 C C output AUX OUTPUT EVENT N CHS Figure 1 2 GPIB connector Instruments can be connected to the GPIB in linear or star configurations or in a combination of both configurations A linear hookup is one where a GPIB cable is used to string one device to a second and then another GPIB cable is u
159. ut 10 minutes the screen brightness is lowered automatically DISPLAY DISPlay DISPlay DIMmer ON OFF 1 0 DISPlay DIMmer ON or 1 enables the dimmer function OFF or 0 clears the dimmer function DISPLAY DIMMER 1 0 DISPLAY DIMMER ON turns the dimmer function on 2 57 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DISPlay ENABle 2 Group Related Commands Syntax Arguments Responses Examples DISPlay MENU Group Related Commands Syntax Arguments Responses 2 58 The DISPlay ENAB1e command turns the display on or off When security is turned on once the display is set to off it cannot be turned on again The DISPlay ENAB1e query returns the on off state of the display DISPLAY DISPlay DISPlay MENU STATe DISPlay ENABle ON OFF 1 0 DISPlay ENABle ON or 1 turns the display on OFF or 0 turns the display off DISPLAY ENABLE 1 0 DISPLAY ENABLE OFF turns the display off The DISPlay MENU query returns the type and display state of the selected menu DISPLAY DISPlay DISPlay MENU NAME DISPlay MENU NAME DISPlay MENU None DISPLAY MENU NAME SETUP EDIT APPLICATION UTIL ITY STATE 1 0 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descri
160. vent Status Enable Register used in the status and event reporting system of the data generator The DESE query returns the contents of the DESER Refer to Section 3 Status and Events for more information about DESE The power on default for the DESER is to set all bits to 1 if the power on status flag is TRUE If this flag is set to FALSE the DESER maintains its current value through a power cycle Other CLS ESE ESR EVENT EVMsg EVQty SRE STB DESE lt Bit Value gt DESE lt Bit Value gt lt NRI1 gt where lt NR1 gt is a decimal integer which must range from 0 to 255 that sets the DESER bits to its binary equivalent DESE 177 sets the DESER to 177 binary 10110001 which sets the PON CME EXE and OPC bits DESE might return DESE 176 which indicates that the DESER contains the binary number 10110000 2 51 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions DIAGnostic Group Related Commands Syntax Arguments Responses 2 52 The DIAGnostic query returns the selected self test routine s runs the routine and returns the results DIAGNOSTIC DIAGnostic SELect DIAGnostic STATe DIAGnostic RESU1t DIAGnostic None DIAGNOSTIC SELECT lt Self test Routine gt RESULT lt Result gt lt Re sult gt lt Self test Routine gt lt label gt where lt abe1 gt is one of following r
161. w RESET OUTPut CH lt n gt DESKew lt Time gt OUTPut CH lt n gt DESKew lt n gt 0 to 7 lt Time gt lt NR2 gt lt Unit gt where lt NR2 gt combined with lt unit gt specifies a time and lt unit gt s ms us ns for seconds milliseconds microseconds or nanoseconds OUTPUT CH lt n gt DES KEW lt NR3 gt OUTPut CH1 DESKEW 2 ns sets the deskew value for channel 1 to 2 ns 2 87 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions OUTPut CH lt n gt DESKew RESET Group Related Commands Syntax Arguments Examples The OUTPut CH lt n gt DESKew RESET command resets the deskew value for the specified channel OUTPUT OUTPut CH lt n gt DESKew OUTPut CH lt n gt DESKew RESET lt n gt 0 to 7 None OUTPUT CH2 DESKEW RESET resets the deskew value for channel 2 OUTPut CH lt n gt FALI Group Related Commands Syntax Arguments Responses Examples 2 88 The OUTPut CH lt n gt FAL1 command sets the fall time for the specififd channel The OUTPut CH lt n gt FAL1 query returns fall time setting for the specified channel If FAST or 0 is used in the argument the fall time become as fast as possible OUTPUT OUTPut CH lt n gt FAL1 RANge OUTPut CH lt n gt FAL1 VALid OUTPut CH lt n gt FAL lt Time gt OUTPut CH lt n gt FAL1 lt n gt 0 to 7 lt T
162. w artisantg com
163. w artisantg com Getting Started Installing for RS 232 C Communication 1 6 Connect an RS 232 C cable from the computer terminal to the RS 232 C connector on the rear panel of the data generator Use a configuration based on the settings for the data flow control flagging The RS 232 C provides a point to point connected communication interface between two devices see Figure 1 5 The data generator can transmit and receive the same message serially over the RS 232 C interface as it can in parallel over the GPIB interface Controller DG2030 ES lo elelelefefe A 9 Z Z Figure 1 5 RS 232 C point to point connection Several connectors are used with the RS 232 C interface a DTE device uses a standard 25 pin male D type shell connector a DCE device uses a standard 25 pin female D type shell connector Some recent computers implement the RS 232 C interface using 9 pin D type connector This data generator uses a standard 9 pin D type shell connector provided on the rear panel see Figure 1 6 along with a 9 pin male to 25 pin male conversion cable Figure 1 7 on page 1 8 shows both 9 pin and 25 pin connectors with their pin number assignments DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Getting Started
164. ways begins with a colon DATA GROUP MSIZE PATTERN SEQUENCE UPDATE caa a a a a a 2 8 DEFINE DELETE DEFINE WORD ADD DEFINE DELETE The following example of a compound command combines three headers delimited by semicolons DATA BLOCK ADD 512 BLOCK3 DATA BLOCK DELETE BLOCK2 DATA BLOCK SIZE BLOCK1 512 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax You must include the complete path in each header when there is no common complete path to the start of the tree structure the colon However note that part of each header in the above example has a common path DATA BLOCK You may shorten compound command structures with such headers For example the command above may be rewritten as follows DATA BLOCK ADD 512 BLOCK3 DELETE BLOCK2 SIZE BLOCK1 512 Note that the mnemonics DATA and BLOCK are assumed from the first header by the headers that follow The following command descriptions are valid examples of commands shortened using the principle just described Note that the insertion of common command SRE between headers does not prevent the headers that follow from assuming the earlier header mnemonics DATA BLOCK ADD 512 BLOCK3 DELETE BLOCK2 DATA GROUP DELETE GROUP4 DATA MSIZE 16384 BLOCK ADD 512 BLOCK3 DELETE BLOCK2 DATA BLOCK ADD 512 BLOCK3 SRE DELETE BL
165. when using the command in a program However if you use the query DESE the data generator will respond in the format lt NR1 gt to match the command description in this manual If the decimal numeric argument refers to a voltage or frequency you can express it using SI units instead of in the scaled explicit point input value format lt NR3 gt SI units are units that conform to the Systeme International d Unites standard For example you can use the input format 200 mV or 1 0 MHz instead of 200 0E 3 or 1 0E 6 respectively to specify voltage or frequency DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Syntax You can omit the unit but you must include the SI unit prefix You can use either upper or lowercase units V or v for voltage Hz HZ or hz for frequency The SI prefixes which must be included are shown below Note that either lower or upper case prefixes can be used 106 Corresponding Power 10 3 108 1 Note that the prefix m M indicates 10 3 when the decimal numeric argument denotes voltage but 10 when it denotes frequency String String sometimes referred to as a string literal a literal or just a string is defined as a series of characters enclosed by double quotation marks as in This is a string constant or O 127 To include a double quoted character in the string insert an additi
166. ww artisantg com Appendix B Reserved Words B 2 DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com SSS ES SE Appendix C Interface Specification Interface Functions DG2030 Programmer Manual This appendix lists and describes the GPIB functions and messages that the DG2030 Data Generator implements Table C 1 shows which GPIB interface functions are implemented in this instrument Following the table is a brief description of each function Table C 1 GPIB interface function implementation Interface function subset Capability Acceptor Handshake AH AH1 Complete Source Handshake SH SH1 Complete Listener L L4 Basic Listener Unaddress if my talk address MTA No talk only mode Talker T T5 Basic Talker Serial Poll a Unaddress if my listen address MLA Device Clear DC DC Complete Remote Local RL RL1 Complete Service Request SR SR1 Complete Parallel Poll PP PPO None Device Trigger DT DT Complete Controller C CU None Electrical Interface E2 Three state driver R Accepter Handshake AH Allows a listening device to help coordinate the the proper reception of data The AH function holds off initiation or termination of a data transfer until the listening device is ready to receive the next data byte R Source Handshake SH Allows a talking device to help coordinate the proper transfer of data Th
167. y area using the DISPlay WINDow TEXT CLEar command DISPLAY DISPlay DISPlay WINDow TEXT CLEar DISPlay WINDow TEXT DATA lt Message gt DISPlay WINDow TEXT DATA 7 lt Message gt lt string gt where lt string gt is a message character string DISPLAY WINDOW TEXT DATA lt Message gt DISPLAY WINDOW TEXT DATA ABCD sends the text ABCD to be displayed in the message display area The ESE common command sets the bits of the ESER Event Status Enable Register used in the status and events reporting system of the data generator The ESE query returns the contents of the ESER Refer to Section 3 Status and Events for more information about the ESER If the power on status flag is TRUE the power on default for the ESER is to reset all bits to zero If this flag is set to FALSE the ESER bits do not change value during the power on cycle Other DG2030 Programmer Manual Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions Related Commands Syntax Arguments Examples ESR Group Related Commands Syntax Arguments Examples DG2030 Programmer Manual CLS DESE ESR EVENT EVMsg EVQty SRE STB ESE lt Bit Value gt ESE lt Bit Value gt lt NRI1 gt where lt NR1 gt is a decimal integer that ranges from 0 to 255 The ESER bits will be set to the binary equivalent of the de
168. y state to on 2 113 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com Command Descriptions SYSTem TIME 2 Group Related Commands Syntax Arguments Responses Examples TRG Group Related Commands Syntax Arguments Examples 2 114 Artisan Technology Group Quality Instrumentation Guaranteed 888 88 SOURCE www artisantg com The SYSTem TIME command sets the internal clock time The SYSTem TIME query returns the internal clock time SYSTEM SYSTem DATE SYSTem TIME lt Hour gt lt Minute gt lt Second gt SYSTem TIME lt Hour gt the hours lt Minute gt the minutes lt Second gt the seconds SYSTEM TIME lt Hour gt lt Minute gt lt Second gt SYSTEM TIME 11 23 58 sets the time The TRG common command generates trigger event Other RUNNing STARt STOP TRG None TRG generates trigger event DG2030 Programmer Manual Command Descriptions TRIGger The TRIGger query returns all of the currently specified settings related to the trigger function Group TRIGGER Related Commands TRIGger IMPedance TRIGger LEVel TRIGger SLOPe Syntax TRIGger Arguments None Responses TRIGGER IMPEDANCE HIGH LOW LEVEL lt NR2 gt SLOPE POSITIVE NEGATIVE SOURCE EXTERNAL INTERNAL INTERVAL TIME lt Time gt STATE 1 0 Examples TRIGGER might returns TRIGGER

Artisan Technology Group is your source for quality new and

Contents

Download Pdf Manuals

Related Search

Related Contents