Jump to content

Conditions when device operation is prohibited: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Introduction==
==Introduction==


From evaluation branch 03.27.16.Rev.00 and also from 04.00.00.Rev.00 base firmware new feature has been implemented to prevent device from operating when it is being used in restricted countries.<br/>
From evaluation firmware version '''03.27.16.'''Rev.XX and also from '''04.00.00'''.Rev.XX base firmware version conditions are enabled to prevent device from operating when it is being used in restricted countries. Block diagram of the logic is presented in '''figure 1''':
In figure 1 block diagram of new logic is presented and it is presented below.


[[File:Fmbdeviceblockingtree.png|Figure 1 Block diagram of Countryblocking functionality|thumb|center]]
[[File:Fmbdeviceblockingtree.png|thumb|center|<div style="text-align:center;">Block diagram of logic ('''figure 1''')</div>]]
==Functionality description==
== Description ==
 
Device checks conditions to block or unblock device each 10 minutes starting from device initialization.


===Device Blocking===
===Device Blocking===
Device will automatically block itself when conditions will be met. All of the parameters are hardcoded and cannot be changed.<br>
Device will automatically stop operating when conditions will be met. Conditions are hardcoded and cannot be changed:<br>


1. Device starts using restricted Mobile Country Code (MCC). Not-Allowed operator list contains MCCs:
1. Device connects to operator with restricted Mobile Country Code (MCC) and blocking timestamp is reached.<br>
2. Restricted operator list contains MCCs:
   250 - Russian Federation
   250 - Russian Federation
   257 - Belarus
   257 - Belarus
Line 18: Line 16:
   368 - Cuba
   368 - Cuba
   467 - North Korea
   467 - North Korea
2. Restricted MCC is used for full 28 days. <br>
 
<br>
Device saves timestamp when device should be blocked (current timestamp + 28 days).<br>
<br>
<br>
There is possibility to reset this timestamp, to do so, device should stop detecting restricted MCC and spend full 7 days without connecting to it. If device have counted 10 days with banned MCC and stopped detecting it and to reset that time it has not been detecting banned MCC for 5 days and then again detected banned MCC, device will continue counting time before device block from 10 days as it is shown in '''figure 1.'''
28-Day Blocking Counter:
* When a device connects to a operator with restricted MCC (Mobile Country Code) it saves blocking timestamp (current timestamp + 28 days) and starts counter as depicted in '''figure 1''' flowchart. The counter tracks the cumulative number of days the device spends connected to an operator with restricted MCC
* If the device reaches 28 cumulative days of connection to to an operator with restricted MCC, it will be automatically blocked.
Resetting the Counter:
* To reset the counter and timestamp, the device must connect to a non-restricted MCC continuously for 7 uninterrupted days.
* If the device disconnects from operator with a non-restricted MCC or connects to operator with a restricted MCC during this 7-day reset period, the reset process fails, and the 28-day counter continues accumulating.
Example 1:
* The device spends 10 days connected to a operator with restricted MCC.
* It then disconnects for 5 days to to any operator with non-restricted MCC.
* Upon reconnecting to operator with the restricted MCC, the blocking counter resumes from 15 days (as the 7-day reset period was not met).
* If the device remains connected to operator with restricted MCC for an additional 13 days, the counter reaches 28 days, and the device will be blocked.
Example 2:
* The device spends 15 days connected to an operator with restricted MCC.
* It then connects to any operator with an operator with non-restricted MCC continuously for 7 uninterrupted days.
* In this case, the counter is fully reset to 0 days, and after device reconnects to an operator with restricted MCC counter will starts from day 0.
<br/>
<br/>
This 7 days “counter” works in same way, it is not counting days it saves timestamp when block timestamp should be reset.<br>
 
