ThinkRF R5700 Manuale
ThinkRF R5700
Real-Time Spectrum Analyzer
with GNSS
Programmer's Guide
Version 1 0 0
October 20, 2018
Document no 75-0033-181020
Copyright © 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 R5700 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-5104
HARDWARE WARRANTY AND LI ITATION OF LIABILITY
Read this warranty carefully before you use the product.
R5700 Real Time Spectrum Analyzers with GNSS 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-5104) 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
GNU General Public License
This device contains free firmware: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, either version 2 of the License, or (at your option) any later version
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE See the GNU General Public License
for more details GNU General Public License is available at
http://www gnu org/licenses
Table of Contents
Abbreviations ................................................................................................................................... 7
List of Figures .................................................................................................................................. 8
List of Tables .................................................................................................................................... 9
Preface ............................................................................................................................................... 10
Audience ................................................................................................................................... 10
Conventions ............................................................................................................................ 10
Obtaining Documentation and Releases .......................................................................... 10
Document Feedback .............................................................................................................. 11
Obtaining Technical Assistance ......................................................................................... 11
R5700 Functional Overview .................................................................................................... 12
System Overview .................................................................................................................... 12
The Architecture ..................................................................................................................... 15
RF Receiver Front-End .......................................................................................................... 17
Direct-Conversion Receiver Technology 17
DC Offset Correction 17
IQ Offset Correction 18
Digital Signal Processing ..................................................................................................... 19
Digital Down Converter 19
Triggers .................................................................................................................................... 20
Frequency Domain Triggering 20
Periodic Triggering 21
External Triggering 21
Capture Controller ................................................................................................................. 22
Trace Capture Control 22
Sweep Capture Control 23
Synchronized Sweep 24
VITA-49 Radio Transport Protocol ...................................................................................... 26
Purpose .................................................................................................................................... 26
R5700's VRT Overview .......................................................................................................... 26
Packet Classes and Streams ............................................................................................... 27
Receiver Context Packet Class 27
Context Field Change Indicator 29
RF Reference Frequency 29
Gain 29
Temperature 29
Digitizer Context Packet Class 30
Context Field Change Indicator 31
Bandwidth 31
RF Frequency Offset 31
Reference Level 32
Formatted GPS Geolocation 32
Extension Context Packet Class 34
Context Field Change Indicator 35
IQ Swapped Indicator 35
New Stream Start ID 36
New Sweep Start ID 36
IF Data Packet Class 36
Picosecond Timestamp Words Format 37
Data Payload Format 37
Trailer Word Format 39
SCPI Command Set ..................................................................................................................... 42
SCPI Language Overview ..................................................................................................... 42
IEEE andated SCPI Commands ....................................................................................... 43
*CLS 43
*ESE/*ESE? 43
*ESR? 44
*IDN? 44
*OPC/*OPC? 44
*RST 44
*SRE/*SRE? 45
*STB? 45
*TST? 45
*WAI 46
SYSTem Commands .............................................................................................................. 46
:SYSTem:ABORt 46
:SYSTem:CAPTure:MODE? 46
:SYSTem:COMMunicate:HISLip:SESSion? 46
:SYSTem:COMMunicate:LAN:APPLy 47
:SYSTem:COMMunicate:LAN:CONFigure 47
:SYSTem:COMMunicate:LAN:DNS 48
:SYSTem:COMMunicate:LAN:GATEway 48
:SYSTem:COMMunicate:LAN:IP 49
:SYSTem:COMMunicate:LAN:MTU 49
:SYSTem:COMMunicate:LAN:NETMask 50
:SYSTem:COMMunicate:NTP 50
:SYSTem:ERRor[:NEXT]? 50
:SYSTem:ERRor:ALL? 51
:SYSTem:ERRor:CODE[:NEXT]? 51
:SYSTem:ERRor:CODE:ALL? 52
:SYSTem:ERRor:COUNt? 52
:SYSTem:FLUSh 52
:SYSTem:LOCK:HAVE? 53
:SYSTem:LOCK:REQuest? 53
:SYSTem:OPTions? 54
:SYSTem:SYNC:MASTer 54
:SYSTem:SYNC:WAIT 55
:SYSTem:VERSion? 55
:SYSTem:DATE 55
:SYSTem:TIME 56
:SYSTem:TIME:ADJust 56
:SYSTem:TIME:SYNC 56
STATus Commands ............................................................................................................... 58
:STATus:OPERation[:EVENt]? 59
:STATus:OPERation:CONDition? 59
:STATus:OPERation:ENABle 60
:STATus:OPERation:NTRansition 60
:STATus:OPERation:PTRansition 60
:STATus:PRESET 61
:STATus:QUEStionable[:EVENt]? 61
:STATus:QUEStionable:CONDition? 61
:STATus:QUEStionable:ENABle 62
:STATus:QUEStionable:NTRansition 62
:STATus:QUEStionable:PTRansition 62
:STATus:TEMPerature? 63
INPut Commands ................................................................................................................... 63
:INPut:ATTenuator 63
:INPut:ATTenuator:VARiable 63
:INPut:GAIN 64
:INPut:GAIN:HDR 65
:INPut:MODE 65
SOURce Commands .............................................................................................................. 66
:SOURce:REFerence:PLL 66
:SOURce:REFerence:PPS 66
SENSe Commands ................................................................................................................. 67
[:SENSe]:DECimation 67
[:SENSe]:FREQuency:CENTer 68
[:SENSe]:FREQuency:IF? 69
[:SENSe]:FREQuency:INVersion? 69
[:SENSe]:FREQuency:LOSCillator? 69
[:SENSe]:FREQuency:SHIFt 70
[:SENSe]:LOCK:REFerence? 70
[:SENSe]:LOCK:RF? 71
GNSS Commands ................................................................................................................... 71
:GNSS[:ENABle] 71
:GNSS:POSition 72
:GNSS:REFerence? 72
TRIGger Commands .............................................................................................................. 72
:TRIGger:TYPE 73
:TRIGger:LEVel 73
:TRIGger:PERiodic 74
TRACe Commands ................................................................................................................. 74
:TRACe:BLOCk:DATA? 75
:TRACe:BLOCk:PACKets 76
:TRACe:SPPacket 76
:TRACe:STReam:STARt 77
:TRACe:STReam:STOP 78
SWEep Commands ................................................................................................................ 78
:SWEep:LIST:ITERations 79
:SWEep:LIST:STARt 79
:SWEep:LIST:STATus? 80
:SWEep:LIST:STOP 80
:SWEep:ENTRy:COPY 80
:SWEep:ENTRy:COUNt? 81
:SWEep:ENTRy:DELETE 81
:SWEep:ENTRy:NEW 81
:SWEep:ENTRy:READ? 82
:SWEep:ENTRy:SAVE 82
:SWEep:ENTRy:ATTenuator 82
:SWEep:ENTRy:ATTenuator:VARiable 83
:SWEep:ENTRy:DECimation 83
:SWEep:ENTRy:FREQuency:CENTer 83
:SWEep:ENTRy:FREQuency:STEP 83
:SWEep:ENTRy:FREQuency:SHIFt 84
:SWEep:ENTRy:GAIN:HDR 84
:SWEep:ENTRy:MODE 84
:SWEep:ENTRy:DWELl 84
:SWEep:ENTRy:PPBlock 85
:SWEep:ENTRy:SPPacket 85
:SWEep:ENTRy:TRIGger:LEVel 85
:SWEep:ENTRy:TRIGger:TYPE 85
Appendix A: Connecting to RTSA ...................................................................................... 86
Simple 2-port TCP/IP Connection ....................................................................................... 86
Connection Using HiSLIP ..................................................................................................... 87
Appendix B: Protocols for Discovering RTSA ............................................................. 90
Discovery Using mDNS/DNS-SD ........................................................................................ 90
Discovery Using Broadcast UDP ........................................................................................ 90
Appendix C: SCPI Command Syntax ................................................................................ 92
Entering Commands .............................................................................................................. 92
Notation .................................................................................................................................... 93
Parameter types ...................................................................................................................... 93
Default Units ............................................................................................................................ 93
Appendix D: SCPI Status and Event Registers ........................................................... 95
Status Byte Register (SBR) .................................................................................................. 95
Standard Event Status Register (ESR) .............................................................................. 95
Operational Status Register (OSR) .................................................................................... 96
Questionable Status Register (QSR) ................................................................................. 96
Output Queue .......................................................................................................................... 97
Error and Event Queue ......................................................................................................... 97
Appendix E: SCPI Error Codes Used ................................................................................ 98
Appendix F: SCPI Commands Quick Reference ......................................................... 99
R5500 vs. R5700 List of Changes ...................................................................................... 105
References ..................................................................................................................................... 106
Document Revision History ................................................................................................. 107
Abbreviations
ADC Analog-to-Digital Converter
API Application Programming Interface
CIC Cascaded Integrator-Comb
DC Direct Current
DD Direct Digitizer
DDC Digital Down Converter
DDS Direct Digital Synthesizer
DSP Digital Signal Processing
FFT Fast Fourier Transform
FIR Finite Impulse Response
FPGA Field-Programmable Gate Array
GNSS Global Navigation Satellite System
GPIO General Purpose Input/Output
GPS Global Positioning System
GUI Graphical User Interface
HDR High Dynamic Range
IBW Instantaneous Bandwidth
IEEE Institute of Electrical and Electronics Engineers
IF Intermediate Frequency
IQ In-phase and Quadrature
LAN Local Area Network
B Mega-Bytes
SB Most Significant Byte
Sa Mega-Samples
NB Narrowband
NCO Numerically Controlled Oscillator
NTP Network Time Protocol
NTPD Network Time Protocol Daemon
PLL Phase-Locked Loop
RF Radio Frequency
RFE Receiver Front-End
RTSA Real Time Spectrum Analyzer
Sa/s Samples-per-Second
SCPI Standard Commands for Programmable Instruments
SH Super-Heterodyne
SHN Super-Heterodyne with narrower bandwidth
TCP/IP Transmission Control Protocol/Internet Protocol
TD Time Domain
TSF TimeStamp-Fractional
TSI TimeStamp-Integer
TS TimeStamp Mode
UTC Coordinated Universal Time
VCO Voltage Control Oscillator
VRT VITA-49 Radio Transport
WB Wideband
ZIF Zero Intermediate Frequency
List of Figures
Figure 1: R5700 Functional Block Diagram 13
Figure 2: RF Receiver Front-end and Capture Controller Functional Block Diagram 16
Figure 3: DC Offset with Amplitude Roll-Off at +50MHz 18
Figure 4: IQ Offset Correction 18
Figure 5: DDC Functional Block Diagram 20
Figure 6: Association between Time and Frequency Domain 21
Figure 7: Synchronized Sweep using Sync-Word 25
Figure 8: Synchronized Sweep with a Missed Capture 25
Figure 9: Connectivity and 4 Different Packet Streams Supported by R5700 26
Figure 10: An Example Illustrating Uninverted and Inverted Spectrums 41
Figure 11: SCPI Language Hierarchical or Tree Structure Example 42
Figure 12: SCPI Measurement Function Block 43
Figure 13: Status Reporting Structure with Status & Enable Registers 58
Figure 14: 2-port TCP/IP connection to RTSA 86
Figure 15: HiSLIP and TCP connections to RTSA 88
List of Tables
Table 1: System Level Control/Status Commands with GNSS 14
Table 2: Radio RFE Modes and DSP Data Output Formats 16
Table 3: RF Front-End Control/Status Commands 18
Table 4: Trigger Control/Status Commands 21
Table 5: Trace Capture Control Commands 23
Table 6: Sweep Capture Control/Status Interface 23
Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's R5700 26
Table 8: A List of Stream Identifiers As Used by ThinkRF for Different Packet Classes 27
Table 9: Receiver Context Packet Class Structure 28
Table 10: Receiver Context Indicator Field Positions 28
Table 11: Receiver Context Field Definition and Values 28
Table 12: RF Reference Frequency Word Format 29
Table 13: Gain Field Format 29
Table 14: Temperature Field Format 29
Table 15: Digitizer Context Packet Class Structure 30
Table 16: Digitizer Context Indicator Field Bit Positions 30
Table 17: Digitizer Context Field Values 31
Table 18: Bandwidth Word Format 31
Table 19: RF Frequency Offset Word Format 32
Table 20: Reference Level Field Format 32
Table 21: Formatted GPS Geolocation Fields 33
Table 22: Geolocation Angle (Degrees) Format 33
Table 23: Altitude Subfield Format 34
Table 24: Speed Over Ground Subfield Format 34
Table 25: Extension Context Packet Class Structure 34
Table 26: Extension Context Indicator Field Positions 35
Table 27: Extension Context Field Definition and Values 35
Table 28: New Stream Start ID Field Format 36
Table 29: New Sweep Start ID Field Format 36
Table 30: Output Data Width and Packing Method for Different Data Formats 36
Table 31: IF Data Class Field Values 37
Table 32: Stream Identifier Values for Different Data Output Formats 37
Table 33: 64-bit or Two Words Picosecond Timestamp Format 37
Table 34: {I14Q14} Data Payload Arrangement with Upper 2-bit Signed Extended to {I16 Q16} 38
Table 35: {I14} Data Payload Arrangement with Upper 2-bit Signed Extended to {I16} 38
Table 36: {I24} Data Payload Arrangement with Upper 8-bit Signed Extended to {I32} 39
Table 37: Trailer Word Format 39
Table 38: Trailer Indicator and Enable Bits 39
Table 39: Conditions Causing Abnormal Indicator State and Suggested Resolution 40
Table 40: RTSA Option Codes and the Corresponding Description 54
Table 41: Performance of The Gain Settings of R5700-418, 427 and Their Variants 64
Table 42: Maximum Threshold Level Where +/-3 dBm Error or Less Still Hold For A Given Attenuation
Level 74
Table 43: Max, Min, and Required Multiples for SPP and Samples-per-word for Different Data Output
Format 77
Table 44: HiSLIP Message Header Format 88
Table 45: ThinkRF Vendor Specific Message Type Value Definitions 89
Table 46: ThinkRF Data Channel Initialization Transaction 89
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 R5700 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
Obtaining Documentation and Releases
You can access the most current ThinkRF documentation and the latest release bundles
at http://www thinkrf com/resources
Altri manuali per R5700
2
Questo manuale è adatto per i seguenti modelli
2
Indice
Altri manuali ThinkRF Strumento di misura
ThinkRF
ThinkRF R5500 Manuale
ThinkRF
ThinkRF R5500 Manuale
ThinkRF
ThinkRF R5700 Manuale utente
ThinkRF
ThinkRF WSA5000 Series Manuale
ThinkRF
ThinkRF R5750 Manuale utente
ThinkRF
ThinkRF R5550 Manuale utente
ThinkRF
ThinkRF WSA5000 Series Manuale utente
ThinkRF
ThinkRF R5500 Manuale utente
ThinkRF
ThinkRF R5700 Manuale
