This custom integration aims to provide plug-and-play integration for your Toyota vehicle.
[!] Beta version alert. Please note this integration is in the early stage of its development. See Contribution section for more information on how to contribute.
This is a custom component the retrieves' data from the Toyota MyT API and makes them available in Home Assistant as sensors. As there is no official API from Toyota, I will try my best to keep it working but there are no promises.
Only Europe is supported right now. If you want to help add other regions, please open an issue over at mytoyota
.
This component will set up the following platforms:
Platform | Sample sensor | Description |
---|---|---|
sensor |
sensor.aygo |
Static data about your car |
sensor |
sensor.aygo_odometer |
Odometer information |
sensor |
sensor.aygo_fuel_tank |
Fuel tank information |
sensor |
sensor.aygo_starter_battery |
Starter battery health |
device_tracker |
device_tracker.aygo |
Shows you last parked information |
Sensors displaying statistical information are coming soon...
Use Home Assistant build 2021.3 or above.
If you can confirm that it is working as advertised on older version please open a PR.
Note: It is only tested against latest, but should work on older versions too.
Note: Future updates may change which version are required.
- Open the directory with your Home Assistant configuration (where you find
configuration.yaml
, usually~/.homeassistant/
). - If you do not have a
custom_components
directory there, you need to create it.
This is a preferred method of manual installation, because it allows you to keep the git
functionality,
allowing you to manually install updates just by running git pull origin master
from the created directory.
Now you can clone the repository somewhere else and symlink it to Home Assistant like so:
- Clone the repo.
git clone https://github.com/DurgNomis-drol/ha_toyota.git
- Create the symlink to
toyota
in the configuration directory. If you have non standard directory for configuration, use it instead.
ln -s ha_toyota/custom_components/toyota ~/.homeassistant/custom_components/toyota
- Download ZIP with the code.
- Unpack it.
- Copy the
custom_components/toyota/
from the unpacked archive tocustom_components
in your Home Assistant configuration directory.
- Browse to your Home Assistant instance.
- In the sidebar click on Configuration.
- From the configuration menu select: Integrations.
- In the bottom right, click on the Add Integration button.
- From the list, search and select “Toyota Connected Services”.
- Follow the instruction on screen to complete the set up.
- After completing, the Toyota Connected Services integration will be immediately available for use.
Contributions are more the welcome. This project uses poetry
and pre-commit
to make sure that
we use a unified coding style throughout the code. Poetry can be installed by running poetry install
.
Please run poetry run pre-commit run --all-files
and make sure that all tests passes before
opening a PR or committing to the PR. All PR's must pass all checks for them to get approved.
By contributing, you agree that your contributions will be licensed under its MIT License.
Under the hood this integration uses the mytoyota python package.