From 9c2f8134a0b849e57866fb63e3c0990d7a7a99c0 Mon Sep 17 00:00:00 2001 From: Brett Date: Sat, 11 May 2024 12:15:54 +1000 Subject: [PATCH 1/8] Base documentation --- source/_integrations/teslemetry.markdown | 225 ++++++++++++++++------- 1 file changed, 162 insertions(+), 63 deletions(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index b0069fb3b17e..88d675a5ff3f 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -2,93 +2,192 @@ title: Teslemetry description: Instructions on how to integrate Teslemetry within Home Assistant. ha_category: + - Binary Sensor + - Button - Climate + - Cover + - Device Tracker + - Lock + - Media Player + - Number - Sensor + - Update ha_release: 2024.2 ha_iot_class: Cloud Polling ha_config_flow: true ha_codeowners: - '@Bre77' -ha_domain: teslemetry +ha_domain: Teslemetry ha_platforms: + - binary_sensor + - button - climate - - diagnostics + - cover + - device_tracker + - lock + - media_player + - number + - select - sensor + - switch + - update ha_integration_type: integration --- -The Teslemetry integration exposes various commands and sensors from the Tesla vehicles connected to a [Teslemetry](https://teslemetry.com/) subscription. +The Teslemetry integration exposes various commands and sensors from the Tesla vehicles and energy sites connected to a [Teslemetry](https://teslemetry.com/) subscription. ## Prerequisites -You must have a [Teslemetry](https://teslemetry.com/) account and [access token](https://teslemetry.com/console). +You must have a [Teslemetry](https://teslemetry.com) account, active subscription, and [access token](https://teslemetry.com/console). + +Vehicle delivered in 2024 and later will require a [virtual key](https://teslemetry.com/docs/topics/virtualkey) to be configured in order to run certain commands. {% include integrations/config_flow.md %} ## Entities -### Climate - -The integration will create a climate entity to control the vehicle's climate control system. This entity can: +These are the entities available in the Teslemetry integration. Not all entities are enabled by default, and not all values are always available. -- Turn on and off -- Change the set temperature -- Change to one of the four modes: Off, Keep mode, Dog mode, and Camp mode +### Vehicles -### Sensor +|Domain|Name|Enabled| +|---|---|---|---| +|Binary sensor|Battery heater|No| +|Binary sensor|Cabin overheat protection actively cooling|No| +|Binary sensor|Charge cable|Yes| +|Binary sensor|Charger has multiple phases|No| +|Binary sensor|Dashcam|No| +|Binary sensor|Front driver door|Yes| +|Binary sensor|Front driver window|Yes| +|Binary sensor|Front passenger door|Yes| +|Binary sensor|Front passenger window|Yes| +|Binary sensor|Preconditioning enabled|No| +|Binary sensor|Preconditioning|No| +|Binary sensor|Rear driver door|Yes| +|Binary sensor|Rear driver window|Yes| +|Binary sensor|Rear passenger door|Yes| +|Binary sensor|Rear passenger window|Yes| +|Binary sensor|Scheduled charging pending|No| +|Binary sensor|Status|Yes| +|Binary sensor|Tire pressure warning front left|No| +|Binary sensor|Tire pressure warning front right|No| +|Binary sensor|Tire pressure warning rear left|No| +|Binary sensor|Tire pressure warning rear right|No| +|Binary sensor|Trip charging|No| +|Binary sensor|User present|Yes| +|Button|Flash lights|Yes| +|Button|Force refresh|Yes| +|Button|Homelink|Yes| +|Button|Honk horn|Yes| +|Button|Keyless driving|Yes| +|Button|Play fart|Yes| +|Button|Wake|Yes| +|Climate|Cabin overheat protection|Yes| +|Climate|Climate|Yes| +|Cover|Charge port door|Yes| +|Cover|Frunk|Yes| +|Cover|Trunk|Yes| +|Cover|Vent windows|Yes| +|Device tracker|Location|Yes| +|Device tracker|Route|Yes| +|Lock|Charge cable lock|Yes| +|Lock|Lock|Yes| +|Lock|Speed limit|Yes| +|Media player|Media Player|Yes| +|Number|Charge current|Yes| +|Number|Charge limit|Yes| +|Number|Speed limit|Yes| +|Select|Seat heater front left|Yes| +|Select|Seat heater front right|Yes| +|Select|Seat heater rear center|No| +|Select|Seat heater rear left|No| +|Select|Seat heater rear right|No| +|Select|Seat heater third row left|No| +|Select|Seat heater third row right|No| +|Select|Steering wheel heater|Yes| +|Sensor|Battery level|Yes| +|Sensor|Battery range|Yes| +|Sensor|Charge cable|No| +|Sensor|Charge energy added|Yes| +|Sensor|Charge rate|Yes| +|Sensor|Charger current|Yes| +|Sensor|Charger power|Yes| +|Sensor|Charger voltage|Yes| +|Sensor|Charging|Yes| +|Sensor|Distance to arrival|Yes| +|Sensor|Driver temperature setting|No| +|Sensor|Estimate battery range|No| +|Sensor|Exterior color|No| +|Sensor|Fast charger type|No| +|Sensor|Ideal battery range|No| +|Sensor|Inside temperature|Yes| +|Sensor|Odometer|No| +|Sensor|Outside temperature|Yes| +|Sensor|Passenger temperature setting|No| +|Sensor|Power|No| +|Sensor|Roof color|No| +|Sensor|Scheduled charging mode|No| +|Sensor|Scheduled charging start time|No| +|Sensor|Scheduled departure time|No| +|Sensor|Shift state|No| +|Sensor|Speed|No| +|Sensor|State of charge at arrival|No| +|Sensor|Time at arrival|Yes| +|Sensor|Time at full charge|Yes| +|Sensor|Time to arrival|Yes| +|Sensor|Time to arrival|Yes| +|Sensor|Time to full charge|Yes| +|Sensor|Time to full charge|Yes| +|Sensor|Tire pressure front left|No| +|Sensor|Tire pressure front right|No| +|Sensor|Tire pressure last measured front left|No| +|Sensor|Tire pressure last measured front right|No| +|Sensor|Tire pressure last measured rear left|No| +|Sensor|Tire pressure last measured rear right|No| +|Sensor|Tire pressure rear left|No| +|Sensor|Tire pressure rear right|No| +|Sensor|Traffic delay|No| +|Sensor|Usable Battery level|No| +|Switch|Auto seat climate left|Yes| +|Switch|Auto seat climate right|Yes| +|Switch|Auto steering wheel heater|Yes| +|Switch|Charge|Yes| +|Switch|Defrost|Yes| +|Switch|Sentry mode|Yes| +|Switch|Valet mode|Yes| +|Update|Update|Yes| -The integration will create sensor entities for a variety of metrics that relate to your vehicles, energy sites, and Wall Connectors: +### Energy Sites -#### Energy sites -- Battery power -- Energy left -- Generator power (disabled by default) -- Grid power -- Grid services power -- Load power -- Percentage charged -- Solar power -- Total pack energy (disabled by default) -- Version -- VPP backup reserve +|Domain|Name|Method|Enabled| +|---|---|---|---| +|Binary sensor|Backup capable|Yes| +|Binary sensor|Grid services active|Yes| +|Binary sensor|Grid services enabled|Yes| +|Number|Backup reserve|Yes| +|Number|Off grid reserve|Yes| +|Sensor|Battery power|Yes| +|Sensor|Energy left|Yes| +|Sensor|Generator power|No| +|Sensor|Grid power|Yes| +|Sensor|Grid services power|Yes| +|Sensor|Island status|Yes| +|Sensor|Load power|Yes| +|Sensor|Percentage charged|Yes| +|Sensor|Solar power|Yes| +|Sensor|Total pack energy|No| +|Sensor|VPP backup reserve|Yes| +|Sensor|Version|Yes| +|Select|Allow export|Yes| +|Select|Operation mode|Yes| +|Switch|Allow charging from grid|Yes| +|Switch|Storm mode|Yes| -#### Vehicles -- Battery level -- Battery power -- Battery range -- Charge cable -- Charge energy added -- Charge rate (disabled by default) -- Charging -- Charger power -- Charger voltage -- Charger current -- Destination -- Distance to arrival -- Driver temperature setting (disabled by default) -- Estimate battery range (disabled by default) -- Fast charger type -- Ideal battery range (disabled by default) -- Inside temperature -- Odometer (disabled by default) -- Online -- Outside temperature -- Passenger temperature setting (disabled by default) -- Power (disabled by default) -- Shift state (disabled by default) -- Speed (disabled by default) -- State of charge at arrival (disabled by default) -- Time to arrival -- Time to full charge -- Tire pressure front left (disabled by default) -- Tire pressure front right (disabled by default) -- Tire pressure rear left (disabled by default) -- Tire pressure rear right (disabled by default) -- Traffic delay (disabled by default) -- Usable battery level (disabled by default) +### Wall Connector -#### Wall connectors -- Fault state code (disabled by default) -- Power -- State code (disabled by default) -- Vehicle +|Domain|Name|Method|Enabled| +|---|---|---|---| +|Sensor|Fault state|No| +|Sensor|Power|Yes| +|Sensor|State|Yes| +|Sensor|Vehicle|Yes| \ No newline at end of file From 554619b3cea2e756c7275065e91170b6f2fd4980 Mon Sep 17 00:00:00 2001 From: Brett Date: Sat, 11 May 2024 12:43:01 +1000 Subject: [PATCH 2/8] Fixes --- source/_integrations/teslemetry.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index 88d675a5ff3f..1354812de6d5 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -17,7 +17,7 @@ ha_iot_class: Cloud Polling ha_config_flow: true ha_codeowners: - '@Bre77' -ha_domain: Teslemetry +ha_domain: teslemetry ha_platforms: - binary_sensor - button @@ -51,7 +51,7 @@ These are the entities available in the Teslemetry integration. Not all entities ### Vehicles |Domain|Name|Enabled| -|---|---|---|---| +|---|---|---| |Binary sensor|Battery heater|No| |Binary sensor|Cabin overheat protection actively cooling|No| |Binary sensor|Charge cable|Yes| @@ -159,8 +159,8 @@ These are the entities available in the Teslemetry integration. Not all entities ### Energy Sites -|Domain|Name|Method|Enabled| -|---|---|---|---| +|Domain|Name|Enabled| +|---|---|---| |Binary sensor|Backup capable|Yes| |Binary sensor|Grid services active|Yes| |Binary sensor|Grid services enabled|Yes| @@ -185,8 +185,8 @@ These are the entities available in the Teslemetry integration. Not all entities ### Wall Connector -|Domain|Name|Method|Enabled| -|---|---|---|---| +|Domain|Name|Enabled| +|---|---|---| |Sensor|Fault state|No| |Sensor|Power|Yes| |Sensor|State|Yes| From 3f8c9f0ce0a5ed8b53fa94e6288ad5a071bac691 Mon Sep 17 00:00:00 2001 From: Brett Date: Mon, 13 May 2024 16:46:23 +1000 Subject: [PATCH 3/8] Re-add diagnostics --- source/_integrations/teslemetry.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index 1354812de6d5..d1bfd543e22b 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -24,6 +24,7 @@ ha_platforms: - climate - cover - device_tracker + - diagnostics - lock - media_player - number From 5b3fea69bc3d2a6bdc2457e695aea309ba7820b3 Mon Sep 17 00:00:00 2001 From: Brett Date: Mon, 13 May 2024 18:54:18 +1000 Subject: [PATCH 4/8] Fixes --- source/_integrations/teslemetry.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index d1bfd543e22b..de9d00fd0b60 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -2,13 +2,13 @@ title: Teslemetry description: Instructions on how to integrate Teslemetry within Home Assistant. ha_category: - - Binary Sensor + - Binary sensor - Button - Climate - Cover - - Device Tracker + - Device tracker - Lock - - Media Player + - Media player - Number - Sensor - Update @@ -41,7 +41,7 @@ The Teslemetry integration exposes various commands and sensors from the Tesla v You must have a [Teslemetry](https://teslemetry.com) account, active subscription, and [access token](https://teslemetry.com/console). -Vehicle delivered in 2024 and later will require a [virtual key](https://teslemetry.com/docs/topics/virtualkey) to be configured in order to run certain commands. +Vehicles delivered in 2024 and later will require a [virtual key](https://teslemetry.com/docs/topics/virtualkey) to be configured in order to run certain commands. {% include integrations/config_flow.md %} @@ -158,7 +158,7 @@ These are the entities available in the Teslemetry integration. Not all entities |Switch|Valet mode|Yes| |Update|Update|Yes| -### Energy Sites +### Energy sites |Domain|Name|Enabled| |---|---|---| @@ -184,7 +184,7 @@ These are the entities available in the Teslemetry integration. Not all entities |Switch|Allow charging from grid|Yes| |Switch|Storm mode|Yes| -### Wall Connector +### Wall connector |Domain|Name|Enabled| |---|---|---| From 5d1fe7ac460a72d9c1f38822a20f5294281ea17b Mon Sep 17 00:00:00 2001 From: Brett Date: Tue, 14 May 2024 14:15:12 +1000 Subject: [PATCH 5/8] Add switch platform --- source/_integrations/teslemetry.markdown | 77 +----------------------- 1 file changed, 1 insertion(+), 76 deletions(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index de9d00fd0b60..eb481be9d905 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -2,16 +2,9 @@ title: Teslemetry description: Instructions on how to integrate Teslemetry within Home Assistant. ha_category: - - Binary sensor - - Button - Climate - - Cover - - Device tracker - - Lock - - Media player - - Number - Sensor - - Update + - Switch ha_release: 2024.2 ha_iot_class: Cloud Polling ha_config_flow: true @@ -19,19 +12,10 @@ ha_codeowners: - '@Bre77' ha_domain: teslemetry ha_platforms: - - binary_sensor - - button - climate - - cover - - device_tracker - diagnostics - - lock - - media_player - - number - - select - sensor - switch - - update ha_integration_type: integration --- @@ -53,59 +37,8 @@ These are the entities available in the Teslemetry integration. Not all entities |Domain|Name|Enabled| |---|---|---| -|Binary sensor|Battery heater|No| -|Binary sensor|Cabin overheat protection actively cooling|No| -|Binary sensor|Charge cable|Yes| -|Binary sensor|Charger has multiple phases|No| -|Binary sensor|Dashcam|No| -|Binary sensor|Front driver door|Yes| -|Binary sensor|Front driver window|Yes| -|Binary sensor|Front passenger door|Yes| -|Binary sensor|Front passenger window|Yes| -|Binary sensor|Preconditioning enabled|No| -|Binary sensor|Preconditioning|No| -|Binary sensor|Rear driver door|Yes| -|Binary sensor|Rear driver window|Yes| -|Binary sensor|Rear passenger door|Yes| -|Binary sensor|Rear passenger window|Yes| -|Binary sensor|Scheduled charging pending|No| -|Binary sensor|Status|Yes| -|Binary sensor|Tire pressure warning front left|No| -|Binary sensor|Tire pressure warning front right|No| -|Binary sensor|Tire pressure warning rear left|No| -|Binary sensor|Tire pressure warning rear right|No| -|Binary sensor|Trip charging|No| -|Binary sensor|User present|Yes| -|Button|Flash lights|Yes| -|Button|Force refresh|Yes| -|Button|Homelink|Yes| -|Button|Honk horn|Yes| -|Button|Keyless driving|Yes| -|Button|Play fart|Yes| -|Button|Wake|Yes| |Climate|Cabin overheat protection|Yes| |Climate|Climate|Yes| -|Cover|Charge port door|Yes| -|Cover|Frunk|Yes| -|Cover|Trunk|Yes| -|Cover|Vent windows|Yes| -|Device tracker|Location|Yes| -|Device tracker|Route|Yes| -|Lock|Charge cable lock|Yes| -|Lock|Lock|Yes| -|Lock|Speed limit|Yes| -|Media player|Media Player|Yes| -|Number|Charge current|Yes| -|Number|Charge limit|Yes| -|Number|Speed limit|Yes| -|Select|Seat heater front left|Yes| -|Select|Seat heater front right|Yes| -|Select|Seat heater rear center|No| -|Select|Seat heater rear left|No| -|Select|Seat heater rear right|No| -|Select|Seat heater third row left|No| -|Select|Seat heater third row right|No| -|Select|Steering wheel heater|Yes| |Sensor|Battery level|Yes| |Sensor|Battery range|Yes| |Sensor|Charge cable|No| @@ -156,17 +89,11 @@ These are the entities available in the Teslemetry integration. Not all entities |Switch|Defrost|Yes| |Switch|Sentry mode|Yes| |Switch|Valet mode|Yes| -|Update|Update|Yes| ### Energy sites |Domain|Name|Enabled| |---|---|---| -|Binary sensor|Backup capable|Yes| -|Binary sensor|Grid services active|Yes| -|Binary sensor|Grid services enabled|Yes| -|Number|Backup reserve|Yes| -|Number|Off grid reserve|Yes| |Sensor|Battery power|Yes| |Sensor|Energy left|Yes| |Sensor|Generator power|No| @@ -179,8 +106,6 @@ These are the entities available in the Teslemetry integration. Not all entities |Sensor|Total pack energy|No| |Sensor|VPP backup reserve|Yes| |Sensor|Version|Yes| -|Select|Allow export|Yes| -|Select|Operation mode|Yes| |Switch|Allow charging from grid|Yes| |Switch|Storm mode|Yes| From fd832b1d07cf3077715d75661f39d2fcfd80c7ba Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Thu, 16 May 2024 11:34:21 +1000 Subject: [PATCH 6/8] Update teslemetry.markdown --- source/_integrations/teslemetry.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index 63e2a604478a..bc1517250b6e 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -108,7 +108,7 @@ These are the entities available in the Teslemetry integration. Not all entities |Sensor|VPP backup reserve|Yes| |Sensor|Version|Yes| |Switch|Allow charging from grid|Yes| -|Switch|Storm mode|Yes| +|Switch|Storm watch|Yes| ### Wall connector @@ -117,4 +117,4 @@ These are the entities available in the Teslemetry integration. Not all entities |Sensor|Fault state|No| |Sensor|Power|Yes| |Sensor|State|Yes| -|Sensor|Vehicle|Yes| \ No newline at end of file +|Sensor|Vehicle|Yes| From 1d59dfa114a4577e6aa6794f367e1fa91af90514 Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Fri, 17 May 2024 07:54:32 +1000 Subject: [PATCH 7/8] Drop trailing newline From 003c38bd9d760d7d5b00fef1068a2a7347f4d52b Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Mon, 20 May 2024 10:33:08 +1000 Subject: [PATCH 8/8] Remove valet --- source/_integrations/teslemetry.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/teslemetry.markdown b/source/_integrations/teslemetry.markdown index 632655d1937f..b1c3447ae13b 100644 --- a/source/_integrations/teslemetry.markdown +++ b/source/_integrations/teslemetry.markdown @@ -99,7 +99,6 @@ These are the entities available in the Teslemetry integration. Not all entities |Switch|Charge|Yes| |Switch|Defrost|Yes| |Switch|Sentry mode|Yes| -|Switch|Valet mode|Yes| ### Energy sites