Official Mobile Application

From Unofficial Zero Manual
Jump to: navigation, search

Zero publishes a native mobile app for their vehicles that connects to the MBB via Bluetooth LE.

First, check Zero's official mobile app user guide for an official and somewhat comprehensive overview.

This is an unofficial guide to their application.

Versions

Versions used internally by Zero and reported by the App may not match the versions reported by the mobile operating system.

For example, as of this writing the Zero App reports itself as 1.6.50(21), but Google Play Store reports it as 1.6.50

To see the version number in the App, touch Support and then About This App.

Capabilities

Ride Mode

Customize in Settings, Riding Screen Setup.

App now supports Landscape or Portrait.

Preview in Settings, Riding Screen Preview

When underway, Ride Mode, most functions in the app are disabled, only Riding Screen is available.

Other functions are available when key is on and throttle is disabled (by right-thumb switch or kickstand).

Voltage is not available on the Riding Screen. If you have concerns that your State Of Charge (percent full) or Distance To Empty is inaccurate and want to check the voltage, you'll have to stop riding to get out of Ride Mode and click the battery icon to see the voltage.

Statistics Mode

Indicator Guide
Page Indicator Official Description Unit Unofficial Guidance
Home State of Charge %
Battery Time Until Charged An estimate of how long it will take for your Zero to fully charge. Hours and minutes (hh:mm) Seems to be a linear projection based on the current Charging Watts and estimated capacity?
Capacity Kilowatt Hours kWh
TBD
See Capacity Amp Hours below
Capacity Amp Hours Ah
TBD
Could divide kWh capacity estimate by maximum pack voltage? Or multiply/project another figure.
Charging Watts This provides an estimate of Watts running into your battery from the on-board charger. W
This multiplies incoming current to the battery from any source by current pack voltage.
Any charger contributes to this.
Power draw by the chargers will be higher as a small portion of the power is lost as heat and current to run fans and accessories.
Total Kwatt Hours Used This indicates the total kWatt Hours Used on the batteries currently installed on your Zero. kWh Lifetime current*voltage discharge integrated and summed. MBB persistent value.
Trip Kwatt Hours Used This indicates the kWatt Hours Used on your Zero since your last reset. It can be reset (or tripped) in the Settings view, under reset statistics. kWh Delimited by the trip reset button.
Cell Balance This is a diagnostic indicator of the current state of balance; this is for Zero Motorcycle dealer reference. mV This represents the maximum difference in cell voltages in the series of cells that stack up to a Brick.
Battery Volts This indicates the current battery voltage; the maximum you will typically see is 116 Volts. The minimum you may see is 85 volts. The fuel gauge has a more accurate estimate of your charge state. V Battery Voltage can be a way to compensate for the necessary projections and estimations used to build the SoC figure, particularly as temperature changes.
Battery voltage does vary temporarily with the current charge state and level; incoming current raises it, outgoing current (while riding) lowers it.
Charge Cycles This measures the number of full charge cycles that your battery has completed. Partial charge cycles are not counted in this feature. # Logged count of times Charge Mode stopped with 95%+ SoC achieved
Need to understand this more accurately; there may be more logic in the BMS to discount partial cycles.
Performance Odometer This indicates the total miles traveled on your Zero. This is the total vehicle odometer as reported by the motorcycle. It may not always agree with the odometer on the dashboard. miles or km
MBB-reported/calculated miles.
The dash keeps a separate figure.
There are legally-required mechanisms to prevent mileage tampering.
Calculated from the MBB drive description settings.
Trip Odometer This indicates the miles traveled on your Zero since the last reset. This is not the total vehicle odometer, as it can be reset (or tripped) in the settings view, under reset statistics. miles or km
Calculated from the MBB drive description settings like the main Odometer.
Money Saved Vs Gas This shows how much money you have saved by riding a Zero motorcycle instead of an internal combustion engine vehicle. This is a derived statistic based on the values you provide on the settings page. In the DRIVE SETUP tab, you will be able to add:
  • Cost per Gallon of Gas, in your local area.
  • MPG of ICE (Internal Combustion Engine) vehicle for comparison. For example, if your Toyota Tacoma gets 22 MPG you put “22” as the value.
  • Cost Per kWatthour. You can get this statistic from your electric company utility bill.
