LeafSpy Help Version 1.5.

0 (Android)
For LeafSpy Pro version 0.45.163 or higher.

Note: After running LeafSpy this Help is stored as a PDF file in

the .../Android/data/com.Turbo3.Leaf_Spy_Pro/files/DOCUMENTS directory. Send any corrections or suggestions
for improvements to [email protected] with a subject of "LeafSpy Android PDF Help".

OVERVIEW ............................................................................................................................................................................... 4
Overview of Screens ........................................................................................................................................................... 4
OBDII Hardware .................................................................................................................................................................. 6
Android Permissions ........................................................................................................................................................... 7
Recent Changes ................................................................................................................................................................... 8
Key Features...................................................................................................................................................................... 10
Navigation ............................................................................................................................................................................. 12
Status Area ........................................................................................................................................................................ 12
Menu ................................................................................................................................................................................. 13
Battery Status (Screen 1) ...................................................................................................................................................... 15
Graphs (Screen 2) .................................................................................................................................................................. 18
Graph Types ...................................................................................................................................................................... 18
Voltage Histogram ............................................................................................................................................................ 18
Battery Temperature ........................................................................................................................................................ 18
LeafSpy Lite/LeafSpy ..................................................................................................................................................... 19
LeafSpy Pro.................................................................................................................................................................... 19
Charge Graph .................................................................................................................................................................... 20
Elevation Graph................................................................................................................................................................. 20
Efficiency Graph ................................................................................................................................................................ 21
Custom Screens (Screen 3) ................................................................................................................................................... 22
Original Screen 3 ............................................................................................................................................................... 22
Custom Screens................................................................................................................................................................. 25
Label(LBL)/Variable Elements (LV, VL, LVL, VAR) .......................................................................................................... 28
Label/Variable (LV) .................................................................................................................................................... 28
Variable/Label (VL) .................................................................................................................................................... 28
Variable (VAR) ........................................................................................................................................................... 28
Label (LBL) ................................................................................................................................................................. 28
Image Elements (IA, IF, IR) ............................................................................................................................................ 29
1
 Gauge (GA) .................................................................................................................................................................... 30
Gauge Layout Assist Mode ............................................................................................................................................ 31
Gauge Pointer Colors (CGP, CGPx) ................................................................................................................................ 32
Gauge Colors (CG, CGB, CGS, CGT)................................................................................................................................ 33
Gauge Markers (GDM, GEM) ........................................................................................................................................ 33
Color Gauge Range (CGR,CGRx) .................................................................................................................................... 34
Conditional Tags ............................................................................................................................................................ 34
Draw Line(DL) ................................................................................................................................................................ 37
Draw Rectangle (DR) ..................................................................................................................................................... 37
Draw Text (DT) .............................................................................................................................................................. 38
Colors ............................................................................................................................................................................ 39
Color of Panel (CP) ........................................................................................................................................................ 39
Color of Line (CL) ........................................................................................................................................................... 39
Color of Variable (CV) .................................................................................................................................................... 40
Color of Drawing (CD) ................................................................................................................................................... 40
Color of Text (CT) .......................................................................................................................................................... 40
Label/Variable (L) Warning: Depreciated do not use ................................................................................................... 41
Detailed View (Screen 4) ....................................................................................................................................................... 44
Energy Panel...................................................................................................................................................................... 44
Tire/Battery Temperature Panel ....................................................................................................................................... 46
Tire Display .................................................................................................................................................................... 46
Battery Temperature Display ........................................................................................................................................ 47
Range & Trip Countdown Counter panel .......................................................................................................................... 47
Braking & Motor Power Graphs (Screen 5 if enabled) ......................................................................................................... 49
Service Functions (Screen 5 or 6) .......................................................................................................................................... 50
Door Lock/Unlock.............................................................................................................................................................. 50
Headlight Settings ............................................................................................................................................................. 51
Interior Light Settings........................................................................................................................................................ 52
VSP Settings ...................................................................................................................................................................... 53
Dashboard Language......................................................................................................................................................... 53
TPMS Management........................................................................................................................................................... 53
TPMS Overview ............................................................................................................................................................. 53
Available TPMS functions.............................................................................................................................................. 54
Tire Rotation ................................................................................................................................................................. 54
2
 Tire Registration ............................................................................................................................................................ 54
Read ECU versions ............................................................................................................................................................ 55
Read DTCs ......................................................................................................................................................................... 55
Clear DTCs ......................................................................................................................................................................... 56
Clear P0AA1................................................................................................................................................................... 56
Pair Battery P3102 ........................................................................................................................................................ 57
Data Logging.......................................................................................................................................................................... 58
Log File Format (csv) ......................................................................................................................................................... 59
Settings.................................................................................................................................................................................. 64
Settings.............................................................................................................................................................................. 64
Units .................................................................................................................................................................................. 64
Language ........................................................................................................................................................................... 64
Model Year ........................................................................................................................................................................ 65
Service Screen ................................................................................................................................................................... 65
Trip Distance ..................................................................................................................................................................... 65
Range ................................................................................................................................................................................ 65
Tire Pressure ..................................................................................................................................................................... 66
Battery............................................................................................................................................................................... 67
Battery Temperature ........................................................................................................................................................ 68
Logging .............................................................................................................................................................................. 68
Dropbox............................................................................................................................................................................. 69
Server ................................................................................................................................................................................ 70
System ............................................................................................................................................................................... 72
Options .............................................................................................................................................................................. 72
Braking & Motor Monitor ................................................................................................................................................. 73
Screen................................................................................................................................................................................ 74
Statistics ............................................................................................................................................................................ 75
Debug ................................................................................................................................................................................ 76

3
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 Basic/Custom screen showing key information in a large font with a new option
to create your own custom version accessed by swiping up or down 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. By Default this option is disabled each time LeafSpy Pro is started to prevent accidentally making changes
to your Leaf. Go into Settings/Service Screen to enable this 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 supporting reading 12v current. Depending on screen size you may need to be in landscape mode to
see the 12 volt battery's current (amps) reading.

4
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
top/bottom of the chart to zoom out/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. For LeafSpy Lite and LeafSpy a simple bar chart displays the
current temperatures. For LeafSpy Pro a history graph plots the sensor values over time including the ambient
temperature. Data is plotted over multiple drives with a reset button clearing the oldest drive's data.

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 has both a Basic screen and new Custom screen. (Swipe Up/Down to switch)

Basic Screen: The Basic screen shows the 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.

Custom Screen: This new screen is defined by csv files and can be customized to display selected information. Four
sample custom screens are included and any number can be created to display just the information your are most
interested in seeing. Data can be displayed as a text value or as custom gauge. The gauge includes resettable maximum
and minimum markers.

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
5
and battery serial number and changing the auto headlight on/off, interior light on/off and auto door lock/unlock
conditions. VSP (sound generator) can also be programmed to disable selected types of sounds the Leaf automatically
generates.

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: standard Bluetooth (needs pairing), Bluetooth 4.x LE (no
pairing) and WiFi.

The recommended standard Bluetooth OBDII adapter is the Carista available from Amazon. This adapter also works with
iOS in Bluetooth 4.x LE mode. Other standard Bluetooth OBDII adapters known to work with the Leaf are the OBDLink
LX, MX and MX+ OBDII adapters.

Supported Bluetooth 4.x LE adapters which are low power and require no pairing are the LELink/LELink^2 and PLX
Kiwi 3. No other software that might be included with these adapters needs to be installed prior to running LeafSpy.

The recommended standard Bluetooth OBDII adapter is the Carista which is actually a dual mode Bluetooth adapter.
When used with an Android device the Carista operates in standard Bluetooth mode which requires pairing before starting
LeafSpy and then selection of the Carista device when LeafSpy is started. When used with an iOS device like an iPhone
the Carista operates in Bluetooth 4.x LE mode which does not use pairing. LeafSpy will automatically detect and connect
to a Carista when run on an iOS device.

The difference between the LELink^2 and the older LELink is that the LELink^2 has a new zero power mode that can be
enabled. When this mode has been enabled the LELink^2 draws virtually no power from the Leaf's 12 volt battery.
However, this mode is not compatible with 2018 and newer Leafs and should not be enabled. If enabled the LELink^2
will not wake up once the Leaf is turned back on again. Check LeafSpy's Settings/Options panel to see if zero power
mode is supported for your version of LeafSpy.

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 purchase) 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" or for the Casista "0000". Then when LeafSpy is first started go into the LeafSpy Menu and select
6
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.

Recently cost reduced WiFi OBDII adapters have come onto the market that have also dropped support for the required
ELM commands. There is no way to tell these adapters from the ones that work as they use the same case and labeling.
Always buy from a place you can return if you should get one that does not work.

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

LeafSpy does not look at the version number reported by the ELM327 adapter as it is not a reliable indicator of the ELM
commands it supports. It is not until LeafSpy attempts to configure the ELM327 for communications with the Leaf that
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 totally incorrect.

Android Permissions
On newer versions of Android, when LeafSpy is first started, Android will ask the user to allow LeafSpy access to certain
functions. On older versions of Android this was done when installing the app.

LeafSpy has been changed to require only "Location" permission instead of the previous "Location", "Phone" and
"Storage" permissions. Location permission is required to support GPS location information saved to log files, if enabled
by the user. However, Android also requires "Location" permission to access a Bluetooth type OBDII adapter. (Most
likely a hold over from the past when external Bluetooth GPS Adapters were used to get location information.)

Other services that are used but do not require user permission.

• modify battery statistics - Read phone battery level.

• view network connections - Display possible WiFi OBDII adapters
• pair with Bluetooth devices - Pair with OBDII adapter
• access Bluetooth settings - Read Bluetooth state on/off
• change network connectivity - Connect to selected OBDII adapter
• connect and disconnect from Wi-Fi - Connect to WiFi OBDII adapter
• full network access - Send data to user Dropbox or user selected server
• control vibration - Vibrations are used on some long presses to confirm detection
• prevent device from sleeping - Keep device active while connected to Leaf

7
Recent Changes
As a result of a new Android requirement, without special permission, an App's read/write access to storage is limited to a
folder name created by the Android System. For LeafSpy the folder name is of the
format .../Android/data/com.Turbo3.Leaf_Spy_Pro/files. Where "..." can be one of the following depending on Android
version.

• /storage/emulated/0
• /storage/sdcard0
• /mnt/sdcard

The full path to the LeafSpy folder is listed on the "About" screen.

Before this new folder restriction, all versions of LeafSpy used the folder named .../LEAF_BT_CAN/ to store user
accessible information.

For new users this folder name/location change is not a problem as the old folder would never have been created and used.
However, for all those previous users they will need to manually copy over any files they would like to continue to access
such as the trip log file and any custom screens they added.

Also note that whereas the .../LEAF_BT_CAN folder would continue to exist if the Apps data area was cleared or even if
the app was uninstalled that is no longer the case. If the "Clear data" function is used it will delete all folders and data in
the .../Android/data/com.Turbo3.Leaf_Spy_Pro/files folder. If LeafSpy is uninstalled
the com.Turbo3/Leaf_Spy_Pro folder will be deleted.

Screen 3 now displays only Custom screens. Up to 20 custom screens can be loaded and selected by swiping up/down. A
number of custom screens are built in including a new real time efficiency custom screen. To help with creating custom
screens with gauges a new test feature has been added that allows for the temporary adjustment of a gauge's location and
size. Once a gauge is correctly located the x, y and size values are displayed so the csv file can be manually updated with
easy values.

Added support for three more languages; Arabic, Chinese and Russian.

Added an alternative way to bring up the Menu function from the current tapping of the three dashed lines in the upper
right corner of the screen. The Menu can now be slid in from the left edge by swiping right from the left edge.

Added a Server Test Mode option in Settings/Server that allows testing of the server functions without the need to be
connected to a Leaf. This option is blocked if actually connected to a Leaf. The option always defaults to off when the
application is started.

Supports for the new Android method of asking for permissions at run time instead of during install. The three
permissions needed are Storage, Phone, and Location. See the above Android Permissions sections for why these
permissions are needed by LeafSpy.

For 2011 through 2017 Leafs a new Safe Mode has been added to Settings/Options which uses a passive mode on the
CAN bus to determine if the Leaf has been turned on before trying to communicate with the Leaf. This avoids LeafSpy
sending commands to the Leaf when it is not ready to process commands which, when the Leaf is in sleep mode, cause a
relay clicking sound from the right front area of the Leaf. Note: This mode must be disabled when taking a charge graph
because during charging the Leaf is off but can still respond to commands. Safe Mode is automatically selected each time
LeafSpy is started if a 2011-2017 Leaf is detected but can be manually disabled to take a charge graph. In cases where
LeafSpy cannot determine the model year it is important the model year be manually set on the Settings/Model

8
Year panel. Warning: Failure to set the proper model year on 2018 and newer Leafs will result in LeafSpy not being able
to communicate with the Leaf.

Added a new "LELink^2 Zero Power Mode" option to Settings/Options to enable the new Zero Power mode on the
LELink2 (only available on 2011-2017 Leaf). If enabled, during the LeafSpy OBDII connection step the LELInk2 is
programmed to go into Zero Power mode 2 minutes after the last CAN activity is detected and LeafSpy is no longer
connected to the adapter. It will also immediately enter sleep mode when plugged in if there is no CAN activity. Opening
the Leaf's door will wake up the LELink2. This auto-off mode eliminates the possibility that the adapter could discharge
the 12v battery if left plugged in all the time when the Leaf is powered off.

Added an SOC charge Alarm (Settings/Battery) which, when enabled, triggers an Alarm when the Leaf has reached a
specified charge level (SOC%). The Android device must be in range of Leaf to maintain the OBDII connection to allow
reading SOC value. A WiFi OBDII adapter would work best due to the more powerful WiFi signal's range if your device
is located some distance from the Leaf.

Added two new options to Logging (Settings/Logging). One to disable reading and logging Cell Pair voltages which
speeds up the logging sample rate. This is overwritten if the currently displayed screen requires displaying cell/shunt data.
The other option changes the variable separator and decimal separator characters used in the CSV file from the defaults of
comma and decimal point to semicolon and decimal comma.

Reading the 2018 and newer Leafs tire pressures is now supported.

For 2018 and newer Leafs the Tire Registration function has been disabled. This will be enabled once the function has
been verified to work on these newer Leafs.

LeafSpy Pro now supports user defined custom screens on screen 3. Custom screens can include labels and variables with
variables being displayed as either values or on a gauge with resettable Lo/Hi markers. Custom screens are capable of
much faster update rates since they only read the data being displayed. Rates as high as 5 to 7 times per second are
possible depending on the data being displayed.

Custom screen labels and variable elements now automatically select the font size based on space available and a template
specifying how many characters need to be displayed. As a result the "L" type element has been replaced with types
"LBL", "VAR", "LV", and "VL".

LeafSpy Pro - Changed HV battery temperature Graph on screen 2 from a simple Bar graph to resettable time graph
which also includes plotting ambient temperature.

The server function now uploads Hx, Speed (GPS) and HV Battery Voltage and Current.

Server function is now a background process. Data continues to be sent to the server even if LeafSpy is running in the
background or the device is turned off.

9
Key Features
Custom Screens LeafSpy Pro now supports user defined custom screens on screen 3. Swipe up/down to switch between
the fixed screen 3 and the currently loaded custom screen 3. When displaying the custom screen 3 press the Load button
to select other custom screens. The custom screens can include user defined labels and selected variables. The variables
can be displayed a values or on a custom gauge. Eight sample screens are included. These cannot be changed as they are
restored each time LeafSpy is started but can be renamed and used as a starting point for a new custom screen.

High Speed Updates LeafSpy Pro now supports a new high speed mode when displaying data on a custom screen. Only
the data selected for display on the custom screen is read from the Leaf instead of cycling through a fixed sequence of
data reads. This can dramatically increase the frequency of data updates to the custom screen. For example, the sample
BMS gauge screens can update data at a rate of 5-7 times per second compared to updating the data once every 4-7
seconds. These faster data updates are best displayed using the new gauge element which also include resettable Lo/Hi
markers.

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:

• Log Files
• Charge & Elevation Files
• Trace & Error Files

A new folder structure is created in your Dropbox to hold the uploaded files in the Apps folder in a sub-folder named
either LeafSpy or LeafSpy Pro depending on the version of LeafSpy being used. The new folders are:

