/homeassistant-carwings

Custom HomeAssistant Integration to access Nissan Connect EV Services

Primary LanguagePythonMIT LicenseMIT

Nissan Carwings Integration for Home Assistant

GitHub Release GitHub Activity License

Project Maintenance BuyMeCoffee

Community Forum

Overview

This unofficial integration allows Home Assistant to interact with Nissan Connect vehicles via the legacy Nissan Connect EV (Carwings) API. It serves as an alternative to the discontinued core nissan_leaf integration and draws inspiration from both the core integration and the NissanConnect integration for newer Nissan models.

Key Features

  • UI Setup & Configuration: Easily configure and manage settings directly from the Home Assistant UI.
  • Asynchronous Networking: Ensures non-blocking calls for a smoother experience.
  • Quick Home Assistant Restarts: Designed for minimal impact on Home Assistant's restart times.

Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called nissan_carwings.
  4. Download all the files from the custom_components/nissan_carwings/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Nissan Carwings"

Configuration

Configuration is exclusively done through the Home Assistant UI using your NissanConnectEV credentials. The initial setup will verify your credentials and fetch current data, which may take a moment.

Adjustable Settings

  • Update Interval: Frequency of data updates from the API, designed to not wake the car and drain the 12V battery.
  • Polling Interval: Frequency of status requests to the car, which uses cellular communication and consumes a small amount of battery power from the 12V battery. Recommended setting is every 1-2 hours.
  • Polling Interval While Charging: Similar to the Polling Interval but for when the car is charging. The default 15-minute interval is generally suitable.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines