Tessie Smart-Home-Integration, kostenlos und Open Source
Your Teslas through Tessie: battery, range, charge, climate, doors, tyres, and lock.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Shows the Teslas of your Tessie account in Gladys: battery level, range, charging state and power, climate, inside and outside temperatures, doors, trunks, windows, lock, Sentry mode, tyre pressures, odometer and state. One command: Lock.
Never tested with a real car. Unofficial, not affiliated with Tesla nor with Tessie.
What you need
- A Tessie account (a paid service, tessie.com) with your car(s) in it.
- An access token: in dash.tessie.com, Settings, API, Generate Access Token.
Setting up
- Install the integration from the Gladys store.
- In its configuration, paste the token in Tessie access token. It is
kept by Gladys in its database, never shown again, and sent only to Tessie
(
api.tessie.com), in a header. - Save, then Test the connection: it answers with the number of cars Tessie returns.
- In Discovery, create each car.
What is read, and how often
Every read interval (5 minutes by default, 60 s to 1 hour), Gladys reads the latest state Tessie knows of each car. Gladys never asks Tessie to wake a car to read it: a sleeping car keeps the values of its last wake.
Each group of values (charge, climate, vehicle, position) carries the time Tessie got it from the car:
- less than 10 minutes old: shown as a new value (scenes may react);
- older: shown with its own date (scenes do not react);
- older than 2 hours: not shown;
- a value already shown is not sent again.
Distances are in km (Tesla gives miles: converted), temperatures in °C, tyre pressures in bar. A value the car does not give stays unknown, never 0. The odometer never goes down.
At most 10 cars are followed (the status says how many are left out).
Lock
The Lock feature of a car is the only command. Setting it to locked sends Tessie's lock command (Tessie wakes the car if needed). It is sent even when Tessie asked to wait, when Tessie refused the token for the reads, or during a read. It is tried up to 3 times within 3 minutes, and sent again after a restart of the integration within that time. It ends when the car confirms, or when a read dated after the command shows the car locked while it was known unlocked before (an older read never counts). Gladys reads the car again 5 s and 20 s after it. When the car has not confirmed within about 3 seconds, Gladys shows an error saying what was sent and what goes on.
It is not sent when:
- no valid token is configured yet (it waits up to 3 minutes for one);
- the car is no longer in the Tessie account (when the key of the car ids was lost, the only car of the account is locked if Gladys has a single Tessie car);
- Tessie refuses the command (401, 403 or another 4xx than 429): it is not tried again;
- the 3 tries are used up, or the 3 minutes are over.
Unlocking is not available (nor trunks, charge port, climate): setting the feature to unlocked is refused and nothing is sent.
The position (off by default)
Turn on Show the position of the car, rounded to get a text feature with the latitude and longitude rounded to 3 decimals (about 100 m), shown only when Tessie's value is less than 10 minutes old. Turning it off erases the value shown. The navigation (destination), speed and heading are never read.
The status
- Connected to Tessie: N vehicle(s): all fine.
- Tessie refused the token (401/403): the reads stop until you save a new token or the test button succeeds.
- Tessie asked to wait (429 or 5xx): the reads wait as long as Tessie says (1 minute to 6 hours, kept across restarts).
- Tessie could not be read: network or timeout; tried again later, the wait doubling up to 1 hour.
- The configuration could not be read from Gladys: tried again, spaced, without end.
- The /data folder cannot be read: the reads wait (a stop may be saved in it), tried again every 10 s, without end. The lock still goes.
- The /data folder cannot be written (at the end of "Connected"): the reads go on; pauses and pending locks are not kept across a restart.
Privacy
The token and the VIN are never written to the logs, the status, nor the
integration's /data folder; the logs name a car by its rank (#1, #2...). A
car is known to Gladys by a code made from its VIN with a random key: without
that key, the VIN cannot be found back from the code. The key is kept twice,
in the integration's settings in Gladys (never shown in the form) and in
/data, so losing one of them changes nothing. If both are lost (Gladys
database restored without them and integration reinstalled), the cars come
back in Discovery as new devices: the old devices, their history and the
scenes using them must be moved to the new ones.
Konfigurationseinstellungen
Diese Einstellungen fragt Tessie in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your Teslas in Gladys, through Tessie | section | Nein | Reads the cars of your Tessie account (a paid Tesla service) through the official Tessie API: battery level, range, charging state and power, climate, temperatures, doors, trunks, windows, lock, Sentry mode, tyre pressures, odometer and state. Gladys shows the latest state Tessie knows and never asks it to wake a car to read it. The only command is Lock (unlock, trunks and charge port are not available). Create an access token in dash.tessie.com (Settings, API) and paste it below. Never tested with a real car. Unofficial, not affiliated with Tesla nor with Tessie. |
| Tessie access token | secret | Ja | The token of dash.tessie.com (Settings, API, Generate Access Token): kept by Gladys in its database, never shown again, sent only to Tessie (api.tessie.com). |
| Read interval (s) | number | Nein | How often Tessie is read, in seconds: 60 to 3600. A read never asks to wake the car. |
| Where the car is | section | Nein | Tessie also knows where each car is. If you allow it, Gladys shows its position rounded to about 100 m (3 decimals), only when Tessie's value is less than 10 minutes old. Turning the option off erases the value Gladys shows. The navigation (destination) is never read. |
| Show the position of the car, rounded | boolean | Nein | Off by default. On: latitude and longitude rounded to 3 decimals (about 100 m), as a text. |
| Language of the feature names | select | Nein |
So installierst du Tessie in Gladys
- Öffne in Gladys Integrationen: Tessie erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-tessie:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-tessie.
Tessie benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Tessie ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation