Difference between revisions of "Template:FMB GPRS settings"
From Wiki Knowledge Base | Teltonika GPS
| (49 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, | + | *Access point name, mandatory parameter which is used connect to internet (GPRS) |
APN Username: | APN Username: | ||
*Access point name username (optional – depending on operator) | *Access point name username (optional – depending on operator) | ||
APN Password: | APN Password: | ||
| − | *Access point name password (optional – depending on operator) | + | *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. <br> | ||
| − | |||
GPRS Authentication: | GPRS Authentication: | ||
| − | * Some operators use a specific type of | + | * 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]] | ||
Auto APN: | Auto APN: | ||
| − | *This feature allows the device to select the correct APN from integrated into the firmware APN database. | + | *This feature allows the device to select the correct APN from integrated into the firmware APN database. Tracker after turning ON will automatically search APN settings depending on the inserted SIM card. |
| − | + | 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]]. | |
| − | |||
}}} | }}} | ||
==Transfer APN File== | ==Transfer APN File== | ||
[[File:Transfer APN File .png|right]] | [[File:Transfer APN File .png|right]] | ||
| − | APN file Upload / Download | + | 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. | |
| − | |||
| − | |||
<br> | <br> | ||
| + | <br> | ||
| + | |||
==First Server Settings== | ==First Server Settings== | ||
[[Image:Example Server settings.png|right]] | [[Image:Example Server settings.png|right]] | ||
| − | + | In the main destination server Domain and Port needs to be written, and allows setting the protocol used for data transfers – <span style="color:#F6A83E">TCP</span> or <span style="color:#F6A83E">UDP</span>. <br> 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> | |
| − | Domain | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | <br> | ||
<br> | <br> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
==Second Server Settings== | ==Second Server Settings== | ||
| Line 71: | Line 51: | ||
*Second server is not used. | *Second server is not used. | ||
Backup: | Backup: | ||
| − | *Records are sent to second server if main server is not available (for example | + | *Records are sent to second 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: | Duplicate: | ||
| − | *Records are sent to both servers (main and second), records are deleted from SD-card (or Flash storage) only if both servers | + | *Records are sent to both servers (main and second), records are deleted from SD-card (or Flash storage) only if both servers accepted the records. |
EGTS: | 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. | + | *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. <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> | ||
==Records Settings== | ==Records Settings== | ||
[[File:Record settings.png|right]] | [[File:Record settings.png|right]] | ||
| + | {{{model|FMB1YX}}} device will send the newest records first if <span style="color:#F6A83E">Newest</span> is selected in ''Records Settings'', and if <span style="color:#F6A83E">Oldest</span> is selected then it will sent Oldest records. <br> When <span style="color:#F6A83E">Newest</span> is selected it 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 /> | ||
| + | |||
Open Link Timeout: | Open Link Timeout: | ||
| − | * | + | *Is used to set termination timeout for link between {{{model|FMB1YX}}} and AVL application. <br> |
| + | 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: | Server Response Timeout: | ||
| − | *Is used to set a period of time waiting for the response from the server-side | + | *Is used to set a period of time waiting for the response from the server-side. |
| − | + | ||
Network Ping Timeout: | Network Ping Timeout: | ||
| − | *Enables network ping after timeout to prevent link close by operator. | + | *Enables network ping after timeout to prevent link close by operator. <br> |
| − | + | '''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: | Status: | ||
| − | *Enables or disables FOTA WEB functionality. | + | *Enables or disables FOTA WEB functionality. If the Status is enabled then it means that CFG can be uploaded to FOTA WEB. |
| − | Domain: | + | Domain Port: |
| − | *The address of the FOTA website | + | *The address and port number of the FOTA website are entered to ''Domain'' and ''Port'' fields. |
| − | Port | ||
| − | |||
Period: | Period: | ||
*Is used to set the timeout of repeat connections to the FOTA WEB server.<br> | *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. | |
| − | |||
}}} | }}} | ||
| Line 124: | Line 95: | ||
==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 13:48, 25 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
Auto APN:
- This feature allows the device to select the correct APN from integrated into the firmware APN database. Tracker after turning ON will automatically search APN settings depending on the inserted SIM card.
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 Server Settings
In the main destination server Domain and Port needs to be written, 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.
Second Server Settings
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 fails to open link) or when main server response timeout is reached successively 5 times.
Duplicate:
- Records are sent to both servers (main and second), 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 second), 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 if Newest is selected in Records Settings, and if Oldest is selected then it will sent Oldest records.
When Newest is selected it 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.
Open 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.
Network Ping Timeout:
- Enables network ping after timeout to prevent link close by operator.
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.
Domain Port:
- 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!
