LeafSy Help Version 1.1.0 (Android)

Note: This Help is available as a PDF file by sending an email with a subject of "Android PDF Help" to WattsLeft.meter@gmail.com. If you find any errors or have suggests for improvements please send them to the same email address but with subject "Android Help file".


OVERVIEW

LeafSpy extracts and displays information from the Leaf through a user supplied OBDII adapter plugged into the Leaf's OBDII connector located under the Leaf's dash. OBDII adapters come in three basic types depending on the method used to communications with your Android device. The three types are standard Bluetooth (requiring a pairing step), Bluetooth 4.x LE (no pairing needed) and WiFi. See the OBDII Hardware section for recommendations.

Leaf Spy consists of from 2 to 5 main information screens depending on the version of Leaf Spy you have installed.

Leaf Spy Lite has two main screens. The Battery Status screen and a second screen that can be toggled between displaying the variation in voltage levels between the 96 cells that make up the High Voltage battery pack (the less variation between cells the better balanced and the more energy the pack can hold) and a display of the four (2011-2012 MY) or three (2013 on up MY) battery pack temperature sensors.

Leaf Spy adds three additional graphs to the second screen and adds two additional screens (3 and 4).

In addition to the voltage histogram and temperature chart the second screen can also display a graph of charging power, %SOC, %Gids and if quick charging battery temperature during a charge and an elevation/speed graph. Just tap on the second screen to cycle through these four graphs/charts.

The two additional screens (3 and 4) are a simple summary screen showing key information in a large font and a more detailed summary screen showing much more information such as estimated driving distance remaining, tire pressures and energy usage per function (motor, accessories, heater, A/C).

Leaf Spy Pro adds a Service screen (5) that allows viewing and changing service information normally only available to the dealer such as reading/clearing Diagnostic Trouble Codes (DTC) and an experimental Brake monitor/Motor Power screen.

Overview of Screens

Located in the lower left corner of each screen is an indicator that shows how many screens are available (2,4 or 5) and which screen is currently displayed. Swipe left or right to change to the next or previous screen. You can also tap the bottom center of the screen to select the next screen or do a long tap to select the previous screen. First and last screens wrap.

In the upper right corner of most screens are three dashed line. If your device does not have a dedicated key or key sequence to bring up the application's menu then tap this area to bring up the LeafSpy Menu. The Menu has options to select the OBDII adapter LeafSpy should use (go here the first time you start LeafSpy), access the Settings menu, view the trip log, bring up the About screen (from which you can access the change history and built-in LeafSpy help screens) and exit the application.

Pressing and holding down on the three dash lines in the upper right corner of a screen will display an overlay of "hot" areas on that screen that can be tapped along with a short description of their assigned function(s).

The 12 volt battery voltage is displayed in the lower left area of the first four screens. Battery current (amps) will also be displayed for model years 2011/2012. Depending on screen size you may need to be in landscape mode to see the 12 volt battery's current (amps) reading.

Screen 1 is the Battery Pack Status screen. The top of the screen shows the battery AHr rating (which will slowly decline with age), State of Health (SOH), battery pack voltage and current, VIN/pack serial number, Hx (% of new battery conductance), odometer, Quick Charge cycles and L1/L2 charge cycles/connections.

The center of the screen shows a bar chart of the voltage of each of the 96 cell pairs making up the High Voltage battery pack. In the upper right corner is the voltage difference between the highest and lowest cell in millivolts(mV). Tap the top of the chart to zoom out and bottom to zoom in. A Red colored voltage bar indicates a small bleeder load is being applied to that cell in order to drain energy from it to better balance it with the other cells.

The bottom area below the x axis lists the minimum, average, maximum cell voltages and delta between the minimum and maximum cell voltages as well as the temperature readings from the 3 or 4 sensors monitoring the battery pack. The delta between lowest to highest temperature sensor is also displayed.

Along the left edge is the selected mV scale with 50 mV being the smallest. Zooming In and Out changes this scale.

Screen 2 displays one of five graphs. Tapping the center of the screen selects the next graph and a long tap selects the previous graph. The number of the current graph is displayed on the bottom left of the screen.

Graph 1 is a battery cell Histogram that displays the variation in cell voltages. Less variation between cells is a sign of a better balanced pack that can hold more usable energy.

Graph 2 displays the battery pack temperature sensors.

Graph 3 displays the active or last charge cycle monitored by LeafSpy. The graph plots the SOC%, Gids% and charge power as the battery is being charged. During a Quick Charge the battery pack temperature is also graphed. The graph is automatically saved at the end of a charge for later review.

Graph 4 records the elevation and speed during a drive and auto resets at the start of each drive. The graph can be saved for later review. Note: The Android device must have GPS for this function to work.

Graph 5 is the "Efficiency" graph that displays the last 32 samples of efficiency which occur at 1 km intervals while driving. The most recent sample appears on the right. Swiping up or down selects a Wh/mile(Wh/km) or miles/kWh(km/kWh) display.

