Nissan Leaf

Vehicle Type: NL

This vehicle type supports the Nissan Leaf and Nissan e-NV200.

Support Overview

Hardware

Item Support Status
Module Any OVMS v3 (or later) module. Vehicle support: 2011-2017 (24kWh & 30kWh & custom battery)
Vehicle Cable 1779000 Nissan Leaf OBD-II to DB9 Data Cable for OVMS
GSM Antenna 1000500 Open Vehicles OVMS GSM Antenna (or any compatible antenna)
GPS Antenna 1020200 Universal GPS Antenna (SMA Connector) (or any compatible antenna)

Controls

Function Support Status
Charge Control Start charge only (Stop charge in beta firmware stage)
Cabin Pre-heat/cool Control Yes [1] (see info below)
Lock/Unlock Vehicle Not currently supported
Valet Mode Control Not currently supported

Metrics

Item Support Status
SOC Yes (by default based on GIDS)
Range Yes (by default based on GIDS)
GPS Location Yes (from modem module GPS)
Speed Yes (from vehicle speed PID)
Cabin Temperature Yes (from vehicle temperature PIDs)
Ambient Temperature Yes (from vehicle temperature PIDs)
SetPoint Temperature Yes (from vehicle hvac PIDs) [2]
HVAC Fan Speed Yes (from vehicle hvac PIDs) [2]
HVAC Heating/Cooling Status Yes (from vehicle hvac PIDs) [2]
HVAC On Status Yes (from vehicle hvac PIDs) [2]
HVAC Temperature Setpoint Yes (from vehicle hvac PIDs) [2]
HVAC Ventilation Mode Yes (from vehicle hvac PIDs) [2]
BMS v+t Yes
TPMS Yes (If hardware available)
Charge Status Yes
Charge Interruption Alerts Yes
[1]OVMS currently supports 2011-2017 Nissan LEAF and Nissan e-NV200
[2](1, 2, 3, 4, 5, 6) Some HVAC Status Items have been only verified with 2013-2016 MY cars and will only work if the year is set in configuraiton. Also HVAC needs to be in ON position before powering down the vehicle for the metrics to work during pre-heat.

Remote Climate Control

2011-2013 models (ZE0)

Gen1 Cars (ZE0, 2011-2013) require a hardware modification to enable OVMS to control remote climate. Wire RC3 to TCU pin 11, more info

2014-2016 models (AZE0)

To use OVMS to activate remote climate the Nissan TCU (Telematics Control Unit) module must be unplugged if fitted (only on Acenta and Tekna models). The TCU is located behind the glovebox on LHD cars or on the right hand side of the drivers foot well on RHD cars. The large white plug on the rear of the TCU should be unplugged, push down tab in the middle and pull to unplug, see video for RHD cars and this page for LHD cars.

Note: Unplugging the TCU will disable Nissan EV connect / CARWINGS features e.g Nissan mobile app. All other car functions will not be effected e.g GPS, maps, radio, Bluetooth, microphone all work just the same as before. OVMS can be used to more than substitute the loss of Nissan Connect features. The TCU can be plugged back in at any point in the future if required.

OVMS remote climate support will ‘just work’ on LEAF Visia models and Visia/Acenta e-NV200 since these models do not have a TCU fitted.

Note: If you prefer not to unplug the Nissan TCU, all OVMS functions appart from remote climate will function just fine alongside the Nissan TCU.

2016-2017 models (AZE0)

Remote climate control will only work when plugged in and actively charging on 2016-2017 models. This is because in 2016 Nissan moved the TCU from the EV CAN bus to the CAR CAN bus.

Set the model year as follows and if necessary configure 30 kWh model:

config set xnl modelyear 2016

or

config set xnl modelyear 2017

Note: in latest OVMS fimware version model year and battery size can be set via the web config interface.

2018+ models (ZE1)

2018+ 40/62kWh LEAF is not yet supported. Please get in touch if your interested in helping to add support. Relevant 2018 CANbus messages have already been decoded and documented, see MyNissanLEAF thread.

Specific battery configs

For models with a 30 kWhr battery pack, set the capacity manually with:

config set xnl maxGids 356 config set xnl newCarAh 79

For models with a 40 kWhr battery pack, set the capacity manually with:

config set xnl maxGids 502 config set xnl newCarAh 115

For models with a 62 kWhr battery pack, set the capacity manually with:

config set xnl maxGids 775 config set xnl newCarAh 176

Note: In latest OVMS firmware version, model year and battery size can be set via the web config interface. This is easier and also the preferred method.

Note 2: OVMS fully supports battery upgraded LEAFs, just set the capacity according to what battery is currently installed.

Range Calculation

The OVMS uses two configuration options to calculate remaining range, whPerGid (default 80Wh/gid) and kmPerKWh (default 7.1km/kWh). The range calculation is based on the remaining gids reported by the LBC and at the moment does not hold 5% in reserve like LeafSpy. Feedback on this calculation is welcomed.

Resources

Assistance is appreciated as I haven’t had time to try to override the TCU using the OVMS or find an alternative solution to prevent the TCU overriding the messages while still allowing the hands free microphone to work.