Support Document

0 mins to read

Oct 04, 2022

Availability

The information in this document pertains to Electric Vehicles (EV) and Fuel Cell Electric Vehicles (FCEV). Support is available on confirmed makes and models. Firmware and device restrictions are noted for each data diagnostic. The Pro or ProPlus rate plan is required for all EV and FCEV data described in this document.

KEY INFO: Locating Your Firmware Version and Device Version in MyGeotab

  • Firmware Version — The firmware is released or exists in a pre-release (Release Candidate or Beta) form on Telematics Device Version 7, 8 and 9, for specific EV and FCEV 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.25.x).
  • Device Version —The Telematics Device Version 7 and 8 do not support all EV and FCEV data diagnostics. To verify the device version:
    1. Navigate to MyGeotab.
    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 and FCEVs receive support, visit the EV Make/Model Support Reference.

EV Data Diagnostics

! IMPORTANT: What about fault diagnostics/Diagnostic Trouble Codes (DTCs)?

Fault diagnostics / DTCs are communicated through the OBDII standard. A main OBDII standards compliance driver is emissions reporting. EVs, outside of PHEVs, are unlikely to support OBDII, because they lack tailpipe emissions — even though there are many fault diagnostics communicated outside of emissions. As a result, we do not have fault diagnostic support for EVs that do not support OBDII.

EV Data Diagnostics Basics

Code

Portal Name

Description

Availability Limitations

59

Hybrid/electric vehicle detected

Unit: 1=true; 0=false

1 is for a plugin EV (BEV or PHEV) or any non-conventional Plugin Hybrid Electric Vehicle (PHEV).

None

2118

Generic state of charge

Unit: %

Refers to usable battery charge.

While driving and charging, battery charge is reported every 1% change in value.

None

EV Driving Energy

Core

Code

Portal Name

Description

Availability Limitations

3277

Electric vehicle battery total energy in while driving (since telematics device install)

Unit: kWh

Total energy added to the battery from all non-charging sources since the telematics device was installed, such as regenerative braking, driving down a hill, and engine charging in a hybrid.

None

3278

Electric vehicle battery total energy out while driving (since telematics device install)

Unit: kWh

Total energy leaving the battery since the telematics device was installed, consumed for driving and operating the vehicle. This includes propulsion and all auxiliary loads.

None

NOTE: EV Electric Energy used is the difference between out (3277) and in (3278). Therefore, if there is more energy generated than consumed over a time period, the EV energy used will be negative.

For Internal Debugging Only

! IMPORTANT: These diagnostics are intended for internal debugging purposes. Customer use of these diagnostics is not recommend for customer use, as accuracy is not guaranteed.

Code

Portal Name

Description

Availability Limitations

2111

HV battery voltage

Unit: Volt

Used by the telematics device to calculate other diagnostics, such as Electric vehicle battery total energy out while driving (since telematics install) or Electric vehicle battery total energy in during DC charging (since telematics install).

None

EV Charging

CORE CONCEPTS:

  • HV Battery — The high-voltage (HV) battery of a BEV or PHEV.
  • AC vs. DC Charging — During Alternating Current (AC) charging, power must be converted to Direct Current (DC) power prior to storage in the EV’s HV battery. The conversion happens in the EV’s on-board charger. In contrast, DC power is stored directly in the EV’s HV battery.

Charging Status

Code

Portal Name

Description

Availability Limitations

3289

Electric vehicle charging state (0 = not charging / 1 = AC charging / 2 = DC charging)

Unit: as described

A value other than 0 indicates that the vehicle is charging; this is reported in real-time. Values of 1 or 2 additionally indicate the type of charging (i.e. AC or DC charging).

Note: As of firmware x.26.x, this will replace Electric vehicle: charging (1 = charging).

None

No longer available

2183

No longer available

Electric vehicle: charging (1 = charging)

No longer available

Unit: 1 = charging; 0 = not charging

Indicates if the EV is actively charging. As of firmware x.26.x, this will no longer be populated. Use Electric vehicle charging state (0 = not charging / 1 = AC charging / 2 = DC charging) (below).

Firmware: Not available as of x.26.x

