Support Document
0 mins to read
•Electric Vehicle Data Diagnostics
Support Document
0 mins to read
•Learn about data diagnostics for electric vehicles (EVs) and fuel cell electric vehicles (FCEVs), including EV driving energy, charging, and battery diagnostics. Firmware and device restrictions are noted for each data diagnostic for ease of reference.
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:
- Navigate to the Fleet Management Application.
- Select Vehicles. On the Vehicles page, use the search bar to find your EVs.
- Select View, and from the dropdown menu, select Advanced.
- 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:
- Navigate to MyGeotab.
- Select Vehicles. On the Vehicles page, use the search bar to find your EVs.
- Select View, and from the dropdown menu, select Report.
- 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 SupportThe 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:
|
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:
|
Charging during Peak Rate Time? Is there an EV charging when electricity rates are high? | Restrict charging during peak rate periods.
|
