DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™ GRS-1 Plugin
Document-Version: 1.0.7
Plugin-Version: 1.0.7
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
measurement innovation
measurement innovation
measurement innovation
measurement innovation
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Table Of Contents
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Table of Contents
1About this document...........................................................................................................................................................1
1.1Legend........................................................................................................................................................................1
1.2Links...........................................................................................................................................................................2
1.3Compatibility.............................................................................................................................................................2
1.4Files and Directories..................................................................................................................................................2
1.4.1Important DEWESoft™ 7 Directories..............................................................................................................2
1.4.1.1DEWESoft™ Measurement Unit [recommended]...................................................................................2
1.4.1.2Windows Standard....................................................................................................................................2
1.5Licensing....................................................................................................................................................................3
1.5.1Requesting an Evaluation license......................................................................................................................3
1.5.2Activating the Evaluation license......................................................................................................................3
1.6Plug-in Installation.....................................................................................................................................................3
1.7Input Fields................................................................................................................................................................4
1.7.1Input Confirmation............................................................................................................................................4
1.7.2Input Warnings/Errors.......................................................................................................................................4
2Configuration......................................................................................................................................................................5
2.1Hardware Setup..........................................................................................................................................................5
2.1.1Transport settings..............................................................................................................................................5
2.1.1.1TCP...........................................................................................................................................................5
2.1.1.2UDP..........................................................................................................................................................5
2.1.2Force Soft Sync.................................................................................................................................................5
2.1.3Communication Test..........................................................................................................................................6
2.1.4Log files.............................................................................................................................................................7
2.1.4.1Log levels..................................................................................................................................................7
2.2Channel Setup............................................................................................................................................................8
2.2.1Write NMEA Log file........................................................................................................................................9
2.2.2Channel Setup Grid...........................................................................................................................................9
2.2.2.1Header pop-up........................................................................................................................................10
2.2.2.2Multi select.............................................................................................................................................10
2.3Channels...................................................................................................................................................................10
2.3.1GGA: Device Time Text..................................................................................................................................10
2.3.2GGA: Device Time..........................................................................................................................................11
2.3.3GGA: Latitude GPS-Y....................................................................................................................................11
2.3.4GGA: Longitude GPS-X.................................................................................................................................11
2.3.5GGA: GPS Quality..........................................................................................................................................11
2.3.6GGA: No of Satellites.....................................................................................................................................11
2.3.7GGA: Horiz. Dilution......................................................................................................................................11
2.3.8GGA: Altitude.................................................................................................................................................11
2.3.9GGA: Geoid Height.........................................................................................................................................11
2.3.10GGA: Sec since last DGPS update................................................................................................................11
2.3.11GGA: DGPS Station ID.................................................................................................................................12
2.3.12VTG: Device Time VTG...............................................................................................................................12
2.3.13VTG: Track Made Good................................................................................................................................12
2.3.14VTG: Magnetic Track...................................................................................................................................12
2.3.15VTG: Ground Speed knots............................................................................................................................12
2.3.16VTG: Ground Speed kph...............................................................................................................................12
2.3.17VTG: Mode Ind.............................................................................................................................................12
2.3.18Mode Ind. Num.............................................................................................................................................12
2.3.19NMEA Log....................................................................................................................................................13
2.3.20Sync Status....................................................................................................................................................13
2.3.21Connection Status..........................................................................................................................................13
3Usage................................................................................................................................................................................14
3.1Time information.....................................................................................................................................................14
3.1.1Synchronized...................................................................................................................................................14
3.1.2Soft Synced......................................................................................................................................................14
measurement innovation
measurement innovation
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page I
DEWESoft™ GRS-1 Plugin
DEWESoftTM
DEWESoftTM
DEWESoftTM
Table Of Contents
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
DEWESoftTM
3.1.3Reception Time................................................................................................................................................15
3.2GPS channels...........................................................................................................................................................15
3.3Discrete Items..........................................................................................................................................................16
3.4ADMA plugin..........................................................................................................................................................17
4Version History.................................................................................................................................................................18
4.1Plugin Version..........................................................................................................................................................18
4.2Documentation Version............................................................................................................................................18
measurement innovation
Page II
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
About this document
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
1 About this document
This is the user documentation for DEWESoft™ GRS-1 Plugin Version 1.0.7.
The plugin can read GPS NMEA sentences over UDP and TCP/IP:
currently GGA (Global Positioning System Fix Data) and VTG (Track made good and Ground speed) are supported.
In DEWESoft™ you must use another GPS as Timing device (e.g. ADMA) and the GRS-1 must be synchronized with
this GPS (i.e. same time-stamps and the GRS-1 should get the position correction data to have the best possible
accuracy).
1.1 Legend
The following symbols and formats will be used throughout the document.
IMPORTANT
Gives you an important information about a subject.
Please read carefully!
HINT
Gives you a hint or provides additional information about a subject.
EXAMPLE
Gives you an example of a specific subject.
Example
Meaning
Description
Cancel
Button
a button that you can click
File
Menu Item
a menu item, will open a sub menu or a dialog
Times New Roman
List Item
an item in a list (or tree) that you can select
Events
Tab Sheet
a tab sheet that you can select
C:\Program Files\OpenOffice.org
3\readme.txt
File Path and Name
a file name or path
Windows Key
a term
any kind of term (maybe also compound)
Table 1: Layout formats used in the documentation
measurement innovation
Page 1/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
About this document
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
1.2 Links
DEWESoft™ homepage
http://www.dewesoft.com
you can download DEWESoft™ plugins when you go to: Downloads – Plugins
NMEA sentence format:
http://www.gpsinformation.org/dale/nmea.htm
http://gpsd.berlios.de/NMEA.txt
1.3 Compatibility
The plugin is compatible with DEWESoft™ 7.
It has been tested with the versions: DEWESoft™ 7.0.5 and DEWESoft™ 7.1-X RC 125 on Windows 7 (32 and 64-bit).
1.4 Files and Directories
The actual location of the directories on your computer may vary dependant on your computer's locale settings and the
settings you chose when installing DEWESoft™.
1.4.1 Important DEWESoft™ 7 Directories
1.4.1.1 DEWESoft™ Measurement Unit [recommended]
Directory
name
Explanation
Default path
Bin
contains DEWSoft.exe
D:\DEWESoft7\Bin\V7_0
Addons
.dll
Data
this is where DEWESoft™ will store your measurement data
D:\DEWESoft7\Data
Setups
this is where your DEWESoft™ setup files will be stored
D:\DEWESoft7\Setups
System
this is where DEWESoft™ project files are stored
D:\DEWESoft7\System\V7_0
D:\DEWESoft7\Bin\V7_0\Addons
files for plugins must be copied into this directory
Log
D:\DEWESoft7\System\V7_0\Logs
this is where DEWESoft™ will store log files
The paths may be different depending on your DEWESoft™ version.
1.4.1.2 Windows Standard
Directory name
Bin
Default path
language dependant directory:
C:\Programme\DEWESoft7\Bin\V7_0
Addons
language dependant directory:
C:\Programme\DEWESoft7\Bin\V7_0\Addons
Data
user/language dependant directory:
C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\Data
Setups
user/language dependant directory:
C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\Setups
System
user/language dependant directory:
C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\System\V7_0
Log
user/language dependant directory:
C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\System\V7_0\Logs
The paths may be different depending on your DEWESoft™ version.
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 2/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
About this document
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
1.5 Licensing
The plugin requires a valid DEWESoft™ license.
To test the plugin you can use an Evaluation license.
1.5.1 Requesting an Evaluation license
You can request an an Evaluation license
from our homepage:
http://www.dewesoft.com/registration
(1) Click on Evaluation license
(2) Fill out all the required fields
(3) Click the
Send evaluation license button
Illustration 1: Request Evaluation License
1.5.2 Activating the Evaluation license
When you have received your trial licence key, open DEWESoft™, go to Settings - Hardware Setup…, select the Registration
tab sheet and enter the license code (if you already have other licenses, you may need to click the Create button).
Now enter the license code and click the Register online Then your new license key will show up in the list and
button.
should have the Status Valid.
Illustration 3: Valid trial license
Illustration 2: Enter license key
1.6 Plug-in Installation
Simply copy the file GRS1.dll into the Addons folder of your DEWESoft™ installation.
(e.g. D:\DEWESoft7\Bin\V7_0\Addons\) and then start DEWESoft™).
measurement innovation
Page 3/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
HINT
DEWESoft™
About this document
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
When you are using Windows® 7, then you must click the Register plugins button (at the
bottom of the Hardware setup dialogue) once and restart DEWESoft™ before the plugin
shows up in the list of available plugins.
1.7 Input Fields
1.7.1 Input Confirmation
When you change the value of an input field, the background colour of the input field will
turn yellow to indicate that you have changed something and that this change has not been
confirmed yet.
Your input will automatically be confirmed when set the focus to another input filed (i.e. by
clicking with the mouse or by pressing the  key).
You can also press  to manually confirm your change.
After the input has been confirmed the background colour of the input field will be white
again (or red/orange, when there are errors/warnings.
1.7.2 Input Warnings/Errors
An invalid input may cause a warning and error.
Warnings will be highlighted in orange, errors in red. When you
hover over the input field you will see a hint with a detailed
description of what is wrong:
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 4/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
2 Configuration
2.1 Hardware Setup
Go to the Plugins tabsheet . In
the grid a the top, look for the
row with the name GRS1  (if
you don't find this row, see:
1.6 Plug-in Installation on page 3)
- make sure that the button in the
left of the column shows Used.
When you click on the GRS1 row
in the grid, you will see the
properties of the plugin in the
bottom of the screen:
 see 2.1.1 Transport settings
 see 2.1.3 Communication Test
 see 2.1.4 Log files
 see 2.1.2 Force Soft Sync
Illustration 4: Hardware setup
2.1.1 Transport settings
These settings are related to the transport layer: i.e. if we read the data via TCP or UDP.
2.1.1.1 TCP
When the GRS-1 is configured to transmit data via TCP/IP then you must enter the IP address of the GRS-1 device plus
the TCP/IP port number.
Read Timeout: when we do not receive any data during this period. The plugin will restart the TCP/IP connection.
2.1.1.2 UDP
When the GRS-1 is configured to send data automatically via UDP, then you only need to setup the UDP port.
2.1.2 Force Soft Sync
In DEWESoft™ you must use another GPS as Timing device (e.g. ADMA) and the GRS-1 must be synchronized with
this GPS (i.e. same time-stamps and the GRS-1 should get the position correction data to have the best possible
accuracy).
If you don't have an other Timing device, then you can activate this flag to force Software Synchronization (see also
3.1.2 Soft Synced on page 14). In this mode, the time information from the GRS-1 cannot be directly used for the datapoints, but it will be used as input for the software-synchronization. This will give you better results, than only using the
receive time of the data, but of course it is not as good as the real GPS time.
When this check box is activated, you will also see a warning in channel setup: see 2.2 Channel Setup on page 8
measurement innovation
Page 5/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
2.1.3 Communication Test
When you have setup the transport settings (see 2.1.1 Transport settings), you can start a test to see if the
communication works.
Just press the Start test button  and
wait until the test is finished (it takes
about 10 seconds).
If everything is okay, you will see
results, like those in Illustration 5.
 the status label will show that we
have received valid data (note: even if
the GRS-1 has no GPS fix, it will send
valid NMEA data – but without position
information
 the memo field will show all the data
that we have received
 the status line below the memo field
will show how many GGA and VTG
messages we have received
Illustration 5: Communication test okay
When you click the Start Test button,
the button's text will change to
Abort Test. If you click it, the test will
be aborted immediately. If you do not
abort the test, it will finish automatically
after 10 seconds.
Illustration 6: Communication test: Abort
When you click the Start Test button,
and the connection cannot be established
for some reason, the status label will turn
red and show you an error message.
e.g. in Illustration 7 we tried to connect
to a port that has already been opened by
another application.
Illustration 7: Communication test: In Use
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 6/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Another possible case is, that we can
successfully connect to the port (in
contrast to Illustration 7), but that we
just don't receive any data. During this
time, the status label will turn blue and
show how long we have already been
waiting for some data (i.e. 2 seconds in
Illustration 8)
Illustration 8: Communication test: Waiting for data
If we did not receive any data during the
test (i.e. within 10 seconds), the status
label will turn orange.
In this case, check if your transport
settings (see 2.1.1 Transport settings on
page 5) match those of the GRS-1
device. Also make sure, that the GRS-1
is actually transmitting data and that it is
within reach of the specified WLAN
network.
Illustration 9: Communication test: Waiting for data
2.1.4 Log files
The plugin will write log files during operation. The amount of log messages is configurable via the Log level drop
down box in the Hardware setup. The name of the logfile is GRS1log.
When the plugin is started, it will immediately start to log to the windows temporary directory.
As soon as the DEWESoft™ application is available to the plugin, all subsequent logs will be written to the standard
DEWESoft™ log directory (e.g. D:\DEWESoft7\System\V7_0\Logs).
Note: There is also a log file called GRS1.dll.log in the Addons directory (see 1.4 Files and Directories). This will
normally be empty. It will only contain messages when there is a bug very early in the plugin initialization.
2.1.4.1 Log levels
With the log level drop down box you can set the detail level of the logging function.
If you set a high log level (e.g. TRACE, ALL) a lot of log messages will be written and the
logfiles will roll over quite often. This is also dependent on the sample rate – the higher the
sample rate is, the more often data will be fetched and thus more log messages will be
written.
For production-use the log level INFO is recommended.
Log level
Description
Error
Will only log error messages
Warn
Will also log warning messages
Info
Will also log info messages – this is recommended for production use
Debug
Will also log debug messages
Trace
will also log trace messages
measurement innovation
Page 7/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
All
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
will log all messages
2.2 Channel Setup
The GRS1 channel setup will show you a list of all available channels and also show the live values:
Illustration 10: Channel Setup Overview
measurement innovation
1.
You must also have another GPS activated (and it must also be used as Timing device for DEWESoft™)
2.
Click on the GRS1 plugin icon to see the channel setup of the GRS1 plugin
3.
This text shows the version number of the plugin
4.
If you checked the Force Soft Sync check box in hardware setup (see 2.1.2 Force Soft Sync on page 5), then
this warning will be visible. See also: 3.1.2 Soft Synced on page 14
Note: if the warning is not visible, it does not necessarily mean that everything is setup correctly
(i.e. if you had setup an NTP timing device in the Hardware setup, the warning would also not be visible!)
5.
This status label shows warnings and errors of the channel setup
in the current example you can see that we have deleted the name of channel 2 in the channel setup grid (8).
Thus we get a warning, because every channel should have a meaningful name
6.
see 2.2.1 Write NMEA Log file on page 9
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 8/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
7.
see 2.2.2 Channel Setup Grid on page 9
8.
If any column has a warning or an error, it's background colour will change to orange/red.
In this case we have set an empty name for the channel and thus we get a warning. Also the status label will
display a warning message in this case: see (2)
DEWESoft™
2.2.1 Write NMEA Log file
If you check the 'Write NMEA log file' check-box, all received NMEA sentences (not only GGA and VTG) will be
written to a text file during storing the data.
The sentences will even be written when the checksum is wrong.
This file can be useful for debugging or it can be used in other programs to analyse the data-transfer. See also
2.3.19 NMEA Log on page 13.
The file will be stored in the same directory as your DEWESoft™ data file and it's name is the same plus
_NMEALog.txt.
EXAMPLE 1
If you store a DEWESoft™ data file called: TestDrive.d7d, then the NMEA Log file will be
called: TestDrive_NMEALog.txt
EXAMPLE 2
The contents of the text file will look like this:
$GNVTG,177.161,T,175.035,M,0.0582,N,0.1078,K,A*3E
$GPGGA,090110.90,4708.$GPGGA,090111.06,4708.5483396,N,01531.4986482,E,1,15,0.74,548.2659,M,43.7263,M,,*55
$GNVTG,150.930,T,148.804,M,0.0454,N,0.0840,K,A*3B
$GPGGA,090111.08,4708.5483409,N,01531.4986478,E,1,15,0.74,548.2699,M,43.7263,M,,*53
Note: that even invalid sentences will be in the text file: e.g. line 2 is clearly invalid, since it
contains another $ inside of the sentence (especially in UDP mode this is normal, since UDP
does not guarantee that the data are transmitted correctly).
IMPORTANT
This feature should NOT be activated in normal operation!
All data will be written to a single text file: so make sure, not to store for too long time. You
may end up with a huge file or writing to the file may even fail if it get's too big.
2.2.2 Channel Setup Grid
The Channel Setup Grid shows information about all channels of the plugin and also live values
Column
Id
Used
measurement innovation
Page 9/19
Information
This is just a unique consecutive number to identify the row/channel of the grid
You can click on the buttons in this row to toggle the Used status from Used to Unused.
Only channels that are set to Used will show up in Measure Mode and can be stored in DEWESoft™
data files.
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Stored
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
This is only useful if the channel is set to Used (see description above).
For Used channels you may want to deactivate the Store button. Then you can see and use the values
of this channel in Measure Mode, but the channel data will not be stored to the DEWESoft™ data file.
This can be useful if you just want to check the data, but don't need it after the measurement.
Another use-case is to use the data of the channel in other Math channels (e.g. to do some statistics) and
then only store the Math channel to the DEWESoft™ data file (but not the original data).
C
This colour will be used by the displays in Measure Mode. You can click on the colour to change it.
Name
This is the name of the channel as it will show up in the channel list of the Measure mode.
Make sure to enter a useful name for the channel (also it makes sense to use unique names to avoid
confusion).
If you enter a blank name, then you will get a warning.
Description Detailed description of the channel.
Value
This column will show the online data of the channels.
Note: you will only see live data of channels that are set to Used (see description above).
Unit
This is the unit that will be displayed for the channel.
Note: you can change this value, but it is not recommended.
2.2.2.1 Header pop-up
When you right-click on the header row of the channel
grid, you can specify which columns you want to see (i.e.
show/hide columns) and you can also sort/unsort the grid
by certain columns.
Illustration 11: Grid: Header Popup
2.2.2.2 Multi select
You can select and edit multiple rows at once.
1. left-click a cell and hold the mouse button
2. move the mouse (while still holding down the
mouse button) to the target cell and then release
the mouse button
The selected cells will now be surrounded by a black
rectangle. When you now click into the selected region,
you can change the Used status of all selected cells at once.
Note: this does also work for text-columns: i.e. you can
select several cells of the Name column and change all
selected names at once.
Illustration 12: Grid: Multi Select
2.3 Channels
2.3.1 GGA: Device Time Text
Shows the UTC time information from the GGA sentence that we get from the GRS1.
Note: this may be useful for debugging, but actually there is no need to store this information in the DEWESoft™ data
file (since the time-information will anyway be used to align the received data of the GRS1 to the DEWESoft™ master
clock – which must be set to another GPS device: e.g. ADMA). Thus, the channel is per default set to Unused.
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 10/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
2.3.2 GGA: Device Time
Shows the UTC time information from the GGA sentence that we get from the GRS1 in DEWESoft™ format (i.e.
number of seconds that have passed since the start of measurement).
Note: this may be useful for debugging, but actually there is no need to store this information in the DEWESoft™ data
file. Thus, the channel is per default set to Unused.
2.3.3 GGA: Latitude GPS-Y
Shows the Latitude information from the GGA sentence that we get from the GRS1. It can be used as the Y-coordinate
channel in DEWESoft™: see also 3.2 GPS channels on page 15
Note: Latitude should be ordered before Longitude, because this is also the order used in the ADMA plugin and in the
Polygon plugin.
2.3.4 GGA: Longitude GPS-X
Shows the Longitude information from the GGA sentence that we get from the GRS1. It can be used as the Xcoordinate channel in DEWESoft™: see also 3.2 GPS channels on page 15
2.3.5 GGA: GPS Quality
Shows the Latitude information from the GGA sentence that we get from the
GRS1.
In the image to the right you can see the discrete items (see also 3.3 Discrete
Items on page 16) that are assigned to the channel.
2.3.6 GGA: No of Satellites
Shows the number of satellites (from the GGA sentence) that are used by the GRS1 (can be 0-12).
2.3.7 GGA: Horiz. Dilution
Shows the horizontal dilution (in meters) from the GGA sentence that we get from the GRS1.
2.3.8 GGA: Altitude
Shows the altitude (in meters) from the GGA sentence that we get from the GRS1.
2.3.9 GGA: Geoid Height
Shows the geoid height(in meters) from the GGA sentence that we get from the GRS1.
2.3.10 GGA: Sec since last DGPS update
Shows the number of seconds since the last DGPS update from the GGA sentence that we get from the GRS1.
measurement innovation
Page 11/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
2.3.11 GGA: DGPS Station ID
Shows the DGPS station ID from the GGA sentence that we get from the GRS1 (can be 0-1023).
2.3.12 VTG: Device Time VTG
Shows the UTC time information used for the VTG sentence: see also 3.1 Time information on page 14.
Note: this may be useful for debugging, but actually there is no need to store this information in the DEWESoft™ data
file. Thus, the channel is per default set to Unused.
2.3.13 VTG: Track Made Good
Shows the Track (in degrees) from the VTG sentence that we get from the GRS1. This can be used as direction channel
for the GPS map visual control.
2.3.14 VTG: Magnetic Track
Shows the Magnetic Track (in degrees) from the VTG sentence that we get from the GRS1.
This channel is per default set to Unused.
2.3.15 VTG: Ground Speed knots
Shows the Ground Speed (in knots) from the VTG sentence that we get from the GRS1.
2.3.16 VTG: Ground Speed kph
Shows the Ground Speed (in kph) from the VTG sentence that we get from the GRS1.
2.3.17 VTG: Mode Ind.
The mode indication character from the VTG sentence that we get from the GRS1.
According to http://www.gpsinformation.org/dale/nmea.htm it can have the following values:
A
autonomous
D
differential
E
Estimated
N
not valid
S
Simulator
See also 2.3.18 Mode Ind. Num below
2.3.18 Mode Ind. Num
Shows the Mode Indicator information from the VTG sentence that we get
from the GRS1.
In the image to the right you can see the discrete items (see also 3.3 Discrete
Items on page 16) that are assigned to the channel.
Note: the numeric values are not NMEA standard.
See also: 2.3.18 Mode Ind. Num above
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 12/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Configuration
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
2.3.19 NMEA Log
This string channel will contain ALL NMEA sentences that we receive (not only GGA and VTG).
When you store this channel in the DEWESoft™ data file, the data file will be much bigger. Thus, the channel is set to
Unused per default. However, this can be very useful for debugging. See also 2.2.1 Write NMEA Log file on page 9.
2.3.20 Sync Status
Shows the Sync Status that is used for the measurement.
You should always have synchronized (if the Timing device is setup
correctly): see also 3.1.1 Synchronized on page 14.
If you checked the Force Soft Sync check box in hardware setup (see
2.1.2 Force Soft Sync on page 5), then, you will see soft sync: see also
3.1.2 Soft Synced on page 14.
During measurement the plugin is constantly checking the GRS1 time
information and if it is for some reason more than 10 seconds off from the
DEWESoft™ master clock (which is usually another GPS: e.g. ADMA), then
the plugin will set this status to inconsistent. Since now the time-information
from the GRS-1 is obviously useless, you should stop the measurement and
correct the problem. Anyway, all data that will arrive in the inconsistent state,
will not be synchronized to the DEWESoft™ master clock: only the time
when the data is added to the DEWESoft™ channel will be used as timeinformation (see 3.1.3 Reception Time on page 15).
In the image to the right you can see the discrete items (see also 3.3 Discrete
Items on page 16) that are assigned to the channel.
2.3.21 Connection Status
Shows the TCP/IP or UDP connection status.
If everything is setup correctly, the status will be connected and remain
connected until the end of the measurement.
If the TCP/IP connection is lost during measurement for some reason (e.g.
the GRS-1 device is out of reach of the WLAN network) then the status will
be set to disconnected. The plugin will try to reconnect in certain intervals
and if the reconnection succeeds, the status will be set to reconnected.
Note: Since UDP has no notion of a connection (i.e. it is not
possible/required to open and close a connection, as it is for TCP/IP), it is not
possible for the plugin to be notified of a disconnection (i.e. if the GRS1 is
out of reach of the WLAN network, we will just not receive any data until the
GRS1 is in reach of the WLAN network again. So the Connection Status is
not of much use for UDP.
measurement innovation
Page 13/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Usage
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
3 Usage
3.1 Time information
The plugins main aim is to be used together with another GPS as Timing device (e.g. ADMA) and the GRS-1 must be
synchronized with this GPS (i.e. same time-stamps and the GRS-1 should get the position correction data to have the
best possible accuracy): see 3.1.1 Synchronized below.
Even if you do not have another GPS used as Timing device, you can use the GRS-1 data in DEWESoft™ - then the
GRS-1 data will be software synchronized to whatever the master clock of DEWESoft™ is: see 3.1.2 Soft
Synced below.
Some channels will never be synchronized at all: i.e. the NMEA Log channel (see 2.3.19 NMEA Log on page 13) will
always use the time when DEWESoft™ has received the sentence.
The channel Sync Status (2.3.20 Sync Status on page 13) will show which synchronization mode is currently used.
HINT
Since the VTG sentence does not contain any time information, we use the time information
of the latest GGA sentence, so that the VTG data always has the same time information as the
GGA sentence (in Soft Synced mode the time information may still be different, because each
time stamp is soft-synchronized on it's own).
This has following consequences:
When the device sends only VTG sentences, you will not see any data, because we
have no time-information
The device should not send VTG sentences at a higher rate than the GGA sentences
(then 2 VTG sentences would end up at the same point in time)
3.1.1 Synchronized
In DEWESoft™ you must use another GPS as Timing device (e.g. ADMA) and the GRS-1 must be synchronized with
this GPS (i.e. same time-stamps and the GRS-1 should get the position correction data to have the best possible
accuracy).
Since both GPS will have the same very accurate time, the plugin will extract the UTC-time information from the GGA
sentence and use it as time-stamp for the data.
Note: if for some strange reason the 2 GPS times do not match the plugin will switch to Reception Time mode (see
2.3.20 Sync Status on page 13 for details).
3.1.2 Soft Synced
If you checked the Force Soft Sync check box in hardware setup (see 2.1.2 Force Soft Sync on page 5), then the plugin
will software synchronize the GRS1 data to the DEWESoft™ masterclock. Thus, the 2 data sources will not drift apart
in the long run, but the data will jitter (thus it is always recommended to use Synchronized mode).
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 14/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Usage
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
3.1.3 Reception Time
For channels, that do not belong to any NMEA sentence, the plugin simply uses the time when the data were received:
Synchronized
Soft Synced
Reception Time
3.2 GPS channels
The channels Longitude and Latitude (see also: Error:
Reference source not found Error: Reference source not found
and 2.3.3 GGA: Latitude GPS-Y on page 11) can be used in
DEWESoft™'s GPS visual control:
1.
click on the GPS visual control
2.
move the GPS visual control to the screen
3.
make sure to select Longitude and Latitude (you will
only see GPS channels in the list of measurement
channels when the GPS visual control is selected)
You can even use a background image of a map showing the
region where the GPS data was recorded (see 'GPS display' in
the DEWESoft™ online help for more details on the GPS visual
control).
Note: internally DEWESoft™ stores the GPS coordinates in minutes: i.e. 15°31.597' is stored (and thus exported)
as 931.597498'.
measurement innovation
Page 15/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Usage
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
3.3 Discrete Items
Some channels have a discrete item list assigned – this is best
displayed with the Indicator lamp visual control:
1.
click on the Indicator lamp visual control
2.
move the Indicator lamp visual control to the screen
(make it wide – because we want to display a text)
3.
change the Display mode from Indicator lamp to
Discrete Display
4.
and finally assign a channel that has a discrete items
list assigned: e.g. the channel Connection Status (see
2.3.21 Connection Status on page 13).
Now you should see the text value, as it is defined in the
discrete items list – e.g. connected in this case
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 16/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Usage
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
3.4 ADMA plugin
When you use the ADMA plugin, you must make sure to activate the 'Use ADMA as clock provider' check-box, so that
the ADMA plugin will be used as the Masterclock for DEWESoft™ (i.e. it will provide the GPS time information for
the analogue channels). In that case the ADMA must be hard-wired to the analogue card (e.g. ORION card), so that the
analogue card will get the PPS (pulse per second) signal for synchronization:
Illustration 13: ADMA plugin
measurement innovation
Page 17/19
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Version History
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
4 Version History
4.1 Plugin Version
Plugin-Version
Date
[dd.mm.yyyy]
Notes
1.0.0
20.03.2013
initial revision
1.0.1
22.03.2013
☑ Fixed problem with German locale settings (decimal separator caused an error)
☑ introduced registry for internal tests
1.0.2
03.04.2013
☑ Temporary test version
1.0.3
03.04.2013
☑ Added Force Soft Sync checkbox to hardware setup
(we cannot just check if a timing device is used, because ADMA does not show
up as a Timing device in DEWESoft™ - it just has an option to be DEWESoft™
master clock and then the ADMA will clock the analogue device)
1.0.4
10.04.2013
☑ Changed channel names and descriptions according to the customers request
☑ Changed order of Lat and Long
☑ Magnetic track is now unused per default
☑ Track Made Good: is now marked as GPS direction
1.0.5
23.05.2013
☑ Increased precision of Lat and Long from Single to Double
☑ Increased length of NMEA Log channel to 90 (GGA messages were truncated)
☑ internal: using other output directory for DCU files
1.0.6
12.08.2013
☑ Improvements to SoftSync (switched to inconsistent in older versions)
☑ TCP/IP: added read-timout in HW setup
☑ NMEA Log channel: when packets are received with the same timestamp, the
timestamps will be distributed by a minimum delta, to make sure, that all
sentences are visible in a DEWESoft™ tabular visual control
☑ data that is received, before DEWESoft™ has a time-information (i.e. because
ADAMA plugin needs some ms to start working) will be ignored (so that the
GRS1 connection status will not be switched to inconsistent)
☑ fixed possible hang with UDP test in HW-setup
1.0.7
12.09.2013
☑ Fixed minor problem with display of channel GRS1_Device_Time_Text in
Analysis mode
4.2 Documentation Version
Revision number: 53
Last modified:
Thu 12 Sep 2013, 11:25
Doc-Version
Date
[dd.mm.yyyy]
Notes
1.0.0
20.03.2013
initial revision for plugin version 1.0.0
1.0.1
22.03.2013
☑ New plugin version 1.0.1
☑ TOC entries are now hyperlinks
1.0.3
03.04.2013
☑ Changes for Force Soft Sync checkbox
1.0.4
10.04.2014
☑ Changes for plugin Version 1.0.4
☑ added notes about ADMA plugin
1.0.5
23.05.2013
☑ Updated to plugin version 1.0.5
measurement innovation
measurement innovation
Document-Version: 1.0.7
measurement innovation
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
Page 18/19
DEWESoft™ GRS-1 Plugin
DEWESoft™
DEWESoft™
DEWESoft™
Doc-Version
Version History
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Date
[dd.mm.yyyy]
12.08.2013
☑ Updated to plugin version 1.0.6
1.0.7
12.09.2013
☑ Updated to plugin version 1.0.7
Page 19/19
measurement innovation
DEWESoft™
DEWESoft™
DEWESoft™
DEWESoft™
Notes
1.0.6
measurement innovation
DEWESoft™
measurement innovation
measurement innovation
www.dewesoft.com
measurement innovation
measurement innovation
measurement innovation
Document-Version: 1.0.7