View source for CONTINUOUS NETWORK CONNECTIVITY WITH AUTO TOP-UP FEATURE

==Introduction==

Many transport businesses are regulated by governments worldwide. For example, lorries must be equipped with digital tachographs so that the data is sent according to a schedule; E-TOLL, modern toll collection solutions, are governed and electronically charged. Reporting is being digitised and made mandatory at the government level. Given this, measures should be put in place to facilitate the ease of data transfer and ensure its stability.

==Solution description==
As most transport and logistics companies are controlled by public authorities, fleet owners are required to submit digital tachograph charts regularly based on strict rules. Failure to submit data on time will inevitably result in heavy fines. According to the UK government website GOV.UK, the maximum fine for failing to do so can reach up to £10,000 and as much as 2-year imprisonment!

In the case of E-TOLL, a GPS tracker sends information on the location of a vehicle, the data is processed in the payment collection system, and a local National Revenue Administration automatically taxes the vehicle or fleet owners respectively. For example, if the data is not submitted on time in Poland, a car owner has to pay a fine, which starts at €300 per violation, as stated on the Ministry of Finance website etoll.gov.pl.

But what happens if the data is used up or the mobile network SIM card expires? Of course, the tracking device will be disconnected from the GSM network and no data will be sent at all.

Fortunately, Teltonika Telematics has a practical solution to help corporate fleets avoid such needless fines and ensure that the SIM cards of GPS trackers are always connected to the GSM network.

