Agilent Technologies N9340B Manual


Agilent N9340B
Spectrum Analyzer
Programmer’s Guide

Notices
© Agilent Technologies, Inc. 2009-2010
No part of this manual may be reproduced
in any form or by any means (including
electronic storage and retrieval or
translation into a foreign language) without
prior agreement and written consent from
Agilent Technologies, Inc. as governed by
United States and international copyright
laws.
Edition
Second Edition, April. 2010
Agilent Technologies, Inc.
No. 116 Tuo Xin West 1st Street
Hi-Tech Industrial Zone (South)
Chengdu 610041, China
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.
Restricted Rights Legend
U.S. Government Restricted Rights.
Software and technical data rights granted
to the federal government include only
those rights customarily provided to end
user customers. Agilent provides this
customary commercial license in Software
and technical data pursuant to FAR 12.211
(Technical Data) and 12.212 (Computer
Software) and, for the Department of
Defense, DFARS 252.227-7015 (Technical
Data - Commercial Items) and DFARS
227.7202-3 (Rights in Commercial Computer
Software or Computer Software
Documentation).
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.
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.
Software Revision
This guide is valid for Version A.01.10 and
above of the N9340B handheld spectrum
anyalzer firmware.

N9340B Programmer’s Guide
In This Guide…
This guide contains programming information for the
N9340B Spectrum Analyzer.
1 Getting Started
Prepare for the remote control.
2 Programming Fundamentals
A quick overview of the SCPI programming.
3StatusRegisters
Introduction of the status registers.
4 Programming Example
How to accomplish the basic applications in programming.
5 Command Reference
Describe every programming command ant the related
softkeys’ functions in detail.
For more information about N9340B handheld spectrum
analyzer, please refer to
www.agilent.com/find/n9340b

N9340B Programmer’s Guide

N9340B Programmer’s Guide
Contents
1 Getting Started 1
Remotely Operating Your N9340B 2
2 Programming Fundamentals 9
Overview 10
Command Categories 12
Command Syntax 13
Creating Valid Commands 15
Program and Response Messages 16
Parameters in Commands 17
3StatusRegisters 19
Overview 20
How to use the Status Registers 23
Status Register System 25
4 Programming Example 31
Overview 32
Programming in C using the VTL 33
Checking USB Connection 39
Using C with Marker Peak Search and Peak Excursion 40
Using Marker Delta Mode and Marker Minimum Search 44
Measuring Phase Noise 48

N9340B Programmer’s Guide
Contents
5 Command Reference 51
IEEE Common Commands 52
CALCulate Subsystem 56
Limit Line Subsection 56
CALCulate:MARKer Subsection 57
DEMOdulation Subsystem 62
DISPlay Subsystem 63
INITiate Subsystem 65
INSTrument Subsystem 67
MEASure Subsystem 68
OBW Subsection 68
ACPR Subsection 69
Channel Power Subsection 71
SEM Subsection 72
SENSe Subsystem 81
[:SENSe]:AVERage Subsection 81
[:SENSe]:BANDwidth Subsection 82
[:SENSe]:DETector Subsection 85
[:SENSe]:FREQuency Subsection 87
[:SENSe]:POWer Subsection 89
[:SENSe]:SWEep Subsection 90
SYSTem Subsystem 92
TGENerator Subsystem 94
TRACe Subsystem 97
TRIGger Subsystem 98
UNIT Subsystem 100

s
Agilent N9340B Handheld Spectrum Analyzer
Programmer’s Guide
1
1
Getting Started
The purpose of this chapter is to serve as a reminder of
SCPI (Standard Commands for Programmable Instruments)
fundamentals to those who have previous experience in
programming SCPI. This chapter is not intended to teach
you everything about the SCPI programming language. If you
are using an optional programming compatibility modes, you
should refer to the manual that came with the option.

2 N9340B Programmer’s Guide
1 Getting Started
Remotely Operating Your N9340B
The N9340B provides both the USB and LAN connection
which allows you to set up a remote operation environment
with a controller computer. A controller computer could be a
personal computer (PC), a minicomputer. Some intelligent
instruments also function as controllers.
Computer Requirement for Remote Operation
Usually, you need to prepare an compatible PC with the
following requirements to set up a remote operation
environment:
Processor: 450 MHz Pentium®II or higher required
Operating system: Microsoft®Windows®XP or Home Editon,
Service Pack 1 or later; Windows®2000 Professional, service
pack 4 or later
Available memory: 128 MB or higher required
Available disk space: 175 MB or greater required

Getting Started 1
N9340B Programmer’s Guide 3
Connecting the N9340B to a PC via the USB Port
No extra driver is required to connect the N9340B via the
USB port to a PC. All you need is the Agilent IO libraries
suite and you can find this IO libraries suite in the
documentation CD in the shipment along with your N9340B.
Or download the IO libraries suite from Agilent website:
http://www.agilent.com/find/iolib
Refer to the following steps to finish the connection:
1Install Agilent IO libraries suite on your PC
2Switch on the N9340B
3Connect the analyzer to a PC with a USB cable.
Connecting instrument
Connecting PC

4 N9340B Programmer’s Guide
1 Getting Started
4After a while, the PC finds your N9340B as a new hardware
and prompts a message saying “Found new hardware...”. A
Found New Hardware Wizard is initiated immediately.
5Select Display a list...