Template:GPRS settings: Difference between revisions

Latest revision as of 08:05, 18 March 2026

GPRS Settings

APN - Access point name, mandatory parameter which is used connect to internet (GPRS).
APN Username - Access point username (optional – depending on operator).
APN password - Access point password (optional – depending on operator).

Some operators use specific type of authentication for GPRS session – CHAP or PAP. If any of these is used, APN should be entered as "chap:<APN>" or "pap:<APN>" respectively e.g. if operator is using APN "internet" with CHAP authentication, it should be entered as "chap:internet". Information about APN and authentication type should be provided by your GSM operator.

Server Settings

Domain - Server IP or DNS address.
Port - Server port.
Protocol -This section allows setting the protocol used for data transfers – TCP or UDP.
Encryption - option to enable sending records with encryption (TLS/DTLS).

Second Server Settings

Backup server settings can also be selected for Backup server.
Backup server has 3 different modes:

Disable - backup server is not used.
Backup - records are sent to backup server if main server is not available (for example fails to open link) or when main server response timeout is reached successively 5 times.
Duplicate - records are sent to both servers (main and backup), records are deleted from SD-card (or RAMS) only if both servers accepted the records.

Records Settings

Open Link Timeout - Parameter is used to set timeout of the link between the device and AVL server. If device has send all the records it waits for the new records before closing the link. If the new record is generated and the link is still open, it is sent to the server immediately without waiting for send period. If new records are generated during the period of this timeout and minimum count to send is reached, the records are sent to AVL application. This option is useful when GSM operator charges for link activation.
Response Timeout - Time period device waits for server response.
Network Ping Timeout - Enables network ping after timeout to prevent link close by the operator. If the value set to 0, it disables the functionality.
Sort by - Here X device will send the newest records first when Newest is selected, which is useful in cases when the most important parameter set is the most recent one, as a result other records will be sent right after the newest records are received by AVL application.
ACK Type - Possible to choose TCP/IP or AVL type
Permanent link - The permanent link feature is designed to establish a connection with the server and maintain a connection to facilitate access to and management of the device using GPRS commands. Connection with main server is initiated as soon as possible after device start. In case if device failed to establish connection with main server or connection was lost, then device tries to connect to backup server (if configured). If device has successfully connected to backup server, then device keeps working with backup server until connection is lost. After that all cycle is repeated if necessary. When Permanent link feature is enabled, then device does not take Open Link Timeout into account.


	Maximum value of the Open Link Timeout and Response Timeout should be 60 sec. We recommend to leave default value - 30 sec. for the best battery performance.

FOTA WEB Settings

These settings are used to configure FOTA WEB server connection parameters.

Status enables or disables FOTA WEB functionality.
Domain - Address of FOTA website.
Port - Port number of FOTA website.
Period - is used to set the timeout of repeat connections to the FOTA WEB server.

@@ Line 13: / Line 13: @@
 *<b>Domain</b> - Server IP or DNS address.
 *<b>Port</b> - Server port.
-*<b>Protocol</b> -This section allows setting the protocol used for data transfers – <span style=color:#F6A83E>TCP</span>,<span style=color:#F6A83E>UDP</span> or <span style=color:#F6A83E>MQTT</span>. <!--- FOR GH5200 and TFT100 ONLY --->
+*<b>Protocol</b> -This section allows setting the protocol used for data transfers – {{#ifeq: {{{model}}} |TFT100|<span style=color:#F6A83E>TCP</span>,<span style=color:#F6A83E>UDP</span> or <span style=color:#F6A83E>MQTT</span>.|<span style=color:#F6A83E>TCP</span> or <span style=color:#F6A83E>UDP</span>.}}
 *<b>Encryption</b> - option to enable sending records with encryption (TLS/DTLS).
 |}
@@ Line 49: / Line 49: @@
 *<b>Port</b> - Port number of FOTA website.
 *<b>Period</b> - is used to set the timeout of repeat connections to the FOTA WEB server.}}}
+{{#switch: {{{model}}}
+| TFT100 =
 ==MQTT Settings==
-{|style="width: 100%;"
+[[File:MQTT - AWS IoT Shadow.png|right]]
-|[[File:MQTT - AWS IoT Shadow.png|right]]
 *'''AWS IoT Shadow'''
 **<b>Device ID</b> - used when connecting to MQTT service. If left empty, device IMEI will be used.
-{|style="width: 100%;"
+[[File:MQTT - AWS IoT Custom.png|right]]
-|[[File:MQTT - AWS IoT Custom.png|right]]
 *'''AWS IoT Custom'''
 **<b>Data Topic </b> - Parameter should be renamed to the device IMEI.
 **<b>Commands Topic</b> - Name used to transfer commands from MQTT client to the device. It can be entered in format “IMEI/commands” but when configuring the MQTT client itself, the topic name for commands has to be entered.
 **<b>Device ID</b> -  Used when connecting to MQTT service. If left empty, device IMEI will be used.
-{|style="width: 100%;"
+[[File:MQTT - Azure.png|right]]
-|[[File:MQTT - Azure.png|right]]
 *'''Azure IoT'''
 **<b>MQTT Client Type</b> -  Selects MQTT client type, based on used IoT service.
@@ Line 68: / Line 70: @@
 **<b>Secondary SAS key</b> - Used for Azure authentication. Optional if using x509 authentication.
 **<b>SAS Policy Name</b> - Used for global keys. Optional if using x509 authentication.
+|#default =
+}}