From e9344e150f9591e4732792be3ee216cff6826eb2 Mon Sep 17 00:00:00 2001 From: Phil Cole Date: Fri, 15 Feb 2019 12:41:15 +0000 Subject: [PATCH] Initial documentation for nissan_leaf (#8073) * Initial documentation for nissan_leaf * Use correct brand names. * Include defaults, extend notes and add nissan_leaf.update service. * Nissan leaf, hope for release in 0.88 * Use markers in example config. Remove redirects. * Add redirects * Add missing redirect * Remove some things to get the build pass --- source/_components/nissan_leaf.markdown | 126 ++++++++++++++++++++++ source/images/supported_brands/nissan.png | Bin 0 -> 41319 bytes 2 files changed, 126 insertions(+) create mode 100644 source/_components/nissan_leaf.markdown create mode 100644 source/images/supported_brands/nissan.png diff --git a/source/_components/nissan_leaf.markdown b/source/_components/nissan_leaf.markdown new file mode 100644 index 00000000000..19357efa985 --- /dev/null +++ b/source/_components/nissan_leaf.markdown @@ -0,0 +1,126 @@ +--- +layout: page +title: "Nissan Leaf" +description: "Instructions for how to integrate Nissan Leaf(s) into Home Assistant." +date: 2019-01-05 07:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: nissan.png +ha_category: Car +ha_release: 0.88 +ha_iot_class: "Cloud Polling" +--- + +The `nissan_leaf` component offers integration with the [NissanConnect EV](http://youplus.nissan.co.uk/GB/en/YouPlus/ConnectedServices.html) cloud service. NissanConnect EV was previously known as Nissan Carwings. It offers: + +* sensors for the battery status and range +* a switch to start and stop the climate control +* a switch to start the car charging (cannot be stopped remotely - API limitation) +* a device tracker to locate the car (only on later Leaf models) + +## {% linkable_title Configuration %} + +To use Nissan Leaf in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +nissan_leaf: + username: "YOUR_USERNAME" + password: "YOUR_PASSWORD" + region: "YOUR_REGION" +``` +{% configuration %} +username: + description: The username associated with your NissanConnect EV account. Enclose in quotes. + required: true + type: string +password: + description: The password for your given NissanConnect EV account. Enclose in quotes. + required: true + type: string +region: + description: The region where the NissanConnect EV account is registered. Should be one of the following, NE (for Europe), NNA (USA), NCI (Canada), NMA (Australia), NML (Japan). + required: true + type: string +nissan_connect: + description: If your car has the updated head unit (NissanConnect rather than Carwings) then the location can be aquired and exposed via a device tracker. If you have a pre-2014 24 kWh Leaf then you will have Carwings and this should be set to false. + required: false + type: boolean +update_interval: + description: The interval between updates if the climate control is off and the car is not charging. Set in any time unit (e.g. minutes, hours, days!). + required: false + default: 1 hour + type: time +update_interval_charging: + description: The interval in minutes between updates if charging. + required: false + default: 15 + type: time +update_interval_climate: + description: The interval in minutes between updates if climate control on. + required: false + default: 5 + type: time +{% endconfiguration %} + +## {% linkable_title Full configuration sample %} + +A more advanced example for setting the update interval: + +```yaml +# Example configuration.yaml entry +nissan_leaf: + username: "YOUR_USERNAME" + password: "YOUR_PASSWORD" + region: "YOUR_REGION" + nissan_connect: true + update_interval: + hours: 1 + update_interval_charging: + minutes: 15 + update_interval_climate: + minutes: 5 + force_miles: true +``` + +## {% linkable_title Updating on-demand using Automation %} + +You can also use the `nissan_leaf.update` service to request an on-demand update. To update almost exclusively via the service set the `update_interval` to a high value in the component configuration. The service requires you to provide the vehicle identification number (VIN) as a parameter. You can see the VIN on the attributes of all the entities created by this component, except the device_tracker. + +```yaml +- id: update_when_driver_not_home + alias: 'Update when driver not home' + initial_state: on + trigger: + - platform: time_pattern + minutes: '/30' + condition: + - condition: state + entity_id: device_tracker.drivername # replace + state: 'not_home' + action: + - service: nissan_leaf.update + data: + vin: '1HGBH41JXMN109186' # replace +``` + +## {% linkable_title Hints %} + +* The update interval has a minimum of two minutes. +* Requesting updates uses a small amount of power from the 12 V battery. The 12 V battery charges from the main traction battery when the car is not plugged in. If the car is left plugged in for a long time, or if the main traction battery is very low then the 12 V battery may gradually discharge. A low update interval may cause the 12 V battery to become flat. When the 12 V battery is flat the car will not start. _Do not set the update interval too low. Use at your own risk._ +* This component communicates with the Nissan Servers which then communicate with the car. The communication between the car and the Nissan Servers is very slow, and takes up to five minutes to get information from the car, therefore the default polling interval is set to one hour to not overwhelm the connection. +* Responses from the Nissan servers are received separately for the battery/range, climate control and location. The `updated_on` attribute will show the last time the data was retrieved from the server. There are separate attributes for when the `next_update` is scheduled, and if an `update_inprogress`. The `nissan_leaf.update` service will reset the `next_update` attribute. + +Please report bugs using the following logger configuration. + +```yaml +logger: + default: critical + logs: + homeassistant.components.nissan_leaf: debug + homeassistant.components.device_tracker.nissan_leaf: debug + homeassistant.components.sensor.nissan_leaf: debug + homeassistant.components.switch.nissan_leaf: debug +``` diff --git a/source/images/supported_brands/nissan.png b/source/images/supported_brands/nissan.png new file mode 100644 index 0000000000000000000000000000000000000000..23b947e8dcb8a78e428b66760d5b5a6de53d11bc GIT binary patch literal 41319 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 literal 0 HcmV?d00001