Difference between revisions of "Template:FMB Accelerometer Features settings"

From Wiki Knowledge Base | Teltonika GPS
(Replaced content with "{{Template:FMX Accelerometer Features settings}}")
Tag: Replaced
(92 intermediate revisions by 20 users not shown)
Line 1: Line 1:
−
{{Template:FMX Accelerometer Features settings}}
+
==Accelerometer Calibration==
 +
 
 +
Accelerometer auto calibration functionality has one purpose - determine how FMB device
 +
is mounted in a vehicle. After the calibration process ''eco driving'' functionality becomes active
 +
and calibration data will be used to determine harsh acceleration, braking and cornering events.<br/>
 +
There are two conditions when auto calibration takes place:<br/>
 +
* If on device startup no calibration was detected;
 +
* If the device receives an SMS/GPRS message with ''auto_calibrate:set'' text.<br/>
 +
After functionality has started FMB device periodically checks current appliance GNSS,
 +
ignition and movement source parameters and if the conditions match:<br/>
 +
* position fix got;
 +
* GNSS speed is zero;
 +
* ignition is ON;
 +
* first calibration vector was not saved yet;<br/>
 +
Then first vector is taken. Saved vector will be considered as ground vector and it will be
 +
used at further calibration calculations.<br/>
 +
''Note: When FMB device saves first ground vector vehicle must be parked on flat ground''.
 +
Crooked vector may have an impact on further calculations.<br/>
 +
Afterwards first ground vector was taken, device analyses conditions:<br/>
 +
* position fix got;
 +
* GNSS speed is at least 20 km/h;
 +
* ignition is ON;
 +
* second vector was not saved yet;
 +
* vehicle driving in the same direction with 5⁰ tolerance;
 +
* vehicle speed increase by 7km/h within 1 second.<br/>
 +
For next vector. Second vector will be taken if all conditions match. Immediately after
 +
second vector is received, it will be multiplied by first (ground) vector, the result of these
 +
vectors is vector multiplication cross product which is the right side of a car. By using
 +
same vector multiplication method, device front, left side will be calculated. 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''.<br/>
 +
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''.<br/>
 +
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/>
 +
After every TRIP START event, device starts shadow calibration. This type of calibration is
 +
running in parallel with already saved vectors (this means that vectors does not reset until
 +
shadow calibration have both new vectors). After shadow calibration is done, device updates the
 +
vector values to the new ones. There are two conditions when shadow calibration does not run
 +
at TRIP start event:<br/>
 +
* Normal calibration is still running.
 +
* Shadow calibration is still running from previous TRIP event.<br/>
 +
To take ground vector these conditions should be met:<br/>
 +
* Ignition is ON
 +
* Device got GPS FIX
 +
* Vehicle speed = 0km/h<br/>
 +
Device will check these conditions every 1sec until they will pass.<br/>
 +
To take side vector these conditions should be met:<br/>
 +
* Vehicle speed >= 20km/h
 +
* Device got GPS FIX
 +
* Ignition is ON
 +
* Device angle does not change more than 5 degrees in past 1 sec
 +
* Speed need to increase by 7km/h in 1s period.<br/>
 +
Device will check these conditions every 1 sec until they will pass.<br/>
 +
 
 +
==Excessive Idling==
 +
 
 +
{{{pic_idling|[[Image:Fmb120_excessive_idling.png|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/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
 +
 
 +
==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. User can select the detection type: <span style=color:#F6A83E>Simple</span>, which is used in cars where power voltage is not dependent on ignition (recommended); <span style=color:#F6A83E>Advanced</span>, which is used in cars where power voltage is disconnected when ignition is switched off.<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
 +
 
 +
{| class="wikitable" style="border-style: solid; border-width: 0px"
 +
|+
 +
|-
 +
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_nb.png|50px]]
 +
| style="text-align: left; background: #F6F6FB;"        | In ''Unplug Detection'' and ''Towing Detection'' scenarios if ''Eventual Records'' is enabled an event will be generated (included into the sent records) only when scenario starts and finishes. If ''Eventual Records'' is disabled scenario status value is sent in each AVL record.
 +
|}
 +
 
 +
==Towing Detection==
 +
 
 +
[[Image:Fmb120_towing.png|right]]
 +
 
 +
''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>
 +
 
 +
==Crash Detection==
 +
 
 +
[[File:Crash Detection cfg.PNG|right]]
 +
 
 +
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 that is required to be detected. {{{model|FMB1YX}}} 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|FMB1YX}}} 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, that is changed by more then >50mG <br/>
 +
 
 +
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://teltonika.lt/client<br />
 +
''Login:'' CrashDataVisualizer<br />
 +
''Password:'' crasHdaTa789
 +
 
 +
'''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]]
 +
 
 +
{{{par_dout|==DOUT controls==
 +
Please refer to [[FMB1YX DOUT controls|DOUT controls]].}}}

Revision as of 15:04, 6 November 2018

Accelerometer Calibration

Accelerometer auto calibration functionality has one purpose - determine how FMB device is mounted in a vehicle. After the calibration process eco driving functionality becomes active and calibration data will be used to determine harsh acceleration, braking and cornering events.
There are two conditions when auto calibration takes place:

  • If on device startup no calibration was detected;
  • If the device receives an SMS/GPRS message with auto_calibrate:set text.

After functionality has started FMB device periodically checks current appliance GNSS, ignition and movement source parameters and if the conditions match:

  • position fix got;
  • GNSS speed is zero;
  • ignition is ON;
  • first calibration vector was not saved yet;

Then first vector is taken. Saved vector will be considered as ground vector and it will be used at further calibration calculations.
Note: When FMB device saves first ground vector vehicle must be parked on flat ground. Crooked vector may have an impact on further calculations.
Afterwards first ground vector was taken, device analyses conditions:

  • position fix got;
  • GNSS speed is at least 20 km/h;
  • ignition is ON;
  • second vector was not saved yet;
  • vehicle driving in the same direction with 5⁰ tolerance;
  • vehicle speed increase by 7km/h within 1 second.

For next vector. Second vector will be taken if all conditions match. Immediately after second vector is received, it will be multiplied by first (ground) vector, the result of these vectors is vector multiplication cross product which is the right side of a car. By using same vector multiplication method, device front, left side will be calculated. 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.
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.
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.
After every TRIP START event, device starts shadow calibration. This type of calibration is running in parallel with already saved vectors (this means that vectors does not reset until shadow calibration have both new vectors). After shadow calibration is done, device updates the vector values to the new ones. There are two conditions when shadow calibration does not run at TRIP start event:

  • Normal calibration is still running.
  • Shadow calibration is still running from previous TRIP event.

To take ground vector these conditions should be met:

  • Ignition is ON
  • Device got GPS FIX
  • Vehicle speed = 0km/h

Device will check these conditions every 1sec until they will pass.
To take side vector these conditions should be met:

  • Vehicle speed >= 20km/h
  • Device got GPS FIX
  • Ignition is ON
  • Device angle does not change more than 5 degrees in past 1 sec
  • Speed need to increase by 7km/h in 1s period.

Device will check these conditions every 1 sec until they will pass.

Excessive Idling

Fmb120 excessive idling.png

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).













Unplug Detection

Fmb120 unplug.png

An event will be generated when FMB1YX is unplugged from external power or plugged back in again. User can select the detection type: Simple, which is used in cars where power voltage is not dependent on ignition (recommended); Advanced, which is used in cars where power voltage is disconnected when ignition is switched off.









Bw nb.png In Unplug Detection and Towing Detection scenarios if Eventual Records is enabled an event will be generated (included into the sent records) only when scenario starts and finishes. If Eventual Records is disabled scenario status value is sent in each AVL record.

Towing Detection

Fmb120 towing.png

Towing Detection feature helps to inform the driver about unexpected car movement when it was parked. FMB1YX generates an event when car is being towed or lifted, for example, in a case of vehicle evacuation. FMB1YX activates towing function when following conditions are met:

  1. Ignition (configured Ignition Source) is OFF.
  2. Activation Timeout is reached.

When towing function is engaged 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 FMB1YX detects a change of Ignition state from ON to OFF.





Crash Detection

Crash Detection cfg.PNG

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 that is required to be detected. FMB1YX can detect events ranging between a slight tapping on the device and a severe accident.
If Crash Trace is disabled only one eventual crash record will be generated when Duration (ms) and Threshold (mg) values are exceeded.

If Crash Trace is enabled, FMB1YX 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:

  • Accel duration (s). Acceleration data duration can be set for up to 15 seconds before crash event and 15 seconds after;
  • GNSS duration (s). GNSS data duration can be set for up to 30 seconds before crash event and 30 seconds after.
  • IO duration (s). IO data duration can be set for up to 30 seconds before crash event and 30 seconds after.

There are three configurable Crash Trace modes:
Trace Full

  • Data tracked: all GNSS and acceleration data

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)
Crash event input.png

Trace Changes

  • Data tracked: GNSS and acceleration, that is changed by more then >50mG

Each record will have accurate timestamps in milliseconds.


Fmb120 crash trace.png

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
Download and install TAVL (version 4.15.0.1 or later) + CrashDataVisualizer applications from here:
Link: https://teltonika.lt/client
Login: CrashDataVisualizer
Password: crasHdaTa789

To get crash data

Login to TAVL application (please contact your Sales manager for TAVL login information).

Crash data steps.png

In TAVL application:
1. Go to Events
2. Set the date of event
3. Select the object you want to analyze
4. Press "Crashes" button







Crash event list window will show up. Press Download icon and save crash event file (.JSON).

JSON download.png


Viewing crash data in application
Open CrashDataVisualizer application. Drag and Drop or Browse crash data file (.JSON).

Crash Data Visualizer start screen.png

Use the Visualizer.

Crash Data Visualizer main.png

DOUT controls

Please refer to DOUT controls.

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Template:FMB_Accelerometer_Features_settings&oldid=21588"