Tektronix Sony/Tek -- 3066,3086 Programmer Manual

Programmer Manual

3066 & 3086
3 GHz Real Time Spectrum Analyzer

071-0502-01

This document supports firmware version 2.2.

Copyright E Sony/Tektronix Corporation. All rights reserved.
Copyright E T ektronix, Inc. All rights reserved.
T ektronix 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 privileges reserved.
Printed in Japan.
Sony/T ektronix Corporation, P.O.Box 5209, T okyo Int’l, Tokyo 100–31 Japan
T ektronix, Inc., P.O. Box 1000, Wilsonville, OR 97070–1000
TEKTRONIX and TEK are registered trademarks of T ektronix, Inc.

WARRANTY

T ektronix warrants that this product will be free from defects in materials and workmanship for a period of one (1) year
from the date of shipment. If any such product proves defective during this warranty period, T ektronix, at its option, either
will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the
defective product.

In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period and make suitable arrangements for the performance of service. Customer shall be responsible for
packaging and shipping the defective product to the service center designated by T ektronix, with shipping charges prepaid.
T ektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
T ektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any
other charges for products returned to any other locations.

This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. T ektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than T ektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; or c) to service a product that has been
modified or integrated with other products when the effect of such modification or integration increases the time or
difficulty of servicing the product.

THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THIS PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESSED OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX’ RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND
EXCLUSIVE REMEDY PROVIDED TO THE CUST OMER FOR BREACH OF THIS WARRANTY. TEKTRONIX
AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT , SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.

Table of Contents

Getting Started

Syntax and Commands

Getting Started 1–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

The Difference between the 3066 and 3086 1–1. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview of the Manual 1–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Connecting the Interface 1–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Communication Ports 1–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting Communication Parameters from the Front Panel 1–7. . . . . . . . . . . . . . . . . .

Command Syntax 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Commands and Queries 2–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Constructed Mnemonics 2–6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Command Groups 2–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Functional Groups 2–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

General Programming Sequence 2–10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuration Commands 2–11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setup Commands 2–12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

View Commands 2–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Utility Commands 2–34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuration Commands 2–37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Standard Setup Commands 2–57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CDMA Setup Commands 2–77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Waveform View Commands 2–91. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Analog View Commands 2–119. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

FSK View Commands 2–131. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Spectrogram View Commands 2–141. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Waterfall View Commands 2–155. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Polar View Commands 2–171. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Eye Diagram View Commands 2–187. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Symbol Table View Commands 2–191. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

EVM View Commands 2–197. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CDMA Waveform View Commands 2–207. . . . . . . . . . . . . . . . . . . . . . . . . . .

CDMA Polar View Commands 2–229. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CDMA Time View Commands 2–247. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

i

Table of Contents

CodeSpectrogram View Commands

(3066 Option 15 and 3086 Option 16 Only) 2–267. . . . . . . . . . . . . . . . . .

CodePolar View Commands

(3066 Option 15 and 3086 Option 16 Only) 2–277. . . . . . . . . . . . . . . . . .

CodePower View Commands

(3066 Option 15 and 3086 Option 16 Only) 2–287. . . . . . . . . . . . . . . . . .

CodeWSpectrogram View Commands (3086 Option 16 Only) 2–299. . . . . .

CodeWPolar View Commands (3086 Option 16 Only) 2–309. . . . . . . . . . . .

CodeWPower View Commands (3086 Option16 Only) 2–319. . . . . . . . . . . .

CCDF Commands (Option 20 Only) 2–331. . . . . . . . . . . . . . . . . . . . . . . . . . .

CCDFView Commands (Option 20 Only) 2–347. . . . . . . . . . . . . . . . . . . . . . .

Self Gain-Calibration Commands 2–357. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Save/Load Commands 2–361. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Average Commands 2–375. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remote Commands 2–381. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Retrieving Response Message 2–399. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Status and Events

Programming Examples

Appendices

Glossary and Index

Status and Events 3–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Obtaining Event and Error Messages 3–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

TCP/IP Event Port 3–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Status Byte Register (SBR) 3–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Messages 3–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Programming Examples 4–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix A: Character Charts A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix B: Factory Initialization Settings B–1. . . . . . . . . . . . . . . . . . . . .

Configuration Commands B–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setup Commands B–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

View Commands B–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Utility Commands B–15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

:Config:Mode Command B–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

ii

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

List of Figures

Table of Contents

Figure 1–1: Common message elements 1–2. . . . . . . . . . . . . . . . . . . . . . . .

Figure 1–2: Functional groupings and an alphabetical list of

commands 1–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 1–3: Event (interrupt) driven programs 1–3. . . . . . . . . . . . . . . . . .

Figure 1–4: Example programs of the PERL source codes 1–3. . . . . . . . .

Figure 1–5: Interface connector location on the rear panel 1–4. . . . . . . .

Figure 1–6: GPIB connection 1–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 1–7: Typical GPIB network configurations 1–5. . . . . . . . . . . . . . .

Figure 1–8: Ethernet connection 1–6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 1–9: Setting the communication parameters 1–7. . . . . . . . . . . . . .

Figure 1–10: Setting the GPIB parameters 1–8. . . . . . . . . . . . . . . . . . . . . .

Figure 1–11: Setting the TCP/IP parameters 1–9. . . . . . . . . . . . . . . . . . . .

Figure 2–1: Example of subsystem hierarchy tree 2–2. . . . . . . . . . . . . . . .

Figure 2–2: Example of chaining commands and queries 2–4. . . . . . . . . .

Figure 2–3: Example of omitting root and lower-level nodes in a

chained message 2–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 2–4: Settings for burst analysis 2–174. . . . . . . . . . . . . . . . . . . . . . . . .

Figure 2–5: Setting the mask for the EVM calculation 2–202. . . . . . . . . . . .

Figure 2–6: Setting the reference line at 1 MHz of RBW 2–216. . . . . . . . . .

Figure 2–7: Setting the reference line at 30 kHz of RBW 2–218. . . . . . . . . .

Figure 2–8: Settings for burst analysis 2–232. . . . . . . . . . . . . . . . . . . . . . . . .

Figure 2–9: Setting the trigger mask 2–256. . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 2–10: :View<x>:Scale:XStartZero On and Off (example) 2–344. . .

Figure 2–10: Data file structure 2–361. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 2–11: Retrieving response message 2–399. . . . . . . . . . . . . . . . . . . . . .

Figure 3–1: Obtaining event on the TCP/IP Ethernet 3–1. . . . . . . . . . . . .

Figure 3–2: The Status Byte Register (SBR) 3–2. . . . . . . . . . . . . . . . . . . . .

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

iii

Table of Contents

List of Tables

Table 2–1: BNF symbols and meanings 2–1. . . . . . . . . . . . . . . . . . . . . . . .

Table 2–2: Comparison of header off and on responses 2–3. . . . . . . . . . .

Table 2–3: Parameter types used in syntax descriptions 2–3. . . . . . . . . .

Table 2–4: Constructed mnemonics 2–6. . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–5: Functional groups in the command set 2–9. . . . . . . . . . . . . . .

Table 2–6: Configuration commands 2–11. . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–7: Standard Setup commands 2–12. . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–8: CDMA Setup commands 2–13. . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–9: Waveform View commands 2–14. . . . . . . . . . . . . . . . . . . . . . . .

Table 2–10: Analog View commands 2–16. . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–11: FSK View commands 2–17. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–12: Spectrogram View commands 2–18. . . . . . . . . . . . . . . . . . . . .

Table 2–13: Waterfall View commands 2–19. . . . . . . . . . . . . . . . . . . . . . . .

Table 2–14: Polar View commands 2–20. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–15: Eye Diagram View commands 2–21. . . . . . . . . . . . . . . . . . . . .

Table 2–16: Symbol Table View commands 2–22. . . . . . . . . . . . . . . . . . . . .

Table 2–17: EVM View commands 2–22. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–18: CDMA Waveform View commands 2–23. . . . . . . . . . . . . . . . .

Table 2–19: CDMA Polar View commands 2–24. . . . . . . . . . . . . . . . . . . . .

Table 2–20: CDMA Time View commands 2–26. . . . . . . . . . . . . . . . . . . . .

Table 2–21: CodeSpectrogram View commands

(3066 option 15 and 3086 option 16 only) 2–27. . . . . . . . . . . . . . . . . . .

Table 2–22: CodePolar View commands

(3066 option 15 and 3086 option 16 only) 2–28. . . . . . . . . . . . . . . . . . .

Table 2–23: CodePower View commands

(3066 option 15 and 3086 option 16 only) 2–29. . . . . . . . . . . . . . . . . . .

Table 2–24: CodeWSpectrogram View commands

