Tessie smart home integration, free and open source
Your Teslas through Tessie: battery, range, charge, climate, doors, tyres, and lock.
Published by LM1LC3N7
- Devices
- Version 0.1.1
- Requires Gladys >=5.1.0
- ★ 0
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.
Configuration settings
These are the settings Tessie asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Your Teslas in Gladys, through Tessie | section | No | 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 | Yes | 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 | No | How often Tessie is read, in seconds: 60 to 3600. A read never asks to wake the car. |
| Where the car is | section | No | 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 | No | Off by default. On: latitude and longitude rounded to 3 decimals (about 100 m), as a text. |
| Language of the feature names | select | No |
How to install Tessie in Gladys
- In Gladys, open Integrations: Tessie appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/lm1lc3n7/gladys-tessie:0.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LM1LC3N7/gladys-tessie.
Tessie requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Tessie is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by LM1LC3N7, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation