Changes

Jump to: navigation, search

Official Mobile Application

17,728 bytes added, 20:56, 8 October 2020
Statistics Mode
Zero publishes a native mobile app for their vehicles that connects to the [[MBB]] via Bluetooth LE.

First, check [http://www.zeromotorcycles.com/app/help/ios/ 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

* [https://play.google.com/store/apps/details?id=com.ZeroMotorcycles&hl=en_US Zero Motorcycles on Android App Store]
* [https://itunes.apple.com/us/app/zero-motorcycles/id596423381?mt=8 Zero Motorcyles app on iTunes App Store]

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

Release information, as scraped from [https://apkpure.com/zero-motorcycles/com.ZeroMotorcycles APK Pure] and iTunes:

{| class="wikitable sortable"
!OS
!Version
!Rev
!Date
!Release Notes
|-
|rowspan="16"|iOS
|2.0.0
|
|2019-09-30
|New Look and Feel
|-
|1.7.5
|
|2019-08-19
|Support for new model year motorcycles.
|-
|1.5.0
|
|2018-10-16
|Support for model year 2019 motorcycles
|-
|1.4.2
|
|2018-02-05
|
: Performance Tab now mirrors Trip 1 Odometer for MY15-MY18
: Updated reporting of some values on the Battery Tab
: Fixed speed offset seen between DASH and riding screen
: Bluetooth Help is now available from the Support Tab
: General Bug fixes
|-
|1.4.0
|
|2017-09-27
|
* Model Year 18 Support.
* The application will now alert you when it detects that your motorcycle's firmware is out of date.
* Better in-app support of firmware update for Model Year 17 and Model Year 18 motorcycles.
|-
|1.3.0
|
|2017-05-03
|Bug Fixes
|-
|1.2.0
|
|2016-11-02
|
* Owners of 2017 models can use the Zero Motorcycles app to update their motorcycle’s firmware, saving time, money and service trips.
* Miscellaneous bug fixes and performance enhancements.
* Support for Italian language.
|-
|1.1.0
|
|2016-09-28
|
* Fix for bug that wouldn't allow you to connect to your motorcycle on iOS 10.
* String translation fixes.
|-
|1.0.9
|
|2016-04-07
|
* Miscellaneous bug fixes and performance enhancements
* Updated to include 2015 and 2016 model year Zero Motorcycles, including the 11kW models.
* Enhanced diagnostic reporting via ability to send battery management system (BMS) logs on 2014 model year and later Zero Motorcycles
|-
|1.0.8
|
|2016-03-04
|
* Miscellaneous bug fixes and performance enhancements
* Updated to include 2015 and 2016 model year Zero Motorcycles
* Enhanced diagnostic reporting via ability to send battery management system (BMS) logs on 2014 model year and later Zero Motorcycles
|-
|1.0.7
|
|2014-07-09
|
* Changed the company email for sending logs.
* Small UI fix for iOS 7.1.
|-
|1.0.6
|
|2014-07-02
|
* Updated the application for iOS7.0 and above.
* Added more specific log uploading support.
|-
|1.05
|
|2013-03-19
|Minor improvements
|-
|1.03
|
|2013-02-25
|Bug fixes & improvements
|-
|1.01
|
|2013-02-19
|Minor issues resolved
|-
|1.00
|
|2013-01-25
|
|-
|rowspan="12"|Android
|2.0.0
|
|2019-10-01
|New Look and Feel
|-
|1.7.5
|
|2019-08-21
|Support for new model year motorcycles.
|-
|1.7.3
|
|2018-10-17
|Support for model year 2019 motorcycles
|-
|1.6.71
|22
|2018-02-14
|
: Performance Tab now mirrors Trip 1 Odometer for MY15-MY18
: Updated reporting of some values on the Battery Tab
: Fixed speed offset seen between DASH and riding screen
: Bluetooth Help is now available from the Support Tab
: General Bug fixes
|-
|1.6.50
|21
|2017-09-29
|
* Model Year 18 Support.
* The application will now alert you when it detects that your motorcycle's firmware is out of date.
* Better in-app support of firmware update for Model Year 17 and Model Year 18 motorcycles.
* Bug fixes.
|-
|1.5.7
|20
|2017-05-06
|
* Crash fix for pre-5.0 (Lollipop) devices.
* Battery tab should now be quicker to load.
|-
|1.4.59
|19
|2016-12-14
|
* Crash fix for pre-5.0 (Lollipop) devices.
* Battery tab should now be quicker to load.
|-
|1.4.56
|18
|2016-11-04
|
* Owners of 2017 models can use the Zero Motorcycles app to update their motorcycle’s firmware, saving time, money and service trips.
* Miscellaneous bug fixes and performance enhancements.
* Support for Italian language.
|-
|1.4.54
|17
|2016-11-03
|
* Owners of 2017 models can use the Zero Motorcycles app to update their motorcycle’s firmware, saving time, money and service trips.
* Miscellaneous bug fixes and performance enhancements.
* Support for Italian language.
|-
|1.3.17
|16
|2016-04-06
|
* Miscellaneous bug fixes and performance enhancements
* Updated to include 2015 and 2016 model year Zero Motorcycles, including the 11kW models.
* Enhanced diagnostic reporting via ability to send battery management system (BMS)
logs on 2014 model year and later Zero Motorcycles
|-
|1.3.16
|15
|2016-03-03
|
* Miscellaneous bug fixes and performance enhancements
* Updated to include 2015 and 2016 model year Zero Motorcycles
* Enhanced diagnostic reporting via ability to send battery management system (BMS) logs on 2014 model year and later Zero Motorcycles
|-
|1.2.8
|14
|2015-12-21
|
Fixed crashes in home screen.
|}

=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==

{| class="wikitable"
|+ Indicator Guide
!Page
!Indicator
!Official Description
!Unit
!Unofficial Guidance
|-
|rowspan="1"|Home
|[[State of Charge]]
|
|%
|-
|rowspan="9"|[[Battery|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 [[Charger|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|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|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 times started charging. Partial charge cycles are counted as 1 cycle in this feature (at least in my 2017 Zero SR).
|#
|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|BMS]] to discount partial cycles.
|-
|rowspan="6"|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_Console#Settings|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_Console#Settings|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 [http://www.zeromotorcycles.com/app/help/ios/ 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
:: In an emergency, just focus on the MBB logs first and try BMS logs later.
: The logs are binary-encoded in a proprietary way.
:: Having collected many owners' logs, some have reverse-engineered most of the encoding.

===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.
: [http://electricmotorcycleforum.com/boards/index.php?topic=5020.0 Forum thread introducing the tool].
: [https://github.com/KimBurgess/zero-log-parser GitHub repository for the log parser].
: [https://github.com/KimBurgess/zero-log-parser/blob/master/log_structure.md Incomplete/reverse-engineered log structure documentation].
: [http://home.hasslers.net/zerologparser/ Online version of the log parser app, just upload your .bin file and view the results].
: [https://zero-motorcycle-community.github.io/browser-parse/ HTML/Javascript downloadable log parser], works on your Android/iOS phone to decode log files on the same device.

==Firmware Update==

On 2017 and newer Zeros, it's possible for the user to upgrade the firmware via the Zero Motorcycles mobile app.
: The app will provide a notification, and when clicked it will walk the user through a step-by-step process.
: This can update both the BMS and MBB firmwares.
: The process is shown below.

;Screenshots
<gallery widths=200px>
File:firmware-update1.png|"New firmware update available" notification
File:firmware-update2.png|Firmware Update step 1: MBB and BMS version listing
File:firmware-update3.png|Firmware Update step 2: Prerequisites
File:firmware-update4.png|Firmware Update step 3: Start Update
File:firmware-update5.png|Firmware Update step 4: Update in Progress with Stop Update button
File:firmware-update6.png|Firmware Update step 5: Update in Progress with MBB progress bar
File:firmware-update7.png|Firmware Update step 6: Update in Progress with BMS progress bar
File:firmware-update8.png|Firmware Update step 7: Update Complete confirmation screen
File:firmware-update9.png|Firmware Update step 8: Main Screen after update
</gallery>

=Common Problems=


==Pairing==
# Ensure the following:
#* The kickstand is down.
#* The kill switch is in the Stop position.
#* The key is in the Off position.
# Turn the key to the On position and:
#* For 2014+ models, hold the Mode button for five seconds
#* For 2013 models, toggle the SPORT ECO switch 12 times.
# Then select the motorcycle to pair from your device:
#* On Android, select Setup, Available Devices, Scan.
#* On iOS, use the Settings app, select Bluetooth, and scan for new devices.
# When Zero Motorcycle appears, pair to it and verify the six digit code.

==Unable to Connect==
Sometimes the MBB will simply no longer activate a session with the mobile device.

;Official Guidance
: [http://www.zeromotorcycles.com/app/help/ios/connectivity.php Zero's Bluetooth Connectivity Guide] covers:
:* Turning on Bluetooth Discoverability on the bike.
:* Connecting on iOS
:* Connecting on Android
: [http://www.zeromotorcycles.com/app/help/ios/faq.php Zero's Mobile FAQ] covers:
:* More Bluetooth connection questions
:* Some insight into the statistics shown in the app
:* How to kill the app (which helps reset a software connection management problem)

;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.

;Reconnection
: The app's UI is identical for iOS and Android which has some annoying results, because each platform handles Bluetooth connectivity differently.
: When the app is disconnected from the device, a dialog will appear offering to use the app in offline mode or visit the settings screen.
:* On Android, the settings screen can reconnect to the device, whereas on iOS, this feature is not possible.
:* On iOS, to reconnect, visit the Settings app itself, navigate under bluetooth, and reconnect to the device in the list presented.

==Unable to Customize [[Drive Modes|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

togo reports no version since 1.3.17 works on his 2014 Zero SR.

==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==
;Newer Android versions
The e-mail log files functionality on Android phones/tablets with newer Android versions does not work, the application crashes after downloading the log files but before offering to e-mail the files.
* Workaround 1: The logs are saved on the internal memory on this path: "internal_memory\android\data\com.zeromotorcycles\files\".
[http://electricmotorcycleforum.com/boards/index.php?topic=8736.0 See dalamarios forum entry here]
* Workaround 2: If you have access to an Android device with an older Android OS version, you may have more luck downloading and mailing using that device. I had success using an old tablet with Android version 4.4

;BMS 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|MBB Console]] directly via OBD-II connection.

==Stuck Screen==

==Stuck Orientation==
1
edit

Navigation menu