===Device Unblocking===
===Device Unblocking===
In order to unblock device, as it is shown in block diagram, device have to detect only allowed MCCs for full 7 days, have timesync and have SIM inserted. If this counter will be interrupted by founded banned MCC it will be reset.<br>
To unblock the device, as depicted in '''figure 1''' flowchart, the device must maintain a continuous connection to operators with non-restricted MCCs for a full 7 days. Additionally, the device must have an active time synchronization and an inserted SIM card. If the device connects to a restricted operator MCC during this period, the unblocking counter resets. <br>
<br>
 
This 7 days “counter” use same variable as 7days counter in device block part and it saves timestamp when device can be unblocked. In case if during this 7 days period conditions will be lost timestamp to unblock will be reset and user will have to fulfill conditions for full 7 days again.
<br/>
<br/>
===Operating Device in Blocked State===
===Operating Device in Blocked State===
<table class="nd-othertables" style="width: 100%;">
<table class="nd-othertables" style="width: 100%;">
Line 60: Line 73:
* Private/Business<br>
* Private/Business<br>
* Ignition update<br>
* Ignition update<br>
* Other SpecFW features<br>
* Sleep
* Sleep
</td>
</td>
Line 89: Line 101:
=== Firmware Upgrade/Downgrade Rules ===
=== Firmware Upgrade/Downgrade Rules ===


Firmware branches have specific restrictions:
Firmwares have specific restrictions:


; Firmware Branch 03.27.16
; Firmware release 03.27.16
* When a device is updated to '''03.27.16.Rev.00''' or a newer revision of this branch:
* When a device is updated to '''03.27.16.Rev.00''' or a newer revision:


1. Downgrade to a version below '''03.27.16.Rev.00''' is not allowed<br>
1. Downgrade to a version below '''03.27.16.Rev.00''' is not allowed<br>
2. Upgrades to other firmware branches other than '''03.27.16'''.Rev.XX and '''04.00.00.'''Rev.XX is not allowed<br>
2. Upgrades to newer revisions of '''03.27.16''' is allowed<br>
3. Upgrades to other firmware other than '''03.27.16'''.Rev.XX and '''04.00.00.'''Rev.XX is not allowed<br>
Note:
* Upgrading from '''03.27.16''' to '''04.00.00''' can only be done using the specific intermediate version: '''03.27.16.Rev.02'''


; Firmware Branch 04.00.00
; Firmware release 04.00.00
* When a device is updated to '''04.00.00.Rev.00''' or a newer revision of this branch:
* When a device is updated to '''04.00.00.Rev.00''' or a newer revision:


1. Downgrade to a version below '''04.00.00.Rev.00''' is not allowed<br>
1. Downgrade to a version below '''04.00.00.Rev.00''' is not allowed<br>
2. Upgrades to versions newer than '''04.00.00'''.Rev.XX are allowed<br>
2. Upgrades to newer versions than '''04.00.00.Rev.00''' is allowed<br>


; Firmware Upgrading Between Branches
* Upgrading from branch '''03.27.16''' to branch '''04.00.00''' can only be done using the specific intermediate version:
** From '''03.27.16.Rev.02''' to '''04.00.00.Rev.XX'''


===Pass through command===
===Pass through command===
In order to allow client to know the location of the vehicle in special cases, pass through for single command has been implemented. SMS/GPRS command “getgps” will be allowed to be sent every 10 minutes to get location of the device, when it is operating in Blocked state.
In order to allow client to know the location of the vehicle in special cases, pass through for single command has been implemented. SMS/GPRS command “getgps” will be allowed to be sent every 10 minutes to get location of the device, when it is operating in Blocked state.
<br>
<br>

Latest revision as of 17:43, 16 January 2025

Introduction

From evaluation firmware version 03.27.16.Rev.XX and also from 04.00.00.Rev.XX base firmware version conditions are enabled to prevent device from operating when it is being used in restricted countries. Block diagram of the logic is presented in figure 1:

Block diagram of logic (figure 1)

Description

Device Blocking

Device will automatically stop operating when conditions will be met. Conditions are hardcoded and cannot be changed:

