EVehicles
The electric vehicle framework connects to the API of electric vehicles to provide information about the car, and to send commands to the car.
Supported Cars
The following hardware is currently supported:
- Tesla Model S/3/X and probably Y. (currently not functional, see https://github.com/domoticz/domoticz/issues/5469)
- Mercedes (currently abandoned by Mercedes)
For issues and questions, please post in the related forum topic.
Other projects
The following pages show how to manage different brand of vehicles not supported by this framework:
Devices
The framework provides the following informative devices in Domoticz:
- State: alert sensor giving information about the state of the car. It has the following values:
- 0: car is not home
- 1: car is home and charging
- 2: car is home and not charging
- 3: car is home but cable is not connected
- 4: car is asleep
- Battery level: percentage sensor giving information about the battery
- Temperature: temperature sensor for the interior temperature of the car
- Outside temperature: temperature sensor for the external temperature around the car
- [2012.2 beta build 12004]Odometer: counter sensor for keeping track of the car's mileage
- [2012.2 beta build 12004]Open Alert: alert sensor giving information about the car being locked or unlocked. It has the following values:
- 0: car is locked
- 4: car is unlocked/open (e.g. door, window, trunk)
The framework provides the following switches:
- Charge switch: to start or stop the charging
- Climate switch: to start or stop the conditioning of the car's climate control
- Defrost switch: to start or stop the defrost mode of the car's climate control
- [2012.2 beta build 12004]Max charge limit switch: to set the charge limit to maximum (on) or default (off)
Note:
- Switches can only be used when the car is home.
- When installing the hardware it may take a while before the devices show up in the device list. Only when the connection to the car is successfully made and information can be retrieved, the devices are created.
Home detection
The framework retrieves the location of the car at the configured intervals. When the car is home, the switches can be used to control the car. Home is detected by comparing the car's location with the location configured in Domoticz settings (with a certain margin). In case the car is at your home location, but it's not detected to be at home, please ensure the location of the car as logged in the logging is set in the Domoticz settings.
Battery saving
The framework allows to configure two intervals that are used to pull information from the car:
- default interval: used when the car is not charging
- active interval: used when one of the switches is switched on (charging/climate/defrost)
Note that the car is checked every minute whether it is asleep or not. This is not configurable, and does not drain the battery.
The framework allows to configure how to deal with a sleeping car (if the car supports a sleep mode):
- Wake up: in case the car is asleep, it is woken up when information is requested from the car
- Do not wake up: in case the car is asleep, it will not request information from the car. However, when a spontaneous woke up is detected, information will be retrieved.
Using the switches to control the car, will always wake up the car, no matter the setting.
Tesla configuration
The following Tesla specific information is required:
- username: the user name of your tesla account
- password: the password of your tesla account
- VIN number: the VIN number of the car
The following settings can be configured:
- default interval: 10 minutes by default. NOTE: If you want your car to fall sleep (and disable the allow wake up setting), change this value to 20 minutes minimum.
- active interval: default 1 minute
- allow wake up: default false.
Scripts
TBD: example dzVents scripts to integrate the car in home automation.
Feature request list
Latest version found in version: 2020.2 beta
The following features are requested:
- Allow setting of interior temperature
- Allow setting of charge limit [implemented 2012.2 beta build 12004]
- Use active refresh interval for a while when a home coming is detected (to avoid a late charging detection)
Example
Below an example of a floorplan for an EVehicle.