Screen 3 is a table showing State of Charge, available battery energy in kWh, current battery Ah, battery voltage, a Wh counter that shows energy used during a drive, battery temperature, estimated distance remaining and Gids. At the bottom of the screen is a displays of the Climate Control state including HVAC mode, power used, fan speed, air flow direction and set temperature.

Screen 4 is the Summary screen. It displays battery and energy usage information, power used per function (motor, accessories, PTC heater, A/C), tire pressures, delta between tires, estimated trip distance and outside temperature.

Screen 5, when enabled, adds a Service screen that allows viewing and changing service information normally only available to the dealer such as reading/clearing Diagnostic Trouble Codes (DTC), reading all the ECU version numbers and battery serial number and changing the auto headlight on/off, interior light on/off and auto door lock/unlock conditions.

OBDII Hardware

In order for LeafSpy to communicate with a Leaf a user supplied OBDII adapter must first be installed in the Leaf's OBDII socket located under the dash above the driver's left knee. The Leaf must be turned on (dash gauges active, not just ACC mode) and after starting LeafSpy for the first time the OBDII adapter must be selected using the "Select OBDII" option. LeafSpy supports three types of OBDII adapters: Bluetooth 4.x LE, standard Bluetooth and WiFi.

The recommended OBDII adapter type is the newer Bluetooth 4.x LE which is low power and requires no pairing. There are two supported Bluetooth 4.x LE adapters the LELink available from Amazon and the PLX Kiwi 3. Of the two the LELink is the recommended adapter.

The cheap standard Bluetooth OBDII adapters available on ebay and other places are hard to recommend due to two issues. The first is that most standard Bluetooth OBDII adapters are cheap clones of the original ELM327. This was originally not a problem as they supported the required ELM327 commands to communicate with the Leaf. But a year or two ago these cheap adapters started to change as outline below in more detail. They were cost reduced resulting in critical ELM327 commands not needed to communicate with a gas car being dropped. Instead of reducing the version number (fewer commands supported) the version number either stayed the same (1.5) or changed to 2.1. Making the version number meaningless. An adapter that really supported the ELM327 v1.2 or v2.1 command set would work with LeafSpy.

The second issue is with the Bluetooth OBDII adapter that had previously been recommend which was the Konnwei KW-902. This supported the required commands but has recently been cost reduced. However, the cost reduction is not the issue as the supported commands are still there. Instead the wrong resistor is being used to terminate the +/- CAN signals. Due to a design or manufacturing error instead of a 120 ohm resistor being used it was changed to a 20 ohm resistor. If plugged into the Leaf this low resistor value will prevent the CAN bus from functioning properly and can result in an i-Key fault, not being able to drive the Leaf and other strange behavior. If you have a Konnwei KW-902 you should check the resistance between pins 6 and 14. A reading of 20 ohms indicates a defective adapter which should not be plugged into your Leaf. The CAN bus is fault tolerant so if you have plugged it in unplugging should allow the Leaf to resume normal operation.

If you are lucky enough to already have or buy a standard Bluetooth OBDII adapter that still support the full command set the adapter must first be paired with the Android device using the Android Bluetooth Settings menu. The typical PIN is "1234". Then when LeafSpy is first started go into the LeafSpy Menu and select the "Select OBDII" => "Bluetooth Paired Devices" to bring up a list of paired device. From the list select the OBDII adapter then reenter the PIN.

At this time it seems all WiFi OBDII adapters support the required ELM327 commands and can report v1.5 or v2.1. Most are large and will extend about 3" down from the bottom of the dash so could interfere with your legs. Being WiFi they have a much longer range but the tradeoff is much higher power drain from the Leaf 12v battery when the Leaf is off. When LeafSpy is first started go into the LeafSpy Menu and select the "Select OBDII" => "WiFi Devices" to bring up a list of Networks. Select the OBDII adapter network and if a password is required enter it on the next screen.

----------------------------------------

Recently it has become harder to find a low cost OBDII Bluetooth adapter that works with the Leaf due to a recent cost reduction change made by many of the Asian manufactures of clone ELM327 adapters. These manufactures have eliminated the dedicated PIC processor that decoded and execute the ELM commands. That function has now been combined into the existing Bluetooth processor saving several dollars in cost. Whether because of code space limitations or inexperience in the ELM command set the critical commands needed to communicate with the Leaf have been dropped. To make things confusing for the buyer these lower cost (to produce) ELM327 adapters are given a version number of 2.1 instead of the previous 1.5 designation. Since commands have been dropped not added it is totally inaccurate to label them as 2.1 which should match the version of the ELM command set supported. Adapters bought from the same seller before and after the change can look exactly the same outside. Only by opening them up for examination can a difference be seen (lack of PIC processor).

