Skip to main content

Nissan Connect smart home integration, free and open source

Nissan Connect integration for Gladys Assistant

Battery, range, charge and climate of your Nissan electric car (Leaf, Ariya…).

This integration brings your Nissan electric car into Gladys through the NissanConnect Services cloud — the same service as the Nissan mobile app. You see the battery, the range, the charge and the climate, you can start the climate or the charge, and you can use all of it in scenes and on the dashboard.

Before you start​

  • Gladys 5.3 or later.
  • A NissanConnect Services account (Europe), with your car activated in the mobile app. If the app shows your car and its battery, this integration can too.
  • The integration works through the Nissan cloud only: it never talks to the car on your local network, and it needs internet access.

Nissan offers no public API. The integration speaks the same language as the official app, which Nissan may change without notice. Not every model answers every request: a LEAF, for example, gives no door lock status.

Configuration​

Open Integrations → Nissan Connect → Configuration.

FieldWhat to put in
NissanConnect login (e-mail)The e-mail you sign in to the NissanConnect Services app with.
NissanConnect passwordIts password. Gladys keeps it as a secret; it is never written in the logs.
Refresh interval (s)How often Gladys reads what the car last sent to the Nissan cloud. Default 900 (15 min), minimum 300. This does not wake the car up.
Car wake-up interval (min)How often the car itself is asked to send fresh data. Default 0 = only when you ask. Each wake-up uses the car's 12 V battery: if you turn it on, choose a large value (for example 240).
Distance unitKilometres or miles, for the range and the odometer.
Climate temperature (°C)Cabin temperature used when the climate is started without one (16 to 30 °C).

Then click Test the connection: the answer lists the cars found in your account.

Add your car​

Open Integrations → Nissan Connect → Discovery and create the car. One Gladys device per car of the account, named after the nickname set in the app.

If you change the distance unit later, open Discovery again and update the car, so its range and odometer show the new unit.

What the car device shows​

FeatureDescriptionControl
BatteryState of charge, in %.—
RangeEstimated range, in km or miles.—
Plugged inWhether the charging cable is connected.—
ChargingWhether the car is charging.Start / stop
ClimateWhether the climate (pre-heating / pre-cooling) is running.Start / stop
Climate temperatureTemperature asked for the next climate start.16 to 30 °C
Cabin temperatureTemperature inside the car, when the car reports it.—
OdometerTotal distance, in km or miles.—
LockedWhether the doors are locked, when the car reports it.—

Remote commands are carried out by the car a little later: Gladys shows the requested state at once, then reads the car again about 90 seconds later to confirm it.

The transport badge of the device says how fresh the data is:

  • Cloud: the last read worked.
  • Unreachable: the Nissan cloud did not answer at the last read.
  • Cloud with an orange dot: the cloud answers, but the car has sent nothing for more than 24 hours (asleep, parked underground, out of coverage). Use Wake up a car.

Read or wake up?​

  • A read asks the Nissan cloud what the car last reported. It is cheap and happens at every refresh interval.
  • A wake-up asks the car itself to send fresh data. It goes through the mobile network and uses the 12 V battery. The new data reaches Gladys a few minutes later.

Wake the car up from the Wake up a car button, the Refresh button of the widget, the Read the status of a Nissan scene action (with "Wake the car up first"), or automatically with the Car wake-up interval.

Configuration screen buttons​

  • Test the connection: logs in and lists the cars of the account.
  • Wake up a car: asks the chosen car to send fresh data (battery and position).
  • Identify a car (flash the lights): the car flashes its lights, handy in a car park.

Scenes​

Triggers​

  • A Nissan car starts or stops charging — filters: the car, the event (charge started, charge stopped).
  • A Nissan car is plugged in or unplugged — filters: the car, the event (plugged in, unplugged).

Both give the scene these variables: the car name, the event, the battery level (%) and the range. They are seen at the next read of the car, so with a delay of up to the refresh interval, not at the exact second. They never fire on the first read after Gladys starts.

For a threshold ("battery below 20 %"), use the standard Gladys device state trigger on the Battery feature.

Actions​

  • Start or stop the climate of a Nissan — the car, start or stop, and an optional temperature. Output: order accepted.
  • Start or stop the charge of a Nissan — the car must be plugged in. Output: order accepted.
  • Read the status of a Nissan — reads the car now, optionally waking it first. Outputs: battery (%), range, plugged in, charging — use them in the next actions ("if battery < 30, send me a message").
  • Flash the lights of a Nissan — lights only, or lights and horn. Output: order accepted.

A refusal from Nissan does not stop the scene: the order accepted output is then false, and you can test it in a condition.

Examples:

  • Every weekday at 7:40, start the climate at 21 °C.
  • When the car is unplugged and its battery is below 50 %, send a message.
  • When the car stops charging, read the status and announce the range.

Dashboard widget​

Add the Nissan car widget to a dashboard. Settings:

  • Car: the car to show (the first one of the account when left empty).
  • Show the map button: adds a button that opens the car's last position on OpenStreetMap. Off by default: leave it off on a dashboard other people can see.

The widget shows the live battery and range, whether the car is plugged in and charging (with the time left), the climate, the doors and the time of the last car data. Its buttons: Refresh (wakes the car up), Start / Stop climate, Start / Stop charge (only when plugged in), and the map. The climate and charge buttons ask for a confirmation.

Troubleshooting​

SymptomWhat to do
"Nissan refused the login or password"Check them by signing in to the NissanConnect Services app, then type them again in Gladys.
"Connected, but this NissanConnect account has no car"Activate the car in the mobile app first, then Test the connection again.
The values never changeThe car has not reported anything new: use Wake up a car, then wait a few minutes.
A feature stays empty (cabin temperature, locked)Your model does not report it to the Nissan cloud.
A command is refusedThe car may be asleep, out of coverage, or not support it (charge control on some models).
"NissanConnect Services unreachable"The Nissan cloud is down or has changed: try again later, and check for an integration update.

The integration logs (Integrations → Nissan Connect → Logs) never contain your password or tokens; error lines name the request and the car VIN.

Privacy​

  • Your login and password are only sent to the Nissan identity server, over HTTPS.
  • The access tokens stay in memory, never on disk.
  • The car's position is only used for the optional map button of the widget.
  • The integration never locks or unlocks the doors and never asks for the car PIN.

Configuration settings​

These are the settings Nissan Connect asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Getting startedsectionNoThis integration uses the NissanConnect Services cloud (Europe), the same as the mobile app: fill in the login and password of that app. Your car must be activated in the app first. Nissan offers no public API: the integration speaks the app's own language, which Nissan may change without notice.
NissanConnect login (e-mail)stringYesThe e-mail address you sign in to the NissanConnect Services app with.
NissanConnect passwordsecretYesKept by Gladys as a secret, never written in the logs.
Refresh interval (s)numberNoHow often Gladys reads, in seconds, what your car last sent to the Nissan cloud. It does not wake the car up.
Car wake-up interval (min)numberNoEvery how many minutes the car itself is asked to send fresh data. Each wake-up uses the car's 12 V battery: keep 0 (only when you ask) or a large value such as 240.
Distance unitselectNoUnit of the range and the odometer. Changing it later needs the car to be updated from the Discovery screen.
Climate temperature (°C)numberNoCabin temperature asked for when the climate is started without one (16 to 30 °C).

How to install Nissan Connect in Gladys​

  1. In Gladys, open Integrations: Nissan Connect appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/prohand/gladys-nissanconnect:0.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/prohand/gladys-nissanconnect.

Nissan Connect requires Gladys >=5.3.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Nissan Connect is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by prohand, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