Difference between revisions of "Template:FMB GPRS settings"

From Wiki Knowledge Base | Teltonika GPS
 
(63 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
==GPRS Settings==
+
==GPRS Settings==  
−
GPRS Contex these settings define the main parameters for {{{model|FMB1YX}}}: GSM operator ''APN'' and GPRS ''Username'' and ''Password'' (optional – depending on operator).
+
[[File:GPRS 2.PNG|right]]
 +
These settings define the main parameters for {{{model|FMB1YX}}}. <br/ >
 +
GPRS Context:
 +
* Device ability to enable or disable GPRS connection.
 +
APN:
 +
*Access point name, a mandatory parameter which is used to connect to the internet (GPRS). Access Point Name is the name of a gateway between a mobile operator and the public internet. It can be obtained from your SIM card provider.
 +
APN Username:
 +
*Access point name username (optional – depending on operator)
 +
APN Password:
 +
*Access point name password (optional – depending on operator). <br>
 +
Limit connection errors:
 +
*When enabled (default option) device will try to open GPRS or socket and if it fails it will introduce additional delays on the next try. The delays are incremented based on the consecutive network errors received:
 +
1. No delays<br>
 +
2. 1 minute.<br>
 +
3. 1 minute.<br>
 +
4. 2 minutes.<br>
 +
5. 2 minutes.<br>
 +
6. 4 minutes.<br>
 +
7. 6 minutes.<br>
 +
8. 8 minutes.<br>
 +
9. 10 minutes.<br>
  
 +
Once 10 minutes is reached and if errors continue to occur the delay will not reset. When connection is succesful the delay resets. This feature is enabled for every socket and SIM1 or SIM2 (if available) GPRS context.
 +
 +
*When disabled (option introduced from 03.29.00.Rev.10 base firmware version) device will spam the network with GPRS or socket related network operations with no additional delays. This might introduce operators bans on some devices if the network signal quality is poor and device tries its best to connect to the network.
 +
GPRS Authentication:
 +
* Some operators use a specific type of authentification for GPRS sessions. It could be CHAP or PAP authentifications. In configurator's GPRS settings there are option to select which GPRS authentification could be used. Information about the APN details and authentification should be provided by your GSM operator. <br />
 
{{{txt_sim2|SIM1 and SIM2 ''GPRS Settings'' can be configured separately. }}}
 
{{{txt_sim2|SIM1 and SIM2 ''GPRS Settings'' can be configured separately. }}}
−
<br />
+
<br>
 
{{{auto_apn|
 
{{{auto_apn|
 +
[[File:Animation SMS.gif|Animation SMS.gif]]
 +
 
==Auto APN==
 
==Auto APN==
−
These settings allow the device to automatically search for APN information based on inserted SIM card. This feature is used form 03.25.15.Rev.32 and up, explained in more detail in [[Auto_APN_feature_for_FM_trackers|this page]].<br />
+
[[File:Auto APN Search.png|right]]
 +
Auto APN:
 +
*This feature allows the device to select the correct APN from integrated into the firmware APN database. After the tracker turns ON it will automatically search APN settings depending on the inserted SIM card.
 +
*This feature is used form 03.25.15.Rev.32 and up, explained in more detail in [[Auto_APN_feature_for_FM_trackers|this page]].
 +
*This feature can be disabled in the device configuration if the device GPRS settings are configured before installation or during installation of device.
 
}}}
 
}}}
−
==Transfer APN File==
+
 
−
APN file Upload / Download  
+
==Transfer APN File==  
 +
[[File:Transfer APN File .png|right]]
 +
APN file Upload / Download: <br />
 +
*Connect to the device using configurator and look for Transfer APN file section. Press the Upload button and locate your APN_list.bin file. (binary APN list can be named differently, make sure to use the correct file).
 +
*This transfer APN File option is valid from 03.25.15.Rev.32 and up.
 +
*The AutoAPN file comes with the device form the factory, but if the GPRS settings are configured before installation or during installation of device - APN file is not required.
 +
<br>
 +
==First Server Settings==
 +
[[Image:Example Server settings.png|right]]
 +
[[File:IP.png|right]]
 +
Domain:
 +
*Server or Domain adress, can be written either IP address or Domain.
 +
Port:
 +
*Server Port
 +
Protocol:
 +
*Defines GPRS data transport protocol,  used for data transfers – <span style="color:#F6A83E">TCP</span> or <span style="color:#F6A83E">UDP</span>. From the device side TCP and UDP work almost the same, only difference is that UDP doesn't need additional confirmation from the server side, that the data packet was received. TCP has that, and uses more network data for the confirmation. The desired data transfer protocol can be selected through the configurator.
 +
TLS encryption:
 +
*An additional option is the use of TLS encryption for sending records to the main server and backup server.
 +
[[File:Alert.png|left|30px|link=]] All the information in photos must not be used, just for demonstrational use only.
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
  
 
==Second Server Settings==
 
==Second Server Settings==
−
Backup server has 4 different modes:
+
[[File:Screenshot 9.png|right]]
 +
Second server has 4 different modes: <br>
 +
Disable:
 +
*Second server is not used.
 +
Backup:
 +
*Records are sent to second server if main server is not available (for example: device fails to open link with main server) or when main server response timeout has been reached 5 times in a row.
 +
Duplicate:
 +
*Records are sent to both servers (main and second), records are deleted from SD-card (or Flash storage) only if both servers confirmed that the records were received from device.
 +
EGTS:
 +
*Records are sent to both servers (main and second), records are sent to the backup server using the EGTS protocol. '''RNIS''' system is supported with EGTS protocol. ('''Relevant just in CIS Regions''')<br />
 +
Backup server Domain:
 +
*Server or Domain adress, can be written either IP address or Domain.
 +
Back up server Port:
 +
*Server Port
 +
Backup server Protocol:
 +
*Defines GPRS data transport protocol,  used for data transfers – <span style="color:#F6A83E">TCP</span> or <span style="color:#F6A83E">UDP</span>. From the device side TCP and UDP both protocols require a confirmation from the server to the device sent packets. However, data consumption will be less using UDP due to differences in the Network layer of TCP/UDP and also packet structure of Codec8 using UDP protocol. More information -[[Teltonika_Data_Sending_Protocols|here]].
  
−
*<span style="color:#F6A83E">Disable</span>: backup server is not used.
 
−
*<span style="color:#F6A83E">Backup</span>: 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.
 
−
*<span style="color:#F6A83E">Duplicate</span>: records are sent to both servers (main and backup), records are deleted from SD-card (or Flash storage) only if both servers accepted the records.
 
−
*<span style="color:#F6A83E">EGTS</span>: records are sent to both servers (main and backup), records are sent to the backup server using the EGTS protocol. '''RNIS''' system is supported with EGTS protocol.
 
  
−
Some operators use a specific type of authentication for GPRS sessions – CHAP or PAP. If any of these is used, APN should be entered as "chap:<APN>" or "pap:<APN>" respectively e.g. if the 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.<br/>{{{model|FMB1YX}}} the device will send the newest records first when <span style=color:#F6A83E>Newest</span> is selected in ''Records Settings'', 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.<br/>''Data Link Timeout'' is used to set termination timeout for the link between {{{model|FMB1YX}}} and AVL application. If {{{model|FMB1YX}}} has already sent all records it waits for the new records before closing the link (except for Deep Sleep mode, for more information refer to {{{ctrSleepModes|[[Template:FMB Sleep modes#Deep Sleep mode]]}}}). If new records are generated during the period of this timeout and the minimum count to send is reached, the records are sent to the AVL application. This option is useful when GSM operator charges for link activation.<br/>''Server Response Timeout'' is used to set a period of time waiting for the response from the server-side.<br/>
+
Encryption:
 +
*An additional option is the use of TLS encryption for sending records to the main server and backup server.
 +
[[File:Alert.png|left|30px|link=]] All the information in photos must not be used, just for demonstrational use only.
 +
<br>
  
 
==Records Settings==
 
==Records Settings==
−
{{{model|FMB1YX}}} device will send the newest records first when <span style="color:#F6A83E">Newest</span> is selected in ''Records Settings'', 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.<br />''Data Link Timeout'' is used to set termination timeout for link between {{{model|FMB1YX}}} and AVL application. If {{{model|FMB1YX}}} has already sent all records it waits for the new records before closing the link (except for Deep Sleep mode, for more information refer to {{{ctrSleepModes|[[Template:FMB Sleep modes#Deep Sleep mode]]}}}). If new records are generated during the period of this timeout and the minimum count to send is reached, the records are sent to the AVL application. This option is useful when GSM operator charges for link activation.<br />''Server Response Timeout'' is used to set a period of time waiting for the response from the server-side.
+
[[File:Record settings.png|right]]
−
<br><br>
+
Open Link Timeout:
−
'''ACK Type''' determines what method the device uses to receive confirmation from the server. <br>
+
*The parameter used to define a timeout between the fleet management device and the server. If the device has sent all records, device holds the link for duration of the confugured timeout. “Open link timeout” will refresh after device sends a new record. If there is a need to keep a constant link with a server, increasing the value of the parameter is needed.
−
'''AVL''' means that the device will expect an additional AVL message from the server,
+
Server Response Timeout:
−
'''TCP/IP''' means that the confirmation will be included in the TCP/IP layer and no additional message will be needed.
+
*Is used to set a period of time waiting for the response from the server-side. If there is no response from the server during the timeout, the device will close the link and according to device configuration resend the same packet.  
 +
[[File:Alert.png|left|20px|link=]] NOTE! If Data [[Codec|protocols]] are not implemented correctly, device will not send data correctly. <br>
 +
Network Ping Timeout:
 +
*Enables network ping after timeout to prevent link close by operator. For example, if the operator closes the active link after 15 minutes when no data is sent, you can set the "network ping" timeout to 10 minutes then the device sends a 0xFF byte to server to keep the link open. This functionality works only for Record and Backup Servers. '''Network Ping Timeout should be always lower than Open Link Timeout.'''
 +
Sort by:
 +
* Can be set either Newest or Oldest. For example if the Oldest is marked the device first will send the Oldest information, if Newest then Device will send the newest information. If the device had no connection (GSM or GPRS) due to bad coverage or being in an area with no signal. Device continues to save records into internal memory, once GSM and GPRS are recovered device will start sending saved data to server. In this example, if Oldest is configured - until newest data is seen on the server all of the oldest records have to be sent first. If Newest is configured - previous data and track won't be seen until newest data is sent first. If high priority on I/O parameters or Features are configured device will send the generated records with High Priority first.
 +
ACK Type:
 +
*Determines what method the device uses to receive confirmation from the server <span style="color:#F6A83E">TCP/IP</span> or <span style="color:#F6A83E">AVL</span>. <span style="color:#F6A83E">TCP/IP</span> means that the confirmation will be included in the TCP/IP layer and no additional message will be needed to acknowledge the record receiving. <span style="color:#F6A83E">AVL</span> means that the device will expect an additional AVL message from the server - according to the Data sending protocols described [[Codec|here]].
 +
 
  
 
{{{fota_web|
 
{{{fota_web|
 
==FOTA WEB Settings==
 
==FOTA WEB Settings==
 
[[File:Fotawebsets.png|right]]
 
[[File:Fotawebsets.png|right]]
−
These settings are used to configure FOTA WEB server connection parameters. ''Status'' enables or disables FOTA WEB functionality. The address and port number of the FOTA website are entered to ''Domain'' and ''Port'' fields. ''Period'' is used to set the timeout of repeat connections to the FOTA WEB server.
+
These settings are used to configure FOTA WEB server connection parameters. <br>
 +
Status:
 +
*Enables or disables FOTA WEB functionality. '''If FOTA WEB Status is set to "Disable" - the configuration will not be allowed to be uploaded into FOTA WEB.'''
 +
Domain:
 +
*The address of the FOTA website is entered to Domain field.
 +
Port:
 +
*The Port of the FOTA website is entered to Port field.
 +
Period:
 +
*Is used to set the timeout of repeat connections to the FOTA WEB server.<br>
  
−
From 03.27.XX firmware version, FOTA WEB connection period randomizer is added. The randomizer will choose a +-2.5 period for each connection. For example, then the connection period is set to 30 minutes, device with each connection will choose a new connection (from 27.5 min to 32.5 minutes). This also applies to the "web_connect" SMS/GRRS command. This has been implemented to ensure smoother operation of FOTA WEB services by spreading out large numbers of simultaneous device connections over a longer timeframe.
+
 +
[[File:Alert.png|left|80px|link=]]From 03.27.02 firmware version, FOTA WEB connection period randomizer is added. The randomizer will choose a +-2.5 period for each connection. For example, then the connection period is set to 30 minutes, device with each connection will choose a new connection (from 27.5 min to 32.5 minutes). This also applies to the "web_connect" SMS/GRRS command. This has been implemented to ensure smoother operation of FOTA WEB services by spreading out large numbers of simultaneous device connections over a longer timeframe.
 
}}}
 
}}}
  
Line 39: Line 124:
 
==TLS/DTLS==
 
==TLS/DTLS==
  
−
From 03.27.xx firmware version, TLS/DTLS functionality was implemented for FMB0YX, FMB9X0, FMB96X, FMB1YX, FMU1YX, FMM1YX, FMC1YX, FM30XY, FMB2YX, FMT100 device.  
+
From 03.27.02 firmware version, TLS/DTLS functionality was implemented for FMB0YX, FMB9X0, FMB96X, FMB1YX, FMU1YX, FMM1YX, FMC1YX, FM30XY, FMB2YX, FMT100 device.  
 
'''Note!''' Currently only TLS encryption functionality is fully implemented, if needed DTLS encryption is possible to implement.
 
'''Note!''' Currently only TLS encryption functionality is fully implemented, if needed DTLS encryption is possible to implement.
  
Line 47: Line 132:
  
 
===TLS/DTLS certificate generation===
 
===TLS/DTLS certificate generation===
−
 
 
Instructions cover how to generate an encryption certificate and how the device should be configured in order to send encrypted records into the client-server can be downloaded [[Media:FMBXX_TLSDTLS_encryption_configuration_v0.2.pdf|'''HERE''']]. <br>
 
Instructions cover how to generate an encryption certificate and how the device should be configured in order to send encrypted records into the client-server can be downloaded [[Media:FMBXX_TLSDTLS_encryption_configuration_v0.2.pdf|'''HERE''']]. <br>
 
'''Server configuration and encryption certificate implementation is mandatory from the client-server side!'''
 
'''Server configuration and encryption certificate implementation is mandatory from the client-server side!'''
 
}}}
 
}}}

Latest revision as of 10:40, 26 March 2024

GPRS Settings

GPRS 2.PNG

These settings define the main parameters for FMB1YX.
GPRS Context:

  • Device ability to enable or disable GPRS connection.

APN:

  • Access point name, a mandatory parameter which is used to connect to the internet (GPRS). Access Point Name is the name of a gateway between a mobile operator and the public internet. It can be obtained from your SIM card provider.

APN Username:

  • Access point name username (optional – depending on operator)

APN Password:

  • Access point name password (optional – depending on operator).

Limit connection errors:

  • When enabled (default option) device will try to open GPRS or socket and if it fails it will introduce additional delays on the next try. The delays are incremented based on the consecutive network errors received:

1. No delays
2. 1 minute.
3. 1 minute.
4. 2 minutes.
5. 2 minutes.
6. 4 minutes.
7. 6 minutes.
8. 8 minutes.
9. 10 minutes.

Once 10 minutes is reached and if errors continue to occur the delay will not reset. When connection is succesful the delay resets. This feature is enabled for every socket and SIM1 or SIM2 (if available) GPRS context.

  • When disabled (option introduced from 03.29.00.Rev.10 base firmware version) device will spam the network with GPRS or socket related network operations with no additional delays. This might introduce operators bans on some devices if the network signal quality is poor and device tries its best to connect to the network.

GPRS Authentication:

  • Some operators use a specific type of authentification for GPRS sessions. It could be CHAP or PAP authentifications. In configurator's GPRS settings there are option to select which GPRS authentification could be used. Information about the APN details and authentification should be provided by your GSM operator.

SIM1 and SIM2 GPRS Settings can be configured separately.

Animation SMS.gif

Auto APN

Auto APN Search.png

Auto APN:

  • This feature allows the device to select the correct APN from integrated into the firmware APN database. After the tracker turns ON it will automatically search APN settings depending on the inserted SIM card.
  • This feature is used form 03.25.15.Rev.32 and up, explained in more detail in this page.
  • This feature can be disabled in the device configuration if the device GPRS settings are configured before installation or during installation of device.


Transfer APN File

Transfer APN File .png

APN file Upload / Download:

  • Connect to the device using configurator and look for Transfer APN file section. Press the Upload button and locate your APN_list.bin file. (binary APN list can be named differently, make sure to use the correct file).
  • This transfer APN File option is valid from 03.25.15.Rev.32 and up.
  • The AutoAPN file comes with the device form the factory, but if the GPRS settings are configured before installation or during installation of device - APN file is not required.


First Server Settings

Example Server settings.png
IP.png

Domain:

  • Server or Domain adress, can be written either IP address or Domain.

Port:

  • Server Port

Protocol:

  • Defines GPRS data transport protocol, used for data transfers – TCP or UDP. From the device side TCP and UDP work almost the same, only difference is that UDP doesn't need additional confirmation from the server side, that the data packet was received. TCP has that, and uses more network data for the confirmation. The desired data transfer protocol can be selected through the configurator.

TLS encryption:

  • An additional option is the use of TLS encryption for sending records to the main server and backup server.
Alert.png

All the information in photos must not be used, just for demonstrational use only.






Second Server Settings

Screenshot 9.png

Second server has 4 different modes:
Disable:

  • Second server is not used.

Backup:

  • Records are sent to second server if main server is not available (for example: device fails to open link with main server) or when main server response timeout has been reached 5 times in a row.

Duplicate:

  • Records are sent to both servers (main and second), records are deleted from SD-card (or Flash storage) only if both servers confirmed that the records were received from device.

EGTS:

  • Records are sent to both servers (main and second), records are sent to the backup server using the EGTS protocol. RNIS system is supported with EGTS protocol. (Relevant just in CIS Regions)

Backup server Domain:

  • Server or Domain adress, can be written either IP address or Domain.

Back up server Port:

  • Server Port

Backup server Protocol:

  • Defines GPRS data transport protocol, used for data transfers – TCP or UDP. From the device side TCP and UDP both protocols require a confirmation from the server to the device sent packets. However, data consumption will be less using UDP due to differences in the Network layer of TCP/UDP and also packet structure of Codec8 using UDP protocol. More information -here.


Encryption:

  • An additional option is the use of TLS encryption for sending records to the main server and backup server.
Alert.png

All the information in photos must not be used, just for demonstrational use only.


Records Settings

Record settings.png

Open Link Timeout:

  • The parameter used to define a timeout between the fleet management device and the server. If the device has sent all records, device holds the link for duration of the confugured timeout. “Open link timeout” will refresh after device sends a new record. If there is a need to keep a constant link with a server, increasing the value of the parameter is needed.

Server Response Timeout:

  • Is used to set a period of time waiting for the response from the server-side. If there is no response from the server during the timeout, the device will close the link and according to device configuration resend the same packet.
Alert.png

NOTE! If Data protocols are not implemented correctly, device will not send data correctly.

Network Ping Timeout:

  • Enables network ping after timeout to prevent link close by operator. For example, if the operator closes the active link after 15 minutes when no data is sent, you can set the "network ping" timeout to 10 minutes then the device sends a 0xFF byte to server to keep the link open. This functionality works only for Record and Backup Servers. Network Ping Timeout should be always lower than Open Link Timeout.

Sort by:

  • Can be set either Newest or Oldest. For example if the Oldest is marked the device first will send the Oldest information, if Newest then Device will send the newest information. If the device had no connection (GSM or GPRS) due to bad coverage or being in an area with no signal. Device continues to save records into internal memory, once GSM and GPRS are recovered device will start sending saved data to server. In this example, if Oldest is configured - until newest data is seen on the server all of the oldest records have to be sent first. If Newest is configured - previous data and track won't be seen until newest data is sent first. If high priority on I/O parameters or Features are configured device will send the generated records with High Priority first.

ACK Type:

  • Determines what method the device uses to receive confirmation from the server TCP/IP or AVL. TCP/IP means that the confirmation will be included in the TCP/IP layer and no additional message will be needed to acknowledge the record receiving. AVL means that the device will expect an additional AVL message from the server - according to the Data sending protocols described here.


FOTA WEB Settings

Fotawebsets.png

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

  • Enables or disables FOTA WEB functionality. If FOTA WEB Status is set to "Disable" - the configuration will not be allowed to be uploaded into FOTA WEB.

Domain:

  • The address of the FOTA website is entered to Domain field.

Port:

  • The Port of the FOTA website is entered to Port field.

Period:

  • Is used to set the timeout of repeat connections to the FOTA WEB server.


Alert.png

From 03.27.02 firmware version, FOTA WEB connection period randomizer is added. The randomizer will choose a +-2.5 period for each connection. For example, then the connection period is set to 30 minutes, device with each connection will choose a new connection (from 27.5 min to 32.5 minutes). This also applies to the "web_connect" SMS/GRRS command. This has been implemented to ensure smoother operation of FOTA WEB services by spreading out large numbers of simultaneous device connections over a longer timeframe.


TLS/DTLS

From 03.27.02 firmware version, TLS/DTLS functionality was implemented for FMB0YX, FMB9X0, FMB96X, FMB1YX, FMU1YX, FMM1YX, FMC1YX, FM30XY, FMB2YX, FMT100 device. Note! Currently only TLS encryption functionality is fully implemented, if needed DTLS encryption is possible to implement.

Supported versions: 1.1/1.2

TLSDTLS.gif

TLS/DTLS certificate generation

Instructions cover how to generate an encryption certificate and how the device should be configured in order to send encrypted records into the client-server can be downloaded HERE.
Server configuration and encryption certificate implementation is mandatory from the client-server side!

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Template:FMB_GPRS_settings&oldid=97031"