Fuel Theft Alarm

GpsGate can help you to detect possible fuel theft, loss or leakage by using a script in your event rules. You can set up alerts when a significant loss of fuel is detected in your vehicles.

Requirements

  • A tracker with fuel level capabilities (check here for compatible devices by searching by the keyword fuel).
  • Script Expressions enabled.
  • The Fuel device signal (input) mapped to the variable Fuel level in the Device Mapper

Setup

1. Import Fuel Theft Alert script.xml file.

2. Execute the EV1000 report for getting historical results.

Optional: add Ignition

You can add an extra variable to ensure that fuel level script triggers on certain conditions. For example, you can edit the fuel theft script and combine it with Ignition signal. When Ignition = Off (if available), you can ensure that you'll only get alerts when the device is parked and not when moving.

How it works

The script saves 8 consecutive fuel level measures and calculates the mean for the first 4 values and also the mean of the last 4 values.

If the difference is larger than the threshold specified, it would indicate abnormal fuel consumption.

By default, the script has a threshold of 3 (the difference between both means in liters). This value can be modified according to the fuel level signal inputs you receive from your device (liters/gallons). If you receive the fuel level input in voltage check this guide to convert that to liters.

mceclip6.png

Configure the event rule notifications

By default, the rule triggers 3 notifications. You can customize all these 3 notifications by editing the imported event rule.

  • Icon on the Vehicle panel

mceclip1.png

Right click on the vehicle panel and add Fuel theft column, then save the Workspace.

  • Report Argument

mceclip2.png

If you have fuel theft events, when executing the EV1000 report, select the Fuel Theft Alert script event rule in the report parameters to see the results.

  • SMS

mceclip3.png

Select in the Receipients field in the event rule, to choose which users will receive SMS notifications. Make sure the user group you select contains user with mobile phone numbers in it.

 

Testing

If you are a developer with knowledge in JavaScript, you can edit this script and adjust it to your needs.

For testing, you could use the script editor and select track point values to see the script outcome.

It's also possible to test the script using SimOne. 

When submitting Fuel Level values to your application, if the fuel consumption surpasses the threshold, you should get an alert as shown in the picture:

mceclip5.png

mceclip4.png

The Event Rule will react to those track points sent with SimOne simulating a real-life situation.

mceclip0.png

Note: These calculations rely on the values sent from the device. This method cannot assure 100% that you are actually getting fuel theft. There could be another cause for the alarm being triggered: fuel leakage, bad readings from the fuel sensor, wrong threshold value, etc. The most accurate the values you receive, the more efficient the script will be.