This Home Assistant component enables you to get information from your Nissan Leaf car into Home Assistant by integrating with the LeafSpy Android or iOS apps.
Plug a Bluetooth OBD2 adapter (like this one) into your Nissan Leaf. Open up LeafSpy and pair your phone with the adapter. It will then read information from your car. This integration will allow your phone to submit that info to Home Assistant.
- Install HACS.
- Add this to HACS as a custom repository by pressing this button and pressing "Download" in the bottom right.
- Restart Home Assistant
- Add the Leaf Spy integration by pressing this button.
- Configure your Leaf Spy app settings using the information that the integration displays on screen. If you don't have the app in front of you, copy down the on-screen information; the generated password will only be shown this once. If you don't copy it down, you'll have to uninstall the integration, restart, and reinstall.
See LeafSpy manual for more details on the data that the app sends.
| Entity ID | Note |
|---|---|
| device_tracker.leaf | Tracks latitude, longitude, GPS accuracy, and battery level |
| Entity ID |
|---|
| binary_sensor.leaf_power |
| Entity ID | Unit reported by LeafSpy | Note |
|---|---|---|
| sensor.leaf_ambient_temperature | °C (You must set this in the LeafSpy app) | Unit adjustable in HA UI |
| sensor.leaf_battery_capacity | Ah | |
| sensor.leaf_battery_conductance | % | Referred to as Hx in the LeafSpy manual |
| sensor.leaf_battery_current | A | |
| sensor.leaf_battery_gids | Gids | |
| sensor.leaf_battery_health | % | |
| sensor.leaf_battery_state_of_charge | % | |
| sensor.leaf_battery_temperature | °C (You must set this in the LeafSpy app) | Unit adjustable in HA UI |
| sensor.leaf_battery_voltage | V | |
| sensor.leaf_charge_mode | --- | |
| sensor.leaf_charge_power | W | Not very accurate. For example, when charging via level 2 charging, it just guesses 6,000 W. |
| sensor.leaf_elevation | m | Unit adjustable in HA UI |
| sensor.leaf_front_wiper | --- | Not known if Leaf Spy reports this. File an issue if you see info here. |
| sensor.leaf_motor_speed | RPM | |
| sensor.leaf_odometer | km | You must indicate in LeafSpy whether your car reports in km or mi. Unit adjustable in HA UI |
| sensor.leaf_phone_battery | % | |
| sensor.leaf_plug | --- | Reports "Not plugged", "Partial Plugged", or "Plugged" |
| sensor.leaf_sequence_number | --- | A number that increments with each report from Leaf Spy |
| sensor.leaf_speed | km/h | Unit adjustable in HA UI |
| sensor.leaf_trip_number | --- | Tracks total number of trips taken |
| sensor.leaf_vin | --- | Car unique identifier |