Domoticz-Toyota-Plugin 0.9.3

A Domoticz plugin that provides devices for a Toyota car with connected services.

Be aware that since version 0.9.3 also an update of mytoyota to version 0.9.3 is required, so ensure that also the mytoyota Python module is updated!

This plugin is using the same API that is used by the Toyota MyT connected services app. This API is however only useable for cars that are purchased in Europe. For more information on Toyota MyT see the Austrian, Belgian, British, Danish, Dutch, European, French, German, Italian, Spanish or Swiss website.

The Toyota car should first be made available in the MyT connected services app, after which this plugin can retrieve the information, which is then provided as several devices in Domoticz.

Provided devices

Device	Image	Description
Mileage		Shows the daily and total mileage
Fuel level		Shows the actual fuel level percentage
Distance to home		Shows the distance between the car and home
Locked		Shows if the car is locked or unlocked
Parking location		Shows the address of the parking location of the car
Consumed fuel		Shows the consumed fuel in l/100 km
Accelerations		Shows the number of hard accelerations
Brakes		Shows the number of hard brakes
Duration		Shows the total driving duration in seconds
Idle		Shows the total standstill duration in seconds

Installation and Setup

• a running Domoticz installation, tested with version 2021.1 and Python 3.8 and higher
• Python >= 3.8
• clone project
  • go to domoticz/plugins directory
  • clone the project

    cd domoticz/plugins
    git clone https://github.com/joro75/Domoticz-Toyota-Plugin.git

• or just download, unzip and copy to domoticz/plugins
• install needed python modules:
  • mytoyota Version 0.9.3
  • geopy Version 2.3.0
  • setuptools Version >= 57.0.0
  • for an automated install of these, you can use sudo pip3 install -r requirements.txt
• restart Domoticz service
• Now go to Setup, Hardware in your Domoticz interface. There add the Toyota plugin.
• Configure the username and password that is also used for the Toyota MyT connected services.
• If one or more errors are detected during the start of the plugin, this will be reported as errors in the Domoticz log.

Settings

Parameter	Information
username	The username that is also used to login in the MyT application
password	The password that is also used to login in the MyT application.
car	An identifier for the car for which the data should be retrieved, if multiple cars are present in the myT application. It can be a part of the VIN number, alias, licenseplate or the model.

Credits

A huge thanks goes to @DurgNomis-drol for making mytoyota.

The following icons from the Noun Project are used:

• fuel meter by Phonlaphat Thongsriphong from the Noun Project
• unlocked by Andrejs Kirma from the Noun Project
• locked by Andrejs Kirma from the Noun Project

State and development

The current version is working for my situation, and a few others. It will be impossible for me to test the plugin with every Toyota car model as there is a large variation in the provided data for each Toyota car and they also can have own specific options. However most of the functionality should be working. The number of provided devices is not complete yet, and future updates will add additional devices.

This plugin is using pre-commit. If you would like to contribute an improvement, fork this repository and create a new branch, which includes the improvements. Before making a PR, please run pre-commit run --all-files and make sure that all tests are passing before requesting the PR.