2,378
edits
Changes
Template:FMB965 Accelerometer Features settings (view source)
Revision as of 08:58, 14 June 2024
, 14 JuneCreated page with "==Accelerometer Calibration== Calibration algorithm is used to recalculate accelerometer axes to represent vehicle‘s axes (see Picture below). Vehicles axes are as follows:..."
==Accelerometer Calibration==
Calibration algorithm is used to recalculate accelerometer axes to represent vehicle‘s axes (see Picture below). Vehicles axes are as follows:<br>
1. X is front.<br>
2. Y is left.<br>
3. Z is down.<br>
[[File:Vehicle axis.PNG.png|center|800px|Vehicle Axis]]
Once vehicle‘s axes are calculated, device is considered calibrated.<br>
<br>
'''Note:''' moving forward along any axis will generate negative values. This means acceleration will generate -X values, accordingly breaking will generate X values. Same goes for other axes. <br>
Configurable parameters can be found at [[{{{model|FMB1YX}}}_System_settings#Accelerometer_Auto_Calibration|System Settings Accelerometer Auto Calibration]]
Commands that can be used during calibration:<br>
<center>
{| class="wikitable"
|-
!Command!!Response!!Description
|-
|auto_calibrate:set||Yes||Request auto calibration task start
|-
|auto_calibrate:get||Yes||Request calibration info (time, ground vector, side vector)
|-
|auto_calibrate:clear||Yes||Request calibration clear from flash and stop calibration task
|-
|auto_calibrate:status||Yes||Request calibration status and calibration task status
|}
</center>
======Auto-calibration======
Auto calibration task is launched on one of these conditions (assume calibration is enabled in configuration):<br>
1. Every time device turns on, it checks whether it was previously calibrated and has calibration stored in flash. If device has no calibration in flash, auto calibration task is started.<br>
2. Device calibration was previously disabled by configuration and now is enabled.<br>
3. SMS “auto_calibrate:set” is received. Note: SMS response is sent after calibration has been acquired.<br>
This SMS triggers an SMS response to be sent. Response is sent when calibration is acquired. When 1 hour passes without successful calibration, failed SMS response is sent.<br>
4. Calibrated device’s mean axes of set interval differ more than set amount from desired (0,0,1) calibration is considered inaccurate. Calibration is deleted from flash and auto calibration task started.<br>
After auto calibration task has been started, it will go on indefinitely until satisfactory calibration is acquired.<br>
=====Data Required=====
Auto calibration needs to fill two buffers to calibrate the device:<br>
1. All accelerometer data – buffer which collects all data from accelerometer at 10Hz frequency. To fill this buffer set seconds of data samples are needed. When buffer is full, oldest data is dumped and new data is placed into the buffer.<br>
2. Straight accelerometer data – buffer which collects straight accelerations data from accelerometer at 10Hz frequency. To fill this buffer set seconds of data samples (set times Hz samples) are needed. When buffer is full, oldest data is dumped and new data is placed into the buffer. Algorithm rules to acquire these samples:<br>
2.1. GPS fix is present.<br>
2.2. Ignition is on.<br>
2.3. GPS speed is more than 5 km/h.<br>
2.4. GPS heading is equal to last GPS heading (+/-1 degree) at GPS sample rate 1Hz.<br>
2.5. GPS speed more then 5 km/h from last sample (accelerating).<br>
Once both buffers are full, auto calibration is attempted. If calibrated values pass calibration quality threshold, calculated calibration is written to flash as current calibration – device is calibrated. <br>
Note: If GPS fix is lost or ignition is turned off, buffers’ data is dumped and must be gathered from 0 again.<br>
At this point calibration is successfully ended as indication device sends an SMS/GPRS message with ''Device is calibrated, to recalibrate send:auto_calibrate:set.<br>''
''Note: SMS/GPRS message will be sent only if auto calibration functionality was triggered by SMS/GPRS message.''
For user convenience in case auto calibration functionality fails then notification message will be sent. For exact messages, check algorithm section.<br>
''Note: SMS/GPRS message will be sent only if auto calibration functionality was triggered by SMS/GPRS message.''
To get current calibration status ''auto_calibrate:get'' SMS/GPRS command must be sent to the device. If device is calibrated it will respond with ''Calibration state: calibrated'' or otherwise ''Calibration state: not calibrated''. Also this command returns saved Ground and Side vectors.<br>
=====Re-Calibration=====
When calibration is present, device checks for re-calibration every 60s indefinitely. Re-calibration requires fix and ignition to run also re-calibration is turned off when vehicle is stopped for more than 15s until conditions are satisfied again. When calibrated device’s mean axes of set interval(calibrated accelerometer data) differ more than set amount from desired (0,0,1) (perfect vehicle’s axes) calibration is considered inaccurate, or device’s position has changed and re-calibration is needed. Calibration is cleared from flash and auto calibration task is started.<br/>
Note: turning device around calibrated Z axis will not trigger re-calibration, after turning device around Z axis manual re-calibration is advised. After calibration if quality value is less than 0.80, calibration update functionality is run. Calibration update constantly tries calibrating device in background until 0.80 quality is reached. Calibration update functionality does not change calibration if calculated new calibration quality is less than 0.80.<br/>
{{{excessive_idling|
==Excessive Idling==
{{{pic_idling|[[Image:Idling.gif|right]]}}}
When vehicle stops for a specific amount of time the scenario is activated, a record will be generated and digital output status will be changed to 1 when configured. You can configure the time it takes to turn on this scenario (''Time to Stopped''). Scenario is activated until the vehicle starts moving (movement is detected only by the accelerometer) and keeps moving for an amount of time that is configured. You can configure the time it takes to turn off this scenario (''Time to Moving'')<br/>{{{dout|info}}}
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
}}}
{{{unplug_feature|
==Unplug Detection==
[[Image:Fmb120_unplug.png|right]]
An event will be generated when {{{model|FMB1YX}}} is unplugged from {{{txt_src|external power}}} or plugged back in again.
===Scenario settings===
* '''Disable''' - disable scenario.
* '''Low Priority''' - when low priority event is triggered, device '''makes additional record''' with indication of event cause.
* '''High Priority''' - module makes additional record with High priority flag and '''sends event packet immediately''' to the server by
'''GPRS'''.
* '''Panic Priority''' - triggers same actions as High priority, but if '''GPRS fails''', it sends AVL packet using '''SMS mode''' if SMS is enabled in [[FMB110_SMS/Call_settings#SMS_Data_Sending|SMS Data Sending]] settings.
===Eventual Records===
* '''Disable''' - scenario status value is sent in '''each AVL record'''.
* '''Enable''' - scenario status value is sent only in '''eventual AVL records'''.
===Unplug Detection mode===
* '''Simple''' - unplug detection according to '''external voltage only'''. Is used in cars where power voltage is not dependent on ignition (recommended).
* '''Advanced''' - unplug detection according to '''external votage''' and '''accelerometer'''. Is used in cars where power voltage is disconnected when ignition is switched off.}}}
==Towing Detection==
[[Image:Fmb120_towings.png|right|250px]]
''Towing Detection'' feature helps to inform the driver about unexpected car movement when it was parked. {{{model|FMB1YX}}} generates an event when car is being towed or lifted, for example, in a case of vehicle evacuation. {{{model|FMB1YX}}} activates towing function when following conditions are met:
# Ignition (configured Ignition Source) is OFF.
# ''Activation Timeout'' is reached.
When towing function is engaged {{{model|FMB1YX}}} monitors accelerometer data. If acceleration ''Threshold'' or ''Angle'' reach configured values for a configured ''Duration'', and Ignition is still OFF for a period of time that is longer than ''Event Timeout'', then an event is generated. When configured, ''Make Call To'' and ''Send SMS To'' functions make a call or send an SMS to a predefined phone number. Towing function will be reactivated after {{{model|FMB1YX}}} detects a change of Ignition state from ON to OFF.
<br><br><br><br><br><br><br>
==Crash Detection==
[[File:Crash Detection.PNG|right]]
[[Crash_trace|Click here to enter Crash Tracer data parsing page]]
If ''Crash Detection'' is enabled, it monitors acceleration on each axis which helps to detect an accident. ''Threshold'' and ''Duration'' values are set depending on the impact magnitude that is required to be detected. {{{model|FMT100}}} can detect events ranging between a slight tapping on the device and a severe accident.<br/>
If ''Crash Trace'' is disabled only one eventual crash record will be generated when ''Duration (ms)'' and ''Threshold (mg)'' values are exceeded. <br/>
If ''Crash Trace'' is enabled, {{{model|FMT100}}} will collect crash trace data with frequency defined by ''Trace ODR (Hz)'' parameter. Acceleration, GNSS and IO data monitoring duration during the crash event is defined by these parameters: <br/>
* ''Accel duration (s)''. Acceleration data duration can be set for up to 15 seconds before crash event and 15 seconds after; <br/>
* ''GNSS duration (s)''. GNSS data duration can be set for up to 30 seconds before crash event and 30 seconds after. <br/>
* ''IO duration (s)''. IO data duration can be set for up to 30 seconds before crash event and 30 seconds after. <br/>
There are three configurable Crash Trace modes:<br/>
'''Trace Full'''
* Data tracked: all GNSS and acceleration data <br/>
'''Trace Full with IO's'''
* Data tracked: all GNSS and acceleration data with IO's, configured in I/O settings as "Crash" parameter (see picture below) <br/>
[[File:Crash event input.png|thumb|none]]
'''Trace Changes'''
* Data tracked: GNSS and acceleration data, when acceleration values are changed by more then 50mG <br/><br/>
NOTE: with Crash Trace mode enabled, it is recommended to use ''Codec 8 Extended'' Data Protocol. This helps to optimize crash trace data sending from device to server.
[[File:Codec 8 Extended setting.png|thumb|none]]
Each record will have accurate timestamps in milliseconds. <br/>
[[Image:Fmb120_crash_trace.png|600px|none]]
==Crash Data Visualisation==
With Teltonika ''CrashDataVisualizer'' tool you can analyze crash trace data visually: determine impact to vehicle direction, view crash trace on the map, also see the change of mG and speed values during crash time period. CrashDataVisualizer is dedicated to work with TAVL application, it means that only crash trace log files exported from TAVL is compatible. To have ability to export crash trace log files, device must be configured to send data by Codec8E.
'''To start using CrashDataVisualizer'''<br />
Download and install TAVL (version 4.15.0.1 or later) + CrashDataVisualizer applications from here:<br />
''Link:'' https://drive.teltonika.lt/d/05369fc90d9744afb14f/<br />
''Password:'' TJEk24YApbRhWrQQ
'''To get crash data'''<br />
Login to TAVL application (please contact your Sales manager for TAVL login information).<br />
[[File:Crash data steps.png|thumb|left]]
In TAVL application:<br />
1. Go to Events<br />
2. Set the date of event<br />
3. Select the object you want to analyze<br />
4. Press "Crashes" button<br/><br/><br/><br/><br/><br/><br/><br/>
Crash event list window will show up. Press Download icon and save crash event file (.JSON).<br />
[[File:JSON download.png|thumb|none]]<br />
'''Viewing crash data in application'''<br />
Open CrashDataVisualizer application. Drag and Drop or Browse crash data file (.JSON).<br />
[[File:Crash Data Visualizer start screen.png|thumb|none]]
Use the Visualizer.<br />
[[File:Crash Data Visualizer main.png|thumb|none]]
==Motorcycle Fall Detection==
Description to be prepared.
Calibration algorithm is used to recalculate accelerometer axes to represent vehicle‘s axes (see Picture below). Vehicles axes are as follows:<br>
1. X is front.<br>
2. Y is left.<br>
3. Z is down.<br>
[[File:Vehicle axis.PNG.png|center|800px|Vehicle Axis]]
Once vehicle‘s axes are calculated, device is considered calibrated.<br>
<br>
'''Note:''' moving forward along any axis will generate negative values. This means acceleration will generate -X values, accordingly breaking will generate X values. Same goes for other axes. <br>
Configurable parameters can be found at [[{{{model|FMB1YX}}}_System_settings#Accelerometer_Auto_Calibration|System Settings Accelerometer Auto Calibration]]
Commands that can be used during calibration:<br>
<center>
{| class="wikitable"
|-
!Command!!Response!!Description
|-
|auto_calibrate:set||Yes||Request auto calibration task start
|-
|auto_calibrate:get||Yes||Request calibration info (time, ground vector, side vector)
|-
|auto_calibrate:clear||Yes||Request calibration clear from flash and stop calibration task
|-
|auto_calibrate:status||Yes||Request calibration status and calibration task status
|}
</center>
======Auto-calibration======
Auto calibration task is launched on one of these conditions (assume calibration is enabled in configuration):<br>
1. Every time device turns on, it checks whether it was previously calibrated and has calibration stored in flash. If device has no calibration in flash, auto calibration task is started.<br>
2. Device calibration was previously disabled by configuration and now is enabled.<br>
3. SMS “auto_calibrate:set” is received. Note: SMS response is sent after calibration has been acquired.<br>
This SMS triggers an SMS response to be sent. Response is sent when calibration is acquired. When 1 hour passes without successful calibration, failed SMS response is sent.<br>
4. Calibrated device’s mean axes of set interval differ more than set amount from desired (0,0,1) calibration is considered inaccurate. Calibration is deleted from flash and auto calibration task started.<br>
After auto calibration task has been started, it will go on indefinitely until satisfactory calibration is acquired.<br>
=====Data Required=====
Auto calibration needs to fill two buffers to calibrate the device:<br>
1. All accelerometer data – buffer which collects all data from accelerometer at 10Hz frequency. To fill this buffer set seconds of data samples are needed. When buffer is full, oldest data is dumped and new data is placed into the buffer.<br>
2. Straight accelerometer data – buffer which collects straight accelerations data from accelerometer at 10Hz frequency. To fill this buffer set seconds of data samples (set times Hz samples) are needed. When buffer is full, oldest data is dumped and new data is placed into the buffer. Algorithm rules to acquire these samples:<br>
2.1. GPS fix is present.<br>
2.2. Ignition is on.<br>
2.3. GPS speed is more than 5 km/h.<br>
2.4. GPS heading is equal to last GPS heading (+/-1 degree) at GPS sample rate 1Hz.<br>
2.5. GPS speed more then 5 km/h from last sample (accelerating).<br>
Once both buffers are full, auto calibration is attempted. If calibrated values pass calibration quality threshold, calculated calibration is written to flash as current calibration – device is calibrated. <br>
Note: If GPS fix is lost or ignition is turned off, buffers’ data is dumped and must be gathered from 0 again.<br>
At this point calibration is successfully ended as indication device sends an SMS/GPRS message with ''Device is calibrated, to recalibrate send:auto_calibrate:set.<br>''
''Note: SMS/GPRS message will be sent only if auto calibration functionality was triggered by SMS/GPRS message.''
For user convenience in case auto calibration functionality fails then notification message will be sent. For exact messages, check algorithm section.<br>
''Note: SMS/GPRS message will be sent only if auto calibration functionality was triggered by SMS/GPRS message.''
To get current calibration status ''auto_calibrate:get'' SMS/GPRS command must be sent to the device. If device is calibrated it will respond with ''Calibration state: calibrated'' or otherwise ''Calibration state: not calibrated''. Also this command returns saved Ground and Side vectors.<br>
=====Re-Calibration=====
When calibration is present, device checks for re-calibration every 60s indefinitely. Re-calibration requires fix and ignition to run also re-calibration is turned off when vehicle is stopped for more than 15s until conditions are satisfied again. When calibrated device’s mean axes of set interval(calibrated accelerometer data) differ more than set amount from desired (0,0,1) (perfect vehicle’s axes) calibration is considered inaccurate, or device’s position has changed and re-calibration is needed. Calibration is cleared from flash and auto calibration task is started.<br/>
Note: turning device around calibrated Z axis will not trigger re-calibration, after turning device around Z axis manual re-calibration is advised. After calibration if quality value is less than 0.80, calibration update functionality is run. Calibration update constantly tries calibrating device in background until 0.80 quality is reached. Calibration update functionality does not change calibration if calculated new calibration quality is less than 0.80.<br/>
{{{excessive_idling|
==Excessive Idling==
{{{pic_idling|[[Image:Idling.gif|right]]}}}
When vehicle stops for a specific amount of time the scenario is activated, a record will be generated and digital output status will be changed to 1 when configured. You can configure the time it takes to turn on this scenario (''Time to Stopped''). Scenario is activated until the vehicle starts moving (movement is detected only by the accelerometer) and keeps moving for an amount of time that is configured. You can configure the time it takes to turn off this scenario (''Time to Moving'')<br/>{{{dout|info}}}
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
}}}
{{{unplug_feature|
==Unplug Detection==
[[Image:Fmb120_unplug.png|right]]
An event will be generated when {{{model|FMB1YX}}} is unplugged from {{{txt_src|external power}}} or plugged back in again.
===Scenario settings===
* '''Disable''' - disable scenario.
* '''Low Priority''' - when low priority event is triggered, device '''makes additional record''' with indication of event cause.
* '''High Priority''' - module makes additional record with High priority flag and '''sends event packet immediately''' to the server by
'''GPRS'''.
* '''Panic Priority''' - triggers same actions as High priority, but if '''GPRS fails''', it sends AVL packet using '''SMS mode''' if SMS is enabled in [[FMB110_SMS/Call_settings#SMS_Data_Sending|SMS Data Sending]] settings.
===Eventual Records===
* '''Disable''' - scenario status value is sent in '''each AVL record'''.
* '''Enable''' - scenario status value is sent only in '''eventual AVL records'''.
===Unplug Detection mode===
* '''Simple''' - unplug detection according to '''external voltage only'''. Is used in cars where power voltage is not dependent on ignition (recommended).
* '''Advanced''' - unplug detection according to '''external votage''' and '''accelerometer'''. Is used in cars where power voltage is disconnected when ignition is switched off.}}}
==Towing Detection==
[[Image:Fmb120_towings.png|right|250px]]
''Towing Detection'' feature helps to inform the driver about unexpected car movement when it was parked. {{{model|FMB1YX}}} generates an event when car is being towed or lifted, for example, in a case of vehicle evacuation. {{{model|FMB1YX}}} activates towing function when following conditions are met:
# Ignition (configured Ignition Source) is OFF.
# ''Activation Timeout'' is reached.
When towing function is engaged {{{model|FMB1YX}}} monitors accelerometer data. If acceleration ''Threshold'' or ''Angle'' reach configured values for a configured ''Duration'', and Ignition is still OFF for a period of time that is longer than ''Event Timeout'', then an event is generated. When configured, ''Make Call To'' and ''Send SMS To'' functions make a call or send an SMS to a predefined phone number. Towing function will be reactivated after {{{model|FMB1YX}}} detects a change of Ignition state from ON to OFF.
<br><br><br><br><br><br><br>
==Crash Detection==
[[File:Crash Detection.PNG|right]]
[[Crash_trace|Click here to enter Crash Tracer data parsing page]]
If ''Crash Detection'' is enabled, it monitors acceleration on each axis which helps to detect an accident. ''Threshold'' and ''Duration'' values are set depending on the impact magnitude that is required to be detected. {{{model|FMT100}}} can detect events ranging between a slight tapping on the device and a severe accident.<br/>
If ''Crash Trace'' is disabled only one eventual crash record will be generated when ''Duration (ms)'' and ''Threshold (mg)'' values are exceeded. <br/>
If ''Crash Trace'' is enabled, {{{model|FMT100}}} will collect crash trace data with frequency defined by ''Trace ODR (Hz)'' parameter. Acceleration, GNSS and IO data monitoring duration during the crash event is defined by these parameters: <br/>
* ''Accel duration (s)''. Acceleration data duration can be set for up to 15 seconds before crash event and 15 seconds after; <br/>
* ''GNSS duration (s)''. GNSS data duration can be set for up to 30 seconds before crash event and 30 seconds after. <br/>
* ''IO duration (s)''. IO data duration can be set for up to 30 seconds before crash event and 30 seconds after. <br/>
There are three configurable Crash Trace modes:<br/>
'''Trace Full'''
* Data tracked: all GNSS and acceleration data <br/>
'''Trace Full with IO's'''
* Data tracked: all GNSS and acceleration data with IO's, configured in I/O settings as "Crash" parameter (see picture below) <br/>
[[File:Crash event input.png|thumb|none]]
'''Trace Changes'''
* Data tracked: GNSS and acceleration data, when acceleration values are changed by more then 50mG <br/><br/>
NOTE: with Crash Trace mode enabled, it is recommended to use ''Codec 8 Extended'' Data Protocol. This helps to optimize crash trace data sending from device to server.
[[File:Codec 8 Extended setting.png|thumb|none]]
Each record will have accurate timestamps in milliseconds. <br/>
[[Image:Fmb120_crash_trace.png|600px|none]]
==Crash Data Visualisation==
With Teltonika ''CrashDataVisualizer'' tool you can analyze crash trace data visually: determine impact to vehicle direction, view crash trace on the map, also see the change of mG and speed values during crash time period. CrashDataVisualizer is dedicated to work with TAVL application, it means that only crash trace log files exported from TAVL is compatible. To have ability to export crash trace log files, device must be configured to send data by Codec8E.
'''To start using CrashDataVisualizer'''<br />
Download and install TAVL (version 4.15.0.1 or later) + CrashDataVisualizer applications from here:<br />
''Link:'' https://drive.teltonika.lt/d/05369fc90d9744afb14f/<br />
''Password:'' TJEk24YApbRhWrQQ
'''To get crash data'''<br />
Login to TAVL application (please contact your Sales manager for TAVL login information).<br />
[[File:Crash data steps.png|thumb|left]]
In TAVL application:<br />
1. Go to Events<br />
2. Set the date of event<br />
3. Select the object you want to analyze<br />
4. Press "Crashes" button<br/><br/><br/><br/><br/><br/><br/><br/>
Crash event list window will show up. Press Download icon and save crash event file (.JSON).<br />
[[File:JSON download.png|thumb|none]]<br />
'''Viewing crash data in application'''<br />
Open CrashDataVisualizer application. Drag and Drop or Browse crash data file (.JSON).<br />
[[File:Crash Data Visualizer start screen.png|thumb|none]]
Use the Visualizer.<br />
[[File:Crash Data Visualizer main.png|thumb|none]]
==Motorcycle Fall Detection==
Description to be prepared.
