Agilent Technologies 1670G

Part 6 Part 6, chapter 43, contains program examples of actual tasks

that show you how to get started in programming the Agilent

1670G-series logic analyzers. The complexity of your programs and the

tasks they accomplish are limited only by your imagination. These

examples are written in HP Basic 6.2; however, the program concepts

can be used in any other popular programming language that allows

communications over GPIB or RS-232 buses.

Contents

Main Page Page Page Page Page Page Page Table of Contents 3 Programming Over RS-232-C 4 Programming and Documentation Conventions 5 Message Communication and System Functions 6 Status Reporting 7 Error Messages Part 2 Instrument Commands 8 Common Commands 9 Instrument Commands 10 Module Level Commands 11 SYSTem Subsystem 12 MMEMory Subsystem Part 3 Logic Analyzer Commands 13 MACHine Subsystem 14 WLISt Subsystem 15 SFORmat Subsystem 16 STRigger (STRace) Subsystem 17 SLISt Subsystem 18 SWAVeform Subsystem 19 SCHart Subsystem 20 COMPare Subsystem 21 TFORmat Subsystem 22 TTRigger (TTRace) Subsystem 23 TWAVeform Subsystem 24 TLISt Subsystem 25 SPA Subsystem 26 SYMBol Subsystem 27 DATA and SETup Commands Introduction 272 Part 4 Oscilloscope Commands 28 Oscilloscope Root Level Commands 29 ACQuire Subsystem 30 CHANnel Subsystem 31 DISPlay Subsystem 32 MARKer Subsystem 33 MEASure Subsystem 34 TIMebase Subsystem 35 TRIGger Subsystem 36 WAVeform Subsystem Part 5 Pattern Generator Commands 37 Programming the Pattern Generator Programming Overview 373 Page Page Page Page Page Talking to the Instrument Initialization Instruction Syntax Output Command Device Address Instructions Instruction Terminator Header Types Duplicate Keywords the state listing. the timing waveforms. Query Usage Program Header Options Parameter Data Types Page Selecting Multiple Subsystems Receiving Information from the Instrument Response Header Options Response Data Formats String Variables Numeric Base Numeric Variables Definite-Length Block Response Data Multiple Queries Page Page Page Interface Capabilities Command and Data Concepts Addressing Communicating Over the GPIB Bus (HP 9000 Series 200/300 Controller) Local, Remote, and Local Lockout Bus Commands Page Page Interface Operation RS-232-C Cables Minimum Three-Wire Interface with Software Protocol Extended Interface with Hardware Handshake Cable Examples Page Configuring the Logic Analyzer Interface Interface Capabilities RS-232-C Bus Addressing Lockout Command Page Page Page Truncation Rule Infinity Representation Sequential and Overlapped Commands Response Generation Syntax Diagrams Notation Conventions and Definitions The Command Tree Tree Traversal Rules Page Page Page Table 4-2 Alphabetic Command Cross-Reference Programming and Documentation Conventions Tree Traversal Rules 410 Table 4-2 (continued) Alphabetic Command Cross-Reference Programming and Documentation Conventions Tree Traversal Rules 411 Command Set Organization Subsystems Program Examples Page Page Page Protocols Page Syntax Diagrams Page Syntax Overview Page Page Page Page Page Page Event Status Register Service Request Enable Register Bit Definitions Page Key Features Page Page Page Page Device Dependent Errors Command Errors Execution Errors Internal Errors Query Errors Page Page Page Page *CLS *ESE *ESR *IDN *IST *OPC *OPT Page Page *CLS (Clear Status) *ESE (Event Status Enable) *ESR (Event Status Register) Page *IDN (Identification Number) *IST (Individual Status) Page *OPC (Operation Complete) *OPT (Option Identification) *PRE (Parallel Poll Enable Register Enable) *RST (Reset) *SRE (Service Request Enable) *STB (Status Byte) *TRG (Trigger) *TST (Test) *WAI (Wait) Page Page Page Page Page Table 9-1 Mainframe Parameter Values Instrument Commands 95 BEEPer CAPability CARDcage CESE (Combined Event Status Enable) CESR (Combined Event Status Register) EOI (End Or Identify) LER (LCL Event Register) LOCKout MENU Page MESE<N> (Module Event Status Enable) Page MESR<N> (Module Event Status Register) Page RMODe RTC (Real-time Clock) <second>|DEFault} SELect Page SETColor STARt STOP XWINdow :XWINdow {O N|1}[,<displ ay name>] Page Page Page Page Table 10-1 Module Level Parameter Values Module Level Commands 104 ARMLine DBLock MACHine WLISt Page Page Page Page DSP (Display) ERRor HEADer LONGform PRINt SETup Page Page Page Page Page Page Table 12-1 MMEMory Parameter Values MMEMory Subsystem 126 AUToload CATalog CD (Change Directory) COPY DOWNload <type>,<block_data> Page INITialize LOAD[:CONFig] LOAD:IASSembler [,<module>] MKDir (Make Directory) MSI (Mass Storage Is) PACK PURGe PWD (Present Working Directory) REName STORe[:CONFig] <description>[,<module>] UPLoad VOLume Page Page Page Page Page MACHine ARM ASSign LEVelarm NAME REName DEFault} RESource TYPE Page Page Page WLISt (Waveforms/LISting) Page [,{<bit_id>|OVERlay|ALL}] Page Page Page Page Page Page Page Page Table 15-1 SFORmat Subsystem Parameter Values SFORmat Subsystem 155 SFORmat CLOCk Page Page MASTer <clock_id>,<clock_spec> MOPQual <clock_pair_id>,<qual_operation> MQUal <qual_num>,<clock_id>,<qual_level> REMove SETHold <pod_num>,<set_hold_value> Page SLAVe <clock_id>,<clock_spec> SOPQual <clock_pair_id>,<qual_operation> SQUal THReshold Page Page Page Page Page Page Page Table 16-1 STRigger Subsystem Parameter Values STRigger (STRace) Subsystem 166 Qualifier STRigger (STRace) (State Trigger) ACQuisition {AUTOmatic|MANual} BRANch <branch_qualifier>,<to_level_number> Page {All|SEQuence|RESource} <proceed_qualifier>,<occurrence> Page <label_name>,<start_pattern>,<stop_pattern> SEQuence <number_of_levels>,<level_of_trigger> STORe TAG {OFF|TIME| TAKenbranch TCONtrol {OFF|STARt|PAUSe|CONTinue} TERM <term_id>,<label_name>,<pattern> <term_id>,<label_name> TIMER {STARt|CENT er |END| POSTstor e, <poststore Page Page Page Page Page Page Page SLISt COLumn <col_num>[,<module_num>, MACHine{1|2}], <label_name>,<base> Page <line_number>,<label_name> Page Page Page Page OTAG {<time_value>|<state_value>} OVERlay <col_num>,<module_num>,MACHine{1|2},<label_name> REMove Page Page XOTag XOTime Page Page XTAG {<time_value>|<state_value>} Page Page Page SWAVeform Page Page CLRStat <bit_id> Page TAKenbranch {STARt|CENTer|END|POSTstore,<percent>} Page Page Page SCHart HAXis VAXis <label_name>,<low_value>,<high_value> Page Page Page Page Page COMPare CMASk <label_name>,<care__spec> COPY {<label_name>,<line_num>,<data_pattern>| <line_num>,<data_pattern>[, <data_pattern>]... } Page <difference_occurrence> MENU PARTial,<start_line>,<stop_line>} GT,<value> | IN Ra nge,<value>, <value> | OUTRange,<value>,<value> | EQUal | NEQual} SET Page Page Page TFORmat (Timing Format) ACQMode Page Page THReshold {TTL|ECL|<value>} Page Page Page Page Table 22-1 TTRigger Parameter Values TTRigger (TTRace) Subsystem 225 Qualifier Page TTRigger (TTRace)(Trace Trigger) ACQuisition BRANch Page Page {All|SEQuence|RESource} EDGE <edge_spec> <time_qualifier>,<condition_mode> Page <label_name>,<start_pattern>,<stop_pattern> SEQuence SPERiod TCONtrol (Timer Control) {OFF|STARt|PAUSe|CONTinue} TERM <term_id>,<label_name>,<pattern> <term_id>,<label_name> TIMER TPOSition (Trigger Position) {STARt|CENTer|END|DELay,<time_val> | POSTstore,<poststore>} Page Page Page Page Page Table 23-1 TWAVeform Parameter Values TWAVeform Subsystem 236 TWAVeform ACCumulate Page CLRStat DELay [<module_spec>,]<label_name> [,{<bit_id>|OVERlay|ALL}] Page OCONdition Page <occurrence>,<origin> Page Page SPERiod TAVerage {STARt|CENTer|END|DELay, <time_val>| POSTstore,<percent>} Page XCONdition {ENTering|EXITing} XOTime Page Page Page Page Page Page Page Page Table 24-1 TLISt Parameter Values TLISt Subsystem 246 TLISt COLumn <col_num>[,<module_num>,MACHine{1|2}],<label_name>, <base> Page <line_number>,<label_name> Page OCONdition Page Page OSTate OTAG Page Page XCONdition XOTag Page Page XSTate XTAG Page Page Page Page Page Page Table 25-1 SPA Subsystem Parameter Values SPA Subsystem 256 Page OVERView:BUCKet {SIZE|NUMBer|<bucket_num>} OVERView:HIGH OVERView:LABel OVERView:LOW OVERView:MLENgth OVERView:OMARker OVERView:OVSTatistic {XHITs|OHITs|TOTal} OVERView:XMARker HISTogram:HSTatistic {TOTal|OTHer|<range_number>} HISTogram:LABel HISTogram:OTHer HISTogram:QUALifier <pattern> HISTogram:RANGe <range_num>,<range_name>,<low_patt>,<high_patt>} HISTogram:TTYPe TINTerval:AUTorange {LOGarithmic|LINear},<min_time>,<max_time> TINTerval:QUALifier <label_name>,<start_pattern>,<end_pattern> Page TINTerval:TINTerval <interval_number>,<min_time>,<max_time> TINTerval:TSTatistic {TMINimum|TMAXimum|TAVerage|TOTal|TTOTal| <interval_number>} Page Page Page Page Table 26-1 SYMBol Parameter Values SYMBol Subsystem 264 SYMBol BASE <label_name>,<base_value> PATTern <symbol_name>,<pattern_value> <symbol_name>,<start_value>,<stop_value> REMove WIDTh <width_value> Page Introduction Data Format SYSTem:DATA Page Section Header Description Section Data Data Preamble Description Page Page Page Acquisition Data Description . . Tag Data Description SYSTem:SETup Page Page Page Page Page Page AUToscale Page DIGitize Page Page Page Page COUNt TYPE Page Page Page Page COUPling ECL OFFSet PROBe Page TTL Page Page Page Page Page CONNect Page Page MINus OVERlay PLUS Page Page Page Page Page Page AVOLt ABVolt? BVOLt MSTats OAUTo <slope>,<occurrence>} Page Page SHOW TAVerage? TMAXimum? TMINimum? TMODe VMODe VOTime? VRUNs? VXTime? XAUTo <slope>,<occurrence>} XOTime? Page Page Page Page ALL? FALLtime? FREQuency? NWIDth? OVERshoot? PERiod? PREShoot? PWIDth? RISetime? Page VAMPlitude? VBASe? VMAX? VMIN? VPP? VTOP? Page Page Page Page Page Page Page Page Page Page CONDition GT,<time>|LT,<time>|RANGe,<time>,<time>} Page Page LEVel Page LOGic {HIGH|LOW|DONTcare} Page PATH SLOPe {POSitive|NEGative} Page Page Page COUNt DATA FORMat POINts PREamble RECord SOURce SPERiod Format for Data Transfer Page Data Conversion Page Page COUNt? DATA? FORMat POINts? PREamble? RECord SPERiod? TYPE? VALid? XINCrement? XORigin? XREFerence? YINCrement? YORigin? YREFerence? Page Page Page Programming the Pattern Generator Programming Overview This section introduces you to the basic command structure used to program the pattern generator. Example Pattern Generator Program Selecting the Pattern Generator :SELect 2 Command Set Organization Page Page STEP 20 OUTPUT XXX;":STEP" Page RESume Page FORMat Subsystem CLOCk :FORMat:CLOC k EXTernal,{LEFi fty|GTFifty|GTONe} [:FORMat:CLO Ck] EXTernal,{LE Fifty|GTFifty|GTONe} Page assignment>, .... <channel assignment> assignment>, .... <channel assignment><NL> Page Page Page Page SEQuence Subsystem 393 Page EPATtern Page Page WAIT,<event>|SIGNal|REPeat,<count>|BREAK| MACRo<#>},<data_value>,<data_value>,... PROGram Page Page Page line range>]| AL L>} Page MACRo Subsystem Page MACRo Subsystem 404 Page Page WAIT,<event> | SIGNal | REPeat,<count> | BREAK } ,<data_value>,<data_value>,... NAME PARameter PROGram Page Page number>[,<program line number>]|ALL|MACRo} Page Page Page SYMBol Subsystem 413 BASE PATTern <start_value>,<stop_value> Page WIDTh Page Data and Setup Commands <block length specifier><section 1>...<section N> Page SYSTem:DATA SYSTem:SETup Page Page Page Page Page Making a Timing Analyzer Measurement 433 Making a Timing Analyzer Measurement 434 Making a State Analyzer Measurement Making a State Analyzer Measurement 436 Making a State Analyzer Measurement 437 Page Making a State Compare Measurement 4310 4311 4312 4313 Transferring the Logic Analyzer Configuration Transferring the Logic Analyzer Configuration 4315 Transferring the Logic Analyzer Configuration 4316 Checking for Measurement Completion Sending Queries to the Logic Analyzer Page Page Index Index1 Index2 Index3 Index4 Index5 Index6