• Apps/LeafSpy Pro/ - for Trip/Charge log

• Apps/LeafSpy Pro/Log Files - for Log Files
• Apps/LeafSpy Pro/DTC - for DTC Log Files
• Apps/LeafSpy Pro/Charge & Elevation Log - for Charge and Elevation logs
• Apps/LeafSpy Pro/Trace Files - for ELM traces
• Apps/LeafSpy Pro/Debug Logs - for debug files

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.

New Service function (VSP) to allow controlling the inside and outside sounds generated by the Leaf.

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

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

___________________________________

11
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*OOO 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 state 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.

12
Menu
The Menu panel allows access to the OBDII selection menu, the Trip Log viewer, the Settings screen, About & Help
screen or to exit the application.

The Menu panel can be displayed in one of two ways. On Android versions 4.0 (API 14) or greater the menu can be
brought up by swiping from the left edge towards the right. The menu will look like this:

┌──────────────────────┐
│ ┌──────────────────┐ │
│ │ Select │ │
│ └──────────────────┘ │
│ ┌──────────────────┐ │
│ │ View Trip Log │ │
│ └──────────────────┘ │
│ ┌──────────────────┐ │
│ │ Settings │ │
│ └──────────────────┘ │
│ ┌──────────────────┐ │
│ │ About & Help │ │
│ └──────────────────┘ │
│ ┌──────────────────┐ │
│ │ Exit │ │
│ └──────────────────┘ │
└──────────────────────┘

The second way to bring up the menu is through the Menu button (three stacked lines) 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. On some Android devices this method does
not work. In that case use the first method.

Select or 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
• Bluetooth Paired Devices
• WiFi Devices
• Work Offline

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.

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

• Start Date & Time

• Starting Odometer
• Duration of trip/charge
• Distance of trip
• Elevation change from start to end of trip
• Energy used in watt/hours
• Gids used during trip
• Starting / Ending Gids
• Battery AHr rating
• State of Health
• Hx
• Starting / Ending Battery voltages
• Drive / Regen / Charge energy counters
• L1/L2 and Quick Charge counts

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.

• LeafSpy version & Selected Model Year

• Android SDK, B4A version & screen scale
• Bluetooth 4.x LE status
• Android path to saved data
• Author's name
• Contact email address
• Button to access Change History
• Button to exit About screen
• Button to access LeafSpy Help

The screen scale should ideally be set to 1.0 (normal) in Android Display settings. If not set to 1.0 (normal) LeafSpy
attempts to adjust all fonts used within the app back to 1.0. However, there are some limitation on what can be
controlled so some fonts used on menu buttons may still be too large if a scale greater than 1.0 is selected.

In previous versions of Android, LeafSpy used a fixed folder named LEAF_BT_CAN for user accessible data located
at the root level of storage (same level as the Documents folder). However, for security reasons Android is no longer
allowing Apps to access the root directory except under special conditions. Instead Apps must now used Android's pre-
assigned folder name which is based on the Apps package name. To make it easier for the user to locate this folder the
full path name is listed on the About screen.

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

14
Battery Status (Screen 1)
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

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

Monitoring Information

• (blank) - Default
• xx L - Number of Lost frames from OBDII adapter
• x.x sec - Last collection cycle time
• xx - Count records written to log file

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.

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

17
Graphs (Screen 2)
Graph Types
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").

• 1) Voltage Histogram
• 2) Battery Temperature
• 3) Charge Graph
• 4) Elevation Graph
• 5) Efficiency Graph

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.

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.

Battery Temperature
This graph shows either 4 (2011/2012 models) or 3 battery temperature sensors. The LeafSpy Pro version also graphs the
Ambient temperature. 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. If the Ambient temperature value is incorrect try toggling the Convert Outside
Temperature option.

The sensor's location in the pack is shown in the following table. The Location is given in three parts. First is the location
in the pack rear to front which can be rear for the block under the rear seat, center or front. Second is the side of the pack
the block of cells is located on which can be Center for the one under the rear seat, left or right. The third is the position
on the block of cells which can be back, front, left or right.

18
For 2018 and newer Leafs the sensors have been moved from the outer edges of the pack towards the middle of the pack
which will give a better indication of the hottest areas of the pack.

┌──────────────────┬──┬──┬──┬───────────┐
│Location Year│11│13│18│ Relative │
│ Year│12│17│xx│ to Pack │
├──────────────────├──├──├──├───────────┤
│Rear Center Back │ 1│ 1│ │Center back│
├──────────────────├──├──├──├───────────┤
│Rear Center Front │ │ │ 1│near middle│
├──────────────────├──├──├──├───────────┤
│Rear Center Right │ 4│ │ │right edge │
├──────────────────├──├──├──├───────────┤
│Center Left Left │ 3│ │ │left edge │
├──────────────────├──├──├──├───────────┤
│Center Left Right │ │ │ 2│near middle│
├──────────────────├──├──├──├───────────┤
│Center Right Right│ │ 4│ │right edge │
├──────────────────├──├──├──├───────────┤
│Front Left Right │ │ │ 4│near middle│
├──────────────────├──├──├──├───────────┤
│Front Right Right │ 2│ 2│ │right edge │
└──────────────────┴──┴──┴──┴───────────┘

LeafSpy Lite/LeafSpy

These versions display a simple Bar graph graphing only the current temperature values for the 3 or 4 sensors.

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

• <= 65F (18.3C) Blue

• <= 75F (23.9C) Green
• <= 86F (30.0C) Yellow
• <= 95F (35.0C) Orange
• <=105F (40.6C) Pink
• > 105F (40.6C) Red

LeafSpy Pro

The Pro version graphs the temperature over time. A button in the lower right corner clears the oldest sample of data if
data from more than one drive or charge is being graphed. This graph also includes the Ambient temperature if driving. At
the top of the screen is the maximum and minimum battery temperatures being graphed with the delta value in
parentheses. The current Ambient temperature is displayed on the next line.

• Sensor 1 - Red
• Sensor 2 - Orange
• Sensor 3 - Yellow (if available)
• Sensor 4 - Green
• Ambient - Blue

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

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.

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

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.

21
Custom Screens (Screen 3)
Screen 3 has evolved over time from a single screen displaying fixed information to two screens displaying the original
fixed screen and a single custom screen selectable by swiping up and down to its current format of only custom screens
(up to 20) selectable by swiping up/down. The original fixed screen 3 is still available as custom screens Screen 3
L.csv,Screen 3 P.csv.

Screen 3 can be configured to display from one to twenty custom screens which are then selectable by swiping up/down.
A custom screen can be a custom screen included with LeafSpy Pro or a user generated custom screen. Custom screens
allows users the ability to create their own custom screens or use ones generated by others to view only the information
they want to see. The information, size and location on the screen are completely controllable. Important information can
be displayed in a large font with less important information displayed in a smaller font. Gauge elements allows displaying
fast moving information with optional resettable max/min markers. Any number of screens can be created. A Load button
allows for easy loading and position up to 20 custom screens that can be scrolled through by swiping up and down.

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.

Original Screen 3
Custom Screens "~Screen 3 L" and "~Screen 3 P"

These two custom screens replace the original fixed screen 3 and 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.

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.

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

• (no letter) - Efficiency manually entered

• T - Distance of current trip
• C - Distance since last charge
• i - Last km

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.
23
 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:

• blank Status of the climate control system has not yet been read by LeafSpy.
• Off Climate control system is Off
• On Climate control system is On but there is no air flowing because the fan is off and recirculate mode is active.
• Vent Outside air will flow through the Leaf while it is in motion.
• Fan The fan is active.
• Heat Climate control heating On and cooling system is Off
• A/C Cooling system is active
• HVAC Cooling & Heating systems are active
• AUTO Cooling system is under automatic control
• AUTO# Heating/Cooling system is under automatic control
• nn If a two digit hexadecimal number is displayed please report this and the Climate Control settings that cause
it to appear.

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.

24
Custom Screens
This new feature allows you to create your own custom screens or use ones generated by others to view only the
information you want to see. The information, size and location on the screen are completely controllable. Important
information can be displayed in a large font with less important information displayed in a smaller font. A number of
sample screens are included. Any number of screens can be created. A Load button allows for easy loading of a new
custom screen.

One benefit of creating a custom screen is that only the data being displayed is read from the Leaf. This can result in
significantly faster update times especially if the data is from a single ECU. The "BMS Grp1" screens demonstrate this
feature and provide near real time data updates.

Important Note: Currently, when a Custom Screen is displayed the normal logging function, if enabled, is
inhibited.

However, a special screen specific logging maybe supported on some custom screens and is indicated by a small black
circle in the upper left corner of the screen. Tapping this circle will turn the circle into a flashing red circle/red dot and
sound a beep. Tap again to disable this special logging. Leaving a custom screen will automatically restart normal logging
if it was previously enabled.

The data used to create a Custom Screen is read from a csv file located in
the /Android/data/com.Turbo3.Leaf_Spy_Pro/files/CUSTOM SCREEN folder. Each line of the csv file can define an
element to be displayed or controls how or when the element is displayed. Each csv file is created for a specific
orientation either Portrait or Landscape. The last character of the file name must be either "P" or "L" and is used to filter
which files are displayed when loading a new custom screen.

Size and location of the elements are defined in terms of screen of percentage screen size allowing the elements to
automatically adjust to larger or smaller screens. Gauges are automatically scaled if there are no other variables displayed
on the screen. It is also possible to manually scale the gauges for the case where variables are combined with gauges
(where automatic scaling is not possible) or if the automatic gauge scaling needs some fine tuning.

To manually scale all gauges up or down tap the freeze button in the lower right corner twice. The button label will then
change from "TAP to Freeze" to "Screen Frozen" to "Adjust Size". In this state the "Load" button is replaced with
a "+" and "-" buttons to adjust the gauge scale. The adjustment only affects the screen being viewed and each screen can
be adjusted individually. These adjustments are saved in a text file named "CustomAdjust.txt" stored in the same
location as the csv files.

If the gauges have been manually changed from their automatic scale sizes, an option to Auto Scale Gauges will appear
at the top of the file list when the Load button is press.

Tapping the freeze button in the lower right corner twice when a gauge is not being displayed results in the title being
changed to "View" and all label and variable elements having their borders enabled. This can be used to verify proper
element alignment.

25
Fifteen sample Custom Screens are built into LeafSpy. They are protected and always refreshed when LeafSpy is started
so should not be modified. There names start with the "~" character and are listed after any user added screens listed.

• ~All Variables L.csv Displays most of the available variables to show what can be displayed. Not intended to be
used while driving due to small font size used and number of variables displayed.
• ~BMS Grp1 L.csv, ~BMS Grp1 P.csv These two screens display near real time information from the Battery
Management System ECU and are the default screens until changed. The special logging function is supported
on these two screens. If enabled, the data will be saved to a file named
"BMS_GRP01_yymmdd_VIN_DeviceID.cvs".
• ~BMS Grp1p L.csv, ~BMS Grp1p P.csv Same as above but the center large gauge displays HV Battery power
instead of HV Battery current.
• ~Efficiency L.csv, ~Efficiency P.csv These two screens display real time efficiency numbers. Speed, HV Battery
Voltage, Current and power are also displayed. Update rate is approximately three times per second.
• ~HVAC_L.csv This screen display HVAC power usage, Auxiliary power usage and Fan Speed.
• ~MikeScreen L.csv This screen was created by one of the LeafSpy users and demonstrates what can be done.
• ~Screen 3 L.csv, ~Screen 3 P.csv These screens duplicate the original fixed screen 3. This screen should properly
scale to different screen sizes including when displaying more than one app on the screen.
• ~SOC L.csv, ~SOC P.csv These screens read data only from the VCM ECU and are intended to be used while
charging. HV Battery SOC, voltage, current and power are displayed.
• ~TireGaugeL.csv, ~TireGaugeP Displays the tire pressures (only for 2011-2017 Leafs) and demonstrates the
multi pointer support of the gauge element.

The Load button in the lower right corner can be used to load a different custom screen. Each orientation is loaded with
its own custom screen.

The csv file format is as follows and can be edited with a text editor but is much easier to edit using Excel or compatible
program. You can start by renaming one of the built-in files and try modifying a few elements to see how they work.

26
The first parameter on each line defines the type of element to be drawn or defines colors or when the element should be
used. If the first parameter does not match a supported one the line is skipped. This allows blank lines and comments to be
added for easier viewing of the file.

• LV - Label/Variable (ex SOC 45%)

• VL - Variable/Label (ex 384.2 Battery Voltage)
• LBL - LaBeL (ex My Custom Screen)
• VAR - VARiable (ex 234.1 mi) (units provided with variable)

• DL - Draw Line
• DR - Draw Rectangle
• DT - Draw Text (can be rotated)

• CP - Color of Panel (screen background)

• CL - Color of Label
• CV - Color of Variable
• CD - Color of Drawing elements (lines/rectangles)
• CT - Color of Text (drawn text)

• GA - GAuage

• CG - Color Gauge
• CGB - Color Gauge Background
• CGS - Color Gauge Scale
• CGT - Color Gauge Text
• CGP - Color Gauge Pointer defaults
• CGPx - Color Gauge Pointer 0 thru 3
• CGR - Color Gauge Range Clear
• CGRx - Color Gauge Range 0 thru 3

• GEM - Gauge Enable Markers

• GDM - Gauge Disable Markers

• TEMP_C - TEMPerature in Centigrade

• TEMP_F - TEMPerature in Fahrenheit
• METRIC - METRIC units
• IMP - IMPerial units
• PKSZxx - PacK SiZe 24/30/40/62
• UBAR - Units BAR
• UKBAR - Units KBAR
• UPSI - Units PSI

• IA - Image Air Flow

• IF - Image Fan
• IR - Image Recirculate

27
Label(LBL)/Variable Elements (LV, VL, LVL, VAR)

Label/Variable (LV)

Type "LV" replaces type "L" and is used to display a label followed by a variable.There are twelve parameters that define
the position (B,C), size (D,E,F,J), label text (G), variable index (K), attributes (H,L) and templates (I,M) to display the
label and variable. Positions and sizes are defined as percentages of the screen. The default anchor used for the x and y
position is the center of the label/variable combination. The anchor can be changed to the top and/or left by using zero or a
negative position percentage.

Example: "LV,0,-48,25,8,50,SOC,r,XXXXXX,40,20,c,xxx.xx" Display SOC label and variable.

Variable/Label (VL)

Similar to Label/Variable but the order of display is swapped such that the Variable displayed to the right of the Label

Example: "VL,-25,-24,24,5.75,54,Battery Wh,l,XXXXXXXXXx,44,-34,c,XXXXXXx"

Variable (VAR)

Display just a variable with any units (ex V, kW, A). The units can be suppressed by making the variable Index negative.

Example: "VAR,15,35,20,15,80,c, (99.99) XXX" Display tire pressure.

Label (LBL)

Display just a Label. If a template is not provided the label text will be used to determine the font size.

Example: "LBL,0,-1,100,6,Custom Screen,c"

General Format
┌────────────────Screen───────────────┐
│ <------------- D -----------> │
│ <----- F ----> <---- J ----> │
│C┌────────────────────────────────── │
│ │ ┌─ ┌─────────────┐┌─────────────┐ │
│ │ │ │ G =Label ││ K =Variable │ │
│ │ E │ H =Attribute││ L =Attribute│ │
│ │ │ │ I =Template ││ M =Template │ │
│ │ └─ └─────────────┘└─────────────┘ │
│ B (Label) (Variable) │
└─────────────────────────────────────┘
┌───┬──┬──┬─┬─┬──┬──┬──┬──┬──┬──┬──┬──┐
│ A │ B│ C│D│E│F │G │H │I │J │K │L │M │
├───├──├──├─├─├──├──├──├──├──├──├──├──┤
│LV │±X│±Y│w│h│wL│Lb│At│Tp│wV│Vr│At│Tp│
├───├──├──├─├─├──├──├──├──├──├──├──├──┤
│VL │±X│±Y│w│h│wL│Lb│At│Tp│wV│Vr│At│Tp│
├───├──├──├─├─├──├──├──├──┴──┴──┴──┴──┘
│LBL│±X│±Y│w│h│Lb│At│Tp│
├───├──├──├─├─├──├──├──┤
│VAR│±X│±Y│w│h│Vr│At│Tp│
└───┴──┴──┴─┴─┴──┴──┴──┘

±X: Horizontal Position - Defines the offset, in screen width percent, from the left edge of the screen to either the center
of the element, if positive, or the left edge of the element, if zero or negative.

28
±Y: Vertical Position - Defines the offset, in screen height percent, from the top edge of the screen to either the center of
the element, if positive, or to the top edge of the element, if zero or negative.

w: Width - Defines the width of the element in screen width percent.

h: Height - Defines the height of the element in screen height percent.

wl: Width Label - Defines the width of the label in terms of the element's w parameter.

wV: Width Variable - Defines the width of the variable in terms of the element's w parameter.

Lb: Label - Defines the label's text.

Vr: Variable Index - Defines the index of the variable.

At: Attributes - Defines the attribute(s) that determine how the label or variable is displayed. The default is left justified
and normal font.

• L - Left justify
• C - Center justify
• R - Right justify
• M - Mono Space font
• B - Bold font

Tp: Template - This text string is used to determine the font size selected for the label or variable. The longer the text
string the smaller the font. Note: For the "LBL" element if no template is provided the label text will be used. This should
only be done if this label does not need its font to match any other font on the screen.

Image Elements (IA, IF, IR)

There are three image elements

• IA Air Flow
• IF Fan Speed
• IR Recirculate

┌──┬──┬──┬─┐
│ A│ B│C │D│
├──├──├──├─┤
│IA│±X│±Y│w│
├──├──├──├─┤
│IF│±X│±Y│w│
├──├──├──├─┤
│IR│ X│ Y│w│
└──┴──┴──┴─┘
Example
(Mode)
VAR,15,77,25,6,97,cb,XXXXXXX
IR,15,79,25

(FAN)
VAR,40,77,22,8,55,cb,XXXXXW)
IF,40,-81,15

(Air Flow)
VAR,61,77,16,8,95,cb,XXXXX
IA,61,-79,20

29
±X: Horizontal Position - Defines the offset, in screen width percent, from the left edge of the screen to either the center
of the image, if positive, or the left edge of the image, if zero or negative. Note: For the IR element the anchor point is
always the center.

±Y: Vertical Position - Defines the offset, in screen height percent, from the top edge of the screen to either the center of
the image, if positive, or to the top edge of the image, if zero or negative. Note: For the IR element the anchor point is
always the top.

w: Width - Width of the image in screen width percent. The height will be set based on the aspect ratio of the image.

Gauge (GA)

A gauge element can have from 1 to 4 pointer but typically is used to display a single value or four values when
displaying tire pressures. A maximum of 20 gauges per screen is supported.

Up to four color ranges can be displayed. Default colors for the first three ranges are Red, Yellow and Green.

┌───┬──┬──┬─┬──┬──┬──┬──┬──┬──┬──┬──┐
│ A │ B│ C│D│E │F │G │H │I │J │K │L │
├───├──├──├─├──├──├──├──├──├──├──├──┤
│GA │±X│±Y│w│Vr│Lb│Dg│sV│eV│tS│tM│St│
└───┴──┴──┴─┴──┴──┴──┴──┴──┴──┴──┴──┘
Example
(HV Battery Voltage)
CGR0, 365,394
CGR1, 340,365
CGR2, 300,340
GEM
GA,21.5,72.5,25,30,"HV Bat",1,310,400,5,4,2

±X: Horizontal Position - Defines the offset, in screen width percent, from the left edge of the screen to either the center
of the gauge, if positive, or the left edge of the gauge, if zero or negative.

±Y: Vertical Position - Defines the offset, in screen height percent, from the top edge of the screen to either the center of
the gauge, if positive, or to the top edge of the gauge, if zero or negative.

w: Width - Width of the gauge in screen width percent.

Vr: Variable - Variable(s) to be displayed using the variable index number. If more than one variable is to be displayed
then "[ ]" are used to surround the variables (ex. [ 80 81 82 82 ] ).

Lb: Label - Title displayed above the center point of the gauge.

Dg: Number of digits - Number of digits to the right of the decimal point displayed just below the center of the gauge
showing the current variable value or max/min value since reset.

sV: Starting Value - Starting (minimum) gauge value.

eV: Ending Value - Ending (maximum) gauge value

tS: Tick Size - Minor tick size.

tM: Tick per Major - Number of ticks per major tick mark.

30
St: Starting tick - Starting minor tick number. Defaults to 0 which means start with a major tick.

Gauge Layout Assist Mode

To assist in determining a gauge's horizontal (X), vertical (Y) and width percent values a new mode has been added
through the status/pause button in the bottom right corner of the screen. This mode makes a temporary change to the
position and size of the selected gauge on the screen. The new X, Y and size percent values are displayed on the pause
button. Once the gauge is finally positioned and sized, the three values (X,Y and Width) need to be manually updated in
the csv file. Exiting assist mode clears these temporary values restoring the screen to the values defined in the cvs file.

Note: This mode does not make any changes to the csv file. It is only intended as a visual aid to show the affect of
different X, Y and size values which can then be manually entered into the csv file making them permanent.

The first step is to select the gauge to work on. This is done by doing a long tap on the bottom half of the gauge. If the
gauge is near the upper right corner of the screen, tap the left side of the bottom half of the gauge to avoid activating the
Help overlay. The long tap will bring up the menu to reset markers and highlight the selected gauge with a red box border.
This menu can then be canceled and the red box will disappear.

The second step is to enter assist mode by taps to the bottom right status area which will cycle through "Tap to Freeze",
"Screen Frozen", "Adjust Size" and finally assist mode which will initially display "X= xx.x%" with minus and plus
buttons above it. The selected gauge will also again be highlight with a red box.

At this point pressing the "-" button will move the gauge to the left while pressing the "+" button moves the gauge to the
right by approximately 1% of the screen's width. Doing a long tap on either the "-" or "+" button will select the "Y"
position for change and a second long tap will select the gauge size for change. Additional long taps of the +/- buttons will
cycle through these three change modes (X, Y, Size) and allow moving and resizing the gauge to its desired position and
size. Remember, this is only a temporary change. The final X, Y and Size percentages displayed in the bottom right status
area need to be copied down so the csv file can be updated with these approximate values. Note the displayed value is a
guide. For example a displayed value of 19.9% would normally be entered into the csv file as 20%.

Note: When adjusting the gauge size, only the red border of the gauge is resized not the internal gauge itself which stays
unchanged or get clipped.

31
Gauge Pointer Colors (CGP, CGPx)

Use these five elements to change or restore the gauge pointer colors from or to their default values either individually or
as a group. An element without a color pair restores the default colors for that element.

Default Pointer colors

┌────┬────────┬──────────┐
│ │DayColor│NightColor│
├────├────────├──────────┤
│CGP0│ Red │ Red │ Pointer 0
├────├────────├──────────┤
│CGP1│DarkGrey│ DarkGrey │ Pointer 1
├────├────────├──────────┤
│CGP2│ Magenta│ Magenta │ Pointer 2
├────├────────├──────────┤
│CGP3│ Blue │ Blue │ Pointer 3
└────┴────────┴──────────┘
┌────┬────────┬──────────┐
│ A │ B │ C │
├────├────────├──────────┤
│CGP0│DayColor│NightColor│ Pointer 0 color
├────├────────├──────────┤
│CGP1│DayColor│NightColor│ Pointer 1 color
├────├────────├──────────┤
│CGP2│DayColor│NightColor│ Pointer 2 color
├────├────────├──────────┤
│CGP3│DayColor│NightColor│ Pointer 3 color
├────├────────┴──────────┘
│CGP0│ Restore Pointer 0 default color
├────┤
│CGP1│ Restore Pointer 1 default color
├────┤
│CGP2│ Restore Pointer 2 default color
├────┤
│CGP3│ Restore Pointer 3 default color
├────┤
│CGP │ Restore Pointer 0-3 default colors
└────┘

32
Gauge Colors (CG, CGB, CGS, CGT)

Use these four elements to change or restore a gauges colors from or to their default values. An element without a color
pair restores the default colors for that element.

Default Pointer colors

┌───┬────────┬──────────┐
│ │DayColor│NightColor│
├───├────────├──────────┤
│CG │ Black │ White │ Gauge
├───├────────├──────────┤
│CGB│ White │ Black │ Gauge Background
├───├────────├──────────┤
│CGS│ Black │ White │ Gauge Scale
├───├────────├──────────┤
│CGT│ Black │ White │ Gauge Text
└───┴────────┴──────────┘
┌───┬────────┬──────────┐
│ A │ B │ C │
├───├────────├──────────┤
│CG │DayColor│NightColor│ Gauge
├───├────────├──────────┤
│CGB│DayColor│NightColor│ Gauge Background
├───├────────├──────────┤
│CGS│DayColor│NightColor│ Gauge Scale
├───├────────├──────────┤
│CGT│DayColor│NightColor│ Gauge Text
├───├────────┴──────────┘
│CG │ Restore Gauge Defaults
├───┤
│CGB│ Restore Gauge Background defaults
├───┤
│CGS│ Restore Gauge Scale defaults
├───┤
│CGT│ Restore Gauge Text defaults
└───┘

Gauge Markers (GDM, GEM)

Maximum and minimum markers can be enabled or disabled using these elements. The marker setting is applied to all
following Gauge (GA) elements until another marker element is encountered.

When enabled for a gauge, maximum and minimum markers are displayed on the gauge as two special pointers showing
the maximum and minimum values since the last time the markers were reset. The markers can be reset either individually
by gauge or for all gauges by a long tap on the bottom half of a gauge. A tap on the bottom half of the gauge will cycle
through displaying the current value(s) and the maximum and minimum values in digital format.

┌───┐
│ A │
├───┤
│GDM│ Disable Gauge Markers
├───┤
│GEM│ Enable Gauge Markers
└───┘

33
Color Gauge Range (CGR,CGRx)

These five elements control and define a gauge range and color. A gauge range is a colored stripe along the perimeter of
the gauge starting and ending at specific gauge values. The CGR element disables all ranges from being displayed.
A CGRx element enables and defines the range with an optional color to override the default colors. The default gauge
range colors are:

• CGR0 - Green
• CRG1 - Yellow
• CGR2 - Red
• CGR3 - none

┌────┬─────┬───┬─────┐
│ A │ B │ C │ D │
├────├─────├───├─────┤
│CGR0│Start│End│Color│ Enable Range 0
├────├─────├───├─────┤
│CGR1│Start│End│Color│ Enable Range 1
├────├─────├───├─────┤
│CGR2│Start│End│Color│ Enable Range 2
├────├─────├───├─────┤
│CGR3│Start│End│Color│ Enable Range 3
├────├─────┴───┴─────┘
│CGR │ Disable all ranges
└────┘
Example
' HV Battery Power
CGR
CGR0,-50,0
CGR1,25,50
CGR2,50,100
GA, 88,21, 21, 57, "HV Bat", 2, -50, 100, 5,5

Conditional Tags

There are four groups of conditional tags. One group each for temperature units, distance units, battery pack size and
pressure units. A conditional tag starts and ends a set of commands that are execute if the tag condition is true and skipped
if the condition is not true. These are typically used for gauge creation commands to allow a gauge to be customized to the
temperature units, distance unties, battery pack size and pressure units.

• TEMP_F - Execute if temperature in F

• TEMP_C - Execute if temperature in C

• METRIC - Execute if Metric units

• IMP - Execute if Imperial units

• PKSZ24 - Execute if pack size 24 kWh

• PKSZ30 - Execute if pack size 30 kWh
• PKSZ40 - Execute if pack size 40 kWh
• PKSZ62 - Execute if pack size 62 kWh

• UBAR - Execute if pressure units BAR

• UKBAR - Execute if pressure units KBAR
• UPSI - Execute if pressure units is PSI

34
Examples
GEM
' Speed
IMP
CGR0, 0, 65
CGR1, 65, 80
CGR2, 80, 100
GA, 28, 50, 98, 4, Speed GPS, 0, 0, 100, 2, 5

GA, 72, 50, 98, 5, Speed Leaf, 1, 0, 100, 2, 5

IMP

METRIC
CGR0, 0, 100
CGR1, 100, 130
CGR2, 130, 160
GA, 28, 50, 98, 4, Speed GPS, 0, 0, 160, 5, 4

GA, 72, 50, 98, 5, Speed Leaf, 1, 0, 160, 5, 4

METRIC

UPSI
CGR0,36,40
CGR1,25,36
CGR2, 0,25
GA, 50,48,86,[80 81 82 83],"Tires",2,15,50,1,5,5
UPSI

UBAR
CGR0,2.5,2.75
CGR1,1.725,2.5
CGR2, 0,1.725
GA, 50,48,86,[80 81 82 83],"Tires",2,1,3.5,0.1,5
UBAR

UKBAR
CGR0,250,275
CGR1,172.5,250
CGR2, 0,172.5
GA, 50,48,86,[80 81 82 83],"Tires",0,100,350,10,5
UKBAR

List of currently available variables that can be displayed and their index number (used in Column I). The ECU the data is
read from is shown in brackets. For fastest screen updates, display data from a single ECU.

• 0 = VIN [VCM]
• 1 = Battery Serial Number [BMS9]
• 2 = Odometer [CMR]
• 3 = Ambient Temperature [VCM]
• 4 = Speed (GPS)
• 5 = Speed (Leaf) [VCM]
• 6 = 12v Battery Voltage [VCM]
• 7 = 12v Battery Current [VCM]
• 8 = SOC [VCM]
• 10 = Trip Time [VCM]
• 11 = Distance [VCM]
• 12 = Range [BMS1]
• 13 = Energy Used [BMS1]
• 14 = Starting Gids [VCM,CMR]
• 15 = Trip Gids [VCM]
• 16 = Distance Remaining [CMR]
• 17 = Efficiency [VCM]
• 20 = SOC [BMS1]
• 21 = SOH [BMS7]
35
• 22 = Battery Health [BMS1]
• 23 = Bat Temperature [BMS4]
• 24 = AHr Capacity [BMS1]
• 30 = HV Volts [BMS1]
• 31 = HV Battery Amps [BMS1]
• 32 = AHr Remaining [BMS1]
• 33 = Gids [VCM]
• 34 = Battery Wh [BMS1]
• 35 = Gids % [VCM]
• 36 = Wh Counter [BMS1]
• 38 = Regen Wh Counter [BMS1]
• 40 = HV Voltage min [BMS3]
• 41 = HV Voltage max [BMS3]
• 42 = HV Voltage avg [BMS3]
• 43 = HV Voltage delta BMS3]
• 44 = Bat Temp Rear Center [BMS4]
• 45 = Bat Temp Front Right [BMS4]
• 46 = Bat Temp Middle Left [BMS4]
• 47 = Bat Temp Middle Right [BMS4]
• 48 = Battery Power kW [VCM]
• 50 = Motor Power [VCM]
• 51 = Battery Power W [BMS1]
• 52 = Aux Power [VCM]
• 53 = PTC Heater Power [VCM]
• 54 = A/C Power [VCM]
• 55 = A/C+PTC Power [VCM]
• 56 = Motor Power kW [VCM]
• 57 = Battery Power kW [BMS1]
• 58 = HV Volts [VCM]
• 59 = HV Battery Amps [VCM]
• 60 = Motor Temperature [MTR]
• 61 = Motor RPM [VCM]
• 62 = Command Torque [MTR]
• 70 = L1/L2 [VCM]
• 71 = Quick Charges [VCM]
• 72 = Plug State [VCM]
• 73 = Charge Mode [VCM]
• 74 = Charge Power [VCM]
• 75 = EVSE Voltage [OBC]
• 76 = EVSE Max Amps [OBC]
• 80 = Front Left tire [CMR]
• 81 = Front Right tire [CMR]
• 82 = Rear Right tire [CMR]
• 83 = Rear Left tire [CMR]
• 84 = Tire delta [CMR]
• 90 = Power Switch [VCM]
• 91 = Gear Position [VCM]
• 92 = Head Lamp status [VCM]
• 93 = Front Wiper Status [BCM]
• 94 = Wheel Angle [ABS]
• 95 = Set Temperature [VCM]
36
 • 96 = Fan Speed [VCM]