(3086 option 16 only) 2–29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–25: CodeWPolar View commands (3086 option 16 only) 2–30. . .
Table 2–26: CodeWPower View commands (3086 option 16 only) 2–31. .

Table 2–27: CCDF commands (option 20 only) 2–32. . . . . . . . . . . . . . . . . .

Table 2–28: CCDFView commands (option 20 only) 2–33. . . . . . . . . . . . .

Table 2–29: Self Gain-Calibration commands 2–34. . . . . . . . . . . . . . . . . . .

Table 2–30: Save/Load commands 2–34. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–31: A verage commands 2–35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 2–32: Remote commands 2–36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

iv

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Table of Contents

Table 3–1: SBR bit functions 3–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–2: Event message 3–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–3: No error 3–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–4: Command error 3–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–5: Execution error 3–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–6: Device specific error 3–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table 3–7: GPIB error 3–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table A–1: The 3066 character set A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table A–2: ASCII & GPIB code chart A–2. . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–1: Factory initialization settings — Configuration

commands B–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–2: Factory initialization settings — Setup commands B–2. . . . .

Table B–3: Factory initialization settings — Waveform View

commands B–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–4: Factory initialization settings — Analog View

commands B–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–5: Factory initialization settings — FSK View commands B–4.
Table B–6: Factory initialization settings — Spectrogram View

commands B–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–7: Factory initialization settings — Waterfall View

commands B–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–8: Factory initialization settings — Polar View commands B–6
Table B–9: Factory initialization settings — Eye diagram View

commands B–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–10: Factory initialization settings — Symbol View

commands B–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–11: Factory initialization settings — EVM View commands B–7
Table B–12: Factory initialization settings — CDMA Waveform

View commands B–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–13: Factory initialization settings — CDMA Polar View

commands B–9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–14: Factory initialization settings — CDMA Time View

commands B–9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–15: Factory initialization settings — CodeSpectrogram

View commands (3066 option 15 and 3086 option 16 only) B–10. . . . .

Table B–16: Factory initialization settings — CodePolar View

commands (3066 option 15 and 3086 option 16 only) B–11. . . . . . . . . .

Table B–17: Factory initialization settings — CodePower View

commands (3066 option 15 and 3086 option 16 only) B–11. . . . . . . . . .

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

v

Table of Contents

Table B–18: Factory initialization settings — CodeWSpectrogram

View commands (3086 option 16 only) B–12. . . . . . . . . . . . . . . . . . . . . .

Table B–19: Factory initialization settings — CodeWPolar View

commands (3086 option 16 only) B–12. . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–20: Factory initialization settings — CodeWPower View

commands (3086 option 16 only) B–13. . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–21: Factory initialization settings — CCDF commands

(option 20 only) B–13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–22: Factory initialization settings — CCDFView commands

(option 20 only) B–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–23: Factory initialization settings — Self gain-calibration

commands B–15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–24: Factory initialization settings — Save/Load commands B–15
Table B–25: Factory initialization settings — Average commands B–15. .
Table B–26: Factory initialization settings — Remote commands B–15. .
Table B–27: Factory initialization settings — :Config:Mode

command – 1 B–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–28: Factory initialization settings — :Config:Mode

command – 2 B–17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Table B–29: Factory initialization settings — :Config:Mode

command (3066 option 15 and 3086 option 16 only) B–18. . . . . . . . . .

Table B–30: Factory initialization settings — :Config:Mode

command (option 20 only) B–18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

vi

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Preface

This is the Programmer Manual for the 3066 and 3086 Real Time Spectrum
Analyzer. This manual provides information on operating the instrument over the
GPIB and TCP/IP interfaces. It also covers the 3066 Option 15 cdmaOne
analysis functions, the 3086 Option 16 W-CDMA/cdmaOne analysis functions,
and the 3066/3086 Option 20 CCDF analysis functions.

This manual provides the following information:
H Getting Started describes how to connect and set up the analyzer for remote

operation.

H Syntax and Commands defines the command syntax and processing

conventions and describes each command in the analyzer command set.

H Status and Events explains the status information and event messages

reported by the analyzer.

H Programming Examples shows some example analyzer programs.
H Appendices contains various tables of reference information.

Related Manuals

H Glossary and Index contains a glossary of common terms and an index to

this manual.

Other documentation for the analyzer includes:
H The 3066 and 3086 Real Time Spectrum Analyzer User Manual (Tektronix

part number 071-0501-XX) describes the operation of the instrument.

H The 3066 and 3086 Real Time Spectrum Analyzer Service Manual (Tektro-

nix part number 071-0503-XX) provides information for maintaining and
servicing the analyzer.

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

vii

Preface

viii

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Getting Started

Getting Started

The 3066 and 3086 are DC to 3 GHz Real Time Spectrum Analyzer. The
instrument software operates on the Windows 95. You can write computer
programs that remotely set the analyzer front panel controls or that take
measurements and read those measurements for further analysis or storage
through the GPIB or TCP/IP Ethernet (optional) interface.

To help you get started with programming the analyzer, this section includes the
following sections:

H Overview of the Manual – summarizes the type of programming information

contained in each major section of this manual.

H Setting Up Remote Communications – describes how to physically connect

the analyzer to a controller and set the appropriate front panel controls.

The Difference between the 3066 and 3086

The 3066 and 3086 functions are the same, except that the 3086 has the
following two input modes:

H Wideband input mode: Processes 50 MHz to 3 GHz signals with maximum

30 MHz span in the vector mode.

H IQ input mode: Inputs the I and Q signals directly from the rear panel

connectors.

The descriptions in this manual apply to both the 3066 and 3086, unless
otherwise noted. For more information about the functions of the analyzer, refer
to the User Manual.

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

1-1

Getting Started

Overview of the Manual

The information contained in each major section of this manual is described
below.

Syntax and Commands

The Syntax and Commands chapter describes the structure and content of the
messages your program sends to the analyzer, Figure 1–1 shows command parts
as described in the Command Syntax subsection.

Command Parts

Header

Arguments

:Util3:PeakHoldĂĂActive,100,0,D1

Mnemonics

Figure 1-1: Common message elements

Chapter 2 also describes the effect of each command and provides examples of
how you might use it. The Command Groups section provides a list by function­al area. The command description sections starting from the Configuration
Commands on page 2–37 arrange commands alphabetically for each command
group (see Figure 1–2).

Space

Comma

Waveform View Commands

Utility

Configuration Commands

Commands grouped in functional areas Commands listed alphabetically

Setup Commands

:Config:Block
:Config:Continue
:Config:Label
:Config:Message
:Config:Mode

and

Figure 1-2: Functional groupings and an alphabetical list of commands

1-2

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

:Setup:FFTPoints

:Setup:CenterFrequency

:Setup:BlockSize

Syntax: . . .

Argument: . . .

Examples: . . .

for each command group

Getting Started

Status and Events

The program may request information from the analyzer. The analyzer provides
information in the form of status and error messages. Figure 1–3 illustrates the
basic operation of this system.

The Status and Events chapter starting on page 3–1 describes how to obtain
status and event messages in your programs.

Your program requests

status and event reports.

Controller

The analyzer sends status and
event reports.

3066/3086

Figure 1-3: Event (interrupt) driven programs

Programming Examples

The Programming Examples chapter starting on page 4–1 describes some
example programs of the PERL source codes (PERL is a freeware).

#
# Main
#
tcp_client(S, '', '3000');
tcp_client(SS, '', '3001');
print S "NewLine LF\n";
print S "Config:Pause On\n";
print S "Config:View1 Waveform\n";
print S "View1:Trace2:Source D1\n";

Figure 1-4: Example programs of the PERL source codes

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

1-3

Getting Started

Connecting the Interface

The analyzer has an IBM PC based expansion slots on its rear panel, as shown in
Figure 1–5. The analyzer is shipped standard with a GPIB port. In addition, the
analyzer can be configured with optional networking cards.

H GPIB interface

H Ethernet interface (Option 10)

NOTE. Only a service personnel can install the network card. Contact Tektronix
for details.

You can also connect the following peripheral devices to the analyzer. Refer to
the 3066 and 3086 User Manual for information on using these interfaces.

This connector has a D-type shell and conforms to IEEE Std 488.1–1987

(The cable is available from Tektronix as part number 012–0991–00).

With Option 10, you can connect the analyzer directly to an Ethernet

network using a twisted pair (10BASE-T/100BASE-TX) cable.

H Mouse and keyboard interface
H Parallel interface for connecting a printer
H SCSI interface for connecting a SCSI device such as an hard disk.

Parallel connector

SCSI connector

1-4

Ethernet interface (Option 10)

GPIB interface

Mouse and keyboard interface

Figure 1-5: Interface connector location on the rear panel

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Using Communication Ports

The analyzer can communicate with the external controller or other devices on
the GPIB and Ethernet network.

Getting Started

Using the GPIB

The analyzer has the Talker/Listener and Controller functions. Refer to the next
section about setting the parameters for the port.

Controller

3066/3086 as the Controller

Bus Bus

OR

Other GPIB device

3066/3086 as the Talker/Listner

Figure 1-6: GPIB connection

GPIB Device

GPIB Device

GPIB Device

GPIB Device

Figure 1-7: Typical GPIB network configurations

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

GPIB Device

GPIB Device

GPIB Device

1-5

Getting Started

GPIB Requirements. Observe these rules when you use your analyzer with a
GPIB network:

H Assign a unique device address to each device on the bus. No two devices

can share the same device address.

H Do not connect more than 15 devices to any one bus.
H Connect one device for every 2 meters (6 feet) of cable used.
H Do not use more than 20 meters (65 feet) of cable to connect devices to a

bus.
H Turn on at least two-thirds of the devices on the network while using the

network.
H Connect the devices on the network in a star or linear configuration. Do not

use loop or parallel configurations (see Figure 1–7).

Using TCP/IP

The analyzer communicates with the external devices through the following two
ports on the TCP/IP Ethernet network.

H Command port receives commands from, or returns responses to the

external controller.
H Event port sends events to the external controller.
Refer to the next section about setting the parameters for these ports.

Controller

Command

port

TCP/IP Ethernet network

3066/3086

Event

port

1-6

Figure 1-8: Ethernet connection

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Setting Communication Parameters from the Front Panel

You can set the communication parameters from the front panel menu or with the
Remote commands. This section describes the front panel operation procedures.
For the remote control commands, refer to Remote Commands on page 2–381.

1. Press the CONFIG:UTILITY key to display the Utility menu.

2. Press the MORE... side key.

3. Press the UTIL H side key to display the Remote menu. See Figure 1–9.

H If you use the GPIB interface, go to the next section Setting the GPIB

Parameters on page 1–8.

H If you use the TCP/IP interface, go to the section Setting the TCP/IP

Parameters on page 1–9.

Getting Started

Figure 1-9: Setting the communication parameters

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

1-7

Getting Started

Setting the GPIB

Parameters

You need to set the GPIB parameters of the analyzer to match the configuration
of the bus. Once you have set these parameters, you can control the analyzer
through the GPIB interface.

1. Press the GPIB side key to display the GPIB configuration menu.

See Figure 1–10.

2. Press the Interface side key, and select Talker/Listener using either the

general purpose knob or the keypad.

3. Press the Primary Address side key, and set GPIB address using either the

general purpose knob or the keypad.

1-8

Figure 1-10: Setting the GPIB parameters

The analyzer is set up for bidirectional communication with your controller. If
you wish to isolate the analyzer from the bus:

H Press the Interface side key, and select Off using either the general purpose

knob or the keypad.

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Getting Started

Setting the TCP/IP

Parameters

You need to set the TCP/IP parameters of the analyzer to match the network
configuration. Once you have set these parameters, you can control the analyzer
on the Ethernet network.

1. Press the TCP/IP side key to display the TCP/IP configuration menu.

See Figure 1–11.

2. Press the Command Port side key, and set the command port number using

either the general purpose knob or the keypad. The number ranges 1024 to

32767.

3. Press the Event Port side key, and set the event port number using either the

general purpose knob or the keypad. The number ranges 1024 to 32767. It
must be different from the command port number.

4. Press the New Line side key, and select the new-line character of returned

value using either the general purpose knob or the keypad.

Figure 1-11: Setting the TCP/IP parameters

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

1-9

Getting Started

1-10

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Syntax and Commands

Command Syntax

This section contains general information on command structure and syntax
usage. You should familiarize yourself with this material before using the
analyzer command descriptions.

This manual describes commands and queries using the Backus-Naur Form
(BNF) notation. Table 2–1 defines the standard BNF symbols.

Table 2-1: BNF symbols and meanings

Symbol Meaning

<ą> Defined element

::= Is defined as

| Exclusive OR

{ą} Group; one element is required

[ą] Optional; can be omitted

.ă.Ă. Previous element(s) may be repeated

(ą) Comment

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

2-1

Command Syntax

Commands and Queries

The analyzer commands are based on a hierarchical or tree structure (see Figure
2–1) that represents a subsystem. The top level of the tree is the root node; it is
followed by one or more lower-level nodes.

Creating Commands

View1

Marker

DeltaX

PeakX

Root node