1. Device connects to operator with restricted Mobile Country Code (MCC) and blocking timestamp is reached.
2. Restricted operator list contains MCCs:

  250 - Russian Federation
  257 - Belarus
  432 - Iran
  368 - Cuba
  467 - North Korea


28-Day Blocking Counter:

  • When a device connects to a operator with restricted MCC (Mobile Country Code) it saves blocking timestamp (current timestamp + 28 days) and starts counter as depicted in figure 1 flowchart. The counter tracks the cumulative number of days the device spends connected to an operator with restricted MCC
  • If the device reaches 28 cumulative days of connection to to an operator with restricted MCC, it will be automatically blocked.

Resetting the Counter:

  • To reset the counter and timestamp, the device must connect to a non-restricted MCC continuously for 7 uninterrupted days.
  • If the device disconnects from operator with a non-restricted MCC or connects to operator with a restricted MCC during this 7-day reset period, the reset process fails, and the 28-day counter continues accumulating.

Example 1:

  • The device spends 10 days connected to a operator with restricted MCC.
  • It then disconnects for 5 days to to any operator with non-restricted MCC.
  • Upon reconnecting to operator with the restricted MCC, the blocking counter resumes from 15 days (as the 7-day reset period was not met).
  • If the device remains connected to operator with restricted MCC for an additional 13 days, the counter reaches 28 days, and the device will be blocked.

Example 2:

  • The device spends 15 days connected to an operator with restricted MCC.
  • It then connects to any operator with an operator with non-restricted MCC continuously for 7 uninterrupted days.
  • In this case, the counter is fully reset to 0 days, and after device reconnects to an operator with restricted MCC counter will starts from day 0.


Device Unblocking

To unblock the device, as depicted in figure 1 flowchart, the device must maintain a continuous connection to operators with non-restricted MCCs for a full 7 days. Additionally, the device must have an active time synchronization and an inserted SIM card. If the device connects to a restricted operator MCC during this period, the unblocking counter resets.


Operating Device in Blocked State

Blocked Features Description
Record saving Device will stop saving periodic and eventual records. Prior to device blocking saved records will not be lost.
Record sending Device will not send any records to server. Prior saved records will be stored and sent once device is unblocked.
Periodic scenario update Various features will be stopped:
  • OBD/LVCAN
  • Output/Input controlling/reading
  • Geofencing
  • Trip
  • Ecodriving
  • GSM Jamming
  • GSM Jamming
  • GNSS Jamming
  • Fuel Consumption
  • Immobilizer
  • Overspeeding
  • Private/Business
  • Ignition update
  • Sleep
Sleep (Power Update) Sleep feature will be disabled as well as Charger update, OBD plug out notify and OBD unlocker. Since these tasks runs under Power Update task which is responsible for sleep.
Accelerometer Accelerometer reading will be stopped and accelerometer should not be initialized
IO element updating IO element values will not be updated
Accelerometer related scenarios Movement detection, crash detection etc.
BLE Sensors updating Updating of BLE sensors will be stopped


Firmware Upgrade/Downgrade Rules

Firmwares have specific restrictions:

Firmware release 03.27.16
  • When a device is updated to 03.27.16.Rev.00 or a newer revision:

1. Downgrade to a version below 03.27.16.Rev.00 is not allowed
2. Upgrades to newer revisions of 03.27.16 is allowed
3. Upgrades to other firmware other than 03.27.16.Rev.XX and 04.00.00.Rev.XX is not allowed
Note:

  • Upgrading from 03.27.16 to 04.00.00 can only be done using the specific intermediate version: 03.27.16.Rev.02
Firmware release 04.00.00
  • When a device is updated to 04.00.00.Rev.00 or a newer revision:

1. Downgrade to a version below 04.00.00.Rev.00 is not allowed
2. Upgrades to newer versions than 04.00.00.Rev.00 is allowed


Pass through command

In order to allow client to know the location of the vehicle in special cases, pass through for single command has been implemented. SMS/GPRS command “getgps” will be allowed to be sent every 10 minutes to get location of the device, when it is operating in Blocked state.