• 97 = AC Mode [VCM]
• 100 = Cycle Time
• 101 = Good Response
• 102 = Bad Response
• 103 = Missing Frames
• 104 = Retries
• 105 = Frame Delay Time
• 110 = BMS 12v Battery Voltage [BMS1]
• 111 = BMS IR Sense Short Pulse [BMS1]
• 200 = Selected Battery Temp (min/avg/max) [BMS4]

Draw Line(DL)

Use this element to draw a line from point x1,y1 to x2,y2 with a specified width. The default line colors of
Black/LightGray can be changed with the Color of Drawing (CD) element.

Example: "DL,0,50,100,50,3" Draw horizontal line in middle of screen, width of 3.

Column A: type - "DL"

Column B: x1 - This floating point value defines, in horizontal percentage of width, the starting point of the line.

Column C: y1 - This floating point value defines, in vertical percentage of height, the starting point of the line.

Column D: x2 - This floating point value defines, in horizontal percentage of width, the ending point of the line.

Column D: y2 - This floating point value defines, in vertical percentage of height, the ending point of the line.

Column F: width - Line Width

Draw Rectangle (DR)

Use this element to draw a rectangle from point x1,y1 to x2,y2 with a specified width. The default rectangle colors of
Black/LightGray can be changed with the Color of Drawing (CD) element.

Example: "DR, 20, 10, 40, #0.5, 0,5" Draw rectangle, thick line.

Example: "DR, 30, 20, 40, #, 0, 3" Draw square, thin line.

Column A: type - "DR"

Column B: x1 - This floating point value defines, in horizontal percentage of width, the top starting point of the rectangle.

Column C: y1 - This floating point value defines, in vertical percentage of height, the top starting point of the rectangle.

Column D: x2 - This floating point value defines, in horizontal percentage of width, the bottom ending point of the
rectangle.

Column E: y2 or # or #n.n - This floating point value, "#" or "#n.n" defines the bottom ending point of the rectangle.
There are three options for this value.

37
 • Absolute: y2 = % screen height (ex 23)
• Square: y2 = # (ex #)
• Rectangle: y2 = #aspect (ex #0.5)

Setting the aspect to 0.5 will draw a rectangle half as high as wide.

Column F: fill - 1=Fill rectangle, 0=no fill

Column G: width - Rectangle Line Width

Draw Text (DT)

Type "DT" format has recently been changed. See bottom of section for conversion information from the old format to
this one.

Draws text around specified location (anchor point). Text can be rotated around the anchor point. The color of the text can
be changed with the Color of Text (CT) element. The format is the same as the LBL element with the addition of an
optional rotation parameter.

┌───┬──┬──┬──┬─┬──┬──┬──┬──┐
│ A │ B│ C│ D│E│ F│ G│H │I │
├───├──├──├──├─├──├──├──├──┤
│LBL│±X│±Y│ w│h│Tx│At│Tp│Rt│
└───┴──┴──┴──┴─┴──┴──┴──┴──┘

Example: "DT ,-55,-18,15,8,Sample Text,dc,XXXXXXXXXX"

Example: "DT ,-55,-18,15,8,Sample Text,dl,XXXXXXXXXX,90" rotate 90 degrees CW.

±X: Horizontal Position - Defines the offset, in screen width percent, from the left edge of the screen to either the center
of the element, if positive, or the left edge of the element, if zero or negative.

±Y: Vertical Position - Defines the offset, in screen height percent, from the top edge of the screen to either the center of
the element, if positive, or to the top edge of the element, if zero or negative.

w: Width - Defines the width of the element in screen width percent.

h: Height - Defines the height of the element in screen height percent.

Tx: Text - Defines the text.

At: Attributes - Defines the attribute(s) that determine how the label or variable is displayed. The default is left justified
and normal font.

• L - Text is drawn with the first character to the right of the anchor point
• C - Text is drawn centered around the anchor point
• R - Text is drawn with the last character to the left of the anchor point
• M - Mono Space font
• B - Bold font

Tp: Template - This text string is used to determine the font size selected for the label or variable. The longer the text
string the smaller the font. Note: For the "LBL" element if no template is provided the label text will be used. This should
only be done if this label does not need its font to match any other font on the screen.

38
Rt: Rotation - This optional parameter defines the clockwise rotation in degrees of the text around the anchor point.

Colors

Colors are defined in pairs. The first color is used in day mode and the second is used when in night mode.

Color numbers should be specified in four byte hexadecimal ARGB format, 0xAARRGGBB where

• AA = Alpha (0x00=transparent and 0xFF = solid color)

• RR = Red
• GG = Green
• BB = Blue

Examples

• 0xFF000000 = Black
• 0xFF87CEFA = Light Sky Blue
• 0xFFFFFFFF = White
• 0 = Transparent (used for a background color)

Color of Panel (CP)

Use this element to change the background color of the screen. The screen colors must be a solid color so the Alpha byte
is internally forced to 0xFF independent of what is actually specified.

The default background colors are White / Black (Day / Night).

Example: "CP, 0xFF87CEFA, 0xFF000000" sets the background to light sky blue and black.

Column A: type - "CP"

Column B: day - Day time background color.

Column C: night - Night time background color.

Color of Line (CL)

Use this element to change the color of the label in any Label (L) element that follows this line. Typically the background
colors are set to transparent by setting the Alpha byte to zero.

The default label colors are Black / Light Gray (Day / Night).

Example: "CL, 0xFF87CEFA, 0xFF000000, 0, 0"

Column A: type - "CL"

Column B: text day color - Label text color during day.

Column C: text night color - Label text color at night.

Column D: background day color - Label background color during day.

39
Column E: background night color - Label background color during night.

Color of Variable (CV)

Use this element to change the color of the variable in any Label (L) element that follows this line. Optionally add a
border around the variable.

Example: "CV, 0xFFFF0000, 0xFFFF0000, 0x0, 0x0" Display variable in Red.

Example: "CV, 0xFF000000, 0xFF808080, 0x0, 0x0, 1, 0" Place border around variable.

The default variable colors are Black / Light Gray (Day / Night).

Column A: type - "CV"

Column B: text day color - Variable text color during day.

Column C: text night color - Variable text color at night.

Column D: background day color - Variable background color during day.

Column E: background night color - Variable background color during night.

Column F: border width - Optional border width around variable. Default is no border. The border color will be the same
as the text color.

Column G: border radius - Radius of optional border around variable. A zero radius will result in square corners.

Color of Drawing (CD)

The default color for drawings (lines and rectangles) is Black for day and LightGray for night. Use this element to change
the color used for any drawings following this line or to restore the previous colors.

Example: "CD, 0xFFFF0000, 0xFFFF0000" Draw lines and rectangles in Red

Example: "CD, POP" Restore previous drawing colors

Column A: type - "CD"

Column B: day color or restore - Drawing day color or "POP" to restore the previous colors

Column C: night color - Drawing night color

Color of Text (CT)

The default color for drawn text is Black for day and LightGray for night. Use this element to change the colors used to
draw text or restore the previous colors.

Example: "CT, 0xFFFF0000, 0xFFFF0000" Draw text in Red

Example: "CT, POP" Restore previous drawn text colors

40
Column A: Type - "CT"

Column B: day color or restore - Drawn Text day color or "POP" to restore the previous colors

Column C: night color - Drawn Text night color

==========================================

Label/Variable (L) Warning: Depreciated do not use

Type "L" has been replaced with four new types (LV, VL, LBL and VAR).

The following table shows the mapping from the old L format to the new LV, VL LBL and VAR formats by column
letter. The font size (column E and M) is no longer needed, instead replaced with a single height and one or two template
strings.

Conversion Table (L to LV, VL, LBL, VAR)

┌───┬─┬──┬─┬─┬─┬─┬──┬─┬─┬─┬─┬─┐
│L │B│ C│D│E│F│G│ H│I│J│K│L│M│
├───├─├──├─├─├─├─├──├─├─├─├─├─├──┬───┬───┐
│new│ Ht=Height Tmp=Templates │Ht│Tmp│Tmp│
├───├─├──├─├─├─├─├──├─├─├─├─├─├──├───├───┤
│LV │D│-B│G│ │H│F│-C│K│ │L│J│ │ E│ I │ M │
│VL │D│-B│G│ │H│F│-C│K│ │L│J│ │ E│ I │ M │
│LBL│D│-B│F│ │G│ │-C│ │ │ │ │ │ E│ H │ │
│VAR│D│-B│ │ │ │ │-C│F│ │G│ │ │ E│ H │ │
└───┴─┴──┴─┴─┴─┴─┴──┴─┴─┴─┴─┴─┴──┴───┴───┘

Instead of specifying a font size, which can be difficult to determine and not be correct on different size screens, font size
is replaced with a % of screen height value. At runtime a font will be select to fit within the field's height and width. This
means that font size is now replaced with a % height. The font size selected is based on a template string and not the
actual label or value being displayed. This permits a single font size to be selected for a series of labels by using the same
template string for example "XXXXXXXXX".

The Label/Variable type defines a label followed by an optional variable. It is possible to define a variable with a blank
label or a label with no variable.

The default label colors are Black / LightGray (Day / Night) with a transparent background. The default variable colors
are Black / Black (Day / Night) with a LightGray background . These colors/backgrounds can be changed using the Color
of Label (CL) and Color of Variable (CV) elements.

Example: "L,25,0,SOC ,11,r,50,48,20,12,c,40,48" Display SOC label and variable.

Example: "L,100,0, ,0,r,0,35,-30, 80,C, 90,35" Display HV voltage, no label, no units.

Example: "L,10,45, Wh,20,L,100,42" Label, no variable.

┌────────────────Screen─────────────────┐
│ <------------- B -----------------> │
│┌───────────────────────────────────┐ │
││ H<----- G ----> M<----- L ------> │ │
││ ┌──────────────┐┌────────────────┐│ │
││ │ D E F ││ I J K ││ │
││ └──────────────┘└────────────────┘│ │
│C (Label) (Variable) │
└───────────────────────────────────────┘

41
Column A: type - "L"

Column B: Width - This floating point value defines in horizontal percentage the amount of space allocated to the field
defined by this line. Use 100 if all the space is to be used by this field. If you are making a two column layout then you
might use 50 or 33 for a third field layout.

Column C: Offset - This floating point value defines in horizontal percentage the starting location of the field defined by
this line. If there is only one field then you would typically use an offset of 0.

Column D: Label - Defines the text string of the label. It is recommended to add a single space at the end of the text if
using right justification to keep the text from coming right up against the following variable.

Column E: font - The font size of the text string. You will need to experiment to see what font looks good on your
screen.

Column F: attributes - Defines the justification and bold attributes of the text label. "L" for Left, "R" for Right, "C" for
center and "B" for bold. (ex CB = center bold)

Column G: width - This floating point value defines the width of the label box in terms of percentage of the space
defined by column B.

Column H: top - This floating point value defines the top of the box the label is written into in terms of vertical
percentage of the screen.

(The following are only used if you want a variable displayed to the right of the label. )

Column I: variable - This integer value defines the variable to be displayed to the right of the label. Making this value
negative suppresses displaying any units (V, A, Ahr, PSI...) to the right of the variable.

Column J: font -The font size of the variable. You will need to experiment to see what font looks good on your screen.

Column K: attributes - Defines the justification and bold attributes of the variable. "L" for Left, "R" for Right, "C" for
center and "B" for bold. (ex CB = center bold)

Column L: width - This floating point value defines the width of the variable box in terms of percentage of the space
defined by column B.

Column M: top - This floating point value defines the top of the box the variable is written into in terms of vertical
percentage of the screen.

If Columns G and L do not add up to 100% then the label/variable fields will be centered in the area defined by Columns
B and C.

42
Type "DT" format has recently been changed. The order of the parameters has been changed to match the LBL element
and the font and size parameters replaced with a Width, Height and Template parameter. The following table shows the
mapping of parameters from old to new format.

Conversion Table (Old DT format to New)

┌───┬─┬──┬──┬─┬─┬─┬─┐
│old│B│ C│ D│E│F│G│H│
├───├─├──├──├─├─├─├─├─────┬──────┬─────┐
│ │ │ │ │ │ │ │ │Width,Height│Tmplt│
├───├─├──├──├─├─├─├─├─────├──────├─────┤
│new│F│-B│-C│G│ │G│I│ D │ E │ H │
└───┴─┴──┴──┴─┴─┴─┴─┴─────┴──────┴─────┘

Example: "DT ,Sample Text, 55, 18, d, 14, c"

Example: "DT ,Sample Text, 55, 18, d, 14, l, 90" rotate 90 degrees CW.

Column A: type - "DT"

Column B: text - Text to be drawn. Any leading and trailing spaces are kept.

Column C: x - This floating point value defines, in horizontal percentage of width, the anchor point of the text.

Column D: y - This floating point value defines, in vertical percentage of height, the anchor point of the text.

Column E: font - Defines font used.

• D : Default font
• B : Bold default font

Column F: size - Defines font size in points. A typical size would be 14.

Column G: justification - Defines the justification around the anchor point. Values are:

• L : Text is drawn with the first character to the right of the anchor point
• C : Text is drawn centered around the anchor point
• R : Text is drawn with the last character to the left of the anchor point

Column H: degrees - This optional parameter defines the clockwise rotation of the text around the anchor point.

43
Detailed View (Screen 4)
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:

Data Set 1: HV Battery Voltage & Current, Battery Power in kW and HP

Data Set 2: Motor RPM, Steering Wheel Angle*, Gids used during trip, Motor, Inverter 2 and Inverter 4
temperatures.

* When in Debug mode the Steering Wheel angle is displayed after motor RPM. The angle ranges from -720
to 720 degrees with negative being left turn.

Data Set 3: GPS Speed, Altitude and Altitude change during trip or "GPS not Valid" if GPS has not locked on
to sufficient satellites or "GPS not enabled" if GPS has not been enabled on the Settings/Logging panel.

44
 Data Set 4: Trip distance and efficiency based on Wh counter and current trip distance.

Data Set 5: Distance and efficiency since last charge based on Wh counter and distance since last charge. The
value in parenthesis is an estimate of the efficiency from "wall to wheel" using Gids with a fixed 82 Wh/Gid
value and distance since last charge.

For Data Set 5 the distance traveled since last charge automatically resets when LeafSpy detects either a charge
cycle that added more than 6 Gids or that the current Gid level has increased by more than 6 Gids from the Gid
value at the end of the previously logged trip. The distance can be manually reset before the start of a trip by
doing a long tap on the left side of the bar graph while Data Set 5 is displayed. If a trip has already started the
long tap will not reset but load the current trip distance. This is useful if you notice the distance did not get cleared
but you have already started the first trip since charging.

4(Bar Graph) (SOC, GIDs, DTE) or (Batt, Aux, Heater, A/C Watts) Bar graph of available energy and
range or power used by function. Tapping the right side of the graph toggles between the two sets of data that can be
displayed.

┌───┐
┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐ │Tap
│ │ │ │ │ │├─┐│over
│ ││ ││this
│ │ │ │ │ │├─┘│area
└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘ │
└───┘

Any time the PTC heater is active the graph automatically switches to displaying power used to alert the driver to the
amount of power being used by the PTC heater. Automatic switching to this screen can be disabled on
the Settings/Options panel using the "Disable forcing energy display" switch.

Available energy/range: The top green bar on the graph indicates the State of Charge (SOC) of the battery with full
scale being 100%. The middle magenta bar indicates the Gid level with full scale being the maximum Gids defined on
the Settings/Battery panel. The bottom blue bar represents the remaining range with full screen being either 100 miles
or 160 km depending on the units defined on the Settings/Units panel. At the start of each trip three white triangular
markers are placed on the energy and range graph indicating the starting level of energy and range.

Power Used by function: When displaying power used by function the following legends are used on the left edge.
The kW values in parentheses are power per tick mark and full scale power. The actual power values are displayed on
the right edge in Watts

• Motr or Batt = Motor Power/Regeneration or Battery Power (10kW & 100kW)

• Aux = Lights, Rear Defroster... (200W & 2kW)
• Hetr = Cabin Heater (600W & 6kW)
• A/C = Air Conditioner (includes Hetr if heater active) (600W & 6kW)

On the Motr or Batt graph a bar starting from the right side and growing to the left indicates regeneration (power
added to the battery).

5(Left bottom number) xx.x kWh Remaining battery energy. This is the absolute energy remaining in the battery (no
reserve). It is calculated based on current Gids and the Wh per Gid set on the Settings/Battery panel (default 77.5
Wh/Gid).

6(Right bottom number) xxx Wh or xxx^ Wh or xxx* Wh Energy counters This field displays the energy used or
only the energy gained from regeneration. The energy counter has four modes of operation. Three modes are automatic
as to what energy is accumulated and when it is reset. The energy for the current drive is always protected and cannot

45
 be reset until the end of the drive. The fourth mode allows the user total control as to when the counter is reset. Mode
selection is done on the Settings/Battery panel using the Configure Wh Counter option.

Tapping on the Energy number toggles between the Energy counter and the Regen counter. When in user mode the energy
value has an asterisk * appended to it. When displaying the regeneration energy the value has a "^" appended. The
example below shows regeneration energy.

┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐
│ │ │ │ │ ├─┐
│ │ │
│ │ │ │ │ ├─┘
└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘

7.7kWh 245^ Wh
remain └─────────┘<=Tap on number
┌─────┐
│RESET│
└─────┘

A Reset button is only available when the User controlled counter is displayed or if counter includes energy from a
previous drive. The portion of the energy accumulated in the energy counter from the current drive is always protected
and cannot be cleared while driving. If no trip is active then pressing the RESET button clears all the energy counters.

The energy counter can be set to automatically clear based on the configuration selected Settings/Battery panel. The four
reset options are:

Reset Manually, Drive+Chrg The counter is only reset manually and the counter accumulates both energy used to
drive (+) and energy replaced by charging (-). A reset button will appear below the number when the counter can be
reset. The energy used during the current drive or charge is protected and can not be cleared until the drive or charge
has ended. Pressing the reset button during a drive or charge will only clear the energy accumulated from previous
drives or charges.

Reset Manually, Only Drive The counter is only reset manually and accumulates only energy used while driving and
not while charging. A reset button will appear below the number when the counter can be reset. The energy used
during the current drive is protected and can not be cleared until the drive has ended. Pressing the reset button during a
drive will only clear the energy accumulated from previous drives but not he current drive.

App Start & 1st Connect, D+C The counter automatically resets at the start of each drive or charge. The counter
accumulates energy used while driving or charging.

User Wh Counter* This energy use counter can be reset by the user at any time even while driving or during a
charge. The counter accumulates energy used while driving and charging.

Tire/Battery Temperature Panel

This panel displays either the pressure of each of the four tires or the battery temperature sensors. Use the control on
the Settings/Tire Pressure panel to enable automatically alternating between the two displays. A tap on the panel will
disable automatic alternating and additional taps will switch between the Tire and Temperature displays. A long tap will
enable automatic alternating.

Tire Display

The numbers in this panel will be grayed out when data is not being received from the TPMS units. When you first install
Leaf Spy the tire pressures will read n/a and be grayed out until you drive the Leaf a few hundred feet. This is because the
TPMS (Tire Pressure Monitoring System) unit in each wheel sleeps to save battery life until it senses the Leaf is moving
46
or senses a sudden change in pressure. The panel numbers being grayed out with parenthesis around the tire pressure units
(PSI, Bar or kPa) indicates the reading are not current but from a previous drive. Drive the Leaf for a few hundred feet to
wake up the TPMS units to get fresh pressure readings which will remove the parenthesis and change the numbers from
gray to black. If instead of parenthesis the pressure units are surrounded by "< >" this indicates the pressures are simulated
values and the Test Mode option has been enable on the Settings/Debug panel.

Two alarms can be enabled on the Settings/Tire Pressure panel. One alarm can be triggered if any tire is at or below a set
pressure. Another alarm can be triggered if the pressure difference between any two tires is equal to or greater than a set
amount. When an alarm is triggered screen 4 is automatically displayed with the low tire(s) and/or delta amount
highlighted in flashing Red. Tap the panel to temporarily disable the alarm.

When tires are not located in the correct position relative to the Leaf graphic due to tire rotation the Settings/Tire
Pressure panel can be used to remap their location on the screen. To determine current tire location on the screen either
add or remove pressure from a tire and note the corresponding pressure change on the screen.

Battery Temperature Display

The battery temperature readings can be displayed in one of two formats controlled by the Settings/Battery
Temperature panel.

max/avg/min This format displays an active thermometer with three large numbers on the left side. The top number is
the maximum sensor reading, the middle number the average of all sensor readings and the lower number the
minimum sensor reading. The small number in the lower right corner is the ambient outside temperature and is only
valid while the Leaf is on and not charging. If the ambient number looks to be in the wrong units go to
the Settings/Units panel and enable "Convert Outside Temperature" or if already enabled then disable it.

Sensors This format displays the 3 or 4 temperature sensors depending on the Model Year of the Leaf. In 2013 Nissan
removed one of the four original temperature sensors from the battery pack. The sensors are located as follows relative
to their position on the panel:

• Upper Left - Center of block of 24 modules located under the rear seat. Normally this is the hottest.
• Upper Right - Right side of modules under front right seat
• Lower Left - Left side of modules under rear left floor. Removed on 2013 and later year Leafs.
• Lower Right - Right side of modules under rear right floor.

Range & Trip Countdown Counter panel

This panel displays an estimated Range to one of three events and an optional Trip Countdown Counter. This sub panel
contains two tap sensitive areas and optionally two buttons (+ -). The tap sensitive areas are used to select the event and
efficiency mode and enable/disable the Trip Countdown Counter. The two buttons are used to change the efficiency if
in manual mode and to enable and change the Trip Countdown Counter starting value.

Tap the upper area of the panel to cycle through the three event choices

• LBW Low Battery Warning

• VLBW Very Low Battery Warning
• Predefined %SOC or kWh level Where SOC range is 0 to 25% and kWh range is 0.5 to 1.0 kWh and is
selected/defined on the Settings/Range panel.

A long tap on this upper area will enable and disable the Trip Countdown Counter. When the Trip Countdown
Counter is active the trip distance remaining will be displayed on the left followed by a down arrow and the range to
event number will be displayed on the right. The default starting value for the Trip Countdown Counter is set on
47
the Settings/Trip Distance panel. In addition to setting starting distance there is also an option, by selecting 0 distance, to
use the current Range estimate as the starting Trip distance. This can be used to gauge the accuracy of the Range estimate
by using it as the starting trip distance and driving to see if the estimated Range is reached before the event happens.

Tap the middle or bottom (if in Landscape) area to cycle through the four ways to determine the efficiency used to
calculate Range. The manual method allows the driver to set the efficiency based on their past experience for the route.
The selected method is indicated by the leading character before the "@" sign.

• (no letter) - Efficiency manually entered

• T - Efficiency of current trip
• C - Efficiency since last charge
• i - Efficiency of last km

When the manual method is selected the Plus or Minus buttons appear and are used to increase or decrease the efficiency
used to calculate Range. The efficiency units used can be changed on the Settings/Range panel. When one of the three
automatic methods is selected the efficiency is calculated based on the recent history of the distance traveled (trip, charge,
last km) and energy used during that distance.

When in manual efficiency mode the Trip Countdown Counter can be adjusted up and down by holding down
the Plus or Minus button. The rate of change will increase after holding the button down for more than 5 seconds.

When in one of the automatic efficiency modes the Trip Countdown Counter can be adjusted by tapping or holding
down the Plus or Minus buttons.

Special Feature: The font size of the Trip Countdown Counter and Range can be adjusted by enabling the Trip
Countdown Counter so it is visible and placing the screen in Screen Frozen mode by tapping the status box (lower right
corner). In this mode tapping the Plus or Minus key will increase or decrease the font used to display the Trip
Countdown Counter and Range numbers.

48
Braking & Motor Power Graphs (Screen 5 if enabled)
These graphs are an experimental feature and only available on Leaf Spy Pro. They may or may not work correctly
depending on you Android Device and OBDII Adapter.

Warning When these graphs are selected no other data can be read from the Leaf. This means that none of the data for the
other screens will be updated until you exit these screens. This includes Logging which will be suspended while these
screens are selected.

Tap the graph to toggle between the Brake monitor graph and Motor Power graph.

49
Service Functions (Screen 5 or 6)
By default the Service screen is disabled each time LeafSpy Pro is started to prevent unintended service operations from
being executed. To enable the Service screen go into the Settings/Service Screen panel and check "Enable".

The Service functions allow you to read and if appropriate clear DTCs (Diagnostic Trouble Codes). Clearing DTCs
should only be done if you understand the reason for the fault and feel it has been corrected.

Service functions also allow you to customize your Leaf's behavior such as when doors are automatically locked and
unlocked, when Headlights and Interior lights are automatically turned on and off and any delay involved in these actions
and when various inside and outside sounds are generated.

For informational purposes there is also a function to display all your Leaf's ECU (Electronic Control Unit) version
numbers as well as some serial numbers such as the serial number of your high voltage battery pack.

For the more advanced user there is a function to register the four wheel TPMS sensors and their locations on the Leaf
(ex. front left, rear right). This function can be used after the tires have been rotated or if you have seasonal tires you swap
during the winter.

• Door Lock/Unlock Settings

• Headlight Settings
• Interior Light Settings
• VSP Settings
• Dashboard Language (2011-2017)
• TPMS Management
• Read ECU versions
• Read DTCs
• Clear DTCs

Door Lock/Unlock
Use this option to change how all doors are unlocked and to change the automatic door lock/unlock settings of the Leaf.

Presses to unlock all doors This option determines how many presses of the door button are needed to unlock all doors.
The factory default is one press to unlock the driver's door and two presses to unlock all doors. Use this option to have one
press unlock all doors or to change back to having two presses unlock all doors.

Automatic This option is the master control for the automatic lock and unlock functions.

Lock & Unlock Both door locking and unlocking will be controlled automatically based on conditions set below.

Unlock Only door unlocking will be controlled automatically based on conditions set below.

Lock Only door locking will be controlled automatically based on conditions set below.

Off Automatic door locking and unlocking is disabled.

Auto Lock This option is enabled if either automatic Lock & Unlock or just Lock has been enabled. Select one of the two
choices to control when all the doors are locked.

50
 At 15 MPH All doors are locked when the Leaf reaches a speed of 15 MPH (24km/h).

Out of Park All doors are locked when the Leaf shifter is taken out of Park.

Auto Unlock This option is enabled if either automatic Lock & Unlock or just Unlock has been enabled. Select one of the
four choices to control when all the doors are unlocked.

All Doors - Ign On->Off Unlock all doors when the Leaf is Turned Off.

All Doors - Shift into Park Unlock all doors when the Leaf is Shifted into Park.

Driver Door - Ign On->Off Unlock only the driver's door when the Leaf is Turned Off.

Driver Door - Shift into Park Unlock only the driver's door when the Leaf is Shifted into Park.

Headlight Settings
This function is used to change the automatic on and off function of the Headlights.

If your Leaf did not originally come with the automatic headlight feature you will be given the option to enable
it. However, you must have first install all the necessary hardware to support the automatic headlight feature for
this to have any affect.

There are four controls. The first enables the battery saver function that tries to save the battery by not allowing the
headlights to be left on for more than 5 minutes after the Leaf has been turned off. The second controls the delay used to
keep the headlights on after the Leaf has been turned off and all doors have been closed. The third controls the sensitivity
of the dusk sensor that automatically turns on the Headlights under dim light conditions. The fourth controls under what
conditions the headlights are automatically turned on. On this fourth control it appears that not all conditions have been
implemented on the Leaf or might vary by model year.

Battery Saver (off after 5 minutes)

• Enable (default)
• Disable (not recommended as you risk draining your 12 volt battery)

Auto Off Delay (After all doors closed)

• 45 Seconds (default)
• Off (0 seconds)
• 30 Seconds
• 60 Seconds
• 90 Seconds
• 120 Seconds
• 150 Seconds
• 180 Seconds

Auto On Sensitivity

• Normal (default)
• More

51
 • Most
• Least

Auto On

• At twilight or wiper INT, LO, HI (default)

• At twilight or wiper LO, HI
• At twilight
• wiper INT, LO, HI
• wiper LO, HI
• Disabled

Interior Light Settings

This function is used to change the automatic turn off behavior of the interior lights. There are three controls. The first
enables or disables the delayed auto turn off function. The second sets the delay before the interior lights automatically
turns off and the third function controls which door or doors start the auto turnoff delay.

Delay Light Turn Off

• Enable (default)
• Disable

Light Off Delay

• 7.5 Seconds
• 15 Seconds (default)
• 30 Seconds

Use Delay with

• All Doors (default)

• Driver Door

52
VSP Settings
For 2013 and newer Leafs this function is used to enable and disable the sounds created by the VSP function. The VSP
board generates the sounds for two different speakers. One speaker is located under the dash and makes the sounds heard
inside the Leaf. The other speaker is in the engine compartment and makes the sounds heard outside the Leaf.

None of these settings affect the Hazard or turn signal sounds.

• Drive Start Sound - Outside sound generated when the Leaf starts to move to alert pedestrians that a vehicle
nearby is moving.
• Drive Sound - Outside sound generated which the Leaf is moving a low speed.
• Reverse Beeps - Outside sound generated when backing up. It is not recommended that you disable this sound
as it is a safety feature for pedestrians.
• Vehicle Start Sound - Inside sound played when Leaf is turned on and off.
• Sound A - (Not known to control any sounds at this time)
• Sound B - (Not known to control any sounds at this time)
• Charge Sounds - Outside sounds generated when opening charge door, plugging in charge cord, starting a
charge and manually overriding the charge timer.

Dashboard Language
This function allows the 2011 thru 2017 Leaf's Dashboard language to be changed. The following ten languages are
supported. The main use for this function is to convert an exported Japanese Leaf to one of the other available languages.

• Japanese
• English 1
• English 2
• German
• Dutch
• French
• Italian
• Spanish
• Portuguese
• Turkish

TPMS Management
TPMS Overview

Each wheel on the Leaf includes a TPMS (Tire Pressure Monitor System) unit that senses and broadcasts the tire's
pressure. Each TPMS unit broadcasts with a unique ID number which the Leaf uses to identify each of the four wheels
and their positions on the Leaf. To extend the TPMS's battery life (sealed unit can not be changed) the TPMS only
transmits data when the wheels are turning or a significant pressure change is detected.

Whenever the wheels are rotated the Leaf should be made aware of the new locations of each wheel. This procedure,
called Tire Registration, can be done by the dealer with an expensive dedicated tool or with the normal service tool
(Consult 3 Plus) by temporarily setting each tire to a unique pressure in a specific order. However, since the Leaf only
reports low pressure tires with a single warning light tire registration is not typically done by the dealer.

53
If the wheels are not correctly registered it causes two problems. Since LeafSpy displays tire pressures relative to the
wheel's position on the Leaf if the wheels are not registered correctly the order of the pressures displayed will be wrong.
Second, if you have seasonal tires with TPMS units you will need to register them or the Leaf will report a solid tire fault
since it does not recognize these new TPMS units and so has no pressure information.

Available TPMS functions

LeafSpy Pro supports six functions that allow complete control of TPMS and supports both tire rotation and seasonal tire
changes. The functions available are:

• Save - Save Leaf's current TPMS IDs

• View - View a previously saved set of TPMS IDs
• Load - Load a saved set of TPMS IDs into the Leaf
• Delete - Deleted a previously saved set of TPMS IDs
• Rotate - Rotate TPMS IDs stored in the Leaf
• Learn - For 2011-2017 Leaf activate the Leaf's built-in Learn function

TPMS IDs are saved and loaded based on the type of tires. There are five types of tires plus when loading a manually
generated one to handle new TPMS IDs.

• All Season
• Summer
• Winter
• Set A
• Set B
• New TPMS - supports new TPMS units

For the 2011-2017 Leaf it is possible to use the Learn function when a new set of TPMS units is being used. The other
option is to find out the TPMS IDs either from the packaging or using an external TPMS ID reader and then create a text
file named TPMS.txt. Note that on 2011-2017 Leafs the TPMS (315 MHz) ID is 6 characters long and on 2018 and
newer Leafs the TPMS (433 MHz) is 7 characters. This text file can be placed in the Dropbox folder named Copy to
LeafSpy and it will automatically be download to the /Android/data/com.Turbo3.Leaf_Spy_Pro/files/TPMS folder or
you can manually copy the file there.

• 0A3AB2B
• 0d2A52B
• 004B32B
• 0505692

The order is Front Left, Front Right, Rear Right and Rear Left.

Tire Rotation

For all Leafs tire rotation is best done using the Rotate function which directly rearrange the IDs in the Leaf to match
their new location.

Tire Registration

For the 2011-2017 Leaf, the Learn function should be reserved for when a new set of TPMS IDs are being introduced to
the Leaf. Otherwise use the Rotation function.

54
Before starting a Tire Registration (Learn) be sure to check that you have the latest version of LeafSpy Pro as several
improvements have been made to make the process easier and more reliable. With the new version, while adjusting tire
pressures, LeafSpy can now report the pressure changes when the Leaf is turn on (not ACC mode) eliminating the need
for a pressure gauge.

Note: You must have a way to add air to the tires before starting registration as you will need to restore your tires to full
pressure after registration has been completed.

Use this function to register your tires after a tire rotation or when swapping seasonal tires. The method used is the same
procedure as the one used by the dealer's Service Tool. Each tire is set to a unique pressure starting with 38 PSI in the
front left tire and going clockwise around the Leaf with 4 PSI less for each one (38 34 30 26 PSI) ending with the left rear
tire at 26 PSI.

If you are swapping wheels you will need a fairly accuracy pressure gauge to setup the pressure sequence. If you have
only rotated your tires and LeafSpy can still display the tire pressures (just not in the correct order) then you can use
LeafSpy to set the tire pressures while parked by turning the Leaf on (not ACC mode) and running LeafSpy. To test go to
the Tire Registration screen and then add a few PSI to the front left tire. In about 15 seconds you should see the pressure
reported on the Tire Registration screen to the right of the TPMS ID. If you see the increase you can then start letting air
out slowly and waiting 15 seconds until the change is reported. Use this procedure to set the other four tires to the required
pressures. Once the pressures are set you can get in the Leaf, press the Start Tire Reg button and start driving. In about 5
to 10 minutes registration should complete with a status message change and a tune sounding. When done be sure to
adjust all the tire pressures back to their recommended pressures (36 PSI / 2.5 Bar / 250 kPa).

Read ECU versions

The function will read all the ECUs (Electronic Control Units) in the Leaf and display their version number and some
additional information if available. For example when reading the BMS ECU the High Voltage battery pack serial number
is also read and displayed. Here is a example of what the ECU version list looks like.

JN1AZ0CP9BT009999
3NA0A BRAKE
3NA1A ABS
3NA0A EPS VA51309095
XXXXX METER
3NA0A HVAC
3NA0B BCM
3NA0D TCU
3NA0B MULTI AV
3NA0A IPDM E/R
3NA0A AIR BAG
3NA0A PARKING BRAKE 36580113008968
3NA0A MOTOR CONTROL 22021113710096H1
3NA0E CHARGER 23511113013941
3NA2A EV/HEV
3NA0D HV BATTERY 230JT1113A009999
3NA0B SHIFT 34001113095

Read DTCs
When a fault is detected by one of the Leaf's ECUs (Electronic Control Units) one or more check codes called Diagnostic
Trouble Codes (DTC) are set internally and a dash warning light turns on. Use this option to read out the five character
DTCs. Included with the DTC is a short description and a reference to the Service Manual section describing the problem
and action to be taken to correct it. A page number is also included but this is only valid for the 2011 Service manual. Do
a search of the DTC to find the correct section in later versions of the Service Manual. Here is an example of a DTC read
with a single fault code of P1557 caused by disconnecting the 12 volt battery sensor cable.

55
Use the Save button on the DTC screen to save (append) a copy of the DTC screen to the DTC log file. The file name will
include the VIN and the DTC data is tagged with a timestamp and current odometer reading.

Ok None---> ABS
Ok None---> AIR BAG
Ok None---> BCM
Ok None---> BRAKE
Ok None---> CHARGER
Ok None---> PARKING BRAKE
Ok None---> EPS
P1557 00C0 EV/HEV Battery Temp Sensor EVC-173
Ok None---> HVAC
Ok None---> HV BATTERY
Ok None---> IPDM E/R
Ok None---> METER
Ok None---> MOTOR CONTROL
Ok None---> MULTI AV
Ok None---> SHIFT
Ok None---> TCU

Clear DTCs
Clearing DTCs is only enabled after a Read DTC has reported at least one DTC. If there are no DTCs then this function is
disabled. DTCs are reset by ECU. Select the ECU you would like to have the DTCs cleared and then press Clear DTC &
FFD. Repeat for any remaining ECUs that have DTCs.

Warning Do not clear DTCs unless you understand the cause and feel the problem has been corrected. One example
of this would be if your 12 volt battery dies. This will cause numerous DTCs as each ECU detects the out of
specification 12 volts coming from the 12 volt battery. Here is an example of what you might seeing from a dying
battery

C118C 0108 ABS EV/HEV System BRC-126

Ok None---> AIR BAG
Ok None---> BCM
C1A62 0108 BRAKE Control Mod Pwr Supply BR-53
C1A6E 0108 BRAKE EV/HEV System BR-146
Ok None---> CHARGER
Ok None---> PARKING BRAKE
Ok None---> EPS
P3180 00C3 EV/HEV HV Battery System EVC-249
P317B 00C3 EV/HEV Motor System EVC-247
P31E2 00C3 EV/HEV HV System Interlock Error EVC-308
Ok None---> HVAC
P30FE 0008 HV BATTERY 12v Battery Voltage EVB-94
Ok None---> IPDM E/R
Ok None---> METER
P0A8D 0008 MOTOR CONTROL 14v Power Supply EVC-132/TMS-63
Ok None---> MULTI AV
Ok None---> SHIFT
Ok None---> TCU

Since all these DTCs were caused by the dying battery, after replacing or charging the 12 volt battery these DTCs can all
be safely cleared.

Clear P0AA1

Clearing the special P0AA1 DTC is now supported as a separate option on the clear DTC menu. Since the P0AA1 fault
involves the high voltage contactor care should be taken when clearing it. Be sure the condition that caused this DTC have
been corrected before attempting to clear it. Take all necessary safety precautions specified in the Leaf Service manual.

56
Pair Battery P3102

Support is now available for the P3102 DTC that happens when swapping to a different high voltage battery pack. This
function updates the VCM ECU with the Battery ID stored in the BMS ECU.

When needed, a special "SYNC Lx/QC" function is available in the Clear DTC function. This function is enabled by first
Reading DTCs. If the VCM Lx/QC counts do not match the Battery Pack Lx/QC counts then a "SYNC Lx/QC" option is
added to the list of ECU available to the Clear function. This can happen when replacing the high voltage pack.

___________________________________

57
Data Logging
The logging function saves data read from the Leaf to a .CSV file located in
directory /Android/data/com.Turbo3.Leaf_Spy_Pro/files/LOG_FILES. This file can be imported/read into an Excel
spreadsheet for later analysis.

The various logging function options are controlled on the Settings/Logging panel. The options and status that are
available there are:

SD Status & Bytes Available Before enabling Logging be sure you have an SD card installed and there is sufficient free
space available. If the free space drops too low (<1MB) logging will automatically be suspended and an on screen
message displayed.

Enable Data Logging Enables the data logging function.

Logging Interval The target logging interval range can be set from once every 2 seconds to once per hour. It is a target
because the actual interval depends on how long it take to collect a complete sample set of data from the Leaf. A
difference between target and actual sample rate is most visible with targets from 2 to 10 seconds. At these fast times the
time to collect a complete set of data can be longer than the target interval.

When BMS mode is selected for "Model Year" the 2 second logging rate is increased to the maximum possible which is
less than 1 second per sample. This can be done because in BMS mode only data from the BMS is being read making
collecting a complete sample much quick.

Enable GPS Enables GPS so that location information can be saved in the log file. This option also needs to be enabled
for the Elevation/Speed graph to function since the data plotted comes from GPS.

Always keep GPS Active If this option is checked once Leaf Spy detects an OBDII adapter GPS will be turned on and
kept on until you exit the application. This option overrides the default that disables GPS whenever the Leaf is turned off.

Force Log Pressing this button will force a log entry at the next opportunity independent of the interval settings. Use this
button if you have selected a long interval but wish to override it. Logging is always conditional on the collection of a new
sample set from the Leaf.

Date Format The format of the date saved to the log file is controlled by this option. The four options are:

• Default = Current Android device default

• Month/Day/Year
• Day/Month/Year
• Year/Month/Day

Append YYMMDD to file name This option will append the date to the end of the log file name creating a new file for
each day you log data. While you are driving the date will not change. If you drive through midnight new data will be
appended to the previous day's file not start a new one at midnight. The default log file name is "Log_(last 8 characters
of VIN)_DeviceID.csv". With this option checked the file name will be "Log_(last 8 characters of
VIN)_YYMMDD_DeviceID.csv".

Why are some cell pair voltages negative in the CSV file? When a Shunt is active the corresponding cell pair voltage is
saved to the log file as a negative voltage. Use the ABS(xx) function to create a separate column if you wish to plot a cell
pair's voltage over time. To sum a row of cell pairs use =SUMPRODUCT(ABS(your range))

58
Log File Format (csv)
[Column Label Example Description]

A "Date/Time" "05/28/2014 9:41:44" Date/Time in either the default format or user selected format. Warning Time is
saved as HH:MM:SS but when imported into excel the default display format is HH:MM. This means if you then export
the file you will lose the seconds information. This can be avoid by changing the display format for time to be
HH:MM:SS after importing the file.

B "Lat" "123 12.12345" Latitude in ddd mm.mmmmm format. Note that minutes has 5 digits of precision. Warning Be
sure to check that all significant digits of minutes are displayed before saving the file otherwise you will lose location
accuracy.

C "Long" "-123 12.12345" Longitude in ddd mm.mmmmm format. Note that minutes has 5 digits of
precision. Warning Be sure to check that all significant digits of minutes are displayed before saving the file otherwise
you will lose location accuracy.

D "Elv" "308" Elevation in the currently selected units (feet or meters). Elevation is received from the GPS hardware in
the Android device. Not from the Leaf

E "Speed" "34" Speed in the currently selected units (mph or km/h). Speed is received from the GPS hardware in the
Android device. Not from the Leaf.

F "Gids" "112" Gids which indicates the energy in the Leaf battery. Nissan multiplies this value by 80 Wh to get current
capacity of the HV Battery. For this example that would be (112 x 80) = 8960 Wh.

G "SOC" "474133" State of Charge (SOC) of the HV Battery. Divide this number by ten thousand (10000) to get % SOC
(47.4133% in this example).

H "AHr" "554385" Capacity of HV Battery. Divide by ten thousand (10000) to get AHr rating (55.4385 AHr in this
example). This is how much energy the battery could hold when fully charged. You can get an estimate of energy
currently in the battery by multiplying SOC% times AHr times 360 volts (nominal HV battery voltage) = WHr. For the
example data that would be (0.474133 x 55.4385 x 360) = 9462.68 WHr or 9.462 kWhr.

I "Pack Volts" 373.82 HV Battery voltage calculated by multiplying average cell pair voltage by 96. During charging of a
2013 or newer Leaf this value will be read directly from the Leaf.

J "Pack Amps" "0" HV Battery amperage, positive =from battery (driving), negative when Regen or charging.

K "Max CP mV" "4033" Millivolts of highest cell pair. Divide by one thousand (1000) to get the highest voltage of any
cell pairs in Volts. In this example the highest cell pair has a voltage of 4.033 volts.

L "Min CP mV" "4017" Millivolts of lowest cell pair. Divide by one thousand (1000) to get the lowest voltage of any cell
pair in Volts. In this example the lowest cell pair has a voltage of 4.017 volts

M "Avg CP mV" "4025" Millivolts of average cell pair. Divide by one thousand (1000) to get the average voltage of all
96 cell pairs in Volts. In this example the average cell pair voltage is 4.025 volts.

N "CP mV Diff" "16" Millivolts difference between highest and lowest cell pairs. The lower this number the better
balanced is the pack.

59
O "Judgement" "0" This value, if not zero, is used to determine which, if any, cell pair needs to be replaced. Any cell pair
whose millivolt reading is less than or equal to the Judgment millivolt value needs to be replaced. The Judgement value is
only calculated when the minimum cell pair voltage is less than or equal to 3712 mV. This means that the HV battery
must be mostly discharged before a Judgement value is calculated.

P "Pack T1 F" "78.4" HV Battery temperature sensor 1 in degrees Fahrenheit which is located in the center of the rear
battery block. Normally the highest temperature.

Q "Pack T1 C" "25.8" HV Battery temperature sensor 1 in degrees Centigrade which is located in the center of the rear
battery block. Normally the highest temperature.

R "Pack T2 F" "77.9" HV Battery temperature sensor 2 in degrees Fahrenheit which is located in the front right hand
battery block.

S "Pack T2 C" "25.5" HV Battery temperature sensor 2 in degrees Centigrade which is located in the front right hand
battery block.

T "Pack T3 F" "78.4" or "na" HV Battery temperature sensor 3 in degrees Fahrenheit which is located in the left hand
center battery block. Not present starting with model year 2013.

U "Pack T3 C" "25.8" or "na" HV Battery temperature sensor 3 in degrees Centigrade which is located in the left hand
center battery block. Not present starting with model year 2013.

V "Pack T4 F" "77.5" HV Battery temperature sensor 4 in degrees Fahrenheit. For model years 2011/2012 it is located on
the right hand side of the rear battery block. For later model year it has been moved to the right hand center battery block.

W "Pack T4 C" "25.3" HV Battery temperature sensor 4 in degrees Centigrade. For model years 2011/2012 it is located
on the right hand side of the rear battery block. For later model year it has been moved to the right hand center battery
block.

W thru DO "CP1" thru "CP96 "3893" These are the 96 cell pair voltages measured in millivolts. Negative values indicate
that the corresponding shunt is active. During pack balancing the shunts are used to drain a small amount of energy from
the cell pair.

DP "12v Bat Amps" "-7.72A" 12 volt battery current. Minus is drain and positive is charging. Only available on
2011/2012 Leafs otherwise "na".

DQ "VIN" "JN1AZ0CP9BT123456" This is the VIN number of the Leaf.

DR "Hx" "88.51" This is an indication of the HV Battery's health. A value of 100 would be a battery in factory new
condition. The number is thought to be an indication of battery internal resistance with 100 indicating a new battery with
lowest resistance. As the value decreases the internal resistance is increasing. As the internal resistance increases more
energy is wasted as heat inside the battery instead of powering the Leaf.

DS "12v Bat Volts" "11.84V" The voltage of the 12 volt battery as read by the Leaf's VCM ECU.

DT "Odo(km)" "57604" Odometer reading in kilometers.

DU "QC" "17" Number of Quick Charges.

DV "L1/L2" "4287" Number of time a J1772 connector has been plugged into the Leaf. If the charge timer is enable so
charge does not start when immediately plugged in the count may increase by two. One count when the charge cord is
plugged in and a second count when/if the charge starts.
60
DW "TP-FL" "39.25" Tire pressure (PSI) of front left wheel assuming wheel locations have been properly registered with
the Leaf. Quarter PSI steps.

DX "TP-FR" "39" Tire pressure (PSI) of front right wheel assuming wheel locations have been properly registered with
the Leaf. Quarter PSI steps.

DY "TP-RR" "38.75" Tire pressure (PSI) of rear right wheel assuming wheel locations have been properly registered with
the Leaf. Quarter PSI steps.

DZ "TP-RL" "38.50" Tire pressure (PSI) of rear left wheel assuming wheel locations have been properly registered with
the Leaf. Quarter PSI steps.

EA "Ambient" "65" Ambient temperature comes from the Leaf's outside temperature sensor and is saved in degrees
Fahrenheit. This value is only valid when the Leaf is ON (not ACC mode and not when charging)

EB "SOH" "87.45" The State of Health of the Battery in percent. After reaching 85% for several weeks the first capacity
bar on the right most side of the dash will be lost.

EC "RegenWh" "-539" This is the current value of the Resettable regeneration energy counter displayed on the summary
screen. Units are Watt/hours. This value also counts energy during charging.

ED "BLevel" "49" Battery level of Android device as percent full (49% in this example).

EE "epoch time" "1401294350.123" This is the time the sample was written in seconds from 1/1/1970 with millisecond
resolution.

EF "Motor Pwr(w)" "37800" Drive motor power in watt units. For this example 37.8 kW. For 2011 and 2012 models
regen power is indicated by a negative number.

EG "Aux Pwr(100w)" "2" Power used by the auxiliary equipment (Lights, Radio, Navigation system, rear defroster...) in
100 watt units. Multiply by 100 to get watts. For this example 200 watts.

EH "A/C Pwr(250w)" "3" Power used by the Air Conditioning System power in 250 watt units. This includes the power
used by the cabin PTC Heater. Multiply the value by 250 to get power in watts. For this example 750 watts.

EI "A/C Comp(0.1MPa)" "25" A/C Compressor high side pressure in 0.1 MPa units. Multiply by 14.50377 to get PSI. For
this example 362.6 PSI.

EJ "Est Pwr A/C(50w)" "17" Estimated Air Conditioning System power in 50 watt units. Multiply by 50 to get power in
watts. For this example 850 watts.

EK "Est Pwr Htr(250w)" "8" Estimated Cabin PTC Heater power in 250 watt units. Multiply by 250 to get power in
watts. For this example 2,000 watts.

EL "Plug State" "2" Plug state of J1772 (L1/L2) charge port.

• 0= Not plugged
• 1= Partial Plugged
• 2= Plugged

EM "Charge Mode" "2" Charging mode.

61
 • 0= Not charging
• 1= Level 1 charging (100-120 volts)
• 2= Level 2 charging (200-240 volts)
• 3= Level 3 Quick Charging

EN "Chrg Pwr" "3300" Charging power coming into the Leaf in watts.

EO "Gear" "7" Gear position.

• 0= not read yet

• 1= Park
• 2= Reverse
• 3= Neutral
• 4= Drive
• 7= B/Eco

EP "HVolt1" "381.5" High Voltage Battery voltage in volts. It is not clear if HVolt1 and HVolt2 are values taken at
different times by the Leaf or from different places in the Leaf. Values come from the BMS ECU.

EQ "HVolt2" "381.4 High Voltage Battery voltage in volts. (See above for why there are two values)

ER "GPS Status" "37F" This hexadecimal number indicates the state of GPS and the current accuracy. The high byte is
the accuracy in meters. The low byte is a bit significant encoded number based on the following table. Used to debug GPS
problems. The value of "37F" means the current accuracy is 3 meters and GPS is fully functional and all reading are valid.

• 01 = GPS Hardware available

• 02 = GPS Hardware enabled
• 04 = GPS Logging enabled
• 08 = GPS on
• 10 = GPS Accuracy is Valid
• 20 = GPS Altitude is Valid
• 40 = GPS Speed is Valid

ES "Power SW" "1" This field will be "1" if Leaf Spy has read the Power Switch and found it active otherwise it will be
"0".

ET "BMS" "1" This field will be "1" if Leaf Spy has been communicating with the BMS ECU otherwise it will be "0".

EU "OBC" "0" This field will be "1" if Leaf Spy has been communicating with the OBC ECU otherwise it will be "0".

EV "Debug" "0x80" This field is used for debug information which can vary depending on the build version. An example
would be the Power Switch status.

EW "Motor Temp" "70" This field is the drive motor temperature as C+40. To get C just subtract 40 from the value.

EX "Inverter 2 Temp" "51" This field is the Inverter 2 temperature sensor value as C+40. To get C just subtract 40 from
the value. Only available on 2011-20012 Leafs.

EY "Inverter 4 Temp" "65" This field is the Inverter 4 temperature sensor value as C+40. To get C just subtract 40 from
the value. Only available on 2011-20012 Leafs.

EZ "Speed 1" "2495" This field from Speed sensor 1. Divide by 100 to get speed in km/h (ex 24.95 km/h).
62
FA "Speed 2" "2526" This field from Speed sensor 2. Divide by 100 to get speed in km/h (ex 25.26 km/h).

FB "Front Wiper Status" "08" This field is the status of the front wipers. The value is saved in hexadecimal format for
easier reading.

• 80 = Front Wiper High

• 40 = Front Wiper Low
• 20 = Front Wiper Switch
• 10 = Front Wiper Intermittent
• 08 = Front Wiper Stopped

FC "Motor Torque" "4.25" This field is the requested Motor Torque in Nm. Minimum unit step is 0.25 Nm.

63
Settings
Settings
Use this panel to Backup and Restore your settings to the SD Card in directory
/Android/data/com.Turbo3.Leaf_Spy_Pro/files/SETUP.

Units
Use this panel to select temperature, distance/speed, and pressure units. Use the Convert Outside Temperature option to
convert the outside temperature displayed on screen 4 to the opposite units if the automatically selected units is not
correct.

Temperature

• Fahrenheit
• Centigrade

Distance/Speed

• Feet, Miles, MPH

• Meters, km, km/h

Pressure

• Bars
• PSI
• kPa

CAN Odometer in Miles - Use this option if the Odometer value is not displayed correctly on screen 1. This option is
only available starting with the 2018 Leaf which has switched to using both miles and km for the odometer read from the
CAN bus depending on country. It is expected that this option only needs to be enabled for US and UK Leafs where miles
are used for distance.

Language
Use this panel to select one of four languages. Please report any translation errors or suggested improvements to the
translation from English.

• English
• Japanese
• German
• French
• Chinese
• Russian
• Arabic

64
Model Year
Normally the Leaf Model year is automatically selected based on information embedded in the US VIN. For countries not
following the US VIN format use this panel to select your model year. At the moment this information is only used to
select the number of Battery temperature sensors displayed (3 or 4).

The pack size (24, 30, 40 or 62 kWh) is automatically detected when connected to the Leaf but can be changed when not
connected to the Leaf to review data captured from a Leaf with a different size battery.

For those using LeafSpy to monitor a standalone Leaf battery pack or Motor/Inverter there are a BMS and MTR/INV
options which are located at the top of the list where 2009 and 2010 would have been located. Selecting one of these
options forces LeafSpy to read only data from the BMS (Battery Management System) or Motor/Inverter ECU and skips
trying to read data from any other ECU. When BMS or MTR/INV mode is selected the words "BMS Only" or "MTR/INV
Only" will flash bottom center as a reminder that only BMS or MTR/INV data is being read.

Service Screen
Use this panel to enable the Service Screen. By default the Service Screen is Disabled each time LeafSpy is started. This
is done to protect against accidentally making changes to the Leaf.

Trip Distance
Use this panel to set the default trip distance loaded into the trip countdown counter when you do a long tap on the
distance to event number on screen 4. There are two ways to adjust this count while on screen 4 depending on whether
manual efficiency entry mode has been selected.

Manual efficiency mode Press and hold either the + or - button. After a short delay only the trip distance is displayed
with a down arrow. When that occurs release the button you were holding down. Then use the + or - button to adjust
the value. When done tap the trip distance number.

Other efficiency modes Use the + or - button to adjust the value.

Range
Use this panel to configure the distance to event panel on screen 4. The three events that can be cycled through by tapping
on the remaining distance number are: Distance to Low Battery Warning LBW, Distance to Very Low Battery
Warning VLBW or Distance to a pre-selected amount of reserve energy x% SOC or x.xkWh.

Use the radio buttons to select whether the reserve amount is based on %SOC or kWh then use the pull down menu to
select the amount of energy to be reserved (0 to 25% SOC or 0.5 to 1 kWh).

There are two ways to calculate remaining distance: one simple (available energy divided by efficiency) or a more
complicated formula taking into account battery temperature and ambient temperature developed by Tony Williams. The
default is to use the temperature adjusted formula. To select the simpler method uncheck the Use Temperature (Bat &
Air) to adjust DTE check box.

When miles is the selected units efficiency can be expressed as either Miles/kWh or Wh/Mile. When km is the selected
units efficiency can be expressed as either km/kWh or Wh/km. In manual efficiency mode the plus and minus keys on
screen 4 are used to adjust the efficiency used to calculate remaining range to event.

65
The efficiency used in the above calculations can be either manually entered based on the driver's experience for the
current route and adjusted as needed on Screen 4 or there are three automatically calculated efficiencies. The three
are T the efficiency for the current trip, C the efficiency since last charge or i the instantaneous efficiency which is
recalculated each km.

Tire Pressure
Use this panel to control the tire pressure alarms and adjust the tire pressure locations on screen 4 to match their actual
position on the Leaf without going through the Tire Registration process.

Alternate Tire/Temp Display This option controls whether upon LeafSpy startup the Tire Pressures and Battery
Temperature readings on screen 4 alternate. This settings can temporarily be changed on screen 4 by tapping the Tire
Pressure/Battery temperature display panel. If alternate is active it will be stopped. If it is not active a tap will toggle
between the two display formats. A long tap will activate alternating between the two display formats.

Sound Alarm This option control whether a tune is played when a tire warning pressure or delta warning pressure has
been reached. Tapping on the tire pressure panel on screen 4 will silence the alarm.

Use alternate method to read Tires (Not available on 2018 and newer Leafs) On some model Leafs Nissan has changed
the method to read the tire pressure. If that is the case then the normal method will not work and the tire pressures will
display n/a. Select this option to use an alternate method.

Note: LeafSpy Pro's TPMS Management function, on the Service Menu, now supports modifying TPMS locations
directly in the Leaf. This supports any possible rearrangement of the tires.

Enable Tire Remapping Use this option to rearrange the tire pressure readings on screen 4 to match the tire's actual
location on the Leaf. This is an alternative method from doing a Tire Registration accessible through the Service Menu.
To determine each tire's actual location a tire's pressure can be increased or decreased and then a note take as to which tire
location on screen 4 actually changes. Once the real location of each tire is determined use one or more of the following
three options to remap the tires' positions on screen 4 to match their real location on the Leaf.

Swap Front/Rear positions This option will do a straight front to back and back to front swap leaving the left/right
positions unchanged. This option, if checked, is done first. Then either or both of the following options are applied.

Swap Front Left/Right This option swaps just the front two tires left to right and right to left.

Swap Rear Left/Right This option swaps just the rear two tires left to right and right to left.

Enable Virtual Tire Registration Once you have the tires correctly displayed on screen 4 this option can be used
whenever the tires are rotated to automatically make the adjustments to screen 4.

Reset Use this option if you have done a Tire Registration to reset the tires to their default post registration position.

Swap Front/Rear Tires Use this option if you are rotating the tires according to Nissan's recommendation of a
straight front to back swap keeping left on left and right on right.

Swap Cross Front Use this option if you are doing a straight to back then cross to front swap.

Swap Cross Back Use this option if you are doing a straight to forward then cross to back swap.

66
Battery
These options can be used to customize your battery's characteristics and are intended for advanced users.

Restore Defaults Pressing this button will resort the battery characteristics to their default values.

• Shunt Order = 8421

• Nominal Pack Voltage = 360 volts
• Maximum Gids = 281 Gids (24 kWh), 357 Gids (30 kWh), 500 Gids (40kWh), 750 Gids (62kWh)
• Wh/Gid = 77.5 Wh/Gid

Shunt Order This option controls the highlighting in Red of the cell voltage bars on screen 1. A Red battery voltage bar
indicates that the Shunt is active for that cell. Shunts are small resistors that can be switched in to drain a small amount
of energy from one or more of the 96 cells that make up the high voltage battery pack. This is the method used by Nissan
to balance the pack by draining energy from the high energy cells. This works because charging stops to prevent
overcharging the highest energy cell. So by reducing the energy in the highest energy cell all the other cells are able to be
charged to a higher level.

(Warning this gets complicated.) Shunt status (on or off) is reported by the Leaf in 24 groups of four bit numbers (0 to
15). However, the ordering of the cells within the group of four bits is not known for certain. The Shunt Order field
allows for the reordering of the cell mapping within the group of four bits. The four shunts are given labels
representing their binary position (8 4 2 1) with 8 being the most significant or highest location bit and 1 being the
least or lowest position bit.

For the first two groups of 4 bits which defines the mapping for battery cells 0 thru 7 the default mapping value of
8421 results in a cell mapping to bits of 0123 4567.

Nominal Voltage Use this field to change the nominal voltage used to calculate the energy change in the battery for the
W/h counter. It is not recommended that you change this value unless the battery chemistry used by the Leaf changes
requiring a different nominal voltage be used.

Maximum Gids This pulldown menu allows you to set the maximum Gids used to calculate percent Gids remaining. The
ranges for each size battery are list in this table

• 24 kWh : 200 to 300 Gids

• 30 kWh : 300 to 380 Gids
• 40 kWh : 425 to 500 Gids
• 62 kWh : 675 to 775 Gids

Typically the value is set to the original maximum Gids value after a full charge when the Leaf was new and should not
normally be changed as the battery degrades.

Wh/Gid This pulldown menu allows the energy associate with each Gid to be varied between 65 to 80 Wh per Gid. This
number is used to calculate the available kWh of energy in the battery when calculated from Gids.

Configure Wh Counter Use this option to configure when to reset the Wh counter on screens 3 and 4. The four choices
are:

Reset Manually, Drive+Chrg The counter is only reset manually and the counter accumulates both energy used to
drive (+) and energy replaced by charging (-). Under perfect conditions (which never exist) after a drive then charge
the counter would return back to zero. The energy used during the current drive or charge is protected and can not be
cleared until the drive or charge has ended.
67
 Reset Manually, Only Drive The counter is only reset manually and accumulates only energy used while driving and
not while charging. The energy used during the current drive or charge is protected and can not be cleared until the
drive or charge has ended.

App Start & 1st Connect, D+C The counter automatically resets at the start of each drive or charge cycle and
accumulates either Drive or Charge energy.

User Wh Counter* This "energy use" counter can be reset by the user at any time even while driving or during a
charge. The counter accumulates energy used while driving or charging.

Charge Alarm When enabled, the Charge Alarm will trigger an alarm when the selected SOC% value has been reached
during a charging session. The Android device must be in range of the Leaf's OBDII adapter to allow the SOC value to be
read.

Battery Temperature
This option controls how the battery temperature sensor data is displayed on screen 4.

max/avg/min Displays the maximum, average and minimum battery temperatures with a thermometer graphic displaying
maximum temperature along with the outside ambient temperature in the lower right corner. Ambient temperature is only
valid when the Leaf is on and not while charging.

Sensors Displays the three or four (2011/2012) battery pack temperature sensors.

Logging
This panel controls the Logging feature in LeafSpy. In order to log, a real or virtual SD Card must be available. If one is
present, the SD Status will indicate "mounted". If none is detected, consult your device's operating manual to see how to
enable SD storage. If an SD Card is mounted the Bytes Available field will show the currently available free space. To
prevent LeafSpy from using up all available storage space Logging will stop when free space drops down to 1 MB or less.

Enable Data Logging This option enables Logging.

Append YYMMDD to file name This option should normally be checked and enables adding a date stamp to the log file
name. This also breaks the log file into files by day instead of just one big file. It makes managing your log files much
easier to have them broken up by day. A trip that spans midnight will be saved in the file that started the trip.

Always keep GPS Active Normally this option should be left uncheck as addition power will be used to keep GPS active
even when not connected to a Leaf.

Enable GPS This option is available even when not logging as the elevation and speed data is also used for the elevation
and speed graph on screen2. This option should normally always be selected. Logs containing GPS data can be uploaded
to the leaflogger.com web site which allows you to visualize your trips on Goggle maps. Contact the owner of the
leaflogger web site for an ID to access the web site.

Log Interval This pulldown menu is used to specify the log interval from once every 2 seconds to once per hour. One log
entry is always made at the start of logging so if a one hour interval is selected after one hour there will be two entries in
the log. One entry for time zero and then a second entry an hour later. If BMS mode is active then the minimum log
interval is changed to be less than one second as only data from the BMS ECU is being read.

68
At the faster sample rates log entries may actually occur at a slightly slower rate. This depends on the cycle time it takes
to read one full set of data from the Leaf. If the cycle time to read one full set of data is longer than the selected log
interval then the read cycle rate is the log rate. For example if the actual cycle rate is 3 seconds and the select log interval
is 2 seconds data is logged at the 3 second rate. The cycle time is dependent on the speed of the device and OBDII
adapter.

Log Date Format This pulldown menu controls the format of the date saved in the log file. The default value is set to the
same format as the device but can be changed using this option.

• Default
• Month Day Year
• Day Month Year
• Year Month Day

Log Cell Voltages Use this option to disable reading and saving Cell Voltages to the Log file. When disabled this will
speed up the sample rate. This option is overridden if on screen 1 which displays cell voltages or on screen 2's battery
voltage Histogram screen.

CSV Separator Characters This pulldown menu lets you select between a period or comma for the decimal separator
character and comma or semicolon for the variable separator character in the CSV log file. The default separators are
period "." and comma "," but can be changed to comma "," and semicolon ";".

Dropbox
This panel controls the Dropbox file synchronization feature. It is not necessary to have Dropbox installed on the device
to use this feature as the feature is self contained within LeafSpy.

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

• Apps/LeafSpyPro/ - for the Trip/Charge log

• Apps/LeafSpyPro/Log Files - for Log Files
• Apps/LeafSpyPro/DTC - for DTC Log Files
• Apps/LeafSpyPro/Charge & Elevation Log - for Charge and Elevation logs
• Apps/LeafSpyPro/Trace Files - for ELM traces
• Apps/LeafSpyPro/Debug Logs - for debug files
• Apps/LeafSpy Pro/Custom Screens/Android - uploaded custom screen files

Enable This option enables file synchronization with your Dropbox. When this option is checked the TripChrgLog file
is automatically synchronized. To sync other files select one or more of the following options.

Log Files : Select to sync Log_xxx.csv, Eff_xxx.csv and DTC Log [vin].txt files.

Charge & Elevation Files : Select to sync ES_xx.csv and Qxx.csv files.

Trace & Error Files : Select to sync TRC_xxx.txt and ERRdata.txt files.

When Dropbox is not enabled a Reset ID button will appear to the right. A long press on that button will clear the
registered Dropbox ID allowing a different ID to be used when Dropbox is enabled again.

Sync Interval Use this pulldown menu to select the synchronization interval (every 1, 2, 5, 10 or 15 minutes) but the
actual transfer only occurs if a file has changed size.

69
Server
Enable this option to activate periodic data transfers to a Server while LeafSpy is connect to the Leaf. As a reminder that
this feature has been enabled a "." will be appended to the date displayed bottom center of most screens. If the server
responses with an error ":(" will be appended to the date.

Note: When the Server function is enabled and connected to the Leaf the Server function continues to operate even if
LeafSpy is placed in the background or the device is turned off.

This feature requires a data plan if you are going to use it while driving. Each send contains about 250 bytes of data. For a
20 minute trip at the fastest send rate of every 5 seconds it would result in 75 KB (250 x 12 x 20) of data transferred or
2.25 MB per month if done every day against your data plan.

The send interval can be selected to be once every 5 seconds to one every 10 minutes. Any one of up to four user defined
Servers can be selected with optional user id and password. The URL type is set to "Http://" by default but can be changed
to "Https://" if secure mode is supported by the server. Use the Server pulldown to select the active server (A, B, C or D)
and to enter configuration information (id, password, URL) for each Server. Use the Lock switch to prevent accidentally
changing configuration information. The Hide option can be used to obscure the passwords displayed on the screen.

Send Interval

• 5 seconds
• 10 seconds
• 15 seconds
• 20 seconds
• 30 seconds
• 1 minute
• 2 minutes
• 3 minutes
• 5 minutes
• 10 minutes

Server

• A
• B
• C
• D

Type

• Http://
• Https://

The following data is sent to the Server in REST format (URL?parm1&parm2&parm3...). The server must respond either
"status":"0" (quotes around status and 0), status:0 (no quotes) or a non zero status if an error is detected. Note: The User
ID and Password are sent in plan text (not encrypted). The below table's format is parameter string (ex user=xxx) followed
by any comments. Only the parameter string is sent. (FB),(EL) and (EM) notations refer to parameters defined in the
corresponding columns under the Logging section of this document.

• user=xxx User ID
70
 • pass=xxx Password
• DevBat=xx Phone Battery Level %
• Gids=xxx
• Lat=xxx.xxxxx
• Long=xxx.xxxx
• Elv=xxx Elevation in meters
• Seq=xx Sequence number of transfer
• Trip=xx Trip number
• odo=xxx Odometer in km
• SOC=xx.xx State of Charge
• AHr=xx.xxxx Current AHr capacity
• BatTemp=xx.x Average Battery Temperature
• Amb=xx.x Ambient Temperature
• Wpr=xx Front Wiper Status (FB)
• PlugState=x Plug State (EL)
• ChrgMode=x Charge Mode (EM)
• ChrgPwr=xxxx Charge Power in watts
• VIN=xxxxxxxxxxxxxxxx
• PwrSw=x Power Switch state 0=off 1=on
• Tunits=x Temperature Units (C/F)
• RPM=x Motor RPM
• SOH=xx.xx State of Health
• Hx=xx.xx Hx
• Speed=xx.x Speed m/sec
• BatVolts=xxx.xx Battery Voltage
• BatAmps=x.xx Battery Amps

Use the Lock option to prevent accidentally making changes to the server settings.

Use the Test Mode option to test the server settings without the need to connect to a Leaf. This option is ignored when
actually connected to a Leaf. Test Mode is automatically reset when exiting the application.

In Test Mode packets will be sent to the selected Server after exiting the Settings screen at the rate defined on
the Settings/Server panel. The packets sent will have a variable SOC starting at 100% and stepping down in 5% steps
until 0% when it will be set back to 100% and loop again. The following items in the packet will be fixed to the listed
values. The other packet values will be the last values read.

• DevBat=68 Phone Battery Level %

• Lat=41.902783
• Long=12.496366
• odo=200000 Odometer in km
• SOC=100% to 0% in 5% steps State of Charge
• PlugState=2 Plug State (EL)
• ChrgMode=3 Charge Mode (EM)
• ChrgPwr=5000 Charge Power in watts

If the Server supports secure transfer select Https instead of Http.

If you wish to test out the Server function visit the website www.leaf-status.com and register. The URL to enter
into Settings/Server/URL for this website is www.leaf-status.com/api/vehicle/update/. One use I make of this website
is to have my Wife access it when I am going to pick her up and she can monitor my location to see I am really on my
way and exactly where I am in the Leaf.
71
System
This panel is used to control various Android system functions.

Stay Awake When checked disables the timeout used to blank the display. This should normally be checked or the screen
will go blank while driving when the timeout expires.

Display Bright When checked this option forces the display to be set to high brightness making it easier to read in
sunlight.

Auto Enable & Disable Bluetooth This option is used when you wish to save power by not having Bluetooth enabled
when not running LeafSpy. It allows LeafSpy to automatically enable Bluetooth on startup and turn it off when exiting the
app. If this option is not checked and Bluetooth is not enabled before starting LeafSpy then a popup message will appear
asking if Bluetooth should be enabled.

Bluetooth Port= After pairing the Bluetooth OBDII adapter is given a virtual serial port number by the operating system
(OS). Unfortunately there is no way for LeafSpy to know which of three possible ports the OS has assigned to the OBDII
adapter. The normal default is Port 1 however if you are using the handsfree phone feature with the Leaf the OS may
assign the OBDII adapter to Port 16. There are also times when the OS supports a Secure Bluetooth link.

If when trying to connect to the OBDII adapter LeafSpy gets stuck at state 00 as shown in the lower right status area try a
different port number. If the status area shows a state number higher than 00 that indicates the port is set correctly. If the
state number cycles around 10 to 14 that indicates the Leaf is not turned on. Normally the Leaf must be turned ON (not
ACC mode) for LeafSpy to be able to communicate with it.

On Exit force BT off If you would always like to have Bluetooth turned off when exiting LeafSpy check this option.

The current screen size, scale used and resolution is also displayed on this panel.

Options
This panel is used to control program options.

Skip Reading Headlight Status Select this option to disable the automatic switching of the display into and out of night
mode. If you always keep your headlights on this feature should be selected. When selected there is also a slight shorting
of the cycle time to read all data from the Leaf since one command/response sequence is skipped (giving slightly better
performance).

Disable forcing energy display Use this option to stop the automatic selection of the energy usage display on screen 4
whenever the PTC heater is active.

Disable Sound Disables all sounds from LeafSpy.

Enable slow Leaf transfer mode Use this option if you experience problems staying connected to the Leaf. This option
instructs the Leaf to transfer data with a small delay between each frame of a multi frame transfer. The delay can be from
10 msec to 70 msec and is selected using the slider.

LELink2 Zero Power Mode If you have the newer LELink2 and a model 2011-2017 Leaf, use this option to enable the
Zero Power mode. The mode will be enabled the next time LeafSpy Pro connects to the LELink2. When enabled the
adapter will go into Zero Power mode 2 minutes after the Leaf has been turned off and the doors closed (red power LED
turns off). Opening a door or turning the Leaf on will cause the adapter to power back up.

72
Note that once the adapter enters Zero Power mode LeafSpy will not be able to communicate with the Leaf to monitor a
charge session. If you wish to monitor a charge session LeafSpy will need to be connected to the Leaf before the adapter
goes into Zero Power mode or you will need to wake up the Leaf by opening and closing a door.

Once Zero Power mode has been enabled the adapter cannot be used on a 2018 or newer Leaf. To use on a 2018 or newer
Leaf, first disable this mode while plugged into a 2011-2017 Leaf. Verify disabled by turning Leaf off and waiting two
minutes to insure the red power LED does not turn off.

Note: This option does not make any real time changes to the LELink^2 adapter which means the adapter does not need
to be plugged in to change this option. The option sets an Enable/Disable flag which is used at the start of the next
connection cycle to program the LELink^2's Zero Power mode.

WARNING: Using this mode on a 2018 or newer Leaf will result in the LELink2 adapter never coming out of Zero
Power mode (red power LED never turns on).

Safe Mode LeafSpy starts in a passive mode listening for communications on the CAN bus before LeafSpy starts
communicating with the Leaf. Communicating with the Leaf when the Leaf is off can at times result in a relay clicking
sound when this unexpected communications is received by the Leaf.

This mode is automatically enabled each time LeafSpy is started unless the Model Year in settings indicates a 2018 or
newer Leaf.

The only time this option should be disabled is when taking a Charge trace since during charging the Leaf is off but will
respond to LeafSpy's request for charge data. During this time the clicking relay cannot be avoided.

Note: This mode is not compatible with 2018 and newer Leafs. For 2018 and newer Leafs be sure the Model Year setting
(near the top of Settings panel) is set correctly. A 2018 or newer Model Year setting will automatically override this
mode.

Exit after Trip/Chrg saved Selecting this option will cause LeafSpy to automatically exit after saving a trip or charge
event to the log file.

Braking & Motor Monitor

This panel controls the experimental Braking Monitor screen and Motor Energy Monitor screen. The Braking
Monitor screen displays a horizontal status bar at the top that shows the amount of regeneration (in green) and friction
braking (in red). A lower windows graphs the last few seconds of braking data. The Motor Energy Monitor screen
displays a horizontal status bar at the top showing accelerator position and optional brake data. The lower window graphs
the motor energy used or regenerated and accelerator position.

Enable Brake & Motor Screens Use this option to enable a fifth screen which can be toggled between a Braking
Monitor screen and a Motor Monitor screen by tapping on it. The Service Menu screen takes precedence over these
screens so be sure you have not enabled the Service Menu before you select this option.

Due to the large amount of data being processed while monitoring the Leaf, not all devices and OBDII adapters can
support this level of data flow. If you experience LeafSpy problems, such as screen updates stopping and/or LeafSpy not
responding, then please disable this feature.

Brake & Motor Combined While viewing the Motor Energy Monitor screen you can also view braking data in the top
status bar. This requires a slightly higher data rate due to the addition data being monitored. If you experience problems
then disable this feature.

73
Change Window Size Use this pulldown menu to change the number of seconds of braking history data displayed on the
brake monitor screen. The pulldown menu allows you select from the last 10 seconds to the last 60 seconds of data.

Screen
Use this panel to control various aspects of the screen.

Screen Orientation Use this pulldown menu to select from one of seven screen orientation modes.

Auto (Sensor) The screen automatically adjusts the orientation based on the sensor (default).

Landscape Force Landscape mode with the top of the device on the left.

Portrait Force Landscape mode with the top of the device on top

Landscape - Sensor Force Landscape mode with top of the device on left or right depending on how the device is
held.

Portrait - Sensor Force Portrait mode with the top of the device on the top or bottom depending on how the device is
held.

Reversed Landscape Force Landscape mode with the top of the device on the right.

Reversed Portrait Force Portrait mode with the top of the device at the bottom.

Hide Connect Status Checking this option will hide the state number displayed in the lower right status window which
cycles as commands are sent to the Leaf. When disabled the time to read one complete cycle of data from the Leaf is
displayed. The shorter this time the more frequently the values are update. This value can also be used to compare the
performance of different OBDII adapters.

Adjusting Colors Changing colors is a two step operation. The first step is to select one of 12 items to change.

Background Change the background color for screens 3 and 4. The default is white.

Text Change the text color for screens 3 and 4. The default is black.

Chart Background On screens 1 and 2 change the color of the background. The default is white.

Chart Bars On screen 1 and 2 change the color of the bars. The default is Blue.

Chart Axis Change the axis color for all graphs. The default is Black.

Chart Shunts On screen 1 change the color used when a shunt is active. The default is Red.

The following 6 items adjust the colors of the bars used to display the battery temperatures on the screen 2 Bar graph
available on LeafSpy Lite and LeafSpy and the battery temperature value when displayed on screen 3.

<=65 On screens 2 and 3 change the color used to display the battery pack temperature when it is <=65 degrees.

<=75 On screens 2 and 3 change the color used to display the battery pack temperature when it is <=75 degrees.

74
 <=86 On screens 2 and 3 change the color used to display the battery pack temperature when it is <=86 degrees.

<=95 On screens 2 and 3 change the color used to display the battery pack temperature when it is <=95 degrees.

<=105 On screens 2 and 3 change the color used to display the battery pack temperature when it is <=105 degrees.

>105 On screens 2 and 3 change the color used to display the battery pack temperature when it is >105 degrees.

After the area to change has been selected next select one of the three color selectors and then select a color.

Pick This color picker gives you 15 predefined colors to choose from.

RGB The RGB color picker lets you select a color based on its RGB value.

HSV The HSV color picker lets you select a color based on Hue, Saturation and Value.

There are three Reset buttons, one below each sample panel. Tapping the Reset button will undo any change made while
still on the settings screen. A long tap on the Reset button will restore the default color values.

Obscure VIN Use this option to obscure the VIN on screen 1 by replacing the lower five characters of the VIN with five
characters from the device ID.

Default Night Mode Use this option to force Night Mode when LeafSpy first starts up. If you drive mostly at night this
option will prevent the screen from switching to bright mode before the headlight status is read.

Statistics
This panel displays statistics on the quality of data received from the OBDII Adapter. These statistics are reset each time a
new connection is made.

Good Frames Counts the number of good frames received.

Bad Frames Counts the number of bad frames received. A bad frame is defined as one where the data length does not
match the received data bytes.

Successful Is the percent success rate (Good frames/(Good+Bad frames)).

Retries Counts the number of times a command had to be re-sent due to a timeout in receiving a response from the Leaf.

Lost Counts the number of Lost frames when receiving a multi frame response. This value can also be monitored on
screen 1 in the monitor area.

75
Debug
The debug panel gives access to some special features.

Enable Checking this option replaces screen 3 with a raw frame display. The frame data displayed is from one of four
possible message types:

SOC/AHr Display raw frames from group 1 of the BMS ECU

Cell Pairs Display raw frames from group 2 of the BMS ECU

Temps Display raw frames from group 4 of the BMS ECU

Shunts Display raw frames from group 6 of the BMS ECU

Testmode Generates test data while not connected to the Leaf.

Trace ELM (on LeafSpy restart) This option is used to capture a trace of the ELM interface to help isolate a problem.

If directed to take an ELM trace, check this option then exit and restart LeafSpy. Upon restart the words "Logging
ELM" will flash at the bottom center of the screen. While the trace is active try to recreate the problem letting LeafSpy
run for a minute then exit LeafSpy. A text file will be created in storage in
folder /Android/data/com.Turbo3.Leaf_Spy_Pro/files/DEBUG_FILES with a name
of TRC_yymmddhhmm.txt where yymmddhhmm is year month day hour minute. Send this file along with
the ERRData.txt file located in the same directory to [email protected] for analysis.

76