teslamate

Enhancements

Translations

• Add Korean translation (#614 by dongbum)

Bug Fixes

• Fix an issue where the map tiles would disappear when editing a geofence
• Fix a few things in the docs (#611 by tobiasehlert)

Enhancements

Streaming API

As the first and only Tesla logging app out there, TeslaMate now use the Tesla streaming API! This brings the following improvements:

• High precision drive data. Rather than active polling, the streaming API allows for passive consumption of a high frequency data stream with the most important drive data (position, heading, speed, power, elevation etc.).
• Actual elevation above sea level. Up until now TeslaMate used satellite terrain data to get the elevation. Driving through tunnels or across bridges therefore resulted in inaccurate recordings. This is no longer the case!
• Bluetooth hints are no longer needed! Using the streaming API does not prevent the vehicle from falling asleep, thus enabling continuous monitoring. This allows the car to fall asleep more quickly (no more idle timer) and we don't miss up to 21 minutes of driving because of halted polling.

Many thanks to everyone who participated in testing this release and contributed improvements!

Translations

• Add Danish translation (#584 by MartinNielsen)
• Update Norwegian translation (#544 and #591 by spacecosmos)
• Update Swedish translation (#522 by tobiasehlert)
• Update French translation (#598 by tomS3210 and MaxG88)
• Updated Labels to Title Case (#578 by jmiverson)

Other enhancements:

• Send credentials with manifest request (#555 by MaxG88)
• Add option to change the language of the web interface
• Reduce docker image size
• Display an arrow instead of a generic marker to indicate in which direction the vehicle is heading
• Show spinner before the map is initialized
• Wait until the doors/trunk/frunk are closed before attempting to fall asleep
• Inform if a new TeslaMate update is available
• Add icons to navbar items
• Add 'About' section to the settings page
• Publish only those values via MQTT that have actually changed
• Improve detection of available vehicle software updates

New MQTT Topics

• teslamate/cars/$car_id/elevation
• teslamate/cars/$car_id/trunk_open
• teslamate/cars/$car_id/frunk_open

Documentation

The docs were revised (once again). You can find them at docs.teslamate.org.

• Add portainer guide to the documentation (#581 by DrMichael)
• Improve Apache2 guide (#570 by DrMichael)
• Bump traefik to v2.2 (#603 by oittaa)

Bug Fixes

• Display vampire drain range loss per hour in the correct units (#543 by ograff).
• Trip dashboard: Add title to the drives table to allow sorting (#592 by MaxG88)
• Add tini as the init process for the TeslaMate Docker container to avoid zombie processes (#606 by dbussink)
• Sort "Drives" table properly by drive date (#595 by Dulanic)
• Fix flashing modal on the geofence page
• Publish an MQTT message when the health check succeeds again
• Handle various invalid API responses that could previously cause problems
• Fix an issue where ambiguous dates could cause the TeslaFi import to fail
• Terminate an in progress drive when the car is put into service mode

Changed

• Increase the minimum Elixir version to 1.10

Removed

• Remove sleep mode requirements that are no longer needed
• Remove option to disable sleep mode

Bug Fixes

• Fix an issue that could cause charging sessions not to be properly recorded if the API reported incomplete charge data
• Fix a problem that could cause the TeslaFi import to fail

Bug Fixes

• Fix settings dropdown and Swedish translation (#525 by tobiasehlert)

Enhancements

• Add Swedish translation (#485 and #522 by tobiasehlert)
• Add Norwegian translation (#500 by spacecosmos)
• Add Spanish translation (#519 by alceasan)
• Overview: Add states panel (#520 by DrMichael)
• Immediately display the current car software version after restarting TeslaMate
• Add mileage to the summary page
• Add option to calculate charging costs retroactively
• Allow to enter total cost or cost per KWh used
• Indicate if any of the doors are open
• Add support for session fees
• Store more vehicle config attributes (exterior_color, wheel_type, spoiler_type)
• Bump Grafana to 6.7.1

New MQTT Topics

• teslamate/cars/$car_id/doors_open
• teslamate/cars/$car_id/model
• teslamate/cars/$car_id/trim_badging
• teslamate/cars/$car_id/exterior_color
• teslamate/cars/$car_id/wheel_type
• teslamate/cars/$car_id/spoiler_type

Bug Fixes

• Drive Stats: Show stats in desired units (#484 by pichalite)
• Drive Details: Fix odometer units (#487 by pichalite)
• Update address formatting to avoid showing obscure names instead of towns/cities
• Charge Details: Hide empty series
• Suppress Cldr.NoMatchingLocale warnings
• Trip: Prevent 'division by zero' error
• Open dashboard links in a new tab to work around Grafana regression
• Use the maximum kWh to calculate the charge cost

Bug Fixes

• Fix an error that could prevent new users from logging in, among other things
• Overview dashboard: Display odometer in desired units

Enhancements

olexs has developed a toolkit to export data from the tesla-apiscraper InfluxDB backend and convert it to a CSV format that can be imported using the TeslaFi Import. Check it out if you want to migrate data to TeslaMate: Import from tesla-apiscraper (BETA)

• Simplify geofence editing: The radius can now be changed interactively.
• Allow geofences to overlap: If multiple geofences cover a position, the geofence whose centre is closest is selected.
• Increase charge cost scale / kWh (#440 by baylanger)
• Charge cost view: Show zoom controls
• TeslaFi Import: Preselect the timezone
• Add configuration option DATABASE_SSL
• Use 'rated' as default preferred range
• Collapse 'Dashboards' dropdown on mobile

Dashboards

• Add Trip dashboard: This dashboard was built to visualize longer trips. It provides an overview of all drives and charges that were logged over a period of several hours or days.
• All: Link to the web interface and other dashboards
• Overview: Speed up database queries
• Charges: Add geofence filter
• Charge Details: Add cost overview (#460 by Niek)
• Drive Details: Add usable battery level graph

New MQTT Topics

• teslamate/cars/$car_id/geofence: The name of the geofence at the current position

Documentation

• Add docs for tesla-apiscraper import (#454 by olexs)
• Update Backup & Restore docs (#438 by AlwindB)
• Revamp manual install docs

Bug Fixes

• Fix an issue where some CSV files could not be imported

Enhancements

• Import from TeslaFi (BETA)
• Calculate charge cost based on location and kWh
• Automatically set charge cost to zero if free supercharging is enabled (configurable on the settings page)
• Add French translation (#397 by tomS3210)
• Improve language detection
• Show odometer on 'Drive Details' dashboard
• Bump Grafana to 6.6.1
• Bump Elixir to 1.10

Documentation

• New FAQ entry for adding API tokens directly into the database instead of using username/password (#412 by wishbone1138)
• Improve standalone install documentation (#416 by Niek)
• Improve iOS Shortcuts guide (#405 by DP19)

Bug Fixes

• Re-add charge annotations to the 'Projected Range' dashboard (#393 by ctraber)
• Correct typos in projected-range.json (#395 by shagberg)
• Increase height of the pie charts panels
• Address an issue where a drive would not be properly completed if the vehicle was suddenly reported as asleep after being offline for a while
• Fix energy used in 'Drive Details'

Enhancements

• Tweak polling intervals
• Make the web interface feel snappier

Bug Fixes

• Fix an issue where distance, energy used and duration were missing on the Drive Details dashboard if the length unit was set to miles

Enhancements

• Add charge cost interface
• Display usable SOC and show snowflake icon on summary page (#338 by ctraber)
• Log missed software updates
• Add tooltip with the estimated range at 100%
• Remove software version commit hash
• Format remaining charge time
• Add option to use a custom namespace for MQTT topics
• Periodically store vehicle data while online
• Use the Accept-Language HTTP header get the locale (Supported languages: English, German)
• Add setting to change the preferred language of OpenStreetMap results
• Show spinner while fetching vehicle data
• Add dropdown with dashboard links to the navigation bar

New MQTT Topics

• teslamate/cars/$car_id/usable_battery_level

Dashboards

• Projected Range: Use usable_battery_level to calculate the projected range and add more panels (#338, #367 by ctraber)
• Add tesla tag (#369 by TechForze)
• Vampire Drain: show SOC difference and ❄ (reduced range)
• Charging Stats: Show share of AC/DC charging
• Charging Stats: Show top charging stations by cost
• Overview dashboard: Use the preferred range
• Overview dashboard: Always show latest voltage and power while charging
• Add Charge Level dashboard
• Add Drive Stats dashboard
• Revamp Drives/Drive Details and Charges/Charge Details dashboards

Documentation

• Add docs for an advanced Docker install with Apache2 (#361 by DrMichael)
• Add docs for backup and restore (#361 by DrMichael)
• Update the macrodroid docs (#359 by markusdd)
• Add docs for manually fixing data
• Add docs for updating Postgres

Bug Fixes

• Fix tooltips in Safari (iOS)
• Always publish the shift state via MQTT
• Fix an issue where he charge location was not be displayed
• Fix an issue that could cause the added charge kWh to be shown as 0

⚠️ Please note: Due to internal changes, all addresses will be recalculated on first startup. Depending on the amount of data, this process may take up to 30 minutes or longer.

TeslaMate is open source and completely free for everyone to use.

If you like this project and want to support further development, please consider making a donation.

Enhancements

• Locations dashboard: Visualize cities and states with the most stored addresses

Bug Fixes

• Fix an issue where a broken rear window sensor could cause the windows to always be displayed as open
• Address an issue where a charge wouldn't be properly logged if the Tesla API reported invalid charge data
• Fix a bug that could cause the geo-fence form to become unresponsive

Bug Fixes

• Fix an issue where invalid or revoked tokens could cause the application to crash after startup
• Change default time range in the 'Updates' dashboard

Bug Fixes

• Fix an issue where the database migrations would not succeed if there were charges without any data points

Enhancements

Documentation

@gundalow has revamped the docs (#292, #314). The new documentation is available here: teslamate.readthedocs.io

Automatic phase correction

The phase correction is now applied automatically.

Background: some vehicles incorrectly report 2 instead of 1 or 3 phases when charging. This led to an incorrect calculation of the 'kWh used'. Furthermore, the calculation did not work reliably in three-phase networks with e.g. 127/220V. Therefore it was necessary in the past to manually activate a phase correction for specific geo-fences. With this update the correction is now applied automatically.

Other enhancements

• Refactored API module
• Increased polling frequency in asleep state
• New OSM aliases
• ... and other minor improvements

Bug Fixes

• Efficiency Dashboard: convert km/h to mph in the temperature efficiency table
• Fix an issue where the application could crash because the database pool was too small
• Fix an issue where a drive/charge could be split into two parts due to API timeouts

TeslaMate is open source and completely free for everyone to use.

If you like this project and want to support further development, please consider making a donation.

Enhancements

• Enable the time range control in the "Charging Stats" dashboard (#278 by @nnoally)
• Various docs improvements (#285 by @gundalow)

Bug Fixes

• Fix issue where on a brand new installation suspending logging would only work after a restart
• Fix the elevation scale in the Drive Details

Enhancements

Add a database column that will allow tracking charge costs:

• Merge 20191117042320_add_cost_field_to_charges.exs (Charge Cost field) (#258 by @ngardiner)
• Grafana Dashboard Integration for Charge Cost (#273 by @ngardiner)

Note: There is no charging cost interface either manual or automatic at this point but there will be in the future.

Bug Fixes

• Downgrade the Grafana docker image to v6.3.7 because there are still issues with ARM-compatible images
• Fix an issue where the selected car was not displayed when opening the drive or charging details

New Features

• Display link "Dashboards" inside the navigation bar (it becomes visible after clicking an address in one of the Grafana dashboards. Alternatively the Grafana URL can be added manually on the settings page)
• Enable or disable the sleep mode depending on the location. For example, the car can be allowed to sleep at home or work, but nowhere else.
• Extend Charge Stats Dashboard with discharge stats, a charge delta graph and a charge heatmap (#270 by @marcogabriel)

Enhancements

• Make sleep mode separately configurable for each car
• Reduce default "Time to try sleeping" to 12 minutes for newer vehicles
• The "States" dashboard now includes software updates
• Automatically repair trips and charges with missing addresses (e.g. because OpenStreetMap was temporarily unavailable)
• Update thresholds of the battery level gauge (#256 by @marcogabriel)

Bug Fixes

• Fix issue where consumption values were displayed as 0
• Fix issue where installing a software update when charging would produce an incomplete charge record

TeslaMate is open source and completely free for everyone to use.

If you like this project and want to support further development, please consider making a donation.

Bug Fixes

• Fix an issue where the "states" graph would not show every drive/charge
• Fix an issue where the application would not start if the vehicle was parked at a place with poor reception
• Remove duplicate table row "Remaining Time"

Enhancements

• Display remaining time while charging

New MQTT Topics

• teslamate/cars/$car_id/heading

Bug Fixes

• Consistent language for label of charging events (#299)
• Cap charging efficiency to 100%

We finally have documentation! Many thanks to @ngardiner, who gave the impulse and did most of the work and also to @krezac, who contributed a guide to creating iOS Shortcuts for TeslaMate!

New Features

Vehicle Efficiency

Previous versions of TeslaMate shipped with hard-coded efficiency values for the various Tesla models. These efficiency values are needed to calculate trip consumptions, because the Tesla API does not provide them directly.

The hard-coded values were probably pretty accurate, but it was impossible to ensure the correctness of all of them. In addition, the new Model S and X "Raven" could not be reliably identified because the Tesla API returns wrong option codes for both.

This version eliminates the need to use these hard-coded values and instead calculates them based on the recorded charging data. It takes at least two charges to display the first estimate. Each subsequent charge will then continue to improve the accuracy of the estimate, which is applied retroactively to all data.

Charge energy used

In addition to the kWh added to the battery during the charge TeslaMate now calculates the actual energy used by the charger, which in most cases is higher than the energy added to the battery.

Consider this feature somewhat experimental. Theoretically, however, it should be pretty accurate as long as the vehicle has a stable internet connection while charging (other paid Tesla loggers use the same calculation method).

Currently, a firmware bug in some vehicles may cause the wrong number of phases to be reported when charging at some chargers. As a workaround, a phase correction can be activated per geo-fence.

New MQTT Topics

• teslamate/cars/$car_id/update_available
• teslamate/cars/$car_id/is_climate_on
• teslamate/cars/$car_id/is_preconditioning
• teslamate/cars/$car_id/is_user_present

Enhancements

• Show icon indicators for various states (sentry mode, vehicle locked, windows open, pre-conditioning etc.)
• Various UI Tweaks
• Grafana: show the precise duration of a trip in a tooltip
• Serve gzipped assets
• Disable origin check by default to simplify the installation of TeslaMate. (⚠️ For publicly exposed TeslaMate instances it is advisable to re-enable the check by adding the environment variable CHECK_ORIGIN=true.)

Bug Fixes

• Set the correct end date for charges where the vehicle remains plugged in after completion
• Fix an issue with vehicles that were removed from the Tesla Account
• Correctly handle API responses which indicate that the vehicle is in service
• Display effects of range gains (e.g. from supercharging pre-conditioning a cold battery) as NULL

TeslaMate is open source and completely free for everyone to use.

If you like this project and want to support further development, please consider making a donation.