LowerĆlevel
nodes

Figure 2-1: Example of subsystem hierarchy tree

You can create commands and queries from these subsystem hierarchy trees.
Commands specify actions for the instrument to perform. Queries return
measurement data and information about parameter settings.

The analyzer commands are created by stringing together the nodes of a
subsystem hierarchy and separating each node by a colon (:).

In Figure 2–1, View1 is the root node and Marker, X, DeltaX, and Peak are
lower-level nodes. To create a command, start with the root node View1 and
move down the tree structure adding nodes until you reach the end of a branch.
Most commands and some queries have parameters; you must include a value for
these parameters. The command descriptions, which start on page 2–7, list the
valid values for all parameters.

2-2

Creating Queries

For example, :View1:Marker:X 1.5 is a valid command created from the
hierarchy tree in Figure 2–1.

NOTE. If you specify a parameter value that is out of range, the parameter will
be set to a default value.

To create a query, start at the root node of a tree structure, move down to the end
of a branch, and add a question mark. :View1:Marker:X? is an example of a
valid query using the hierarchy tree in Figure 2–1.

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

Command Syntax

Headers in Query

Responses

Parameter Types

You can control whether the analyzer returns headers as part of the query
response. Use the [:Util8]:Header command (page 2–386) to control this
feature. If header is on, the query response returns command headers and formats
itself as a valid set command. When header is off, the response includes only the
values. This may make it easier to parse and extract the information from the
response. Table 2–2 shows the difference in responses.

Table 2-2: Comparison of header off and on responses

Query Header off response Header on response

:View1:Source? "FILE1.AP" :View1:Source "File1.AP"

:Setup:Span? 5M :Setup:Span 5M

Parameters are indicated by angle brackets, such as <file_name>. There are
several different types of parameters, as listed in Table 2–3. The parameter type
is listed after the parameter. Some parameter types are defined specifically for
the analyzer command set and some are defined by ANSI/IEEE 488.2-1987.

Table 2-3: Parameter types used in syntax descriptions

Special Characters

Parameter Type Description Example

boolean Boolean numbers or values On, Off

discrete A list of specific values MIN, MAX

NR11numeric Integers 0, 1, 15, -1

NR21numeric Decimal numbers 1.2, 3.141516, -6.5

NR31numeric Floating point numbers 3.1415E-9, -16.1E5

NRf1numeric Flexible decimal number that

may be type NR1, NR2, or NR3

2

string

1 An ANSI/IEEE 488.2Ć1992Ćdefined parameter type.

2 Defined in ANSI/IEEE 488.2 as String Response Data" and String Program Data."

Alphanumeric characters (must
be within quotation marks)

See NR1, NR2, NR3 examples

Testing 1, 2, 3"

The Line Feed (LF) character (ASCII 10) and all characters in the range of
ASCII 127-255 are defined as special characters. Using these characters in any
command yields unpredictable results.

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual

2-3

Command Syntax

Abbreviating Commands,

Queries, and Parameters

Chaining Commands and

Queries

You must not

abbreviate all commands, queries, and parameters. For example,
shortening the command :Setup:CenterFrequency to :Setup:CenterFreq
causes an error.

You can chain several commands or queries together into a single message. To
create a chained message, first create a command or query, then add a semicolon
(;), and finally add more commands or queries and semicolons until you are
done. If the command following a semicolon is a root node, precede it with a
colon (:). Figure 2–2 illustrates a chained message consisting of several
commands and queries. The chained message should end in a command or query,
not a semicolon. Responses to any queries in your message are separated by
semicolons.

:Config:Setup Standard;:Setup:BlockSize 200;:View1:Marker:X?;:Util2:Source?

First command Second command Second query

The response from this chained message might be:

First query

1.2;Active

Response from first query Response from second query

Figure 2-2: Example of chaining commands and queries

If a command or query has the same root and lower-level nodes as the previous
command or query, you can omit these nodes. In Figure 2–3, the second
command has the same root node (Marker) as the first command, so these nodes
can be omitted.

:View1:Marker:X 1.5;:View1:Marker:Y -20;:View1:Marker:DeltaMarker On

Identical root and lowerĆlevel nodes

:View1:Marker:X 1.5;Y -20;DeltaMarker On

First command Additional commands

(omitted the root nodes)

Figure 2-3: Example of omitting root and lowerĆlevel nodes in a chained message

2-4

3066 & 3086 3 GHz Real Time Spectrum Analyzer Programmer Manual