VIAVI Instrument Programming Tool (VIP Tool™) User Guide Contents Introduction to the VIP Tool ............................................................................................... 1 Overview ........................................................................................................................... 1 Intended User .................................................................................................................... 1 System Requirements ....................................................................................................... 1 Installing VIP Tool ............................................................................................................... 2 A Sample VIP Tool Directory Structure .............................................................................. 2 Enabling the VIP Tool ........................................................................................................ 2 Establishing an Ethernet Connection to the Instrument .................................................. 4 Connection Types ............................................................................................................. 4 Direct Connection ............................................................................................................................ 4 Network Connection ........................................................................................................................ 4 Configuring the Instrument’s Network Connection ............................................................. 5 Configuring the 8800 Series Connection ........................................................................................ 5 Configuring the 3550 Series Connection ........................................................................................ 6 Configuring the 3900 Series Connection ........................................................................................ 6 Setting up the Computer for Static IP Connection .......................................................................... 8 Testing the Connection ................................................................................................................... 9 The VIP Tool Workbook .................................................................................................... 10 The VIP Tool Ribbon ....................................................................................................... 10 The Getting Started Sheet ............................................................................................... 10 The Getting Started Sheet Ribbon ................................................................................................ 10 The Setup Sheet ............................................................................................................. 11 Setup Sheet Fields ........................................................................................................................ 12 The Setup Sheet Ribbon ............................................................................................................... 14 The Script Sheet .............................................................................................................. 17 The Script ...................................................................................................................................... 17 The Script Sheet Ribbon ............................................................................................................... 19 Script Sheet Ribbon Script Operations Group .............................................................................. 21 Script Sheet Ribbon Script Debug Group ..................................................................................... 22 The Trace Data Sheet ..................................................................................................... 29 The Trace Data Sheet Ribbon ...................................................................................................... 30 The Results Data Sheet .................................................................................................. 32 i Contents The Results Data Sheet Ribbon.................................................................................................... 33 Report Sheets ................................................................................................................. 35 Report Sheet Rules ....................................................................................................................... 36 Tags .............................................................................................................................................. 36 Saving Report Sheets ................................................................................................................... 36 The Report Sheet Ribbon ............................................................................................................. 36 The Version Sheet ........................................................................................................... 42 The Version Sheet Ribbon ............................................................................................................ 42 VIP Tool Programming Language Reference .................................................................. 43 Variables, Tags, and Cell Assignments ........................................................................... 44 Variables ....................................................................................................................................... 44 Tags ................................................................................................................................ 50 Working with Tags ......................................................................................................................... 50 Rules of Tag Use .......................................................................................................................... 53 Considerations for Assigning Values to Tags ............................................................................... 53 Tag Syntax .................................................................................................................................... 55 Creating Tag Arrays ...................................................................................................................... 58 Math Functions ................................................................................................................ 69 Math Function Command Column Syntax .................................................................................... 69 Math Function Argument Column Syntax ..................................................................................... 70 Using Math Functions to Generate Arguments ............................................................................. 71 Concatenation ................................................................................................................. 72 Counters and Timers ....................................................................................................... 73 Counter Functions ......................................................................................................................... 73 Timer Functions............................................................................................................................. 74 Goto and Subroutine Functions ....................................................................................... 76 Goto Function ................................................................................................................................ 76 Subroutine Function ...................................................................................................................... 77 Loops and Conditional Statements .................................................................................. 78 For Next Loop................................................................................................................................ 78 Do Loop ......................................................................................................................................... 80 IF Statement .................................................................................................................................. 84 Flow Control, Messages and Forms ................................................................................ 86 Delay Function .............................................................................................................................. 86 Schedule Function ........................................................................................................................ 87 ii Contents End Function ................................................................................................................................. 87 Custom Dynamic Message Box .................................................................................................... 88 Wait for Transmit On Dynamic Message Box ............................................................................... 91 Wait for Transmit Off Dynamic Message Box ............................................................................... 93 Wait for Audio Level Dynamic Message Box ...............................................................................