LeafSpy does not look at the version number reported by the ELM327 adapter. It is not until LeafSpy attempts to configure the ELM327 for communications with the Leaf does LeafSpy discover the lack of support for the needed ELM commands. If the ELM327 reporting a version number of 2.1 actually supported the official version 2.1 ELM command set it would work with LeafSpy. This incorrect labeling as version 2.1 gives the impression that LeafSpy does not support ELM version 2.1 which is total incorrect.

Recent Changes

On screen 1 the difference between the highest and lowest cell voltages is now displayed in a large font in the upper right side of the screen. Optional "monitor" information is displayed on the left side.

Added an "Efficiency" Graph that displays efficiency for the last 32 km in 1 km intervals.

Three new Service functions. Configure Headlight auto turn on/off conditions, Configure Interior light turn off conditions and read/display ECU version information. The ECU information read also includes the battery pack serial number which once read will alternate with the VIN at the top of screen 1.

Service function now supports reading DTCs from the VSP and AVM ECUs. The DTC clear function supports clearing the special P0AA1 DTC.

Server support that allows information to be periodically sent to a predefined server. Server configuration is done on the Settings/Server panel. At the bottom of screens a period "." after the date indicates that the server function has been enabled.

Tire pressures can now be displayed in kPa units.

Motor and Inverter temperatures are displayable in the user selectable area on screen 4.

The efficiency used to calculate remaining range to event can now be automatically calculated using current Trip average, since last charge average or last km average.

Four new options on the Settings/Options panel. One to disable the automatic selection of the energy usage graph on screen 4 if the PTC heater is active, others to disable all sound, save Trip/Charge log when exiting app and a special "Cyanogenmod" mode to try to work around that OS's poor Bluetooth implementation.

Support for two Bluetooth 4.x Low Energy (LE) OBDII adapters (LELink and PLX Kiwi 3). These adapters require no setup or pairing but only that Bluetooth be enabled. They are recommended over the previous standard Bluetooth and WiFi OBDII adapters because of their ease of use and low power from both the Android device and the Leaf.

In BMS only mode the maximum logging rate has been increased to less than once per second.

If Dropbox has been enabled then exiting LeafSpy will force a final synchronization of the selected files.

At the start of a drive tire pressures warnings are suppressed until the TPMS units wake up and start sending pressure data.

Used a better calculation for Ambient temperature. A manual adjustment is no longer needed.

Used a new calculation for motor power which gives a more accurate value for both 2011-2012 and the newer 2013+ Leafs.

Fixed problem where corrupt configuration files would cause LeafSpy to crash on startup.

Elevation and Charge graphs time axis now scales to minutes, hours and days.

Charge graph has the option (by swiping up/down) to fill in missing data through straight line approximation.

Key Features

Dropbox Synchronization Added support for syncing selected file types with your Dropbox. The Dropbox app does not need to be installed to use this feature. A sync interval of 1, 2, 5, 10 or 15 minutes can be specified. By default the Trip/Charge log is always synchronized. The other types of files that can be synchronized are:

A new folder structure is created in your Dropbox to hold the uploaded files. The new folders are:

Alternate Method to Read Tire Pressures Use this new option on the Settings/Tire Pressure panel when the default method does not work (seen on 2015 UK Leafs).

Remap Tire Pressures As an alternative to doing a Tire Registration this option on the Settings/Tire Pressure panel allows you to simply move the pressures readings around to match their actual location on the Leaf.

Virtual Tire Registration This option on the Settings/Tire Registration panel is used after the tires have been rotated to automatically remap the tires to their new locations based on the type of rotation selected. To use this option the tires must have been displayed in their correct position before the tires were rotated.

Soft Menu A soft Menu key (marked by three dashes) is available in the upper right corner of screens 1 thru 4. Tapping this area brings up the menu to Select OBDII, Settings, View Trip Log, About & Help or Exit. This provides a way to bring up this menu on newer android devices that do not have a dedicated menu key.

Overlay Help In addition to bring up the Menu the upper right area also serves as a way to overlay the current screen with help information about tap sensitive areas. By pressing and hold down on the upper right corner (marked by the three dashes) an overlay will appear. Areas marked in a gold color are single tap areas and areas marked in green have both a short and long tap function.

Countdown Counter On screen 4 a user settable distance Countdown counter can be displayed by doing a long tap on the distance remaining to event number. When enabled the Countdown counter will be displayed to the left of the distance to event number. The Countdown counter number will also have a down arrow to its right. The default starting distance is controlled on the Settings/Trip Distance panel. The value can also be changed on screen 4 by holding down either the plus (+) or minus (-) button. The font size of these two numbers can be changed by placing the screen in "Screen Frozen" mode (tap lower right status box) and then using the +/- buttons to adjust the font size.

Background Logging is supported. This means that if Logging is enabled it will continue even if Leaf Spy loses focus as when another application is started. Depending on your Android device logging may continue even when the Android device is placed in sleep mode..

You can determine if your Android device supports background operation while in Sleep mode by running Leaf Spy until it connects to the Leaf then place the Android device in Sleep mode. Look at the OBDII adapter and if you see a light flash every 5 to 10 seconds the background function is still active. Logging does not need to be active to run this test.

