Difference between revisions of "Template:FMB GPRS settings"
From Wiki Knowledge Base | Teltonika GPS
| (54 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
==GPRS Settings== | ==GPRS Settings== | ||
| − | [[File:GPRS | + | [[File:GPRS.png|right]] |
These settings define the main parameters for {{{model|FMB1YX}}}. <br/ > | These settings define the main parameters for {{{model|FMB1YX}}}. <br/ > | ||
| − | GPRS | + | GPRS Contex can be selected disabled or enabled: |
* Device ability to enable or disable GPRS connection. | * Device ability to enable or disable GPRS connection. | ||
| − | APN: | + | * APN: Access point name, mandatory parameter which is used connect to internet (GPRS) |
| − | + | * APN Username: Access point name username (optional – depending on operator) | |
| − | APN Username: | + | * APN Password: Access point name password (optional – depending on operator) |
| − | + | Access Point Name is a gateway between mobile operator and public internet. | |
| − | APN Password: | + | It can be obtained from your SIM card provider. |
| − | + | <br> | |
| − | + | GPRS Authentication: | |
| − | * | + | * 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 /> |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{{{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| | ||
| − | |||
| − | |||
==Auto APN== | ==Auto APN== | ||
[[File:Auto APN Search.png|right]] | [[File:Auto APN Search.png|right]] | ||
| − | + | This setting allows the device to automatically search for APN information based on inserted SIM card. <br> 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> | ||
| + | ==Transfer APN File== | ||
| − | + | APN file Upload / Download <br /> [[File:Transfer APN File .png|right]] | |
| − | [[File:Transfer APN File .png|right]] | + | 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. |
| − | + | <br> | |
| − | |||
| − | |||
| − | |||
<br> | <br> | ||
| − | ==First Server Settings== | + | ==First and Second Server Settings== |
[[Image:Example Server settings.png|right]] | [[Image:Example Server settings.png|right]] | ||
| − | [[ | + | [[Image:Example IP Server settings.png|right]] |
| − | Domain: | + | In the main destination server Domain and Port needs to be inputted, and allows setting the protocol used for data transfers – <span style="color:#F6A83E">TCP</span> or <span style="color:#F6A83E">UDP</span>. An additional option is the use of TLS/DTLS encryption for sending records to the main server and backup server. Also in the Domain settings, can be written either IP address or Domain. <br> |
| − | + | ||
| − | + | Backup server has 4 different modes: | |
| − | * | + | |
| − | + | *<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. <br /> | |
| − | + | Domain and Port needs to be inputted, and allows setting the protocol used for data transfers – <span style="color:#F6A83E">TCP</span> or <span style="color:#F6A83E">UDP</span>. An additional option is the use of TLS/DTLS encryption for sending records to the main server and backup server. | |
<br> | <br> | ||
<br> | <br> | ||
| Line 64: | Line 44: | ||
<br> | <br> | ||
<br> | <br> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Records Settings== | ==Records Settings== | ||
[[File:Record settings.png|right]] | [[File:Record settings.png|right]] | ||
| − | + | {{{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. | |
| − | + | <br> | |
| − | Server Response Timeout | + | '''ACK Type''' determines what method the device uses to receive confirmation from the server. <br> |
| − | + | '''AVL''' means that the device will expect an additional AVL message from the server, | |
| − | + | '''TCP/IP''' means that the confirmation will be included in the TCP/IP layer and no additional message will be needed. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{{{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. | + | These settings are used to configure FOTA WEB server connection parameters. ''Status'' enables or disables FOTA WEB functionality. If the Status is enabled then it means that CFG can be uploaded to FOTA WEB. 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.<br> |
| − | Status | + | 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. |
| − | |||
| − | |||
| − | |||
| − | Port | ||
| − | |||
| − | Period | ||
| − | |||
| − | |||
| − | |||
| − | |||
}}} | }}} | ||
| Line 124: | Line 62: | ||
==TLS/DTLS== | ==TLS/DTLS== | ||
| − | From 03.27. | + | From 03.27.xx 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. | ||
Revision as of 12:32, 22 October 2021
GPRS Settings
These settings define the main parameters for FMB1YX.
GPRS Contex can be selected disabled or enabled:
- Device ability to enable or disable GPRS connection.
- APN: Access point name, mandatory parameter which is used connect to internet (GPRS)
- APN Username: Access point name username (optional – depending on operator)
- APN Password: Access point name password (optional – depending on operator)
Access Point Name is a gateway between mobile operator and public internet.
It can be obtained from your SIM card provider.
GPRS Authentication:
- 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.
SIM1 and SIM2 GPRS Settings can be configured separately.
Auto APN
This setting allows 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 this page.
Transfer APN File
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.
First and Second Server Settings
In the main destination server Domain and Port needs to be inputted, and allows setting the protocol used for data transfers – TCP or UDP. An additional option is the use of TLS/DTLS encryption for sending records to the main server and backup server. Also in the Domain settings, can be written either IP address or Domain.
Backup server has 4 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 Flash storage) only if both servers accepted the records.
- EGTS: 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.
Domain and Port needs to be inputted, and allows setting the protocol used for data transfers – TCP or UDP. An additional option is the use of TLS/DTLS encryption for sending records to the main server and backup server.
Records Settings
FMB1YX device will send the newest records first when Newest 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.
Data Link Timeout is used to set termination timeout for link between FMB1YX and AVL application. If 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 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.
Server Response Timeout is used to set a period of time waiting for the response from the server-side.
ACK Type determines what method the device uses to receive confirmation from the server.
AVL means that the device will expect an additional AVL message from the server,
TCP/IP means that the confirmation will be included in the TCP/IP layer and no additional message will be needed.
FOTA WEB Settings
These settings are used to configure FOTA WEB server connection parameters. Status enables or disables FOTA WEB functionality. If the Status is enabled then it means that CFG can be uploaded to FOTA WEB. 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.
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.
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. Note! Currently only TLS encryption functionality is fully implemented, if needed DTLS encryption is possible to implement.
Supported versions: 1.1/1.2
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!
