Difference between revisions of "GPS"

From Wiki Knowledge Base | Teltonika GPS
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Summary==
 
==Summary==
  
'''The Global Positioning System (GPS)''' is a space-based radionavigation system. This chapter is an overview of the GPS function in RUT955 routers.
+
'''The Global Positioning System (GPS)''' is a space-based radionavigation system. This chapter is an overview of the GPS function in RUT routers.
  
 
==GPS==
 
==GPS==
Line 13: Line 13:
 
[[Image:Services gps configuration.PNG]]
 
[[Image:Services gps configuration.PNG]]
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Enable GPS service
      <td>Enable GPS service</td>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>yes {{!}} no; Default: '''no'''</td>
+
| style="text-align: left; vertical-align: top;" | Toggles GPS ON or OFF
      <td>Toggles GPS ON or OFF</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Enable GPS data to server
    <tr>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>Enable GPS data to server</td>
+
| style="text-align: left; vertical-align: top;" | Enables automatic GPS data transferring to a remote server  
      <td>yes {{!}} no; Default: '''no'''</td>
+
|-
      <td>Enables automatic GPS data transferring to a remote server </td>
+
! style="text-align: left; vertical-align: top;" | Remote host/IP address
    </tr>
+
| style="text-align: left; vertical-align: top;" | host {{!}} ip; Default: '''212.47.99.61'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Server IP address or domain name to send the coordinates to
    <td>Remote host/IP address</td>
+
|-
        <td>host {{!}} ip; Default: '''212.47.99.61'''</td>
+
! style="text-align: left; vertical-align: top;" | Port
        <td>Server IP address or domain name to send the coordinates to</td>
+
| style="text-align: left; vertical-align: top;" | integer [0..65535]; Default: '''17050'''
    </tr>
+
| style="text-align: left; vertical-align: top;" | Server port used for data transfer
    <tr>
+
|-
    <td>Port</td>
+
! style="text-align: left; vertical-align: top;" | Protocol
        <td>integer [0..65535]; Default: '''17050'''</td>
+
| style="text-align: left; vertical-align: top;" | TCP {{!}} UDP; Default: '''TCP'''
        <td>Server port used for data transfer</td>
+
| style="text-align: left; vertical-align: top;" | Protocol to be used for data transfer to server
    </tr>
+
|-
    <tr>
+
|}
    <td>Protocol</td>
 
        <td>TCP {{!}} UDP; Default: '''TCP'''</td>
 
        <td>Protocol to be used for data transfer to server</td>
 
    </tr>
 
</table>
 
  
 
===TAVL Settings===
 
===TAVL Settings===
----
+
 
 
[[Image:Services gps configuration tavl.PNG]]
 
[[Image:Services gps configuration tavl.PNG]]
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Send GSM signal
      <td>Send GSM signal</td>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>yes {{!}} no; Default: '''no'''</td>
+
| style="text-align: left; vertical-align: top;" | Includes GSM signal strength information in GPS data package to be sent to server
      <td>Includes GSM signal strength information in GPS data package to be sent to server</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Send analog input
    <tr>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>Send analog input</td>
+
| style="text-align: left; vertical-align: top;" | Includes analog input state in GPS data package to be sent to server
      <td>yes {{!}} no; Default: '''no'''</td>
+
|-
      <td>Includes analog input state in GPS data package to be sent to server</td>
+
! style="text-align: left; vertical-align: top;" | Send digital input (1)
    </tr>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Includes digital input #1 state in GPS data package to be sent to server
    <td>Send digital input (1)</td>
+
|-
        <td>yes {{!}} no; Default: '''no'''</td>
+
! style="text-align: left; vertical-align: top;" | Send digital input (2)
        <td>Includes digital input #1 state in GPS data package to be sent to server</td>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
    </tr>
+
| style="text-align: left; vertical-align: top;" | Includes digital input #2 state in GPS data package to be sent to server
    <tr>
+
|-
    <td>Send digital input (2)</td>
+
|}
        <td>yes {{!}} no; Default: '''no'''</td>
 
        <td>Includes digital input #2 state in GPS data package to be sent to server</td>
 
    </tr>
 
</table>
 
  
 
==GPS Mode==
 
==GPS Mode==
Line 82: Line 73:
 
[[Image:Services gps mode.PNG]]
 
[[Image:Services gps mode.PNG]]
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+ style="text-align: left;" | Data Sending Parameters
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Min period
      <td>Min period</td>
+
| style="text-align: left; vertical-align: top;" | integer [1..999999]; Default: '''5'''
      <td>integer [1..999999]; Default: '''5'''</td>
+
| style="text-align: left; vertical-align: top;" | Period (in seconds) for data collection
      <td>Period (in seconds) for data collection</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Min distance
    <tr>
+
| style="text-align: left; vertical-align: top;" | integer [1..999999]; Default: '''200'''
      <td>Min distance</td>
+
| style="text-align: left; vertical-align: top;" | Distance difference (in meters) between last registered and current coordinates to collect data (even if Min period has not passed yet)
      <td>integer [1..999999]; Default: '''200'''</td>
+
|-
      <td>Distance difference (in meters) between last registered and current coordinates to collect data (even if Min period has not passed yet)</td>
+
! style="text-align: left; vertical-align: top;" | Min angle
    </tr>
+
| style="text-align: left; vertical-align: top;" | integer [1..999999]; Default: '''30'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Minimal angle difference between last registered and current coordinates to collect data (even if Min period has not passed yet)
    <td>Min angle</td>
+
|-
        <td>integer [1..999999]; Default: '''30'''</td>
+
! style="text-align: left; vertical-align: top;" | Min saved records
        <td>Minimal angle difference between last registered and current coordinates to collect data (even if Min period has not passed yet)</td>
+
| style="text-align: left; vertical-align: top;" | integer [1..32]; Default: '''20'''
    </tr>
+
| style="text-align: left; vertical-align: top;" | Minimal amount of coordinates registered to send them to server immediately (even if Send period has not passed yet)
    <tr>
+
|-
    <td>Min saved records</td>
+
! style="text-align: left; vertical-align: top;" | Send period
        <td>integer [1..32]; Default: '''20'''</td>
+
| style="text-align: left; vertical-align: top;" | integer [1..999999]; Default: '''60'''
        <td>Minimal amount of coordinates registered to send them to server immediately (even if Send period has not passed yet)</td>
+
| style="text-align: left; vertical-align: top;" | Period for sending collected data to server
    </tr>
+
|-
    <tr>
+
|}
    <td>Send period</td>
 
        <td>integer [1..999999]; Default: '''60'''</td>
 
        <td>Period for sending collected data to server</td>
 
    </tr>
 
</table>
 
  
 
The GPS configuration section allows to save several different configurations for GPS data collection. Active configuration is automaticaly selected when configured conditions are met.
 
The GPS configuration section allows to save several different configurations for GPS data collection. Active configuration is automaticaly selected when configured conditions are met.
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+ style="text-align: left;" | GPS Configuration
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | WAN
      <td>WAN</td>
+
| style="text-align: left; vertical-align: top;" | Mobile {{!}} Wired {{!}} WiFi; Default: '''Mobile'''
      <td>Mobile {{!}} Wired {{!}} WiFi; Default: '''Mobile'''</td>
+
| style="text-align: left; vertical-align: top;" | Interface which needs to be used to activate this configuration
      <td>Interface which needs to be used to activate this configuration</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Type
    <tr>
+
| style="text-align: left; vertical-align: top;" | Home {{!}} Roaming {{!}} Both; Default: '''Home'''
      <td>Type</td>
+
| style="text-align: left; vertical-align: top;" | Mobile connection state needed to activate this configuration
      <td>Home {{!}} Roaming {{!}} Both; Default: '''Home'''</td>
+
|-
      <td>Mobile connection state needed to activate this configuration</td>
+
! style="text-align: left; vertical-align: top;" | Digital isolated input
    </tr>