$ or other currency
Cost Per Mile Cost Per Mile is calculated with the following formula: Average watt-hours per mile (since resetting your odometer) X Cost Per kWhatthour. $/mile or (other currency)/km
Average Watt Hours Per Mile This indicates the Average Watt Hours Per Mile on your Zero once you have paired it to your phone. It can be reset (or tripped) in the settings view, under reset statistics. Wh/mi or Wh/km
C02 Reduced Vs. Gas This estimates how much C02 you have reduced by riding your Zero motorcycle instead of an internal combustion engine vehicle.

This is a derived statistic based on the values you provide on the settings page. In the DRIVE SETUP tab, you will be able to add:

  • MPG of ICE (Internal Combustion Engine) vehicle for comparison. For example, if your Toyota Tacoma gets 22 MPG you can put “22” as the value.
  • kWatthours and distance you have travelled.
lb or kg

Upgrading Firmware

As of 2017, Zero models are capable of performing remote firmware updates by the customer using the mobile app.
Apparently this doesn't transfer to older models because the older boards did not have enough storage space to perform an atomic/reversible update.
This means holding both firmware versions and being able to toggle which version to use.
So, if anything goes wrong with a firmware update, the system can roll back to the previous version without requiring a dealer visit.

Usage

First, check Zero's official mobile app user guide for an official and somewhat comprehensive overview.

Obtaining Logs

The Zero companion mobile app can send logs to Zero customer service, or to an email address.
2014+ models can export BMS logs in addition to the primary MBB logs, but the extraction time can be very long, so in an emergency just focus on the MBB logs first and try BMS logs later.
The logs are binary-encoded in a proprietary way.

Decoding Logs

You can send the logs to yourself, and use a log file parser utility to do some digging which might save time if the utility can successfully decode the relevant parts.
Forum thread introducing the tool.
GitHub repository for the log parser.
Incomplete/reverse-engineered log structure documentation.
Online version of the log parser app, just upload your .bin file and view the results.
HTML/Javascript downloadable log parser, works on your Android/iOS phone to decode log files on the same device.

Common Problems

Unable to Connect

Sometimes the MBB will simply no longer activate a session with the mobile device.

Potential Workarounds
  • Kill the app, then re-connect to the bike in the Bluetooth settings, then start the app.
  • Put phone in airplane mode for at least 10 seconds then put it back to normal (i.e. reboot the wireless chipset).
  • Turning wifi off until the bluetooth has connected sometimes helps.

Unable to Customize Drive Mode

This seems to be a bug with specific revisions of the mobile application.

In particular, multiple reports that newer versions of the app are unable to make changes to the Custom Mode max torque and and regen parameters on 2014 Zero motorcycles, on both Android and iPhone. It's unclear what other years may be affected. http://electricmotorcycleforum.com/boards/index.php?topic=7106.0

Zero reports the apps released end of September 2017 addresses this issue. That's 1.4.0(55) on iPhone and 1.6.50(21) on Android, as reported by Support, About This App, within the app. Versions reported by the OS may differ.

Slow to Obtain Logs

If you have several ride through faults then the large quantity of data can make downloading logs very slow. Occasionally blip the throttle to keep the bike from timing out.

Unable to Obtain Logs

BMS logs are not obtainable on 2013 models, and even on newer models, the BMS logs take a dangerously long amount of time to access considering the typical mobile application e access session length.

Zero reports that versions released in late September address this issue.

Workarounds
  • Definitely send/obtain MBB logs alone before trying to extract and send MBB with BMS logs.
  • Connect to the MBB Console directly via OBD-II connection.

Stuck Screen

Stuck Orientation