Jump to content

TEST-DM: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:{{{model}}}]]
<!---This template works like this:
Use basic text and images everytime, BUT
for "Deactivate by:" parameter values - we maintain in this template a list of standard values, from which which you need to select and copy directly to your Auto Geofence settings page, as plain text, when invoking this template there.--->


This page lists SMS/GPRS commands for the {{{model}}} device.
[[Image:FM auto geofence.png|300px|right]]
'''Auto Geofence''' allows sending notifications if your tracker leaves/re-enters the last known stationary position. Auto Geofence does not require entering coordinates –it requires GNSS visibility.


General information:
'''Basic function''': when the tracker has stopped, ignition has been turned off, and “Activation Timeout” has passed, the device automatically creates a geozone of size “Radius” around the last known location. If the device leaves/re-enters this zone, it can send a record.
* A single SMS/GPRS command is limited to 160 characters.
* All commands are case-sensitive.
* GPRS commands require the [[Codec#Codec_12|Codec 12 protocol]].
* SMS/GPRS command functioning in Deep Sleep - because the GSM/GPRS module is disabled in Deep Sleep, the device will receive your SMS message only when it exists Deep Sleep (and GPRS commands will not be received at all).
==Command Syntax==
[[File:smsgprscommand_EXAMPLE.png|300px|right|alt=SMS/GPRS command example]]
'''Before all SMS/GPRS commands, enter the password OR a whitespace (when password is not set).'''


General command structure:
'''“Activation Timeout” has a second function. It works together with GNSS fix to indicate if the tracker moves after GNSS fix is lost:'''
<password><space><command><space><argument1><space><argument2>...
 
Examples:
When the geozone is created, and later these conditions are met:
* ''getinfo'' command, password "1234": <code>1234 getinfo</code>
* GNSS fix is lost;
* ''getinfo'' command, password not set: <code>&nbsp;getinfo</code> (note the whitespace before command)
* Movement is detected by Movement Source;
* ''readavl'' command, password "1234", single argument: <code>1234 readavl 69</code>
* Deactivation is not performed by the user;
* ''getparam'' command, password not set, multiple arguments: <code>&nbsp;getparam 2001;2002</code> (note the whitespace before command)
 
* ''setparam'' command, password "1234", multiple arguments with values: <code>1234 setparam 2001:wap;2002:user;2003:pass</code>
the tracker starts monitoring GNSS status for the duration of “Activation Timeout”. If GNSS fix is achieved – the timeout pauses and will continue again once all 3 conditions are satisfied. If GNSS fix is not achieved during “Activation Timeout” – the tracker sends an eventual record with AVL ID 175 and value 0 (regardless of if the vehicle moves from or stays in the geozone). This timeout can be reset by triggering “Deactivate by” source, or if movement stops when there is no GNSS fix.
'''''Note!''' In some Apple iOS devices, any whitespace in the beginning of a message is automatically removed under certain conditions. This may affect SMS parsing in the receiving device.''
 
==Command List==
'''Auto Geofence parameters''':
===Default Commands===
* Eventual Records - enable or disable Eventual Records functionality.
These are the default SMS/GPRS commands, applicable for most Teltonika devices.
* Generate Event – configures event generation on auto geofence entrance, exit, or in both cases.
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
* Activation timeout (s) - defines the delay between Ignition OFF and the creation of the auto geofence of size “Radius” around the tracker’s most recent position.
<tr>
* Radius (m) – sets the radius of the auto geofence.
<th style="width:20%; vertical-align: middle; text-align: left;">COMMAND</th>
* Deactivate by: - select deactivation source.
<th style="width:45%; vertical-align: middle; text-align: left;">DESCRIPTION</th>
* Send SMS to – selects the number from predefined list for notification.
<th style="width:35%; vertical-align: middle; text-align: left;">SYNTAX EXAMPLE</th>
* SMS Text -text of SMS to send.
</tr>
 
<tr>
'''Auto Geofence can be deactivated by:'''<br>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - allver|allver]]</td>
<!--- PASTE LIST OF PARAMETERS HERE --->
<td style="vertical-align: middle; text-align: left;">Returns information about device firmware and hardware.
</td>
<td style="vertical-align: middle; text-align: left;"><code>allver</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - battery|battery]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information about battery status. If battery is not present voltage and current will return zero value.</td>
<td style="vertical-align: middle; text-align: left;"><code>battery</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - cpureset|cpureset]]</td>
<td style="vertical-align: middle; text-align: left;">Restarts device.</td>
<td style="vertical-align: middle; text-align: left;"><code>cpureset</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - deleterecords|deleterecords]]</td>
<td style="vertical-align: middle; text-align: left;">Deletes all records inside device.</td>
<td style="vertical-align: middle; text-align: left;"><code>deleterecords</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - delkey|delkey]]</td>
<td style="vertical-align: middle; text-align: left;">Deletes current primary key.</td>
<td style="vertical-align: middle; text-align: left;"><code>syntax</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - delsecondkey|delsecondkey]]</td>
<td style="vertical-align: middle; text-align: left;">Deletes current recovery key.</td>
<td style="vertical-align: middle; text-align: left;"><code>delkey <old_keyword></code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - fwstats|fwstats]]</td>
<td style="vertical-align: middle; text-align: left;">Information regarding firmware update statistics.</td>
<td style="vertical-align: middle; text-align: left;"><code>fwstats</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getgps|getgps]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information string regarding GNSS.</td>
<td style="vertical-align: middle; text-align: left;"><code>getgps</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getimeiccid|getimeiccid]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information about modem IMEI and SIM CCID.</td>
<td style="vertical-align: middle; text-align: left;"><code>getimeiccid</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getimsi|getimsi]]</td>
<td style="vertical-align: middle; text-align: left;">Returns IMSI code of currently used SIM card.</td>
<td style="vertical-align: middle; text-align: left;"><code>getimsi</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getinfo|getinfo]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information string.</td>
<td style="vertical-align: middle; text-align: left;"><code>getinfo</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getops|getops]]</td>
<td style="vertical-align: middle; text-align: left;">Returns list of currently visible operators.</td>
<td style="vertical-align: middle; text-align: left;"><code>getops</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getparam|getparam]]</td>
<td style="vertical-align: middle; text-align: left;">Get configured parameter value.</td>
<td style="vertical-align: middle; text-align: left;"><code>getparam <param_id1>;<param_id2>;...</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getrecord|getrecord]]</td>
<td style="vertical-align: middle; text-align: left;">Generates a high priority record so force device to send all records to the server.</td>
<td style="vertical-align: middle; text-align: left;"><code>getrecord</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getstatus|getstatus]]</td>
<td style="vertical-align: middle; text-align: left;">Get status about device.</td>
<td style="vertical-align: middle; text-align: left;"><code>getstatus</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - getver|getver]]</td>
<td style="vertical-align: middle; text-align: left;">Returns code version, device IMEI, modem app version, RTC time, Init time, etc.</td>
<td style="vertical-align: middle; text-align: left;"><code>getver</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - ggps|ggps]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information about current date, time, speed, device coordinates and a link to Google Maps with current position.</td>
<td style="vertical-align: middle; text-align: left;"><code>ggps</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - readavl|readavl]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information string regarding AVL ID value.</td>
<td style="vertical-align: middle; text-align: left;"><code>readavl <AVL_ID></code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - setkey|setkey]]</td>
<td style="vertical-align: middle; text-align: left;">Set new or change current primary key.</td>
<td style="vertical-align: middle; text-align: left;"><code>setkey <old_keyword> <new_keyword></code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - setparam|setparam]]</td>
<td style="vertical-align: middle; text-align: left;">Change configurable parameter value.</td>
<td style="vertical-align: middle; text-align: left;"><code>setparam <param_id1>:<value>;<param_id2>:<value>;...</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - setsecondkey|setsecondkey]]</td>
<td style="vertical-align: middle; text-align: left;">Set new or change current recovery key.</td>
<td style="vertical-align: middle; text-align: left;"><code>setsecondkey <old_keyword> <new_keyword></code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - towingreact|towingreact]]</td>
<td style="vertical-align: middle; text-align: left;">Reactivates towing Detection scenario. Intended for use in case of a fake towing detection event.</td>
<td style="vertical-align: middle; text-align: left;"><code>towingreact</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - wdlog|wdlog]]</td>
<td style="vertical-align: middle; text-align: left;">Returns information about the recent watchdog events.</td>
<td style="vertical-align: middle; text-align: left;"><code>wdlog</code></td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - web_connect|web_connect]]</td>
<td style="vertical-align: middle; text-align: left;">Triggers FOTA service/connection.</td>
<td style="vertical-align: middle; text-align: left;"><code>web_connect</code></td>
</tr>
</table>

Latest revision as of 10:15, 29 January 2026


Auto Geofence allows sending notifications if your tracker leaves/re-enters the last known stationary position. Auto Geofence does not require entering coordinates –it requires GNSS visibility.

Basic function: when the tracker has stopped, ignition has been turned off, and “Activation Timeout” has passed, the device automatically creates a geozone of size “Radius” around the last known location. If the device leaves/re-enters this zone, it can send a record.

“Activation Timeout” has a second function. It works together with GNSS fix to indicate if the tracker moves after GNSS fix is lost:

When the geozone is created, and later these conditions are met:

  • GNSS fix is lost;
  • Movement is detected by Movement Source;
  • Deactivation is not performed by the user;

the tracker starts monitoring GNSS status for the duration of “Activation Timeout”. If GNSS fix is achieved – the timeout pauses and will continue again once all 3 conditions are satisfied. If GNSS fix is not achieved during “Activation Timeout” – the tracker sends an eventual record with AVL ID 175 and value 0 (regardless of if the vehicle moves from or stays in the geozone). This timeout can be reset by triggering “Deactivate by” source, or if movement stops when there is no GNSS fix.

Auto Geofence parameters:

  • Eventual Records - enable or disable Eventual Records functionality.
  • Generate Event – configures event generation on auto geofence entrance, exit, or in both cases.
  • Activation timeout (s) - defines the delay between Ignition OFF and the creation of the auto geofence of size “Radius” around the tracker’s most recent position.
  • Radius (m) – sets the radius of the auto geofence.
  • Deactivate by: - select deactivation source.
  • Send SMS to – selects the number from predefined list for notification.
  • SMS Text -text of SMS to send.

Auto Geofence can be deactivated by: