GSG 05 - UserManual - PN4031 600 54001rev27 1
GSG 05 - UserManual - PN4031 600 54001rev27 1
User Manual
with SCPI Guide
orolia.com
© 2019 Orolia. All rights reserved.
The information in this document has been carefully reviewed and is believed to
be accurate and up-to-date. Orolia assumes no responsibility for any errors or
omissions that may be contained in this document, and makes no commitment
to keep current the information in this manual, or to notify any person or organ-
ization of updates. This User Manual is subject to change without notice. For
the most current version of this documentation, please see our web site at
orolia.com.
Orolia reserves the right to make changes to the product described in this doc-
ument at any time and without notice. Any software that may be provided with
the product described in this document is furnished under a license agreement
or nondisclosure agreement. The software may be used or copied only in accord-
ance with the terms of those agreements.
Warranty Information
CHAPTER 2
Setup 11
2.1 About Your Safety 12
2.1.1 Safety Precautions 12
2.1.2 Basic User Responsibilities 13
2.1.3 If in Doubt about Safety 13
2.2 Unpacking and Inventory 14
2.2.1 Unit Identification 14
2.3 Mechanical Installation 15
2.3.1 General Installation Considerations 15
2.4 Electrical Installation 22
2.5 Signal Power Level Considerations 24
2.5.1 Compliance: Using an Antenna 24
CHAPTER 3
Features & Functions 27
3.1 Front Panel 28
3.1.1 Description of Keys 28
3.1.1.1 Power 28
3.1.1.2 Start 28
3.1.1.3 Exit 29
3.1.1.4 Cancel 29
3.1.1.5 Menu 29
3.1.1.6 View 29
3.1.1.7 Enter 29
3.1.1.8 Arrows 30
3.1.1.9 N/S 30
3.1.1.10 E/W 30
3.1.1.11 Numeric Keys 30
3.1.1.12 +/– (format) 30
3.1.1.13 [.] (hold) 30
CHAPTER 4
Frequent Tasks 107
4.1 Working with Scenarios 108
4.1.1 Scenario Start/Stop/Hold/Arm 108
4.1.2 Running a Scenario 108
4.1.3 Holding a Scenario 109
4.1.4 Configuring a Scenario 109
4.2 Locking/Unlocking the Keyboard 112
4.3 Setting Transmit Power 113
4.4 Accessing the GSG Web Interface 115
4.5 Using the CLI 116
4.6 Performing a Receiver Cold Start 117
4.7 Creating a One-Line Trajectory 118
4.8 Leap Second Configuration 118
4.9 Studioview Tasks 120
4.9.1 What Is StudioView? 120
4.9.1.1 StudioView Tasks 120
4.9.1.2 StudioView Functionality Overview 121
4.9.2 Installing StudioView 122
4.9.3 Connecting StudioView to GSG 122
4.9.4 Updating the GSG Firmware via StudioView 124
4.9.5 Uploading StudioView Files 125
4.9.5.1 Using the StudioView Uploader for the First Time 125
4.9.6 Transferring Files With StudioView 127
4.9.7 Accessing GSG Remotely via StudioView 128
4.9.8 Creating a Trajectory in StudioView 130
4.9.9 Converting a Trajectory in StudioView 136
4.9.10 Improving a Trajectory 138
4.9.11 Creating an RSG Trajectory with StudioView 140
4.9.11.1 Using the RSG Trajectory Editor for the First Time 141
4.9.11.2 RSG Example: Racetrack Pattern 143
4.9.11.3 Kepler Orbit 145
CHAPTER 5
Reference 175
5.1 The GSG Web UI 176
5.2 Messages 176
5.3 Timing Calibration 182
5.4 NMEA Logging 183
5.5 Execution Log 183
5.6 Saving RINEX Data 184
5.7 YUMA Almanac File 185
5.8 RLS (Return Link Service) 186
5.8.1 SAR Data 186
5.8.2 Requirements 187
5.8.3 Simulating RLMs 187
5.9 Galileo E6-B/C Signal 188
5.10 Default Settings 188
5.11 Pre-Installed Scenarios 188
5.12 Default Scenario Satellites 190
5.12.1 GLONASS Default Satellite Types 190
5.13 Scenario File Format 191
CHAPTER 6
SCPI Guide 223
6.1 SCPI Guide: Introduction 224
6.2 Protocol 224
6.2.1 General Format of Commands 224
6.2.2 Protocol Errors 225
6.3 Command Reference 227
6.3.1 Common Commands 227
6.3.1.1 *CLS 227
6.3.1.2 *ESE 227
6.3.1.3 *ESR? 228
6.3.1.4 *IDN? 228
6.3.1.5 *OPC 230
6.3.1.6 *OPC? 231
6.3.1.7 *RST 231
6.3.1.8 *SRE 232
6.3.1.9 *SRE? 233
6.3.1.10 *STB? 233
6.3.1.11 *TST? 233
6.3.1.12 *WAI 234
6.3.2 SYSTem: Subsystem Commands 234
6.3.2.1 SYSTem:ERRor? 235
6.3.2.2 SYSTem:RESET:FACTory 236
6.3.3 SOURce: Subsystem Commands 236
6.3.3.1 SOURce:POWer 236
APPENDIX
Appendix i
7.1 Lists of Tables and Images ii
7.2 GSG User Manual Revision History iv
INDEX
8. Your GNSS receiver under test should see and track the generated signals. If the
receiver could successfully decode the navigation data included in the signals (this
process often takes approximately 40 seconds), the receiver will output the nav-
igation fix as specified in the selected scenario. This navigation solution should cor-
respond to the solution shown on the GSG-5/6 display.
1.2 Welcome
Orolia GSG-Series Signal Generators and GNSS Simulators are used to test GNSS receiv-
ers by generating GNSS signals, as they are transmitted by GNSS satellites. The signals are
transmitted via air (using an antenna; see "Signal Power Level Considerations" on
page 24), or via an RF cable.
Depending on the model, and the options installed in a GSG unit, generated/simulated sig-
nals, as well as user position, time and output power can be manipulated by the user either:
during the test, i.e. in real-time, via the GSG front panel, or
before beginning the test, by saving the programmed signal data (as well as tra-
jectory data, if the receiver is to be tested under virtual movement conditions) in
scenario files, using the optional StudioView™ software.
In addition to GNSS, other signals such as interference and multi-path can be generated to
test the sensitivity to various disruptions.
The number of channels installed in a GSG unit determines how many signals can be gen-
erated. If more channels are required than available, two or more GSG units can be syn-
chronized to generate 128, 256, or more signals.
Built-in trajectories (static, configurable circle, and rectangular as defined in 3GPP TS
25.171) or user-designed trajectories (in NMEA standard format) can be run on GSG sim-
ulators. Users can upload their own ephemeris data in standard RINEX format or re-use the
default data for any time periods. The GSG-6 Series is capable of automatically down-
loading historical RINEX, WAAS and EGNOS data from official websites, as needed.
The GSG-6 Series can be controlled via an Ethernet network connection, or USB or GPIB.
A built-in web interface allows remote operation of the instrument. With the optional GSG
StudioView™ PC Software, you can build, edit, and manage the most complex scenarios,
including building trajectories via Google Maps, independent of the GSG unit, for later
upload.
Besides the variety of built-in navigation/positioning tests, GSG units are also suited for
accurate testing of timing GNSS-receivers. The GSG-6 is equipped with an ultra-high-sta-
bility OCXO timebase for precision timing of the satellite data, or use external syn-
chronization from a 10 MHz reference from e.g. a Cesium or Rubidium clock. A built-in
1PPS output, synchronized to the generated satellite data, allows comparison with the
1PPS signal from the timing receiver under test.
Note: For more information about Signal Power Emissions , see "Signal
Power Level Considerations" on page 24.
In particular, this instrument has been designed and tested for Measurement Category I,
Pollution Degree 2, in accordance with EN/IEC 61010- 1:2001 and CAN/CSA- C22.2
No. 61010-1-04 (including approval). It has been supplied in a safe condition.
Limits:
Altitude: 18240 m (60000 feet)
Acceleration: 4.0 g
Velocity: 515 m/s (1000 knots)
Jerk: 20 m/s3
Extended limits:
Altitude: 20200 km
Acceleration
Velocity: 20000 m/s (38874 knots)
Jerk: No limit
White noise signal level:
-50 to -160 dBm
0.1 dB resolution down to -150 dBm
0.3 dB down to -160 dBm
±1.0 dB accuracy
Minimum PW: 10 ms
Active Edge: Falling
1/10/100/1000 PPS Output
Connector: BNC female
Output signal level: approx. 0V to +2.0 V in 50 Ω load
Accuracy: Calibrated to ±10 nSec of RF timing mark output
Transit Drop Test: Heavy-duty transport case and soft carrying case tested
according to MIL-PRF-28800F
Reliability: MTBF 30000 h, calculated
Safety: Designed and tested for Measurement Category I, Pollution Degree
2, in accordance with EN/IEC 61010-1:2001 and CAN/CSA-C22.2 No.
61010-1-04 (incl. approval)
EMC: EN 61326 (1997) A1 (1998), increased test levels per EN 50082-2,
Group 1, Class B, CE
Power Requirements
Line Voltage: 100-240 VAC, 50/60/400 Hz
Power Consumption: 40 W max.
Dimensions & Weight
Width: ½ x 19" (215 mm)
Height: 2U (90 mm)
Depth: 395 mm
Weight: Net 2.7 kg (5.8 lb)
Shipping: 3.5 kg (7.5 lb)
Unpack the equipment and inspect it for damage. If any equipment has been damaged in
transit, or you experience any problems during installation and configuration of your Orolia
product, please contact your closest Orolia Customer Service Center (see: "Technical Sup-
port" on page 207).
Note: Retain all original packaging for use in return shipments if necessary.
Orientation
GSG-Series units can be operated in any position, i.e. horizontal, vertical, or at any angle.
Cooling
The air flow through the side ventilation openings must not be obstructed.
Leave 5 cm (2") of space around the unit.
Bench-Top Setup
For bench-top use, a fold-down support is available for use underneath the GNSS Sim-
ulator. This support can also be used as a handle to carry the instrument.
Figure 2-2: Rack-Mount-Kit (the GSG housing shown in the center is not part of the kit)
In order to prepare the GSG unit for rack-mount installation, the housing needs to be
opened, in order to remove the bottom feet (otherwise the assembly will not fit in a 2U
slot.)
DANGER! Do not perform any work on the internal components of the unit,
while the housing is removed, unless you are qualified to do so. Before
removing the cover, unplug the power cord and wait for one minute to
allow any capacitors to discharge.
1. After making sure that the power cord has been unplugged, carefully turn the unit
upside down.
2. Temporarily remove the two rear feet by loosening their screws.
3. Remove the four housing screws and plugs (if present) at the side panels; discard
them.
4. Grip the front panel with one hand, while pushing at the rear with the other hand.
Pull the unit out of its housing.
5. Remove the four bottom feet from the housing, as shown in the illustration below:
Use a screwdriver or a pair of pliers to remove the springs holding each foot, then
Note: The unit can also be installed on the right-hand side of the rack
by reversing the two ears.
9. Depending on accessibility in your rack, you can connect the cables to the GSG unit
now, or after installation of the assembly in the rack. For electrical installation, see
"Electrical Installation" on page 22.
10. Install the assembly in your rack, using the M6 screws that came with the rack-
mount kit.
11. Complete the electrical installation.
In order to prepare the GSG units for rack mount installation, the housings needs to be
opened, in order to remove the bottom feet (otherwise the assembly will not fit in a 2U
slot.)
1. After making sure that the power cord has been unplugged, carefully turn the first
GSG unit upside down.
2. Remove the two rear feet. Keep the screws, discard the brackets.
3. Remove the four housing screws and plugs (if present) at the side panels, and dis-
card them.
4. Grip the front panel with one hand, while pushing at the rear with the other hand.
Pull the unit out of its housing.
5. Remove the four bottom feet from the housing, as shown in the illustration below:
Use a screwdriver or a pair of pliers to remove the springs holding each foot, then
push out the foot.
12. Pinch the hinge pins together into the stored position. Align the hinge halves
together between the two units, and swing together side by side. The hinge pins
should snap into place, securing the front of the two units.
13. In the back of the unit, take the supplied Hex Spacer (item no. 7), and place between
middle rear brackets, and secure using the supplied 8-mm screws (item no. 6).
14. Assembly is now ready for installation into standard 19" rack.
15. Depending on accessibility, you can complete the electrical installation before or
after installing the assembly in the rack. For electrical installation, see "Electrical
Installation" on page 22.
Note: This kit can also be used to install only one GSG unit in a 19" rack 2U
slot, similar to the optional Orolia 22/90 Rack-Mount Kit (P/N 9446-1002-
2901).
In order to prepare the GSG unit for rack mount installation, the housing needs to be
opened, in order to remove the bottom feet (otherwise the assembly will not fit in a 2U
slot.) The same may be necessary for the Agilent unit – follow the manufacturer's instruc-
tions.
1. After making sure that the power cord has been unplugged, carefully turn the GSG
unit upside down.
2. Temporarily remove the two rear feet by loosening their screws.
3. Remove the four housing screws and plugs (if present) at the side panels, and dis-
card them.
4. Grip the front panel with one hand, while pushing at the rear with the other hand.
Pull the unit out of its housing.
5. Remove the four bottom feet from the housing, as shown in the illustration below:
Use a screwdriver or a pair of pliers to remove the springs holding each foot, then
push out the foot.
Note: The instructions below are based on the assumption that the
GSG unit is installed on the left-hand side of the assembly.
9. Install the front assy plate to the Agilent unit, as shown in the illustration below. Use
the screws from the Agilent rack-mount kit.
Take two of the plastic snap caps from the GSG rack-mount kit, remove and discard
the caps, and install the sleeves into the housing screw openings.
Slide the Agilent unit and the GSG unit together, so that the protruding pins of the
front assy plate fit into the sleeves.
Figure 2-9: Front assembly plate installation Agilent unit (shown left), GSG unit
10. Install the rear assy plate, Agilent, and the rear assy plate, GSG, and assemble them,
as shown in the illustrations below.
11. Equivalent to Step 8., install the front panel ear plate (Agilent rack-mount kit) to the
Agilent power meter.
12. The assembly is now complete, and can be installed in the cabinet.
Supply Voltage
GSG Series simulators may be connected to any AC supply with a voltage rating of
100 to 240 V, at 50/60/400 Hz. The units automatically adjust themselves to the input
Fuse
The secondary supply voltages are electronically protected against overload or short cir-
cuit. The primary line voltage side is protected by a fuse located on the power supply unit.
The fuse rating covers the full voltage range. Consequently there is no need for the user to
replace the fuse under any operating conditions, nor is it accessible from the outside.
Caution: If this fuse is blown, it is likely that the power supply is badly dam-
aged. Do not replace the fuse. Send the GSG unit to your local Service
Center.
The warranty commitments are rendered void if unauthorized access to the interior of the
instrument has taken place during the warranty period.
Grounding
Grounding faults in the line voltage supply will make any instrument connected to it dan-
gerous. Before connecting any unit to the power line, you must make sure that the pro-
tective ground functions correctly. Only then can a unit be connected to the power line
and only by using a three-wire line cord. No other method of grounding is permitted. Exten-
sion cords must always have a protective ground conductor.
Electrical Connections
For a graphic representation of all electrical connections, see "Rear Panel" on page 31 and
"Front Panel" on page 28.
Using any of the communication interfaces is not required for GSG to operate in a basic
mode. The same applies to the outputs for 1PPS and 10 MHz, as well as the inputs EXT
REF FREQ and EXT TRIG: Their usage is not compulsory for basic operation.
The minimum electrical configuration for any test layout requires only the power cord and
an RF antenna cable—or an actual GNSS antenna—to connect the GSG unit to your
receiver-under-test (using the front panel RF connector, see "Front Panel" on page 28.)
1This link is provided for reference purposes only. It leads to a web page that is not maintained or supported by Orolia.
BLANK PAGE.
There are three status indicators on the front panel. When the unit is idle, all three indic-
ators are off.
scenario will blink when a scenario is running
armed (or: trig) is lit when the unit is armed, i.e. waiting for a trigger signal to start
executing a scenario
rf-out is lit when there is signal coming out of the RF-connector on the front panel.
3.1.1.1 Power
The ON/OFF key is a toggling secondary power switch. Part of the instrument is always
ON as long as power is applied, this standby condition is indicated by a red LED above the
key. This indicator is consequently not lit while the instrument is in operation.
3.1.1.2 Start
Press start to start the currently selected scenario.
In the Signal Generator menu, press start to start transmitting.
3.1.1.3 Exit
When editing a field, press exit to end the editing process, and save your changed
field value. The field label will be highlighted.
When not editing a field, press exit to return to the previous display, and save
the changes you applied to the current display. Confirm your changes.
When running a scenario, press exit to stop the scenario execution (same as can-
cel).
3.1.1.4 Cancel
When editing a field, press cancel to abort the editing process, and discard any
field changes. The field label will be highlighted instead.
When not editing a field, press cancel to return to the previous display, and dis-
card any changes you applied to the current display. Confirm your cancellation.
When running a scenario, press cancel to stop the scenario execution (same as
exit).
3.1.1.5 Menu
When running a scenario, press menu to display the main scenario configuration
(the scenario will continue to run.)
When reviewing/editing configuration settings, press menu to exit the current sub-
menu, and return to the main menu, regardless of the current display. You will be
asked to save your changes (same as exit).
3.1.1.6 View
When running a scenario, press view to toggle between the available views.
In the main menu, pressing view will act as a shortcut to the configuration display of
the currently selected scenario.
In the Options menu, press view to make a selection (same as enter).
3.1.1.7 Enter
Press enter to make a selection.
3.1.1.8 Arrows
Press any of the arrow keys to navigate in displays.
When editing an integer value, press the UP/DOWN arrows to incrementally
increase or decrease the value.
3.1.1.9 N/S
When editing latitude, press N/S to toggle between north and south latitude.
During scenario execution, press N/S to open the transmit power menu, in order
to adjust the scenario's noise settings.
3.1.1.10 E/W
When editing longitude, press E/W to toggle between east and west longitude.
During scenario execution, press E/W to adjust the units displayed for Altitude and
Speed (m/m/s > ft/kn > ft/mph).
1. 1PPS Output: TTL level signal with positive slope timed to GPS time of RF out (can
be programmed as 10/100/1000PPS).
2. Reference Output: 10 MHz derived from the internal or—if present—external ref-
erence.
3. External Reference Input: Can be selected as a reference via the Interface and
Reference menu.
4. External Trigger Input: Optional signal input for scenario triggering.
5. GPIB Connector: The address is set in the Interface and Reference menu.
6. Ethernet Connector: Data communications port used with TCP/IP networks.
7. USB Connector: Data communications port used with Personal Computers.
8. Line Power Inlet: AC 90-265 VRMS. 45-440 Hz; automatic input voltage selection.
9. Protective Ground Terminal: The protective ground wire is connected at this loc-
ation inside the instrument. Never tamper with this screw!
10. Fan: The fan speed is controlled via a temperature sensor. Normal bench-top use
means low speed, whereas rack-mounting and/or installed options may result in
higher speed.
11. Type Plate: Indicates model number and serial number.
To display the views in successive order, press the view key. In the lower right corner e.g.,
View 2/6 may be displayed, indicating the current view/total number of views. The total
number, and content of views depends on the number of signals used in the scenario.
Note: When you press the exit key to leave a menu, its settings will be
taken into use immediately, and all band- or satellite-specific offsets are dis-
carded.
See "Running a Scenario" on page 108 to find out how you can interact with the system
during scenario execution, and to learn which scenario settings can be adjusted.
1. In view: Shows the abbreviation of each satellite system, followed by its number of
satellites in view/GSG channels reserved. Satellite system abbreviations are:
GP: GPS
GL: Glonass
GA: Galileo
BD: BeiDou
IR: IRNSS
QZ: QZSS
2. PRN: Pseudo-Range Number (satellite identifier). The identifiers are:
For GPS: Gxx
For Galileo: Exx
For GLONASS: Rxx
For BeiDou: Cxx
For QZSS: Jxx
For IRNSS: Ixx
For SBAS: Sxxx.
Letters are lower case if a satellite is unhealthy, or if the ephemeris data is too old
to be used.
For multipath replicas, the letter 'D' will be displayed next to the satellite number.
Fading satellite signals are indicated by the letter ‘F’ (see end of Chapter "Propaga-
tion Environment Models" on page 69 for more information).
Interference signals are recognized by their elevation and azimuth fields since
these will be marked as *.
Furthermore, when the interference signal is un-modulated this is identified by a
CG for GPS interference signals and a leading C letter followed by the frequency
slot number for GLONASS interference signals.
Hence, next to the identifiers listed above, the following identifiers may also be dis-
played:
iUG, for unmodulated GPS interference signal
iUE, for unmodulated Galileo interference signal
iUC, for unmodulated BeiDou interference signal
iUJ, for unmodulated QZSS interference signal
iUx , for unmodulated GLONASS interference signal, where ‘x’ is the fre-
quency slot ranging from -7 to 6
Example
The example above illustrates two GPS signals (G23 and G5 ), one SBAS signal (S135 ), one
multipath signal (G7D) and one interference signal (G3).
The center of the plot represents the current receiver position, and the outermost circle
the horizon, i.e. the elevation of a satellite located near this circle is low. The lines rep-
resent the azimuth (North = 0°). For example, in the GALileo plot shown above, satellite
number 22 would have an elevation of approximately 45°, and an azimuth near 300°.
can re-configure to adapt them to your needs. You can also create your own scenarios
using the optional GSG StudioView Software.
Prior to running a scenario, you have to select it from the list of scenarios installed on the
GSG unit:
1. In the Main Menu, highlight Select using the arrow keys, then press enter to display
the list of scenarios currently loaded:
2. Scroll through the list by using the UP/DOWN arrow keys. Select the highlighted
scenario by pressing enter or view: The first Configuration View will be displayed:
3. If you want to modify the configuration of the scenario, see "Configuring a Scen-
ario" on page 109.
4. To execute (= run) the selected scenario, press the start key: The scenario will be
launched (which will take a moment, depending on the complexity of the scenario
chosen), and then started automatically, unless you pressed the [.]/hold key.
Below is a list of all configurable scenario parameters which can be accessed via the Select
Scenario menu, and which are discussed in the following topics.
Note: Options that are grayed out on your GSG unit are not installed.
"Trajectories" on page 43
"Ephemeris" on page 47
"Leap Second" on page 53
"Event Data" on page 54
"Antenna Settings" on page 59
"Advanced Configuration Options" on page 61
"Multipath Signals" on page 61
"Interference signals" on page 64
"Base station" on page 67
"Environment models" on page 68
"Atmospheric model" on page 72
"Satellite Configuration" on page 74
"Satellite Systems" on page 75
"Number of Satellites" on page 76
"Frequency Bands and Signal De-/Activation" on page 76
"Satellite Constellations" on page 79
"Encryption" on page 81
"SBAS Satellites" on page 82
Note: If NTP real time is used, the scenario start will be delayed by up
to 2 minutes, in order to allow for the simulation data to be loaded.
The Start time is aligned to the next full GPS minute. The NTP (UTC) timescale is
converted to the GPS timescale by a UTC-GPS offset defined in the NTP Server set-
tings.
get into a conflict with the GLONASS time stamps and in this case the receiver will not out-
put any solution. This issue, especially with combined GPS+GLONASS scenarios, can be
avoided by simulating future dates.
3.5.2 Duration
The duration of the scenario replay can be set to a number of days, hours and minutes.
Any scenario can be run in three different modes:
Looping: The scenario will be replayed infinite times, re-starting every time after
its set duration has expired.
For this mode, the trajectory should be loop-shaped, i.e. have the same start/end
point. Otherwise, an error will likely be thrown once the receiver-under-test upon
the first replay is moved from the end point to the start point in an unrealistically
short time.
Forever: The scenario will run infinitely (the duration time will be grayed out).
If your trajectory is loop-shaped, i.e. it has the same start/end point, the trajectory
will be followed over and over again (just like in the above-mentioned Looping
mode), but the simulation time will continue to elapse (contrary to the Looping
mode, which will re-start the simulation time with every new scenario execution.
If your trajectory is not loop-shaped, in this mode the receiver will travel along the
last trajectory vector infinitely.
Note: The option Endless only works, if the ephemeris option is set
to Download. (See also:"Ephemeris" on page 47)
One-Go: The scenario will be executed once, for the set duration.
Upon completion of the scenario execution, GSG will return to the Main menu.
degrees-minutes-seconds
ECEF (Earth-Centered, Earth-Fixed) format.
3.5.4 Trajectories
In the context of GNSS testing, a trajectory is the predefined path a receiver is traveling
during the execution of a scenario. GSG-5/6 can be used to simulate virtually any user tra-
jectory. You can:
Use predefined (built-in) trajectories
Modify predefined trajectories (using the GSG unit, or the GSG StudioView soft-
ware)
Create trajectory files in StudioView, and upload them.
Note: If the RSG Option (OPT-RSG) is installed on your unit, you can also
control movement in real-time.
At the start of the scenario the nose of the user is pointing north. The orientation of the
vehicle body changes with movement so that its nose is aligned with the vehicle’s course.
In cases with changing altitude the nose will still point in a horizontal direction, not changing
the body attitude. This default behavior can be changed by using SCPI commands which
change pitch, roll, and yaw of the simulated vehicle.
The start position of the trajectories is the position specified in the Configuration
View 1/3, under Latitude, Longitude and Altitude.
on page 130).
Two trajectory file types are supported:
RSG Trajectories
Even if the RSG Option (OPT-RSG) is not installed on your GSG, and you can therefore not
run scenarios in real time, you can still use the Orolia-proprietary RSG format by up-loading
RSG trajectories onto your GSG unit. The RSG format is further described under "RSG
Command Reference" on page 332.
NMEA Trajectories
It is also possible to use custom trajectories in the NMEA format (as generated with the
help of Orolia's GSG StudioView software, or created otherwise) by uploading the NMEA
trajectory to your GSG from a Windows PC.
GSG will transform the first timestamp in the NMEA trajectory so as to adjust it to fit the
scenario start-time and start position. Hence, the start time for the scenario does not need
to match NMEA time-stamp. All other timestamps in the NMEA trajectory will be trans-
formed accordingly, thus keeping the relative position/times in the NMEA trajectory intact.
A given NMEA trajectory can be replayed in any GPS time frame, utilizing any earth
coordinates by specifying the desired start time and start position in the scenario.
Looping trajectories
The NMEA trajectory files can be configured either to be executed once, or to loop
repeatedly throughout the scenario execution. For the looping to be allowed, the NMEA
trajectory has to be continuous, meaning the first and last specified coordinates of the tra-
jectory must be identical (see also: "Duration" on page 42).
incorrect checksum (because incorrect checksums can be useful for manually correcting
the contents of an NMEA file).
Altitude
RMC messages do not include altitude data, hence if no GGA messages are available, the
start position altitude specified in scenario parameters will be used instead.
Heading and speed over ground specified in the NMEA file will be applied only to the last
epoch of the trajectory, since all other points they will be computed by two adjacent pos-
itions. This technique prevents the undesirable behavior of some receivers which generate
NMEA data using heading and speed data that does no correspond to position change.
Skipped epochs
The navigation receiver warning field will always be verified. An epoch will be skipped if…
…the field value is ‘V’, or
…there is no date/time data, or
…there is no position data.
File size
Note that NMEA trajectory files can become quite large if the sampling rate is high and a
large distance is covered. Simulation files uploaded to the GSG unit cannot contain more
than 12000 epochs (~19 minutes RMC + GGA at 10 Hz).
If you start a scenario that uses an NMEA file with more than 12000 epochs, GSG will ini-
tiate a dialog upon start of the scenario, asking you to either cancel the simulation exe-
cution, or to truncate the NMEA trajectory file down to its first 12000 epochs.
$GPRMC,111150,A,6000.0000,N,0100.0000,E,77.000,0.0,010101,0.9,W,A*03
One-line trajectories like this can be easily be made by manually creating desired NMEA
files. The example above can be taken as a baseline, then edit speed and/or heading fields
as required. For the validity of the sentence, the last 2 digits contain a checksum of the
data (XOR of all bytes between $ and * symbols) – this checksum must be correct and can
be calculated with e.g., this online tool:
http://www.hhhh.org/wiml/proj/nmeaxor.html. Note that the NMEA messages, includ-
ing the checksums, are case sensitive and should be given in UPPERCASE even if the GSG
unit (firmware version 3.00 and above) accepts messages in lower case.
3.5.5 Ephemeris
The satellite constellations and the transmitted navigation data of each satellite are dynam-
ically built, once you start the scenario or the signal generation. The constellation and the
navigation data is based on RINEX data stored in the unit, or uploaded to the unit. The con-
stellation orbits can be refined by providing precise orbit information in SP3 format (for
details, see below).
GPS and QZSS almanac data may optionally be provided in the form of YUMA files (for
details, see below).
In addition, SBAS message files are also supported (see "SBAS Satellites" on page 82 and
"User-Uploaded Ephemeris" on page 49 below for more details).
Under the menu item Select > Select Scenario > Configure > Ephemeris, there are two
or three options to choose from (as described below), in order to select a source for your
scenario navigation data:
Default
Download
User-uploaded files.
Simulate Now
When Download ephemeris is used, it is also possible to simulate the current time ,
provided:
a. the Simulate Now license option is installed, and
b. the Start Time is set to NTP.
In this case, the navigation data will be based on hourly data retrieved from the official GPS
ephemeris site ftp://cddis.gsfc.nasa.gov/pub/gps/data/daily/.
Please note that this functionality is only available for GPS, and that the availability of the
data cannot be guaranteed.
If a satellite system (e.g., GPS, or Galileo) is selected (i.e., number of satellites selected is
not 0) and no navigation files are selected for that particular satellite system, then GSG will
use default data for that satellite system.
The RINEX format support includes version 2.x and 3.0.
The file extension for SP3 files must be *.sp3 (not case sensitive).
sidered valid for ±3.5 days from the TOA value (Time-of-almanac) listed in the YUMA
almanac.
The scenario is restricted to start times within this range. If a scenario runs beyond this
range of time, no new satellites will be added. If the user specifies a start time outside this
range, a dialog will advise the user that the ephemeris and almanac are dates are mis-
matched. The SCPI error “ Data out of range" will be logged to indicate this issue for
remote control users.
CNAV
You can also provide a file with CNAV messages to be used with GPS and QZSS L2C and
L5. The file extension is .cnt (CNAV train), and the file is satellite-specific. The file name
conventions are:
PRN<satid>_y<4digityear>_d<dayofyear>_h<hourofday>.cnt
e.g., PRNG01_y2013_d105_h14.cnt.
Each row of the file should contain:
satSys(A1), satid (I2), 1X, year (I2), 1X, month (I2), 1X, date
(I2), 1X, hour (I2), 1X, min(I2), 1X, sec (I2), 1X, msgid (I2),
1X, [optional] hexmsg (A76)
Example :
G01 13 04 15 14 00 00 11 8B04B4ED919863A6671F473A31412695EFF3C
026C0209FF07D601F775FEFE1FF987800000000
The hexmsg part is optional, and if not provided, it will be generated by GSG. This enables
for users to specify only the order of messages.
The messages are used in a circular manner, i.e. after the last message is sent, the first mes-
sage will be sent again. The starting message is selected based on scenario start time, i.e., it
can be one of the middle messages in case scenario starts later than the time of the first
message.
Since the same file is used for L2C and L5 message trains which have different message
duration, only the timestamp of the first message is relevant to decide the starting mes-
sage. The week number and tow, as well as CRC, are recalculated by GSG.
SBAS
SBAS message files must follow the following file naming conventions so that GSG can
recognize them:
For EGNOS: PRN*.ems
For WAAS: Geo*
SBAS message files do not need to be transformed to the scenario date as all timing is rel-
ative, i.e. a message file downloaded for a particular date can be used also with any other
scenario start date.
ANTEX
You may also specify an ANTEX file to be used in simulation. The file extension is .atx. It
contains satellite antenna phase center offsets and phase center variations. When present,
this information is used for improving satellite range calculation.
Note: For GLONASS, matching ephemeris and almanac files must be spe-
cified (only the 2- line AGL format is supported, see ftp://ftp.glonass-
iac.ru/MCC/FORMAT/Format.agl ). In addition, GLONASS almanac files
must be named *YYMMDD.agl (i.e., a date must be provided at the end of
the file name).
Note: The GLONASS data at this publicly available FTP site is known to con-
tain errors. These can cause the GSG to generate signals that are deemed
‘bad’ by a receiver and may not be used in a fix or for navigation. This data is
not maintained by Orolia and is not guaranteed.
Note: The GPS and QZSS almanac files specified must comply with the
YUMA file format and match the first 5 characters exactly for field iden-
tification. The spacing to the rightmost column of data must be preserved.
If the file fails to be processed, verify that the Af0 and the Af1 lines do not
contain a space between these prefixes and the (s/s). For example, the line
must be Af0(s/s), not Af0 (s/s).
Note: RINEX data files in most cases must be full day files. However, when
GPS almanac files are provided, the RINEX records can be of shorter dur-
ation. RINEX files of less than a day duration without supporting GPS and
QZSS YUMA almanac files are limited to start times only after 1400 hours,
and may operate for limited times.
The leap second event field can be set to -1, 0 or 1, and indicates a future change in GPS-
to-UTC offset value.
If the leap second event (LS field) is set to a value other than zero
The following values will be used:
ΔtLSF = ΔtLS + value given in the leap second field
WNLSF = The GPS week number (eight bit representation) of the week that includes the
30th of June, or 31st of December, which-ever comes first with respect to the scenario
start time.
DN = Day number of the date described above.
Alternatively, the user can also specify any desired offset value. This is configured under
the scenario menu: Advanced > GPS to UTC offset, or by using the scenario file para-
meter GpsToUtcOffset.
The allowed values are:
Auto: In this setting, the initial offset is determined by scenario start time
Rinex: determined by information taken from navigation data files attached to a
scenario
<Fixed Offset in Seconds>: the user can select an offset from a range of 0-30
An up-to-date leap second events history is embedded in each firmware release, but you
can also download the latest list from the Internet using Options > Advanced options >
Download leap seconds list.
Considerations
Note that downloaded and default navigation data files do not contain any LSF information
(RINEX v2.1). Therefore, it is still necessary to set the LSF when a leap second change will
occur, in order to ensure correct behavior.
satellites use the scenario keyword. Events which apply to a specific satellite indicate
this by specifying channel NUMBER or prn SATID values. For relpower and abspower
events, it is possible to apply the event to each satellite of a specified constellation: use the
system keyword followed by the satellite system name
(GPS/GLONASS/GALILEO/BEIDOU/QZSS/IRNSS/SBAS).
The first format, relpower, defines a change in the power level for the whole scen-
ario, a single satellite identified by SATID or channel number, or all satellites in one
constellation.
The second format, abspower, sets the absolute power for the whole scenario, a
single satellite identified by SATID or channel number, or all satellites in one con-
stellation.
The third format, duplicate, generates a duplicate signal from a given satellite,
using a specified delay, Doppler and power level. Duplicate channels require
60 seconds to be created, and are introduced at fixed 30-second intervals. Only 4
Duplicate satellites are allowed to be created at a time. Duplicate events closer
together than 4 seconds are spread apart automatically to maintain 4 second sep-
aration.
SBAS and Interference satellites cannot be duplicated. The optional CHTARGET para-
meter specifies the channel to be used. If the channel is used by a satellite, this satel-
lite will be disabled, and the multipath satellite replaces it. If the CHTARGET
parameter is not specified, the multipath satellite will be created in the first unused
channel. Multipath, SBAS and interference/jamming channels cannot be duplicated.
The fourth format, multipath, modifies the multipath parameters of a satellite. If
the satellite is not a duplicate, it becomes a duplicate satellite, which is reflected in its
SATID. SBAS and interference/jamming channels cannot have their multipath para-
meters modified.
The fifth format, delete, deletes a satellite. If the satellite is not a multipath duplic-
ate, it will typically automatically re-appear after 1 to 2 minutes. SBAS and inter-
ference/jamming channels cannot be deleted.
The sixth format, navbits, sets bits in a navigation message. The ENDBITPOS-
STARTBITPOS+1 LSB of the HEXSTRING are used to replace the bits between
STARTBITPOS and ENDBITPOS, so that the ENDBITPOS is aligned with the LSB of
the HEXSTRING.
Should ENDBITPOS-STARTBITPOS+1 > length (HEXSTRING), the HEXSTRING will be
used as a repeating pattern to replace the bits between STARTBITPOS and
ENDBITPOS.
Multiple navbits events may be applied to the same message. Note that a navbits
event is applied to the first message from the event TIME with the SFID and
PAGEID specified in the event. For GPS the bit count starts with MSB, whereas for
Glonass, the count starts with LSB. Only GPS and GLONASS are currently sup-
ported.
PAGEID is
a page ID (with GPSL1 and L2P signals)
0 (not relevant) when the subframe ID is 1-3
0 (not relevant) with L2C and L5 signals
a string idID (with Glonass).
STARTBITPOS, ENDBITPOS are positions of bits in a navigation message.
HEXSTRING is a bit pattern to be set in the message.
REPEAT
set to 0, if the modification should be applied only once
set to 1, if the modification should be repeated on every message.
CRCFLAG
set to 0, if CRC/parity is not to be corrected after the modification
set to 1, if CRC/parity needs to be corrected after the bit modification.
PRINTFLAG
set to 0, if the modified message does not to be logged (default)
set to 1, if the modified message needs to be logged in the execution log.
Note that the message is logged only once, even if the modification is
repeated on every message (repeat flag is 1).
PROPENV
See "Propagation Environment Models" on page 69.
An example event file containing all five formats with explanations is shown below:
11.0 channel 6 multipath 35.0 0.01 1.0 0.0 0.0 0 -10.0 0.0 0
11.0 prn G9D multipath 25.0 0.01 1.5 0.0 0.0 0 -15.0 0.0 0
At 11.0 seconds, the multipath settings of the newly created duplicate, identified by
its SATID ‘G9D’, are modified: The satellite will have a 25 meter range offset, increas-
ing with 1.5cm/s. It will have its power attenuated by 15 dB.
After 12.0 seconds, the MSB is set to 1 in 6-bit health (bits 77-82) in the first GPS
L1CA message with subframe ID 1 sent by satellite G1.
After 170.0 seconds the channel number 6 duplicate is deleted.
After 180.0 seconds the G9D duplicate is deleted.
Note: Several Events can occur at the same epoch. If so, any PRN/channel
event overrules scenario events, see example below.
EXAMPLE:
The output power of channel 1 is set to -142.0 dBm, while all other channels are transmitted
with an output power of -147.0 dBm.
Note also that abspower settings of events overrule the Transmit power setting spe-
cified under Options > Transmit power, while observing the external attenuation set-
tings.
Duplicating a satellite at time 00.00 is not permitted.
A receiver typically has a higher elevation mask and it will not use any satellite below the
elevation angle of its set mask. The recommended setting is to set the elevation mask of
GSG to a value equal or less than that of the device under test.
In order to conserve channels by not generating signals the GNSS receiver will not use in
its fix, the elevation mask in the GSG can be set to a slightly higher value. This is especially
important with, e.g., GSG-52/53 Series units, or GSG-5 models equipped with 4-channels.
To configure a multipath signal, navigate to Select > Select Scenario > Configure Scen-
ario, View 2/3: Advanced, and specify a number greater than zero for Multipath signals.
Note: Your GSG unit requires free channel(s) available, in order to allow for
the creation and configuration of a (several) new multipath signal(s).
Press enter to display the first configuration view for the first Multipath signal (the number
of views equals the number of signals you specified.)
Satellite
This specifies which satellite is to be duplicated by the multipath signal. The value
specified is a running number starting from 1 to the number of satellites defined to
be in the scenario. ‘1’ would mean that we will duplicate the satellite in the first pos-
ition when scenario starts.
Range
Offset: The Range (or: Code) offset in meters. For a multipath signal this value
should typically be positive, meaning that the travelled distance of the signal will be
longer than that of the original or line-of-sight (LOS) signal.
Change: Change in range offset, given in meters / Interval
Interval: Specify change interval in seconds to the nearest tenth second.
Doppler
Offset: The offset in Doppler in centimeters/seconds
Change: Change in Doppler offset, given in centimeters/seconds/Interval
Interval: Specifying change interval in seconds.
Random CP
The carrier phase offset can also be randomized on startup by setting the ‘Multipath ran-
dom CP” to ‘On’ in the GSG menu (or ‘RandomMpCP’ keyword in the configuration file).
Power
Offset: The offset in output Power in dB
Change: Change in Power offset, given in dB / Interval
Interval: Specifying change interval in seconds. If the interval is zero, the offsets will
be set at startup and remain static.
Considerations:
SBAS and interference/jamming channels cannot be duplicated.
The Change/Interval effect will be interpolated. If the initial interval is zero, the off-
sets will be set at startup and remain static.
In a multi-frequency constellation, the multipath configuration will apply to all active
bands.
To match the multipath conditions as specified in the LTE/3GPPS A-GNSS test spe-
cification, for GPS the following settings should be used:
Range Offset 150 m
Doppler Offset 1.9 cm/s
Power Offset -6dB
Multipath random CP: ON.
Press the view key to configure the next multipath signal, when several multipath signals
are configured.
Press the exit key to save your multipath configuration.
Note: The Interference feature is only available with GSG-5, GSG-55, GSG-
56 and GSG-6 Series products. Some features are only available when
OPT- JAM is enabled in the unit (see "List of Available Options" on
page 205).
Orolia GSG- Series simulators can generate GNSS interference signals to test GNSS
receiver performance. To configure an interference signal, navigate to Select > Select
Scenario > Configure Scenario, View 2/3: Advanced: Interference Signals.
After specifying the desired number of interference signals (using the UP/DOWN arrow
keys), press enter to display the first interference signal configuration view (the total num-
ber of views depends on how many interference signal you specified):
Signal type
You can configure any signal type your GSG unit is licensed for (un-licensed signal types
are grayed out).
Frequency offset
The frequency offset refers to nominal frequency of the selected signal/frequency slot.
Power, Position
It is possible to simulate a location-based jamming signal by specifying a position for it. Loca-
tion-based jamming simulation utilizes the jamming signal power, and position to cal-
culate the distance from the simulated position, applying the path loss formula given earlier
in this document (see "Signal Power Level Considerations" on page 24) to calculate the
power of the received jamming signal. As the scenario position moves closer to the location
of the jamming transmitter, the jamming power increases, and vice versa.
When configuring a location-based jamming source, the distance to the scenario start pos-
ition and the jamming coverage are shown, in order to assist you in designing a reasonable
jamming test configuration.
Note that the jamming power can be set to +60 dBm, whereas the maximum GSG power
level is -65 dBm.
Example
The figure below shows a configuration of a sweeper interference signal for the L1, L2 and
L5 bands (OPT-JAM installed).
Once you selected the On option for Base station, the configuration view will be dis-
played: Configure the position of the base station and the RTCM messages to be output by
it.
RTCM version
The RTCM SC-104 version currently supported is Ver. 3.2. This cannot be changed.
For more information on RTCM standards, see: www.navipedia.net/index.php/RTK_
Standards.
Message type
Message types 1002, 1004, 1006, 1010, 1012 and 1033 are supported.
Environment model
An environment model is a 3D model of the environment, e.g., buildings, ground, etc. All
environment models used must have a geo-location added to them before they can be
used for simulation purposes.
Vehicle model
A vehicle model represents a 3D model of the vehicle. The vehicle model will move with
the simulated trajectory. The body center of a simulated vehicle will be in the origin pos-
ition of the model, and all trajectory movements defined in the simulation will act on the
body center. The vehicle model should be placed so that its nose points to the north.
The vehicle model will also follow any pitch/roll/yaw movements simulated, i.e. if the
vehicle model rolls by 90 degrees, half of the sky is likely to be blocked by the vehicle itself
(depending on vehicle model used).
The antenna position oftentimes is not in the same location as the vehicle body center pos-
ition. In the simulation, this can be adjusted by configuring the lever arm values (see "Lever
arm" on page 60).
The antenna position can also be specified in the vehicle model file by adding a component
named RecAnt. In the event that both lever arm, and RecAnt are set, the receiver antenna
position as set in the Vehicle model takes precedence. The vehicle model does not need a
geo-location.
If a satellite is blocked by an object from either environment or vehicle model, i.e. it is not
visible by the receiver antenna, its power will be set to OFF.
GSG can successfully handle vehicle models with up to 130 triangles. Models should be
optimized for a low polygon count. The triangle count is limited to a total of 300 for the
combined environment and vehicle models.
For additional information, see the Orolia Technical Note Vehicle Modeling.
Satellites above the Open Sky limit are not affected by multipath propagation.
Satellites in the Multipath Zone (elevation angle between Obstruction Limit and Open
Sky Limit) are considered LOS signals, but affected by multipath propagation. The ITU
model for LOS situation is used for these satellites.
For satellites in the Obstruction Zone (elevation angle below Obstruction Limit), the dir-
ect signal path may be obstructed, e.g., by a building. This is modelled by giving a probability
for an NLOS situation. With the given probability, the simulator classifies satellites as NLOS
and takes the ITU model for the NLOS situation into use. The NLOS situation changes only
when a satellite leaves the Obstruction Zone.
Note that, in addition to the two elevation limits mentioned above, the Elevation mask set-
ting applies to the simulation as normally.
The Propagation environment is defined by the environment type (open/rural/sub-
urban/ urban) and three parameters:
Open sky limit, Obstruction limit and NLOS probability.
Default values for the parameters in each environment type are given in the table below.
The Open environment type is the default, meaning that all satellites assume free-space
propagation.
The Propagation environment model is taken into use by setting an event scenario
propenv. If stated without parameters, the default parameter values given above will be
used. In this case the format of the even line is:
TIME scenario propenv {open|rural|suburban|urban}
Example
0.0 scenario propenv suburban
300.0 scenario propenv urban
600.0 scenario propenv urban 90.0 60.0 0.75
The example event file above will create a simulation starting from sub-urban environment
(default parameters). After five minutes the simulation changes to an urban environment
(default parameters) and after ten minutes to a highly obstructed urban environment
where open sky satellites do not exist (open sky limit at 90 degrees), and satellites below
60 degrees elevation are likely to be NLOS (NLOS probability 0.75).
The Propagation environment model can be defined in the scenario configuration by using
the Scenario editor in StudioView.
The Propagation environment model can also be set by using the corresponding SCPI com-
mands (see "SOURce:SCENario:PROPenv" on page 265).
Iono model
The GSG unit comes with built-in support for a model of the ionosphere. By default the
used model is a reverse model of the model described in IS- GPS- 200D, Section
20.3.3.5.2.5, called Klobuchar.
The a0-3 and b0-3 parameters set in the default model are set by the used navigation data
files. When set to Off, no delays caused by the ionosphere are used in the simulation.
Under normal testing conditions, the Klobuchar ionosphere model should be used.
Note: The GSG also supports simulation of ionosphere delays using files in
the IONEX format.
Tropo model
A number of tropospheric models are supported by the device. These are:
Saastamoinen model. The model is based on Saastamoinen, J., 'Atmospheric Cor-
rection for the Troposphere and Stratosphere in Radio Ranging of Satellites,' The
Use of Artificial Satellites for Geodesy, Geophysics Monograph Series, Vol. 15., Amer-
ican Geophysical Union, 1972
Black model. The model is based on Black H., ‘An Easily Implemented Algorithm for
the Tropospheric Range Correction’, JOURNAL OF GEOPHYSICAL RESEARCH,
1978
Goad&Goodman, a tropospheric model based on Goad and Goodman(1974), "A
Modified Hopfield Tropospheric Refraction Correction Model", 1974
STANAG model. The model is based on NATO Standardization Agreement
(STANAG) Doc. 4294, Appendix 6.
The tropospheric model can also be set to Off, and no tropospheric delays are used in sim-
ulation. Under normal testing conditions, one of the tropospheric model should be used.
The tropospheric model also allows for the temperature, pressure and humidity to be con-
figured:
Temperature: to be specified in degrees Celsius
Atmospheric pressure: in millibars
Humidity: relative humidity in percent.
The graph below illustrates the delays for the different models available, using default val-
ues for environmental conditions.
Note that the tropospheric delay added to satellites with low elevation angles are ‘capped’
at a maximum value. The capping delay value and the elevation angle are a function of the
model used.
To access the first satellite configuration view, navigate to Select > [Select scenario] >
Configure scenario: View 3/3.
The following satellite-relevant settings can be configured:
Satellite System, e.g., GPS, Glonass (see "Satellite Systems" below)
Number of satellites simulated for a given satellite system (see "Number of Satel-
lites" on the next page)
Signal Type, e.g., L1, L2 (see "Frequency Bands and Signal De-/Activation" on the
next page)
Satellite Constellation [GPS: "block"] (see "Satellite Constellations" on page 79)
Encryption (see "Encryption" on page 81)
SBAS/Augmentation (see "SBAS Satellites" on page 82)
GALILEO
Europe; globally operating system; yet, not fully operational as of summer
2015; high-quality signals, multiple uses
BEIDOU
China; regional system (Asia); planned global expansion; open system
QZSS
Japan; regional system
IRNSS
India; regional system
Note: If GSG runs out of free channels when in Auto mode, not all satellites
will be simulated.
… are transmitted on frequencies close to each other, yet they do not interfere with
each other
… can be decoded by one receiver (if supported by the receiver manufacturer)
… can be grouped into four main bands.
These four frequency bands are:
Frequency Bands
Constellation
1 2 3 4
GPS L1 L2/L2C L5
Glonass L1 L2
Galileo E1 E5 E6
BeiDou B1 B2 B3
For GPS:
L1CA
L1P
L2P
L2C
L5
P(Y): Pseudo encryption
For Glonass:
L1
L2
For Galileo:
E1
E5A
E5B
For BeiDou:
B1
B2
For QZSS:
C/A
SAIF
L2C
L5
Active Signals
Frequency bands can be turned ON/OFF separately, so as to configure which types of RF
signals specific to each supported satellite system shall be active/inactive when a scenario
is running.
Depending on the configuration of your GSG unit, all of the frequency bands listed above
can be turned ON/OFF.
To turn ON/OFF a signal band, navigate to: Select > [Select Scenario] > Configure Scen-
ario: View 3/3 > [Satellite System]: Enter a number of satellites > 1 (see "Number of
Satellites" on page 76).
The satellite constellation (see "Satellite Constellations" on the facing page) must be con-
figured accordingly, in order to allow for, e.g., the L2C band to be simulated. In other
words, if you chose to disable satellites that can generate this signal, it will not be gen-
erated, even if you activate the signal. Hence, it is recommended to leave all signal types
ON (default), thereby letting the configured satellite type determine which RF signals are
active.
Use cases for turning OFF the transmission of individual frequency bands are:
simulating a one-band antenna
reserving the maximum number of channels for other requirements (e.g., L1-only
transmission)
Considerations:
Altering active RF signals will not alter the navigation message. Hence from a
receiver point of view, choosing to de-active L2 and L5 will mimic the situation of
using a single band (L1) antenna.
Settings are GNSS-specific, not satellite-specific.
For GLONASS, C/A code is always used.
Note: The functionality described below only applies to GPS and Glonass.
Other installed satellite systems, such as Galileo, still have their first gen-
eration of satellites in orbit.
III. Explicitly specify the constellation for each individual satellite, using GSG Stu-
dioView:
This functionality may be required for the configuration of scenarios taking place in
the past, or 'What-if' scenarios.
Consider the following when configuring satellite constellations:
The selected satellite constellation will impact the navigation message to mimic
the type of simulated satellite.
The satellite type will also impact the types of RF signals generated (see "Fre-
quency Bands and Signal De-/Activation" on page 76), i.e. for the signal type L2C
to be transmitted, the satellite type must be Block IIR-M (or higher), for L5 to be
transmitted, the satellite type must be of type Block IIF (or higher), etc.
Possible settings are:
For GPS:
II
IIA
IIR
Block IIR-M
IIF
(default)
For Glonass:
Glonass-K1
Glonass-M
(default)
3.5.10.5 Encryption
Next to the unencrypted L1 band Coarse/Acquisition Pseudo-Random Noise code (C/A
PRN code), the Precise (P), but encrypted Pseudo Random Noise code is used to mod-
ulate both the L1, and the L2 carriers.
While GSG cannot replicate the encryption, it can emulate, and thus represent the P(Y)
code, so as to allow for commercial GPS surveying receivers to be tested for their ability to
derive the carrier in a codeless fashion.
Note that this technology does NOT use controlled encryption. Instead, it mimics the
encryption so as to provide an RF signal in the L1/L2 P(Y) location.
Note: GPS receivers that use genuine encryption methods will NOT be able
to use the L1/L2 P with Pseudo P(Y) code enabled because the encryption
used is not as expected and they cannot decode it.
3. Navigate to the P(Y) entry at the bottom of the view, and select On, or Off.
Considerations:
For most L1/L2 GPS receivers, there are two valid configuration modes:
1. Enable L1 C/A, L1P, and L2P only:
The L1P and L2P will be transmitted without encryption.
GSG can simulate SBAS satellites at frequency bands L1 and L5. Each scenario defines the
number of SBAS satellites that should be simulated. There can be 0, 1, 2, or 3 SBAS satel-
lites per scenario. You can also specify individual SBAS satellite IDs to simulate.
To review/edit the number of SBAS satellites for the scenario chosen, navigate to: Select
> [Select Scenario] > Configure Scenario: View 3/3"Number of Satellites" on page 76
If an integer number of SBAS satellites is specified, the GSG unit will select SBAS space
vehicles based on their elevation relative to the user position. When the scenario is run-
ning, the SBAS satellite positions and speed will be updated with the information found in
the SBAS messages. These messages comprise different Message Types, one of which—
MT9—is used to update the satellite’s position and speed.
You can also select up to 3 specific satellites to simulate.
The SBAS satellites transmit their signals utilizing Coarse/Acquisition Pseudo-Random
Noise (see also "Encryption" on page 81). PRN numbers, which have been internationally
coordinated, have been allocated to each of the SBAS constellations. Although PRN120 …
PRN158 are all reserved for SBAS systems, only a few of them are actually used by satel-
lites.
When determining the elevation angle of SBAS satellites, the GSG unit looks for the SBAS
satellites listed below. This is in contrast to the signal generator mode (see "Signal Gen-
erator" on page 94) where the user can specify any SBAS PRNs to be simulated.
The currently supported SBAS satellites are:
EGNOS: 120, 123, and 136
WAAS: 131, 133, 135, and 138
MSAS: 129, 137
GAGAN: 127, 128, and 132
The simulator uses two approaches for SBAS messages:
Default SBAS messages (MT63)
EGNOS/WAAS message files
The default SBAS messages are always available. These messages should be recognized
by SBAS-compatible receivers. However, they carry no information and will therefore not
enable the receiver to correct GPS signals.
SBAS message files for both EGNOS, and WAAS are supported. EGNOS files (.ems) are
ASCII and hourly, while WAAS files are typically in binary format and cover a whole day.
Both systems share the same format of the messages. For details, see
www.navipedia.net.
When the scenario has the Ephemeris set to Download, the GSG unit will download the
SBAS messages from official sites and match these messages to the time of the scenario.
The SBAS messages broadcast by these satellites are downloaded automatically from the
following public FTP sites:
EGNOS: ftp://131.176.49.48
WAAS: ftp://ftp.nstb.tc.faa.gov
MSAS: www.enri.go.jp
GAGAN: default MT63
GSG logs into these sites anonymously. However, note that both FTP sites are likely to
track and record all FTP access, including access by GSG simulators.
Considerations
If a scenario needs SBAS messages that cannot be downloaded from these FTP sites, the
scenario continues, but the GSG unit transmits null- messages (SBAS message type:
MT63). An SBAS-compatible receiver should still be capable of seeing the SBAS signals,
but it will not find any useful information (range corrections, time offsets, etc.) in these mes-
sages.
Because of these reasons, SBAS scenarios run best with a live Internet connection. Fur-
thermore, since the aforementioned FTP sites store only a limited amount of SBAS
records, the start time of SBAS scenarios has to be chosen carefully:
Usually, SBAS records that are less than a year (EGNOS)/6 months (WAAS) old, can be
found on the FTP sites mentioned above. Therefore, it is advisable to select a start time
that is not older than one year for EGNOS scenarios, and not older than 6 months for
WAAS scenarios.
Moreover, the start time shall not be too close to the current time. For EGNOS, there can
be a one-day delay before the SBAS messages are published on the FTP site. For WAAS
the delay can possibly be longer (up to 3 or 4 days).
An Internet connection is not always needed, however: All downloaded ephemeris data
and SBAS data will be locally stored on the unit, once they have been downloaded. Hence,
the next time the same scenario runs, the ephemeris data and SBAS messages are read
from the local storage, not from the online ftp sites.
GSG will performs automatic clean-up of downloaded files, once the remaining free disc
space falls below 20% of the total disc space.
Note: The SBAS corrections are ‘applied backwards’ to the output GPS sig-
nals by adjusting the signal ranges.
It is also possible to download the EGNOS and WAAS files from the ftp servers, and select
them for use in the scenario: The file name holds the information on the applicable time &
date, which is NOT available in the content of the file (all time is relative), and must follow
these naming conventions:
For EGNOS: PRN<prn>_y<YYYY>_d<doy>_h<hour>.ems
For WAAS: Geo<prn>_<GPSWeek>_<dayOfWeek>
Should the files downloaded from the ftp server do not meet these format requirements, it
will be necessary to rename the files accordingly.
QZSS L1 SAIF
The QZSS satellites transmit also a SBAS signal, called L1 SAIF. The GSG unit can emulate
this signal. The signal is enabled by setting the value of “QZSSL1SAIF” to ”1” in a scenario
file.
If the user does not specify a file containing the messages for transmission, the unit will
transmit only the default (MT63) messages. The naming convention for the transmitted
files is the same as for the WAAS satellites above. The PRN numbers reserved for QZSS
L1 SAIF transmission start from 183, so the name of the message file for J01 should start
with “Geo183_”, for J02 with “Geo184_”, etc.
For the best results, the user should specify the Rinex navigation file(s) used in the scen-
ario, together with the SAIF message files. This way the user can ensure that the simulated
satellite position based on Rinex NAV files is in line with the position information trans-
mitted in the L1 SAIF messages.
Caution: To learn more about signal level compliance in the United States,
see "Signal Power Level Considerations" on page 24. If you live in other
countries, check your local emission standards.
To access the Transmit Power view, navigate to Options > Transmit Power. This view
also allows you to adjust the external attenuation (see "Adjusting External Attenuation"
on page 90), and noise (see "Adjusting Noise Generation" on page 91).
Considerations
A common problem is that signals too strong or too weak are used. A signal too strong will
typically ‘jam’ the receiver, causing it to erroneously find many shadow signals. It is recom-
mended that you familiarize yourself with the typical signal/noise values for real satellites,
and try to obtain similar values when using this unit. When the signal strength is correctly
set, the receiver will respond directly and logically to changes in signal power.
The following table shows the offsets when referencing GPS L1 C/A as zero dB offset:
L1 C/A 0.0
L1 P -3.0
GPS L2 P -3.0
L2C 0.0
L5 +1.5
GLONASS L1 -2.5
L2 -8.5
E1 +1.5
Beidou B1 -4.5
B2 -4.5
L1 SAIF -2.5
you modified the power configuration, it will be saved with all other settings when the unit
is turned off.
To configure signals power:
1. Navigate to Options > Transmit Power.
2. Adjust the GPS L1C/A band Ref. power. The power is specified in dBm. The sup-
ported range is: Max. -65 dBm … Min. -160 dBm.
3. Select Signals power configuration to open the corresponding menu.
4. Select the desired constellation, and adjust the power for each signal type sup-
ported by this constellation.
Note: When changing the power setting for a signal type, the Refer-
ence Power (absolute power level of GPS L1 C/A) and Relative
Power offsets for all the remaining signal types will remain
unchanged.
Use the format key to switch between the absolute or relative mode of displaying/editing
power. When the Absolute Power mode is active and Reference Power is changed, the
Relative Power offsets will stay unchanged, so that absolute powers will be “shifted”
together with the Reference Power.
GPSL1P -131.5 -3
GPSL2P -131.5 -3
GPSL2C -128.5 0
GPSL5 -127 +1.5
SBASL1 -131 -2.5
SBASL5 -127.9 +0.6
GLOL1 -131 -2.5
GLOL2 -137 -8.5
*Orbit type for BeiDou satellites determined by PRN number (for more information, see
https://www.glonass- iac.ru/en/BEIDOU/ ): GEO: 1<=PRN<=5, IGSO: 6<=PRN<=10
and PRN=13, MEO: others
General considerations
International regulations keep the L1 band practically clean from disturbing signals, so the
only noise source is the natural background noise, as expressed in the following equation:
PN = kTBN
Where k is the Bolzmann’s constant, T is the ambient temperature (in Kelvin), and BN is the
bandwidth (in Hertz).
For example, an ideal GPS L1 C/A code filter would have a passband of 2MHz, and noise
power passed by the filter at a temperature of 290 K would be equal to -141 dBW.
The ambient noise power spectral density is given by the equation:
NT = kT = 4.00 x 10-21 W/Hz = -204 dBW/Hz = -174 dBm/Hz
By definition, carrier-to-noise density is the carrier power divided by the noise power spec-
tral density. The GPS ICD specifies that the received signal level at the surface level is -130
dBm or better. Carrier-to-noise density is then:
C/N0 = -130 dBm/(-174 dBm/Hz) = 44 dB Hz
C/N0 (not SNR) is the figure that the receivers typically display as an indication of quality
for the received, digitally modulated signal. If the receiver has bandwidth of 6 MHz, SNR
would be:
SNR = 44 dB Hz/(6 x 106 Hz) = 44 – (10 x log10 (6 x 106)) dB = -23.8 dB.
If a stronger input signal for the receiver is required, while maintaining the same C/N0 , addi-
tional noise needs to be introduced into the transmitted signal. One may think of this as hav-
ing an active antenna at the receiver input. The signal level is higher, but so is the noise
level.
strong signal (for example: -100 dBm, C/N0 44 dB-Hz), and narrow noise bandwidth.
Then increase the noise bandwidth until the C/N0 value shown by your receiver sta-
bilizes. It is a good idea to use the narrowest bandwidth needed.
Note: For more information on available GSG models and options, see "GSG
Series Model Variants and Options" on page 203.
To configure the Signal Generator mode, navigate to Options > Signal Generator:
Figure 3-28: Signal Generator configuration view (depends on licensing options installed)
In Signal Generator mode, GSG offers the following Signal type configuration options:
GNSS systems currently supported are: GPS, Glonass, Galileo, BeiDou, and QZSS,
and their corresponding signal types. For information on signal types, see also "Fre-
quency Bands and Signal De-/Activation" on page 76.
Pseudo-encryption (P(Y)): For more information, see "Encryption" on page 81.
SBAS Signals: It is possible to generate a signal for any of the SBAS PRNs. However,
GSG can generate a real SBAS message stream only if the chosen PRN corresponds
to a live SBAS satellite (see "SBAS Satellites" on page 82 for further details).
Note: The SBAS signal type is only available with GSG-55, GSG-56,
and GSG-6 Series units.
Note that in signal generator mode (unlike in constellation simulation mode), GSG
will always attempt to download SBAS data. If such data is not available, then MT63
(i.e., “null messages”) will be transmitted.
Modulation options:
Modulated: This is the default mode, transmitting standard, modulated sig-
nals.
Sweep or Noise: In addition to the modulated signals, sweeping interference
or narrowband noise interference will be transmitted. Currently it is not pos-
sible to use sweep/noise with unmodulated signals.
Pure Carrier Signal: GSG will transmit an un-modulated signal (pure carrier),
using the user-specified signal strength, and frequency offset from the
3.6.2.2 Satellite ID
The Satellite ID field is used to specify the GPS PRN, Galileo PRN, and the GLONASS
satellite ID, therefore it is limited to 24 (the highest GLONASS satellite ID). If this field is set
to a value higher than 24, then GLONASS will not be selectable under Configure signal
types.
Caution: If you are using an antenna (rather than an RF cable), see "Signal
Power Level Considerations" on page 24 regarding signal level compliance
in the U.S. If you live in other countries, check your local emission standards.
Note: If this field is grayed out, it is not applicable for the chosen con-
figuration.
3.6.2.6 Ephemeris
If NTP start time is used, the Ephemeris cannot be downloaded, as this data is not available
in real time. The simulated range equals to (25.0E-3*speed_ of_ light), so the 1PPS Out
from the back panel would trail the time mark determined from the RF Out signal by 25
ms.
Note: If this field is grayed out, it is not applicable for the chosen con-
figuration.
3.6.2.7 AutoStart
If set to ON, AutoStart will start the Signal Generator mode automatically, once you
powered up the GSG unit.
If set to OFF, the signal generation is started by pressing the START key, and stopped by
pressing CANCEL. When a signal is generated, the simulated GPS time and the text Trans-
mission ON are displayed (see illustration below).
Note that Power and Frequency offset can be edited while the transmission is ON.
All signal parameters are stored to non-volatile memory and are set when the unit is star-
ted.
Depending on the type of interface chosen, only relevant fields are editable.
The remote interface type can be:
USB
Ethernet
GPIB: Set the address here.
SCPI-Raw network clients can use a socket connection to port 5025 and send/re-
ceive SCPI commands terminated by a newline.
The 10 MHz input can also be selected via this view. When it is selected, a small symbol con-
taining the text EXTREF is displayed in the upper right corner of the GSG display.
In all models except GSG-52 and GSG-53, the PPS output on the rear panel can be con-
figured to send 1, 10, 100 or 1,000 pulses per second. The pulse ratio is always 1/10 (1/10
high, 9/10 low). PPS Out is active on the rising edge of the signal.
IP Configuration
In the Network configuration screen, you can configure GSG either to obtain an IP
address automatically from a DHCP server, or you can specify a static IP address.
To specify a static IP address manually, you must provide:
the IP address
the network mask
and the gateway.
Note: In order for the ephemeris download to work, the correct DNS
address must specified, either by setting Options > Interfaces and Refer-
ence > Network > Obtain IP autom. = Yes, or—when using a static IP con-
figuration—by manually entering the correct DNS address.
NTP Configuration
Under Network configuration, you can also—among other things—enable the current
time, as delivered by an NTP server, to be used as the Start Time, by setting an NTP Server
address.
1. To access the Network configuration view, navigate to Options > Interface and
Reference > Select Interface Type: Ethernet. Then highlight the menu item Net-
work, and press enter; the Network configuration screen will be displayed. High-
light the menu item NTP server, and press enter.
2. Enter the IP address of the NTP server on your network.
Download Server
The download server for the GPS ephemeris and almanac data can be configured under:
Network configuration > Options > Interface and Reference > [Interface Type: set to
Ethernet.] > Network > Network configuration: Download server.
The choices are Default, and [user-entered custom address].
For more information on automatic download of ephemeris and almanac data see
"Ephemeris" on page 47.
Note: In order for the ephemeris download to work, the correct DNS
address must specified, either by setting Options > Interfaces and Refer-
ence > Network > Obtain IP autom. = Yes, or—when using a static IP con-
figuration—by manually entering the correct DNS address.
2. The Proxy address must be the address of the proxy including the http:// -prefix,
and a port number after the address separated by ‘:’. Optionally, a username and pass-
word for the proxy can be given. If in doubt, consult your network administrator
about the Proxy server settings.
Navigating
The top level view shows the directories. To select a directory, use the UP/DOWN
arrow keys and press ENTER.
Select files within a directory by using the UP/DOWN arrow keys.
To go up one level, select “../”.
To perform an action on a file, first select it, and then use LEFT/RIGHT arrow keys
to select the desired action (View, Copy, Rename or Delete).
To return to the previous level, press the CANCEL key. (i.e., this is the same as
selecting “../”. EXIT returns to the main menu).
By selecting Options and pressing the ENTER key, you can also view the available and
installed license options:
For more information on GSG Options, see "GSG Series Model Variants and Options" on
page 203.
3.6.7 Calibration
Note: This chapter describes the Calibration menu items. Calibration itself
should only be attempted by qualified technicians. Alternatively, you can
send your GSG unit to Orolia to be calibrated.
The Calibration view displays when the Factory calibration was done, and if and when
the last User calibration was done.
Calibration Recommendations
Is recommended that you adhere to the following calibration guidelines:
1. Orolia recommends calibration every 2 years to ensure the frequency is within spe-
cification and the power levels are correct.
2. If your unit is equipped with an Ultra-High-Stability OCXO (an option that is no
longer available), Orolia recommends calibration every year for this reference to
ensure operation to specifications.
3. Regardless of which oscillator option is installed in your GSG unit: If you are testing
GPS timing receivers and are testing the precision of the 1 PPS output, comparing it
to the 1 PPS output from your device under test, Orolia recommends calibration
every year.
To carry out a user calibration, highlight Calibrate and press enter. Confirm your choice,
and enter the password, in order to make sure the calibration settings are not changed unin-
tentionally. The password is 62951413 (first 8 digits of π backwards).
Note: It is strongly advised to write down the current values before making
any changes. Once new values are saved, the old values cannot be recalled.
During the calibration, the unit generates an unmodulated signal at full power. Maximum
RF power is measured by a spectrum analyzer connected to the RF output of your GSG
unit.
The OCXO DAC value is adjusted according to the frequency measured by the GSG unit
from the 10 MHz output at the back panel. Using a frequency counter, adjust the OCXO
value until the GSG shows 10 MHz.
The PPS delay is essentially an “equipment delay” of the generated signal. To measure it
properly, you need to measure the difference between the GSG's PPS out (Trigger out)
and the PPS out of a trusted GPS timing receiver. The value is always positive, and is set in
microseconds. Three digits can be given, enabling nanosecond resolution. The allowed
range is [0.000-4.000] microseconds.
Note that if you try to measure this delay, remember to take into account the GPS time to
UTC time offset set in the scenario you use. Timing receivers typically output the UTC syn-
chronized PPS signal.
After the calibration is complete, the new values can be saved by pressing exit or menu.
Press cancel to discard the values and keep the previous calibration settings.
Note: The scenario will continue to run in the background, even if you view a
display other than the "Scenario Execution Views" on page 34.
Note: When you press exit to leave a menu, its settings will be taken into
use immediately, and all band- or satellite-specific offsets are discarded.
Note: Holding a scenario is not the same as arming a scenario (see "Scen-
ario Start Variations" on page 33).
A typical use case for holding a scenario would be to simulate a red traffic light.
Note: For a list of all configurable scenario parameters, see ""Select" Menu"
on page 38.
To navigate between fields, first press the UP/DOWN arrow keys to select the field
label. Then press enter or the RIGHT arrow key, to begin editing the values. To move to
the next field on the same line, press enter, or the RIGHT arrow key. To move to the pre-
vious field on the same line, press the LEFT arrow key.
To proceed to the next View, press view.
To finish editing, press start, exit, or cancel. (With start and exit, you will be given the
choice to save the scenario under a different name.)
Note: Some of the functionality shown is optional and may be grayed out.
For more information on GSG Options, see "GSG Series Model Variants and
Options" on page 203.
For each satellite constellation your GSG unit can simulate (e.g., GPS), you can:
In the Satellites View (see illustration below), set the maximum number of satellites
to be simulated (using the UP/DOWN arrow keys). Or, use the Auto setting, which
lets the GSG simulator automatically select the highest number of satellites available
for the number of channels supported by your GSG unit.
In the Satellites View, you can also configure the number of SBAS satellites (see
"SBAS Satellites" on page 82).
In the Signal Type View, select the signal types to be simulated for the highlighted
constellation (e.g., "L1CA"), and enable (pseudo-P(Y)) encryption (if available).
In the Signal Type View, press the view key to access the Constellation View, which
allows you to specify the Blocks (or the "vintage") of satellites simulated. For more
information about this subject, see "Default Scenario Satellites" on page 190.
The Default setting in the first row of Constellation View, GPS Constellation (or
GLONASS Constellation, respectively) will simulate the satellite constellations as
they existed on April 22nd, 2015.
Note: For a list of all configurable scenario parameters, see ""Select" Menu"
on page 38.
Note: For the different options on how to start a scenario, see "Scenario
Start Variations" on page 33.
To change the keyboard lock code, use the KEYLOCK:PASSWord SCPI command:
Open the , and then the command line interpreter (CLI) by clicking the MONITOR
icon:
Ensure that the CLI is connected to your GSG unit (see "Using the CLI" on
page 116).
Enter the following command: write SOURce:KEYLOCK:PASSWord [wxyz]
The keyboard lock code [wxyz] can be changed at any time. The user-issued lock
code must be 4-8 digits in length, and contain only numerical characters. The default
keyboard lock code is "1122".
This sets the Reference Power which is used to control the absolute power
level of the GPS L1 C/A signal. You can also adjust the default relative power
offset for each individual signal type other than GPS L1 C/A by selecting Sig-
nals power configuration. (For more information, see "Adjusting Transmit
Power" on page 88.)
2. While the scenario is running — by pressing the N/S key:
In Scenario Execution Views 2 to 5/x (see "Scenario Execution Views" on
page 34) highlight dBm for all satellites, or press the LEFT/RIGHT arrow
keys to highlight individual satellites. Then press the N/S key to adjust the
scenario power.
While this option will also open the Transmit Power menu (as under 1. above), it is
used to adjust only the Transmit Power level for the current scenario (running now,
or in the future). All other scenarios will continue to use the default value, or the
value you set under 1.
Note that the adjusted power level will also apply to any new satellites coming into
view later during any execution of this scenario.
3. While the scenario is running — by pressing the press the UP/DOWN arrow keys:
In the Scenario Execution Views 2 to 5/x (see "Scenario Execution Views"
on page 34) highlight dBm for all satellites, or press the LEFT/RIGHT arrow
keys to highlight individual satellites. Then press the UP/DOWN arrow keys
to adjust the Transmit Power level, or enter a new value by using the
numeric keys.
Contrary to option 2., this will only adjust power for the selected satellites in view ,
not for new satellites coming into view later.
Note: If a value is not accepted, it is likely out of spec, see "Transmit Power"
on page 86.
Figure 4-5: Example GSG Web UI, showing a logged GPS almanac file
Note: ALWAYS force a Cold Start, or a full reset of a receiver after it had
been used with generated signals!
One-line trajectories like this can be easily be made by manually creating the desired
NMEA files: The example above can be taken as a baseline, then edit speed and/or head-
ing fields as required.
To allow for testing the sentence's validity, the last 2 digits contain a checksum of the data
(XOR of all bytes between $ and * symbols) – this checksum must be correct and can be cal-
culated with e.g., this online tool: www.hhhh.org/wiml/proj/nmeaxor.html.
Note that the NMEA messages, including the checksums, are case sensitive and should be
given in UPPERCASE even if the GSG unit (firmware version 3.00 and above) accepts
messages in lower case.
To find out more about NMEA, and purchase a copy of the NMEA 0183 Standard, visit
www.nmea.org.
To learn more about trajectories, see: "Trajectories" on page 43.
receivers must correctly implement the leap second at the proper time.
To configure a leap second for a scenario, Select the scenario, then navigate to the con-
figuration View 2/3:
Note: GSG StudioView requires a license to activate all features after the
30-day trial period. After the trial period, all features are locked out except
for the Uploader . The Uploader is used to perform firmware updates or
upload scenario files to the GSG.
To install StudioView:
1. Download the software: https://files.spectracom.com/public-downloads/gsg-
56-update-files-and-documentation
2. Locate the downloaded .exe file, and launch it. Follow the on-screen installation
instructions.
3. Towards the end of the installation process, among other things you will be asked if
you want to install the National Instruments VISA driver: This driver is required for
Studioview to communicate with your GSG unit, so please check the box (unless you
do not plan to connect your PC to a GSG unit).
4. Save the VISA runtime .exe file, and launch it to install the driver.
The topic "Connecting StudioView to GSG" below describes how to establish com-
munication between StudioView and a GSG unit (or any other device on the network).
2. Select the Interface type that matches your hardware configuration, i.e. the con-
nection between the GSG unit and the StudioView computer: TCP/IP, USB, or GPIB
(note that SCPI-Raw does not work with StudioView).
3. In the same menu dialog, take note of the Network address displayed.
4. Launch StudioView on a PC. From the main menu, or the TOOLS dropdown menu,
select the tool you would like to use e.g., the GSG web interface , the Uploader
, or the Data recorder .
5. In the tool window, next to the Address field, click the Connections button. The
Connections Manager window will be displayed, showing a list of previously cre-
ated connections:
If you can see the connection pointing to your GSG unit, click it and then click OK. To
refresh the list and search for more GPIB or USB devices, press the Refresh but-
ton. Otherwise click the Add icon to add a new connection:
6. Enter the IP address that was displayed under Step 3. above, and click
to validate the connection. Click OK to close validation dialog. If the connection was
successful, click OK to add this connection.
7. Highlight your connection (blue background) and click OK. The StudioView tool win-
dow should now show the connection to your GSG unit. (Note: The actual
connection (e.g., for the Data Recorder) will not be established until you press the
Start button.)
Note that for uploading scenarios the Uploader is the preferred tool over the File Man-
ager (see "Transferring Files With StudioView" on page 127), since the Uploader
automatically uploads all files belonging to a scenario. The File Manager is meant to trans-
fer individual files e.g., a standalone trajectory file.
In order for GSG to communicate with StudioView, the NI VISA Run-Time engine is
required, which can be downloaded directly from the National Instruments website.
1. Once VISA Run-Time and GSG StudioView are installed, start GSG StudioView.
From the Application Tips screen, or from the toolbar under Tools, select
Uploader.
To obtain your GSG's IP address or change the interface type, select Interface and
Reference from the GSG Options menu:
Note: This screen may vary, based on your installed firmware version.
Uploading Firmware
1. In order to update the firmware onto your GSG unit, in the StudioView Uploader,
click the Open Folder button (next to Select file for uploading), and navigate to
the downloaded firmware file on your PC.
2. Click the Start button to start the transfer. The unit will first transfer the file, and
then update the firmware.
Uploading a Scenario
1. In order to upload a scenario, first ensure that the scenario file (.scen file) and any
trajectory, event, or navigation file associated with the scenario are stored in the Stu-
dioView repository. By default this location is:
C:\Users\username\Documents\Spectracom\GSG StudioView\Repository
Note: The username location may depend on your version of the Win-
dows operating system you are using.
2. In the StudioView Uploader window, click Select file for uploading, and nav-
igate to the scenario file in the repository.
3. Click the Start button to start the upload. The software will automatically upload the
scenario file as well as any trajectory, event, or navigation file associated with that
scenario, and place the files in the proper locations in the GSG.
Note: Note that for uploading scenarios the Uploader (see "Uploading Stu-
dioView Files" on page 125) is the preferred tool over the File Manager ,
since the Uploader automatically uploads all files belonging to a scenario.
1. Open the File Manager tool by navigating to Tools > File Manager, or click .
2. Establish a connection to the GSG unit by clicking . (For details, see "Connecting
StudioView to GSG" on page 122.)
3. Once a connection has been established, you should see GSG's file/folder tree in
the left window, and StudioView's file list in the right window:
4. Double-click on any folder to open it. Click on the top folder to navigate to the
next higher folder. Highlight any file in order to F5 Copy or F8 Delete it.
1. In StudioView, open the GSG Web Interface by clicking the Globe button (or – if
not using Studioview – see "Accessing the GSG Web Interface" on page 115).
2. Select GSG FILES in the top-left corner. Then select the observations/ directory.
Click on any file to display its contents. Click the green arrow in the top right corner
to navigate back to the file listing.
3. Download a file by right-clicking on it and selecting Save target as ...
2. Click to open the Connections Manager tool (for details, see "Connecting Stu-
dioView to GSG" on page 122.)
3. After setting up the connection, a visual representation of the front panel will
appear:
You can control the unit as if physically pressing the buttons on the unit.
To access the files stored on the GSG unit, click the GSG FILES button in the top left
corner.
1. Click or navigate to Tools > Console. The Console window will display:
2. Click to open the Connections Manager tool (for details, see "Connecting Stu-
dioView to GSG" on page 122.)
3. The following generic commands are supported (to display this list in the console
window, type list.):
clh – clear commands history
cls – clear console screen
connect <resource1> – connect to a specific GSG unit
disconnect – disconnect from currently connected device
list – print the list of available commands
loop <interval> <SCPI command> – execute specific command in a loop with
specific interval in milliseconds between repetition
query <SCPI command> – send SCPI command to connected device and
read response string of connected device
read – read the response string of connected device
write <SCPI command> – send SCPI command to the connected device
GSG has en error queue that can be checked automatically after every execution of a com-
mand. To enable or disable this function, click .
What is a Trajectory?
In the context of GNSS testing, a trajectory is the predefined path a receiver is traveling
during the execution of a scenario. It is the input to the scenario that defines how the vir-
tual vehicle will move in up to 6 degrees of freedom during the test (X, Y, Z; pitch, roll,
yaw).
While the definition of the vehicle path itself is an important constituent of any scenario,
the GNSS signal reception at any given time during scenario execution is of equal import-
ance, since the reception will be affected by these trajectory-dependent factors:
The environment along the trajectory changes: Infrastructure blockages such as tall
buildings ("urban canyons") or other topographic characteristics will cause the signal
reception to vary.
1A resource string (e.g., "TCPIP::10.32.1.203::inst0::INSTR") can point to a USB or GPIB connection. It is generated auto-
matically when you add a new connection and its IP address becomes validated.
The attitude of the vehicle in motion can affect signal reception due to on-vehicle
blockages and antenna affects.
The acceleration/jerk in the context of position and attitude can have a significant
effect on signal reception.
Ultimately, the objective of any test is to determine how the receiver/the system under
test responds when subjected to the above-mentioned control factors and noises.
Trajectories generated by means other than (a.) should always realistically reflect the dynamic
capabilities of the type of vehicle in motion e.g., car, aircraft, ship. To this end, Orolia recom-
mends using ‘smooth’ methods to describe the movements, i.e. changes in acceleration, head-
ing or altitude should be gradual, not sudden or ‘hard’.
When using coordinates to describe a trajectory, the data must be provided in 10 Hz format and
must not contain sudden changes in speed, direction or elevation; GNSS receivers generally
are very sensitive to G-force and unrealistic movements will result in the receiver losing track
of the signals.
The vertical toolbar on the left side of the screen provides access to the Trajectory
Editor's functionality:
Note: A little blue box indicates that a feature is active (except "Export ...").
Some features cannot be active at the same time.
1. Parameters Display/hide the Waypoints table on the right side of the screen.
panel
3. "Drag only" Drag (pan) in Google Maps™, while avoiding inadvertent insertion of way-
map mode points.
5. "Search" Access the Google Maps Search functionality (enter the name of a loc-
panel ation, or WGS-84 coordinates).
6. "Build Opens a panel in Google Maps that is needed to build a route. (Consider
route" this to be the Trajectory Editor's main tool.)
panel
1. In the StudioView Trajectory Editor, click the Route Builder icon . (See also
"Using the Trajectory Editor for the First Time" on page 132.) The Build route
panel will open:
Note: To search for particular place on the map, but not set a way-
point (yet), click the Search icon. Note that any previously set way-
points will NOT be lost.
5. Once all the waypoints for the new route are set (you can add waypoints later), click
the Route builder button in the lower right corner of the panel. The route will be
built. The Waypoints table and the Velocity and Altitude chart will be populated.
Editing a Route
While a route built with the help of Google Maps would suffice to be used in a scenario, it is
advisable to add or change some additional altitude and speed data, thus developing the tra-
jectory further into a realistic trajectory. Also, you may want to edit individual waypoints, or
add a stop.
Note: You can also edit the route of an existing trajectory. To import an
existing trajectory, see "Transferring Files With StudioView" on page 127.
Open the trajectory by clicking File > Open. Make sure you have selected
the correct file format (the default is "All supported files"), then locate the
file you want to open, and click Open. The Trajectory Editor window will
open automatically.
Double-click on any waypoint to edit its elevations, its coordinates, or the speed set-
ting.
You may enter geographic coordinates in any of Degrees, Deg Min, Deg Min Sec
format or ECEF coordinates. StudioView will recalculate the other formats auto-
matically.
Note that altitude values are not MSL, but above the surface of the ellipsoid.
Table 4-2: Speed conversion table (Note: mph and knots are rounded down.)
Note: When changing speed settings, the time values in the Waypoints
table will be updated automatically.
SHIFT-right click or CTRL-right click any group of waypoints to batch-edit their settings
by clicking .
Add or delete waypoints by clicking the + icon, or the x icon, respectively. By default, Stu-
dioView will insert the waypoint at the end of list. However, you may manually set a Point
#, which will add the waypoint to that place in the trajectory.
Select a waypoint in the Waypoints table, and then drag its Google Maps pin to relocate it.
Add a brief stop (e.g., to simulate a red stop light) by highlighting any waypoint and clicking
the STOP button. Enter the stop duration, and the speed at which to continue after the
stop.
To save the trajectory, click , or select File > Save. The default file format is .nmea.
Note: Note that the .csv format represents StudioView waypoints table
from the Trajectory Editor and therefore has the same fields. Working
with .csv files, StudioView assumes that for each waypoint the .csv file will
have four values: Latitude, Longitude, Speed and Altitude.
Trajectories should always realistically reflect the dynamic capabilities of the type of vehicle in
motion e.g., car, aircraft, ship. To this end, Orolia recommends using ‘smooth’ methods to
describe the movements, i.e. changes in acceleration, heading or altitude should be gradual, not
sudden or ‘hard’.
When using coordinates to describe a trajectory, the data must be provided in 10 Hz format and
must not contain sudden changes in speed, direction or elevation; GNSS receivers generally
are very sensitive to G-force and unrealistic movements will result in the receiver losing track
of the signals.
In StudioView, open the Trajectory Converter tool by clicking the icon, or navigate to
Tools > Trajectory converter:
1. Select the Input trajectory you want to convert by clicking the file folder icon.
2. Decide what to do with the new trajectory and then select one of the 3 available
options:
With the latter two options, click the lower file folder icon, and select a file loc-
ation and file format .
3. Select a Preset (Car, Aircraft, Ship) to pre-populate the fields below. Click Apply.
4. Adjust the parameters as described under "Converting a Trajectory in StudioView"
on page 136 and click to begin the conversion. Look out for possible
error messages and follow the screen instructions to resolve any found issues.
In StudioView, open the Trajectory Converter tool by clicking the icon, or navigate to
Tools > Trajectory converter:
Apply changes to the original trajectory as needed, following the tabs from left to right.
The diagram below illustrates some of the parameters.
Downsampling
Downsampling means decreasing the number of points in a trajectory, so as to make those
parts of a trajectory with constant movement parameters as long as possible. The down-
sampling algorithm excludes points which are within a specified deviation from the general
movement direction. If your trajectory uses a substantial number of points, it is strongly
recommended to apply downsampling.
Enable it by checking the box on Downsampling tab. To define a deviation, select an Inac-
curacy estimation type , and enter a max. value for it. Also enter a maximum speed
change for the trajectory segment.
Smoothing
Smoothing is used to adjust movements parameters that are critical for the receiver per-
formance. By changing the smoothing parameters, you can achieve more realistic speed
changes and turn abrupt heading changes into more realistic gradual turns. Enable it by
checking the box on the Smoothing tab. The smoothing algorithm will add points to the
trajectory as determined by the algorithmn.
The Max rounded distance is measured from a particular rounded point.
The Max rounded segment percent represents the value of the maximum roun-
ded distance in % from the rounded point relative to the length of entire trajectory
segment. The segment of the trajectory refers to any part of a trajectory between
two consecutive points.
The Max angular velocity defines the speed of a turn. While rounding angels of tra-
jectory, resulted angular speed will be interpolated within specified limit.
The Max vertical velocity defines the maximum permitted vertical movement
between consecutive points. If the altitude has changed between two consecutive
points, it will be interpolated, applying this not-to-exceed vertical velocity.
The Heading change threshold defines the maximum change of movement dir-
ection at any particular point. If the actual value is greater than the heading change
threshold, the trajectory will be rounded at this point.
The Max acceleration in m/s². (3.8 m/s² is a typical value for a performance car [0-
60 mph in 7s]).
Interpolation
Interpolation allows to add points to the original trajectory. Enable it by checking the box
on the Interpolation tab.
An Interpolation step value of 1 per second generates 1Hz data.
Equalization
Use equalization if a steady speed or constant altitude is needed. The value entered will be
applied to all waypoints of the trajectory.
Note: This feature only works if the file type of both the Input, and Output
trajectory is NMEA, and if the Output destination is set to Write to file.
Note that RSG trajectories must be built prior to running them. However, there is also the
concept of feeding trajectory data into the GSG unit in real-time, i.e. while the trajectory is
being generated: This functionality requires the option kit OPT-RSG, which allows the GSG
unit to receive trajectory information in real-time from e.g., a motion simulator or a computer
running simulation software.
4.9.11.1 Using the RSG Trajectory Editor for the First Time
In StudioView, click in the main toolbar, the Tools menu, or in the StudioView
Application Tips startup screen. The editor screen will show (the image below shows
a loaded scenario for illustration purposes.)
The editor has three panels:
1. The left panel shows a list of all RSG commands for the trajectory currently
open (if any).
2. The corresponding trajectory is visualized on the Google Map on the right.
3. The charts below the m ap show speeds and altitude over time.
Note that this data actually is not part of the trajectory, it is used only to assign a rel-
ative location to the trajectory. You can later change this location, thereby moving
the entire trajectory to a different place (unless the trajectory includes geographic
or ECEF position change commands).
2. To add a new command to the list, highlight the command after which you would
like to insert the new command by clicking it. Then click the button. The RSG
Command Editor window will appear:
Select the command you want to use, and enter the required parameters. Detailed
command descriptions can be found in the "SCPI Guide" on page 223.
Note: With some of the other commands, the KEEP GOING com-
mand is created by StudioView (you may still need to assign a dur-
ation manually).
5. Next, create a turn e.g., by 180° within 5 minutes: While this can be accomplished
with the command sequence RATEHEADING, KEEP GOING, STOP, this would
require some calculation to determine that the course rate change for this turn is -
0.6°/s. Instead, use the Maneuver command Turn, and define the Direction change,
or the radius of the turn:
For the turn, select Left, Direction change: 180°, and Duration: 5 minutes.
6. Lastly, repeat all of the steps above to complete the racetrack pattern (replace the
heading with the opposite heading).
Note: The preferred way to describe space vehicle trajectories are TLE-
formatted trajectories, see "Trajectory Two-Line Element Format (TLE)"
on page 363.
2. Use the File or Editor radio-buttons to select the source RSG trajectory (.traj file
extension) for realtime playing.
3. Click to open the Connections Manager tool (for details, see "Connecting Stu-
dioView to GSG" on page 122.)
to the GSG unit. The GSG unit will execute the simulation in accordance with the para-
meters specified in the scenario file.
Scenario data is stored in a text file. To show/hide text of scenario file, click .To con-
figure the scenario, fill in the appropriate fields under the tabs described below.
Once you have completed your scenario configuration, save it and upload the scenario file
to the GSG unit by clicking .
Note: StudioView stores all files in a directory chosen during the installation
process. By default, the repository is located at C:\User-
s\UserName\Documents\Spectracom\GSG StudioView\Repository. You
may save your scenario in any other folder, but please note you must also
save any trajectory, event, antenna pattern, or navigation files you may
want to include to your scenario in the same folder.
The Scenario Editor provides access to all essential scenario parameters. To access the
Scenario Editor, click , or navigate to Tools > Scenario Editor:
General tab
Under the General tab, you can edit basic parameters like Start time, Duration and Start
position:
The Start time is specified using GPS Time. The GPS Time is always used when dis-
playing time. This is not equal to the UTC time frequently displayed by the receivers.
Contrary to the GPS time, UTC contains leap seconds.
The Start Time can be a set time, or the current time derived from an NTP server
specified in the Network Configuration settings of GSG device. To use this feature,
check Synchronize from the NTP server checkbox.
If the current time from the NTP server is used, next the startup will be delayed up
to 2 minutes to allow the simulation to load required data. The start time is aligned to
the next full GPS minute. The NTP (UTC) timescale is converted to the GPS times-
cale by a UTC-GPS offset defined in the NTP server settings.
Using NTP as start time in conjunction with Ephemeris set to Download is subject to
licensing options, as it requires the Simulate Now option to be present. In this con-
figuration, the GSG will simulate the sky as it is in that start position at current time.
This functionality is currently only available for the GPS constellation. Please also
note that the availability of good ephemeris data cannot be guaranteed, but periods
where no data is found and hence no signals can be generated, may occur.
The Duration of the scenario replay can be set to a number of days, hours and
minutes. The scenario can be set to:
Looping, means that scenario will restart again right after execution is fin-
ished
Forever, GSG will download needed navigation data from Internet and run
scenario until user will stop it
One-go, in which case it executes only ones and then returns to main menu of
GSG device. Note that the option “forever” only works when the Ephemeris
option is set to ‘Download’ (Start) Position.
The Start position is specified using WGS84. Note that this also concerns the alti-
tude (ellipsoid height) and that this is not the same as the MSL often output by
receivers. StudioView provides automatic conversion between different coordinate
input formats; decimal degree, degrees-minutes, degrees-minutes-seconds and
ECEF format.
Signals tab
Under the Signals tab, you can determine which satellite signals you want to use, the type
of environment, and possible Interference signals:
Under this tab, you can explicitly set the maximum number of satellites to be sim-
ulated, with separate settings for GPS, GLONASS, Galileo and Beidou. When the
Auto keyword is used, the GSG unit will automatically select the highest satellites
available and generate the maximum number of satellites that your GSG model
allows. You can also configure the number of SBAS satellites to be simulated.
It is possible to configure the frequency bands and possible (pseudo-P(Y))
Use checkboxes to include or exclude a particular frequency band (e.g. L1, L2, E1,
L2 P, etc.) from your simulation scenario. If a checkbox is grayed, it means that it is
not supported or the only displayed choice is available.
There can be 0, 1, 2, or 3 SBAS satellites per scenario. The GSG unit will select
SBAS SV based on their elevation with respect to the user position. When the scen-
ario is running the SBAS satellite positions and speed will be updated with the
information found in the SBAS messages. You can also select specific SBAS satel-
lites by their IDs (up to 3 total).
Under Propagation environment you can select an environment model which will
impact signal propagation. There are four models available:
Urban
Suburban
Rura
Open (full clear view of the sky, i.e. no obstructions).
The simulation is carried out based on probability, applying different building dens-
ities (sparse <> dense). The feature offers some adjustability. For more information,
see "Propagation Environment Models" on page 69.
By specifying the Elevation mask, you define the satellite-in-view cut-off range. All
satellites which are below this range will be dropped off and replaced with bet-
ter/higher satellite (if available). For more information, see "Elevation mask" on
page 61.
You may also add Interference signals and Multipath signals to the scenario. The
maximum number of Interference/Multipath signals is 8.
Interference signals are used to degrade the reception of GNSS receivers. To add an
Interference signal, click . To add a signal, use default values or specify Inter-
ference signal parameters by expanding the list. You may also collapse or expand all
items by clicking on the closed book or open book icon, respectively. To delete an
Interference or Multipath signal, click .
Navigation tab
Under the Navigation tab, you link files that describe the trajectory, events, environment,
vehicle model and navigation data to your scenario:
Any user trajectory can be simulated using the GSG. You can choose to use one of
the built-in trajectories or upload a trajectory file created in the Trajectory Editor or
RSG Trajectory Editor of StudioView. To select one of built-in trajectories, click on
Circle, Static, 3GPP and set up parameters if needed.
To attach a pre-installed trajectory or your own trajectory to the scenario, click File
and pick a trajectory file from the dropdown menu. To add your own trajectory file to
this dropdown list, you have to create a new trajectory first and then save it in the
repository.
An Events file describes some specified events during scenario execution. To create
events file, see "Defining Events in StudioView" on page 155.
Support for environmental or vehicle models in GSG simulators is via compressed
keyhole markup language files (kmz) popularized by Google Earth. A simple way to
create these files is with the tool SketchUp available from Trimble ® Navigation, see
https://www.sketchup.com/.
An Environment model is a 3D model of the environment, describing terrain, build-
ings, etc. All environment models used must have a ‘geo-location’ added to them
before they can be used by in simulation. Environmental Modeling is used first and
foremost to simulate urban canyons, or tunnels. You can create blocks, representing
buildings/obstructions, and place them on the map along the trajectory. The power
level of the satellites will be blocked or reduced in the vicinity of the buildings due to
the obstruction of the line of sight near these virtual buildings.
A vehicle model represents a 3D model of the vehicle. The vehicle model will move
with the simulated trajectory. The vehicle model will also follow any pitch/roll/yaw
movements simulated, i.e. if the vehicle rolls by 90 degrees, half of the sky is likely to
be blocked by the vehicle itself, depending on vehicle model used. The body center
of the simulated vehicle will be in the origin position of the model. The antenna pos-
ition can differ from the body center position by configuring lever arm values in the
scenario configuration. The antenna position can also be specified in the vehicle
model file by adding a component named “RecAnt”. If both lever arm and RecAnt
are set, the receiver antenna position as set in the vehicle model takes the pre-
cedence. The vehicle model does not need a geo-location.
Vehicle models can also be created with the software tool “Sketchup”, see above.
If a satellite is blocked by an object from either the environment or vehicle model, i.e.
it is not visible by the receiver antenna, its power level is set to OFF.
For more information, see
https://www.orolia.com/documents/environmental- modeling- gpsgnss-
simulators.
GSG can successfully handle vehicle models with up to 130 triangles and models
should be optimized for low polygon count. The triangle count is limited to a total of
300 for the combined environment and vehicle models.
Navigation data allows you to specify Almanac and Ephemeris files to be used dur-
ing simulation. Next to the Default option, you can download navigation data from
the official web sites, or use your own Almanac or RINEX files. For more information
on RINEX files, see "Editing RINEX Files in StudioView" on page 170.
To download navigation data from the official web sites, click , and then click
. The navigation data for the scenario start time and number of satel-
lites you specified under the Signals tab will be downloaded. To add the navigation
data files to your scenario, click and select the files needed.
To edit navigation data in the RINEX editor, select the file from the list and click .
200D, section 20.3.3.5.2.5. When set to Off, no delays caused by the Ionosphere
are used in the simulation. GSG also supports simulation of Ionospheric delays using
files in IONEX format. To specify a particular file, select Files and choose it from
Repository.
Antenna tab
Under the Antenna tab, you determine which type of antenna you would like to simulate,
as well as the lever arm, which specifies the antenna position relative to the vehicle center
of movement.
RTK tab
Under the RTK tab, it is possible to simulate a virtual Base Station: Specify its geographic
coordinates and altitude, as well as an RTCM protocol version and type of RTCM messages
to be simulated.
Adding an Event
To set the type of event, choose an option from the Event type drop-down menu:
Change absolute power: Defines a power level for a given channel or PRN code.
Change relative power: Defines a change in the power level for a given channel or
PRN code.
Create new multipath signal
Delete multipath signal
1Pseudo-Random Noise
Note: This functionality is used with the VTS System (Vulnerability Test
System), which includes a GSG spoofing license.
A spoofing test in StudioView exposes the device-under-test not only to the authentic Sky
signal, but also to a second signal generated by the Spoofer. This second signal can be
used to challenge the capability of the receiver to discern between the genuine and the
fake signal. Several parameters can be adjusted to tweak the test scenario, if needed.
The testing environment illustrated below is used to test a system against spoofing vul-
nerability.
1. Navigate to Tools > . The Parameters panel will open (the Status tab is
used during the scenario execution, see "Running a Spoofing Simulation" on the
next page):
Spoofer
Connection: Open the Connections Manager to establish a con-
nection to the device that generates the spoofing data (simulated,
recorded, or live sky)
Scenario: Select a scenario for the "spoofed" simulation.
Use the same scenario as for sky: [Yes/No] Check if you want to use
the same scenario for both the sky data, and the spoofing data.
Sky signal parameters
Sky power (dBm): Select a signal strength for the authentic signal.
Spoofer signal difference to sky signal
Time offset (ns): Determine by how much the spoofed signal's time
shall be offset from the sky signal's time. The time is not directly related
to UTC, it only states the time difference between two signals.
Position offset (m): Determine by how much the spoofed signal shall be
offset from the sky signal.
Power above sky (dB): Determine how much stronger the spoofed sig-
nal shall be in comparison to the sky signal.
Receiver
Use receiver: [Yes/No] Determine if you want to feed the GNSS
receiver data into StudioView during the simulation.
COM port: Determine to which port the receiver is connected
Automatically start spoofing immediately after position fix: [Yes/No]
Determine when to start the spoofing. When checked, StudioView
starts spoofing immediately after the receiver can determine its pos-
ition. If unchecked, the field Time to wait for position fix before
starting spoofing (see below) is used to determine the spoofing start
delay.
Other
Time to wait for position fix before starting spoofing: [min:sec]
Determine when to start the spoofing.
Click the Start button in the bottom-left corner. The following parameters will be
updated in real time:
LiveSky position: Provides the actual position, as determined using the live sky
satellite data.
Receiver visible position: Provides the actual position, as measured by the
receiver.
Spoofer generated position: Provides the position, as calculated using the
spoofed signals.
Spoofing is running: Tells if the spoofing signal is active at this moment.
The chart on the right will visualize the 2D error, as well as the 3D error between the
LiveSky position and the receiver-visible position.
6 months for WAAS scenarios. Moreover, the start time shall not be too close to the cur-
rent time. For EGNOS, there can be a one day delay before the SBAS messages are pub-
lished on the FTP site. For WAAS the delay can possibly be longer (up to 3 or 4 days).
The Internet connection is not always needed. All downloaded ephemeris data and SBAS
data will be locally stored on the unit once they are downloaded. So, the next time the
same scenario runs, the ephemeris data and SBAS messages are read from the local stor-
age and no Internet connection is needed. The unit performs automatic clean-up of down-
loaded files. Such clean-up will occur when free disc space is less than 20% of the total disc
space.
Note: Currently SBAS corrections are not ‘applied backwards’ to the out-
putted GPS signals, even though the corrections will be transmitted in the
SBAS signal.
Note: This is an optional feature for which the Record and Playback option
(OPT-RP) is required.
The Record and Playback software converts recorded NMEA messages into scenario, tra-
jectory, and event files. You can then upload these files to your GSG unit where they can
be played back in order to recreate the original scenario.
1. While traveling in a car along the planned test route, record NMEA data by using a
GNSS receiver and antenna (included in the OPT-RP kit), connected to a laptop
computer with StudioView installed on it. StudioView will record the data generated.
2. Run the recorded trajectory through the Scenario Generator in StudioView. Note
that your StudioView computer must be connected to the GSG unit, and that the
OPT-RP option must be enabled.
StudioView will automatically generate the scenario, event and trajectory files for
you.
3. Upload the generated scenario files to your GSG unit, and playback the scenario.
1. Check the box GSG unit, then click to configure the connection (for details, see
"Connecting StudioView to GSG" on page 122.)
2. Choose which data to record: Navigation data, Observations, RSG data, Satellites
data (e.g., satellite position, Doppler shift, etc), navigation messages.
Select Output files for each recorded data category.
3. As an option, the NMEA data can also be redirected to a serial port e.g., to use it
with a device that utilizes real-time NMEA data (such as a marine plotter). If so
desired, select and configure the port to be used to redirect the data.
Or, load the desired scenario on your GSG unit, and click .
DO NOT start the scenario via the GSG unit, since the RINEX navigation data will not be
captured! (Unless you manually submitted the SCPI navigation data logging command.)
Once data starts to be generated, the Data Recorder will display the incoming raw data in
the bottom section of the Data tab. Under the View tab (top-left corner of the screen) you
can also visually display the progress in real-time on the Google Map and see a skyplot with
all visible satellites, as well as velocity and altitude charts.
Note: This is an optional feature for which the Record and Playback option
(OPT-RP) is required.
Part of the StudioView Record & Playback workflow (see "Record and Playback" on
page 163) is to augment and convert the data previously recorded (see "Recording Data
with StudioView" on page 165) so that it can be played back as a scenario on a GSG unit.
This conversion is done with the StudioView Scenario Generator tool.
The Scenario Generator translates the GGA, RMC and GSV sentences1 contained in the
NMEA into a syntax that is used by GSG scenario, trajectory and event files. These files are
required to playback the recorded data on a GSG unit.
Note: The GSG unit requires an internet connection to replay the recorded
data.
1For example, the GGA and RMC sentences contain position, speed, heading and altitude information, while the GSV sen-
tences record which satellites had been in view and what had been their power levels at any given time during the tra-
jectory.
2. Click to open the Connections Manager tool (for details, see "Connecting Stu-
dioView to GSG" on page 122.)
3. Select your recorded NMEA file as the source file by opening the file dialog and
navigating to file.
The Scenario Generator uses the GSG default scenario parameters for the Play-
back function. To review these default parameters, open the Scenario Editor.
4. Alternatively, you can select a different scenario as a template, in order to use non-
default scenario parameters: Click next to Scenario template, and locate the
scenario you want to use as a template on your PC.
If you want to use the GSG default scenario parameters, you can leave the Scenario
template blank.
5. Populate the following settings:
No thermal noise (dBm/Hz): On the GSG, signal strength is specified in
dBm. The Record and Playback generation relies on a decibel offset value.
This offset value maps the NMEA signal strength (in dB) to the GSG signal
strength (in dBm). An offset value of [‐
160] is recommended to begin with.
This value can be adjusted up or down until the offset is satisfactory.
Stationary period (s): Choose to add a stationary period to your trajectory if
the movement starts immediately. If the recording already contains a sta-
tionary period, then adding an additional one is not necessary.
SNR change threshold: The Signal-to-noise ratio (SNR) is used to compare
the level of a desired signal to the level of the background noise. SNR is
expressed in decibels (dB) and is used to describe the GNSS signal strength in
NMEA‐ 0183 GSV sentences.
6. You may also choose Actions after generation is complete. Use the drop-down
menu to choose to open the files in the editors or open the Uploader to load them
onto the unit.
7. Click Generate to create the files.
Open the RINEX Editor by navigating to Tools > Rinex Editor, or by clicking .
The Editor window will open:
The following dialog box will appear if you double-click on a highlighted GPSA or GPSB
row:
The Time Correction toolbar allows you to change the A0 and A1 coefficients, Reference
Time and the Continuous Week Number. Double-click a highlighted row to open the fol-
lowing dialog box:
Under the Leap tab you can change the Leap seconds, Week number, an Day number.
Under the Data tab you can change the health of satellites. In each cell, you can enter a
number directly, or click the Edit button and select a value from the dropdown list:
To edit multiple cells at once, select the cells by holding down the Shift or Ctrl key while
clicking, and then click the Edit button.
2. Click to open the Connections Manager tool (for details, see "Connecting Stu-
dioView to GSG" on page 122.)
The button will appear, with a counter of all the RTCM messages
transmitted.
Note: The information and text displayed on your computer screen will vary
depending upon the configuration of your GSG unit.
For more information, and instructions on how to access the Web UI, see "Accessing the
GSG Web Interface" on page 115.
5.2 Messages
Below is a listing of messages, as they may appear in message dialog boxes. The text below
each message explains its meaning, context and – if applicable – suggested remedial
action.
Password is invalid.
Calibration password entered is invalid. Try again.
Save calibration?
After manual calibration you can choose to save or not save the values.
File missing.
The navigation data file was missing when starting the signal generator. Select another
option in the ephemeris list and try again.
No text entered.
When giving name for a file, the name is empty. Please enter a file name.
File is in use.
The file for a given file manager operation (Copy, Rename or Delete) is performed is in use.
You can choose whether to continue the operation or not. If the scenario in use is deleted,
the current scenario becomes “None”.
No scenario selected.
This happens when the current scenario is “None” and scenario execution is started. Select
a scenario to be executed.
No scenarios available.
This message appears when there are no scenarios in the scenarios directory. Reset fact-
ory defaults to restore the default scenarios, or transfer your own scenarios from a PC
using the StudioView software.
Note: Restoring factory defaults on the unit will also reset this file to the
factory default for the unit.
Using the GSG Web UI on a connected PC, click on GSG FILES, then navigate to
observations, and click on executionlog.txt.
The maximum size of the execution log file is 20,000 lines. Once the limit is reached, the
oldest entries will be overwritten by new data.
Please note that the log is not updated in real time, but is updated when a scenario stops,
for example.
Also note that the log will be deleted when a Clean & Restore operation is performed, i.e.
when restoring the unit to factory default configuration (Options > Reset to factory
defaults).
After each six hours or when the scenario is stopped, the navigation data is saved to:
/observations/scenarioNameYYYYMMDDHHMMSS.nav
The generated files can be retrieved via GSG StudioView, the Web UI, or by using SCPI
commands (see "MMEMory:COPY" on page 321).
Additionally, a link named /observations/latest.nav points to the latest generated
file.
The files are in RINEX 3.0.2 mixed format. As the unit generates new navigation data
sets quite rarely, it is recommended that navigation data logging is enabled before starting
a scenario. Navigation data logging is turned off when scenario stops.
Note: This file will be overwritten every time a new scenario is started, so
only the YUMA file for the last run scenario will be available.
The almanac file will be empty, if GPS satellites were not included in the latest scenario
executed.
The following is an example of one entry in the almanac file:
******** Week 755 almanac for PRN-01 ********
ID: 01
Health: 000
Eccentricity: 5.8191653807E-04
Time of Applicability(s): 233472.0000
Orbital Inclination(rad): 0.9597571420
Rate of Right Ascen(r/s): -8.1828408482E-09
SQRT(A) (m 1/2): 5153.650309
Right Ascen at Week(rad): 1.2710842193E+00
5.8.2 Requirements
In order for the RLM simulation to work with GSG, the following pre-requisites must be
met:
The Galileo-Option OPT-GAL must be present
GSG-5 or -6, with 8 channels (or 16 channels if GPS + GAL is required)
Firmware version 6.6.1 or greater
StudioView software Version 4.6.1.3 or greater
For automated testing e.g., when integrating GSG into a larger test system, a SCPI pro-
gram can be written. In this case, StudioView would not be needed.
More advanced scenarios, events, and trajectories can be found in the StudioView repos-
itory.
powerChange DECIMAL
powerInterval DECIMAL
InterferenceSignals INTEGER
[InterferenceSignal INTEGER]
GPSL1CA 1 | 0
GPSL1P 1 | 0
GPSL2P 1 | 0
GPSL2C 1 | 0
GPSL5 1 | 0
GPSPY 1 | 0
GLOL1 1 | 0
GLOL2 1 | 0
GALE1 1 | 0
GALE5a 1 | 0
GALE5b 1 | 0
BDSB1 1 | 0
BDSB2 1 | 0
QZSSL1CA 1 | 0mode 0 | 1 | 2 | 3
SatId INTEGER
Power INTEGER
FreqOffset INTEGER
JammerPosition DECIMAL degN DECIMAL degE DECIMAL m | Not set
StartOffset DECIMAL
EndOffset DECIMAL
SweepTime INTEGER
RtcmConfig 3x,INTEGER [,INTEGER*]
GpsToUtcOffset Auto | Rinex | <INTEGER>
Keyword Parameters:
StartTime Valid date in the format: Start time in the GPS Time time frame.
MM/DD/YYYY Note that seconds must be set to zero.
HH:MM:00 When scenario ephemeris data is set to Download,
Source then StartTime must be in the past (typically with a
Valid range limited to: 1-day added margin) to allow the data to be avail-
MIN GPS: 00:00 on 6th able for downloading.
of January 1980 The optional Source value defines where the sim-
MIN GLONASS: 00:00 ulation gets its Start Time.
on 1st of January The default value is set.
1996MAX: 23:59 on 31st 0 – Set (fixed value)
of December 2100 1 – NTP (current time)
Source: [0, 1]
Ephemeris Keyword or filename. Default indicates that the unit will re-use internally
Available keywords: available files to build a navigation data.
{'Default', 'Download'} 'Download' means that the unit attempt to down-
load the data from ftp site.
Default: 'Default'
Filenames are used to specify RINEX and
GPS/QZSS YUMA Almanac navigation files.
Several files are separated by comma.YUMA
almanac files are identified by the .alm case- insens-
itive file extension.
The old keyword NavigationData has the same
meaning as keyword Ephemeris and is accepted
for backward compatibility.
Duration DAYS HOURS The REPEAT value indicates what the scenario
MINUTES REPEAT will do once scenario has reached its end.
where the values are 0 – stops
INTEGER values with 1 – re-starts
the following ranges; 2 – forever.
DAYS: [0, 31] The 'forever' option (2) requires Ephemeris to be
HOURS: [0, 23] set to Download.
MINUTES: [0, 59]
REPEAT: [0,2]
GpsSatellites [-1, 5], for GSG-52/53 Maximum number of signals in view at any given
[-1, 8], for GSG-54 time.
[-1, 16], for GSG-55 Keyword '-1' implies 'Auto' – maximum number of
[-,16], for GSG-56 Satellites in view to be simulated
Default: 5/8/16 depending on GSG model
The old keyword NumSignals is accepted and
interpreted as GpsSatellites.
GlonassSatellites [-1, 5], for GSG-53 Default: 0
[-1,16], for GSG-56 Keyword -1 implies 'Auto' – maximum number of
Satellites in view will be simulated.
GalileoSatellites [-1, 36] Default: 0
Keyword -1 implies 'Auto' – maximum number of
Satellites in view will be simulated.
DefaultGpsSV {'Default', 'SvBlockII', Defines the default GPS satellite series simulated,
'SvBlockIIA', 'SvBlockIIR', would the ID not explicitly be specified to be of a
'SvBlockIIR-M', 'SvB- different type. Default: 'Default'
lockIIF', 'SvBlockIIIA'}
DefaultGlonassSV {'Default', 'SvGlonassM', Defines the default GLONASS satellite series sim-
'SvGlonassK1' } ulated, would the ID not explicitly be specified to
be of a different type. Default: 'Default'
[MultipathSignal INTEGER range: [1, Mul- 'Header' for the parameters for each multipath sig-
INTEGER] tipathSignals] nal.
When MultipathSignals is 1 or greater, then a set of
parameters must be specified for each multipath
signal.
mpChannel [1, GpsSatellites + Specifying which channel that is to be duplic-
GlonassSatellites + ated.Only GPS or GLONASS channels may be
GalileoSatellites] duplicated. Default: 1
rangeOffset [-999.999, 999.999] Specifying range offset in meters. Default: 0
rangeChange [-99.99, 99.99] Specifying range offset change in meters /
rangeInterval. Default: 0
rangeInterval [0, 600] Specifying range change interval in seconds with
one decimal accuracy. Default: 0
[InterferenceSignal INTEGER range: [1, '˜Header'™ for the parameters for each inter-
INTEGER] InterferenceSignals] ference signal.
When InterferenceSignals is 1 or greater, then a
set of parameters below must be specified for
each interference signal.
GPSL1CA [0, 1] , where 0 cor- Specifies the type of signal interference
responds to 'Off' , and 1
to 'On'
GPSL1P [0, 1] , where 0 cor- Specifies the type of signal interference
responds to 'Off' , and 1
to 'On'
SatId GPS: [1,32] Specifies the satellite ID (PRN / frequency slot) for
GPS carrier: 0 interference signal
Glonass: [1, 24] Default: 3
Glonass carrier: [-7,6] For 'Glonass carrier', the term 'SatId' refers to the
Galileo: [1, 36] frequency slot.
SBAS: [120, 158]
BeiDou: [1,37]
QZSS: [1,4]
IRNSS: [1:7]
Power [-65, -160] Signal strength in dBm. Default: unit's transmit
power
FreqOffset [-999999, 999999] Frequency offset in Hz. Default: 0
Multipath
White Noise
Programmable PPS (1, 10, 100, 1000)
StudioView software
Antenna modeling
Front Panel Lockout
NTP Synchronization
Arm and trigger
Leap Second Simulation
OPT-ECL: enabling this option loads and enables the predefined scenarios for eCall.
OPT-FN: fixed bandwidth noise
OPT-GLO: enables Glonass signals supported.
OPT-GAL: enables all Galileo signals supported.
OPT-HPWR: High Power Option
OPT-HV: high velocity/altitude enables the simulation of high velocity vehicles.
OPT-INTF: interference option to simulate interference signals. See also "Interference sig-
nals" on page 64.
OPT-IRN: enables all IRNSS signals supported.
OPT-JAM: jamming enables the ability to define a point source of interference signals. See
"Interference signals" on page 64.
OPT-L2: enables GPS L2P, L1P and GLONASS L2 signals.
OPT-L2C: enables GPS L2C signals.
OPT-L5: enables GPS L5, Galileo 5a/b, BeiDou B2, IRNSS, SBAS L5 signals.
OPT-L6: reserved for Galileo E6 and BeiDou B3.
OPT-MP: allows for the simulation of multipath signals. See also "Multipath Signals" on
page 61.
OPT-NOW: uses downloaded Ephemeris and NTP time set to align GSG generator signals
with live sky.
OPT-PPS: PPS Output allows for configuring 1/10/100/1000 pulse-per-second output
aligned to the GPS on-time point
OPT-QZ: enables the simulation of QZSS signals.
OPT-RP: offers the ability to convert and record GPS data to a GSG scenario to replay the
actual route and satellites in view during that route, including power levels.
OPT-RSG: allows GSG to receive trajectory information in real time via SCPI commands.
OPT-RTK: RTK/DGNSS RTK Real time kinematics enables the generation and use of base
station information for RTK receivers.
OPT-SBAS: enables the simulation of satellite base augmentation systems (see "SBAS
Satellites" on page 82).
OPT-SEN: sensor simulator package generates various sensor type data in response to a
query via SCPI command (included with RSG option)
OPT-SPF: Spoofing range compensation
OPT-TIM: timing calibration option offers 10x improvement in the timing accuracy. See
also "Timing Calibration" on page 182.
OPT-TLM: sets the TLM word in all messages to all 1’s
5.15 Problems?
Additional regional contact information can be found on the Contact page of the Orolia
website.
Everyone is permitted to copy and distribute verbatim copies of this license document, but
changing it is not allowed.
This version of the GNU Lesser General Public License incorporates the terms and con-
ditions of version 3 of the GNU General Public License, supplemented by the additional per-
missions listed below.
0. Additional Definitions.
As used herein, "this License" refers to version 3 of the GNU Lesser General Public
License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The
Library" refers to a covered work governed by this License, other than an Application or a
Combined Work as defined below.
An "Application" is any work that makes use of an interface provided by the Library, but
which is not otherwise based on the Library. Defining a subclass of a class defined by the
Library is deemed a mode of using an interface provided by the Library.
A "Combined Work" is a work produced by combining or linking an Application with the
Library. The particular version of the Library with which the Combined Work was made is
also called the "Linked Version".
The "Minimal Corresponding Source" for a Combined Work means the Corresponding
Source for the Combined Work, excluding any source code for portions of the Combined
Work that, considered in isolation, are based on the Application, and not on the Linked Ver-
sion.
The "Corresponding Application Code" for a Combined Work means the object code
and/or source code for the Application, including any data and utility programs needed for
reproducing the Combined Work from the Application, but excluding the System Libraries
of the Combined Work.
4. Combined Works.
You may convey a Combined Work under terms of your choice that, taken together, effect-
ively do not restrict modification of the portions of the Library contained in the Combined
Work and reverse engineering for debugging such modifications, if you also do each of the
following:
a. Give prominent notice with each copy of the Combined Work that the Library is
used in it and that the Library and its use are covered by this License.
b. Accompany the Combined Work with a copy of the GNU GPL and this license doc-
ument.
c. For a Combined Work that displays copyright notices during execution, include the
copyright notice for the Library among these notices, as well as a reference dir-
ecting the user to the copies of the GNU GPL and this license document.
d. Do one of the following:
0. Convey the Minimal Corresponding Source under the terms of this License,
and the Corresponding Application Code in a form suitable for, and under
terms that permit, the user to recombine or relink the Application with a mod-
ified version of the Linked Version to produce a modified Combined Work, in
the manner specified by section 6 of the GNU GPL for conveying Cor-
responding Source.
1. Use a suitable shared library mechanism for linking with the Library. A suitable
mechanism is one that (a) uses at run time a copy of the Library already
present on the user's computer system, and (b) will operate properly with a
modified version of the Library that is interface-compatible with the Linked
Version.
e. Provide Installation Information, but only if you would otherwise be required to
provide such information under section 6 of the GNU GPL, and only to the extent
that such information is necessary to install and execute a modified version of the
Combined Work produced by recombining or relinking the Application with a
modified version of the Linked Version. (If you use option 4d0, the Installation
Information must accompany the Minimal Corresponding Source and Cor-
responding Application Code. If you use option 4d1, you must provide the Installation
Information in the manner specified by section 6 of the GNU GPL for conveying Cor-
responding Source.)
5. Combined Libraries.
You may place library facilities that are a work based on the Library side by side in a single
library together with other library facilities that are not Applications and are not covered by
this License, and convey such a combined library under terms of your choice, if you do both
of the following:
a. Accompany the combined library with a copy of the same work based on the Library,
uncombined with any other library facilities, conveyed under the terms of this
License.
b. Give prominent notice with the combined library that part of it is a work based on the
Library, and explaining where to find the accompanying uncombined form of the
same work.
The licenses for most software and other practical works are designed to take away your
freedom to share and change the works. By contrast, the GNU General Public License is
intended to guarantee your freedom to share and change all versions of a program--to
make sure it remains free software for all its users. We, the Free Software Foundation, use
the GNU General Public License for most of our software; it applies also to any other work
released this way by its authors. You can apply it to your programs, too.
When we speak of free software, we are referring to freedom, not price. Our General
Public Licenses are designed to make sure that you have the freedom to distribute copies
of free software (and charge for them if you wish), that you receive source code or can get
it if you want it, that you can change the software or use pieces of it in new free programs,
and that you know you can do these things.
To protect your rights, we need to prevent others from denying you these rights or asking
you to surrender the rights. Therefore, you have certain responsibilities if you distribute
copies of the software, or if you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether gratis or for a fee, you
must pass on to the recipients the same freedoms that you received. You must make sure
that they, too, receive or can get the source code. And you must show them these terms
so they know their rights.
Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright
on the software, and (2) offer you this License giving you legal permission to copy, dis-
tribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains that there is no war-
ranty for this free software. For both users' and authors' sake, the GPL requires that mod-
ified versions be marked as changed, so that their problems will not be attributed
erroneously to authors of previous versions.
Some devices are designed to deny users access to install or run modified versions of the
software inside them, although the manufacturer can do so. This is fundamentally incom-
patible with the aim of protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to use, which is pre-
cisely where it is most unacceptable. Therefore, we have designed this version of the GPL
to prohibit the practice for those products. If such problems arise substantially in other
domains, we stand ready to extend this provision to those domains in future versions of the
GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents. States should not
allow patents to restrict development and use of software on general-purpose computers,
but in those that do, we wish to avoid the special danger that patents applied to a free pro-
gram could make it effectively proprietary. To prevent this, the GPL assures that patents
cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and modification follow.
0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds of works, such as semi-
conductor masks.
"The Program" refers to any copyrightable work licensed under this License. Each licensee
is addressed as "you". "Licensees" and "recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work in a fashion requir-
ing copyright permission, other than the making of an exact copy. The resulting work is
called a "modified version" of the earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based on the Program.
To "propagate" a work means to do anything with it that, without permission, would make
you directly or secondarily liable for infringement under applicable copyright law, except
executing it on a computer or modifying a private copy. Propagation includes copying, dis-
tribution (with or without modification), making available to the public, and in some coun-
tries other activities as well.
To "convey" a work means any kind of propagation that enables other parties to make or
receive copies. Mere interaction with a user through a computer network, with no transfer
of a copy, is not conveying.
An interactive user interface displays "Appropriate Legal Notices" to the extent that it
includes a convenient and prominently visible feature that
(1) displays an appropriate copyright notice, and
(2) tells the user that there is no warranty for the work (except to the extent that war-
ranties are provided), that licensees may convey the work under this License, and how to
view a copy of this License. If the interface presents a list of user commands or options,
such as a menu, a prominent item in the list meets this criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work for making modi-
fications to it. "Object code" means any non-source form of a work.
A "Standard Interface" means an interface that either is an official standard defined by a
recognized standards body, or, in the case of interfaces specified for a particular pro-
gramming language, one that is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other than the work as a
whole, that (a) is included in the normal form of packaging a Major Component, but which
is not part of that Major Component, and (b) serves only to enable use of the work with
that Major Component, or to implement a Standard Interface for which an implementation
is available to the public in source code form. A "Major Component", in this context, means
a major essential component (kernel, window system, and so on) of the specific operating
system (if any) on which the executable work runs, or a compiler used to produce the work,
or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all the source code
needed to generate, install, and (for an executable work)run the object code and to modify
the work, including scripts to control those activities. However, it does not include the
work's System Libraries, or general-purpose tools or generally available free programs
which are used unmodified in performing those activities but which are not part of the
work. For example, Corresponding Source includes interface definition files associated
with source files for the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require, such as by intimate
data communication or control flow between those subprograms and other parts of the
work.
The Corresponding Source need not include anything that users can regenerate auto-
matically from other parts of the Corresponding Source.
The Corresponding Source for a work in source code form is that same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of copyright on the Program,
and are irrevocable provided the stated conditions are met. This License explicitly affirms
your unlimited permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its content, constitutes a
covered work. This License acknowledges your rights of fair use or other equivalent, as
provided by copyright law. You may make, run and propagate covered works that you do
not convey, without conditions so long as your license otherwise remains in force.
You may convey covered works to others for the sole purpose of having them make modi-
fications exclusively for you, or provide you with facilities for running those works, provided
that you comply with the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works for you must do so
exclusively on your behalf, under your direction and control, on terms that prohibit them
from making any copies of your copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under the conditions stated
below. Sublicensing is not allowed; section 10 makes it unnecessary.
under this License with respect to the covered work, and you disclaim any intention to limit
operation or modification of the work as a means of enforcing, against the work's users,
your or third parties' legal rights to forbid circumvention of technological measures.
product received by a particular user, "normally used" refers to a typical or common use of
that class of product, regardless of the status of the particular user or of the way in which
the particular user actually uses, or expects or is expected to use, the product. A product is
a consumer product regardless of whether the product has substantial commercial, indus-
trial or non-consumer uses, unless such uses represent the only significant mode of use of
the product.
"Installation Information" for a User Product means any methods, procedures, author-
ization keys, or other information required to install and execute modified versions of a
covered work in that User Product from a modified version of its Corresponding Source.
The information must suffice to ensure that the continued functioning of the modified
object code is in no case prevented or interfered with solely because modification has
been made.
If you convey an object code work under this section in, or with, or specifically for use in, a
User Product, and the conveying occurs as part of a transaction in which the right of pos-
session and use of the User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the Corresponding Source
conveyed under this section must be accompanied by the Installation Information. But this
requirement does not apply if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has been installed in
ROM).
The requirement to provide Installation Information does not include a requirement to con-
tinue to provide support service, warranty, or updates for a work that has been modified or
installed by the recipient, or for the User Product in which it has been modified or installed.
Access to a network may be denied when the modification itself materially and adversely
affects the operation of the network or violates the rules and protocols for communication
across the network.
Corresponding Source conveyed, and Installation Information provided, in accord with this
section must be in a format that is publicly documented (and with an implementation avail-
able to the public in source code form), and must require no special password or key for
unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this License by making
exceptions from one or more of its conditions. Additional permissions that are applicable to
the entire Program shall be treated as though they were included in this License, to the
extent that they are valid under applicable law. If additional permissions apply only to part
of the Program, that part may be used separately under those permissions, but the entire
Program remains governed by this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option remove any additional
permissions from that copy, or from any part of it. (Additional permissions may be written
to require their own removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work, for which you have or
can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you add to a covered
work, you may (if authorized by the copyright holders of that material) supplement the
terms of this License with terms:
a. Disclaiming warranty or limiting liability differently from the terms of sections 15 and
16 of this License; or
b. Requiring preservation of specified reasonable legal notices or author attributions in
that material or in the Appropriate Legal Notices displayed by works containing it; or
c. Prohibiting misrepresentation of the origin of that material, or requiring that mod-
ified versions of such material be marked in reasonable ways as different from the ori-
ginal version; or
d. Limiting the use for publicity purposes of names of licensors or authors of the mater-
ial; or
e. Declining to grant rights under trademark law for use of some trade names, trade-
marks, or service marks; or
f. Requiring indemnification of licensors and authors of that material by anyone who
conveys the material (or modified versions of it) with contractual assumptions of liab-
ility to the recipient, for any liability that these contractual assumptions directly
impose on those licensors and authors.
All other non-permissive additional terms are considered "further restrictions" within the
meaning of section 10. If the Program as you received it, or any part of it, contains a notice
stating that it is governed by this License along with a term that is a further restriction, you
may remove that term. If a license document contains a further restriction but permits reli-
censing or conveying under this License, you may add to a covered work material gov-
erned by the terms of that license document, provided that the further restriction does not
survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you must place, in the rel-
evant source files, a statement of the additional terms that apply to those files, or a notice
indicating where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the form of a separately
written license, or stated as exceptions; the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly provided under this
License. Any attempt otherwise to propagate or modify it is void, and will automatically ter-
minate your rights under this License (including any patent licenses granted under the
third paragraph of section 11).
However, if you cease all violation of this License, then your license from a particular copy-
right holder is reinstated (a)provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright holder fails to notify
you of the violation by some reasonable means prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is reinstated permanently if the
copyright holder notifies you of the violation by some reasonable means, this is the first
time you have received notice of violation of this License (for any work) from that copy-
right holder, and you cure the violation prior to 30 days after your receipt of the notice.
Termination of your rights under this section does not terminate the licenses of parties
who have received copies or rights from you under this License. If your rights have been
terminated and not permanently reinstated, you do not qualify to receive new licenses for
the same material under section 10.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this License of the Program
or a work on which the Program is based. The work thus licensed is called the contributor's
"contributor version".
A contributor's "essential patent claims" are all patent claims owned or controlled by the
contributor, whether already acquired or hereafter acquired, that would be infringed by
some manner, permitted by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a consequence of further modi-
fication of the contributor version. For purposes of this definition, "control" includes the
right to grant patent sublicenses in a manner consistent with the requirements of this
License.
Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under
the contributor's essential patent claims, to make, use, sell, offer for sale, import and oth-
erwise run, modify and propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express agreement or com-
mitment, however denominated, not to enforce a patent (such as an express permission to
practice a patent or covenant not to sue for patent infringement). To "grant" such a patent
license to a party means to make such an agreement or commitment not to enforce a pat-
ent against the party.
If you convey a covered work, knowingly relying on a patent license, and the Cor-
responding Source of the work is not available for anyone to copy, free of charge and
under the terms of this License, through a publicly available network server or other readily
accessible means, then you must either (1) cause the Corresponding Source to be so avail-
able, or (2) arrange to deprive yourself of the benefit of the patent license for this par-
ticular work, or (3) arrange, in a manner consistent with the requirements of this License,
to extend the patent license to downstream recipients. "Knowingly relying" means you
have actual knowledge that, but for the patent license, your conveying the covered work in
a country, or your recipient's use of the covered work in a country, would infringe one or
more identifiable patents in that country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or arrangement, you convey, or
propagate by procuring conveyance of, a covered work, and grant a patent license to some
of the parties receiving the covered work authorizing them to use, propagate, modify or
convey a specific copy of the covered work, then the patent license you grant is auto-
matically extended to all recipients of the covered work and works based on it.
A patent license is "discriminatory" if it does not include within the scope of its coverage,
prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights
that are specifically granted under this License. You may not convey a covered work if you
are a party to an arrangement with a third party that is in the business of distributing soft-
ware, under which you make payment to the third party based on the extent of your activ-
ity of conveying the work, and under which the third party grants, to any of the parties who
would receive the covered work from you, a discriminatory patent license (a) in connection
with copies of the covered work conveyed by you (or copies made from those copies), or
(b) primarily for and in connection with specific products or compilations that contain the
covered work, unless you entered into that arrangement, or that patent license was gran-
ted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting any implied license or
other defenses to infringement that may otherwise be available to you under applicable
patent law.
Later license versions may give you additional or different permissions. However, no addi-
tional obligations are imposed on any author or copyright holder as a result of your choos-
ing to follow a later version.
Some parts of this product use free software released under the terms of MIT/X11
License. Upon request Orolia will give out source code according to applicable licenses.
Contact information can be found at web address: orolia.com.
This license applies to GeographicLib, versions 1.12 and later.
Copyright© 2008-2013, Charles Karney
Permission is hereby granted, free of charge, to any person obtaining a copy of this soft-
ware and associated documentation files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use, copy, modify, merge, publish, dis-
tribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or sub-
stantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
GSG can be setup to receive raw SCPI commands through the Ethernet port over TCP port
5025.
In the Option Menu, change the connection type from USB or Ethernet to SCPI-RAW. Then
send the SCPI commands to the GSG.
6.2 Protocol
SOURce:SCENario:CONTrol start
SOURce:SCENario:CONTrol?
Commands ending with ?-mark are queries. Keywords can be shortened by typing only the
capital letters. Case does not matter. For example:
sour:scen:cont?
If using SCPI-Raw all commands should be terminated with newline "\n". All responses
from GSG are also terminated with newline. Exceptions are commands and responses
where the length of data is inside the command/response. These are SOURce:FILe:data
command and response to MMEMory:DATA? query. Some commands, such as sour:s-
cen:log? and sour:scen:advlog? imply multiline responses. When a multiline response
is not empty, each line of data is terminated with a newline symbol. Additionally, multiline
responses (even empty ones) are terminated with an empty line (a line with no symbols
except a newline symbol in it).
When using, for example, a telnet client to control the unit, it is enough just type com-
mands and press enter to send the command.
-158,"String data not allowed". String data detected when number is expected.
-160,"Block data error”. This error, as well as errors –161 through –169, is gen-
erated when parsing a block data element. This particular error message is used
when the instrument cannot detect a more specific error.
-161,"Invalid block data". A block data element was expected, but was invalid for
some reason (see IEEE-488.2, 7.7.6.2); for example, an END message was received
before the length was satisfied.
-190,"Execution in progress". Command not allowed in current state.
-191,"Execution not in progress". Command requiring scenario/signal generator
executing issued when device is idle.
-192,"Unused channel". Query or command for a channel that is currently not alloc-
ated to any signal.
-193,"RSG command overflow occurred". Too many RSG commands were
received to process within a GSG 10 Hz epoch.
-194,"RSG command underflow occurred". Underflow detection was enabled,
and no GSG RSG commands were received within a GSG 100 ms epoch.
-200,"Execution error". Scenario execution failed to start.
-220,"Parameter error". Scenario/signal generator started without a scenario.
-221,"Settings conflict". Indicates that a legal program data element was parsed
but could not be executed due to the current counter state (see IEEE-488.2,
6.4.5.3 and 11.5.1.1.5.)
-221,"Settings conflict; invalid combination of channel and function". See
above.
-222,"Data out of range". Indicates data values are out of range or input data such
as Navigation data files have incompatible ranges of validity.
-224,"Illegal parameter value". Scenario configuration has illegal coordinates or
date.
-225,"Out of memory". Command processing was interrupted because of the lack
of memory.
-241,"Hardware missing". This error is given only when the reference clock signal
is missing when scenario/signal generator is started or when the Ethernet MAC
address cannot be found. Check that the external reference clock is connected.
Verify Network Ethernet Port detection and activity lights.
-250,"Mass storage error". Copying/moving files is not allowed between dir-
ectories.
-256,"File name not found". File operation attempted on a non-existing file or dir-
ectory.
6.3.1.1 *CLS
Example
*CLS
6.3.1.2 *ESE
Command Syntax
*ESE <decimal>
Parameters
<dec.data> = the sum (between 0 and 255) of all bits that are true.
Event Status Enable Register (1 = enable)
Bit Weight Enables
6.3.1.3 *ESR?
Returned Format
<dec.data> = the sum (between 0 and 255) of all bits that are true. See table for *ESE.
6.3.1.4 *IDN?
Identification query
Reads out the manufacturer, model, serial number, firmware level and options in an ASCII
response data element. The query must be the last query in a program message.
Returned Format
<Manufacturer>, <Model>, <Serial Number>, <Firmware Level>, <Options>.
Example
SEND:
*IDN?
READ:
Options
The first option listed is the maximum number of channels the unit has been licensed for.
SBAS – Satellite Based Augmentation System satellites
TRAJ – Trajectories
TRG – External Trigger
FN – Fixed bandwidth noise
VN – Variable Bandwidth Noise (GSG-55 only)
INTF – Interference channels
MP – Multipath
NOW – Simulate Now
PPS – PPS output (1/10/100/1000)
HV – High Velocity/Altitude, Extended Limits Option
L2 – L2 Frequency band, enables P-code for GPS L1 and L2, is required for
GLONASS L2
L2C – GPS L2C
L5 – L5 Frequency band, enables GPS L5, is required for Galileo E5a/b, BeiDou B2
L6 – L6 Frequency band, required for BeiDou B3 / Galileo E6
RTK – Virtual Basestation and RTCM messages
GAL – Galileo, enables Galileo E1, is required for Galileo E5a/b
GLO – GLONASS, enables GLONASS L1, is required for GLONASS L2
RSG – Real-time Scenario Generation
BDS – BeiDou, enables B1, is required for BeiDou B2
6.3.1.5 *OPC
Operation Complete
The Operation Complete command causes the device to set the operation complete bit in
the Standard Event Status Register when all pending selected device operations have
been finished.
*OPC and *OPC? commands can be used with overlapping commands, i.e., commands
which take long time to finish. In GSG such commands are starting/arming scenario exe-
cution ( SOUR:SCEN:CONT START ), and starting/arming of the signal generator
(SOUR:ONECHN:CONT START).
Example
Enable OPC-bit
SEND:
*ESE 1
Start scenario. *OPC will set the operation complete bit in the status register when the
start of scenario is done and it is running.
SEND:
SOURce:SCENario:CONTrol start;*OPC
Wait 5s for the scenario to start. Then read the event status register.
SEND:
*ESR?
Check the Operation complete bit (0) in the result. If it is true, the start of scenario is com-
pleted and you can ask for example the current position.
SEND:
SOURce:SCENario:LOG?
*ESR?
6.3.1.6 *OPC?
sour:scen:ecefposition IMMEDIATE,1000.00,2000.00,3000.00
*OPC?
sour:scen:ecefposition?
Returned format
1
6.3.1.7 *RST
Reset
Resets the device. Any ongoing activity is stopped and the device is prepared to start new
operations.
Example
*RST
6.3.1.8 *SRE
Command Syntax
Parameters
<dec.data> = the sum (between 0 and 255) of all bits that are true.
Service Request Enable Register (1 = enable)
0 1 Device Status
Returned format
<Integer>
Where:
<Integer> = the sum of all bits that are set.
Example
*SRE 1
6
In this example, the device generates a service request when a message is available in the
output queue.
6.3.1.9 *SRE?
Returned format
<Integer> = the sum (between 0 and 255) of all bits that are true. See "*SRE" on the pre-
vious page for a description of the individual bits.
6.3.1.10 *STB?
Returned format
<Integer> = the sum (between 0 and 255) of all bits that are true.
Status byte Register (1 = true)
Bit Weight Name Condition
1 2 Not used
0 1 Not used
6.3.1.11 *TST?
Self Test
The self- test query causes an internal self- test and generates a response indicating
whether or not the device completed the self-test without any detected errors.
Returned format
<Integer>
Where:
0 = No error
1 = Error in reference clock
6.3.1.12 *WAI
Wait-to-continue
The Wait-to-Continue command prevents the device from executing any further com-
mands or queries until execution of all previous commands or queries have been com-
pleted. It differs from the *OPC? command in that it blocks within the GSG. It also resumes
operation and allows synchronous execution of a command sequence within the GSG
10Hz epoch.
Example
SOURce:SCENario:CONTrol start;*WAI;SOURce:SCENario:LOG?
Wait until scenario is running and then request NMEA position.
RSG Example
SEND:
*WAI?
SEND:
SOURce:SCENario:PRYRate 123.400,-2.0000,2.0000,1.0000
Wait until the next 100 msec interval and issue the following commands.
6.3.2.1 SYSTem:ERRor?
Function
This SYSTem command queries the error queue for an ASCII text description of the next
error and removes it from the queue. The error messages are placed in an error queue,
with a FIFO (First In-First Out) structure. This queue is summarized in the Error AVailable
(EAV) bit in the status byte.
The System Error command is extended with relevant command and protocol errors. It will
allow the user to determine:
Scheduled commands arrive too late to meet their required pre-processing time
based on their timestamps.
The user can configure protocol to flag error in situation where:
More than one position command is received during same epoch, and the
commands contradict (not complement) each other. Values are not analyzed
to determine contradiction, but only type of data (e.g., two position inform-
ation commands are deemed to contradict, even if the actual position would
not change.). In these situations only the last received information is served
(no queue system used). The default configuration is NOT to flag error.
No position information is received during the epoch. The default con-
figuration is NOT to flag error.
Command Syntax
SYSTem:ERRor[:NEXT]?
Note
All SOURce:SCENario commands are only available during scenario execution. If scenario
is not running these error codes are to be returned (for both set and get functions);
-191,"Execution not in progress".
Returned format
<error number>,"<Error Description String>"
Where:
<Error Description String> = an error description as ASCII text.
6.3.2.2 SYSTem:RESET:FACTory
Function
This SYSTem command performs the factory reset. With parameter restore it only
restores the factory default files. With parameter clean it cleans all user data and restores
factory default files.
Command Syntax
SYSTem:RESET:FACTory <restore|clean>
Note
Communication interface is not reset in order to maintain connection to the unit.
Parameter
enum = {restore, clean}
Example
SEND:
SYSTem:RESET:FACTory clean
6.3.3.1 SOURce:POWer
Function
Sets the transmit power of the device. During scenario execution all signals on all bands will
get the new transmit power, and all possible power offsets between different satellite con-
stellations and frequency bands are discarded.
Command Syntax
SOURce:POWer <decimal>
Note
Setting not stored during scenario or 1-channel mode execution.
If power is inside allowed limits, but other RF parameters need to be modified, such para-
meters are modified and an error about settings conflict is set.
Parameter
decimal [-160,-65] dBm
Example
SEND:
SOURce:POWer -123.2
6.3.3.2 SOURce:POWer?
Function
Queries the current transmit power of the unit.
Command Syntax
SOURce:POWer?
Example
SEND:
SOURce:POWer?
READ:
-121.3
6.3.3.3 SOURce:REFPOWer
Function
Changes the absolute power in dBm of the reference signal (GPS L1 C/A).
Command Syntax
SOURce:REFPOWer <decimal>
Notes
This command can only be used before starting a simulation. The setting is not stored dur-
ing scenario or 1-channel mode execution.
If power is inside allowed limits, but other RF parameters need to be modified, such para-
meters are modified and an error about a settings conflict is set.
Parameter
decimal [-160,-65] dBm
Example
SEND:
SOURce:REFPOWer -123.2
You can use the keyword “default” instead of <power>:
SOURce:REFPOWer default
Restores default relative power for GPS L1 C/A
6.3.3.4 SOURce:REFPOWer?
Function
Returns current absolute power in dBm of the reference signal (GPS L1 C/A).
Command Syntax
SOURce:REFPOWer?
Example
SEND:
SOURce:REFPOWer?
READ:
-121.3
6.3.3.5 SOURce:ABSPOWer
Function
Changes the absolute power for the given signal type and orbit type.
Command Syntax
Notes
This command can only be used before starting a simulation. The setting is not stored dur-
ing scenario or 1-channel mode execution.
If power is inside allowed limits, but other RF parameters need to be modified, such para-
meters are modified and an error about a settings conflict is set.
You can use the keyword “all” instead of <signal name>. However, in this case the
<orbit type name> cannot be specified. The power you entered will be used for all sig-
nal types for all constellations.
You can use the keyword “default” instead of <power>. The chosen <signal name> (and
optionally <orbit type name> ) will use the default power (specified in the cor-
responding ICD).
Examples
SEND:
SOUR:ABSPOWer BDSB1,GEO,-123.2
Both keywords “all”, and “default” can be used together:
SOURce:ABSPOWer all,default
This command will reset whole power configuration to the default state (reference
power and relative power offsets as it is specified in ICDs)
6.3.3.6 SOURce:ABSPOWer?
Function
Returns the current absolute power in dBm for the given signal type and orbit type.
Command Syntax
Examples
SEND:
SOUR:ABSPOW? GLOL1
Returns power for GLONASS L1
SOUR:ABSPOW? BDSB1,GEO
Returns power for BEIDOU B1 on geostationary orbit
6.3.3.7 SOURce:RELPOWer
Function
Changes the relative power offset for the given signal type and orbit type.
Command Syntax
Notes
This command can only be used before starting a simulation. The setting is not stored dur-
ing scenario or 1-channel mode execution.
If the power is inside the allowed limits, but other RF parameters need to be modified, such
parameters are modified and an error about a settings conflict is set.
You can use the keyword “all” instead of <signal name>. However, in this case the
<orbit type name> cannot be specified. The power you entered will be used for all sig-
nal types for all constellations.
You can use the keyword “default” instead of <power>. The chosen <signal name> (and
optionally <orbit type name>) will be set to the default relative power offsets.
Examples
SEND:
SOUR:RELPOWer BDSB1,GEO,-123.2
SOURce:RELPOWer all,default
This command will reset the relative power offsets to their default values. The ref-
erence power, however, WILL NOT be changed (to change the reference power
level also, use the command SOUR:ABSPOW all, default instead.)
6.3.3.8 SOURce:RELPOWer?
Function
Returns current relative power offset in dBm for the given signal type and orbit type (off-
set relative to reference power).
Command Syntax
Example
SEND:
SOURce:RELPOWer? BDSB1,GEO
6.3.3.9 SOURce:EXTREF
Function
Specifies the reference clock source. If set to ON, the external reference clock signal is
required and used when scenarios are executed, or the signal generator is running.
Command Syntax
SOURce:EXTREF <ON|OFF>
Parameter
enum = {ON, OFF}
Example
SEND:
SOURce:EXTREF ON
6.3.3.10 SOURce:EXTREF?
Function
Get the currently selected clock source.
Command Syntax
SOURce:EXTREF?
Example
SEND:
SOURce:EXTREF?
READ:
ON
6.3.3.11 SOURce:PPSOUTput
Function
Sets the PPS (pulses-per-second) output of the device.
Command Syntax
SOURce:PPSOUTput <value>
Note
This feature is not available on GSG-52.
Parameter
value = 1, 10, 100, 1000 pulses per second
Example
SEND:
SOURce:PPSOUTput 10
6.3.3.12 SOURce:PPSOUTput?
Function
Get the current PPS output setting.
Command Syntax
SOURce:PPSOUTput?
Note
This feature is not available on GSG-52.
Example
SEND:
SOURce:PPSOUT?
READ:
100
6.3.3.13 SOURce:EXTATT
Function
Set the external attenuation of the device.
Command Syntax
SOURce:EXTATT <decimal>
Note
Setting not stored during scenario or 1-channel mode execution.
If the value is inside allowed limits, but other RF parameters need to be modified, they are
modified and an error about settings conflict is set.
Parameter
decimal = [0,30] in dB
Example
SEND:
SOURce:EXTATT 12.2
6.3.3.14 SOURce:EXTATT?
Function
Query the current external attenuation setting of the unit.
Command Syntax
SOURce:EXTATT?
Example
SEND:
SOURce:EXTATT?
READ:
11.3
6.3.3.15 SOURce:NOISE:CONTrol
Function
Set the noise simulation ON or OFF.
Command Syntax
SOURce:NOISE:CONTrol <ON|OFF>
Note
Setting not stored during scenario or 1-channel mode execution.
Parameter
enum = {ON, OFF}
Example
SEND:
SOURce:NOISE:CONTrol ON
6.3.3.16 SOURce:NOISE:CONTrol?
Function
Get the noise simulation state.
Command Syntax
SOURce:NOISE:CONTrol?
Example
SEND:
SOURce:NOISE:CONTrol?
READ:
OFF
6.3.3.17 SOURce:NOISE:CNO
Function
Set the maximum carrier-to-noise density of the simulated signals.
Command Syntax
SOURce:NOISE:CNO <decimal>
Note
Setting not stored during scenario or 1-channel mode execution.
The actual C/N0 of individual signals may be lower than this setting due to various reasons
(distance, elevation, modified by event, etc).
Parameter
C/N0 in dB·Hz. A decimal number, within the range [0.0 … 56.0].
Example
SEND:
SOURce:NOISE:CNO 44.1
6.3.3.18 SOURce:NOISE:CNO?
Function
Get the current maximum carrier-to-noise density of the simulated signals.
Command Syntax
SOURce:NOISE:CNO?
Example
SEND:
SOURce:NOISE:CNO?
READ:
39.2
6.3.3.19 SOURce:NOISE:BW
Function
Set the noise simulation bandwidth. This command is only available with GSG-55 units.
Command Syntax
SOURce:NOISE:BW <decimal>
Note
Setting not stored during scenario execution or 1-channel mode execution. This command
is only available with GSG-55 units.
Parameter
Noise simulation bandwidth in MHz:, Decimal number in range [0.001 … 20.46].
Example
SEND:
SOURce:NOISE:BW 18.001
6.3.3.20 SOURce:NOISE:BW?
Function
Get the noise simulation bandwidth. This command is only available with GSG-55 units.
Command Syntax
SOURce:NOISE:BW?
Example
SEND:
SOURce:NOISE:BW?
READ:
20.2
6.3.3.21 SOURce:NOISE:OFFSET
Function
Set the frequency offset of the simulated noise from the GPS L1 center frequency
(1.57542 GHz).
For example, if the noise bandwidth is set to be 20 MHz, and offset is 10 MHz, the noise will
be simulated on frequency band 1575.42 … 1595.42 MHz.
Command Syntax
SOURce:NOISE:OFFSET <decimal>
Note
Setting not stored during scenario or 1-channel mode execution. This command is only
available in GSG-55.
Parameter
Noise frequency offset in MHz. A decimal number within the range [-10.23 … 10.23].
Example
SEND:
SOURce:NOISE:OFFSET 2.0
6.3.3.22 SOURce:NOISE:OFFSET?
Function
Get the frequency offset (in MHz) of the simulated noise from the GPS L1 center fre-
quency. This command is only available with GSG-55 units.
Command Syntax
SOURce:NOISE:OFFSET?
Example
SEND:
SOURce:NOISE:OFFSET
READ:
-8.2
6.3.3.23 SOURce:ONECHN:CONTrol
Function
Control the execution of the Signal Generator.
Command Syntax
SOURce:ONECHN:CONTrol <START|STOP|ARM>
Parameter
enum {START,STOP,ARM}
Example
SEND:
SOURce:ONECHN:CONTrol start
6.3.3.24 SOURce:ONECHN:CONTrol?
Function
Query the current state of the Signal Generator. Meaning of returned values is the fol-
lowing:
START: Signal Generator is started and running
STOP: Signal Generator is stopped and thus not running
WAIT: Signal Generator delays startup for 2 minutes to allow the simulation to load
required data. The start time derived from the NTP server is then aligned to the next
full GPS minute.ARMED: Signal Generator is armed, all data loading is done, but Sig-
nal Generator is not yet running, but waiting for the trigger to start it
ARMING: Signal Generator is loading data to memory, and arming after which it
transitions to the ARMED state
Command Syntax
SOURce:ONECHN:CONTrol?
Returned values
START, STOP, WAIT, ARMED or ARMING
Example
SEND:
SOURce:ONECHN:CONTrol?
READ:
START
6.3.3.25 SOURce:ONECHN:SATid
Function
During RF generation 1 , modify the current signal mode. While GSG is not generating RF,
set & store the 1-channel mode satellite identifier and signal mode.
While GSG is not generating RF, modify the current signal mode.
SOURce:ONECHN:SATid <signal_mode_letter><gnss_letter><integer>
SOURce:ONECHN:SATid <gnss_letter><integer>
SOURce:ONECHN:SATid <signal_mode_letter><integer>
SOURce:ONECHN:SATid <signal_mode_letter>
Parameters
<signal_mode_letter>: [M, P, U]
<gnss_letter>: [G, R, E, C, J, I, S]
<integer>: [–7 … 210]
The gnss_letter parameter can be:
Additionally, as of firmware version 7.0.1, it is possible to specify only the signal mode and
satellite id. All signals that have been enabled by the source:onechn:signaltype com-
mand (or via the front panel) and are compatible to the specified signal mode and satellite
id remain set. Incompatible signals are automatically disabled. This syntax is designed to be
used together with the ‘source:onechn:signaltype’ command, so that you can first spe-
cify the signal mode and satellite ID using the ‘source:onechn:satid’ command and later
specify particular signals with the ‘source:onechn:signaltype’ command.
When GLONASS signals are selected along with the modulated mode, the GLONASS fre-
quency slot is determined by the satellite id from the navigation data (specified either using
the SOURce:ONECHN:EPHemeris command or from the Ephemeris field in the front panel
interface).
For the PRN mode, the frequency slot for GLONASS is determined automatically by a pre-
defined mapping of satellite id to frequency slot.
While the GSG unit is generating RF it is possible to change the signal mode using the
reduced command syntax specifying only the desired signal mode. Note that currently it is
only possible to change the signal mode to any mode that is ‘lower’ or equal to the initial
signal mode used when the signal generator was started. For example, if the signal gen-
erator is started in PRN mode it is possible to switch to unmodulated mode and back to
PRN mode, but not to modulated mode. If started in modulated mode it is possible to
switch between all three signal modes. The signal mode cannot be changed if the signal
generator started in unmodulated mode.
SOURce:ONECHN:SATid G11
Set unmodulated GLONASS signal with frequency slot -5:
SEND:
SOURce:ONECHN:SATid UR-5
Examples (used while the unit is generating RF, e.g. executing a scen-
ario)
Set signal mode to unmodulated mode:
SEND:
SOURce:ONECHN:SATid U
Set signal mode to PRN:
SEND:
SOURce:ONECHN:SATid P
Set signal mode to modulated mode:
SEND:
SOURce:ONECHN:SATid M
6.3.3.26 SOURce:ONECHN:SATid?
Function
Query the 1-channel mode satellite identifier. The returned satellite identifier can be:
Gxx for GPS, for example G12
Rxx for GLONASS, for example R15
Command Syntax
SOURce:ONECHN:SATid?
Notes
If several signal types are selected with either SOURce:ONECHN:SIGNALtype or via menus,
then the returned value may have several satellite identifiers separated by comma.
If the transmission of data message is disabled, the satellite identifier is preceded by the let-
ter “P”. For example, the identifier is “PG30” for the simulated GPS satellite 30, trans-
mitting only the PRN code.
As of firmware version 7.0.1 this query takes into account possible signal mode modi-
fications made by SOURce:ONECHN:SATID command while the signal generator is running.
Example
SEND:
SOURce:ONECHN:SATid?
READ:
G13
SEND:
SOURce:ONECHN:SATid?
READ:
G5,R5
6.3.3.27 SOURce:ONECHN:STARTtime
Function
Set & store 1-channel mode start time (use this command only while the unit is not gen-
erating any RF).
Command Syntax
SOURce:ONECHN:STARTtime <string>
Note
Seconds are omitted, always starts at 0 seconds.
Parameter
String of format DD/MM/YYYY hh:mm, where:
DD=day, MM=month, YYYY=year, hh=hour, mm=minutes
Example
SEND:
6.3.3.28 SOURce:ONECHN:STARTtime?
Function
Query 1-channel mode start time.
Command Syntax
SOURce:ONECHN:STARTtime?
Example
SEND:
SOURce:ONECHN:STARTtime?
READ:
23/11/2010 12:45
6.3.3.29 SOURce:ONECHN:EPHemeris
Function
Set & store 1-channel mode ephemeris files to be used (use this command only while the
unit is not generating any RF).
Ephemeris files may include RINEX v2 or newer navigation message files for GPS and/or
GLONASS, “agl” type GLONASS almanac, or EGNOS/WAAS SBAS message files.
Command Syntax
SOURce:ONECHN:EPHemeris <string>
Parameter
String identifier of filename(s)
Example
SEND:
SOURce:ONECHN:EPHemeris brdc0020.09n7
SEND:
SOURce:ONECHN:EPHemeris Geo133_1736_01
6.3.3.30 SOURce:ONECHN:EPHemeris?
Function
Query 1-channel mode ephemeris files.
Command Syntax
SOURce:ONECHN:EPHemeris?
Example
SEND:
SOURce:ONECHN:EPHemeris?
READ:
Default
6.3.3.31 SOURce:ONECHN:FREQuency
Function
Set & store 1-channel mode frequency offset (use this command only while the unit is not
generating any RF).
Parameter can also have optional suffix (MHz, kHz or Hz).
Command Syntax
SOURce:ONECHN:FREQuency <decimal>
Parameter
decimal [-6000000, 6000000] in Hz
Example
SEND:
SOURce:ONECHN:FREQuency -54
SEND:
6.3.3.32 SOURce:ONECHN:FREQuency?
Function
Query 1-channel mode frequency offset in MHz.
Command Syntax
SOURce:ONECHN:FREQuency?
Example
SEND:
SOURce:ONECHN:FREQuency?
READ:
4.345
6.3.3.33 SOURce:ONECHN:SIGNALtype
Function
Sets signal(s) to be simulated (use this command only while the unit is not generating any
RF). Signal type consists of comma separated list of signal names, as described under “Para-
meters” below.
Command Syntax
SOURce:ONECHN:SIGNALtype <string>
Notes
The satellite system GPS/GLONASS/GALILEO, BeiDou/QZSS/IRNSS and the mod-
ulation (signal mode) are set with the SOURce:ONECHN:satID command.
In firmware versions before version 7.0.1 if requested signal types were not compatible
with the satellite ID selected either by the SOURce:ONECHN:satID command or from the
front panel those signals were ignored and not set. As of firmware version 7.0.1 any incom-
patible signal results in whole command failure so that no signal is set.
Parameters
<String> – GPSL1CA,GPSL1P,GPSL1PY, GPSL2P,GPS L2PY for GPS
<String> – GLOL1,GLOL2 for GLONASS
<String> – GALE1,GALE5a,GALE5b for Galileo
<String> – BDSB1, BDSB2 for BeiDou
<String> – QZSSL1CA, QZSSL1SAIF, QZSSL2C, QZSSL5 for QZSS
<String> – IRNSSL5 for IRNSS
Example
SEND:
SOURce:ONECHN:SIGNALtype GPSL1CA,GPSL2P
SEND:
SOURce:ONECHN:SIGNALtype GPSL1CA,GLOL2
6.3.3.34 SOURce:ONECHN:SIGNALtype?
Function
Query 1-channel signal type in use. Signal type consists of comma-separated list of the sim-
ulated signals.
Command Syntax
SOURce:ONECHN:SIGNALtype?
Example
SEND:
SOURce:ONECHN:SIGNALtype?
READ:
GPS L1CA,GPSL2P
SEND:
SOURce:ONECHN:SIGNALtype?
READ:
GPS L1CA,GLOL1,GALE1,BDSB1,QZSSL1CA,IRNSSL5
6.3.3.35 SOURce:ONECHN:LOSDynamics:SETtings
Function
Set the line of sight dynamics parameters for the Signal Generator.
If the profile is running new parameters are memorized, but will be applied only on profile
restart.
Command Syntax
SOURce:ONECHN:LOSDynamics:SETtings <J>,<A>,<DA>,<DV>
Parameters
<J> – absolute jerk value in m/s³
<A> – maximum absolute acceleration value in m/s²
<DA> – duration of movement with constant acceleration, positive value, in seconds;
<DV> – duration of movement with constant velocity DV, positive value, in seconds
Example
SEND:
Figure 6-1: Jerk [m/s³], acceleration [m/s²], velocity [m/s], and range [m] over time [s]
6.3.3.36 SOURce:ONECHN:LOSDynamics:SETtings?
Function
Queries the line of sight dynamics profile parameters previously set by the
SOURce:ONECHN:LOSDynamics:SETtings command.
Command Syntax
SOURce:ONECHN:LOSDynamics:SETtings?
Example
SEND:
SOURce:ONECHN:LOSD:SET?
READ:
0.005,0.1,20,2
6.3.3.37 SOURce:ONECHN:LOSDynamics:CONTrol
Function
Starts, restarts or stops the line of sight dynamics profile. This command can only be used
while RF is generated. Before starting the profile its parameters must be set using the
SOURce:ONECHN:LOSDynamics:SETtings command.
After the profile is started, the Doppler frequency shift is controlled automatically and can
neither be changed using the SOURce:ONECHN:FREQuency command, nor via the front
panel.
Command Syntax
SOURce:ONECHN:LOSDynamics:CONTrol <START|STOP>
Parameters
<START> – starts line of sight dynamics profile if the profile is not running or restarts the
profile applying new parameters
<STOP> – stops line of sight dynamics profile
Example
SOUR:ONECHN:LOSD:CONT START
6.3.3.38 SOURce:ONECHN:LOSDynamics:CONTrol?
Function
Queries the current status of the line of sight dynamics profile, i.e. whether it is running
(active) or not.
Command Syntax
SOURce:ONECHN:LOSDynamics:CONTrol?
Return values
<START> – the profile is currently active
<STOP> – the profile is not active
Example
SEND:
SOUR:ONECHN:LOSD:CONT?
READ:
STOP
6.3.3.39 SOURce:SCENario:LOAD
Function
Load the scenario as specified by <string>.
Command Syntax
SOURce:SCENario:LOAD <string>
Note
Calling the command will stop any running scenarios.
Parameter
String identifier of filename
Example
SEND:
SOURce:SCENario:LOAD scen01.scen
6.3.3.40 SOURce:SCENario:LOAD?
Function
Query the current loaded scenario.
Command Syntax
SOURce:SCENario:LOAD?
Example
SEND:
SOURce:SCENario:LOAD?
READ:
scen01.scen
6.3.3.41 SOURce:SCENario:CONTrol
Function
Control the execution of the scenario.
Command Syntax
SOURce:SCENario:CONTrol <START|STOP|HOLD|ARM>
Notes
The scenario must be loaded beforehand using SOURce:SCENario:LOAD.
Calling a START command will first automatically stop any running scenarios. HOLD can be
used to pause and resume trajectory movement, not the entire scenario. HOLD is effective
when a scenario is running.
ARMing a scenario means to hold a scenario before it is started.
Parameter
enum {START,STOP,HOLD,ARM}
Example
SEND:
SOURce:SCENario:CONTrol start
6.3.3.42 SOURce:SCENario:CONTrol?
Function
Query the current state of scenario execution. Meaning of returned values is the following:
START: scenario is started and running
STOP: scenario is stopped and thus not running
HOLD: scenario is running, but the trajectory is on hold
WAIT: scenario delays startup for 2 minutes to allow the simulation to load required
data. The start time derived from the NTP server is then aligned to the next full GPS
minute.
ARMED: scenario is armed, all data loading is done, but scenario is not yet running
but waiting for the trigger to start it
ARMING: scenario is being loaded to memory after which it is in ARMED state
Command Syntax
SOURce:SCENario:CONTrol?
Returned values
START, STOP, HOLD, WAIT, ARMED or ARMING
Example
SEND:
SOURce:SCENario:CONTrol?
READ:
START
6.3.3.43 SOURce:SCENario:PROPenv
Function
Sets built-in propagation environment model.
The parameters sky_limit, obstruction_limit and nlos_probability are optional,
either all of them or none should be set.
Notes:
The scenario must be running.
Note that 0<= obstruction_limit <= sky_limit <=90.
For additional information, see "Propagation Environment Models" on page 69.
Command Syntax
Parameter
Decimal [0.0,90.0] sky_limit: elevation above which there is no obstruction.
Decimal [0.0,90.0] obstruction_limit: elevation below which there is no line-of-sight
satellites.
Decimal [0.0,1.0] nlos_probability: probability for a satellite with elevation between
sky_limit and obstruction_limit to be non-line-of-sight.
Examples
SEND:
SOURce:SCENario:PROPenv urban
SEND:
SOURce:SCENario:PROPenv suburban,50,30,0.2
6.3.3.44 SOURce:SCENario:PROPenv?
Function
Query the current propagation model and its parameters.
Command Syntax
SOURce:SCENario:PROPenv?
Example
SEND:
SOURce:SCENario:PROPenv?
READ:
suburban,50,30,0.2
6.3.3.45 SOURce:SCENario:LOG?
Function
Get current position as NMEA data, available only when scenario is running.
Command Syntax
SOURce:SCENario:LOG?
Example
SEND:
SOURce:SCENario:LOG?
READ:
$GPRMC,181810.000,A,6000.1041,N,2400.0553,E,019.4,284.9,060109,,*0B
$GPGGA,181810.000,6000.1041,N,2400.0553,E,1,15,0.6,587.0,M,0.0,M,,,*0F
$GPGSV,4,1,15,23,77.7,192.3,44,20,52.8,132.7,44,32,31.2,117.3,44,31,2-
4.6,44.0,44*00
$GPGSV,4,2,15,16,9.2,96.3,44,7,1.1,190.7,44,17,0.5,242.4,44,2,17.4,31-
9.9,44*00
$GPGSV,4,3,15,30,6.3,1.2,44,4,46.0,280.1,44,13,51.5,230.8,44,25,19.6,-
184.5,44*2A
$GPGSV,4,4,15,126,22.0,178.8,44,124,21.9,182.9,44,120,14.3,223.6,44*E4
6.3.3.46 SOURce:SCENario:ADVLOG?
Function
The Advanced Log feature queries log records of the specified log. This feature is effect-
ive as of firmware version 6.7.1.
The following logs can be queried:
RSG log – contains realtime movement parameters of the object being modelled
along with time information;
SAT log – contains various data describing modelled satellites movement para-
meters along with time.
NAVMSG log – contains navigation data messages transmitted by simulated satellite
Command Syntax
SOURce:SCENario:ADVLOG? <logID>[,<filter1>,<filter2>,...,
<filterN>]
<logID> – log identifier that specifies what log data to request
<filterX> – optional filter expression that allows to include into response only specified
record types
Mechanism
When a scenario is running, the GSG unit internally creates log records at predefined time
intervals and puts them into a limited-size queue with a FIFO (First In – First Out) structure
where they remain for some time (several seconds). As the scenario continues to run, new
records get added into the log and old records get removed either automatically or by
request from the user. Each type of log features its own (independent) queue.
RSG log records are created every 100 ms. SAT log records are created every 1 second.
When requested using the sour:scen:advlog? command, log records are removed from
the queue starting with the oldest available records. They are returned as text lines con-
taining comma-separated fields. These lines can be easily processed by user-developed
software to extract specific fields, or they can be stored in a csv-file allowing for further ana-
lysis with spreadsheet software.
When the user does not request any log records, the latest log records remain in their
queues until the unit is requested to start a new scenario. Hence it is possible to get remain-
ing records even after a scenario was stopped.
One possible approach to using the advanced log feature is to periodically make a series of
repetitive queries, waiting for an empty response in each series. An empty response sig-
nifies that the most recent data have been received and no new data is available so far.
Filter expressions
Each log supports individual filter expressions. Several of them can be combined with com-
mas to specify what record types should be included in the response. If no filter expression
is specified, the return response will contain all supported record types.
For the RSG log the supported record types are:
SOUR:SCEN:ADVLOG? RSG,BODY_CENTER
SOUR:SCEN:ADVLOG? RSG,CENTER,ANT
EXAMPLE:
SEND:
sour:scen:advlog? sat
READ:
6.3.3.47 SOURce:SCENario:ADVLOG:HEADer?
Function
Queries the header for the data of the specified log. This feature is effective as of firmware
version 6.7.1.
This command is intended to be used together with the command SOURce:SCENari-
o:ADVLOG?, and allows to get a line of comma-separated labels for fields of corresponding
log records.
Command Syntax
SOURce:SCENario:ADVLOG:HEADer? <logID>
<logID> — Log identifier that specifies the advanced log for which to obtain the header.
Notes
The position of specific field label within the comma-separated line is the same as the pos-
ition of that field’s value within a response line of the SOURce:SCENario:ADVLOG com-
mand.
In order to be compatible with future versions of the unit firmware, any user-developed
software should not strictly rely on a specific order of fields in responses to the
SOURce:SCENario:ADVLOG? and SOURce:SCENario:ADVLOG:HEADer? commands.
Before issuing log record requests user-developed software should:
a. first request the log header once,
b. then determine positions of all fields of interest based on their labels,
c. and then refer to log record fields by their determined positions.
The order of fields is fixed within one firmware version.
When the logID argument is RSG, the following fields are available:
Field label
(in response to a Possible field values (in response to a
Field meaning
“SOURce:SCENario: “SOURce:SCENario:ADVLOG?” query)
ADVLOG:HEADer?” query)
Field label
(in response to a Possible field values (in response to a
Field meaning
“SOURce:SCENario: “SOURce:SCENario:ADVLOG?” query)
ADVLOG:HEADer?” query)
Field label
Possible field values
(in response to a
(in response to a
“SOURce:SCENario: Field meaning
“SOURce:SCENario:ADVLOG?”
ADVLOG:HEADer?”
query)
query)
As of firmware version 6.7.5, when LogID is NAVMSG, the following fields are available:
Field label
(in response
to a Possible field values
Field
“SOURce:SC- (in response to a
mean-
ENario: “SOURce:SCENario:ADVLOG?”
ing
ADVLOG:HEA- query)
Der?”
query)
Field label
(in response
to a Possible field values
Field
“SOURce:SC- (in response to a
mean-
ENario: “SOURce:SCENario:ADVLOG?”
ing
ADVLOG:HEA- query)
Der?”
query)
signal_type Signal For GPS satellites: L1CA, L1P, L1CAP, L2P; “L1CAP” is used when the satel-
type of lite has both L1CA and L1P signals enabled.
nav-
igation
mes-
sage
Example:
SEND:
sour:scen:advlog:head? sat
READ:
id, SAT, time, utc_time, gps_sow, sat_id, pos_x, pos_y, pos_z, pr_l1,
prr_l1, doppler_shift_l1, doppler_shift_rate_l1
6.3.3.48 SOURce:SCENario:OBServation
Function
Turn on scenario observations.
All parameters are seconds.
Start is the number of seconds from scenario start.
Duration is length of observations from start. Interval is the interval between the individual
observations in the resulting Rinex OBS file.
Observations files are created in observations/ with name <scenarioName> <yyyym-
mddhhmmss>.obs, where the date is the date of the first observation in the file.
Observation files can be retrieved using the MMEMory commands. Maximum length for
each file is 1 hour (3600 seconds). If duration is longer than 1 hour, then multiple files are
created.
Command Syntax
SOURce:SCENario:OBServation <start>,<duration>,<interval>
Parameter
Decimal start [-1,nnn] seconds. If ‘-1’ is used the logging will start immediately when a com-
mand is received, and this is only available when the scenario is running.
Decimal duration [-1,nnn] seconds. If ‘-1’ is used the logging will continue until the scenario
is running
Decimal interval [1,3600] seconds
Example
SEND:
SOURce:SCENario:OBS 10,3600,1
6.3.3.49 SOURce:SCENario:OBServation?
Function
Query scenario observation parameters.
Command Syntax
SOURce:SCENario:OBServation?
Example
SEND:
SOURce:SCENario:OBS?
READ:
10,3600,1
6.3.3.50 SOURce:SCENario:NAV
Function
Turn ON/OFF RINEX navigation data logging.
The generated files are in RINEX 3.0.2 mixed format, so the information for all the sim-
ulated constellations/satellites will be written into one file.
Note that the RINEX data is logged only when the GSG generates new navigation message
sets, which is not done often. Therefore, the recommended way to use this command is to
turn ON RINEX navigation data logging before a scenario is started. Logging is stopped
when scenario stops. See the GSG User Manual for naming of the generated files.
Command Syntax
SOURce:SCENario:NAV <ON|OFF>
Parameter
ON | OFF
Example
SEND:
SOURce:SCENario:NAV ON
6.3.3.51 SOURce:SCENario:NAV?
Function
Query status of RINEX navigation data logging.
Command Syntax
SOURce:SCENario:NAV?
Example
SEND:
SOURce:SCENario:NAV?
READ:
OFF
6.3.3.52 SOURce:SCENario:SATid[n]?
Function
Query the current satellite identifier of channel n. The parameter n can be 1-5 for GSG-
52/53, 1-8 for GSG-54, 1-16 for GSG-55/GSG-56 and 1-32/48/64 for GSG-62/63/64.
The returned satellite identifier can be:
Gxx for GPS for example G12
Rxx for GLONASS, for example R15
Exx for Galileo, for example E01
Cxx for BeiDou, for example C11
Jxx for QZSS, for example J02
Ixx for IRNSS, for example I01
Sxxx for SBAS for example S120
UG for unmodulated GPS signal
UE for unmodulated Galileo signal
UC for unmodulated BeiDou signal
UJ for unmodulated QZSS signal
UI, for unmodulated IRNSS signal
URx for unmodulated GLONASS signal. X is the frequency slot from -7 to 6
Would the signal be a multipath signal, this is identified by an added character D at the end.
The satID is returned with a leading timestamp.
Command Syntax
SOURce:SCENario:SATid[n]?
Note
Only available during scenario execution.
Example
SEND:
SOURce:SCENario:SATid5?
READ:
123.4,R23
6.3.3.53 SOURce:SCENario:SIGNALtype[n]?
Function
Query signal type of satellite. The parameter n can be:
1-5 for GSG-52/53
1-8 for GSG-54
1-16 for GSG-55/GSG-56 and
1-32/48/64 for GSG-62/63/64.
The signal type consists of a comma-separated list of frequency bands and codes (CA or P
code) for GPS and frequency bands for GLONASS, Galileo, BeiDou, QZSS and IRNSS.
Command Syntax
SOURce:SCENario:SIGNALtype[n]?
Example
SEND:
SOURce:SCENario:SIGNALtype20?
READ:
GPSL1CA,GPSL2P
6.3.3.54 SOURce:SCENario:SIGNALtype?
Function
Query the signal satellite types in the form of comma-separated values.
Command Syntax
SOURce:SCENario:SIGNALtype? <satID>
Parameter
satID – The format is explained under "SOURce:ONECHN:SATid?" on page 252.
Example
SEND:
SOURce:SCENario:SIGNALtype? G2
READ:
GPSL1CA,GPSL2P
6.3.3.55 SOURce:SCENario:NAVBITS
Function
Sets bits in a navigation message.
The endBitPos - startBitPos +1 LSB of the hexstring are used to replace the bits between
startBitPos and endBitPos, so that the endBitPos is aligned with the LSB of the hexstring.
In case endBitPos - startBitPos +1 > length(hexstring), the hexstring will be used as a
repeating pattern to replace the bits between startBitPos and endBitPos.
Multiple commands may be applied to the same message.
Command Syntax
Note
Only available during scenario execution.
Parameter
satID – GPS, Glonass, BeiDou, QZSS and SBAS are supported, the format is explained
under "SOURce:ONECHN:SATid?" on page 252.
sigtype – One of the signal types supported by the satellite, allowed values are:
For GPS: L1CA, GPSL1CA, L1P, GPSL1P, L1PY, GPSL1PY, L1CAP, GPSL1CAP,
L1CAPY, GPSL1CAPY, L2P, GPSL2P, L2PY, GPSL2PY, L2C, GPSL2C, L5, GPSL5
Note: The signal types from the same group below share the same
navigation bit stream.
Note: The signal types from the same group below share the same
navigation bit stream.
L1, GLOL1
L2, GLOL2
For Galileo: E1, E5a, E5b
For BeiDou: B1, B2,
For QZSS: L1CA, L1SAIF (L1SBAS can be also used for L1SAIF)
For SBAS: L1SBAS or SBASL1, L5SBAS or SBASL5
sfid – For GPS L1 and L2P signals: subframe id
For GPS L2C and L5 signals: message type
For Glonass: frame id
For Galileo E1 and E5b signals: word id
For Galileo E5a: page id
For BeiDou: subframe id
For QZSS L1CA: subframe id
For QZSS L1SAIF: message type, where 0 means that the modification is applied on
the next message independently of its type
For SBAS: message type, where 0 means that the modification is applied on the
next message independently of its type
pageid – For GPS L1 and L2P signals: page id and 0 (not relevant) when subframe id is 1-3
For GPS L2C and L5 signals: 0 (not relevant)
For Glonass: string id
For Galileo E1 and E5b signals: 0/1 (even/odd)
For Galileo E5a: 0 (not relevant)
For BeiDou: page id
For QZSS L1CA: page id and 0 (not relevant) when subframe id is 1-3
For QZSS L1SAIF: 0 (not relevant)
For SBAS: 0 (not relevant)
startBitPos, endBitPos – positions of bits in a navigation message,
Note: For Glonass the bit count starts from LSB, whereas for other mes-
sages the bit count starts from MSB.
Example
Set MSB to 1 in 6 bit health (bits 77-82) in subframe 1 of the GPS L1CA message:
SOUR:SCEN:NAVBITS IMM,G23,L1CA,1,0,77,77,1,1,0,1
Example message in the execution log:
sour:scen:navbits IMM,G23,L1CA,3,0,1,300,0,0,0
Set bits 16-119 to 1 in the next QZSS L1SAIF message from satellite J3:
sour:scen:navbits IMM,J3,L1SAIF,0,2,16,119,FF,0,1
6.3.3.56 SOURce:SCENario:FREQuency[n]?
Function
Query the current frequency setting ofn when scenario is running. The parameter n can be
1-8 for GSG-54, 1-16 for GSG-55/56 and 1-32/48/64 for GSG-62/63/64. The frequency
is returned with a leading timestamp.
Command Syntax
SOURce:SCENario:FREQuency[n]?
Note
Only available during scenario execution.
Example
SEND:
SOURce:SCENario:FREQuency3?
READ:
123.4,-480.513
6.3.3.57 SOURce:SCENario:FREQuency?
Function
Query the current frequency setting of channel satID when scenario is running. The fre-
quency is returned with a leading timestamp.
Command Syntax
SOURce:SCENario:FREQuency? <satID>
Note
Only available during scenario execution.
Parameter
For a list of satID satellite identifiers, see "SOURce:ONECHN:SATid?" on page 252.
Example
SEND:
SOURce:SCENario:FREQuency? G32
READ:
123.4,-480.513
6.3.3.58 SOURce:SCENario:POWer[n]
Function
Sets the absolute power of channel or switch power ON or OFF when the scenario is run-
ning.
The parameter n, the channel number, can be:
1-5 for GSG-52/53
1-8 for GSG-54
1-16 for GSG-55/56
1-32/48/64 for GSG-62/63/64.
The freqband parameter is optional and can be used when only a certain satellite fre-
quency band power is changed.
The value ALL in freqband means that the power for all bands is adjusted by the amount
indicated via the command.
The command also accepts ON/OFF keywords as an argument, see examples below.
Command Syntax
SOURce:SCENario:POWer[n] <decimal>[,<freqband>]
SOURce:SCENario:POWer[n] ON|OFF
Note
Only available during scenario execution.
Parameters
Decimal [-160.0,-65.0] dBm, if freqband is not ALL. For ALL, the relative change by
which the power setting is to be modified, should be limited to a delta of 100 (e.g., chan-
ging a power of -65 dBm to -165 dBm (by -100) and vice versa (+100).
FreqBand [L1, L2, L5, ALL]
Examples
SOURce:SCENario:POWer3 -75, ALL
Set absolute power to -75 dBm for all channel #3 freqbands
SOURce:SCENario:POWer3 -115, L1
Set absolute power to -115 dBm for the L1 channel #3 freqband
SOUR:SCEN:POW2 OFF
Turns OFF power for channel #2
SOUR:SCEN:POW3 ON
Turns ON power for channel #3, absolute power restored to the level it had before
switching power off
6.3.3.59 SOURce:SCENario:POWer[n]?
Function
Query the current power setting of channel/satellite/satellite system/scenario during
scenario execution.
The parameter n (the channel number) can be:
1-5 for GSG-52/53
1-8 for GSG-54
1-16 for GSG-55/56
1-32/48/64 for GSG-62/63/64.
The absolute power is returned with a leading timestamp.
Freqband is an optional parameter used to specify for which frequency band the power is
returned.
Command Syntax
SOURce:SCENario:POWer[n]? [<freqband>]
Note
Only available during scenario execution.
Parameter
FreqBand [L1, L2, L5, ALL]
Example
SOUR:SCEN:POWer3?
Returns power of channel #3
Example return value: 123.4, -119.7
SOUR:SCEN:POWer2? L5
Returns L5 power of channel #2
Example return value: 123.4, -119.7
6.3.3.60 SOURce:SCENario:POWer
Function
Set the power of satellite satID when scenario is running. Freqband parameter is optional
and can be used when only certain frequency band power of satellite is changed. Value
ALL in freqband means that power of all bands are adjusted by the amount indicated by
the command.
Command Syntax
SOURce:SCENario:POWer ON|OFF
SOURce:SCENario:POWer <satID>,<decimal>[,<freqband>]
SOURce:SCENario:POWer <SatSystem>,<decimal>[,<freqband>]
Note
Only available during scenario execution.
Parameter
Decimal [-160.0,-65.0] dBm, if freqband is not ALL. For ALL, the relative change by
which the power setting is to be modified, should be limited to a delta of 100 (e.g., chan-
ging a power of -65 dBm to -165 dBm (by -100) and vice-versa (+100).
For a list of satID satellite identifier, see "SOURce:ONECHN:SATid?" on page 252.
FreqBand [L1, L2, L5, ALL]. If the freqband is not specified, it is assumed to be L1.
Examples
SOURce:SCENario:POWer R22,-115, L1
Sets power of L1 freqbands of satellite R22 to -120 dBm
SOUR:SCEN:POW GPS,-120, L5
Sets power of all GPS L5 channels to -120 dBm
SOUR:SCEN:POW GLO,OFF
Turns off power of all GLONASS satellites
SOUR:SCEN:POW GAL,ON
Turns on power of all Galileo satellites, absolute power is restored to the level it had
before it was turned off
6.3.3.61 SOURce:SCENario:POWer?
Function
Query the current power setting of the satellite satID during scenario execution. The
power is returned with a leading timestamp. Freqband is an optional parameter used to
specify the frequency band whose power is returned. If freqband is omitted, the L1 power
is returned.
Command Syntax
SOURce:SCENario:POWer? <satID>[,<freqband>]
SOURce:SCENario:POWer? <SatSystem>[,<freqband>]
Note
Only available during scenario execution.
Parameter
For a list of satID satellite identifiers see "SOURce:ONECHN:SATid?" on page 252.
FreqBand [L1, L2, L5, ALL]
SatSystem- the name of the satellite system. [GPS, GLONASS, GLO, GALILEO, GAL,
BEIDOU, BDS, QZSS, IRNSS, SBAS]
Example
SOURce:SCENario:POWer?
Returns OFF when there is no active satellites in scenario (for example after
SOUR:SCEN:POW OFF command) on ON when at least one active satellite exists in
scenario
SOUR:SCEN:POWer? G1,L2
Returns power in L2 freqband of G1 satellite
SOUR:SCEN:POWer? GPS,L5
Returns OFF when power is off for all GPS L5 satellites or ON when at least one
GPS L5 active satellitesexists in scenario
6.3.3.62 SOURce:SCENario:FREQBAND:POWer
Function
Set the power for a frequency band (all satellites) when scenario is running. Freqband is
used to specify the frequency band. The freqband value ALL means that the power for all
bands is adjusted by the amount indicated.
Command Syntax
SOURce:SCENario:FREQBAND:POWer <decimal>[,<freqband>]
Note
Only available during scenario execution.
Parameter
Decimal [-160.0,-65.0] dBm if freqband is not ALL. For ALL, the limits are [-100,100] dB.
FreqBand [L1, L2, L5, ALL]
Examples
SEND:
SOURce:SCENario:FREQBAND:POWer -115,L1
SEND:
SOURce:SCENario:FREQBAND:POWer 10,ALL
6.3.3.63 SOURce:SCENario:SVmodel?
Function
Query the satellite’s Space Vehicle model. The Space Vehicle model can be:
Block II, Block IIA, Block IIR, Block IIR-M, Block IIF or Block IIIA for GPS
Glonass-M or Glonass-K1 for GLONASS
Command Syntax
SOURce:SCENario:SVmodel? <satID>
Parameter
Decimal [-160.0,-65.0] dBm, if freqband is not ALL. For ALL, the limits are [-100,100] dB.
For a list of satID satellite identifiers, see "SOURce:ONECHN:SATid?" on page 252.
Example
SEND:
SOURce:SCENario:SVmodel? G11
READ:
Block IIR-M
6.3.3.64 SOURce:SCENario:SVmodel[n]?
Function
Query the satellite’s Space Vehicle model.
The parameter n can be:
1-5 for GSG-52/53
1-8 for GSG-54
1-16 for GSG-55/GSG-56
1-32 for GSG-62.
The Space Vehicle model can be:
Block II, Block IIA, Block IIR, Block IIR-M, Block IIF or Block IIIA for GPS
Glonass-M or Glonass-K1 for GLONASS
Command Syntax
SOURce:SCENario:SVmodel[n]?
Example
SEND:
SOURce:SCENario:SVmodel4?
READ:
Block IIR-M
6.3.3.65 SOURce:SCENario:LIST?
Function
List possible models which can be used in the scenarios. Note that for ionomodels, the
options are limited to ‘ON, OFF’.
Command Syntax
Example
SEND:
SOURce:SCENario:LIST? antennamodels
READ:
6.3.3.66 SOURce:SCENario:ANTennamodel
Function
Set the antenna model for the current scenario.
Command Syntax
SOURce:SCENario:ANTennamodel <antennamodel>
Example
SEND:
6.3.3.67 SOURce:SCENario:ANTennamodel?
Function
Query the antenna model of current scenario.
Command Syntax
SOURce:SCENario:ANTennamodel?
Example
SEND:
SOURce:SCENario:ANTennamodel?
READ:
Zero model
6.3.3.68 SOURce:SCENario:TROPOmodel
Function
Set the tropospheric model for the current scenario.
Command Syntax
SOURce:SCENario:TROPOmodel <tropomodel>
Example
SEND:
6.3.3.69 SOURce:SCENario:TROPOmodel?
Function
Query the tropospheric model of the current scenario.
Command Syntax
SOURce:SCENario:TROPOmodel?
Example
SEND:
SOURce:SCENario:TROPOmodel?
READ:
Saastamoinen
6.3.3.70 SOURce:SCENario:IONOmodel
Function
Select the ionospheric model to be used in the current scenario. Permitted values are ON
and OFF.
Command Syntax
SOURce:SCENario:IONOmodel <ionomodel>
6.3.3.71 SOURce:SCENario:IONOmodel?
Function
Query whether the Ionospheric model is used in the current scenario. The command
returns:
‘OFF’, if the ionospheric model is not used
‘ON’ if the Klobuchar model is used
a comma-separated list of files, if IONEX files are used.
Command Syntax
SOURce:SCENario:IONOmodel?
Note
When ‘OFF’ or ‘ON’ mode is selected and ionospheric correction can be determined using
SBAS satellites, then SBAS satellites information is used.
When IONEX files are used and ionospheric correction cannot be determined using the
specified IONEX files e.g., because the IONEX files do not cover the current time or pos-
ition, then the unit will act as if the ‘ON’ mode was selected.
Example
SEND:
SOURce:SCENario:IONOmodel?
READ:
ON
SEND:
SOURce:SCENario:IONOmodel?
READ:
codg0010.14i,codg0030.14i,codg0020.14i
6.3.3.72 SOURce:SCENario:POSition
Function
Set latitude, longitude and altitude for the geodetic position (WGS84) as the start position
for the loaded scenario, or the current position if the scenario is running.
Latitude and longitude are defined using decimal degrees. The altitude is given in meters
as altitude over an ellipsoid.
For latitude and longitude, the recommended decimal accuracy is 8 digits, with 6 digits
being the minimum recommended accuracy. No benefit is achieved at accuracies greater
than 10 digits for latitude or longitude.
The altitude can be specified to a resolution down to two digits or centimeter level. No
benefit is achieved with altitude accuracies greater than 4 decimal digits.
Command Syntax
SOURce:SCENario:POSition TIME,<decimal>,<decimal>,<decimal>
Parameter
TIME must be IMMediate.
Decimal Latitude [-89.99999999, +89.99999999] degrees North
Decimal Longitude [-360.00000000, +360.00000000] degrees East
Decimal Altitude [-1000.00, +20,200,000.00] meters
Notes
If a scenario is armed but not running yet, an error is returned.
The maximum altitude for normal operation is 18470 meters. (With Extended Limits it is
20,200 km).
This command changes position of the currently loaded scenario, but does not change the
scenario file, so that when you try to edit the scenario, you will see unchanged parameters
from the file.
Example
SEND:
SOURce:SCENario:POSition IMM,-77.58895432,43.08332157,168.58
6.3.3.73 SOURce:SCENario:POSition?
Function
Query the current geodetic position in latitude, longitude and altitude during scenario exe-
cution or the start position, if a scenario is loaded and not running yet. A time stamp of the
elapsed time into the scenario is also returned.
Command Syntax
SOURce:SCENario:POSition?
Example
SEND:
SOURce:SCENario:POSition?
READ:
0.0,-77.58895432,43.08332157,168.58
6.3.3.74 SOURce:SCENario:ECEFPOSition
Function
Set the ECEF position in X, Y and Z coordinates as the start position for the loaded scen-
ario or the current position, if the scenario is running.
The X, Y, and Z position is given in decimal meters. The recommended decimal accuracy of
ECEF is 2 decimal digits. No benefit for ECEF positions is achieved at accuracies greater
than 4 digits.
Command Syntax
SOURce:SCENario:ECEFPOSition TIME,<decimal>,<decimal>,<decimal>
Note
If a scenario is armed and not running yet, an error is returned.
Parameter
Decimal X Position [-26 500 000.00, +26 500 000.00] meters
Decimal Y Position [-26 500 000.00, +26 500 000.00] meters
Decimal Z Position [-26 500 000.00, +26 500 000.00] meters
TIME must be IMMediate.
Note
The maximum altitude for normal operation is 18470 meters. (Altitude for Extended Limits
is 20,200 Km.)
This command changes position of the currently loaded scenario, but does not change the
scenario file, so that when you try to edit the scenario, you will see unchanged parameters
from the file.
Example
SEND:
6.3.3.75 SOURce:SCENario:ECEFPOSition?
Function
Query the current ECEF position in X, Y and Z coordinates during scenario execution or
the start position, if a scenario is loaded and not running yet.
Command Syntax
SOURce:SCENario:ECEFPOSition?
Example
SEND:
SOURce:SCENario:ECEFPOSition?
READ:
6.3.3.76 SOURce:SCENario:DATEtime
Function
Set the scenario start time as GPS time.
Command Syntax
Note
If scenario is running or armed, an error is returned.
Parameter
String format:
MM-DD-YYYY hh:mm
…where MM=Month {01-12}, DD=day of month {01-31}, YYYY=year, hh=hours {00-23},
mm=minutes {00-59}.
For Simulate Now, the string must be“NTP”.
This command changes start time of the currently loaded scenario, but does not change
the scenario file, so that when you try to edit the scenario, you will see unchanged para-
meters from the file.
Example
SEND:
SOURce:SCENario:DATEtime NTP
6.3.3.77 SOURce:SCENario:DATEtime?
Function
Query the Date, Time and Timescale of the running scenario or the start time of the loaded
scenario. The default timescale is GPS. However, the user can optionally provide a para-
meter to convert the current Date and Time of the running scenario to various timescales
including GPS, UTC, BeiDou, QZSS, Galileo, GLONASS, EGNOS Network Time and WAAS
Network Time. If no argument is provided, GPS time scale is returned. Correct time con-
version to a timescale different from GPS can be performed only when a scenario is run-
ning, because timescales relation information is loaded only when starting a scenario. The
special parameter RUNTIME can be used to get start time together with elapsed scenario
time in seconds when scenatio is running.
Command Syntax
When scenario is not running:
SOURce:SCENario:DATEtime?
When scenario is running:
SOURce:SCENario:DATEtime? <gps|utc|bds|qzt|gal|glo|glo0|ent|wnt>
SOURce:SCENario:DATETIME? RUNTIME
Return
When no argument is specified, or the timescale argument is specified, returned string cor-
responds to one of the following formats:
MM-DD-YYYY hh:mm:ss.s AAA
NTP
…where MM=Month {01-12}, DD=day of month {01-31}, YYYY=year, hh=hours {00-23},
mm=minutes {00-59}, ss.s=seconds {00-59} with one decimal of sub-seconds digits.
The Timescale AAA= {GPS, UTC, BDS, QZS, GAL, GLO, GLO0, ENT, WNT} field supports
various GNSS timescales. If AAA is not supplied, the default is GPS timescale.
NTP is returned when scenario start time is set to NTP.
When RUNTIME argument specified, returned string is a pair:
<date -time>
<elapsed -seconds>
...where date time is date and time in GPS scale as specified above, and elapsed seconds is
time in seconds elaped from scenario start.
Example
QUERY:
SOURce:SCENario:DATEtime? GLO
RESPONSE:
SOUR:SCEN:DATETIME? RUNTIME
RESPONSE:
6.3.3.78 SOURce:SCENario:RUNtime?
Function
Query the current length of time in seconds elapsed since the start of RF signal gen-
eration. The time is returned including 3 digits of sub-seconds. The accuracy is equivalent
to the system's internal update rate.
Notes
If no scenario is running, an error is returned.
Currently, the system accuracy is 10 Hz or 100 ms. Only a single digit of accuracy is valid.
Parameter
Decimal time [0, 2678400] Seconds Sub-Second Time [0,999] Milliseconds
Command Syntax/Example
SEND:
SOURce:SCENario:RUNtime?
READ:
123.400
6.3.3.79 SOURce:SCENario:ELAPsedtime?
Function
Query the time of a scenario elapsed since the start of RF signal generation. The time
returned is in units of days, hours, minutes, seconds, and 3 digits of sub-seconds. The accur-
acy is equivalent to the system's internal update rate.
Command Syntax
SOURce:SCENario:ELAPsedtime?
Notes
If no scenario is running, an error will be returned. Currently the system accuracy is 10 Hz or
100 ms. Only a single digit of accuracy is valid. For now we only plan to support the GPS
rimeframe, bu the UTC time scale is also defined.
Parameter
String format:
DDDdhh:mm:ss.xxx, where DDD=days, hh=hours, mm=minutes, ss=seconds, xxx-
x=sub-seconds up to three decimals
Example
SEND:
SOURce:SCENario:ELAPsedtime?
READ:
029d12:34:56.700 GPS
6.3.3.80 SOURce:SCENario:RTCM?
Function
Queries for the latest RTCM messages (update rate of 1Hz).
Returns a hexadecimal string of the latest RTCM messages, as configured.
Command Syntax
SOURce:SCENario:RTCM?
SOURce:SCENario:RTCM?
READ:
D300153EE001038519731F728933157AC40A72ABE4310000061AC0
6.3.3.81 SOURce:SCENario:RTCMCFG?
Function
Queries the current RTCM configuration for output.
Returns comma separated RTCM version (i.e., 3x or 2x), followed by the selected message
types.
Command Syntax
SOURce:SCENario:RTCMCFG?
Example
SEND:
SOURce:SCENario:RTCMCFG?
READ:
3x,1002,1006,1033
6.3.3.82 SOURce:SCENario:RTCMCFG
Function
Sets the RTCM configuration to use. The arguments given identify the RTCM messages to
be outputted.
Command Syntax
SOURce:SCENario:RTCMCFG 3x,<string>[,<string>]…
Parameter
string - 1002, 1004, 1006, 1010, 1012 and 1033.
Example
SEND:
SOURce:SCENario:RTCMCFG 3x,1004,1006
6.3.3.83 SOURce:SCENario:RLM
Function
This command supports the Galileo Return Link Acknowledgement Service by sending out
a Return Link Message to a user in distress, thereby informing him that his distress signal
has been detected and located. For more information, see "RLS (Return Link Service)"
on page 186.
The SCPI command is available in two variants:
Command Syntax
Short RLM message:
SOURce:SCENario:RLM 0,satID,int1,int2,int2,int4
Long RLM message
SOURce:SCENario:RLM 1,satID,int1,int2,int3,int4,int5,int6,int7,int8
Parameters
RLM [x]: 0 = short message; 1 = long message
satID: The satellite chosen to transmit the message (PRN).
int1...0: an unassigned decimal integer, representing 20 bits of RLM (SAR) data trans-
mitted within the INAV page, as illustrated below:
For additional information, see the Galileo Open Service Signal in Space Interface
Control Document.
Examples
Short RLM
SOURce:SCENario:RLM 0,satid,int1,int2,int3,int4
Satid = Galileo satellite in view in running scenario
Int1,int2,int3 – beacon id – 3x20bits converted to decimal
15 HEX ID -> 60 binary bits (3x20) -> each 20 bit binary converted to decimal
Int 4 – 4 bit message ID, 16 bit parameter data
SOURce:SCENario:RLM 0,satid,int1,int2,int3,int4
Satid = Galileo satellite in view in running scenario
Int1,int2,int3 – beacon id – 3 x 20bits converted to decimal
15 HEX ID -> 60 binary bits (3 x 20) -> each 20 bit binary converted to decimal
Int 4 – 4 bit message ID, 16 bit parameter data
SOUR:SCEN:RLM 0,8,711888,141509,1025,65536
Long RLM
SOURce:SCENario:RLM 1,satid,int1,int2,int3,int4,int5,int6,int7,int8
Satiid = Galileo satellite in view in running scneario
Int1,int2,int3: Beacon ID – 3 x 20 bits convertd to decimal
15 HEX ID -> 60 binary bits (3 x 20) –> each 20 bit binary converted to decimal
Int 4-8: 4bit message ID, 96 bit parameter data
SOUR:SCEN:RLM 1,8,711888,141509,1025,983040,1048575,1048575,1048575,1-
048575
6.3.3.84 SOURce:SCENario:DUPlicate
Function
This command creates a duplicate of the satellite with the given satID using the provided
multipath parameters. The parameters include the Range Offset, Range Change, Range
Interval, Doppler Offset, Doppler Change, Doppler Interval, Power Offset, Power Change
and Power Interval.
The final optional satID can be used to specify which existing satellite is to be replaced by
the newly created duplicate. If this satID is not provided, and there are no free channels,
the command will fail, and produce an error.
Note
Multipath satellites require 60 seconds to be created and are introduced at modulo 30
second intervals. The GSG can only introduce 4 duplicate satellites at a time and at a max-
imum rate of one satellite every two seconds. Multipath, SBAS and interference/jamming
channels cannot be the duplicated. This command is only available when the scenario is run-
ning. Note that excessive changes to Range or Doppler may result in Doppler shifts greater
than the system can handle and cause the satellites to shutdown due to exceeding the
hardware capabilities.
Command Syntax
Parameter
TIME – As TIME argument only IMMediate is supported.
satID – Satellite identifier of the satellite to duplicate
Decimal [-999.999,999.999] – Range offset in meters
Decimal [-99.999,99.999] – Range Change rate in meters/interval
Decimal [0.0,600.0] – Range Interval in seconds
Decimal [-99.9999,99.9999] – Doppler offset in meters
Decimal [-99.9999,99.9999] – Doppler Change rate in meters/sec/interval
Integer [0,600] – Doppler Interval in seconds
Decimal [-30.0,6.0] – Power offset in meters
Decimal [-30.0,0.0] – Power Change rate in dB/interval
Integer [0,600] – Power Interval in seconds
satID – Optional satellite identifier for which satellite that is to be replaced by the duplicate
Examples
SEND:
SOURce:SCENario:DUPlicate IMM,G3,1.0,2.0,3.0,4.0,5.0,6,7.0,-8.0,9,G9
6.3.3.85 SOURce:SCENario:DUPlicate[n]
Function
This command creates a duplicate of the satellite in given channel number (the second
argument) using the provided multipath parameters. The parameters include the Duplicate
Satellite Channel Number, Range Offset, Range Change, Range Interval, Doppler Offset,
Doppler Change, Doppler Interval, Power Offset, Power Change and Power Interval.
When the scenario is running, the optional argument n can be used to specified the target
channel where the duplicate will be placed. If the target channel already contains a satellite,
that satellite is disabled and replaced by the duplicate.
Notes
Multipath satellites require 60 seconds to be created and are introduced at modulo 30
second intervals. The GSG can only introduce 4 duplicate satellites at a time and at a max-
imum rate of one satellite every two seconds. Multipath, SBAS and interference/jamming
channels cannot be the duplicated. Note that excessive changes to Range or Doppler may
result in Doppler shifts greater than the system can handle and cause the satellites to shut-
down due to exceeding the hardware capabilities.
The command can also be used to alter multipath configuration settings before the scen-
ario has started. The argument n is then mandatory and specifies which multipath con-
figuration is changed. For the command to be successful the scenario configuration must
have at least n number of multipath signals defined. Furthermore, the scenario must be
started using the SCPI Scenario:Control Start command for the modification to be
effective, i.e. the altered configuration will not be used if the scenario is started from the
front panel. Note also that the changed configuration will not be saved to the scenario con-
figuration file.
Command Syntax
SOURce:SCENario:DUPlicate[n] <TIME>,<in-
teger-
>,<-
decim-
al>,<-
decim-
al>,<-
decimal>,<decimal>,<decimal>,<integer>,<decimal>,<decimal>,<integer>
Parameter
TIME – As TIME argument only IMMediate is supported.
Integer [1:N] – Satellite index of the satellite to duplicate. Maximum is number of satellites
Decimal [-999.999,999.999] – Range offset in meters
Decimal [-99.99,99.99] – Range Change rate in meters/interval
Decimal [0.0,600.0] – Range Interval in seconds
Decimal [-99.9999,99.9999] – Doppler offset in meters
Decimal [-99.9999,99.9999] – Doppler Change rate in meters/sec/interval
Integer [0,600] – Doppler Interval in seconds
Decimal [-30.0,6.0] – Power offset in meters
Decimal [-30.0,0.0] – Power Change rate in dB/interval
Integer [0,600] – Power Interval in seconds
Example
SEND:
SOURce:SCENario:DUPlicate9 IMM,3,1.0,2.0,0.0,4.0,5.0,6,7.0,-8.0,9
6.3.3.86 SOURce:SCENario:DUPlicate?
Function
The command returns a comma delimited list of the channel numbers which are duplicates
of the satID given.
Command Syntax
SOURce:SCENario:DUPlicate? <satID>
Parameter
satID – For a list of satellite identifiers, see "SOURce:ONECHN:SATid?" on page 252.
Example Running
SEND:
SOURce:SCENario:DUPlicate? G3
READ:
6.3.3.87 SOURce:SCENario:DURATION
Function
Changes the scenario duration before starting the simulation.
Command Syntax
SOURce:SCENario:DURATION [<mode>,][duration]
Parameters
<duration> is specified in seconds.
Notes
This command changes duration of the currently loaded scenario, but does not change the
scenario file, so that when you try to edit the scenario, you will see unchanged parameters
from the file.
Examples
SEND:
SOUR:SCEN:DURATION ONCE,3600
Set scenario duration to 1 hour, executed once.
SOUR:SCEN:DURATION FOREVER
Set scenario duration to forever.
SOUR:SCEN:DURATION 600
Set scenario duration to 10 minutes, executed once.
6.3.3.88 SOURce:SCENario:DURATION?
Function
Inquires the duration of the scenario (<duration> specified in seconds).
Command Syntax
SOURce:SCENario:DURATION?
Return
Returns pair <mode>, <duration>. <mode> can be ONCE/FOREVER/LOOPING.
Example
QUERY:
SOUR:SCEN:DURATION?
RESPONSE:
LOOPING,1800
6.3.3.89 SOURce:SCENario:MULtipath[n]
Function
This command sets the multipath parameters for satellite with a satID. The parameters
include the Range Offset, Range Change, Range Interval, Doppler Offset, Doppler
Change, Doppler Interval, Power Offset, Power Change and Power Interval.
After issuing the command the target satellite becomes a multipath satellite and this is
reflected in the satID as multipath satellites have a trailing character ‘D’ at the end of their
satID.
We can have several multipath satellites with the same satID. In such cases the optional
parameter n can be used to specify that we want to act on the n:th instance of these. If the
n parameter is left out the command acts on the first satellite found with matching satID.
If the satID is left out, the parameter n is mandatory and specifies that the command it to
act on the n:th multipath satellite configured.
Command Syntax
SOURce:SCENario:MULtipath[n] <TIME>,<satID>],
<decimal>,<decimal>,<decimal>,<decimal>,<decimal>,
<integer>,<decimal>,<decimal>,<integer>
Notes
By leaving out the satID the command can be executed before the scenario has star-
ted to alter the scenario configuration. For this to be successful the scenario con-
figuration must have at least n number of multipath signals already defined.
Furthermore the scenario must be started using the SCPI Scenario:Control
Start command for the modification to be effective. Note also that the changed
configuration will not be saved to the scenario configuration file.
This command cannot be used with SBAS and interference/jamming channels.
Excessive changes to Range or Doppler may result in Doppler shifts greater than the
system can handle and the satellites to shutdown.
Parameter
TIME - As TIME argument only IMMediate is supported.
satID – Satellite identifier of the satellite to update
Examples
SEND:
SOURce:SCENario:MULTIPath2
IMM,G9D,1.0,2.0,3,4.0,5.0,6,7.0,-8.0,9
SEND:
SOURce:SCENario:MULTIPath
IMM,G9,1.0,2.0,3,4.0,5.0,6,7.0,-8.0,9
6.3.3.90 SOURce:SCENario:MULtipath[n]?
Function
This command returns the multipath settings for the satellite with given satID. If we have
several multipath satellites with the same satID the optional parameter n can be used to
specify that we are interested in the n:th duplicate of this satellite. If instance n is not spe-
cified it always defaults to the first duplicate found.
If the satID is not specified the n argument is mandatory and the command with return the
multipath settings for the n:th multipath satellite. This command is also available before the
scenario has started to query scenario configuration settings.
In the response, the first parameter will be the satID (when scenario is running) or the satel-
lite index for the satellite that is to be duplicated (when scenario is not running).
Command Syntax
SOURce:SCENario:MULtipath[n]? <satID>]
Parameter
Integer [1:N] – Maximum is number of defined multipath satellite channels
satID – the satellite identifier of the satellite
Example
Before execution:
SEND:
SOURce:SCENario:MULtipath1?
READ:
3,1.0,2.0,3,4.0,5.0,6,7.0,-8.0,9
During execution:
SEND:
SOURce:SCENario:MULtipath? G17
READ:
G17D,1.0,2.0,3,4.0,5.0,6,7.0,-8.0,9
Function
This command deletes the satellite at channel n.
Command Syntax
SOURce:SCENario:DELete[n] <TIME>
Note
Command is allowed only during scenario execution. SBAS and interference channels can-
not be deleted.
Parameter
TIME – As TIME argument only IMMediate is supported.
Example
SEND:
SOURce:SCENario:DELete17 IMM
Function
This command deletes the comma-delimited list of satellites.
Command Syntax
SOURce:SCENario:DELete <TIME>,<satID>[,<satID>] …
Note
Command is allowed only during scenario execution. SBAS and interference channels can-
not be deleted. Only one satellite with the same satID string can be deleted at a time. Satel-
lites which are still valid in the constellation will be restarted 1-2 minutes after deletion.
Parameter
TIME – As TIME argument only IMMediate is supported.
satID – Comma separated list of satellite identifier strings.
Example
SEND:
SOURce:SCENario:DELete IMM,G10,G10D,R9D
Function
This command deletes the satellite specified by the given satID string. The optional n para-
meter allows the n:th duplicate satellite to be deleted rather than the first found.
Command Syntax
SOURce:SCENario:DELete[n] <TIME>,<satID>
Note
Command is allowed only during scenario execution. SBAS and interference/jamming
channels cannot be deleted.
Parameter
TIME – As TIME argument only IMMediate is supported.
satID – Satellite identifier string.
Example
SEND:
SOURce:SCENario:DELete2 IMM,G10D
6.3.3.94 SOURce:SCENario:CLKMDL
Note: This SCPI command is only supported if the Spoofing Range Option is
installed (OPT-SPF license, see "GSG Series Model Variants and Options"
on page 203.)
Function
The Clock Model command is used in the context of simulating the spoofing of mobile
equipment. This command allows to adjust the time- of- transmission in order to com-
pensate for time-of-flight. Information on the Query Clock Model command can be found
under "SOURce:SCENario:CLKMDL?" on the next page.
Command Syntax
SOURce:SCENario:CLKMDL <decimal>,<decimal>,<decimal>,<decimal>
Parameters
The Clock Model is described by the following parameters:
t0 s >0 Scenario elapsed time when parameters a0, a1 and a2 were measured.
When t0 is set, its value must be within ±10 seconds compared to the
current elapsed scenario time.
Note
SOURce:CLKMDL commands are accepted only while a scenario is running.
Example
SOUR:SCEN:CLKMDL 10.000000,2000.000000,-10.000000,0.000000
6.3.3.95 SOURce:SCENario:CLKMDL?
Note: This SCPI command is only supported if the Spoofing Range Option is
installed (OPT-SPF license, see "GSG Series Model Variants and Options"
on page 203.)
Function
The Clock Model command is used in the context of simulating the spoofing of mobile
equipment.
This command is used to query the Clock Model state and its parameters t, bias, t0 , a0 , a1,
and a2. See also: "SOURce:SCENario:CLKMDL" on the previous page.
Command Syntax
SOURce:SCENario:CLKMDL?
Return
t: scenario elapsed time in seconds when the query was handled (and when the bias
was calculated).
bias: clock bias at time t.
t0 , a0 , a1, a2: the current clock model parameters
Example
SOURce:SCENario:clkmdl?
Return Format
2.010000E+01,1.899000E+03,1.000000E+01,2.000000E+03,-
1.000000E+01,0.000000E+00
6.3.3.96 SOURce:FILe:TYPe
Function
This commands are used to transfer a file to the unit. The order of commands is fixed:
Type, name, length checksum and data.
SOURce:FILe:TYPe sets the type of the file transferred.
Valid files types are:
CALibration
FIRMware
SCENario
TRAJectory
RSGTRAJectory
EPHemeris
ALManac
EVEnt
ENVironmentmodel
ANTenna
Command Syntax
Note
Command not allowed during scenario execution, and will result in the error code “-
190,"Execution in progress"”.
6.3.3.97 SOURce:FILe:NAMe
Function
This command sends the file name to be used to store the file to the unit. The name shall
only contain alphanumeric characters.
Command Syntax
SOURce:FILe:NAMe
Note
Command not allowed during scenario execution, and will result in the error code “-
190,"Execution in progress"”.
6.3.3.98 SOURce:FILe:LENgth
Function
This command sends the file length to the unit.
Command Syntax
SOURce:FILe:LENgth
Note
This command not allowed during scenario execution, and will result in the error code “-
190,"Execution in progress"”.
6.3.3.99 SOURce:FILe:CHECKsum
Function
This command sends the file checksum to the unit. A simple arithmetic checksum is cal-
culated by adding the characters in the file as binary unsigned 8-bit integers. The resulting
sum is then negated.
Command Syntax
SOURce:FILe:LENgth
Note
This command not allowed during scenario execution, and will result in the error code “-
190,"Execution in progress"”.
The checksum is calculated using the following algorithm, presented here in a Python lan-
guage example. The array s passed in must be read from a file opened with attributes read
and binary (rb).
def cksum(s):
sum = 0
for c in s:
sum += ord(c)
sum &= 255
sum = -sum
return sum
An example in C is shown below. Again, the char *Data array is read from a file and is a bin-
ary array of unsigned 8-bit char values.
6.3.3.100 SOURce:FILe:DATA
Function
This command sends the file data to the unit. The file being transferred is divided into mul-
tiple data commands. There can be as many data commands as needed to send the whole
file. The maximum data in one command is 4000 bytes. At the start of each data block
there is a header #800001234 which tells that 8 following digits gives the length of block.
Command Syntax
SOURce:FILe:DATA
Notes
The example below depicts the transfer of a file. The first DATA command depicts the
transfer. The checksum shown cannot be recreated from the file data because the end of
Example
Sending a scenario file to the unit:
SEND:
SOURce:FILe:TYPe SCEN
SEND:
SOURce:FILe:NAMe scen02
SEND:
SOURce:FILe:LENgth 335
SEND:
SOURce:FILe:CHECKsum 234
SEND:
6.3.3.101 SOURce:KEYLOCK:PASSWord
Function
Changes the password of the front panel lock. The password has to contain only numerical
characters and has to be 4-8 digits in length to be valid.
Command Syntax
SOURce:KEYLOCK:PASSWord <password>
Parameter
4-8 numerical characters.
Example
SEND:
SOURce:KEYLOCK:PASSWord 123456
6.3.3.102 SOURce:KEYLOCK:PASSWord?
Function
Queries the current password used in front panel lock.
Command Syntax
SOURce:KEYLOCK:PASSWord?
Example
SEND:
SOURce:KEYLOCK:PASSWord?
READ:
123456
6.3.3.103 SOURce:KEYLOCK:STATus
Function
Sets the state of the front panel lock.
Command Syntax
SOURce:KEYLOCK:STATus <ON|OFF>
Parameter
enum = {ON, OFF}
Example
SEND:
SOURce:KEYLOCK:STATus ON
6.3.3.104 SOURce:KEYLOCK:STATus?
Function
Queries the state of the front panel lock.
Command Syntax
SOURce:KEYLOCK:STATus?
Example
SEND:
SOURce:KEYLOCK:STATus?
READ:
ON
6.3.4.1 MMEMory:CATalog?
Function
This command lists the content of directory <dirname>, or the current directory if the para-
meter is omitted.
The response contains first used bytes then free bytes on device and then list of the files in
format <name>,<type>,<size>.
Command Syntax
MMEMory:CATalog? <dirname>
Example
SEND:
MMEMory:CATalog? events
READ:
3145728,72351744,AGPS1e,ASCII,208,AGPS2e,ASCII,110,AGPS3e,
ASCII,208,EventAGPS1,ASCII,59,EventAGPS2,ASCII,29,EventAGPS3,
ASCII,29,EventAGPS4,ASCII,180,EventAGPS5,ASCII,250,EventAGPS6,
ASCII,29,event0,ASCII,146,event007,ASCII,146,event01,ASCII,
1,eventAGPS1,ASCII,61,eventAGPS2,ASCII,30,eventAGPS3,ASCII,
30,eventAGPS4,ASCII,186,eventAGPS5,ASCII,256,eventAGPS6,
ASCII,30,events1,ASCII,874,events2,ASCII,384,events3, ASCII,122
6.3.4.2 MMEMory:CDIRectory
Function
Change current directory on the device. The <dirname> must be/start with nav-
igationData, events, trajectories or scenarios.
Command Syntax
MMEMory:CDIRectory <dirname>
Example
SEND:
MMEMory:CDIRectory scenarios
6.3.4.3 MMEMory:CDIRectory?
Function
Get current directory on the device.
Command Syntax
MMEMory:CDIRectory?
Example
SEND:
MMEMory:CDIRectory?
READ:
events
6.3.4.4 MMEMory:DATA?
Function
Get contents of file. At the start of the response is the header e.g., #800001234, con-
taining the information about the length of the file. The first digit after “#” symbol tells how
many next symbols are used to encode the file size. So, in the example above, 8 digits are
used to encode the file size, which is 1234 bytes. The file data follow immediately after the
header.
Command Syntax
MMEMory:DATA? <filename>
Example
SEND:
MMEMory:CDIRectory scenarios
SEND:
MMEMory:DATA? Scen02
READ:
UserTrajectory Circle
TrajectoryParameters 400 10 -1
AntennaModel Zero model
IonoModel 1
TropoModel Saastamoinen
Temperature 15
Pressure 1100
Humidity 50
MinElev 0
NrSBASChannels 2
6.3.4.5 MMEMory:DELete
Function
Delete a file in device. If <dirname> is omitted, file is assumed to be in current directory oth-
erwise the file is deleted from <dirname>.
Command Syntax
MMEMory:DELete <filename>[,<dirname>]
Example
SEND:
MMEMory:DELete scen02,scenarios
6.3.4.6 MMEMory:COPY
Function
Copy a file in current directory or directory <srcdir>. Note that copying between dir-
ectories is forbidden, so <srcdir> must be equal to <dstdir>.
Command Syntax
MMEMory:COPY <srcfile>[,<srcdir>],<dstfile>[,<dstdir>]
Example
SEND:
MMEMory:COPY scen02,scenarios,scen02_copy,scenarios
6.3.4.7 MMEMory:MOVE
Function
Move a file in current directory or directory <srcdir>. Note that moving between dir-
ectories is forbidden, so <srcdir> must be equal to <dstdir>.
Command Syntax
MMEMory:MOVE <srcfile>[,<srcdir>],<dstfile>[,<dstdir>]
Example
SEND:
MMEMory:MOVE scen02,scenarios,scen022,scenarios
6.3.5.1 NETwork:MACaddress?
Function
Reads out the Ethernet Network Port’s MAC Address. If none is found, an error is returned.
Command Syntax
NETwork:MACaddress?
Returned Format
<String>
Example
SEND:
NETwork:MACaddress?
00:1A:F1:01:68:2D
6.3.6.1 STATus:OPERation:CONDition?
Function
Reads out the contents of the operation status condition register. This register reflects the
state of the GSG operation.
Command Syntax
STATus:OPERation:CONDition?
Returned Format
<Decimal data> = the sum (between 0 and 97) of all bits that are true. See table below:
Bit Weight Condition
0 1 Calibrating
6.3.6.2 STATus:OPERation:ENABle
Function
Enables operation status reporting by setting the enable bits of the Operation Status
Enable register.
This register contains a mask value for the bits to be enabled in the Operation Status Event
register. A bit that is set True in the enable register enables the corresponding bit in the
status register.
An enabled bit will set bit #7, OPR (Operation Status Bit), in the Status Byte Register if the
enabled event occurs.
Command Syntax
STATus:OPERation:ENABle <Decimal data>
Parameters
<decimal data> = the sum (between 0 and 96) of all bits that are true. See table below:
Returned Format
<Decimal data>
Example
SEND:
STAT:OPER:ENAB 32
In this example, waiting for triggering, bit 5, will set the OPR-bit of the Status Byte.
6.3.6.3 STATus:OPERation[:EVENt]?
Function
Read out the contents of the Operation Event Status register. Reading the Operation
Event Register clears the register.
Command Syntax
STATus:OPERation[:event]?
Returned Format
<Decimal data> = the sum (between 0 and 97) of all bits that are true.
6.3.6.4 STATus:QUEStionable:CONDition?
Function
Read out the contents of the Status Questionable Data/Signal Condition register.
Command Syntax
STATus:QUEStionable:CONDition?
Returned Format
<decimal data> = the sum (between 0 and 16384) of all bits that are true. See table below:
6.3.6.5 STATus:QUEStionable:ENABle
Function
Enable the Questionable Data/Signal Status Reporting by setting the enable bits of the
status questionable enable register.
This enable register contains a mask value for the bits to be enabled in the status ques-
tionable event register. A bit that is set true in the enable register enables the cor-
responding bit in the status register. An enabled bit will set bit #3, QUE (Questionable
Status Bit), in the Status Byte Register if the enabled event occurs.
Command Syntax
Parameters
<decimal_data> = the sum (between 0 and 16384) of all bits that are true. See the table
on previous chapter.
Returned format
<Decimal data>
Example
SEND:
STAT:QUES:ENAB 16384
In this example ‘unexpected parameter’ bit 14 will set the QUE-bit of the Status Byte when
a questionable status occurs.
6.3.6.6 STATus:QUEStionable[:EVENt]?
Function
Reads out the contents of the Questionable Data/Signal Event Register. Reading this
register clears it.
Command Syntax
STATus:QUEStionable[:EVENt]?
Returned Format
<decimal data> = the sum (between 0 and 16384) of all bits that are true. See the table for
STATus:QUEStionable:CONDition
6.3.6.7 STATus:PRESet
Function
Enables Device Status Reporting. This command has an SCPI standardized effect on the
status data structures. The purpose is to precondition these toward reporting only device-
dependent status data.
It only affects enable registers. It does not change event and condition registers.
The IEEE-488.2 enable registers, which are handled with the common commands
*SRE and *ESE remain unchanged.
The command sets or clears all other enable registers. Those relevant for this device
are as follows:
It sets all bits of the Device status Enable Registers to 1.
It sets all bits of the Questionable Data Status Enable Registers and the Operation
Status Enable Registers to 0.
The following registers never change in the GSG-5x, but they do conform to the
standard :STATus:PRESet values.
All bits in the positive transition filters of Questionable Data and Operation status
registers are 1.
All bits in the negative transition filters of Questionable Data and Operation status
registers are 0.
Command Syntax
STATus:PRESet
forward/backward
left/right
up/down , as well as the rotations around the three perpendicular axes:
pitch
yaw
roll.
All sensors are initially mounted so that at start of the simulation the sensor’s coordinate sys-
tem XYZ is aligned with the user's ENU system (East, North, Up).
The X axis has a positive direction towards the right side of the sensor.
The Y axis has a positive direction towards the front of the sensor.
The Z axis has a positive direction towards the top of the sensor.
At the start of a scenario, the X axis corresponds to the east/west axes of the ENU system
while the front of the sensor—positive direction on the Y axis—is pointing to the north.
Accelerometer ACCelerometer
Linear Accelerometer LINearaccelerometer
Gravimeter GRAvimeter
Gyroscope GYRoscope
Odometer ODOmeter
3D Odometer ODOMETER3D, ODO3D
6.4.1.1 Accelerometer
The accelerometer outputs acceleration in the XYZ axis. The typical case where the device
is flat relative to the surface of the Earth appears as -STANDARD_GRAVITY in the Z axis,
and X and Y values as zero.
Sensor data
values[0] – Acceleration along the x-axis, in g
values[1] – Acceleration along the y-axis, in g
values[2] – Acceleration along the z-axis, in g
6.4.1.3 Gravimeter
The gravimeter outputs the gravity force against the XYZ axis. In all other aspects it is like
the accelerometer above.
6.4.1.4 Gyroscope
The gyroscope sensor measures the rate of rotation around the X, Y and Z axis. Unlike the
accelerometer, the gyro is not affected by gravity. The coordinate system is the same as is
used for the acceleration sensor. Rotation is positive in the counter-clockwise direction for
pitch and roll (not yaw). That is, an observer looking from some positive location on the x, y.
or z axis at a device positioned on the origin would report positive rotation if the device
appeared to be rotating counter clockwise.
Sensor data
values[0] – Angular speed around the x-axis, in radians/second
values[1] – Angular speed around the y-axis, in radians/second
6.4.1.5 Odometer
The odometer sensor keeps track of the total traveled distance.
Sensor data
values[0] – Traveled distance in meters
6.4.1.6 Odometer 3D
The 3D odometer sensor keeps track of the total traveled distance in a 3D ENU vector
form.
Sensor data
values[0] – Traveled distance along the x-axis, in meters
values[1] – Traveled distance along the y-axis, in meters
values[2] – Traveled distance along the z-axis, in meters
6.4.2.1 SOURce:SCENario:SENSor:REGister
Function
This command registers a sensor of a given type. Once registered, the output from all
registered sensors can be retrieved using the SOURce:SCENario:SENSor:DATa? com-
mand.
Only one sensor of each type can be registered.
Command Syntax
SOURce:SCENario:SENSor:REGister <SENSORTYPE>
6.4.2.2 SOURce:SCENario:SENSor:REGister?
Function
Queries if a given sensor is registered.
Command Syntax
SOURce:SCENario:SENSor:REGister? <SENSORTYPE>
6.4.2.3 SOURce:SCENario:SENSor:UNREGister
Function
This command unregisters a sensor of a given type, after which the sensor data is no longer
output.
Command Syntax
SOURce:SCENario:SENSor:UNREGister <SENSORTYPE>
6.4.2.4 SOURce:SCENario:SENSor:DATa?
Function
The command queries for the output of all registered sensors of a running scenario. The
data is updated at a 10Hz rate.
Command Syntax
SOURce:SCENario:SENSor:DATa?
Function
The command specified that the output of a given sensor should be normalized. This is not
applicable to all types of sensors and before the max range is set (see below) the command
has no effect. The default setting is OFF.
Command Syntax
Function
Queries if a sensor of a given type is normalized or not.
Command Syntax
SOURce:SCENario:SENSor:NORMalize? SENSOR_TYPE
Function
The command specified the max range of a sensor. The minrange equals –maxrange.
Command Syntax
Function
The command returns the max range for a specified sensor.
Command Syntax
SOURce:SCENario:SENSor:MAXrange? SENSOR_TYPE
Coordinate Systems
Geodetic (Cartesian)
Earth Centered Earth Fixed (ECEF)
Earth Model
WGS-84
Timestamp
Time into scenario is given in second and 100 millisecond accuracy.
Field Type Default Units
6.5.3.1 SOURce:SCENario:POSition
Function
Set latitude, longitude and altitude for the geodetic position (WGS84) as the start position
for the loaded scenario, or the current position if the scenario is running.
Latitude and longitude are defined using decimal degrees. The altitude is given in meters
as altitude over an ellipsoid.
For latitude and longitude, the recommended decimal accuracy is 8 digits, with 6 digits
being the minimum recommended accuracy. No benefit is achieved at accuracies greater
than 10 digits for latitude or longitude.
The altitude can be specified to a resolution down to two digits or centimeter level. No
benefit is achieved with altitude accuracies greater than 4 decimal digits.
Command Syntax
SOURce:SCENario:POSition TIME,<decimal>,<decimal>,<decimal>
Parameter
TIME must be IMMediate.
Decimal Latitude [-89.99999999, +89.99999999] degrees North
Decimal Longitude [-360.00000000, +360.00000000] degrees East
Decimal Altitude [-1000.00, +20,200,000.00] meters
Notes
If a scenario is armed but not running yet, an error is returned.
The maximum altitude for normal operation is 18470 meters. (With Extended Limits it is
20,200 km).
This command changes position of the currently loaded scenario, but does not change the
scenario file, so that when you try to edit the scenario, you will see unchanged parameters
from the file.
Example
SEND:
SOURce:SCENario:POSition IMM,-77.58895432,43.08332157,168.58
6.5.3.2 SOURce:SCENario:POSition?
Function
Queries the current geodetic position in Latitude, Longitude and Altitude. A time stamp of
the time into the scenario is also returned.
As an optional argument one can specify the antenna position, as an effect of a specified
lever arm, or the body center position. If the argument is not given, the body center pos-
ition will be returned.
Command Syntax
SOURce:SCENario:POSition? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:POSition?
READ:
123.4,-77.58895432,43.08332157,168.58
Function
Sets the ECEF position in X, Y and Z coordinates. The X, Y, and Z position is given in
decimal meters. The decimal accuracy of ECEF is recommended as 2 decimal digits. No
benefit is achieved for ECEF positions at accuracies greater than 4 digits.
Command Syntax
SOURce:SCENario:ECEFPOSition TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal X Position [-26 500 000.00, +26 500 000.00] meters
Decimal Y Position [-26 500 000.00, +26 500 000.00] meters
Decimal Z Position [-26 500 000.00, +26 500 000.00] meters
Note
The maximum altitude for normal operation is 18470 meters. (The altitude for Extended
Limits is 20200 km.)
Example
SEND:
6.5.3.4 SOURce:SCENario:ECEFPOSition?
Function
Queries the current ECEF position in X, Y and Z coordinates.
As an optional argument, the antenna position can be specified, as an effect of a specified
lever arm, or the body center position. If the argument is not given, the body center pos-
ition will be returned.
Command Syntax
SOURce:SCENario:ECEFPOSition? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ECEFPOSition?
READ:
Function
Sets the vehicle’s speed over ground (WGS84 ellipsoid).
Command Syntax
SOURce:SCENario:SPEed TIME,<decimal>
Parameter
Decimal 1D Speed [0.00 to +20000.00] m/s
Note
The maximum allowed speed for normal operation is 520 m/s. If you want to reverse dir-
ection, change heading or use the velocity command. (For Extended Limits it is limited by
interface above.)
Example
SEND:
SOURce:SCENario:SPEed 123.4,30.10
6.5.3.6 SOURce:SCENario:SPEed?
Function
Query the current speed expressed in m/s.
Command Syntax
SOURce:SCENario:SPEed? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:SPEed?
READ:
123.4,30.10
Function
Sets the vehicle’s true heading. The heading is expressed in clockwise direction from the
true north (WGS84 ellipsoid) representing 0 degrees, increasing to 359.999 degrees.
Command Syntax
SOURce:SCENario:HEADing TIME,<decimal>
Parameter
Decimal Heading [0, 359.999] true heading in decimal degrees
Example
SEND:
6.5.3.8 SOURce:SCENario:HEADing?
Function
Returns the vehicle’s true heading expressed as described above.
Command Syntax
SOURce:SCENario:HEADing? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:HEADing?
READ:
123.4, 90.000
Function
Sets the heading change rate. Rate is expressed as degrees per second. Heading will be
updated each epoch according to the specified constant rate. Next position is calculated
using direct rhumb line method (movement with constant heading). Pay attention that spe-
cifying constant heading rate results in non-constant curvature radius, thus it is not suitable
for creation of closed-circle trajectories.
Command Syntax
SOURce:SCENario:RATEHEading TIME,<decimal>
Parameter
Decimal RateHeading [-180.000, 180.000] true heading change in decimal degrees per
second. Positive value correspond to right turn, negative – left turn.
Example
SEND:
SOURce:SCENario:RATEHEading 123.4,5.500
6.5.3.10 SOURce:SCENario:RATEHEading?
Function
Returns the vehicle’s heading rate, which was previously set using the command described
above.
Command Syntax/Example
SEND:
SOURce:SCENario:RATEHEading?
READ:
123.4, 5.500
Function
Sets the rate of turning. Rate is expressed as degrees per second. Next position is cal-
culated using direct orthodromic method (moving along shortest path with non-constant
heading). Use this command to simulate movement along arc of circle or closed circle tra-
jectory with constant velocity. Heading rate is varying each epoch, but overall average rate
along single full closed circle will be equal to the value specified.
Command Syntax
SOURce:SCENario:TURNRATE TIME,<decimal>
Parameter
Decimal TurnRate [-180.000, 180.000] desired average heading rate (over single full
closed circle) in decimal degrees per second. Positive value correspond to right turn, neg-
ative – left turn.
Example
SEND:
6.5.3.12 SOURce:SCENario:TURNRATE?
Function
Returns the vehicle’s rate of turning, which was previously set using the command
described above.
Command Syntax/Example
SEND:
SOURce:SCENario:TURNRATE?
READ:
123.4, 5.500
Function
Sets the radius of turning. Radius is expressed in meters. The next position is calculated
using direct orthodromic method (moving along shortest path with non-constant heading).
Use this command to simulate movement along arc of circle regardless of velocity changes.
Heading rate is varying each epoch, but radius of turning will be constantly equal to value
specified.
Command Syntax
SOURce:SCENario:TURNRADIUS TIME,<decimal>
Parameter
Decimal TurnRadius [-5 000 000.000, 5 000 000.000] radius of turning in meters. Pos-
itive value correspond to right turn, negative – left turn.
Example
SEND:
6.5.3.14 SOURce:SCENario:TURNRADIUS?
Function
Return the vehicle’s radius of turning previously set using command described above.
Command Syntax/Example
SEND:
SOURce:SCENario:TURNRATE?
READ:
123.4, 500.0
Function
Sets the vehicle’s speed over ground (WGS84 ellipsoid) and heading in degrees.
Command Syntax
SOURce:SCENario:VELocity TIME,<decimal>,<decimal>
Parameter
Decimal 1D Speed [0.000 to +20000.000] m/s
Decimal Bearing [0, 359.999] true bearing in decimal degrees
Note
The maximum allowed speed for normal operation is 520 m/s. (For Extended Limits it is
limited by interface above.)
Example
SEND:
6.5.3.16 SOURce:SCENario:VELocity?
Function
Queries the vehicle’s velocity.
Command Syntax
SOURce:SCENario:VELocity?
Example
SEND:
SOURce:SCENario:VELocity?
READ:
123.4,27.25,210.800
Function
Sets the vehicle’s vertical speed.
Command Syntax
SOURce:SCENario:VSPEed TIME,<decimal>
Parameter
Decimal 1D Speed [-20000.00 to +20000.00] m/s
Note
The maximum allowed speed for normal operation is 520 m/s. (For Extended Limits it is
limited by interface above.)
Example
SEND:
SOURce:SCENario:VSPEed 123.4,3.15
6.5.3.18 SOURce:SCENario:VSPEed?
Function
Get the vehicle’s vertical speed.
Command Syntax
SOURce:SCENario:VSPEed? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:VSPEed?
READ:
123.4,3.15
Function
Sets the velocity expressed in ENU coordinates when scenario is running. The Velocity
terms are defined in m/s.
Command Syntax
SOURce:SCENario:ENUVELocity TIME,<decimal>,<decimal>,<decimal>
Note
The local plane of the coordinates will always be re-aligned with ellipsoid surface, meaning
the Up-Down velocity can be seen as a velocity with respect to ellipsoid (and not the local
plane formed by the position the user was at TIME).
Parameter
Decimal Velocity East [-20000.00, +20000.00] m/s
Decimal Velocity North [-20000.00, +20000.00] m/s
Decimal Velocity Up [-20000.00, +20000.00] m/s
Note
The maximum allowed speed for normal operation is 520 m/s. (For Extended Limits it is
limited by interface above.)
Example
SEND:
SOURce:SCENario:ENUVELocity 123.4,-4.00,3.00,0.00
6.5.3.20 SOURce:SCENario:ENUVELocity?
Function
Queries the current velocity during scenario execution, expressed as ENU coordinates.
Command Syntax
SOURce:SCENario:ENUVELocity? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ENUVELocity?
READ:
123.4,-4.00,3.00,0.00
6.5.3.21 SOURce:SCENario:ECEFVELocity
Function
Sets the current ECEF velocity in X, Y and Z coordinates when the scenario is running. The
Velocity terms are defined in m/s.
Command Syntax
SOURce:SCENario:ECEFVELocity TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal Velocity X [-20000.00, +20000.00] m/s
Decimal Velocity Y [-20000.00, +20000.00] m/s
Decimal Velocity Z [-20000.00, +20000.00] m/s
Note
The maximum allowed speed for normal operation is 520 m/s. (Velocity for Extended Lim-
its is not limited.)
Example
SEND:
SOURce:SCENario:ECEFVELocity 123.4,-4.00,3.00,1.00
6.5.3.22 SOURce:SCENario:ECEFVELocity?
Function
Queries the current ECEF velocity in 3 dimensions as X, Y and Z coordinates during scen-
ario execution.
Command Syntax
SOURce:SCENario:ECEFVELocity? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ECEFVELocity?
READ:
123.4,-4.00,3.00,1.00
Function
Sets the 1D acceleration expressed in m/s2 when scenario is running.
Command Syntax
SOURce:SCENario:ACCeleration TIME,<decimal>
Parameter
Decimal 1D Acceleration [-981 to +981] m/s2, equivalent to [-100G to +100G]
Example
SEND:
SOURce:SCENario:ACCeleration 123.4,0.50
6.5.3.24 SOURce:SCENario:ACCeleration?
Function
Queries the 1D acceleration.
Command Syntax
SOURce:SCENario:ACCeleration? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ACCeleration?
READ:
123.4,0.50
Function
Sets the vehicle’s vertical acceleration.
Command Syntax
SOURce:SCENario:VACCel TIME,<decimal>
Parameter
Decimal 1D Acceleration [-981 to +981] m/s2, equivalent to [-100G to +100G]
Example
SEND:
SOURce:SCENario:VACCel 123.4,0.50
6.5.3.26 SOURce:SCENario:VACCel?
Function
Query the vehicle’s vertical acceleration.
Command Syntax
SOURce:SCENario:VACCel? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:VACCel?
READ:
123.4,0.50
Function
Sets the acceleration expressed in ENU coordinates when scenario is running. The accel-
eration terms are defined in m/s2.
Command Syntax
SOURce:SCENario:ENUACCel TIME,<decimal>,<decimal>,<decimal>
Note
The local plane of the coordinates will always be re-aligned with ellipsoid surface, meaning
the Up-Down velocity can be seen as a velocity with respect to ellipsoid (and not the local
plane formed by the position the user was at TIME).
Parameter
Decimal Acceleration East [-981, +981] m/s2, equivalent to [-100G to +100G]
Example
SEND:
SOURce:SCENario:ENUACCel 123.4,-2.83,2.83,0.00
6.5.3.28 SOURce:SCENario:ENUACCel?
Function
Queries the current acceleration expressed as ENU coordinates during scenario execution.
Command Syntax
SOURce:SCENario:ENUACCel? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ENUACCel?
READ:
123.4,-2.83,2.83,0.00
Function
Sets the ECEF acceleration in 3-dimensions as Acceleration X, Y, and Z when scenario is
running. The Acceleration terms are defined in m/s2.
Command Syntax
SOURce:SCENario:ECEFACCel TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal Acceleration X [-981, +981] m/s2, equivalent to [-100G to +100G]
Example
SEND:
SOURce:SCENario:EACCel 123.4,-2.83,2.83,1.00
6.5.3.30 SOURce:SCENario:ECEFACCel?
Function
Queries the current ECEF acceleration in 3-dimensions as Acceleration X, Y, Z during scen-
ario execution.
Command Syntax
SOURce:SCENario:ECEFACCel? [<ANTenna|BODYcenter>]
Example
SEND:
SOURce:SCENario:ECEFACCeleration?
READ:
123.4,-2.83,2.83,1.00
Function
Sets the Vehicle Attitude in 3-dimensions about the center of mass as Pitch, Roll, and Yaw
when scenario is running. The terms are defined in Radians.
The pitch argument will be positive when pitching from forward to up. The roll argument is
positive when rotating from up to right. The yaw argument is positive when rotating from
forward to right. The angles are applied in the order of pitch, roll and finally yaw. The user
cannot impact this order by applying the pitch, roll, and yaw as separate calls.
Command Syntax
SOURce:SCENario:PRYattitude TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal Pitch [-π, +π] Radians
Decimal Roll [-π, +π] Radians
Decimal Yaw [-π, +π] Radians
Example
SEND:
SOURce:SCENario:PRYattitude -2.0000,2.0000,1.0000
6.5.3.32 SOURce:SCENario:PRYattitude?
Function
Query the current Vehicle Attitude in 3-dimensions about the center of mass as Pitch, Roll,
and Yaw during scenario execution.
Command Syntax/Example
SEND:
SOURce:SCENario:PRYattitude?
READ:
123.4,-2.0000,2.0000,1.0000
Function
Sets the Vehicle Attitude in 3-dimensions about the center of mass as Pitch, Roll, and Yaw
when scenario is running. The terms are defined in Degrees.
The pitch argument will be positive when pitching from forward to up. The roll argument is
positive when rotating from up to right. The yaw argument is positive when rotating from
forward to right. The angles are applied in the order of pitch, roll, and finally yaw. The user
cannot impact this order by applying the pitch, roll, and yaw as separate calls.
Command Syntax
SOURce:SCENario:DPRYattitude TIME,
<decimal>,<decimal>,<decimal>
Parameter
Decimal Pitch [-180, +180] Degrees
Decimal Roll [-180, +180] Degrees
Example
SEND:
SOURce:SCENario:DPRYattitude -2.0000,2.0000,1.0000
6.5.3.34 SOURce:SCENario:DPRYattitude?
Function
Queries the current Vehicle Attitude in 3-dimensions about the center of mass as Pitch,
Roll, and Yaw during scenario execution. Returned values are defined in Degrees.
Command Syntax
SOURce:SCENario:DPRYattitude?
Example
SEND:
SOURce:SCENario: DPRYattitude?
READ:
123.4,-2.0000,2.0000,1.0000
Function
Sets the rate of change in Vehicle Attitude in 3-dimensions about the center of mass as
Pitch Rate, Roll Rate, and Yaw Rate when scenario is running. The Rate of Attitude change
terms are defined in Radians per second.
When the PRY rate is active the changes will be applied in the order of pitch, roll, and yaw.
Note that this order matters and can’t be controlled by user, but angle arguments will have
to adapt to this order.
Command Syntax
SOURce:SCENario:PRYRate TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal Pitch Rate [-π, +π] Radians per second
Decimal Roll Rate [-π, +π] Radians per second
Decimal Yaw Rate [-π, +π] Radians per second
Example
SEND:
SOURce:SCENario:PRYRate 123.4,-2.0000,2.0000,1.0000
6.5.3.36 SOURce:SCENario:PRYRate?
Function
Queries the current rate of change in Vehicle Attitude in 3-dimensions about the center of
mass as Pitch, Roll, and Yaw during scenario execution.
Command Syntax/Example
SEND:
SOURce:SCENario:PRYRate?
READ:
123.4,-2.0000,2.0000,1.0000
Functions
Sets the rate of change in Vehicle Attitude in 3-dimensions about the center of mass as
Pitch Rate, Roll Rate, and Yaw Rate when scenario is running. The Rate of Attitude change
terms are defined in Degrees per second.
When the PRY rate is active the changes will be applied in the order of pitch, roll, and yaw.
Note that this order matters and can’t be controlled by user, but angle arguments will have
to adapt to this order.
Command Syntax
SOURce:SCENario:DPRYRate TIME,<decimal>,<decimal>,<decimal>
Parameter
Decimal Pitch Rate [-3600, +3600] Degrees per second
Decimal Roll Rate [-3600, +3600] Degrees per second
Decimal Yaw Rate [-3600, +3600] Degrees per second
Example
SEND:
SOURce:SCENario:DPRYRate 123.4,-2.0000,2.0000,1.0000
6.5.3.38 SOURce:SCENario:DPRYRate?
Function
Queries the current rate of change in Vehicle Attitude in 3-dimensions about the center of
mass as Pitch, Roll, and Yaw during scenario execution. Returned values are defined in
Degrees per second.
Command Syntax/Example
SEND:
SOURce:SCENario:DPRYRate?
READ:
123.4,-2.0000,2.0000,1.0000
Function
Sets the Kepler orbit parameters.
If a position, speed or acceleration command is sent after the Kepler orbit command, they
will overwrite the movements along the Kepler orbit. PRY commands can be applied while
the Kepler orbit is active.
Command Syntax
SOURce:SCENario:KEPLER TIME,<-
decimal>,<decimal>,<decimal>,<decimal>,<decimal>,<decimal>
Parameter
Decimal Mean anomaly [–π ] Radians
Decimal Eccentrity
Decimal Semi-major axis
Decimal Ascension of ascending node [-π, +π] Radians
Decimal Inclination [-π, +π] Radians
Decimal Argument of perigee [-π, +π] Radians
Example
SEND:
SOURce:SCENario:KEPLER 0,1.30280292873,0.995806301944E-
03,0.075377837181E+08,-
0.159728922636E+01,0.957334107483E+00,0.296123313943E+01
6.5.3.40 SOURce:SCENario:KEPLER?
Function
Queries the Kepler orbit parameters in the same order as set and the current true anomaly.
If Kepler orbit is not in use, the return value is an empty string.
Command Syntax/Example
SEND:
SOURce:SCENario:KEPLER?
READ:
1618.6,1.302803E+00,3.130653E+00,9.958063E-04,7.537784E+06,-
1.597289E+00,9.573341E-01,2.961233E+00
6.5.3.41 SOURce:SCENario:RSGUNDERflow
Function
Enables or disable RSG underflow detection. It is active once an RSG command comes in.
Underflow detection is disabled by default.
Command Syntax
SOURce:SCENario:RSGUNDERflow <integer>
Parameter
Integer – Enable or disable {1,0}, respectively.
Example
SEND:
SOURce:SCENario:RSGUNDERflow 1
6.5.3.42 SOURce:SCENario:RSGUNDERflow?
Function
Queries RSG underflow detection status, whether enabled or disabled.
Command Syntax/Example
SEND:
SOURce:SCENario:RSGUNDERflow?
READ:
6.5.3.43 SOURce:SCENario:DOPPler?
Function
Queries a satellite’s Doppler for a specific signal supported by that satellite. The signals sup-
ported vary based on the constellation and scenario configuration.
Command Syntax
SOURce:SCENario:DOPPler? <satID>,<sigtype>
Notes
If no scenario is running, an error is returned.
If the satellite does not support the signal type, an error is returned.
Parameters
satID – GPS, Glonass, Galileo, BeiDou, QZSS, IRNSS and SBAS are supported. For more
information on the format, see "SOURce:ONECHN:SATid?" on page 252.
sigtype – One of the signal types supported by the satellite, allowed values are:
For GPS: L1CA, GPSL1CA, L1P, GPSL1P, L1PY, GPSL1PY, L1CAP, GPSL1CAP,
L1CAPY, GPSL1CAPY, L2P, GPSL2P, L2PY, GPSL2PY, L2C, GPSL2C, L5, GPSL5
Note that the signal types from the same group below share the same navigation bit
stream.
L1CA, GPSL1CA, L1P, GPSL1P, L1PY, GPSL1PY, L1CAP, GPSL1CAP,
L2P, GPSL2P, L2PY, GPSL2PY
L2C, GPSL2C
L5, GPSL5
For Glonass: GLOL1 (or L1), GLOL2 (or L2)
For Galileo: E1, E5a, E5b
For Beidou: BDSB1 (or B1), BDSB2 (or B2)
For QZSS: QZSSL1CA (or L1, or L1CA), L1SAIF (or L1SBAS), QZSSL2C (or
L2C), QZSSL5 (or L5)
For IRNSS: IRNSSL5 (or L5)
For SBAS: L1SBAS or SBASL1 and L5SBAS and SBASL5
Example
SEND:
SOURce:SCENario:DOPPler? G27,L1CAP
READ:
-320.51
6.5.3.44 SOURce:SCENario:PRANge?
Function
Queries a satellite’s range for a specific frequency band supported by that satellite for the
simulated user position or optionally an RTK base station position. The signals supported
vary based on the constellation and scenario configuration.
Command Syntax
SOURce:SCENario:PRANge? <satID>,<sigtype>,<location>
Notes
If no scenario is running, an error is returned.
If the satellite does not support the signal type, an error is returned.
If the base station location is not enabled, 0 values are returned.
Parameters
satID – GPS, Glonass, Galileo, BeiDou, QZSS, IRNSS and SBAS are supported. For more
information on the format, see "SOURce:ONECHN:SATid?" on page 252.
sigtype – one of the signal types supported by the satellite, allowed values are:
For GPS: L1CA, GPSL1CA, L1P, GPSL1P, L1PY, GPSL1PY, L1CAP, GPSL1CAP,
L1CAPY, GPSL1CAPY, L2P, GPSL2P, L2PY, GPSL2PY, L2C, GPSL2C, L5, GPSL5
Note that the signal types from the same group below share the same navigation bit
stream
L1CA, GPSL1CA, L1P, GPSL1P, L1PY, GPSL1PY, L1CAP, GPSL1CAP,
L2P, GPSL2P, L2PY, GPSL2PY
L2C, GPSL2C
L5, GPSL5
For Glonass: L1, GLOL1, L2, GLOL2,
For Galileo: E1, E5a, E5b
For BeiDou: B1, B2,
For QZSS: L1CA, L1SAIF (L1SBAS can be also used for L1SAIF)
For IRNSS: L5, IRNSSL5
For SBAS: L1SBAS or SBASL1 and L5SBAS or SBASL5
Location – user or base
Example
SEND:
SOURce:SCENario:PRANge? G19,L1CA
READ:
24241628.51
6.5.3.45 SOURce:SCENario:CHINview?
Function
Queries a comma separated list of values ranging from 1 to 64 which indicate which satel-
lite index values are active in view in the simulated sky. Duplicate and interference chan-
nels are ignored.
Command Syntax
SOURce:SCENario:CHINview? <ALL|GPS|GLO|GAL|BDS|QZSS|IRNSS|SBAS>
Note
If no scenario is running, an error is returned.
Parameter
constellation – ALL returns all active channels, while a constellation value returns satellite
index values for that constellation only. No argument is the same as ALL.
Example
SEND:
SOURce:SCENario:CHINview? GLO
READ:
3,5,9,12,14,17
6.5.3.46 SOURce:SCENario:SVINview?
Function
Queries a comma-separated list of SatID values which indicate which satellites are in view
in the simulated sky. Duplicate and interference channels are ignored.
Command Syntax
SOURce:SCENario:SVINview? <ALL|GPS|GLO|GAL|BDS|QZSS|IRNSS|SBAS>
Note
If the scenario is not running, an error is returned.
Parameter
constellation – ALL returns all active channels, while a constellation value returns satellite
IDs for that constellation only. No argument is the same as ALL.
Example
SEND:
SOURce:SCENario:SVINview? GLO
READ:
R2,R5,R9,R11,R12,R17
6.5.3.47 SOURce:SCENario:SVPos[n]?
Function
Queries a satellite’s ECEF position using channel number.
Command Syntax
SOURce:SCENario:SVPos[n]?
Note
If no scenario is running, an error is returned.
Parameter
Integer [1:N] – Satellite index of the satellite channel. Maximum is number of satellites
Example
SEND:
SOURce:SCENario:SVPos8?
READ:
13802999.54,18312013.72,13305242.14
6.5.3.48 SOURce:SCENario:SVPos[n]?
Function
Queries a satellite’s ECEF position using a Satellite ID. The user can specify all satellite
types supported including their multipath duplicates by satID. An optional location argu-
ment is specified to allow use with GSG’s simulating user position or with systems using
base station operation. If no location is specified, the user value is assumed.
Command Syntax
SOURce:SCENario:SVPos[n]? <satID>,<location>
Note
If no scenario is running, an error is returned.
If the base station location is not enabled, 0 values are returned.
Parameters
Integer [1:N] – Satellite index of the satellite. Maximum is number of satellites
satID – GPS, Glonass, Galileo, BeiDou, QZSS, IRNSS and SBAS are supported. The format
is explained under "SOURce:ONECHN:SATid?" on page 252.
Location – user or base
Example
SEND:
SOURce:SCENario:SVPos? G20
READ:
13802999.54,18312013.72,13305242.14
6.6 Programming
6.6.1.2 Synchronization
It is possible to synchronize SCPI commanding with GSG’s internal processing loop, with a
resolution of 100 ms. This can be achieved by using the *WAI and/or *OPC? commands.
For example, checking that the ECEF position command is applied on next 10 Hz epoch:
sour:scen:ecefposition IMMEDIATE,1000.0,2000.0,3000.0
*OPC?
sour:scen:ecefposition?
This synchronization can happen irrespective of whether an RSG command comes in.
For example, to see elapsed time “ticking” in 100 ms epochs
*OPC?
sour:scen:elapsedTime?
*OPC?
sour:scen:elapsedTime?
In addition, this synchronization mechanism can be used to consecutively to achieve any
desired synchronization rate (max resolution of 100 ms, ie. at 10 Hz). For this purpose only
*OPC? should be used. To use *WAI for this purpose the user would need to insert a small
micro sleep, or perform suitable actions, between consecutive *WAI commands.
For example, to see elapsed time “ticking” every half a second the following commands
can be looped:
...
*OPC?
sour:scen:elapsedTime?
*OPC?
*OPC?
*OPC?
*OPC?
*OPC?
sour:scen:elapsedTime?
*OPC?
...
syst:err?
6.6.1.5 Limitations
Communication over GPIB is not currently working for RSG commands – syn-
chronization fails.
Communication over GPIB is not currently working for RSG commands – syn-
chronization fails.
SOURce:SCENario:POSition TIME,<decimal>,<decimal>,<decimal>
…
or, without the SOURce:SCENario: part as:
POSition TIME,<decimal>,<decimal>,<decimal>
…
In the trajectory file format TIME must be a decimal number.
The resolution of the time stamps is 0.1 seconds (100 ms).
3. Select the file for use in a scenario the same way as any trajectory is selected.
F 2990 Added GSG-62 model and set Start Time based on NTP time. Minor July 2012
corrections.
G Updated for Real-time Scenario Generation commands. Minor cor- December
rection. 2012
H 3150 Updates corresponding with latest software release & product February
enhancements. 2013
J 3179 Added factory reset command. March
2013
BLANK PAGE.
Figure 6-1: Jerk [m/s³], acceleration [m/s²], velocity [m/s], and range [m] over
time [s] 260
E 2929 Added support for GSG-53 product, additional corrections. May 2012
F 2990 Added support for GSG-62 product features and NTP Server as a August
source for Start Time. 2012
J 3128 General updates coinciding with latest software release: newly December
released GSG-62 product & features, added information regarding 2012
new platform software feature enhancements.
K 3150 Updates coinciding with latest software release. Added information February
regarding product feature enhancements. 2013
N 3254 Updated to support latest software & software release modi- June 2013
fications
P 3347 Updated to support latest software & software release modi- March
fications 2014
Q 3458 Updated to support latest software & software release modi- April 2014
fications
18 000073 Updated to support latest software & new features July 2014
21 000421 Updated to support latest software & new features May 2015
22 000587 Updated to support latest software & new features (mainly Propaga- Sept 2015
tion Environment functionality) to support 6.5.1 firmware release.
New layout due to carry-over into new Authoring tool.
Integration of SCPI Guide into GSG User Manual.
23 000856 Added/changed content following SW release 6.6.1 (SCPI Clock April 2016
Model), new options (TLM, HPWR, SPF).
Changes to Trajectories topic, Encryption topic.
Ongoing document maintenance.
26 DOC- Changes to Transmit Power adjustment. Added several SCPI Jan 2018
000153 power commands. Errata.
Elevation mask 61
Emissions H
Electro-magnetic compliance 10 HOLD 33
Encryption 81 Hold key 30
ENU (East, North, Up) 327 Hold, scenario 109
Environmental modeling 68
Environmental specifications 9
I
Ephemeris 41 , 47 , 84 , 97 , 110 , 121 ,
150 , 162 , 170 , 191 , 206 , 251 , Interference signal 64
255
Ionosphere model 72
Epoch 46
IP configuration 99
Event data 54
EXTREF 32
J
F Jamming 66
Jamming, jammer 157
Factory default settings 188
Factory defaults, restore 103
File management 101
K
Files, uploading 125 Keyboard un/-locking 112
Firmware updating 124 Keys, front panel 28
Forever mode 42
Format key 30 L
Frequency band
Leap second 4, 118, 197
Signal type 7 , 37 , 65 , 114 , 188 ,
248 , 282- 284 , 286- 287 , Lever arm 60
356 Lock code, keyboard 113
Frequency offset 66, 97 Looping, scenario duration 42
G M
G-forces 46 Main menu 32
Gain pattern, antenna 60 Message type 68
GPS time 41 Models, GSG 203
Modulation, signal 95
Multipath signal 38, 61, 200, 276
REM 32
N Return Link Message 186, 300
Network configuration 99 Return Link Service 186, 300
NMEA logging 183 RF connector 24
Noise generation 91 RF output 7
NTP configuration 99 RINEX data 184
NTP server 40 RLM 186, 300
Numeric keys 30 RLS 186, 300
RTCM message 68
O
S
OCXO DAC value 106
One-Go, scenario duration 42 Safety precautions 12
Options, GSG 203 Satellite ID 66
Orientation 15 Satellite systems 75
SBAS 51, 82
Scenario, configuring 109
P
Scenarios, pre-installed 188
P (pseudo) code 82 SCPI, commands 227
Power requirements 10 SCPI, protocol errors 225
PPS delay 106 SCPI, syntax 224
PRN 36 Signal generator mode 94
PRN code 81, 96 Signal type
Proxy configuration 100 Frequency band 65 , 80 , 87-88 ,
Pure carrier signal 95 114, 165, 239-241, 258, 277,
356-357
Specifications, technical 7
R Start time 40, 48, 97, 149, 195
Rack installation 15 Status indicators 28
Random CP 63 Studioview 125
Range offset 63 StudioView 120
Real time scenario generation 43 , StudioView, about 120
131 , 140 , 148 , 152 , 158 , 165 , StudioView, introduction 120
196, 206, 226, 229, 234, 267,
269 , 292 , 332-333 , 361-363 , Sweep (modulation) 95
v Sweeper interference 66
Symbols, display 32
System information, show 103 W
Web UI 115 , 176
T Week number, GPS 41
Technical support 207 WGS84 (positioning) 42
TLE format 363
Trajectory 32 , 43, 110, 118, 130, 136, Y
138 , 140 , 148 , 152 , 158 , 333 ,
363 YUMA 50, 185
Trajectory, altitude 46
Trajectory, file size 46
Trajectory, looping 45
Trajectory, NMEA 45
Trajectory, one-line 47
Trajectory, predefined 43
Trajectory, RSG 45
Trajectory, timestamping 45
Trajectory, user-created 44
Transmit power 59 , 66 , 87-88 , 90 ,
188
Transmit Power, adjust 113
Transmit Power, manage 113
Transmit Power, set 113
Tropospheric model 73
Two- Line Element trajectory
format 363
U
Uploading scenario files 127
UTC-GPS offset 40
V
Vehicle model 69