mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 01:06:52 +00:00
Added mychevy docs (#4410)
* Added mychevy docs * ✏️ Update ha_release * ✏️ Removed configuration variables header
This commit is contained in:
parent
7b20739182
commit
f8ab881dd4
73
source/_components/mychevy.markdown
Normal file
73
source/_components/mychevy.markdown
Normal file
@ -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.
|
BIN
source/images/supported_brands/chevy.png
Normal file
BIN
source/images/supported_brands/chevy.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 27 KiB |
Loading…
x
Reference in New Issue
Block a user