AC Charging

Code

Portal Name

Description

Availability Limitations

3287

Electric vehicle on-board charger total energy in during AC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going into the EV’s on-board charger during AC charging since the telematics device was installed.

Device: Telematics Device Version 9 only

3292

Electric vehicle on-board charger AC input power

Unit: Watt (W)

The power of the original AC charging source, going into the EV’s on-board charger.

3290

Electric vehicle on-board charger AC input voltage

Unit: Volt

The voltage of the original AC charging source, going into the vehicle’s on-board charger.

3288

Electric vehicle on-board charger total energy out during AC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going out of the EV’s on-board charger during AC charging since the telematics device was installed.

3293

Electric vehicle on-board charger DC output power

Unit: Watt (W)

The power going out of the EV’s on-board charger after converting AC power to DC power.

3283

Electric vehicle battery total energy in during AC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going into the HV battery via AC charging since the telematics device was installed.

3284

Electric vehicle battery total energy out during AC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going out of the HV battery during AC charging since the telematics device install.

3294

Electric vehicle battery power

Unit: Watt (W)

Power measured at the battery. During DC charging, this is the only power reading available. During AC charging, this is available if higher quality power data sources are not available.

A positive value indicates power is flowing out of the battery, such as for propulsion and auxiliary loads.

A negative value indicates power is flowing into the battery, such as for charging from the plug, charging from the engine, and regenerative braking.

DC Charging

Code

Portal Name

Description

Availability Limitations

3285

Electric vehicle battery total energy in during DC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going into the HV battery during DC charging since the telematics device was installed.

Device: Telematics Device Version 9 only

3286

Electric vehicle battery total energy out during DC charging (since telematics device install)

Unit: kilowatt hours (kWh)

The total energy going out of the HV battery during DC charging since the telematics device was installed.

3294

Electric vehicle battery power

Unit: Watt (W)

Power measured in the battery. During DC charging, this is the only power reading available. During AC charging this is available if higher quality power data sources are not available.

A positive value indicates power is flowing out of the battery, such as for propulsion and auxiliary loads.

A negative value indicates power is flowing into the battery, such as for charging from the plug, charging from the engine, and regenerative braking.

Battery — Non-Standard Support

The following are supported on select EV makes/models that make this information accessible.

Code

Portal Name

Description

Availability Limitations

2997

Electric vehicle battery charge remaining

Energy (kWh) remaining in the battery, which may be usable or actual.

Non-standard support

3254

Generic EV battery state of health

Unit: %

Battery health, as reported by the vehicle.

Non-standard support

3255

Generic EV battery maximum temperature

Unit: Celsius

The maximum temperature of the battery at a specific point in time, across multiple measurement points.

Non-standard support

3256

Generic EV battery minimum temperature

Unit: Celsius

The minimum temperature of the battery at a specific point in time, across multiple measurement points.

Non-standard support

3268

Generic EV battery median temperature

Unit: Celsius

The median temperature of the battery at a specific point in time, across multiple measurement points.

Non-standard support

2659

Electric vehicle distance remaining

Unit: meters (m)

Distance remaining, as calculated and reported by the EV.

Non-standard support

Fuel Cell Electric Vehicle (FCEV) Data Diagnostics

Code

Portal Name

Description

Availability Limitations

98

Fuel level (percentage)

Unit: %

Hydrogen fuel tank level.

Device: Telematics Device Version 9 only

3297

Total hydrogen fuel used (since telematics device install)

Unit: grams

Total hydrogen consumed since the telematics device was installed.

3296

Total idle hydrogen fuel used (since telematics device install)

Unit: grams

Total hydrogen consumed while idling since the telematics device was installed.

Using Data Diagnostics in the Fleet Management Application

Engine Measurements — Using EV and FCEV Data Diagnostics

For advanced reporting, Engine Measurements can be used for the EV and FCEV data diagnostics listed above. To access Engine Measurements, select Engine & Maintenance > Engine and Device … > Measurements from the main menu.

Custom Exception Rules — EV Data Diagnostics

With EV data diagnostics, Exception Rules offer support for additional event-based notifications and reporting. 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.
scroll-up