+
| style="text-align: left; vertical-align: top;" | Low logic level {{!}} High logic level {{!}} Both; Default: '''Low'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Input state needed to activate this configuration
    <td>Digital isolated input</td>
+
|-
        <td>Low logic level {{!}} High logic level {{!}} Both; Default: '''Low'''</td>
+
|}
        <td>Input state needed to activate this configuration</td>
 
    </tr>
 
</table>
 
  
 
==GPS I/O==
 
==GPS I/O==
Line 146: Line 129:
 
[[Image:Services gps io.PNG]]
 
[[Image:Services gps io.PNG]]
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Enable
      <td>Enable</td>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>yes {{!}} no; Default: '''no'''</td>
+
| style="text-align: left; vertical-align: top;" | Toggles the rule ON or OFF
      <td>Toggles the rule ON or OFF</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Input type
    <tr>
+
| style="text-align: left; vertical-align: top;" | Digital {{!}} Digital isolated {{!}} Analog; Default: '''Digital'''
      <td>Input type</td>
+
| style="text-align: left; vertical-align: top;" | Which type of input the rule will apply to
      <td>Digital {{!}} Digital isolated {{!}} Analog; Default: '''Digital'''</td>
+
|-
      <td>Which type of input the rule will apply to</td>
+
! style="text-align: left; vertical-align: top;" | Trigger
    </tr>
+
| style="text-align: left; vertical-align: top;" | Input open {{!}} Input shorted {{!}} Both; Default: '''Input open'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Trigger event for your intended configuration
    <td>Trigger</td>
+
|-
        <td>Input open {{!}} Input shorted {{!}} Both; Default: '''Input open'''</td>
+
! style="text-align: left; vertical-align: top;" | Priority
        <td>Trigger event for your intended configuration</td>
+
| style="text-align: left; vertical-align: top;" | Low {{!}} High {{!}} Panic; Default: '''Low'''
    </tr>
+
| style="text-align: left; vertical-align: top;" | Different priority settings add different priority flags to event packets, and they can be displayed differently
    <tr>
+
|-
    <td>Priority</td>
+
|}
        <td>Low {{!}} High {{!}} Panic; Default: '''Low'''</td>
 
        <td>Different priority settings add different priority flags to event packets, and they can be displayed differently</td>
 
    </tr>
 
</table>
 
  
 
==GPS Geofencing==
 
==GPS Geofencing==
Line 180: Line 159:
 
[[Image:Services gps geofencing.PNG]]
 
[[Image:Services gps geofencing.PNG]]
  
<table class="nd-mantable">
+
{| class="wikitable"
    <tr>
+
|+
        <th>field name</th>
+
! style="width: 250px; background: black; color: white;"  | Field name
      <th>value</th>
+
! style="width: 250px; background: black; color: white;"  | Value
      <th>description</th>
+
! style="width: 1200px; background: black; color: white;" | Description
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Enable
      <td>Enable</td>
+
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
      <td>yes {{!}} no; Default: '''no'''</td>
+
| style="text-align: left; vertical-align: top;" | Toggles GPS Geofencing ON or OFF
      <td>Toggles GPS Geofencing ON or OFF</td>
+
|-
    </tr>
+
! style="text-align: left; vertical-align: top;" | Longitude (X)
    <tr>
+
| style="text-align: left; vertical-align: top;" | real number [-180..180]; Default: '''0.000000'''
      <td>Longitude (X)</td>
+
| style="text-align: left; vertical-align: top;" | Longitude of selected point
      <td>real number [-180..180]; Default: '''0.000000'''</td>
+
|-
      <td>Longitude of selected point</td>
+
! style="text-align: left; vertical-align: top;" | Latitude (Y)
    </tr>
+
| style="text-align: left; vertical-align: top;" | real number [-90..90]; Default: '''0.000000'''
    <tr>
+
| style="text-align: left; vertical-align: top;" | Latitude of selected point
    <td>Latitude (Y)</td>
+
|-
        <td>real number [-90..90]; Default: '''0.000000'''</td>
+
! style="text-align: left; vertical-align: top;" | Radius
        <td>Latitude of selected point</td>
+
| style="text-align: left; vertical-align: top;" | integer [1..999999]; Default: '''200'''
    </tr>
+
| style="text-align: left; vertical-align: top;" | Radius of selected area
    <tr>
+
|-
    <td>Radius</td>
+
! style="text-align: left; vertical-align: top;" | Generate event on
        <td>integer [1..999999]; Default: '''200'''</td>
+
| style="text-align: left; vertical-align: top;" | Exit {{!}} Enter {{!}} Enter/Exit; Default: '''Exit'''
        <td>Radius of selected area</td>
+
| style="text-align: left; vertical-align: top;" | Specifies whether event takes place on exiting or entering the specified area or both
    </tr>
+
|-
    <tr>
+
! style="text-align: left; vertical-align: top;" | Get current coordinates
    <td>Generate event on</td>
+
| style="text-align: left; vertical-align: top;" | -
        <td>Exit {{!}} Enter {{!}} Enter/Exit; Default: '''Exit'''</td>
+
| style="text-align: left; vertical-align: top;" | Gets current device coordinates from GPS
        <td>Specifies whether event takes place on exiting or entering the specified area or both</td>
+
|-
    </tr>
+
|}
    <tr>
 
    <td>Get current coordinates</td>
 
        <td>-</td>
 
        <td>Gets current device coordinates from GPS</td>
 
    </tr>
 
