Difference between revisions of "GPS"

From Wiki Knowledge Base | Teltonika GPS
(Created page with "==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 G...")
 
 
(17 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 RUT routers.
+
'''The Global Positioning System (GPS)''' is a space-based radionavigation system. This chapter is an overview of the GPS function in RUT955 routers.
  
 
==GPS==
 
==GPS==
Line 13: Line 13:
 
[[Image:Services gps configuration.PNG]]
 
[[Image:Services gps configuration.PNG]]
  
−
{| class="wikitable"
+
<table class="nd-mantable">
−
|+
+
    <tr>
−
! style="width: 250px; background: black; color: white;"  | Field name
+
        <th>field name</th>
−
! style="width: 250px; background: black; color: white;"  | Value
+
      <th>value</th>
−
! style="width: 1200px; background: black; color: white;" | Description
+
      <th>description</th>
−
|-
+
    </tr>
−
! style="text-align: left; vertical-align: top;" | Enable GPS service
+
    <tr>
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
+
      <td>Enable GPS service</td>
−
| style="text-align: left; vertical-align: top;" | Toggles GPS ON or OFF
+
      <td>yes {{!}} no; Default: '''no'''</td>
−
|-
+
      <td>Toggles GPS ON or OFF</td>
−
! style="text-align: left; vertical-align: top;" | Enable GPS data to server
+
    </tr>
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
+
    <tr>
−
| style="text-align: left; vertical-align: top;" | Enables automatic GPS data transferring to a remote server  
+
      <td>Enable GPS data to server</td>
−
|-
+
      <td>yes {{!}} no; Default: '''no'''</td>
−
! style="text-align: left; vertical-align: top;" | Remote host/IP address
+
      <td>Enables automatic GPS data transferring to a remote server </td>
−
| 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
+
    <tr>
−
|-
+
    <td>Remote host/IP address</td>
−
! style="text-align: left; vertical-align: top;" | Port
+
        <td>host {{!}} ip; Default: '''212.47.99.61'''</td>
−
| style="text-align: left; vertical-align: top;" | integer [0..65535]; Default: '''17050'''
+
        <td>Server IP address or domain name to send the coordinates to</td>
−
| style="text-align: left; vertical-align: top;" | Server port used for data transfer
+
    </tr>
−
|-
+
    <tr>
−
! style="text-align: left; vertical-align: top;" | Protocol
+
    <td>Port</td>
−
| style="text-align: left; vertical-align: top;" | TCP {{!}} UDP; Default: '''TCP'''
+
        <td>integer [0..65535]; Default: '''17050'''</td>
−
| style="text-align: left; vertical-align: top;" | Protocol to be used for data transfer to server
+
        <td>Server port used for data transfer</td>
−
|-
+
    </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]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Send GSM signal</td>
 +
      <td>yes {{!}} no; Default: '''no'''</td>
 +
      <td>Includes GSM signal strength information in GPS data package to be sent to server</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Send analog input</td>
 +
      <td>yes {{!}} no; Default: '''no'''</td>
 +
      <td>Includes analog input state in GPS data package to be sent to server</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Send digital input (1)</td>
 +
        <td>yes {{!}} no; Default: '''no'''</td>
 +
        <td>Includes digital input #1 state in GPS data package to be sent to server</td>
 +
    </tr>
 +
    <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==
 +
 +
[[Image:Services gps mode.PNG]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Min period</td>
 +
      <td>integer [1..999999]; Default: '''5'''</td>
 +
      <td>Period (in seconds) for data collection</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Min distance</td>
 +
      <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>
 +
    </tr>
 +
    <tr>
 +
    <td>Min angle</td>
 +
        <td>integer [1..999999]; Default: '''30'''</td>
 +
        <td>Minimal angle difference between last registered and current coordinates to collect data (even if Min period has not passed yet)</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Min saved records</td>
 +
        <td>integer [1..32]; Default: '''20'''</td>
 +
        <td>Minimal amount of coordinates registered to send them to server immediately (even if Send period has not passed yet)</td>
 +
    </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.
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>WAN</td>
 +
      <td>Mobile {{!}} Wired {{!}} WiFi; Default: '''Mobile'''</td>
 +
      <td>Interface which needs to be used to activate this configuration</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Type</td>
 +
      <td>Home {{!}} Roaming {{!}} Both; Default: '''Home'''</td>
 +
      <td>Mobile connection state needed to activate this configuration</td>
 +
    </tr>
 +
    <tr>
 +
    <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==
 +
 +
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.
 +
 +
[[Image:Services gps io.PNG]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Enable</td>
 +
      <td>yes {{!}} no; Default: '''no'''</td>
 +
      <td>Toggles the rule ON or OFF</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Input type</td>
 +
      <td>Digital {{!}} Digital isolated {{!}} Analog; Default: '''Digital'''</td>
 +
      <td>Which type of input the rule will apply to</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Trigger</td>
 +
        <td>Input open {{!}} Input shorted {{!}} Both; Default: '''Input open'''</td>
 +
        <td>Trigger event for your intended configuration</td>
 +
    </tr>
 +
    <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==
 +
 +
'''Geofencing''' is a feature which can detect whenever a device enters or leaves customized area.
 +
 +
[[Image:Services gps geofencing.PNG]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Enable</td>
 +
      <td>yes {{!}} no; Default: '''no'''</td>
 +
      <td>Toggles GPS Geofencing ON or OFF</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Longitude (X)</td>
 +
      <td>real number [-180..180]; Default: '''0.000000'''</td>
 +
      <td>Longitude of selected point</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Latitude (Y)</td>
 +
        <td>real number [-90..90]; Default: '''0.000000'''</td>
 +
        <td>Latitude of selected point</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Radius</td>
 +
        <td>integer [1..999999]; Default: '''200'''</td>
 +
        <td>Radius of selected area</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Generate event on</td>
 +
        <td>Exit {{!}} Enter {{!}} Enter/Exit; Default: '''Exit'''</td>
 +
        <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>
  
−
[[Image:Services gps configuration tavl.PNG]]
+
==See also==
  
−
{| class="wikitable"
+
[http://wiki.teltonika-gps.com/index.php?title=RUT955_Protocols RUT955 GPS protocols]
−
|+
 
−
! style="width: 250px; background: black; color: white;"  | Field name
 
−
! style="width: 250px; background: black; color: white;"  | Value
 
−
! style="width: 1200px; background: black; color: white;" | Description
 
−
|-
 
−
! style="text-align: left; vertical-align: top;" | Send GSM signal
 
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
−
| style="text-align: left; vertical-align: top;" | Includes GSM signal strength information in GPS data package to be sent to server
 
−
|-
 
−
! style="text-align: left; vertical-align: top;" | Send analog input
 
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
−
| style="text-align: left; vertical-align: top;" | Includes analog input state in GPS data package to be sent to server
 
−
|-
 
−
! style="text-align: left; vertical-align: top;" | Send digital input (1)
 
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
−
| style="text-align: left; vertical-align: top;" | Includes digital input #1 state in GPS data package to be sent to server
 
−
|-
 
−
! style="text-align: left; vertical-align: top;" | Send digital input (2)
 
−
| style="text-align: left; vertical-align: top;" | yes {{!}} no; Default: '''no'''
 
−
| style="text-align: left; vertical-align: top;" | Includes digital input #2 state in GPS data package to be sent to server
 
−
|-
 
−
|}
 

Latest revision as of 14:13, 19 December 2018

Summary

The Global Positioning System (GPS) is a space-based radionavigation system. This chapter is an overview of the GPS function in RUT955 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

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.

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

See also

RUT955 GPS protocols

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=GPS&oldid=25652"