From f8ab881dd4f0c1b7d2aac7799808d41d46148d39 Mon Sep 17 00:00:00 2001 From: Sean Dague Date: Wed, 17 Jan 2018 02:05:37 -0500 Subject: [PATCH] Added mychevy docs (#4410) * Added mychevy docs * :pencil2: Update ha_release * :pencil2: Removed configuration variables header --- source/_components/mychevy.markdown | 73 +++++++++++++++++++++++ source/images/supported_brands/chevy.png | Bin 0 -> 27477 bytes 2 files changed, 73 insertions(+) create mode 100644 source/_components/mychevy.markdown create mode 100644 source/images/supported_brands/chevy.png diff --git a/source/_components/mychevy.markdown b/source/_components/mychevy.markdown new file mode 100644 index 00000000000..64584db11d9 --- /dev/null +++ b/source/_components/mychevy.markdown @@ -0,0 +1,73 @@ +--- +layout: page +title: "MyChevy" +description: "Instructions on how to integrate Chevy Bolt car into Home Assistant." +date: 2017-08-28 17:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: chevy.png +ha_category: Hub +ha_release: 0.62 +ha_iot_class: "Cloud Polling" +--- + +The `MyChevy` component communicates with the +[my.chevrolet](https://my.chevrolet.com) website using selenium to log +in as your user, and screen scrape the data provided. GM does not +make it easy to sign up for any official development program, so this +provides a workaround to get access to your data. + +This component provides the following platforms: + - Binary sensors - if the car is plugged in + - Sensors - such as Battery Level, Charge Mode, EST Range, Total + Distance Traveled + +To use MyChevy in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +mychevy: + username: email + password: password +``` + +{% configuration %} +username: + description: The email address associated with your my.chevrolet account + required: true + type: string +password: + description: The password for your given my.chevrolet account + required: true + type: string +{% endconfiguration %} + + +#### {% linkable_title Installation %} + +Because this uses selenium behind the scenes, installation is more +complicated than merely pip install. See the installation instructions +at https://github.com/sdague/mychevy. + +#### {% linkable_title Limitations %} + +The architecture of the GM automotive networking imposes some +limitations on the functionality of the component. + +The OnStar network link is very slow, and takes 1 - 3 minutes to get +information back from the car. As such the mychevy component only +polls every 30 minutes to not overwhelms that connection. + +The OnStar network (or more specifically the gateway used by the +my.chevrolet website) appears to suffer more than most networks when +the car is a) in a garage, and b) it's cold outside (like < 15 degrees +F). One of the provided sensors is a status sensor which indicates if +we got connectivity with the car on the last polling cycle or not. + +The "API" for this is written by web scraping. As such, it only +currently is known to work if you have a Chevy Bolt EV, and only 1 +Chevy car connected to OnStar. Patches for extended support should go +to the https://github.com/sdague/mychevy project first, then +Home Assistant can be extended. diff --git a/source/images/supported_brands/chevy.png b/source/images/supported_brands/chevy.png new file mode 100644 index 0000000000000000000000000000000000000000..184da879bc910f76d2d67360997679f335dcee39 GIT binary patch literal 27477 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