Every single Teltonika vehicle GPS tracker has a placeholder for a plastic (regular) SIM card or a possibility to install an eSIM module. The SIM card or eSIM is part of the Teltonika [https://teltonika-gps.com/products/solutions/teltonika-connectivity-solution Global Connectivity Solution] and is used to connect to mobile networks, and the GPS device will be able to send and receive data to and from locations covered by the data plan.
[[File:Truphone_solution.png|left|frameless|700x700px]]
For example, the Teltonika Global Plan currently allows you to prevent roaming costs in 134 countries around the world and uses the same amount of data anywhere. But the fact is, any data plan has a limited number of megabytes, and if they are used up, a GPS tracker loses an access to the mobile network.

How it works - to keep SIM cards up and running continuously without physical and manual interference, we offer the convenient and practical Auto Top-Up feature. As the name implies, when properly set up, this function automatically renews the same data plan under the same conditions when the remaining amount of data has been used up to a specified limit. Thanks to it, fleet managers and business owners will not run into trouble if a SIM card plan data is nearly used up, or expiration term is around the corner but a person in charge has missed all the notifications, off duty, or simply forgot to top up the plan timely.

With the SIM card management IoT Platform, you can set up specific SIM cards to be topped up, choose notification rules (via email or SMS) when 90% or any other percentage of data is used up, or inform a person in charge that the last top-up has been depleted and there are no more of them left. As a result, there is no point to monitor the amount of data or the expiry date anymore, as automatic top-ups reduce the need for manual maintenance of the SIM cards, and fleet GPS trackers will always remain connected to the GSM network with no service interruptions.
==What you need for a solution?==

*Any [https://teltonika-gps.com/ru/products/vehicle-tracking/ '''FMx'''] device 
*The [https://teltonika-gps.com/ru/product/connectivity-solution/ '''GLOBAL CONNECTIVITY SOLUTION SIM card'''] in order to get data to your server
*[https://account.truphone.com/login?redirectUrl=https://iot.truphone.com/ '''IoT Platform'''] to manage SIM cards.<br />

==Installation==

Install the tracker according to [https://wiki.teltonika-gps.com/view/FMB130_First_Start#Mounting_recommendations mounting recommendations] as well (using the FMB130 device as an example).

Although devices have high gain antennas it’s important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts.

The main solution in this case is the automatic charging of traffic in the IoT platform. If the Truphone SIM card is not installed from the factory, then [https://wiki.teltonika-gps.com/view/FMB130_First_Start#How_to_insert_Micro-SIM_card install it yourself].


==Configuration==

==='''1. Prerequisites:'''===

====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB130_First_Start First start guide]====
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB130_Sleep_modes Sleep modes].====
====1.3. Activate on the [https://account.truphone.com/login?redirectUrl=https://iot.truphone.com/ IoT Platform] using the details provided by the sales manager.====
==='''2. CONTINUOUS NETWORK CONNECTIVITY WITH AUTO TOP-UP FEATURE configuration:'''===

1.    Navigate to the "Rules" menu and add a new Usage rule (Please refer to Picture 1)
[[File:AutoTopUp1.jpg|thumb|none|Picture 1. '''Rules menu'''|link=Special:FilePath/AutoTopUp1.jpg]]

2.    In the "Label" window enter Your preferred name. To distinguish different rules, in this example name is "Auto Top Up" (Please refer to Picture 2)
[[File:AutoTopUp2.jpg|thumb|none|Picture 2. '''Label'''|link=Special:FilePath/AutoTopUp2.jpg]]

3.    In the "Rule Triggers" select the following settings (Please refer to Picture 3):

* When — Data Usage.
* Of — Each SIM Card.
* Is greater than — In this example value is 490 MB, but it can be customized according to Your needs.
* Over the — Current Rate Plan
* Country/Network — Any Country/Network
[[File:AutoTopUp3.jpg|thumb|none|Picture 3. '''Rule Triggers'''|link=Special:FilePath/AutoTopUp3.jpg]]

4.    In SIM Card(s) window select "All SIM Cards" (Please refer to Picture 4)
[[File:AutoTopUp5.jpg|thumb|none|Picture 4. '''SIM Card(s)'''|link=Special:FilePath/AutoTopUp5.jpg]]

5.    In the Actions window select the rate plan that will be applied to the SIM card and <b>Uncheck</b> "Change next billing cycle" (Please refer to Picture 5)
[[File:AutoTopUp6.jpg|thumb|none|Picture 6. '''Actions'''|link=Special:FilePath/AutoTopUp6.jpg]]

6.    Select an email where the notification will be sent (Please refer to Picture 6)
[[File:AutoTopUp7.jpg|thumb|none|Picture 7. '''Notifications'''|link=Special:FilePath/AutoTopUp7.jpg]]
==Parsing information==

==='''1.Prerequisites:'''===

==== 1.1.  Open [https://wiki.teltonika-gps.com/view/Opening_TCP/UDP_port TCP/UDP port]====

==== 1.2.  Read Java parser  [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide first start guide]====

=== '''2. Parsing example:''' ===
{| class="nd-othertables_2" style="width:100%;"
|+
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
|-
| style="vertical-align: middle; text-align: center;" |000000000000004608010000017501DAF828010F0E4792209AC4FB00C200D70C0000F90D06EF01F00
01503C8004501F900B50005B6000342334D43000044000002F10000601A100000000000010000732E
|-
|} 


{| class="nd-othertables_2" style="width:100%;"
|+
! colspan="2" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet
|-
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |AVL Data Packet Part
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part
|-
| style="vertical-align: middle; text-align: center;" |Zero Bytes
| style="vertical-align: middle; text-align: center;" |00 00 00 00
|-
| style="vertical-align: middle; text-align: center;" |Data Field Length
| style="vertical-align: middle; text-align: center;" |00 00 00 D6
|-
| style="vertical-align: middle; text-align: center;" |Codec ID
| style="vertical-align: middle; text-align: center;" |08 (Codec 8)
|-
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |Timestamp
| style="vertical-align: middle; text-align: center;" |00 00 01 75 01 DA F8 28 (Wed Oct 07 06:58:49 UTC 2020)
|-
| style="vertical-align: middle; text-align: center;" |Priority
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |0F 0E 47 92
|-
| style="vertical-align: middle; text-align: center;" |Latitude
| style="vertical-align: middle; text-align: center;" |20 9A C4 FB
|-
| style="vertical-align: middle; text-align: center;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 C2
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 D7
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |0C
|-
| style="vertical-align: middle; text-align: center;" |Speed
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |Event IO ID
| style="vertical-align: middle; text-align: center;" |F9 (AVL ID: 249, Name: Jamming)
|-
| style="vertical-align: middle; text-align: center;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |0D
|-
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |06
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |EF (AVL ID: 239, Name: Ignition)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |F0  (AVL ID: 240, Name: Movement)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |15 (AVL ID: 21, Name: GSM Signal)
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |03
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |C8 (AVL ID: 200, Name: Sleep Mode)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |45 (AVL ID: 69, Name: GNSS Status)
|-
| style="vertical-align: middle; text-align: center;" |5'th IO Value
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| style="vertical-align: middle; text-align: center;" |F9 (AVL ID: 249, Name: Jamming)
|-
| style="vertical-align: middle; text-align: center;" |6'th IO Value
| style="vertical-align: middle; text-align: center;" |00 (0 – jamming stop, 1 – jamming start)
|-
| style="vertical-align: middle; text-align: center;" |N1 of Two Byte IO
| style="vertical-align: middle; text-align: center;" |05
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |B5 (AVL ID: 181, Name: GNSS PDOP)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 05
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |B6 (AVL ID: 182, Name: GNSS HDOP)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00 03
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |42 (AVL ID: 66, Name: External Voltage)
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |33 4D
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |43 (AVL ID: 67, Name: Battery Voltage)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |44 (AVL ID: 68, Name: Battery Current)
|-
| style="vertical-align: middle; text-align: center;" |5'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |N4 of Four Bytes IO
| style="vertical-align: middle; text-align: center;" |02
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |F1 (AVL ID: 241, Name: Active GSM Operator)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 00 60 1A
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |10 (AVL ID: 16, Name: Total Odometer)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00 00 00 00
|-
| style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
| style="vertical-align: middle; text-align: center;" |01
|-
| style="vertical-align: middle; text-align: center;" |CRC-16
| style="vertical-align: middle; text-align: center;" |00 00 73 2E
|-
|}


==Demonstration in platform==


WIALON: Open WIALON → open messages → push unit ( select your device) → choose the date from which to show the records → select message  (data messages) → push execute button and you will see all information.
[[File:Wialon_CONTINUOUS_NETWORK_CONNECTIVITY_WITH_AUTO_TOP-UP_FEATURE.png|left|frameless|1155x1155px]]

[[Category: Usage scenarios]]