Programmer Manual
WCA230A & WCA280A
3 GHz & 8 GHz
Portable Wireless Communication Analyzers
071-1255-03
This document applies to firmware version 2.2
and above.
www.tektronix.com
Copyright © Tektronix Japan, Ltd. All rights reserved.
Copyright © Tektronix, Inc. All rights reserved.
Licensed software products are owned by Tektronix or its suppliers and are protected by United States copyright laws and
international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the
Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1) and (2) of the
Commercial Computer Software – Restricted Rights clause at FAR 52.227-19, as applicable.
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 privileges reserved.
Tektronix Japan, Ltd., Shinagawa Intercity Building B 6th Floor, 2-15-2 Konan, Minato-ku, Tokyo 108-6106 Japan
Tektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Windows and Windows 98 are trademarks of Microsoft Corporation.
Hardware Warranty
Tektronix warrants that the products that it manufactures and sells will be free from defects in materials and workmanship
for a period of one (1) year from the date of shipment. If a product proves defective during this warranty period, Tektronix,
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 Tektronix, with shipping charges prepaid.
Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
Tektronix 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. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than Tektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; c) to repair any damage or malfunction
caused by the use of non-Tektronix supplies; or d) 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 IN LIEU OF ANY OTHER WARRANTIES, EXPRESS 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 CUSTOMER 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.
Software Warranty
Tektronix warrants that the media on which this software product is furnished and the encoding of the programs on the
media will be free from defects in materials and workmanship for a period of three (3) months from the date of shipment.
If a medium or encoding proves defective during the warranty period, Tektronix will provide a replacement in exchange
for the defective medium. Except as to the media on which this software product is furnished, this software product is
provided “as is” without warranty of any kind, either express or implied. Tektronix does not warrant that the functions
contained in this software product will meet Customer’s requirements or that the operation of the programs will be
uninterrupted or error–free.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period. If Tektronix is unable to provide a replacement that is free from defects in materials and workmanship
within a reasonable time thereafter, Customer may terminate the license for this software product and return this software
product and any associated materials for credit or refund.
THIS WARRANTY IS GIVEN BY TEKTRONIX IN LIEU OF ANY OTHER WARRANTIES, EXPRESS OR
IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. TEKTRONIX’ RESPONSIBILITY TO
REPLACE DEFECTIVE MEDIA OR REFUND CUSTOMER’S PAYMENT IS THE SOLE AND EXCLUSIVE
REMEDY PROVIDED TO THE CUSTOMER 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
Preface ix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Related Manual ix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Difference between WCA230A and WCA280A ix. . . . . . . . . . . . . . . . . . . . . . . . .
Overview of the Manual 1–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connecting the Interface 1–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the GPIB Port 1–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting the GPIB Parameters from the Front Panel 1–6. . . . . . . . . . . . . . . . . . . . . . .
Command Syntax 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backus-Naur Form Definition 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SCPI Commands and Queries 2–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IEEE 488.2 Common Commands 2–10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Constructed Mnemonics 2–11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Groups 2–13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Measurement Mode 2–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional Groups 2–15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IEEE Common Commands 2–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:ABORt Commands 2–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CALCulate Commands 2–17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CALibration Commands 2–18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CONFigure Commands 2–19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:DISPlay Commands 2–20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:FETCh Commands 2–23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:FORMat Commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:HCOPy Commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INITiate Commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INPut Commands 2–25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INSTrument Commands 2–25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:MMEMory Commands 2–26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:PROGram Commands 2–26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:READ Commands 2–27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:SENSe Commands 2–28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:STATus Commands 2–31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:SYSTem Commands 2–32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:TRACe Commands 2–32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:TRIGger Commands 2–33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
General Programming Procedure 2–34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
WCA230A & WCA280A Programmer Manual
i
Table of Contents
IEEE Common Commands 2–35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:ABORt Commands 2–45. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CALCulate Commands 2–47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CALibration Commands 2–63. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:CONFigure Commands 2–71. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:DISPlay Commands 2–83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:FETCh Commands 2–131. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:FORMat Commands 2–153. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:HCOPy Commands 2–155. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INITiate Commands 2–159. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INPut Commands 2–163. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:INSTrument Commands 2–169. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:MMEMory Commands 2–173. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:PROGram Commands 2–181. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:READ Commands 2–187. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:SENSe Commands 2–211. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:STATus Commands 2–289. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:SYSTem Commands 2–297. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:TRACe Commands 2–307. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:TRIGger Commands 2–311. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Retrieving Response Message 2–323. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Events
Programming Examples
Status and Event Reporting System 3–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registers 3–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status Registers 3–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enable Registers 3–9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transition Registers 3–11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Queues 3–12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Event Processing Sequence 3–13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Synchronizing Execution 3–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Error Messages and Codes 3–17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Errors 3–18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Execution Errors 3–20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Device Specific Errors 3–22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Query Errors 3–22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Program Sample 4–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Macro Program Execution Sample 4–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ii
WCA230A & WCA280A Programmer Manual
Appendices
Glossary and Index
Table of Contents
Appendix A: Character Charts A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B: GPIB Interface Specification B–1. . . . . . . . . . . . . . . . . . . . . .
Interface Functions B–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interface Messages B–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix C: Factory Initialization Settings C–1. . . . . . . . . . . . . . . . . . . . .
Appendix D: Setting Range D–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display Format and Scale D–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RBW D–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix E: SCPI Conformance Information E–1. . . . . . . . . . . . . . . . . . .
WCA230A & WCA280A Programmer Manual
iii
Table of Contents
List of Figures
Figure 1–1: Command parts 1–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1–2: Functional groupings and an alphabetical list of
commands 1–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1–3: Event-driven program 1–3. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1–4: Sample program (Visual C++ source code) 1–3. . . . . . . . . . .
Figure 1–5: GPIB connector (rear panel) 1–4. . . . . . . . . . . . . . . . . . . . . . .
Figure 1–6: GPIB connection 1–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 1–7: Typical GPIB network configurations 1–5. . . . . . . . . . . . . . .
Figure 1–8: Setting the GPIB parameters 1–6. . . . . . . . . . . . . . . . . . . . . . .
Figure 2–1: Example of SCPI subsystem hierarchy tree 2–2. . . . . . . . . . .
Figure 2–2: Example of abbreviating a command 2–6. . . . . . . . . . . . . . . .
Figure 2–3: Example of chaining commands and queries 2–7. . . . . . . . . .
Figure 2–4: Example of omitting root and lower-level nodes in a
chained message 2–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 2–5: View number assignments 2–47. . . . . . . . . . . . . . . . . . . . . . . . .
Figure 2–6: :DISPlay:CCDF command setting 2–84. . . . . . . . . . . . . . . . . .
Figure 2–7: :DISPlay:DDEMod command setting 2–91. . . . . . . . . . . . . . . .
Figure 2–8: :DISPlay:OVIew command setting 2–105. . . . . . . . . . . . . . . . . .
Figure 2–9: :DISPlay:SPECtrum command setting 2–114. . . . . . . . . . . . . .
Figure 2–10: :DISPlay:TFRequency command setting 2–119. . . . . . . . . . . .
Figure 2–11: View display formats 2–125. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 2–12: :DISPlay:WAVeform command setting 2–126. . . . . . . . . . . . . .
Figure 2–13: Setting up the ACPR measurement 2–214. . . . . . . . . . . . . . . .
Figure 2–14: Defining the analysis range 2–216. . . . . . . . . . . . . . . . . . . . . . .
Figure 2–15: Setting up the channel power measurement 2–231. . . . . . . . .
Figure 2–16: Setting up the C/N measurement 2–234. . . . . . . . . . . . . . . . . . .
Figure 2–17: Defining the analysis range 2–244. . . . . . . . . . . . . . . . . . . . . . .
Figure 2–18: Setting up the EBW measurement 2–255. . . . . . . . . . . . . . . . .
Figure 2–19: Setting frequency and span 2–257. . . . . . . . . . . . . . . . . . . . . . .
Figure 2–20: Setting up the OBW measurement 2–267. . . . . . . . . . . . . . . . .
Figure 2–21: Setting up the spurious signal measurement 2–281. . . . . . . . .
Figure 2–22: Defining the analysis range 2–284. . . . . . . . . . . . . . . . . . . . . . .
Figure 2–23: Trigger mask setting example 2–314. . . . . . . . . . . . . . . . . . . . .
Figure 2–24: Retrieving response message 2–323. . . . . . . . . . . . . . . . . . . . . .
iv
WCA230A & WCA280A Programmer Manual
Table of Contents
Figure 3–1: Status/Event reporting mechanism 3–2. . . . . . . . . . . . . . . . . .
Figure 3–2: The Status Byte Register (SBR) 3–6. . . . . . . . . . . . . . . . . . . . .
Figure 3–3: The Standard Event Status Register (SESR) 3–7. . . . . . . . . .
Figure 3–4: The Operation Condition Register (OCR) 3–8. . . . . . . . . . . .
Figure 3–5: The Event Status Enable Register (ESER) 3–9. . . . . . . . . . . .
Figure 3–6: The Service Request Enable Register (SRER) 3–10. . . . . . . . .
Figure 3–7: Operation Enable Register (OENR) 3–10. . . . . . . . . . . . . . . . .
Figure 3–8: Operation Transition Register (OTR) 3–11. . . . . . . . . . . . . . . .
Figure 3–9: Status and event processing sequence 3–13. . . . . . . . . . . . . . . .
Figure 4–1: Saving the macro programs 4–14. . . . . . . . . . . . . . . . . . . . . . . .
WCA230A & WCA280A Programmer Manual
v
Table of Contents
List of Tables
Table 2–1: BNF symbols and meanings 2–1. . . . . . . . . . . . . . . . . . . . . . . .
Table 2–2: Query response examples 2–3. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–3: Parameter types used in syntax descriptions 2–4. . . . . . . . . .
Table 2–4: Available units 2–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–5: Available SI prefixes 2–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–6: Constructed mnemonics 2–11. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–7: Measurement mode 2–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–8: List of command groups 2–15. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–9: IEEE common commands 2–16. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–10: :ABORt commands 2–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–11: :CALCulate commands 2–17. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–12: :CALibration commands 2–18. . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–13: :CONFigure commands 2–19. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–14: :DISPlay commands 2–20. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–15: :FETCh commands 2–23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–16: :FORMat commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–17: :HCOPy commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–18: :INITiate commands 2–24. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–19: :INPut commands 2–25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–20: :INSTrument commands 2–25. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–21: :MMEMory commands 2–26. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–22: :PROGram commands 2–26. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–23: :READ commands 2–27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–24: :SENSe commands 2–28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–25: :STATus commands 2–31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–26: :SYSTem commands 2–32. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–27: :TRACe commands 2–32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–28: :TRIGger commands 2–33. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–29: :DISPlay command subgroups 2–83. . . . . . . . . . . . . . . . . . . . .
Table 2–30: Main view display formats 2–92. . . . . . . . . . . . . . . . . . . . . . . .
Table 2–31: Subview display formats 2–98. . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–32: Queried information on the digital modulation analysis
results 2–138. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–33: Input attenuation settings 2–164. . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–34: Mixer level settings 2–167. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi
WCA230A & WCA280A Programmer Manual
Table of Contents
Table 2–35: Reference level range 2–168. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–36: Measurement mode 2–170. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–37: Queried information on the digital modulation analysis
results 2–195. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–38: :SENSe command subgroups 2–211. . . . . . . . . . . . . . . . . . . . . .
Table 2–39: Measurement item selections 2–220. . . . . . . . . . . . . . . . . . . . . .
Table 2–40: Block size setting range 2–225. . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–41: Modulation selections 2–248. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–42: Communication standard selections 2–252. . . . . . . . . . . . . . . .
Table 2–43: Measurement frequency bands 2–258. . . . . . . . . . . . . . . . . . . .
Table 2–44: Span setting 2–264. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–45: FFT windows 2–277. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 2–46: S/A mode measurement items 2–279. . . . . . . . . . . . . . . . . . . . . .
Table 2–47: Bin number setting range 2–313. . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–1: SBR bit functions 3–6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–2: SESR bit functions 3–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–3: OCR bit functions 3–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–4: Command errors 3–18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–5: Execution errors 3–20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–6: Device specific errors 3–22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 3–7: Query errors 3–22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table A–1: ASCII & GPIB code chart A–2. . . . . . . . . . . . . . . . . . . . . . . . . .
Table B–1: GPIB interface function implementation B–1. . . . . . . . . . . . .
Table B–2: Standard interface messages B–3. . . . . . . . . . . . . . . . . . . . . . .
Table C–1: Factory initialization settiings — IEEE common
commands C–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table C–2: Factory initialization settiings — :CALCulate
commands C–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table C–3: Factory initialization settiings — :CALibration
commands C–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table C–4: Factory initialization settiings — :DISPlay commands C–2.
Table C–5: Factory initialization settiings — :FORMat commands C–4.
Table C–6: Factory initialization settiings — :INITiate commands C–4.
Table C–7: Factory initialization settiings — :INPut commands C–5. . .
Table C–8: Factory initialization settiings — :SENSe commands C–5. . .
Table C–9: Factory initialization settiings — :STATus commands C–9. .
WCA230A & WCA280A Programmer Manual
vii
Table of Contents
Table C–10: Factory initialization settiings — :TRACe commands C–9.
Table C–11: Factory initialization settiings — :TRIGger commands C–9
Table D–1: Display format and scale D–1. . . . . . . . . . . . . . . . . . . . . . . . . .
Table D–2: RBW setting range D–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–1: SCPI conformance information — IEEE common
commands E–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–2: SCPI conformance information — :ABORt commands E–1.
Table E–3: SCPI conformance information — :CALCulate
commands E–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–4: SCPI conformance information — :CALibration
commands E–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–5: SCPI conformance information — :CONFigure
commands E–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–6: SCPI conformance information — :DISPlay commands E–3
Table E–7: SCPI conformance information — :FETCh commands E–6.
Table E–8: SCPI conformance information — :HCOPy commands E–6
Table E–9: SCPI conformance information — :INITiate commands E–7
Table E–10: SCPI conformance information — :INPut commands E–7.
Table E–11: SCPI conformance information — :INSTrument
commands E–7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–12: SCPI conformance information — :MMEMory
commands E–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–13: SCPI conformance information — :PROGram
commands E–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–14: SCPI conformance information — :READ commands E–9.
Table E–15: SCPI conformance information — :SENSe commands E–9
Table E–16: SCPI conformance information — :STATus commands E–13
Table E–17: SCPI conformance information — :SYSTem
commands E–13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table E–18: SCPI conformance information — :TRACe commands E–14
Table E–19: SCPI conformance information — :TRIGger
commands E–14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii
WCA230A & WCA280A Programmer Manual
Preface
This programmer manual is for the WCA230A and WCA280A Portable Wireless
Communication Analyzers. It provides information on operating your analyzer
using the General Purpose Interface Bus (GPIB).
This manual is composed of the following sections:
H Getting Started outlines how to use the GPIB interface.
H Syntax and Commands defines the syntax used in command descriptions,
presents a list of all command subsystems, and presents detailed descriptions
of all programming commands.
H Status and Events describes how the status and Events Reporting system
operates and presents a list of all system errors.
H Programming Examples describes some example analyzer programs.
H Appendices provides additional information including character charts, GPIB
interface specification, and factory initialization settings.
Related Manual
WCA230A and WCA280A User Manual
(Standard accessory; Tektronix part number 071-1253-XX)
Describes how to install the analyzer and how to work with the menus and
details the functions.
Difference between WCA230A and WCA280A
WCA230A and WCA280A have the same functions except for their measurement frequency ranges:
WCA230A DC to 3 GHz. . . . . . . . .
WCA280A DC to 8 GHz. . . . . . . . .
Unless otherwise noted, descriptions in this manual apply to both.
WCA230A & WCA280A Programmer Manual
ix
Preface
x
WCA230A & WCA280A Programmer Manual
Getting Started
Getting Started
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.
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 Connecting the Interface
Describes how to physically connect the analyzer to a controller.
H Using GPIB Ports
Describes how to use the GPIB port.
H Setting the GPIB Parameters from the Front Panel
Describes how to set the GPIB parameters from the front panel.
WCA230A & WCA280A 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
:CALCulate Commands
:TRIGger
:ABORt Commands
IEEE Common Commands
*CAL?
*CLS
*ESE
*ESR
*IDN?
*OPC
Section 2, Syntax and Commands, 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
Comma
:MMEMory:COPY FILE1,FILE2
Mnemonics
Figure 1-1: Command parts
Section 2 also describes the effect of each command and provides examples of
how you might use it. The Command Groups section provides lists by functional
areas. The IEEE Common Commands and the subsequent sections arrange
commands alphabetically (Figure 1–2).
ArgumentsSpace
:CALCulate:MARKer:X
:CALCulate:MARKer:AOFF
S
A
E
:CALCulate:DLINe
S
A
Syntax: . . .
E
Arguments:
Examples: . . .
Commands grouped in functional areas Commands listed alphabetically
Figure 1-2: Functional groupings and an alphabetical list of commands
1-2
WCA230A & WCA280A Programmer Manual
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.
Section 3, Status and Events, describes how to get status or event information
from the program and details the event and error messages.
Your program requests
status and event reports.
Controller
The analyzer sends status and event reports.
WCA230A/WCA280A
GPIB cable
Figure 1-3: EventĆdriven program
Programming Examples
Section 4, Programming Examples, includes Visual C++ source code as well as
sample programs for running macro programs.
GpibWrite("INSTrument 'SANORMAL'");
GpibWrite("*RST");
GpibTimeOut(NORMAL_TIME);
GpibWrite("CONFigure:SPECtrum:CHPower");
GpibWrite("FREQuency:BAND RF1B");
GpibWrite("FREQuency:CENTer 1GHz");
GpibWrite("FREQuency:SPAN 1MHz");
GpibWrite("*CAL?");
GpibRead(readBuf, MAX_BUF);
printf("*CAL? result = %s\n", readBuf);
GpibWrite("CHPower:BANDwidth:INTegration 300kHz");
GpibWrite("SPECtrum:AVERage ON");
Figure 1-4: Sample program (Visual C++ source code)
WCA230A & WCA280A Programmer Manual
1-3
Getting Started
Connecting the Interface
The analyzer has a 24-pin GPIB connector on its rear panel, as shown in
Figure 1–5. This connector has a D-type shell and conforms to IEEE Std
488.1–1987.
Attach an IEEE Std 488.1-1987 GPIB cable (Tektronix part number
012-0991-00) to this connector.
GPIB connector
1-4
Figure 1-5: GPIB connector (rear panel)
Appendix B: GPIB Interface Specifications gives more information on the GPIB
configuration of the analyzer.
For the other interfaces, refer to the WCA230A and WCA280A User Manual.
WCA230A & WCA280A Programmer Manual
Using the GPIB Port
Getting Started
The analyzer has Talker/Listener functions through which it can communicate
with other devices, as well as the external controller, located on the bus.
GPIB
Controller Using the analyzer as a talker or listener
Figure 1-6: GPIB connection
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 as shown
in Figure 1–7. Do not use loop or parallel configurations.
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
GPIB Device
Figure 1-7: Typical GPIB network configurations
WCA230A & WCA280A Programmer Manual
GPIB Device
1-5
Getting Started
Setting the GPIB Parameters from the Front Panel
Set the GPIB parameters as required for the bus configuration. Once you have set
the parameters, you can control the analyzer through the GPIB interface.
1. Press the SYSTEM key in the UTILITY block.
SYSTEM key
2. Press the Remote Setup... side key.
3. Press the Remote Interface side key to select On.
4. Press the side key GPIB Setup...→ GPIB Address and set the address
using either the general purpose knob or the numeric keypad.
The range is 0 to 30 (factory default setting: 1).
NOTE. The GPIB address cannot be initialized with *RST command.
Remote Setup menu
Remote Interface
Selects whether the connection
between the analyzer and GPIB
is turned on or off.
GPIB Setup...
Sets the GPIB parameters
such as address.
1-6
Figure 1-8: Setting the GPIB parameters
WCA230A & WCA280A Programmer Manual
Getting Started
To disconnect the analyzer from the bus:
H Press the Remote Interface side key to select Off.
When the analyzer is disconnected from the bus, all the communication
processes with the controller are interrupted.
WCA230A & WCA280A Programmer Manual
1-7
Getting Started
1-8
WCA230A & WCA280A Programmer Manual
Syntax and Commands
Command Syntax
This section contains information on the Standard Commands for Programmable
Instruments (SCPI) and IEEE 488.2 Common Commands you can use to
program your WCA230A/WCA280A analyzer. The information is organized in
the following subsections:
H Backus-Naur Form Definition
H SCPI Commands and Queries
H IEEE 488.2 Common Commands
H Constructed Mnemonics
BackusĆNaur Form Definition
This manual may describe 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
WCA230A & WCA280A Programmer Manual
2-1
Command Syntax
SCPI Commands and Queries
SCPI is a standard created by a consortium that provides guidelines for remote
programming of instruments. These guidelines provide a consistent programming environment for instrument control and data transfer. This environment
uses defined programming messages, instrument responses, and data format
across all SCPI instruments, regardless of manufacturer. The analyzer uses a
command language based on the SCPI standard.
The SCPI language is 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.
TRIGger
SEQuence
POLarity
SOURceLEVel
Root node
LowerĆlevel nodes
Figure 2-1: Example of SCPI 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.
2-2
WCA230A & WCA280A Programmer Manual
Command Syntax
Creating Commands
Creating Queries
Query Responses
SCPI commands are created by stringing together the nodes of a subsystem
hierarchy and separating each node by a colon.
In Figure 2–1, TRIGger is the root node and SEQuence, LEVel, POLarity, and
SOURce are lower-level nodes. To create a SCPI command, start with the root
node TRIGger 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. If you specify a parameter value that
is out of range, the parameter will be set to a default value. The command
descriptions, which start on page 2–35, list the valid values for all parameters.
For example, TRIGger:SEQuence:SOURce EXT is a valid SCPI command
created from the hierarchy tree in Figure 2–1.
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. TRIGger:SEQuence:SOURce? is an
example of a valid SCPI query using the hierarchy tree in Figure 2–1.
The query causes the analyzer to return information about its status or settings.
When a query is sent to the analyzer, only the values are returned. When the
returned value is a mnemonic, it is noted in abbreviated format, as shown in
Table 2–2.
Table 2-2: Query response examples
Query Response
:DISPlay:OVIew:SGRam:X:SPAN? 10.0E+6
:SENSe:AVERage:TYPE? RMS
A few queries also initiate an operation action before returning information. For
example, the *CAL? query runs a calibration.
WCA230A & WCA280A Programmer Manual
2-3
Command Syntax
Parameter Types
Every parameter in the command and query descriptions is of a specified type.
The parameters are enclosed in brackets, such as <value>. The parameter type is
listed after the parameter and is enclosed in parentheses, for example, (discrete).
Some parameter types are defined specifically for the WCA200 Series command
set and some are defined by ANSI/IEEE 488.2-1987 (refer to Table 2–3).
Table 2-3: Parameter types used in syntax descriptions
Parameter type Description Example
arbitrary block
boolean Boolean numbers or values ON or 1; OFF or 0
discrete A list of specific values MIN, MAX, UP, DOWN
binary Binary numbers #B0110
octal Octal numbers #Q57, #Q3
hexadecimal
2,3
NR1
1
A specified length of arbitrary data #512234xxxxx . . .
where 5 indicates that the followĆ
ing 5 digits (12234) specify the
length of the data in bytes;
xxxxx ... indicates the data
2
Hexadecimal numbers
#HAA, #H1
(0-9, A, B, C, D, E, F)
numeric Integers 0, 1, 15, -1
NR22numeric Decimal numbers 1.2, 3.141516, -6.5
NR32numeric Floating point numbers 3.1415E-9, -16.1E5
NRf2numeric Flexible decimal number that may
be type NR1, NR2 or NR3
4
string
Alphanumeric characters
See NR1, NR2, and NR3 examĆ
ples
Testing 1, 2, 3"
(must be within quotation marks)
1
Defined in ANSI/IEEE 488.2 as Definite Length Arbitrary Block Response Data."
2
An ANSI/IEEE 488.2-1992Ćdefined parameter type.
3
Some commands and queries will accept an octal or hexadecimal value even though
the parameter type is defined as NR1.
4
Defined in ANSI/IEEE 488.2 as String Response Data."
2-4
WCA230A & WCA280A Programmer Manual
Command Syntax
SCPIĆdefined Parameters. In addition to the ANSI/IEEE 488.2-1987-defined
parameters, WCA200 Series support the following SCPI-defined parameters.
H <NRf> for boolean
OFF|ON|0|1|<NRf>
You can use <NRf> for boolean parameter. The values other than zero (OFF)
are regarded as one (ON).
H MAXimum and MINimum for numeric parameters
You can use MAXimum and MINimum for the numeric parameter <NRf>.
The following example sets the trigger level to the maximum (100%).
:TRIGger[:SEQuence]:LEVel:IF MAXimum
The commands that have numeric parameters support the following query:
<header>? { MAXimum | MINimum }
The query command returns the maximum or minimum acceptable value for
the command. For example,
:TRIGger[:SEQuence]:LEVel:IF? MAXimum
returns 100 indicating the maximum trigger level is 100%.
H UP and DOWN for numeric parameters
The [:SENse]:FREQuency:CENTer command (refer to page 2–259) supports
UP and DOWN for the numeric parameters. The increment/decrement of
UP/DOWN is determined by one of these commands:
[:SENse]:FREQuency:CENTer:STEP:AUTO
[:SENse]:FREQuency:CENTer:STEP[:INCRement]
WCA230A & WCA280A Programmer Manual
2-5
Command Syntax
Special Characters
Abbreviating Commands,
Queries, and Parameters
The Line Feed (LF) 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.
You can abbreviate most SCPI commands, queries, and parameters to an
accepted short form. This manual shows these short forms as a combination of
upper and lower case letters. The upper case letters indicate the accepted short
form of a command. As shown in Figure 2–2, you can create a short form by
using only the upper case letters. The accepted short form and the long form are
equivalent and request the same action of the instrument.
Long form of a command
Accepted short form of a
command and parameter
ulate3:MARKer:Y 50
:CALC
Minimum information needed for
accepted short form
CALC3:MARK:Y 50
Figure 2-2: Example of abbreviating a command
NOTE. The numeric suffix of a command or query may be included in either the
long form or short form; the analyzer will default to “1” if no suffix is used. In
Figure 2–2, the “3” of “CALC3” indicates that the command is directed to
View 3.
2-6
WCA230A & WCA280A Programmer Manual
Loading...