In this Document

    ! IMPORTANT: The term Electric Vehicle (EV) is used in this Guide to refer to a vehicle that plugs into an electric power source to charge and store electric energy in a vehicle battery. The term includes both plug-in hybrid EVs (PHEV) and battery EV (BEV). The term does not include conventional hybrids because they do not plug into an electric power source.

    ! IMPORTANT: To determine which EVs receive support, visit the EV Make/Model Support Reference.

    Do you have a use case/feature request for your EVs?

    The EV Product Management Team wants to hear from you! We work hard to improve our products and your feedback is important to us. Please contact your Reseller.

    Availability

    While some reports are currently available, others are only available in Feature Preview. Telematics Device firmware, needed to access vehicle data and populate reports, may not yet be available for all data sets and EV makes/models.

    The table below provides information about which Telematics Device service plan is required for EV data to populate the reports. For example, while the Fuel and EV Energy Usage report is available for all Telematics Device service plans, different report fields are visible depending on the service plan. The report fields for Fuel Used and Fuel Economy are visible on the Pro service plan or above but the Electric Energy Used and Electric Energy Economy are visible on the Pro and ProPlus service plan.

    Map — EV Charging Activity

    EV Data

    Telematics Device Version 7/8

    Telematics Device Version 9

    Service Plan

    Fleet Management Application

    Real-time charging status

    Support on confirmed models.

    Support on confirmed models.

    Pro/ProPlus

    Feature Preview

    Real-time battery charge % (SOC) during driving and charging

    Support on confirmed models.

    Support on confirmed models.

    Pro/ProPlus

    Feature Preview

    Engine Measurements & Exception Rules — EV Data Diagnostics

    EV Data

    Telematics Device Version 7/8

    Telematics Device Version 9

    Service Plan

    Fleet Management Application

    EV driving energy

    (see EV Data Diagnostic Guide for specific data diagnostics)

    Support on confirmed models.

    Support on confirmed models.

    Pro/ProPlus

    Available

    EV charging AC and DC energy

    (see EV Data Diagnostic Guide for specific data diagnostics)

    Not supported. No planned future support.

    Support on confirmed models.

    Pro/ProPlus

    Feature Preview

    Charging status and battery charge % (SOC)

    See: Map — EV Charging Activity for availability information

    See: Map — EV Charging Activity for availability information

    Pro/ProPlus

    Feature Preview

    Reports — Fuel and EV Energy Usage Report

    EV Data

    Telematics Device Version 7/8

    Telematics Device Version 9

    Service Plan

    Fleet Management Application

    EV driving energy

    Support on confirmed models.

    Support on confirmed models.

    Pro/ProPlus

    Available

    Reports — EV Charging Report

    EV Data

    Telematics Device Version 7/8

    Telematics Device Version 9

    Service Plan

    Fleet Management Application

    EV charging energy

    Basic support on confirmed models.

    Not supported: energy, power, current type, AC voltage

    Support on confirmed models.

    Pro/ProPlus

    Feature Preview

    KEY INFO: Locating Your Firmware Version and Device Version

    • Firmware Version — The firmware is released or exists in a pre-release (Beta) form on Telematics Device version 7, 8, and/or 9, for specific EV makes/models. To verify the firmware version:
      1. Navigate to the Fleet Management Application.
      2. Select Vehicles. On the Vehicles page, use the search bar to find your EVs.
      3. Select View, and from the dropdown menu, select Advanced.
      4. Locate the Firmware Version column (i.e. x.26.x).
      5. Device Version —The Telematics Device version 7 and 8 do not support all EV data diagnostics. To verify the device version:
        1. Navigate to the Fleet Management Application.
        2. Select Vehicles. On the Vehicles page, use the search bar to find your EVs.
        3. Select View, and from the dropdown menu, select Report.
        4. Locate the Device column to determine the device version.

    ! IMPORTANT: To determine which EVs receive support, visit the EV Make/Model Support Reference.

    Fleet Management Application: Enabling Feature Preview

    The Built-In Exception Rules are in Beta and not currently enabled by default. To access this feature, you must enable Feature Preview.

    To enable Feature Preview, follow the steps below.

    1

    Navigate to Administration > Users from the main menu.

    2

    Search for your name and in the User Edit page, click the UI Settings tab.

    3

    For Feature Preview, toggle the button to On.

    4

    Click Save.

    NOTE: Features that are in preview may change, break or disappear at any time. Using these features in a production setting is not recommended.

    Live Map Positions: EV Charging Status and EV Charge %

    For supported EVs, the live Map now displays the current battery charge % and indicates whether the vehicle is charging, driving, or stopped.

    EV Charging Status and Charge % Questions and Answers

    Key Questions

    Answers

    Know What’s Happening in Real-Time

    Who needs to charge?

    Who is actively charging?

    Who has the most / least battery charge %?

    Map Live Positions:

    Allows you to see actively charging EVs.

    Allows you to see the real-time charge % for EVs.

    Which vehicle is closest to a location, and within sufficient range?

    Map Live Positions — Nearest:

    Allows you to see and filter EV Charge — Real-time charge % (SOC).

    Views

    Map and List View

    The Map view allows you to see which EVs are charging, outside or inside a zone.

    The List view allows you to see which EVs are charging, as well as the driving charge % for each EV, updated at 1% increments. The List view also allows you to sort the vehicles by battery charge % (EV Charge).

    Nearest View

    The Nearest View helps you find the vehicles closest to your current location, and helps you assess which vehicle has enough range for a trip based on viewing their battery charge %.

    Engine Measurements: Using EV Data Diagnostics

    With EV data diagnostics, Engine Measurements allows for more advanced reporting that is not supported by the reports and features outlined above.

    To access Engine Measurements, select Engine & Maintenance > Engine and Device … > Measurements from the main navigation menu.

    For more detailed information on EV data diagnostics and their availability, visit the Electric Vehicle Data Diagnostics User Guide.

    EV Exception Rules

    NOTE: For more on Exceptions, visit the section titled Exceptions in the Product Guide.

    Built-In Exception Rules (Feature Preview)

    Within the Sustainability section, you will find four built-in rules for your EVs, currently under Feature Preview. To enable Feature Preview, see Fleet Management Application: Enabling Feature Preview.

    EV Low Charge

    Get notified when an EV becomes at risk of not having sufficient charge to complete routes without stopping to charge, which is a high productivity loss. This rule will trigger when the electric vehicle (EV) battery charge % (State of Charge) drops below the configured value.

    Important Information and Tips:

    • The specified Battery charge looks at the Engine Measurement Generic state of charge.
    • Setting this rule to On via the built-in rule will enable it for all vehicles reporting values for Engine Measurement Generic state of charge, which will include PHEVs, BEVS, and some HEVs. If you have PHEVs and HEVs in your database, we advise that you customize this rule, and use the Publish to groups option to only apply the rule to a subset of the EVs in a Group. See the Product Guide: Publishing Exception Rules for more information.

    EV Enters Charging Zone with Low Charge

    When an EV returns to a lot/depot with sufficiently low charge, it is time to plug in. This rule is useful for plug-in reminders and identifying which EVs need to be prioritized for charging.

    Important Information and Tips:

    • This builds on EV Low Charge, and is more specific to plug-in reminders.
    • The specified Battery charge looks at the Engine Measurement Generic state of charge.
    • Create Zones around areas where your EVs stop and charge. Then assign those Zones to one or more designated Zone Types, and specify them here.
    • Setting this rule to On via the built-in rule will enable it for all vehicles reporting values for Engine Measurement Generic state of charge, which will include PHEVs, BEVS, and some HEVs. If you have PHEVs and HEVs in your database, we advise that you customize this rule, and use the Publish to groups option to only apply to a subset of the EVs in a Group, such as to a BEVs group. See the Product Guide: Publishing Exception Rules for more information.
    • Have the plug in reminder go directly to the Driver by customizing the rule and choosing to Add driver feedback. See Product Guide: Driver Feedback for more information.

    EV Exits Charging Zone with Low Charge

    This rule will trigger when EVs exit a charging zone of the specified type(s) while its battery charge is below the configured value. This is useful for identifying EVs that:

    • Leave the depot/lot at the start of their day with insufficient charge to complete their routes. This works well for cases when the EVs need a minimum charge to complete their expected route distance.
      • Leave a wider geographic safe zone, such that by leaving this larger zone with a low charge, the EV no longer may have sufficient range to return to their regular charging location.

      Important Information and Tips:

      • This builds on EV Low Charge, and is more specific to notify drivers that they are at risk of not having sufficient charge to complete their routes or make it back to their usual location to charge.
      • The specified Battery charge looks at the Engine Measurement Generic state of charge.
      • Create Zones around areas where your EVs stop and charge. Then assign those Zones to one or more designated Zone Types, and specify them here.
      • Setting this to On via the built-in rule will enable it for all vehicles reporting values for Engine Measurement Generic state of charge, which will include PHEVs, BEVS, and some HEVs. If you have PHEVs and HEVs in your database, we advise that you customize this rule, and use the Publish to groups option to only apply to a subset of your EVs in a Group, such as to a BEVs group. See the Product Guide: Publishing Exception Rules for more information.
      • Have the driver be alerted by customizing the rule and choosing to Add driver feedback. See Product Guide: Driver Feedback for more information.

      EV Done Charging

      This rule will trigger when the EV battery is charged to the configured value. This is useful to indicate when the EV’s charging plug can be provided to another EV, or when it is important to know when the EV is ready for use.

      Important Information and Tips:

      • The specified Battery charge looks at the Engine Measurement Generic state of charge. Change from the default 100% value should you have your EVs configured to end charging lower than 100%.

      Custom Exception Rules: Using EV Data Diagnostics

      With EV data diagnostics, Exception Rules offer support for additional event-based notifications and reporting, outside of those built-in rules. The following are a few to get you started!

      NOTE: For more on Exceptions, visit the section titled Exceptions in the Product Guide.

      Key Questions

      Answers

      Time to Charge?

      Who needs to charge?

      Who needs to charge at a specific location?

      Notifications/report for low battery charge % (SOC).

      Exception Rule Conditions:

      • Engine Measurement — Generic state of charge.
      • Zone/Zone Type for specifying the location of the EV.

      Time to Unplug?

      When there are more EVs than plugs, which EVs are done charging and their plug can be given to the next EV?

      Notifications/report for 100% battery charge % (SOC).

      Exception Rule Conditions:

      • Engine Measurement — Generic state of charge.
      • Engine Measurement — Electric vehicle charging state (0 = not charging / 1 = AC charging / 2 = DC charging)
      • Zone/Zone Type specifies the location of the EV. See note below.

      Charging during Peak Rate Time?

      Is there an EV charging when electricity rates are high?

      Restrict charging during peak rate periods.

      • Engine Measurement — Electric vehicle charging state (0 = not charging / 1 = AC charging / 2 = DC charging)
      • Work hours allows you to define the time frame for when the vehicle is not allowed to charge on a daily basis.
      • Zone/Zone Type specifies the location of the EV. See note below.

      Fuel and EV Energy Usage Report

      The Fuel and EV Energy Usage Report displays driving energy consumption from both fuel and electric energy sources. Driving energy consumption includes both propulsion and auxiliary, such as heating and cooling. Both fuel and electric energy usage are combined in this report to handle Plug-in Hybrid Electric Vehicles (PHEV), which consume both fuel and electric energy.

      EV Specific Questions Answered

      Key Questions

      Answers

      Performance

      How are my EVs performing?

      What electric range am I typically getting?

      Is it close to the promised range?

      How are my EVs performing in comparison to my fuel cars?

      Electric Energy EconomyReports on performance for BEVs.

      Total Fuel and Electric Energy EconomyReports on efficiency for PHEVs, and provides a comparable value in a mixed fleet.

      Maximizing Use of PHEV Battery

      Are we maximizing the battery use?

      Are these just running on gas?

      % Electric Energy of Total — Filtering on just PHEVs.

      Report Fields — EV Specific Meanings

      Below is a simplified list of EV-relevant fields in this report.

      Field

      Description

      Distance

      Total distance travelled on all energy sources.

      Electric Energy Used

      Total electric energy used, expressed in either kilowatt hour (kWh) or watt hour (Wh). Wh is used when Electric Energy Economy Measurement unit is set to Wh/km or Wh/mile; otherwise kWh is used.

      NOTE: Energy added to the battery from all non-charging sources — regenerative braking, driving down a hill, fuel engine charging in a hybrid — is subtracted from Electric Energy Used. If energy is added to the battery faster than it is consumed, the value will be negative.

      Fuel Economy

      This is displayed when the vehicle travels exclusively on fuel (electric energy used = 0); otherwise the field remains blank.

      Electric Energy Economy

      This is displayed when the vehicle travels exclusively on electric energy (fuel used = 0); otherwise the field remains blank. It is a primary indicator of vehicle electric energy efficiency and performance.

      NOTE: See Electric Energy Economy Measurement to change the measurement unit.

      Similar to Electric Energy Used, if energy is added to the battery faster than it is consumed, the value will be negative.

      Total Fuel and Electric Energy Economy

      This is a single comparable value across all your vehicles and displayed for every vehicle. If electric energy is used, it is converted to the equivalent in fuel. This converted value is then added to the Fuel Used to calculate this combined Economy value. If electric energy is not used, this value is the same as Fuel Economy.

      Units = The equivalent of the selected fuel economy measurement. To learn how we convert electric energy to fuel, please refer to the note below.

      NOTE: Similar to Electric Energy Used, if energy is added to the battery faster than it is consumed, the value will be negative.

      % Electric Energy of Total

      Calculation of electric energy used (%), based on all electric and fuel energy usage. To learn how we convert electric energy to fuel, please refer to the note below.

      NOTE: When Electric Energy Used is negative, this value may exceed 100%.

      How do we convert electric energy to the equivalent in fuel?

      Both electricity and fuel are forms of energy. This report performs a conversion of electric energy to the equivalent in fuel to calculate the Total Fuel and Electric Energy Economy, and the % of Electric Energy of Total. For Battery Electric Vehicles (BEV), the equivalent in gasoline fuel is converted. For PHEV, the units convert to the same fuel type that’s used by the vehicle when the fuel type is reliably available.

      The United States Environmental Protection Agency (EPA) and the United States Department of Transportation (DOT) have adopted the standard conversion and states that 1 US Gallon of Gasoline is equivalent to 33.7 kWh of electric energy (src). Additionally, the United States Department of Energy Alternative Fuels Data Center defines 1 US Gallon of Diesel as having 113% of the energy of 1 US Gallon of Gasoline (src).

      Using these baseline conversions, including standard volume conversions to Liters and Imperial Gallons, we can convert electric energy to the equivalent in fuel.

      Electric Energy Economy Measurement

      Similar to Fuel Economy Measurement, the Electric Energy Economy Measurement allows users to display measurements in the desired units.

      To change the measurement unit, follow the steps below:

      1

      In the Fleet Management Application, click the user name in the top right corner of the screen and select Options.

      2

      Under the Main Settings tab, choose the desired measurement unit located next to Electric Energy Economy Measurement.

      3

      Click Save.

      NOTE: The “-e” attached to L and MPG indicates that the unit converts electric energy to the equivalent in either liters or gallons of fuel. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline.

      Electric Energy Economy Measurement: Metric

      Unit

      Description

      L-e/100 km

      The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is L/100 km.

      NOTE: This converts electric energy into the fuel equivalent (in litres) to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done.

      km/L-e

      The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is km/L.

      NOTE: This converts electric energy into the fuel equivalent (in litres) to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done.

      kWh/100 km

      Wh/km

      For a primarily EV fleet, this helps you understand how much energy is used / needed for a specified distance.

      km/kWh

      For a primarily EV fleet, this helps you understand how much distance you can cover based on the battery energy — measured in kWh.

      Electric Energy Economy Measurement: US/Imperial

      Unit

      Description

      MPG-e (US)

      MPG-e (Imp)

      The best choice for a primarily non-EV fleet when the preferred fuel economy measurement is MPG.

      NOTE: This converts electric energy into gallons equivalent of fuel to present a value in familiar units. For BEVs, electric energy is converted into the equivalent in gasoline. For PHEVs, electric energy is converted into the same fuel type used by the vehicle — detected by the Telematics Device. The conversion requires the Telematics Device to accurately detect the fuel type; otherwise, the electric energy is converted to the fuel equivalent in gasoline. See the note above to learn how the conversion is done.

      kWh/100 miles

      Wh/mile

      For a primarily EV fleet, this helps you understand how much energy is used / needed for a specified distance.

      mile/kWh

      For a primarily EV fleet, this helps you understand how much distance you can cover based on the battery energy — measured in kWh.

      NOTE: Electric Energy Economy is currently based on distance. In some cases, EVs operate in a stationary position for long periods of time, and idle. In these cases, it’s better to calculate Electric Energy Economy over time rather than distance, such as kWh/hour. Use the Electric Energy Used value and report time period to calculate this value.

      Report Views

      List

      The Fuel and EV Energy Usage page displays the electric energy and fuel usage by vehicle. Similar to Fuel used, the value for Electric Energy used is displayed under the corresponding vehicle. The list view also displays Total Fuel and Electric Energy Economy for each vehicle, as described in Report Fields — EV Specific Meanings above. When both fuel and EV energy are used, clicking on a row gives you the choice to either view the Fill-Ups or EV Charging Report.

      Report

      Includes all fields listed in Report Fields — EV Specific Meanings, except for % Electric Energy of Total.

      Advanced

      Includes all fields listed in Report Fields — EV Specific Meanings.

      EV Charging Report

      The EV Charging Beta Report is the EV equivalent of the Fill-Ups Report used for fuel. This report provides information about the electric power and energy consumed when vehicles plug in to charge.

      NOTE: What’s the difference between electric power and electric energy?

      Power, expressed in kilowatts (kW) or watts (W), is the rate at which electric energy is transferred into the vehicle for charging. The lower the power value, the longer the vehicle takes to charge.

      Energy, expressed in kilowatt hours (kWh) or watt hours (Wh), is the total volume of power transferred or used over an hour.

      EV Charging Beta Report Questions Answered

      Key Questions

      Answers

      Have the Full Charging History

      What happened?

      Where, when, for how long and how much did EVs charge?

      Why do my EVs have the battery charge % that they have?

      Answered generally by EV Charging.

      EVs and Building Load

      What is the EV contribution to facility load?

      Sum total Energy Added by Zone.

      ✱ NOTE: Trying to calculate charging costs and demand charge/peak charges?

      The EV Charging Beta Report does not easily support these uses. The EV Product Management team is aware these are high priority requests and is keen to track more requests. Please contact your Reseller to share your feature requests.

      Report Fields

      ! IMPORTANT: The report fields are populated differently for the following sections in the List, Report, and Advanced report views: start and end dates, duration, and the start and end battery charge %.

      Charge Event Report Tab of Report & Advanced

      A Charge Event is recorded from when charging starts (power > 0 W) to when it stops (power = 0 W). During a single stop, there may be multiple Charge Events, if a managed charging, power sharing technology, or manual plug sharing is employed. In this report, each row of data corresponds to a single Charge Event.

      Charge Session List and Summary Tab of Report & Advanced

      A Charge Session groups all Charge Events that occur during a single stop. In this report, each row of data corresponds to a single Charge Session. This is intended as a more readable format — especially when managed charging, power sharing or plug sharing is employed.

      Field

      Description

      Start Date

      In the Report and Advanced report Report tab, this is the date and start time of the Charge event.

      In the List, and Report & Advanced Summary tab, this is the date and start time of the Charge Session — the start of the first charge event during a single stop.

      End Date

      In the Report and Advanced report Report tab, this is the date and end time of the Charge Event.

      In the List, and Report & Advanced Summary tab, this is the date and end time of the Charge Session — the end of last charge event during a single stop.

      Location

      The street address of the charging location. When Privacy Mode is applied, this will be blank.

      Zones

      If the location is within one or more Zones, the names of the Zones are displayed. When Privacy Mode is applied, this will be blank.

      Zone Types

      If any Zone has one or more Types, the name of each Zone Type is displayed. When Privacy Mode is applied, this will be blank.

      Start Charge %

      In the Report and Advanced report Report tab, this is the battery charge % remaining at the start of the Charge Event.

      In the List, and Report & Advanced Summary tab, this is the battery charge % remaining at the start of the Charge Session — the start of the first charge event during a single stop.

      End Charge %

      In the Report and Advanced report Report tab, this is the battery charge % remaining at the end of the Charge Event.

      In the List, and Report & Advanced Summary tab, this is the battery charge % remaining at the end of the Charge Session — the end of the last charge event during a single stop.

      Energy Added

      The total electric energy added, expressed in either kilowatt hour (kWh) or watt hour (Wh).

      Wh is used when Electric Energy Economy Measurement unit is chosen as Wh/km or Wh/mile; otherwise kWh is used.

      Max Power

      During a Charge Event or Charge Session, the power typically fluctuates. The maximum value is the best indicator of the sustained power found throughout. The maximum value is also the best indicator of the EV contribution to additional billing charges resulting from excessive power demand, and for being aware of the capacity requirements for EV charging.

      Wh is used when Electric Energy Economy Measurement unit is chosen as Wh/km or Wh/mile; otherwise kWh is used.

      Current

      This is either AC (Alternating Current) or DC (Direct Current). If you want both at once, check out the band by that name, AC/DC.

      AC Voltage

      The Alternating Current voltage.

      Electric Energy Economy

      The equivalent concept to Fuel Economy in the Fill-Ups Report. This is the amount of energy consumed over the total distance traveled since the end of the previous Charge Event / Charge Session to this one. See Electric Energy Economy Measurement to change the measurement unit.

      This is not populated for PHEVs if fuel was consumed within the report’s time period.

      ✱ NOTE: For those in North America who want to display charging as SAE Level 1 (120 V AC), SAE Level 2 (~240 V AC), or SAE Level 3 (DC), use the Current and AC Voltage values to extend the report.

      Report Views

      List

      The List View displays the following information:

      • Zone(s);
      • Start and end date of the charging session;
      • Duration of the charging session;
      • Location of the charging session;
      • Battery charge % from the start and end of the trip;
      • Electric Energy Economy since the last charging session; and
      • Electric Energy Added.

      The icon allows you to view the charging location of the vehicle on the Map.

      ✱ NOTE: Our priority is to provide high accuracy data on all EV makes and models. However, data for some vehicles may be missing or originate from a secondary source, when a primary higher quality source was not available. For these vehicles, the List Limited indicator describes the missing data and specifies if data is obtained from a secondary source, which may result in lower accuracy.

      Report

      The Report view includes all the fields listed in Report Fields, except for Current and AC Voltage.

      Advanced

      The Advanced view includes all fields listed in Report Fields, as well as the Charging Summary by Vehicle and Charging Summary by Zone summarized data reports.