Agilent Technologies 81250 Operating instructions

Artisan Technology Group is your source for quality
new and certied-used/pre-owned equipment
• FAST SHIPPING AND
DELIVERY
• TENS OF THOUSANDS OF
IN-STOCK ITEMS
• EQUIPMENT DEMOS
• HUNDREDS OF
MANUFACTURERS
SUPPORTED
• LEASING/MONTHLY
RENTALS
• ITAR CERTIFIED
SECURE ASSET SOLUTIONS
SERVICE CENTER REPAIRS
Experienced engineers and technicians on staff
at our full-service, in-house repair center
WE BUY USED EQUIPMENT
Sell your excess, underutilized, and idle used equipment
We also offer credit for buy-backs and trade-ins
www.artisantg.com/WeBuyEquipment
REMOTE INSPECTION
Remotely inspect equipment before purchasing with
our interactive website at www.instraview.com
LOOKING FOR MORE INFORMATION?
Visit us on the web at www.artisantg.com for more
information on price quotations, drivers, technical
specications, manuals, and documentation
Contact us: (888) 88-SOURCE | [e-mail] | www.artisantg.com
SM
View
Instra

S1
Agilent 81250 Parallel Bit Error Ratio Tester
System Programming
Guide and
SCPI Reference
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

2Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
Important Notice
© Agilent Technologies, Inc. 2003
Manual Part Number
5988-4886EN
Revision
Revision 5.5, December 2003
Printed in Germany
Agilent Technologies
Herrenberger Straße 130
D-71034 Böblingen
Germany
Authors: t3 medien GmbH
Warranty
The material contained in this document is
provided "as is," and is subject to being changed,
without notice, in future editions. Further, to the
maximum extent permitted by applicable law,
Agilent disclaims all warranties, either express or
implied, with regard to this manual and any
information contained herein, including but not
limited to the implied warranties of
merchantability and fitness for a particular
purpose. Agilent shall not be liable for errors or
for incidental or consequential damages in
connection with the furnishing, use, or
performance of this document or of any
information contained herein. Should Agilent and
the user have a separate written agreement with
warranty terms covering the material in this
document that conflict with these terms, the
warranty terms in the separate agreement shall
control.
Technology Licenses
The hardware and/or software described in this
document are furnished under a license and may
be used or copied only in accordance with the
terms of such license.
Restricted Rights Legend
If software is for use in the performance of a U.S.
Government prime contract or subcontract,
Software is delivered and licensed as
"Commercial computer software" as defined in
DFAR 252.227-7014 (June 1995), or as a
"commercial item" as defined in FAR 2.101(a) or
as "Restricted computer software" as defined in
FAR 52.227-19 (June 1987) or any equivalent
agency regulation or contract clause. Use,
duplication or disclosure of Software is subject to
Agilent Technologies' standard commercial
license terms, and non-DOD Departments and
Agencies of the U.S. Government will receive no
greater than Restricted Rights as defined in FAR
52.227-19(c)(1-2) (June 1987). U.S. Government
users will receive no greater than Limited Rights
as defined in FAR 52.227-14 (June 1987) or DFAR
252.227-7015 (b)(2) (November 1995), as
applicable in any technical data.
Safety Notices
CAUTION
A CAUTION notice denotes a hazard. It calls
attention to an operating procedure, practice, or
the like that, if not correctly performed or adhered
to, could result in damage to the product or loss
of important data. Do not proceed beyond a
CAUTION notice until the indicated conditions
are fully understood and met.
WARNING
A WARNING notice denotes a hazard. It calls
attention to an operating procedure, practice, or
the like that, if not correctly performed or adhered
to, could result in personal injury or death. Do not
proceed beyond a WARNING notice until the
indicated conditions are fully understood and
met.
Trademarks
Windows NT ® and MS Windows ® are U.S.
registered trademarks of Microsoft Corporation.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006 3
Contents
Programming Interfaces 19
Programming Models 20
Agilent 81250 String Interface Library 22
Error Handling 23
Connect_HP81200 23
Call_HP81200 24
GetErrStr_HP81200 25
Disconnect_HP81200 25
Example Implementations 26
Command Line Interface 28
Overview of the SCPI Command Structure 29
Command Syntax 30
Hierarchical Structure 30
Conventions Used in the Command Reference 30
Instrument Commands and Queries Syntax 31
Linking Commands 31
The Command Tree 32
DVT Subsystem and Virtual Instruments 33
Multiple Parameter Access 34
Example Programs 37
Typical SCPI Programming Sequence 38
Example C++ Program 40
SCPI Commands Overview 43
Generic Administration Commands 44
Virtual Instruments Administration Commands 44
Mass Memory Commands 45
Segment Editing Commands 46
Global Commands 48
Clock Reference Input Commands 49
External Input Commands 50
Trigger Output Commands 50
Port Administration Commands 51
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
4Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
Terminal Administration Commands 52
Connector Administration Commands 52
Clockgroup Administration Commands 53
Sequence Commands 53
Synchronization Commands 54
Analyzer Commands 55
Level Parameter Commands 55
Amplitude/Offset Correction Factor Commands 56
Timing Parameter Commands 57
MUX Parameter Commands 58
DeMUX Parameter Commands 59
DeMUX Rewiring Commands 59
Delay Control Parameter Commands 60
Input Parameter Commands 60
Optical Input Commands 62
Output Parameter Commands 63
Optical Output Commands 64
Clock Trigger Output Commands 65
Auxiliary Out Commands 65
Performance Parameter Commands 66
Format Parameter Commands 66
Commands in the DVT Subsystem 67
Example: Use of :DVT Subsystem Commands 68
Top-Level Com ma nds 69
:DVT:IDN? 69
:SYSTem Subsystem 70
:DVT:SYSTem:ERRor? 70
:INSTrument Subsystem 71
:DVT:INSTrument:LIST? 71
:DVT:INSTrument:RESource:LIST? 71
:INSTrument:HANDle Subsystem 72
:DVT:INSTrument:HANDle:CREate? 72
:DVT:INSTrument:HANDle:LIST? 73
:DVT:INSTrument:HANDle:DESTroy 73
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006 5
:MMEMory Subsystem 74
:DVT:MMEMory:SETTing:EXPort? 74
:DVT:MMEMory:SETTing:IMPort 75
Commands in DSR Application Subsystems 77
Administration Commands 78
:<Handle>:IDN? 78
:<Handle>:OPC? 78
:SYSTem Subsystem 79
:<Handle>:SYSTem:ERRor? 79
:<Handle>:SYSTem:CINFormation? 80
:<Handle>:SYSTem:TEST:MODule 81
:<Handle>:SYSTem:TEST:GLOBal 82
:<Handle>:MODule:SREVisions 82
:<Handle>:SYSTem:MQUeue[:READ]? 83
:<Handle>:SYSTem:MQUeue:LENGth? 83
:<Handle>:SYSTem:PON[:STATus] 83
:SYSTem:CLIent Subsystem 84
:<Handle>:SYSTem:CLIent[:HANDle]? 84
:<Handle>:SYSTem:CLIent:LOCK 84
:<Handle>:SYSTem:CLIent:BLOCk 85
:<Handle>:SYSTem:CLIent:UNLock 85
:CONFiguration Subsystem 86
:<Handle>:CONFiguration:CGRoups(*)? 86
:<Handle>:CONFiguration:CGRoups(*):MODules(*)? 86
:<Handle>:CONFiguration:CGRoups(*):MODules(*):
CONNectors(*)? 87
:<Handle>:CONFiguration:CGRoups(*):MODules(*):
CONNectors(*):TYPE? 87
:<Handle>:CONFiguration:STYPes? 87
:<Handle>:CONFiguration:PROFile[:VALue] 88
:<Handle>:CONFiguration:PROFile[:VALue]? 88
:<Handle>:CONFiguration:PROFile:REMove 88
:<Handle>:CONFiguration:PROFile:LIST? 89
:MMEMory Subsystem 90
:<Handle>:MMEMory:LIST? 90
:<Handle>:MMEMory:INFormation? 91
:<Handle>:MMEMory:SEGMent:LOAD 92
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
6Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
:<Handle>:MMEMory:SEGMent:SAVE 93
:<Handle>:MMEMory:SEGMent:GET? 94
:<Handle>:MMEMory:SETTing:NAME? 94
:<Handle>:MMEMory:SETTing:LOAD 95
:<Handle>:MMEMory:SETTing:SAVE 95
:<Handle>:MMEMory:SETTing:NEW 96
:<Handle>:MMEMory:SETTing:DELete 96
:EDIT:SEGMent(*) Subsystem 97
:<Handle>:EDIT:SEGMent:OPEN? 98
:<Handle>:EDIT:SEGMent(*):SAVE 99
:<Handle>:EDIT:SEGMent(*):DELete 100
:<Handle>:EDIT:SEGMent(*):CREate? 100
:<Handle>:EDIT:SEGMent(*):EXISts? 101
:<Handle>:EDIT:SEGMent(*):RPATh? 102
:<Handle>:EDIT:SEGMent(*):CLOSe 103
:<Handle>:EDIT:SEGMent(*):PATTern:DATA 103
:<Handle>:EDIT:SEGMent(*):PATTern:DATA? 104
:<Handle>:EDIT:SEGMent(*):PATTern:CODing 106
:<Handle>:EDIT:SEGMent(*):PATTern:CODing? 107
:<Handle>:EDIT:SEGMent(*):PATTern:ERRor:FIRSt? 107
:<Handle>:EDIT:SEGMent(*):PATTern:ERRor:NEXT? 108
:<Handle>:EDIT:SEGMent(*):PATTern:ERRor:PREVious? 108
:<Handle>:EDIT:SEGMent(*):PATTern:FIND:FIRSt? 109
:<Handle>:EDIT:SEGMent(*):PATTern:FIND:NEXT? 111
:<Handle>:EDIT:SEGMent(*):PATTern:FIND:PREVious? 111
:<Handle>:EDIT:SEGMent(*):PATTern:LENGth? 112
:<Handle>:EDIT:SEGMent(*):PATTern:WIDTh? 112
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:COPY 113
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:PASTE 113
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:FILL 114
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:INVert 115
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:MIRRor 116
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:INSert 117
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:DELete 117
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:CONVerse 118
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:SERialize 119
:<Handle>:EDIT:SEGMent(*):PATTern:MODify:DESerialize 120
:<Handle>:EDIT:SEGMent(*):PARAmeter:LENGth? 120
:<Handle>:EDIT:SEGMent(*):PARAmeter:LIST? 121
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006 7
:<Handle>:EDIT:SEGMent(*):PARAmeter[:VALue]? 121
:<Handle>:EDIT:SEGMent(*):PARAmeter[:VALue] 122
:<Handle>:EDIT:SEGMent(*):PARAmeter:REMove 122
:<Handle>:EDIT:SEGMent(*):TYPE 122
:<Handle>:EDIT:SEGMent(*):TYPE? 123
[:CGRoup(*)] Subsystem 123
:<Handle>[:CGRoup(*)]:CINFormation? 124
[:CGRoup(*)]:MCLock Subsystem 125
:<Handle>[:CGRoup(*)]:MCLock:SOURce[:VALue] 125
:<Handle>[:CGRoup(*)]:MCLock:SOURce[:VALue]? 125
[:CGRoup(*)]:MODule(*) Subsystem 126
:<Handle>[:CGRoup(*)]:MODule(*):CINFormation? 126
:<Handle>[:CGRoup(*)]:MODule(*):TYPE? 127
:<Handle>[:CGRoup(*)]:MODule(*):SLOT? 127
:<Handle>[:CGRoup(*)]:MODule(*):FRAMe? 127
:<Handle>[:CGRoup(*)]:MODule(*):NAME? 127
:<Handle>[:CGRoup(*)]:MODule(*):CNAMes? 128
[:CGRoup(*)]:MODule(*):CONNector(*) Subsystem 129
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):
CINFormation? 129
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):TYPE? 130
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):NAME? 130
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):TNAMe? 130
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):CALibration:
CDELay 131
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):CALibration:
CDELay? 131
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):CALibration:
ZDELay 131
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):CALibration:
ZDELay? 132
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):SPECies[:
VALue]? 132
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):SPECies:
STATe 132
:<Handle>[:CGRoup(*)]:MODule(*):CONNector(*):SPECies:
STATe? 133
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
8Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
[:CGRoup(*)][:SOURce]:TRIGger Subsystem 134
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:DELay 134
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:DELay? 134
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:MUX 135
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:MUX? 135
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:OUTPut[:STATe] 135
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:OUTPut[:STATe]? 136
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:VOLTage[:LEVel][:
IMMediate]:HIGH 136
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:VOLTage[:LEVel][:
IMMediate]:HIGH? 136
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:VOLTage[:LEVel][:
IMMediate]:LOW 137
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:VOLTage[:LEVel][:
IMMediate]:LOW? 137
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:TVOLtage 137
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:TVOLtage? 138
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:IMPedance:
EXTernal 138
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:IMPedance:
EXTernal? 138
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:MODE 139
:<Handle>[:CGRoup(*)][:SOURce]:TRIGger:MODE? 139
:SGENeral Subsystem 140
:SGENeral:INFormation Subsystem 141
:<Handle>:SGENeral:INFormation:PCLasses? 141
:SGENeral:GLOBal Subsystem 142
:<Handle>:SGENeral:GLOBal:CONNect 142
:<Handle>:SGENeral:GLOBal:CONNect? 142
:<Handle>:SGENeral:GLOBal:CALibration:PUSe PASSive 143
:<Handle>:SGENeral:GLOBal:CALibration:SELF DELay 143
:<Handle>:SGENeral:GLOBal:DOFFset 143
:<Handle>:SGENeral:GLOBal:DOFFset? 144
:<Handle>:SGENeral:GLOBal:FETCh:ERRor:ANY? 144
:<Handle>:SGENeral:GLOBal:PERiod 144
:<Handle>:SGENeral:GLOBal:PERiod? 145
:<Handle>:SGENeral:GLOBal:FREQuency 145
:<Handle>:SGENeral:GLOBal:FREQuency? 145
:<Handle>:SGENeral:GLOBal:MUX? 146
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com

Contents
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006 9
:<Handle>:SGENeral:GLOBal:MUX 146
:<Handle>:SGENeral:GLOBal:PLL:DSTate? 149
:<Handle>:SGENeral:GLOBal:PLL:STATe? 150
:SGENeral:GLOBal:CONFigure Subsystem 151
:<Handle>:SGENeral:GLOBal:CONFigure? 151
:<Handle>:SGENeral:GLOBal:CONFigure:CAPTure 151
:<Handle>:SGENeral:GLOBal:CONFigure[:ECOunt] 152
:<Handle>:SGENeral:GLOBal:CONFigure:ECAPture 152
:<Handle>:SGENeral:GLOBal:CONFigure:CCAPture 153
:SGENeral:GLOBal:INITiate:CONTinuous Subsystem 154
:<Handle>:SGENeral:GLOBal:INITiate:CONTinuous 154
:<Handle>:SGENeral:GLOBal:INITiate:CONTinuous? 154
:SGENeral:GLOBal:SYSTem Subsystem 155
:<Handle>:SGENeral:GLOBal:SYSTem:STATe? 155
:SGENeral:GLOBal:SEQuence Subsystem 156
:<Handle>:SGENeral:GLOBal:SEQuence[:VALue] 157
:<Handle>:SGENeral:GLOBal:SEQuence[:VALue]? 161
:<Handle>:SGENeral:GLOBal:SEQuence:EVENTs 162
:<Handle>:SGENeral:GLOBal:SEQuence:EVENTs? 164
:<Handle>:SGENeral:GLOBal:SEQuence:FORCe 165
:<Handle>:SGENeral:GLOBal:SEQuence:LLEVel? 165
:<Handle>:SGENeral:GLOBal:SEQuence:PCONtrol 166
:<Handle>:SGENeral:GLOBal:SEQuence:PCONtrol? 166
:<Handle>:SGENeral:GLOBal:SEQuence:STATe? 166
:SGENeral:GLOBal:SYNChronization Subsystem 167
:<Handle>:SGENeral:GLOBal:SYNChronization:USED? 168
:<Handle>:SGENeral:GLOBal:SYNChronization:BERThreshold
168
:<Handle>:SGENeral:GLOBal:SYNChronization:BERThreshold?
169
:<Handle>:SGENeral:GLOBal:SYNChronization:SMODe 169
:<Handle>:SGENeral:GLOBal:SYNChronization:SMODe? 170
:<Handle>:SGENeral:GLOBal:SYNChronization:APSelect 170
:<Handle>:SGENeral:GLOBal:SYNChronization:APSelect? 171
:<Handle>:SGENeral:GLOBal:SYNChronization:APAlignment171
:<Handle>:SGENeral:GLOBal:SYNChronization:APAlignment?
172
:<Handle>:SGENeral:GLOBal:SYNChronization:PACCuracy 172
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com