ThinkRF D2030 Manuale
D2030
30 GHz Downconverter
Programmer's Guide
Version 1.2.1
Mar 2018
Document no. 7 -0070-180301
Copyright © 2017,2018 ThinkRF Corporation, all rights reserved.
All product names are trademarks of their respective companies.
This document contains information that is proprietary to ThinkRF Corporation.
Important notice
The information in this
guide is furnished for
informational use only
and is subject to change
without notice. ThinkRF
Corporation assumes no
responsibility or liability
for any errors or
inaccuracies that may
appear in this document.
No part of this
publication may be
reproduced, published,
stored in an electronic
database, or transmitted,
in any form or by any
means, electronic,
mechanical, recording,
or otherwise, for any
purpose, without the
prior written permission
of ThinkRF Corporation.
Trademarks
ThinkRF, the ThinkRF
logo and D2030 are
trademarks of ThinkRF
Corporation.
All other brand or
product names are
trademarks or registered
trademarks of their
respective companies or
owners.
ThinkRF Corp
390 March Road
Kanata, ON K2K 0G7
(613) 369- 104
HARDWARE WARRANTY AND LI ITATION OF LIABILITY
Read this warranty carefully before you use the product.
D2030 30 GHz Downconverters are warranted for workmanship and materials for a
period of one (1) year from the date of shipment as identified by the Customer’s
packing slip or carrier waybill. ThinkRF reserves the right to void the warranty on any
equipment that has been altered or damaged due to Customer negligence,
unauthorized repair, misuse of equipment, evidence of physical or environmental
damage, transportation abuse or removal of any ThinkRF identification labels or
serial numbers.
It will remain the responsibility of the Customer, having obtained a Return Material
Authorization (RMA) and shipping instructions from ThinkRF, to return, at the
Customer's expense, the defective unit to ThinkRF’s repair facilities. ThinkRF will
incur shipping charges for the return of warranty repaired equipment. The RMA
number can be secured by calling ThinkRF Customer Service and Support (1-613-
369- 104). If the product does not fall within ThinkRF’s warranty period or the
product is found to be functioning as designed, then under the terms of ThinkRF’s
warranty policy, all costs of repairs and shipping will be charged directly to the
Customer. ThinkRF will warrant repaired units for a period of 90 days from date of
shipment from ThinkRF to the Customer. If the remaining period on the original
hardware warranty is greater than 30 days, then ThinkRF will honor this remaining
warranty period.
THINKRF EXPRESSLY DISCLAIMS ALL OTHER WARRANTIES AND
CONDITIONS, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT
LIMITATION, WARRANTIES, CONDITIONS OR REPRESENTATIONS OF
WORKMANSHIP, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, DURABILITY, OR THAT THE OPERATION OF THE HARDWARE OR
LICENSED SOFTWARE WILL BE ERROR FREE. IN NO EVENT WILL THINKRF
BE LIABLE FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES.
USE OF PRODUCTS IN HIGH RISK ACTIVITIES
THINKRF PRODUCTS ARE INTENDED FOR STANDARD INDOOR COMMERCIAL
USE. WITHOUT THE APPROPRIATE NETWORK DESIGN ENGINEERING, THEY
MUST NOT BE USED FOR ANY “HIGH RISK ACTIVITY”, as described in this
paragraph. Customer acknowledges and agrees that the products supplied
hereunder are not fault-tolerant and are not designed, manufactured or intended for
use or resale as on-line control equipment in hazardous environments requiring fail
safe performance including but not limited to the operation of nuclear facilities,
aircraft navigation or communication systems, air traffic control, direct life support
machines, or weapons systems, in which the failure of products could lead directly to
death, personal injury, or severe physical or environmental damage, all of which are
examples of “High Risk Activity”. THINKRF AND ITS SUPPLIERS EXPRESSLY
DISCLAIM ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR HIGH
RISK ACTIVITIES.
Table of Contents
Abbreviations ................................................................................................................................... 5
List of Figures .................................................................................................................................. 6
List of Tables .................................................................................................................................... 6
Preface ................................................................................................................................................. 7
Audience .................................................................................................................................... 7
Conventions .............................................................................................................................. 7
Obtaining Documentation and Releases ............................................................................ 8
Document Feedback ................................................................................................................ 8
Obtaining Technical Assistance ........................................................................................... 8
D2030 Functional Overview ...................................................................................................... 9
System Overview ...................................................................................................................... 9
RF Receiver Front-End .......................................................................................................... 10
SCPI Command Set ..................................................................................................................... 12
SCPI Language Overview ..................................................................................................... 12
IEEE andated SCPI Commands ....................................................................................... 13
*CLS .................................................................................................................................... 13
*ESE/*ESE? ........................................................................................................................ 13
*ESR? .................................................................................................................................. 13
*IDN? ................................................................................................................................... 14
*OPC/*OPC? ....................................................................................................................... 14
*RST .................................................................................................................................... 14
*SRE/*SRE? ........................................................................................................................ 1
*STB? .................................................................................................................................. 1
*TST? .................................................................................................................................. 1
*WAI .................................................................................................................................... 16
SYSTem Commands .............................................................................................................. 16
:SYSTem:COMMunicate:LAN:APPLy .................................................................................. 16
:SYSTem:COMMunicate:LAN:CONFigure .......................................................................... 16
:SYSTem:COMMunicate:LAN:GATEway ............................................................................ 17
:SYSTem:COMMunicate:LAN:IP ......................................................................................... 17
:SYSTem:COMMunicate:LAN:NETMask ............................................................................. 18
:SYSTem:ERRor[:NEXT]? ................................................................................................... 18
:SYSTem:ERRor:ALL? ........................................................................................................ 19
:SYSTem:OPTions? ............................................................................................................ 19
:SYSTem:VERSion? ............................................................................................................ 19
STATus Commands ............................................................................................................... 20
Status Reporting Structures ................................................................................................. 20
:STATus:OPERation[:EVENt]? ............................................................................................ 23
:STATus:OPERation:CONDition? ........................................................................................ 23
:STATus:OPERation:ENABle .............................................................................................. 24
:STATus:OPERation:NTRansition ....................................................................................... 24
:STATus:OPERation:PTRansition ....................................................................................... 24
:STATus:PRESET ............................................................................................................... 2
:STATus:QUEStionable[:EVENt]? ....................................................................................... 2
:STATus:QUEStionable:CONDition? ................................................................................... 2
:STATus:QUEStionable:ENABle .......................................................................................... 26
:STATus:QUEStionable:NTRansition .................................................................................. 26
:STATus:QUEStionable:PTRansition ................................................................................... 26
:STATus:TEMPerature? ...................................................................................................... 27
INPut Commands ................................................................................................................... 27
:INPut:DCONverter:MANual:FILTer:PRESelect .................................................................. 27
:INPut:GAIN ......................................................................................................................... 27
SENSe Commands ................................................................................................................. 28
[:SENSe]:DCONverter:MANual:LO<1|2>:FREQuency ........................................................ 28
[:SENSe]:DCONverter:MANual:MIX2 .................................................................................. 28
[:SENSe]:FREQuency:CENTer ........................................................................................... 28
[:SENSe]:REFerence:PLL ................................................................................................... 29
OUTPut Commands ............................................................................................................... 29
:OUTPut:DCONverter:MANual:ATTenuation ....................................................................... 29
:OUTPut:FILTer:BPASs:BANDwidth? .................................................................................. 30
:OUTPut:FILTer:BPASs:FREQuency? ................................................................................ 30
:OUTPut:IF:FREQuency? .................................................................................................... 30
Appendix A: Booting up and Connecting to the D2030 .......................................... 31
Bootup Sequence ................................................................................................................... 31
Connecting to D2030 ............................................................................................................. 31
SCPI Raw ............................................................................................................................ 31
SCPI Telnet ......................................................................................................................... 32
HiSLIP ................................................................................................................................. 32
Code Example of TCP/IP Connection and SCPI Control .............................................. 33
Appendix B: SCPI Command Syntax ................................................................................ 40
Entering Commands .............................................................................................................. 40
Notation .................................................................................................................................... 41
Parameter types ...................................................................................................................... 41
Default Units ............................................................................................................................ 42
Appendix C: SCPI Status and Event Registers ........................................................... 43
Status Byte Register (SBR) .................................................................................................. 43
Standard Event Status Register (ESR) .............................................................................. 43
Operational Status (OSR) Register .................................................................................... 44
Questionable Status (QSR) Register ................................................................................. 44
Output Queue .......................................................................................................................... 45
Error and Event Queue ......................................................................................................... 45
Appendix D: SCPI Error Codes Used ................................................................................ 46
Appendix E: SCPI Commands Quick Reference ........................................................ 47
References ....................................................................................................................................... 50
Document Revision History ................................................................................................... 51
Abbreviations
Abbreviations
ADC Analog-to-Digital Converter
API Application Programming Interface
HiSLIP Hi Speed LAN Instrument Protocol
IEEE Institute of Electrical and Electronics Engineers
IF Intermediate Frequency
LAN Local Area Network
SB ost Significant Byte
PLL Phase-Locked Loop
RF Radio Frequency
RFE Receiver Front-End
Downconverter 30 GHz Downconverter
SCPI Standard Commands for Programmable Instruments
TCP/IP Transmission Control Protocol/Internet Protocol
5 ThinkRF D2030 30 GHz Downconverter Programmer's Guide
Abbreviations
List of Figures
Figure 1: D2030 Interconnect Diagram with A Spectrum Analyzer ............................................................ 9
Figure 2: SCPI Language Hierarchical or Tree Structure Example .......................................................... 12
Figure 3: SCPI Downconverter Instrument Model .................................................................................... 13
Figure 4: Status Reporting Structure with Status & Enable Registers ...................................................... 21
Figure 5: SDS Register Model ................................................................................................................. 22
List of Tables
Table 1: System Level Control/Status Commands ................................................................................... 10
Table 2: RF Front-End Control/Status Commands .................................................................................. 11
Table 3: Downconverter Option Codes and the Corresponding Description ............................................ 19
ThinkRF D2030 30 GHz Downconverter Programmer's Guide 6
Preface
Preface
This preface describes the audience for, the organization of, and conventions used in this
document. It also identifies related documentation and explains how to access electronic
documentation.
Audience
This document is written for software developers wishing to develop and/or maintain a
software interface to the D2030 and who have a basic understanding, familiarity and
experience with network test and measurement equipment.
Conventions
This section describes the conventions used in this document.
Grayed-out Font
Indicates a command or a feature is not yet available in the current release.
Courier Font
Illustrates this is an example for a command or a concept.
Light Blue Font
Contains hyperlink to the referenced source that can be clicked on.
Normal Bold Font
When used within a sentence or a paragraph, it emphasizes an idea to be paid attention
to particularly.
Red Font
Conveys special information of that section.
Note: This symbol means take note. Notes contain helpful suggestions or references to
additional information and material.
Caution: This symbol means be careful. In this situation, you might do something that
could result in equipment damage or loss of data.
Warning: This symbol means danger. You are in a situation that could cause bodily
injury. Before you work on any equipment, be aware of the hazards involved with
electrical circuitry and be familiar with the standard practices for preventing accidents.
7 ThinkRF D2030 30 GHz Downconverter Programmer's Guide
Preface
Obtaining Documentation and Releases
You can access the most current ThinkRF documentation and the latest release bundles
at http://www.thinkrf.com/resources.
Document Feedback
Please send your comments about this document or our other documentation to
Thank you, we appreciate your comments.
Obtaining Technical Assistance
The ThinkRF Support website provides online documents for resolving technical issues
with ThinkRF products at http://www.thinkrf.com/resources.
For all customers who hold a valid end-user license, ThinkRF provides technical
assistance 9 AM to PM Eastern Time, Monday to Friday. Contact us at
[email protected] or by calling +1.613.369.5104.
Before contacting Support, please have the following information available:
•D2030's serial number which is located on the identification label on the D2030's
underside.
•The product version.
•The firmware version running on the D2030 (using *IDN? command).
•Versions of any ThinkRF software you are using.
•The operating system and version you are using.
ThinkRF D2030 30 GHz Downconverter Programmer's Guide 8
D2030 Functional Overview
D2030 Functional Overview
This section overviews the D2030's functionality and protocols used, and summarizes the
SCPI command sets for controlling the individual functions.
Note: This is a living and evolving document. We welcome your feedback.
The features and functionality described in this section may exist in the current product
firmware release or are scheduled for a future product firmware release (grayed out
commands and/or text). Please refer to Appendix E: SCPI Commands Quick Reference
for the complete list of commands and the availability information. No hardware upgrade
is required at each feature release (unless specified though unlikely).
System Overview
D2030 30 GHz Downconverter is used to convert RF signals in the range of 27-30 GHz
down to an intermediate frequency (IF) of 3. GHz or .6 GHz (determined by the
product Option code, see :SYSTem:OPTions?). This is designed to extend the
functionality of existing spectrum analyzers that operate to a maximum frequency of 4
GHz or 6 GHz, respectively, to measure and analyze G signals in the range of 27-30
GHz band. Figure 1 shows a simplify interconnect diagram with a spectrum analyzer.
Figure 1: D2030 Interconnect Diagram with A Spectrum Analyzer
ThinkRF's products conform with standardized protocols for interoperability. Standard
protocols include the Standard Commands for Programmable Instruments (SCPI)
protocol for controlling and obtaining status from the Downconverter.
Refer to Appendix A for how to connect to a Downconverter.
The D2030 provides system level control and status commands as defined in Table 1.
ThinkRF D2030 30 GHz Downconverter Programmer's Guide 9
D2030 Functional Overview
Table 1: System Level Control/Status Commands
SCPI Command Description
:SYSTem Page 16
:COMMunicate
:LAN<commands> Subset of commands for configuring/querying Downconverter's LAN
settings
:ERRor Returns the error code and messages from the SCPI error/event queue
[:NEXT]?
:OPTions? Returns comma separated 3-digit values to represent the hardware
option(s) or features available with a particular Downconverter model
:VERSion? Returns the SCPI version number that the instrument complies with
:STATus Page 20
:OPERation
[:EVENt]? Returns the standard Operation Status Register (OSR) and clears the
register
:CONDition? Returns the standard Operation Condition Register (OCR)
:ENABle[?] Sets or queries the Operation Status Enable Register (OSE)
:PRESET Presets the D2030 (similar to *RST)
:QUEStionable
[:EVENt]? Returns the Questionable Status Register (QSR) and clears the register
:CONDition? Returns the Questionable Condition Register (QCR)
:ENABle[?] Sets or queries the Questionable Status Enable Register (QSE)
:TEMPerature? Returns the D2030's internal ambient temperature
See SCPI Command Set section (page 12 onward) for further details on the commands.
Caution pertaining to multi-user: The current firmware version of the D2030 allows
multiple applications to connect to the unit simultaneously but it does not support
independent sessions. Therefore, the actions of one user may over-write those of
another. This could potentially damage the unit for instance if the front-end's gain were
incorrectly set. If multiple applications are connecting to the unit, it is advised that only
one of those is controlling the unit at any time.
RF Receiver Front-End
The receive front-end (RFE) has been largely defined through the hardware
specifications. The primary commands have to do with setting the center frequency of the
Downconverter and switching in the front-end gain for improved noise figure, ThinkRF
provides the user access to other blocks within the radio receiver. The command set is
defined in Table 2.
10 ThinkRF D2030 30 GHz Downconverter Programmer's Guide
Indice
