8,699
edits
Changes
Template:Networking rutos manual gps rut2 rut9 (view source)
Revision as of 12:04, 9 April 2024
, 9 AprilCreated page with "{{Template: Networking_device_manual_fw_disclosure | series = {{{series}}} | name = {{{name}}} | fw_version ={{Template: Networking_device_manual_latest_fw | series = {{{se..."
{{Template: Networking_device_manual_fw_disclosure
| series = {{{series}}}
| name = {{{name}}}
| fw_version ={{Template: Networking_device_manual_latest_fw
| series = {{{series}}}
| name = {{{name}}}
}}
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} GPS (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
==Summary==
The <b>Global Positioning System</b> (<b>GPS</b>) is a space-based radionavigation system. This page is an overview of the GPS service in {{{name}}} devices.
==General==
The <b>General</b> is used to enable the GPS service and the support for different types satellites. Once you turn on GPS, you can check the [[{{{name}}}_GPS#Map|Map]] page in order to see if the device has obtained a GPS fix. It is very important to attach the GPS antenna on the device and place it outside (not inside of a building). The device will not be likely to obtain a GPS fix otherwise.
The figure below is an example of the General page and the table below provides information on the fields contained in that page:
{{#switch: {{{name}}}
| RUT906 | RUT956 | RUT955 = [[File:Networking_rutos_manual_gps_general_rut906.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_general_v2.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns the GPS service on or off.</td>
</tr>{{#switch: {{{name}}} | RUT906 | RUT956 = | #default =
<tr>
<td>DPO enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Enable dynamic power optimization (requires modem reboot). <b>This function is not supported on devices with Meig modems or Quectel BG95 modem</b> </td>
</tr>
<tr>
<td>Galileo NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for Galileo satellites on or off.</td>
</tr>
<tr>
<td>Glonass NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for Glonass satellites on or off.</td>
</tr>
<tr>
<td>BeiDou NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for BeiDou satellites on or off.</td>
</tr>}}
</table>
<span class="asterisk">*</span>Changing these options requires a modem reboot. Therefore, if you make changes to these options and save them, the device will lose cellular connectivity for about 30 seconds.
==Map==
The <b>Map</b> page displays the device's current coordinates and position on the map. To see the device's location on the map, make sure to attach the GPS antenna on the device and enable GPS in the [[#General|General]] page.
The figure below is an example of the Map page:
[[File:Networking_rutos_manual_gps_map_v3.png|border|class=tlt-border]]
==NMEA==
The <b>NMEA</b> page is used to configure settings related to NMEA sentence collecting and forwarding.
===NMEA forwarding===
----
The <b>NMEA forwarding</b> section is used to configure and enable NMEA forwarding. The figure below is an example of the NMEA forwarding section and the table below provides information on the fields contained in that section:
[[File:Networking rutos manual gps nmea nmea forwarding v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Turns NMEA forwarding on or off.</td>
</tr>
<tr>
<td>Hostname</td>
<td>ip | host; default: '''none'''</td>
<td>IP address or hostname of the server to which NMEA data will be forwarded.</td>
</tr>
<tr>
<td>Protocol</td>
<td>TCP | UDP; default: <b>TCP</b></td>
<td>Protocol that will be used to send NMEA data.</td>
</tr>
<tr>
<td>Port</td>
<td>integer [0..65535]; default: <b>8500</b></td>
<td>Port number off the server to which NMEA data will be forwarded.</td>
</tr>
<tr>
<td>Contain connection</td>
<td>off | on; default: <b>off</b></td>
<td>Contains active session with the remote server if turned on.</td>
</tr>
<tr>
<td>Select prefix</td>
<td>Custom | None |Serial | Mac address | IMEI; default: <b>None</b></td>
<td>Prefix is added to the NMEA sentence before it is transmitted. </td>
</tr>
</table>
===NMEA forwarding cache===
----
The device <b>caches NMEA forwarding</b> information if NMEA forwarding is enabled. This section is used to select the memory type where the cache will be stored and the maximum amount of data that will be saved:
[[File:Networking_rutos_manual_gps_nmea_nmea_forwarding_cache.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Save cache in</td>
<td>RAM Memory | FLASH Memory; default: <b>RAM Memory</b></td>
<td>Selects which type of memory will be used for storing NMEA forwarding cache.</td>
</tr>
<tr>
<td>Maximum sentences</td>
<td>integer; default: <b>5000</b></td>
<td>Maximum amount of NMEA sentences that will be saved in the cache before older entries are deleted and replaced by new ones.</td>
</tr>
<tr>
<td>File</td>
<td>filepath; default: <b>none</b></td>
<td>Location of the file where NMEA forwarding cache information will be stored. This field becomes visible only when the selected memory type is "flash".</td>
</tr>
</table>
===NMEA collecting===
----
The <b>NMEA collecting</b> section is used to enable NMEA sentence gathering and storing. The figure below is an example of the NMEA collecting section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_nmea_nmea_collecting_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: '''off'''</td>
<td>Turns NMEA sentence collecting on or off.</td>
</tr>
<tr>
<td>File</td>
<td>filepath; default: <b>none</b></td>
<td>Location of the file where NMEA sentences will be stored. This field becomes visible only when NMEA collecting is enabled.</td>
</tr>
</table>
===NMEA sentence settings===
----
The <b>NMEA sentence settings</b> section provides the possibility to configure which NMEA sentences will be forwarded or collected and at what frequency. The figure below is an example of the NMEA sentence settings section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_nmea_nmea_sentence_settings.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Forwarding enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Enables forwarding for the adjacent NMEA sentence.</td>
</tr>
<tr>
<td>Forwarding interval</td>
<td>positive integer; default: <b>5</b></td>
<td>NMEA sentence forwarding frequency in seconds.</td>
</tr>
<tr>
<td>Collecting enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Enables collecting for the adjacent NMEA sentence.</td>
</tr>
<tr>
<td>Collecting interval</td>
<td>positive integer; default: <b>5</b></td>
<td>NMEA sentence collecting frequency in seconds.</td>
</tr>
</table>
<br>
<b>NMEA sentence reference table</b>:
<table class="nd-othertables_3">
<tr>
<th width="250">NMEA sentence name</th>
<th width="902">Description</th>
</tr>
<tr>
<td><b>GPGSV</b></td>
<td>Number of GPS satellites in view.</td>
</tr>
<tr>
<td><b>GPGGA</b></td>
<td>GPS fix data.</td>
</tr>
<tr>
<td><b>GPVTG</b></td>
<td>GPS track made good and speed relative to the ground.</td>
</tr>
<tr>
<td><b>GPRMC</b></td>
<td>Recommended minimum specific GPS/Transit data.</td>
</tr>
<tr>
<td><b>GPGSA</b></td>
<td>GPS DOP and active satellites.</td>
</tr>
<tr>
<td><b>GNGSA</b></td>
<td>GLONASS DOP and active satellites.</td>
</tr>
<tr>
<td><b>GLGSV</b></td>
<td>Number of GLONASS satellites in view.</td>
</tr>
<tr>
<td><b>GNGNS</b></td>
<td>GNSS position fix from more than one constellation (e.g., GPS + GLONASS).</td>
</tr>
<tr>
<td><b>GAGSV</b></td>
<td>Number of Galileo satellites in view.</td>
</tr>
<tr>
<td><b>GARMC</b></td>
<td>Recomended minimum specific for Galileo data.</td>
</tr>
<tr>
<td><b>GAGGA</b></td>
<td>Galileo fix data.</td>
</tr>
<tr>
<td><b>GAGSA</b></td>
<td>Galileo DOP and active satellites.</td>
</tr>
<tr>
<td><b>GAVTG</b></td>
<td>Galileo track made good and speed information relative to the ground.</td>
</tr>
<tr>
<td><b>PQGSV</b></td>
<td>Detailed satellite data (used in BeiDou and QZSS (Quectel Quirk) sentences).</td>
</tr>
<tr>
<td><b>PQGSA</b></td>
<td>Overall satellite data (used in BeiDou and QZSS (Quectel Quirk) sentences).</td>
</tr>
<tr>
<td><b>GBGSV</b></td>
<td>Detailed satellite data (used in BeiDou sentences).</td>
</tr>
<tr>
<td><b>GBGSA</b></td>
<td>BeiDou DOP and active satellites.</td>
</tr>
<tr>
<td><b>GQGSV</b></td>
<td>Detailed QZSS satellite data (QZSS regional GPS augmentation system (Japan)).</td>
</tr>
<tr>
<td><b>GQGSA</b></td>
<td>QZSS DOP and active satellites (QZSS regional GPS augmentation system (Japan)).</td>
</tr>
</table>
==HTTPS==
The <b>HTTPS</b> page can be used to configure data sending to an HTTP(S) server.
===HTTPS/HTTP server settings===
----
The HTTPS/HTTP Server Settings section is used to enable GPS data sending to an HTTP or HTTPS server.
[[File:Networking_rutos_manual_gps_https_server_settings_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns data sending to HTTP/HTTPS server on or off.</td>
</tr>
<tr>
<td>URL</td>
<td>url string; default: <b>none</b></td>
<td>URL of the remote server (ex. example.com/xxxx).</td>
</tr>
<tr>
<td>Interval</td>
<td>integer; default: <b>none</b></td>
<td>Interval on which collected NMEA sentences should be forwarded.</td>
</tr>
</table>
===TAVL settings===
----
The <b>TAVL settings</b> section is used to select which data will be sent to the TAVL server:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rut955_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_trb245_manual_gps_https_tavl_settings.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
}}
{{#switch: {{{name}}}
| #default = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
</table>
| RUT955 | RUT956 | RUT906 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Iio</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Iio status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Acl0</td>
<td><span style="color: red;">Current {{!}} Percent</span>; off {{!}} on; default: <b><span style="color: red;">Current</span>; off</b></td>
<td>Includes Acl0 Current/Percent information in the GPS data sent to server.</td>
</tr>
</table>
| TRB245 | TRB246 | TRB255 | TRB256 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
</table>}}
==AVL==
The <b>AVL</b> page is used to set up GPS data sending to an AVL server.
===AVL server settings===
----
The <b>AVL server settings</b> section is used to configure the main parameters of data sending to an AVL server. The figure below is an example of the AVL Server Settings section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_avl_avl_server_settings_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Turns data sending to AVL server on or off.</td>
</tr>
<tr>
<td>Retry on Fail</td>
<td>off | on; default: <b>off</b></td>
<td>Turn retries in case of a failed attempts on or off. When turned on, the device will try to send the same data to the server until the transmission is successful.</td>
</tr>
<tr>
<td>Hostname</td>
<td>ip | host; default: <b>192.168.0.1</b></td>
<td>IP address or hostname of an AVL server.</td>
</tr>
<tr>
<td>Protocol</td>
<td>TCP | UDP; Default: <b>TCP</b></td>
<td>Protocol that will be used for communication with the AVL server.</td>
</tr>
<tr>
<td>Port</td>
<td>integer [0..65535]; default: <b>8501</b></td>
<td>TCP/UDP port number of the AVL server to which the device will be connecting.</td>
</tr>
<tr>
<td>Don't Contain Connection</td>
<td>off | on; default: <b>off</b></td>
<td>When turned on, handles each AVL packet iteration as a new connection. When turned off, connects once and uses the same socket for future communication.</td>
</tr>
<tr>
<td>Static Navigation</td>
<td>off | on; default: <b>off</b></td>
<td>Stop collecting NMEA data if object is stationary. Ignores data when speed equals to 0 or same as previous coordinates (rounded to 4 decimals).</td>
</tr>
</table>
===Main rule===
----
The <b>Main rule</b> section defines how and when GPS data will be collected and sent to a specified AVL server. Refer to the figure and table below for information on the configuration fields of Main Rule.
[[File:Networking rutos manual gps avl main rule v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>on</b></td>
<td>Turns the main rule on or off.</td>
</tr>
<tr>
<td>Rule priority</td>
<td>Low priority level | High priority level | Panic priority level | Security priority level; default: <b>Low priority level</b></td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first. Priority levels from highest to lowest are as follows:
<ol>
<li>Security</li>
<li>Panic</li>
<li>High</li>
<li>Low</li>
</ol>
</td>
</tr>
<tr>
<td>Collect period</td>
<td>integer [1..999999]; default: <b>5</b></td>
<td>How often (in seconds) data will be collected.</td>
</tr>
<tr>
<td>Min distance</td>
<td>integer [1..999999]; default: <b>50</b></td>
<td>Minimum distance change (in meters) before sending records.</td>
</tr>
<tr>
<td>Min angle</td>
<td>integer [1..360]; default: <b>50</b></td>
<td>Minimum angle change (in degrees) before sending records.</td>
</tr>
<tr>
<td>Min accuracy</td>
<td>integer [1..999999]; default: <b>10</b></td>
<td>Minimum accuracy (in meters) required before saving record. The lower the accuracy value, the better.</td>
</tr>
<tr>
<td>Min saved records</td>
<td>integer [1..32]; default: <b>20</b></td>
<td>Minimum amount of gathered records before sending.</td>
</tr>
<tr>
<td>Send period</td>
<td>integer [0..999999]; default: '''60'''</td>
<td>How often (in seconds) gathered data is sent.</td>
</tr>
</table>
===Secondary rules===
----
The <b>Secondary rules</b> section provides you with the possibility to create additional data sending rules. The difference from the main rule is that the secondary rules only send data when the device uses a specified type of WAN and when the digital isolated output is in the specified state.
Refer to the figure and table below for information on the configuration fields of the Secondary rules section.
[[File:Networking_rutos_manual_gps_avl_secondary_rules_{{{series}}}_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>off</b></td>
<td>Turns the secondary rule on or off.</td>
</tr>
<tr>
<td>WAN</td>
<td>Mobile Both | Mobile Home | Mobile Roaming | Wired; default: <b>Mobile Home</b></td>
<td>Selects which type of WAN will trigger the rule.</td>
</tr>
<tr>
<td>Ignore</td>
<td>off | on; default: <b>off</b></td>
<td>If enabled, the rule ignores state of input.</td>
</tr>
<tr>
<td>IO level</td>
<td>Low level {{!}} High level {{!}} Both; default: <b>High level</b></td>
<td>Selects which input state will trigger the rule.</td>
</tr>
<tr>
<td>IO type</td>
<td>GPIO; default: <b>GPIO</b></td>
<td>Selects input type.</td>
</tr>
<tr>
<td>IO name</td>{{#switch:{{{series}}}
| RUT9 =<td>Input (3) {{!}} Input (1) {{!}} Isolated Input (2,7); default: <b>Input (1)</b></td>
| RUTX =<td>Input (4); default: <b>Input (3)</b></td>
| TRB2 | TRB2M =<td>Configurable Input/Output (3) {{!}} Configurable Input/Output (4); default: <b>Configurable Input/Output (3)</b></td>}}
<td>Selects which specific input will trigger the rule.</td>
</tr>
<tr>
<td>Rule priority</td>
<td>Low priority level | High priority level | Panic priority level | Security priority level; default: High priority level</td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first. Priority levels from highest to lowest are as follows:
<ol>
<li>Security</li>
<li>Panic</li>
<li>High</li>
<li>Low</li>
</ol>
</td>
</tr>
<tr>
<td>Collect period</td>
<td>integer [1..999999]; default: '''10'''</td>
<td>How often (in seconds) data will be collected.</td>
</tr>
<tr>
<td>Min distance</td>
<td>integer [1..999999]; default: <b>25</b></td>
<td>Minimum distance change (in meters) before sending records.</td>
</tr>
<tr>
<td>Min angle</td>
<td>integer [1..360]; default: '''25'''</td>
<td>Minimum angle change (in degrees) before sending records.</td>
</tr>
<tr>
<td>Min accuracy</td>
<td>integer [1..999999]; default: <b>10</b></td>
<td>Minimum accuracy (in meters) required before saving record. The lower the accuracy value, the better.</td>
</tr>
<tr>
<td>Min saved records</td>
<td>integer [1..32]; default: '''10'''</td>
<td>Minimum amount of gathered records before sending.</td>
</tr>
<tr>
<td>Send period</td>
<td>integer [0..999999]; default: '''10'''</td>
<td>How often (in seconds) gathered data is sent.</td>
</tr>
</table>
===TAVL settings===
----
The <b>TAVL settings</b> section is used to select which data will be sent to the TAVL server:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rut955_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_trb245_manual_gps_https_tavl_settings.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
}}
{{#switch: {{{name}}}
| #default = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
</table>
| RUT955 | RUT956 | RUT906 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Iio</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Iio status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Acl0</td>
<td><span style="color: red;">Current {{!}} Percent</span>; off {{!}} on; default: <b><span style="color: red;">Current</span>; off</b></td>
<td>Includes Acl0 Current/Percent information in the GPS data sent to server.</td>
</tr>
</table>
| TRB245 | TRB246 | TRB255 | TRB256 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
</table>}}
==AVL I/O==
The <b>AVL I/O</b> tab provides you with the possibility to configure input rules.
===Input Rules===
----
The <b>Input Rules</b> section displays existing input rules. To create a new input rule click the 'Add' button.
[[File:Networking_rutos_manual_gps_avl_io_input_rules_add_button.png|border|class=tlt-border]]
After this you should be redirected to configuration page of the newly added rule, which should look similar to this:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration_rut955.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration_trb245.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>on</b></td>
<td>Turns the input rule on or off.</td>
</tr>
<tr>
<td>Input type</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 = <span style="color: red;">Analog Current Loop (6,9)</span> {{!}} <span style="color: blue;">Analog Input (6,9)</span> {{!}} Input (3) {{!}} Digital Input (1) {{!}} Isolated Input (2,7); default: <b>Analog Current Loop (6,9)</b>| TRB245|TRB246|TRB255|TRB256 = <span style="color: red;">Analog Input (11)</span> {{!}} Configurable Input/Output (2) {{!}} Configurable Input/Output (3) {{!}} Configurable Input/Output (4); default: <b>Analog Input (11)</b>| #default = Input (3); default: <b>Input (3)</b>}}</td>
<td>Select type on your own intended configuration.</td>
</tr>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 =
<tr>
<td><span style="color: red;">ACL Property</span></td>
<td>Current {{!}} Percent; default: <b>Current</b></td>
<td>Select which property - ampere or percentage the condition listens to.</td>
</tr>
<tr>
<td><span style="color: red;">Min current</span></td>
<td>float [4..20]; default: <b>none</b></td>
<td>Specifies minimum current of the range. Values between 4-20mA.</td>
</tr>
<tr>
<td><span style="color: red;">Max current</span></td>
<td>float [4..20]; default: <b>none</b></td>
<td>Specifies maximum current of the range. Values between minimum-20mA.</td>
</tr>
<tr>
<td><span style="color: blue;">Min voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify minimum voltage range.</td>
</tr>
<tr>
<td><span style="color: blue;">Max voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify maximum voltage range.</td>
</tr>| TR245|TRB246|TRB255|TRB256 =
<tr>
<td><span style="color: red;">Min voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify minimum voltage range.</td>
</tr>
<tr>
<td><span style="color: red;">Max voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify maximum voltage range.</td>
</tr>| #default =}}
<tr>
<td>Trigger</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 = <span style="color: red;">Inside range</span> {{!}} <span style="color: red;">Outside range</span>; <span style="color: blue;">Inside range</span> {{!}} <span style="color: blue;">Outside range; </span> Input active {{!}} Input low {{!}} Both; default: <b><span style="color: red;">Inside range</span>; <span style="color: blue;">Inside range</span>; Input active</b>|TRB245|TRB246|TRB255|TRB256 = <span style="color: red;">Inside range</span> {{!}} <span style="color: red;">Outside range; </span> Input active {{!}} Input low {{!}} Both; default: <b><span style="color: red;">Inside range</span>; Input active</b>|#default = Input active {{!}} Input low {{!}} Both; default: <b>Input active</b>}}</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906|TRB245|TRB246|TRB255|TRB256=<span style="color: red;">Inside range - Input voltage falls in the specified region, Outside range - Input voltage drops out of the specified region</span>; Select trigger event for your own intended configuration.|#default = Select trigger event for your own intended configuration.}}</td>
</tr>
<tr>
<td>Priority</td>
<td>Low | High | Panic | Security; default: <b>Low</b></td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first.</td>
</tr>
</table>
==GPS Geofencing==
A <b>geofence</b> is a virtually defined boundary for a real-world geographic area. The GPS Geofencing page provides you with the possibility to set this custom area and apply rules that will inform you when the device leaves or enters the geofence.
To create a new geofence area, enter a custom name for it and click the 'Add' button. A new geofence area configuration with the given name should appear in the "Geofencing" list. Click the button that looks like a pencil next to it to begin editing.
The figure below is an example of GPS Geofencing configuration and the table below provides information related to that configuration:
[[File:Networking_rutos_manual_gps_gps_geofencing_geofencing_details_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>off</b></td>
<td>Turns the Geofence rule on or off.</td>
</tr>
<tr>
<td>Longitude (X)</td>
<td>degrees [-180.000000..180.000000]; default: <b>0.000000</b></td>
<td>East-west position of a point on the Earth's surface. Combining this and the Latitude information will produce a point on the world map that will serve as the center of the geofence area.</td>
</tr>
<tr>
<td>Latitude (Y)</td>
<td>degrees [-90.000000..90.000000]; default: <b>0.000000</b></td>
<td>North-south position of a point on the Earth's surface. Combining this and the Longitude information will produce a point on the world map that will serve as the center of the geofence area.</td>
</tr>
<tr>
<td>Radius</td>
<td>integer [1..999999]; default: <b>200</b></td>
<td>Radius (in meters) of the geofence area.</td>
</tr>
<tr>
<td>Generate event on</td>
<td>Exit | Enter | Enter/exit; default: <b>Exit</b></td>
<td>Specifies whether the rule should be triggered when the device enters the geofence area, leaves it or on both events.</td>
</tr>
<tr>
<td>Switch profile</td>
<td>configuration profiles; default: <b>none</b></td>
<td>Selects a profile to switch to on this geofencing event.</td>
</tr>
<tr>
<td>Get current coordinates</td>
<td>- (interactive button)</td>
<td>Obtains the device's current coordinates and places them in the Longitude and Latitude fields.</td>
</tr>
</table>
[[Category:{{{name}}} Services section]]
| series = {{{series}}}
| name = {{{name}}}
| fw_version ={{Template: Networking_device_manual_latest_fw
| series = {{{series}}}
| name = {{{name}}}
}}
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} GPS (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
==Summary==
The <b>Global Positioning System</b> (<b>GPS</b>) is a space-based radionavigation system. This page is an overview of the GPS service in {{{name}}} devices.
==General==
The <b>General</b> is used to enable the GPS service and the support for different types satellites. Once you turn on GPS, you can check the [[{{{name}}}_GPS#Map|Map]] page in order to see if the device has obtained a GPS fix. It is very important to attach the GPS antenna on the device and place it outside (not inside of a building). The device will not be likely to obtain a GPS fix otherwise.
The figure below is an example of the General page and the table below provides information on the fields contained in that page:
{{#switch: {{{name}}}
| RUT906 | RUT956 | RUT955 = [[File:Networking_rutos_manual_gps_general_rut906.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_general_v2.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns the GPS service on or off.</td>
</tr>{{#switch: {{{name}}} | RUT906 | RUT956 = | #default =
<tr>
<td>DPO enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Enable dynamic power optimization (requires modem reboot). <b>This function is not supported on devices with Meig modems or Quectel BG95 modem</b> </td>
</tr>
<tr>
<td>Galileo NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for Galileo satellites on or off.</td>
</tr>
<tr>
<td>Glonass NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for Glonass satellites on or off.</td>
</tr>
<tr>
<td>BeiDou NMEA support<span class="asterisk">*</span></td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns support for BeiDou satellites on or off.</td>
</tr>}}
</table>
<span class="asterisk">*</span>Changing these options requires a modem reboot. Therefore, if you make changes to these options and save them, the device will lose cellular connectivity for about 30 seconds.
==Map==
The <b>Map</b> page displays the device's current coordinates and position on the map. To see the device's location on the map, make sure to attach the GPS antenna on the device and enable GPS in the [[#General|General]] page.
The figure below is an example of the Map page:
[[File:Networking_rutos_manual_gps_map_v3.png|border|class=tlt-border]]
==NMEA==
The <b>NMEA</b> page is used to configure settings related to NMEA sentence collecting and forwarding.
===NMEA forwarding===
----
The <b>NMEA forwarding</b> section is used to configure and enable NMEA forwarding. The figure below is an example of the NMEA forwarding section and the table below provides information on the fields contained in that section:
[[File:Networking rutos manual gps nmea nmea forwarding v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Turns NMEA forwarding on or off.</td>
</tr>
<tr>
<td>Hostname</td>
<td>ip | host; default: '''none'''</td>
<td>IP address or hostname of the server to which NMEA data will be forwarded.</td>
</tr>
<tr>
<td>Protocol</td>
<td>TCP | UDP; default: <b>TCP</b></td>
<td>Protocol that will be used to send NMEA data.</td>
</tr>
<tr>
<td>Port</td>
<td>integer [0..65535]; default: <b>8500</b></td>
<td>Port number off the server to which NMEA data will be forwarded.</td>
</tr>
<tr>
<td>Contain connection</td>
<td>off | on; default: <b>off</b></td>
<td>Contains active session with the remote server if turned on.</td>
</tr>
<tr>
<td>Select prefix</td>
<td>Custom | None |Serial | Mac address | IMEI; default: <b>None</b></td>
<td>Prefix is added to the NMEA sentence before it is transmitted. </td>
</tr>
</table>
===NMEA forwarding cache===
----
The device <b>caches NMEA forwarding</b> information if NMEA forwarding is enabled. This section is used to select the memory type where the cache will be stored and the maximum amount of data that will be saved:
[[File:Networking_rutos_manual_gps_nmea_nmea_forwarding_cache.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Save cache in</td>
<td>RAM Memory | FLASH Memory; default: <b>RAM Memory</b></td>
<td>Selects which type of memory will be used for storing NMEA forwarding cache.</td>
</tr>
<tr>
<td>Maximum sentences</td>
<td>integer; default: <b>5000</b></td>
<td>Maximum amount of NMEA sentences that will be saved in the cache before older entries are deleted and replaced by new ones.</td>
</tr>
<tr>
<td>File</td>
<td>filepath; default: <b>none</b></td>
<td>Location of the file where NMEA forwarding cache information will be stored. This field becomes visible only when the selected memory type is "flash".</td>
</tr>
</table>
===NMEA collecting===
----
The <b>NMEA collecting</b> section is used to enable NMEA sentence gathering and storing. The figure below is an example of the NMEA collecting section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_nmea_nmea_collecting_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: '''off'''</td>
<td>Turns NMEA sentence collecting on or off.</td>
</tr>
<tr>
<td>File</td>
<td>filepath; default: <b>none</b></td>
<td>Location of the file where NMEA sentences will be stored. This field becomes visible only when NMEA collecting is enabled.</td>
</tr>
</table>
===NMEA sentence settings===
----
The <b>NMEA sentence settings</b> section provides the possibility to configure which NMEA sentences will be forwarded or collected and at what frequency. The figure below is an example of the NMEA sentence settings section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_nmea_nmea_sentence_settings.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Forwarding enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Enables forwarding for the adjacent NMEA sentence.</td>
</tr>
<tr>
<td>Forwarding interval</td>
<td>positive integer; default: <b>5</b></td>
<td>NMEA sentence forwarding frequency in seconds.</td>
</tr>
<tr>
<td>Collecting enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Enables collecting for the adjacent NMEA sentence.</td>
</tr>
<tr>
<td>Collecting interval</td>
<td>positive integer; default: <b>5</b></td>
<td>NMEA sentence collecting frequency in seconds.</td>
</tr>
</table>
<br>
<b>NMEA sentence reference table</b>:
<table class="nd-othertables_3">
<tr>
<th width="250">NMEA sentence name</th>
<th width="902">Description</th>
</tr>
<tr>
<td><b>GPGSV</b></td>
<td>Number of GPS satellites in view.</td>
</tr>
<tr>
<td><b>GPGGA</b></td>
<td>GPS fix data.</td>
</tr>
<tr>
<td><b>GPVTG</b></td>
<td>GPS track made good and speed relative to the ground.</td>
</tr>
<tr>
<td><b>GPRMC</b></td>
<td>Recommended minimum specific GPS/Transit data.</td>
</tr>
<tr>
<td><b>GPGSA</b></td>
<td>GPS DOP and active satellites.</td>
</tr>
<tr>
<td><b>GNGSA</b></td>
<td>GLONASS DOP and active satellites.</td>
</tr>
<tr>
<td><b>GLGSV</b></td>
<td>Number of GLONASS satellites in view.</td>
</tr>
<tr>
<td><b>GNGNS</b></td>
<td>GNSS position fix from more than one constellation (e.g., GPS + GLONASS).</td>
</tr>
<tr>
<td><b>GAGSV</b></td>
<td>Number of Galileo satellites in view.</td>
</tr>
<tr>
<td><b>GARMC</b></td>
<td>Recomended minimum specific for Galileo data.</td>
</tr>
<tr>
<td><b>GAGGA</b></td>
<td>Galileo fix data.</td>
</tr>
<tr>
<td><b>GAGSA</b></td>
<td>Galileo DOP and active satellites.</td>
</tr>
<tr>
<td><b>GAVTG</b></td>
<td>Galileo track made good and speed information relative to the ground.</td>
</tr>
<tr>
<td><b>PQGSV</b></td>
<td>Detailed satellite data (used in BeiDou and QZSS (Quectel Quirk) sentences).</td>
</tr>
<tr>
<td><b>PQGSA</b></td>
<td>Overall satellite data (used in BeiDou and QZSS (Quectel Quirk) sentences).</td>
</tr>
<tr>
<td><b>GBGSV</b></td>
<td>Detailed satellite data (used in BeiDou sentences).</td>
</tr>
<tr>
<td><b>GBGSA</b></td>
<td>BeiDou DOP and active satellites.</td>
</tr>
<tr>
<td><b>GQGSV</b></td>
<td>Detailed QZSS satellite data (QZSS regional GPS augmentation system (Japan)).</td>
</tr>
<tr>
<td><b>GQGSA</b></td>
<td>QZSS DOP and active satellites (QZSS regional GPS augmentation system (Japan)).</td>
</tr>
</table>
==HTTPS==
The <b>HTTPS</b> page can be used to configure data sending to an HTTP(S) server.
===HTTPS/HTTP server settings===
----
The HTTPS/HTTP Server Settings section is used to enable GPS data sending to an HTTP or HTTPS server.
[[File:Networking_rutos_manual_gps_https_server_settings_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Turns data sending to HTTP/HTTPS server on or off.</td>
</tr>
<tr>
<td>URL</td>
<td>url string; default: <b>none</b></td>
<td>URL of the remote server (ex. example.com/xxxx).</td>
</tr>
<tr>
<td>Interval</td>
<td>integer; default: <b>none</b></td>
<td>Interval on which collected NMEA sentences should be forwarded.</td>
</tr>
</table>
===TAVL settings===
----
The <b>TAVL settings</b> section is used to select which data will be sent to the TAVL server:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rut955_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_trb245_manual_gps_https_tavl_settings.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
}}
{{#switch: {{{name}}}
| #default = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
</table>
| RUT955 | RUT956 | RUT906 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Iio</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Iio status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Acl0</td>
<td><span style="color: red;">Current {{!}} Percent</span>; off {{!}} on; default: <b><span style="color: red;">Current</span>; off</b></td>
<td>Includes Acl0 Current/Percent information in the GPS data sent to server.</td>
</tr>
</table>
| TRB245 | TRB246 | TRB255 | TRB256 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
</table>}}
==AVL==
The <b>AVL</b> page is used to set up GPS data sending to an AVL server.
===AVL server settings===
----
The <b>AVL server settings</b> section is used to configure the main parameters of data sending to an AVL server. The figure below is an example of the AVL Server Settings section and the table below provides information on the fields contained in that section:
[[File:Networking_rutos_manual_gps_avl_avl_server_settings_v1.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enabled</td>
<td>off | on; default: <b>off</b></td>
<td>Turns data sending to AVL server on or off.</td>
</tr>
<tr>
<td>Retry on Fail</td>
<td>off | on; default: <b>off</b></td>
<td>Turn retries in case of a failed attempts on or off. When turned on, the device will try to send the same data to the server until the transmission is successful.</td>
</tr>
<tr>
<td>Hostname</td>
<td>ip | host; default: <b>192.168.0.1</b></td>
<td>IP address or hostname of an AVL server.</td>
</tr>
<tr>
<td>Protocol</td>
<td>TCP | UDP; Default: <b>TCP</b></td>
<td>Protocol that will be used for communication with the AVL server.</td>
</tr>
<tr>
<td>Port</td>
<td>integer [0..65535]; default: <b>8501</b></td>
<td>TCP/UDP port number of the AVL server to which the device will be connecting.</td>
</tr>
<tr>
<td>Don't Contain Connection</td>
<td>off | on; default: <b>off</b></td>
<td>When turned on, handles each AVL packet iteration as a new connection. When turned off, connects once and uses the same socket for future communication.</td>
</tr>
<tr>
<td>Static Navigation</td>
<td>off | on; default: <b>off</b></td>
<td>Stop collecting NMEA data if object is stationary. Ignores data when speed equals to 0 or same as previous coordinates (rounded to 4 decimals).</td>
</tr>
</table>
===Main rule===
----
The <b>Main rule</b> section defines how and when GPS data will be collected and sent to a specified AVL server. Refer to the figure and table below for information on the configuration fields of Main Rule.
[[File:Networking rutos manual gps avl main rule v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>on</b></td>
<td>Turns the main rule on or off.</td>
</tr>
<tr>
<td>Rule priority</td>
<td>Low priority level | High priority level | Panic priority level | Security priority level; default: <b>Low priority level</b></td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first. Priority levels from highest to lowest are as follows:
<ol>
<li>Security</li>
<li>Panic</li>
<li>High</li>
<li>Low</li>
</ol>
</td>
</tr>
<tr>
<td>Collect period</td>
<td>integer [1..999999]; default: <b>5</b></td>
<td>How often (in seconds) data will be collected.</td>
</tr>
<tr>
<td>Min distance</td>
<td>integer [1..999999]; default: <b>50</b></td>
<td>Minimum distance change (in meters) before sending records.</td>
</tr>
<tr>
<td>Min angle</td>
<td>integer [1..360]; default: <b>50</b></td>
<td>Minimum angle change (in degrees) before sending records.</td>
</tr>
<tr>
<td>Min accuracy</td>
<td>integer [1..999999]; default: <b>10</b></td>
<td>Minimum accuracy (in meters) required before saving record. The lower the accuracy value, the better.</td>
</tr>
<tr>
<td>Min saved records</td>
<td>integer [1..32]; default: <b>20</b></td>
<td>Minimum amount of gathered records before sending.</td>
</tr>
<tr>
<td>Send period</td>
<td>integer [0..999999]; default: '''60'''</td>
<td>How often (in seconds) gathered data is sent.</td>
</tr>
</table>
===Secondary rules===
----
The <b>Secondary rules</b> section provides you with the possibility to create additional data sending rules. The difference from the main rule is that the secondary rules only send data when the device uses a specified type of WAN and when the digital isolated output is in the specified state.
Refer to the figure and table below for information on the configuration fields of the Secondary rules section.
[[File:Networking_rutos_manual_gps_avl_secondary_rules_{{{series}}}_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>off</b></td>
<td>Turns the secondary rule on or off.</td>
</tr>
<tr>
<td>WAN</td>
<td>Mobile Both | Mobile Home | Mobile Roaming | Wired; default: <b>Mobile Home</b></td>
<td>Selects which type of WAN will trigger the rule.</td>
</tr>
<tr>
<td>Ignore</td>
<td>off | on; default: <b>off</b></td>
<td>If enabled, the rule ignores state of input.</td>
</tr>
<tr>
<td>IO level</td>
<td>Low level {{!}} High level {{!}} Both; default: <b>High level</b></td>
<td>Selects which input state will trigger the rule.</td>
</tr>
<tr>
<td>IO type</td>
<td>GPIO; default: <b>GPIO</b></td>
<td>Selects input type.</td>
</tr>
<tr>
<td>IO name</td>{{#switch:{{{series}}}
| RUT9 =<td>Input (3) {{!}} Input (1) {{!}} Isolated Input (2,7); default: <b>Input (1)</b></td>
| RUTX =<td>Input (4); default: <b>Input (3)</b></td>
| TRB2 | TRB2M =<td>Configurable Input/Output (3) {{!}} Configurable Input/Output (4); default: <b>Configurable Input/Output (3)</b></td>}}
<td>Selects which specific input will trigger the rule.</td>
</tr>
<tr>
<td>Rule priority</td>
<td>Low priority level | High priority level | Panic priority level | Security priority level; default: High priority level</td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first. Priority levels from highest to lowest are as follows:
<ol>
<li>Security</li>
<li>Panic</li>
<li>High</li>
<li>Low</li>
</ol>
</td>
</tr>
<tr>
<td>Collect period</td>
<td>integer [1..999999]; default: '''10'''</td>
<td>How often (in seconds) data will be collected.</td>
</tr>
<tr>
<td>Min distance</td>
<td>integer [1..999999]; default: <b>25</b></td>
<td>Minimum distance change (in meters) before sending records.</td>
</tr>
<tr>
<td>Min angle</td>
<td>integer [1..360]; default: '''25'''</td>
<td>Minimum angle change (in degrees) before sending records.</td>
</tr>
<tr>
<td>Min accuracy</td>
<td>integer [1..999999]; default: <b>10</b></td>
<td>Minimum accuracy (in meters) required before saving record. The lower the accuracy value, the better.</td>
</tr>
<tr>
<td>Min saved records</td>
<td>integer [1..32]; default: '''10'''</td>
<td>Minimum amount of gathered records before sending.</td>
</tr>
<tr>
<td>Send period</td>
<td>integer [0..999999]; default: '''10'''</td>
<td>How often (in seconds) gathered data is sent.</td>
</tr>
</table>
===TAVL settings===
----
The <b>TAVL settings</b> section is used to select which data will be sent to the TAVL server:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rut955_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_trb245_manual_gps_https_tavl_settings.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_https_tavl_settings_v2.png|border|class=tlt-border]]
}}
{{#switch: {{{name}}}
| #default = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
</table>
| RUT955 | RUT956 | RUT906 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Din2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Din2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Iio</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Iio status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Acl0</td>
<td><span style="color: red;">Current {{!}} Percent</span>; off {{!}} on; default: <b><span style="color: red;">Current</span>; off</b></td>
<td>Includes Acl0 Current/Percent information in the GPS data sent to server.</td>
</tr>
</table>
| TRB245 | TRB246 | TRB255 | TRB256 = <table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Signal</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes GSM signal strength information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio0 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio1</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio1 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Dio2</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Dio2 status information in the GPS data sent to server.</td>
</tr>
<tr>
<td>Adc0</td>
<td>off {{!}} on; default: <b>off</b></td>
<td>Includes Adc0 status information in the GPS data sent to server.</td>
</tr>
</table>}}
==AVL I/O==
The <b>AVL I/O</b> tab provides you with the possibility to configure input rules.
===Input Rules===
----
The <b>Input Rules</b> section displays existing input rules. To create a new input rule click the 'Add' button.
[[File:Networking_rutos_manual_gps_avl_io_input_rules_add_button.png|border|class=tlt-border]]
After this you should be redirected to configuration page of the newly added rule, which should look similar to this:
{{#switch: {{{name}}}
| RUT955 | RUT956 | RUT906 = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration_rut955.png|border|class=tlt-border]]
| TRB245 | TRB246 | TRB255 | TRB256 = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration_trb245.png|border|class=tlt-border]]
| #default = [[File:Networking_rutos_manual_gps_avl_io_input_rules_avl_input_rule_data_configuration.png|border|class=tlt-border]]}}
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>on</b></td>
<td>Turns the input rule on or off.</td>
</tr>
<tr>
<td>Input type</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 = <span style="color: red;">Analog Current Loop (6,9)</span> {{!}} <span style="color: blue;">Analog Input (6,9)</span> {{!}} Input (3) {{!}} Digital Input (1) {{!}} Isolated Input (2,7); default: <b>Analog Current Loop (6,9)</b>| TRB245|TRB246|TRB255|TRB256 = <span style="color: red;">Analog Input (11)</span> {{!}} Configurable Input/Output (2) {{!}} Configurable Input/Output (3) {{!}} Configurable Input/Output (4); default: <b>Analog Input (11)</b>| #default = Input (3); default: <b>Input (3)</b>}}</td>
<td>Select type on your own intended configuration.</td>
</tr>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 =
<tr>
<td><span style="color: red;">ACL Property</span></td>
<td>Current {{!}} Percent; default: <b>Current</b></td>
<td>Select which property - ampere or percentage the condition listens to.</td>
</tr>
<tr>
<td><span style="color: red;">Min current</span></td>
<td>float [4..20]; default: <b>none</b></td>
<td>Specifies minimum current of the range. Values between 4-20mA.</td>
</tr>
<tr>
<td><span style="color: red;">Max current</span></td>
<td>float [4..20]; default: <b>none</b></td>
<td>Specifies maximum current of the range. Values between minimum-20mA.</td>
</tr>
<tr>
<td><span style="color: blue;">Min voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify minimum voltage range.</td>
</tr>
<tr>
<td><span style="color: blue;">Max voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify maximum voltage range.</td>
</tr>| TR245|TRB246|TRB255|TRB256 =
<tr>
<td><span style="color: red;">Min voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify minimum voltage range.</td>
</tr>
<tr>
<td><span style="color: red;">Max voltage</span></td>
<td>float [0..40]; default: <b>none</b></td>
<td>Specify maximum voltage range.</td>
</tr>| #default =}}
<tr>
<td>Trigger</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906 = <span style="color: red;">Inside range</span> {{!}} <span style="color: red;">Outside range</span>; <span style="color: blue;">Inside range</span> {{!}} <span style="color: blue;">Outside range; </span> Input active {{!}} Input low {{!}} Both; default: <b><span style="color: red;">Inside range</span>; <span style="color: blue;">Inside range</span>; Input active</b>|TRB245|TRB246|TRB255|TRB256 = <span style="color: red;">Inside range</span> {{!}} <span style="color: red;">Outside range; </span> Input active {{!}} Input low {{!}} Both; default: <b><span style="color: red;">Inside range</span>; Input active</b>|#default = Input active {{!}} Input low {{!}} Both; default: <b>Input active</b>}}</td>
<td>{{#switch:{{{name}}}| RUT955|RUT956|RUT906|TRB245|TRB246|TRB255|TRB256=<span style="color: red;">Inside range - Input voltage falls in the specified region, Outside range - Input voltage drops out of the specified region</span>; Select trigger event for your own intended configuration.|#default = Select trigger event for your own intended configuration.}}</td>
</tr>
<tr>
<td>Priority</td>
<td>Low | High | Panic | Security; default: <b>Low</b></td>
<td>The rule's priority. Different priority settings add different flags to event packets, so they can be displayed differently in the receiving system. The device sends data of higher priority first.</td>
</tr>
</table>
==GPS Geofencing==
A <b>geofence</b> is a virtually defined boundary for a real-world geographic area. The GPS Geofencing page provides you with the possibility to set this custom area and apply rules that will inform you when the device leaves or enters the geofence.
To create a new geofence area, enter a custom name for it and click the 'Add' button. A new geofence area configuration with the given name should appear in the "Geofencing" list. Click the button that looks like a pencil next to it to begin editing.
The figure below is an example of GPS Geofencing configuration and the table below provides information related to that configuration:
[[File:Networking_rutos_manual_gps_gps_geofencing_geofencing_details_v2.png|border|class=tlt-border]]
<table class="nd-mantable">
<tr>
<th>Field</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>off | on; default: <b>off</b></td>
<td>Turns the Geofence rule on or off.</td>
</tr>
<tr>
<td>Longitude (X)</td>
<td>degrees [-180.000000..180.000000]; default: <b>0.000000</b></td>
<td>East-west position of a point on the Earth's surface. Combining this and the Latitude information will produce a point on the world map that will serve as the center of the geofence area.</td>
</tr>
<tr>
<td>Latitude (Y)</td>
<td>degrees [-90.000000..90.000000]; default: <b>0.000000</b></td>
<td>North-south position of a point on the Earth's surface. Combining this and the Longitude information will produce a point on the world map that will serve as the center of the geofence area.</td>
</tr>
<tr>
<td>Radius</td>
<td>integer [1..999999]; default: <b>200</b></td>
<td>Radius (in meters) of the geofence area.</td>
</tr>
<tr>
<td>Generate event on</td>
<td>Exit | Enter | Enter/exit; default: <b>Exit</b></td>
<td>Specifies whether the rule should be triggered when the device enters the geofence area, leaves it or on both events.</td>
</tr>
<tr>
<td>Switch profile</td>
<td>configuration profiles; default: <b>none</b></td>
<td>Selects a profile to switch to on this geofencing event.</td>
</tr>
<tr>
<td>Get current coordinates</td>
<td>- (interactive button)</td>
<td>Obtains the device's current coordinates and places them in the Longitude and Latitude fields.</td>
</tr>
</table>
[[Category:{{{name}}} Services section]]