This guide shows how to set up and get started with the Eco Report. It includes report plugin installation and report configuration.
The Eco Report measures harsh driving, speeding, and idling and it produces a score for each vehicle. In this guide, we will install the Eco Report, configure it, and map the required device signals.
For a scripted version of these reports, go to Scripted Eco Report Setup.
- A device that supports harsh driving signals (acceleration, turning, braking).
Some devices supporting harsh signals are, for example, ATrack, Teltonika, or Queclink. You can check the full list of devices supporting harsh signals in our devices page by checking for the column ECO.
- VarPack2 plugin installed.
Follow these steps to install the report on your server:
- Log in to your Site Admin application
- Install Eco Report from Site Admin > Plugins
- Activate the reports in your Application.
Configure your Device Mapper
Your harsh driving signals must be mapped to the correct GpsGate variables for the Eco report to work.
Follow these steps:
- Go to Admin > Device Mapper in the application.
- Click Edit for the harsh driving compatible device
- Map the Ignition input from your device to the GpsGate variable Ignition. This is required for correct idle time. Note: The following screenshot is an example. The ignition signal might come from a different input from your device. Check with your device support to know which is the right input that you should use.
- Map the device harsh signals to the variables harsh acceleration, harsh turning, and harsh braking. Note: it’s not required to map all harsh signals, but remember to set 0 (zero) Weight in the matching parameter (shown below).
- Save your changes and close the Device Mapper window.
Configure the RPT_Speeding Event Rule
You can change the speed that the Eco Report counts as speeding.
1. In the application, open the Admin > Event Rules window.
2. Notice that there is a new rule called RPT_Speeding available. This rule is created by the Eco Report plugin and specifically used to count speeding events in the Eco reports.
3. Click Edit and alter the 4. Expression section as appropriate (set the speed that you count as speeding and an appropriate end condition).
4. Save your changes and verify that no warnings are displayed.
Configuring the report - weight parameters
The Eco reports (details and summary) show a single score for each vehicle based on harsh events.
To do this a formula is used based on the distance, the number of event occurrences, and the signal’s weight.
The weights are defined as report parameters when configuring/creating the report in the application.
To configure weight parameters follow these steps:
- Log in to the application in question.
- Open the Reports > Manage reports window.
- Choose either EC1000 (summary) or EC1001 (detailed) in the drop-down and Click Open.
- For each harsh parameter, there’s a default value. Preview the report to determine if any of the weights need to be altered. Note: you might want to configure several versions of the report in the same Application for trucks, cars, etc, where you weigh the signals differently. You can do that in Reports > Manage reports > New.
- Select Hide for each harsh parameter so the end-user can’t see (and alter) them.
- Save the report.
View the report
Now you can look at your report directly by selecting your Eco report in the Reports menu. This is what the EC1000 (the summary report) looks like with enough device data in it:
Device configuration guides
You need to configure your devices to send harsh driving information for the report to work. The guides below will help you with that (and we will be adding guides for more devices).