Skip to content

hombach/ioBroker.teslafi

Repository files navigation

Logo

ioBroker.teslafi

NPM version Downloads node-lts Libraries.io dependency status for latest release

GitHub GitHub repo size GitHub commit activity GitHub last commit GitHub issues

GitHub Workflow Status CodeQL Appveyor-CI SNYK Known Vulnerabilities

Versions

Beta Stable Installed

NPM

ioBroker TeslaFi Adapter – Seamless Tesla Data Integration for Your Smart Home

The TeslaFi adapter enables effortless integration of vehicle data from your TeslaFi account into the ioBroker system. Leverage this data to enhance your Tesla experience and optimize home automation workflows.

Why This Adapter?

The main purpose of this adapter is to integrate Tesla data into ioBroker without directly querying the vehicle's systems. By utilizing TeslaFi’s existing data polling, the adapter avoids additional requests to the vehicle, preserving battery life and ensuring efficient data access.

Features

The adapter connects to the TeslaFi API to retrieve comprehensive details about your Tesla vehicle and makes this data accessible within ioBroker. All Tesla models supported by TeslaFi are fully compatible. Currently, the following data categories are available:

  • Thermal State: Insights into the thermal management system and temperatures.
  • Battery State: Information on battery status, charge level, and range.
  • Vehicle State: General vehicle status, including position and overall condition.
  • Vehicle Data: Vehicle-specific details such as name, and VIN.

Typical Use Cases

  • Automation: Trigger smart home actions based on the real-time status of your Tesla. For instance, automatically adjust home climate control when the vehicle arrives.
  • Energy Management: Optimize energy consumption by scheduling vehicle charging times and monitoring battery status directly from ioBroker.
  • Notifications and Reporting: Set up alerts for specific vehicle conditions, such as low battery level, completed charging sessions or available updates.

Configuration

Configuring the adapter is straightforward:

  1. Enter your TeslaFi API key in the adapter's configuration screen.
  2. Set the desired polling interval to customize how frequently data is updated.

Compatibility

The adapter is compatible with all Tesla models supported by TeslaFi. A valid TeslaFi account with API access is required.

Active Development and User Contributions

The TeslaFi adapter is actively maintained, and additional features or data categories can be added based on user requests. Feel free to submit your ideas and help improve the adapter for the entire community!

Sentry

This adapter employs Sentry libraries to automatically report exceptions and code errors to the developers. For more details and information on how to disable error reporting, please consult the Sentry-Plugin Documentation! Sentry reporting is initiated starting with js-controller 3.0.

Donate

If you enjoyed this project — or just feeling generous, consider buying me a beer. Cheers! 🍻

Changelog

1.0.0 (2024-12-25)

  • (hombach) set version to 1.0 for stable release
  • (hombach) add newVersionStatus (#80)
  • (hombach) add configurable poll timeout

0.4.6 (2024-12-21)

  • (hombach) fix chai-as-promised
  • (hombach) enrich documentation

0.4.5 (2024-12-11)

  • (hombach) change some state roles

0.4.4 (2024-12-10)

  • (hombach) add roles to projectUtils

0.4.3 (2024-12-09)

  • (hombach) use of ioBroker.setInterval

0.4.2 (2024-12-06)

  • (hombach) intruduce i18n for translations (#41)

0.4.1 (2024-11-28)

  • (hombach) intruduce 'iobroker/eslint-config' (#67)
  • (hombach) add axios timeout
  • (hombach) optimized code stability
  • (hombach) fix typo
  • (hombach) remove message handler

0.4.0 (2024-11-10)

  • (hombach) implement managed charging time (#29)
  • (hombach) implement battery range
  • (hombach) fixed errors in 'time to finish charge'
  • (hombach) changed min update interval to 10 sec
  • (hombach) fixed typos

0.3.0 (2024-11-08)

  • (hombach) implement string for time to finish charge (#42)
  • (hombach) reorganize data in folders (#43)
  • (hombach) show 3rd row seat heater only if 3rd row is available (#40)
  • (hombach) implement 'charging_state' (#37)

0.2.1 (2024-11-08)

  • (hombach) change 'time_to_full_charge' type to number (#38)
  • (hombach) total rework of vehicle data parser
  • (hombach) set speed to 0 if null in API data (#39)

0.2.0 (2024-11-07)

  • (hombach) implement raw data state (#26)
  • (hombach) implement charger_phases (#28)
  • (hombach) implement driver_temp_setting (#31)
  • (hombach) implement seat and steeringwheel heater states (#30)

0.1.5 (2024-11-06)

  • (hombach) harmonize project tools
  • (hombach) removed doubled texts in state names

0.1.4 (2024-11-01)

  • (hombach) fix conversion error

0.1.3 (2024-10-30)

  • (hombach) fix typo in error text
  • (hombach) optimize responsive design
  • (hombach) bump dependencies

0.1.2 (2024-10-28)

  • (hombach) introduce to ioBroker latest repo
  • (hombach) bump dependencies

0.1.1 (2024-10-26)

  • (hombach) fix npm error

0.1.0 (2024-10-26)

  • (hombach) first working version

0.0.1 (2024-10-24)

  • (hombach) initial release

License

MIT License

Copyright (c) 2024 C.Hombach TeslaFi@homba.ch

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.