</table>
 
 
 
==See also==
 
 
 
[http://wiki.teltonika-gps.com/index.php?title=RUT955_Protocols RUT955 GPS protocols]
 

Revision as of 14:48, 18 October 2017

Summary

The Global Positioning System (GPS) is a space-based radionavigation system. This chapter is an overview of the GPS function in RUT routers.

GPS

The GPS window displays your current coordinates and position on the map.

Services gps.PNG

GPS Settings

Services gps configuration.PNG

Field name Value Description
Enable GPS service yes | no; Default: no Toggles GPS ON or OFF
Enable GPS data to server yes | no; Default: no Enables automatic GPS data transferring to a remote server
Remote host/IP address host | ip; Default: 212.47.99.61 Server IP address or domain name to send the coordinates to
Port integer [0..65535]; Default: 17050 Server port used for data transfer
Protocol TCP | UDP; Default: TCP Protocol to be used for data transfer to server

TAVL Settings

Services gps configuration tavl.PNG

Field name Value Description
Send GSM signal yes | no; Default: no Includes GSM signal strength information in GPS data package to be sent to server
Send analog input yes | no; Default: no Includes analog input state in GPS data package to be sent to server
Send digital input (1) yes | no; Default: no Includes digital input #1 state in GPS data package to be sent to server
Send digital input (2) yes | no; Default: no Includes digital input #2 state in GPS data package to be sent to server

GPS Mode

Services gps mode.PNG

Data Sending Parameters
Field name Value Description
Min period integer [1..999999]; Default: 5 Period (in seconds) for data collection
Min distance integer [1..999999]; Default: 200 Distance difference (in meters) between last registered and current coordinates to collect data (even if Min period has not passed yet)
Min angle integer [1..999999]; Default: 30 Minimal angle difference between last registered and current coordinates to collect data (even if Min period has not passed yet)
Min saved records integer [1..32]; Default: 20 Minimal amount of coordinates registered to send them to server immediately (even if Send period has not passed yet)
Send period integer [1..999999]; Default: 60 Period for sending collected data to server

The GPS configuration section allows to save several different configurations for GPS data collection. Active configuration is automaticaly selected when configured conditions are met.

GPS Configuration
Field name Value Description
WAN Mobile | Wired | WiFi; Default: Mobile Interface which needs to be used to activate this configuration
Type Home | Roaming | Both; Default: Home Mobile connection state needed to activate this configuration
Digital isolated input Low logic level | High logic level | Both; Default: Low Input state needed to activate this configuration

GPS I/O

The GPS I/O window provides you with the possibility to configure GPS Input rules. To create a new Input rule select Input type and Trigger, both of which can be found in the GPS Input Configuration section, then click the Add button.

Services gps io.PNG

Field name Value Description
Enable yes | no; Default: no Toggles the rule ON or OFF
Input type Digital | Digital isolated | Analog; Default: Digital Which type of input the rule will apply to
Trigger Input open | Input shorted | Both; Default: Input open Trigger event for your intended configuration
Priority Low | High | Panic; Default: Low Different priority settings add different priority flags to event packets, and they can be displayed differently

GPS Geofencing

Geofencing is a feature which can detect whenever a device enters or leaves customized area.

Services gps geofencing.PNG

Field name Value Description
Enable yes | no; Default: no Toggles GPS Geofencing ON or OFF
Longitude (X) real number [-180..180]; Default: 0.000000 Longitude of selected point
Latitude (Y) real number [-90..90]; Default: 0.000000 Latitude of selected point
Radius integer [1..999999]; Default: 200 Radius of selected area
Generate event on Exit | Enter | Enter/Exit; Default: Exit Specifies whether event takes place on exiting or entering the specified area or both
Get current coordinates - Gets current device coordinates from GPS