Brake Force graph & Motor Power graph are experimental features of Leaf Spy Pro. It consists of a new graph screen that can be toggled, by tapping it, between showing a Brake Force screen or a Motor Power screen. Warning: If you experience any connection problems or problems moving between screens then Disable this feature!

Both screens show regeneration either as a portion of the braking force being applied to the wheels or as power being generated by the motor. To enable this function go to the Settings/Braking & Motor Monitor panel and check Enable. This panel also has an option to control the Brake Window size which controls the number of seconds of Brake history that is displayed. Another option controls whether braking force is displayed at the top of the Motor monitor screen.

If you have the Service Screen enabled it will override displaying these graphs. To see these graphs just disable the Service Screen in Settings.

___________________________________

Navigation

There are two ways to move between screens.

Swiping - Use your finger to Swipe left or right. Choose an area of the screen that does not have active touch areas (Buttons). Starting your swipe off the active screen also seem to work better.

OR

Tapping - To move to the next screen Tap the *O*** area at the bottom left half of the screen. To move to the previous screen Tap and hold your finger down.

,___________________________,
|,_________________________,|
||      In this area       ||
||                         ||
||   swipe left or right   ||
||                         ||
||     to move between     ||
||                         ||
||         screens         ||
||                         ||
||                         ||
||   Avoid swiping over    ||
||  "Active" areas such    ||
||       as buttons        ||
||                         ||
|:_________________________:|
|___________________________|
|,_______________,,________,|
||Tap/Long Tap to|| Status ||
||*OOOO Chg Scrns||  Area  ||
|:_______________::________:|
:___________________________:

Status Area

The bottom right corner of most screens contains a status box. This colored status box indicates the current state of the connection to the ELM OBDII adapter and the Leaf. The general meaning of the colors is:

...status.... Yellow: trying to connect to ELM Adapter
...status.... Orange: ELM ok, trying to connect to Leaf
Connected Green: connected to Leaf, command number
Screen Frozen Gray: the screen is frozen for viewing
Offline Blue: means the link is Offline

Tapping the colored status box will toggle between showing status and the Screen Frozen state. When in the Screen Frozen updates to the screen are suspended. Data is still read from the Leaf but is not updated to the screen. Use this mode to study the data on the screen without it being updated with another sample. This mode also suspends displaying the periodic connection retry messages.

Menu

The Menu button (three stacked lines) is located in the top right corner of the screen. Tapping the Menu area will bring up a menu of items across the bottom of the screen. The five menu items are Select OBDII, View Trip Log, Settings (Gear), About/Help and Exit.

Select OBDII - Use this option when LeafSpy is first installed or when changing to a different OBDII adapter. Select from a list of OBDII types.

__ Bluetooth 4.x LE - Selecting this option causes LeafSpy to automatically search for one of the two supported Bluetooth 4.x OBDII adapters (LELink & PLX Kiwi 3). There is no pairing needed or possible with a Bluetooth 4.x LE device.

__ Bluetooth Paired Devices - Selecting this options brings up a list of currently paired Bluetooth devices. Be sure to pair any new Bluetooth OBDII device before selecting this option or it will not be in the list. Go to the Android Settings/Bluetooth screen to search for and pair with any new OBDII device. When prompted enter the password used during pairing.

__ WiFi Devices - Selecting this options brings up a list of WiFi networks. From the list select the network of you WiFi OBDII adapter then if needed enter the network password.

__ Work Offline - Select this temporary option if you wish to use LeafSpy to review data without connecting to a Leaf. It does not change the previously selected OBDII adapter. It only disables using it during this LeafSpy session.

View Trip Log - Selecting this item displays the Trip Log. Once the trip log appears a single tap will force a jump to the most recently completed trip located at the bottom of the screen.

Note: A trip Start occurs when the app first detects the Leaf's drive motor rotating. A trip End occurs when the app detects the Leaf has been turned off. To ensure correct detection of the end of a trip, after turning the Leaf off please wait for a beep sound and the word "Saved" to be displayed to the right of the trip timer at the top of screen 4. When you see "Saved" and/or hear the beep the trip has been record to the Trip Log.

Settings - Selecting this item brings up the Settings screen. See bottom of help for all available settings.

About/Help - Selecting this item brings up a panel displaying the following information.

Exit - Use this option to exit the LeafSpy application and stop communications with the Leaf.


[O****] Screen 1
Battery Status
The Battery Status screen can be divided into three sections: top, middle and bottom.

Pressing the three dashed line area in the upper right corner will bring up the screen help overlay that identifies areas that can be tapped to change what or how things are displayed. Orange areas have a single tap function and Green areas have both a short and long tap function.

,___________________________, _,
|                           |  |Top
|  Battery Status Area      |  |Section
|___________________________| _:
|,_________________________,| _,
||                         ||  |Middle
||                         ||  |Section
||     Tap top half to     ||  |
||                         ||  |
||         zoom out        ||  |
||                         ||  |
||_________________________||  |
||                         ||  |
||                         ||  |
||   Tap bottom half to    ||  |
||                         ||  |
||         zoom in         ||  |
||                         ||  |
|:_________________________:| _:
|___________________________| _,
|                           |  |Bottom
|   voltage range & temp    |  |Section
|___________________________| _:
|,_______________,,________,|
||Tap/Long Tap to|| Status ||
||*OOOO Chg Scrn ||  Area  ||
|:_______________::________:|
:___________________________:

Top Section has the following information:

AHr Ampere/Hour is a rating of the present battery capacity. This is determined by the Battery Management Controller in the Leaf and decreases as the battery ages. It gives an estimate of the battery's capacity to hold energy when fully charged, not how much energy is currently in the battery. Think of it as the size of the tank not how much is currently in the tank. As the battery ages this number will decrease indicating that less and less energy can be stored in the battery when fully charged. If you have a laptop you have seen this happen. The amount of time the laptop can run on a fully charged battery decreases as the batteries get older.

SOH State of Health is another indication of the battery's ability to hold and release energy and is reported as a percentage. When the battery is new SOH=100%. When SOH drops to 85% for a month or so the Leaf loses the first capacity level segment displayed on the right side of the Leaf's central dash display. The capacity gauge is the rightmost outer curved column of segments next to "1" at the top and "0" at the bottom with the last two segments being colored red.

xxx.xxV Voltage of high voltage battery. Example "380.21V" or 380.2V depending on which ECU provided the reading.

xxx.xA Amperage of the high voltage battery is displayed in landscape mode and also in portrait mode if you have a high resolution screen. A positive value indicates current out of the battery and a negative value current into the battery (Regen or charging).

VIN/Battery Serial # The vehicle identification number indicates which vehicle the data came from. It is surrounded by parentheses if the data being displayed is saved data as opposed to data just read from a Leaf. If the ECUs have been read using the Service function then the High Voltage battery pack serial number will alternate with the VIN. Use the Freeze Screen function to temporarily stop the alternating.

Hx The meaning of this number is not fully understood but it appears to be inversely related to the battery internal resistance. As the internal resistance of the battery pack increases it is thought this percentage decreases. As internal resistance increases more energy is lost within the pack and the pack heats up more under load.

xA yV Example 31A 244V or 31A 5V (Only available on Models 2011/2012) When an EVSE is plugged into the Leaf these numbers indicate the maximum available current the EVSE can provide the Leaf and the voltage supplied by the EVSE. For the first example the EVSE can provide up to 31 amps of current and is supplying a charge voltage of 244 volts. The second example shows the reading when the EVSE is attached to the Leaf but the Leaf is not charging. In this case a voltage reading of around 5 volts can be expected.

Odo Odometer reading in either miles or km depending on units selected in Settings/Units.

QCs Number of Quick Charges. Each time a Quick Charge occurs this number increments by 1.

L1/L2s Number of L1/L2 connections and charges. This number increases each time the J1772 charge cord is plugged into the Leaf. It also increases by one for each delayed charge that takes place. If the Leaf charge timer is not active, so charging starts immediately when the charge cord is plugged in, then the count will increase by only one. But if the timer is active then the count will increase by two. Once when the charge cord is initially plugged in and a second time when the timer starts the delayed charge.

The Middle Section of the screen contains a bar graph showing the voltage for each of the 96 cell pairs that make up the High Voltage battery pack. Highlighted bars in Red indicate a shunt is active for that cell pair which drains a small amount of energy to balance the cell with the others. To Zoom Out tap on the top half of the graph. To Zoom In tap on the bottom half of the graph. The present scale is shown on the left side and can range from 50 mV to 1600 mV with a scale of 4500 mV automatically selected if a shorted cell (0 Volts) is reported.

Overlaying the right top side of the Middle Section is the cell difference voltage in a large easy to read font. This difference increases as the battery approaches empty.

Monitoring information can be overlaid on the left top side of the Middle Section. By default this information is hidden. Tap the area to cycle through the available monitor information.

The Lost frame count should normally be zero. If not zero the count can be monitored to determine what activity or condition results in lost frames.

The cycle time can be used to compare difference OBDII adapters and devices to gauge their performance. A faster cycle time results in more frequent updating of data on the screen.

The Bottom Section shows the minimum, average and maximum cell pair voltages with the difference between minimum and maximum voltage in parentheses. The second line shows each of the battery temperature sensor readings (3 or 4 depending on model year) with the difference between low and high in parenthesis. The units used are selected by the Settings/Units panel.

The SOC field is located at the bottom left corner of the screen.

SOC State of Charge indicates the amount of charge currently in the battery. The amount of energy this represents is not fixed but decreases over time as the battery ages. Since capacity decreases with age a new battery at 50% SOC holds more energy than a 5 year old battery at 50% SOC.

Note: The SOC displayed here is not the same as the one displayed on the dash of later model Leafs. What is displayed by LeafSpy Pro is the true SOC as reported by the battery management computer. The one on the dash is adjusted to respond like a traditional gas gauge. The dash gauge will show 100% and 0% whereas the real SOC never reaches those values in order to protect the battery and extend its life.

Cell Voltage Loss Inspection This test is run automatically anytime the Leaf is ON (not ACC mode), in Park and the minimum cell pair voltage is below 3.713 volts (i.e. below low battery warning level).

This "Cell Voltage Loss Inspection" test is based on Nissan's originally published algorithm (2011 April Service Manual, section EVB-67) with the addition that there must be at least a 200 mV difference between the maximum and minimum cell pair voltage to run the test. The results of the inspection replace the battery temperature sensor status line just below the x axis on screen 1. Any weak cells are listed as "Weak Cells: xx yy zz" in red with xx yy zz being the weak cell numbers. If the test finds no weak cells the message "All Cells OK" will be displayed in green.


[*O***] Screen 2
Graphs

Depending on the version of LeafSpy, either two, four or five graphs can be viewed on screen 2. Tap the center of the screen to cycle to the next graph or do a long tap to move back one graph. The currently selected graph's number is shown in the lower left corner of the screen in x of y format (e.g. "2 of 5" or "2 of 2").

Pressing the three dashed line area in the upper right corner will bring up the screen help overlay that identifies areas that can be tapped to change what or how things are displayed. Orange areas have a single tap function and Green areas have both a short and long tap function.

1) Voltage Histogram

This graph gives a visual representation of how well the 96 cells making up the battery pack are balanced. For a perfectly balanced pack all cells would have exactly the same voltage which would be represented on the histogram as a single bar with a height of 96 cells.

The minimum, average and maximum cell voltages are listed at the top of the screen and the voltage difference between the highest and lowest cells is listed below the x axis in millivolts (thousands of a volt). The y axis is in units of cell pairs and auto scales. The y axis label shows the current magnification level of the x axis and ranges from 50mv to 1600mv. To change the magnification level go to screen 1 and tap on the upper (zoom out) or lower (zoom in) half of the screen.

2) Battery Temperature

This graph shows either 4 (2011/2012 models) or 3 battery temperature sensors. If the incorrect number of sensors is displayed go to Settings/Model Year panel and make sure the Leaf model year is set correctly for your Leaf. Displayed units (Fahrenheit or Centigrade) can be changed on the Settings/Units panel.

The top of the screen lists the available sensors. Starting in 2013 Nissan removed sensor 3. The maximum, minimum temperatures and in parentheses the temperature difference between the highest and lowest sensors is displayed below the x axis. The y axis auto scales depending on the temperatures. The color of each bar changes based on the temperature of the corresponding sensor.

3) Charge Graph

This screen plots charging power and power going into the battery in kW, percent State of Charge (SOC) and percent Gids during an L1/L2 or Quick Charge. During a Quick Charge the battery temperature is also plotted. Depending on your Leaf you may be able to keep LeafSpy running while charging even with the Leaf off. Graphs can be saved and loaded for later viewing. Files are saved in csv format. A sample Quick Charge graph is displayed when LeafSpy is first installed.

The first title line displays two power numbers in kW. The first number is the power in kW going into the battery pack and the second number is the power the charger is reporting. Normally these numbers are the same or almost the same. Following the two kW numbers is the file name if the data has been saved. If the data has not yet been saved the words "Not Saved" will be displayed. The data is automatically saved at the end of a charge session. For an L1/L2 charge session the file name will be of the form Qxx_Lyyy where xx is the number of Quick Charges and yyy is the number of L1/L1 charges/connections. For a Quick Charge the file name will be of the form Qxx_yyy (without the "L") where xx and yyy are the same as for an L1/L2 charge. The name difference makes it easy to distinguish an L1/L1 file from a Quick Charge file.

The second title line and optionally third title line show the current (charge in progress) or last (if charge has ended) SOC percent, Gids percent and if a Quick Charge the battery pack temperature. The color used to graph each of these parameters is also given.

The y axis label lists the colors used to plot the power. The left side y axis numbers auto scales in units of kW. The right side y axis label is in percent 0 to 100 and is used to read %SOC and %Gids. There is no scale for the battery pack temperature but the 100% mark corresponds to 150F/65.6C and the 0% mark to 0F/-17.7C.

Press the "Save/Load" button to force a save or to load a previously saved charge file for viewing. Graphs are saved in csv format.

Tap on the bottom corner status box to enable Zoom/Scroll. Use two fingers to zoom in/out and a single finger to scroll left/right.

4) Elevation Graph

Since elevation changes can affect driving range this graph allows you to see the elevation changes along the route as you drive. The elevation and speed data does not come from the Leaf but instead from the Android device's GPS. Therefore this graph only applies to devices that have a built in real GPS function. Accuracy of the plotted data is dependent on the number of satellites and how long it takes the GPS controller to acquire these satellites. As a result, the graph will give a general idea of the topography driven over but is not an absolute indication in terms of elevation plotted. A sample elevation graph is displayed when LeafSpy is first installed.

Due to the inherent inaccuracies of GPS determined elevation it is not uncommon when driving a round trip for the starting and ending elevation to not match up even though you returned to the exact same spot.

The graph will automatically clear at the start of each drive and can also be manually cleared by tapping the Save/Load button and selecting Clear.

The top title line displays the file name if the data has been saved. Once GPS has locked on to sufficient satellites, the second title line displays the elevation, (accuracy), speed and (color of speed plot) (Elevation 285 (+/-13) Speed 19 mph (Red)).

The left axis label gives the units of elevation and the color of the elevation plot. The right y axis units are mph or km/h. The x axis automatically scales as more data is added to the graph.

Plots can be saved and loaded by using the Save/Load button. The plot name is automatically assigned in the format ES_yymmddhhmm with yy mm dd hh mm being year month day hour minute. Graphs are saved in csv format.

Tap on the bottom corner status box to enable Zoom/Scroll. Use two fingers to zoom in/out and a single finger to scroll left/right.

5) Efficiency Graph

This graph plots the efficiency of each full km of travel displaying up to the last 32 km of travel. To make it possible to identify separate trips the color of the bars alternates between trips. Swipe up or down to switch between graphing efficiency as Wh/distance or distance/kWh. The top line displays the most recent efficiency number followed by the average efficiency of the graph. The bottom of the graph shows the minimum and maximum efficiency values on the graph.

Tap the Clear button to bring up a menu to allow clearing just the oldest sample, all samples or to Save the graph in csv format. The file name will be of the form Eff_last8ofVIN_date_time.csv.


[**O**] Screen 3
Simple Summary

The Simple summary screen provides the following information in a large text format for easy viewing. The top of the screen displays information about the battery and energy usage while the bottom displays information about the climate control system.

Pressing the three dashed line area in the upper right corner will bring up the screen help overlay that identifies areas that can be tapped to change what or how things are displayed. Orange areas have a single tap function and Green areas have both a short and long tap function.

There are five buttons on this screen. The text on all but the Reset button is used to displays additional information.

"Reset" This button only appears if the energy usage counter can be reset. This is controlled with the Config Wh Counter pulldown on the Settings/Battery panel.

"F" or "C" & type Use this button to change the type of temperature displayed to either the maximum, average or minimum battery temperature. The button text shows the units, type and in parenthesis the delta between the highest and lowest sensor readings.

"miles" or "km" This button and the following button are only enabled when using the manual method for setting efficiency. They are disable when "Trip" (T), "Since Last Charge" (C) or "Instantaneous" (i) modes are selected. The efficiency mode used is selected on Screen 4. In manual mode use this button to increase the efficiency number used to calculate the range to event. The text shows distance units (miles/km) and the currently select event (LBW, VLBW, x% or x.xkWh). The event can be changed on Screen 4 and for the percent or kWh selection on the Settings/Range panel.

Efficiency Use this button to decrease the efficiency number used to calculate the range to event when using the manual method for determining efficiency. The top line of the button lists the current efficiency number being used. If that number is prefaced with a letter the efficiency is being automatically calculated based on distance traveled and energy used. There are three automatic modes based on distance used for the calculation. The following table lists the letter and distance used in the calculation.

The text on the bottom of the button shows the units of efficiency (miles/kWh (km/kWh) or Wh/mile (Wh/km)) which can be changed on the Settings/Range panel.

"GIDs" Use this button to switch between displaying the Gids value or Gids percent to the left of the button. The value not being display to the left of the button is displayed on the button. The percentage is based on the maximum Gids entered on the Settings/Battery panel. Default is 281 Gids for the 24 kWh pack and 357 Gids for the 30 kWh pack. In landscape mode this button is moved to the top.

The following information is displayed on the upper section of the screen.

SOC = State of Charge: This is being read directly from the Leaf's battery management system (BMS) and is based on the current capacity of the Leaf battery. That means if you charge your Leaf to 80% then at the completion of the charge the SOC will always be 80% even after 8 years when the battery capacity has dropped to say half its original capacity. It is not an indication of the energy contained in the battery. (Think of a shrinking gas tank. It can always be filled to the top so 100% full but its size has shrunk from 10 gallons to 5 gallons.)

Note: What is displayed here is the true SOC and may differ from the one displayed on the Leaf dash. To protect the battery Nissan prevents the battery from being fully charged to 100% and drained to 0%. However, this would be confusing to drivers expecting a full charge to be 100% so the dash SOC is adjusted to display 100% when in fact the SOC is less. What is displayed here is the true engineering SOC value.

Ah This is a prorated Ah number based on full charge Ah times present %SOC. So if SOC=50% then Ah displayed here would be half the fully charged Ah displayed at the top of screen 1.

V This is the voltage of the high voltage battery pack. A voltage format of xxx.xx indicates the reading is coming from the BMS unit and a format of xxx.x indicates the reading is coming from the VCM unit. When the BMS is not responding the VCM value is reported instead.

kWh = Approximate energy currently stored in the battery. This number is calculated by multiplying the number of Gids read from the Leaf times the Wh/Gids set on the Settings/Battery panel. The default Wh/Gids is 77.5. The calculated kWh gives the best indication of available energy in the battery.

Wh Resettable counter that keeps track of energy changes in the battery. As the available energy in the battery changes this number is updated. In general as you drive this number will increase giving an estimate of the energy used. While charging or during motor regeneration this number will decrease indicating an energy increase in the battery. If present, tapping the Reset button while a trip is active will clear all but the energy for this trip. If no trip is active then pressing the Reset button will clear all energy used. What this counter accumulates (Drive/Charge energy) and when it gets reset is configured on the Settings/Battery panel.

Temperature Battery temperature either in C or F depending on the units selected on the Settings/Units panel. The number in parenthesis is the difference between the minimum and maximum sensor reading. Tapping the label to the right of the number cycles the number displayed through minimum, average and maximum temperature readings.

Range Is an estimate of the remaining range to event based on the selected efficiency. The selected units of the distance (miles or km) is displayed on the first button. The current efficiency selected is displayed on the second button. When using a manually entered efficiency, pressing the first button increases estimated efficiency and pressing the second button decreases estimated efficiency used to calculate the remaining range to event. The units of efficiency are set on the Settings/Range panel. The choices are Miles/kWh (km/kWh) or Wh/Mile (Wh/km). The distance remaining may include a selectable reserve determined by the Settings/Range panel.

GIDs This field indicates the remaining energy in the battery in terms of Gids. Gids is the name given to a value found on the Leaf CAN bus that tracked closely with the amount of energy remaining in the Leaf Battery. It was first discovered by Gary Giddings. Later it was determined that Nissan uses this field to indicate the amount of usable energy in the battery by multiplying it by 77.5. On a new 2011 Leafs the maximum Gids is typically 281 or (281 x 77.5) 21.78 kWh of usable energy from the 24 kWh battery. Tapping the label to the right of the value will toggle the value between Gids and percent Gids.

The following information about the Climate Control system is display on the lower section of the screen.

CC Mode This field displays the climate control (CC) mode which can be in one of the following nine modes:

Recirculate Air When this icon appears the Climate Control system is recirculating the air and has closed off the fresh air intake.

CC Power Displays the current power being used by the Climate Control system. This appears above the fan icon.

Fan Speed When the fan is active the fan icon will appear. In the center will be the current fan speed ( 1 to 7).

Set Temperature The Climate Control set temperature will appear above the air flow icon. The temperature units used is automatically set. If not correct please cycle the set temperature to its maximum and minimum values which will cause the correct units to be detected and used.

Air Flow The air flow icon will indicate the currently selected air flow direction(s) and if air is flowing to the windshield.


[***O*] Screen 4
Detailed View

This screen is divided into three sub panels. The largest is the energy panel which displays information about available energy and how that energy is being used. A second smaller panel alternates between displaying tire pressures and battery temperatures. The third panel displays a distance to event estimate where the event can be either Low Battery Warning, Very Low Battery Warning or distance to a predefined reserve amount of energy (defined on Settings/Range panel). A distance countdown counter can also be activated on the third panel

Pressing the three dashed line area in the upper right corner will bring up the screen help overlay that identifies areas that can be tapped to change what or how things are displayed. Orange areas have a single tap function and Green areas have both a short and long tap function.

Energy Panel

This panel can be divided into six sections:

1(Top Line Right of Center) 00:00:00 Trip/Charge Timer This timer automatically resets at the start of each drive or charge. At the end of a trip, when the Leaf is turned off, the current trip statistics will be appended to the Trip Log. A successful append to the Trip Log is indicated by the word "Saved" displayed to the right of the timer and a beep will sound. The Trip/Charge Log Viewer is accessed from the Menu. The Trip Log is a csv file that can be read by Excel and automatically uploaded to your Dropbox if Dropbox has been enabled on the Settings/Dropbox panel.

2(Large Top Left & smaller Right two numbers) xxx / yyy / zzz Battery Energy in Gids, %Gids and %SOC Tapping the large upper left number cycles which of the three values (Gids, % Gids or % SOC) is displayed in that position with the other values being displayed to the right.

3(One or two lines below Top Left number) Data Lines 1 & 2 User selectable Data Area This area can display one of five sets of extra data. Tap this area or the left side of the bar graph to cycle between each of the five choices.

     ,__________,
     |   Data   |
     |   Area   |
     :__________:
     ,_____,
     |,_,_,_,_,_,_,_,_,_,_,
     ||   ||  |   |   |   |_,
     ||   ||              | |
     ||   ||  |   |   |   |_:
     |:_:_:_:_:_:_:_:_:_:_:
     :_____:

Tap over the above RED areas to step through displaying the following sets of data: