https://github.com/dan-r/homeassistant-nissanconnect

Unofficial Home Assistant integration for interacting with Nissan Connect vehicles 🚗
https://github.com/dan-r/homeassistant-nissanconnect

hacs-integration home-assistant nissan nissan-leaf nissanconnect

Last synced: about 2 months ago
JSON representation

Unofficial Home Assistant integration for interacting with Nissan Connect vehicles 🚗

• Host: GitHub
• URL: https://github.com/dan-r/homeassistant-nissanconnect
• Owner: dan-r
• License: apache-2.0
• Created: 2024-01-20T09:47:54.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-10-24T09:23:50.000Z (about 2 months ago)
• Last Synced: 2024-10-25T05:36:21.751Z (about 2 months ago)
• Topics: hacs-integration, home-assistant, nissan, nissan-leaf, nissanconnect
• Language: Python
• Homepage:
• Size: 132 KB
• Stars: 36
• Watchers: 11
• Forks: 10
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# NissanConnect for Home Assistant

An unofficial integration for interacting with NissanConnect vehicles in Europe. Based on the work of [mitchellrj](https://github.com/mitchellrj) and [tobiaswk](https://github.com/Tobiaswk/dartnissanconnect). I have no affiliation with Nissan besides owning one of their cars.

_Please note this integration is only for vehicles using the NissanConnect app, not NissanConnect EV or any other app._

If you find any bugs or would like to request a feature, please open an issue.

## Tested Vehicles

This integration has been tested with the following vehicles:

* Nissan Leaf (2022) - UK [@dan-r]

* Nissan Qashqai (2021) - EU 

* Nissan Ariya - EU

* Nissan X-Trail (2024)

### North America

The API used in North America is completely separate to Europe and it appears that Nissan USA are [a lot more hostile](https://tobis.dk/blog/the-farce-of-nissanconnect-north-america/) towards third-party access. Any future US support would rely on library support (such as [dartnissanconnectna](https://gitlab.com/tobiaswkjeldsen/dartnissanconnectna)) or someone in North America maintaining that side of things. If you're interested, get in touch!

## Installation

### HACS

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=dan-r&repository=HomeAssistant-NissanConnect&category=integration)

This is the recommended installation method.

1. Search for and install the **NissanConnect [EU]** integration from HACS

2. Restart Home Assistant

### Manual

1. Download the [latest release](https://github.com/dan-r/HomeAssistant-NissanConnect/releases)

2. Copy the contents of `custom_components` into the `/custom_components` directory of your Home Assistant installation

3. Restart Home Assistant

## Setup

From the Home Assistant Integrations page, search for and add the Nissan Connect integration.

## Update Time

Terminology used for this integration:

* Polling - the car is woken up and new status is reported

* Update - data is fetched from Nissan but the car is not woken up

Following the model of leaf2mqtt, this integration can be set to use a different update time when plugged in. When HVAC is turned on the update time drops to once per minute.

To prevent excessive 12v battery drain when plugged in but not charging for extended periods of time, the interval reverts to the standard update interval after 4 consecutive updates show the car as plugged in but not charging.

This logic was added to give the benefit of quicker response times on the charging status binary sensor, which can be especially useful when charging with load-balanced or 'smart' chargers.

## Translations

Translations are provided for the following languages. If you are a native speaker and spot any mistakes, please let me know.

* English

* Danish

* Dutch

* French

* German

* Italian

* Norwegian

* Polish

* Portuguese

* Russian

* Spanish

## Entities

This integration exposes the following entities. Please note that entities will only be shown if the functionality is supported by your car.

* Binary Sensors

    * Car Plugged In (EV Only)

    * Car Charging (EV Only)

    * Doors Locked

* Sensors

    * Battery Level

    * Charge Time

    * Internal Temperature

    * External Temperature

    * Range (EV Only)

    * Odometer

    * Daily Distance

    * Daily Trips

    * Daily Efficiency (EV Only)

    * Monthly Distance

    * Monthly Trips

    * Monthly Efficiency (EV Only)

* Climate

* Device Tracker

* Buttons

    * Update Data

    * Flash Lights

    * Honk Horn

    * Start Charge